Source code

Revision control

Copy as Markdown

Other Tools

/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
/* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at */
// NSApplication delegate for Mac OS X Cocoa API.
// As of 10.4 Tiger, the system can send six kinds of Apple Events to an
// application; a well-behaved XUL app should have some kind of handling for all
// of them.
// See
// for details.
#include <AppKit/AppKit.h>
#import <Cocoa/Cocoa.h>
#include "NativeMenuMac.h"
#import <Carbon/Carbon.h>
#include "CustomCocoaEvents.h"
#include "gfxPlatform.h"
#include "nsCOMPtr.h"
#include "nsINativeAppSupport.h"
#include "nsAppRunner.h"
#include "nsAppShell.h"
#include "nsComponentManagerUtils.h"
#include "nsServiceManagerUtils.h"
#include "nsIAppStartup.h"
#include "nsIObserverService.h"
#include "nsISupportsPrimitives.h"
#include "nsObjCExceptions.h"
#include "nsIFile.h"
#include "nsDirectoryServiceDefs.h"
#include "nsCommandLine.h"
#include "nsIMacDockSupport.h"
#include "nsIStandaloneNativeMenu.h"
#include "nsILocalFileMac.h"
#include "nsString.h"
#include "nsCommandLineServiceMac.h"
#include "nsCommandLine.h"
#include "nsStandaloneNativeMenu.h"
#include "nsCocoaUtils.h"
#include "nsMenuBarX.h"
#include "mozilla/NeverDestroyed.h"
class AutoAutoreleasePool {
AutoAutoreleasePool() { mLocalPool = [[NSAutoreleasePool alloc] init]; }
~AutoAutoreleasePool() { [mLocalPool release]; }
NSAutoreleasePool* mLocalPool;
@interface MacApplicationDelegate : NSObject <NSApplicationDelegate> {
// This is used as a workaround for bug 1478347 in order to make OS-provided
// menu items such as the emoji picker available in the Edit menu, especially
// in multi-language environments.
- (IBAction)copy:(id)aSender;
enum class LaunchStatus {
static LaunchStatus sLaunchStatus = LaunchStatus::Initial;
static nsTArray<nsCString>& StartupURLs() {
static mozilla::NeverDestroyed<nsTArray<nsCString>> sStartupURLs;
return *sStartupURLs;
// Methods that can be called from non-Objective-C code.
// This is needed, on relaunch, to force the OS to use the "Cocoa Dock API"
// instead of the "Carbon Dock API". For more info see bmo bug 377166.
void EnsureUseCocoaDockAPI() {
[GeckoNSApplication sharedApplication];
void DisableAppNap() {
// Prevent the parent process from entering App Nap. macOS does not put our
// child processes into App Nap and, as a result, when the parent is in
// App Nap, child processes continue to run normally generating IPC messages
// for the parent which can end up being queued. This can cause the browser
// to be unresponsive for a period of time after the App Nap until the parent
// process "catches up." NSAppSleepDisabled has to be set early during
// startup before the OS reads the value for the process.
[[NSUserDefaults standardUserDefaults] registerDefaults:@{
@"NSAppSleepDisabled" : @YES,
void SetupMacApplicationDelegate(bool* gRestartedByOS) {
// this is called during startup, outside an event loop, and therefore
// needs an autorelease pool to avoid cocoa object leakage (bug 559075)
AutoAutoreleasePool pool;
// Ensure that InitializeMacApp() doesn't regress bug 377166.
[GeckoNSApplication sharedApplication];
// This call makes it so that application:openFile: doesn't get bogus calls
// from Cocoa doing its own parsing of the argument string. And yes, we need
// to use a string with a boolean value in it. That's just how it works.
[[NSUserDefaults standardUserDefaults]
// Create the delegate. This should be around for the lifetime of the app.
id<NSApplicationDelegate> delegate = [[MacApplicationDelegate alloc] init];
[[GeckoNSApplication sharedApplication] setDelegate:delegate];
*gRestartedByOS = !!nsCocoaUtils::ShouldRestoreStateDueToLaunchAtLogin();
sLaunchStatus == LaunchStatus::Initial,
"Launch status should be in intial state when setting up delegate");
sLaunchStatus = LaunchStatus::DelegateIsSetup;
// Run the mac app and stop it immediately after launch. This allows us to
// (a) Initialize accessibility early enough for modals that appear before
// the main app and nest their own event loop to be accessible.
// (b) Collect URLs that were provided to the app at open time.
void InitializeMacApp() {
if (sLaunchStatus != LaunchStatus::DelegateIsSetup) {
// Delegate has not been set up or NSApp has been launched already.
sLaunchStatus = LaunchStatus::CollectingURLs;
if (!gfxPlatform::IsHeadless()) {
[NSApp run];
sLaunchStatus = LaunchStatus::CollectedURLs;
nsTArray<nsCString> TakeStartupURLs() { return std::move(StartupURLs()); }
@implementation MacApplicationDelegate
- (IBAction)copy:(id)aSender {
[nsMenuBarX::sNativeEventTarget menuItemHit:aSender];
- (id)init {
if ((self = [super init])) {
if (![NSApp windowsMenu]) {
// If the application has a windows menu, it will keep it up to date and
// prepend the window list to the Dock menu automatically.
NSMenu* windowsMenu = [[NSMenu alloc] initWithTitle:@"Window"];
[NSApp setWindowsMenu:windowsMenu];
[windowsMenu release];
return self;
// The method that NSApplication calls upon a request to reopen, such as when
// the Dock icon is clicked and no windows are open. A "visible" window may be
// miniaturized, so we can't skip nsCocoaNativeReOpen() if 'flag' is 'true'.
- (BOOL)applicationShouldHandleReopen:(NSApplication*)theApp
hasVisibleWindows:(BOOL)flag {
nsCOMPtr<nsINativeAppSupport> nas = NS_GetNativeAppSupport();
// Go to the common Carbon/Cocoa reopen method.
nsresult rv = nas->ReOpen();
// NO says we don't want NSApplication to do anything else for us.
return NO;
// The method that NSApplication calls when documents are requested to be
// printed from the Finder (under the "File" menu). It will be called once for
// each selected document.
- (BOOL)application:(NSApplication*)theApplication
printFile:(NSString*)filename {
return NO;
// The method that NSApplication calls for using secure state restoration.
- (BOOL)applicationSupportsSecureRestorableState:(NSApplication*)app {
return YES;
// Create the menu that shows up in the Dock.
- (NSMenu*)applicationDockMenu:(NSApplication*)sender {
// Create the NSMenu that will contain the dock menu items.
NSMenu* menu = [[[NSMenu alloc] initWithTitle:@""] autorelease];
[menu setAutoenablesItems:NO];
// Add application-specific dock menu items. On error, do not insert the
// dock menu items.
nsresult rv;
nsCOMPtr<nsIMacDockSupport> dockSupport =
do_GetService(";1", &rv);
if (NS_FAILED(rv) || !dockSupport) return menu;
nsCOMPtr<nsIStandaloneNativeMenu> dockMenuInterface;
rv = dockSupport->GetDockMenu(getter_AddRefs(dockMenuInterface));
if (NS_FAILED(rv) || !dockMenuInterface) return menu;
RefPtr<mozilla::widget::NativeMenuMac> dockMenu =
// Give the menu the opportunity to update itself before display.
// Obtain a copy of the native menu.
NSMenu* nativeDockMenu = dockMenu->NativeNSMenu();
if (!nativeDockMenu) {
return menu;
// Loop through the application-specific dock menu and insert its
// contents into the dock menu that we are building for Cocoa.
int numDockMenuItems = [nativeDockMenu numberOfItems];
if (numDockMenuItems > 0) {
if ([menu numberOfItems] > 0) [menu addItem:[NSMenuItem separatorItem]];
for (int i = 0; i < numDockMenuItems; i++) {
NSMenuItem* itemCopy = [[nativeDockMenu itemAtIndex:i] copy];
[menu addItem:itemCopy];
[itemCopy release];
return menu;
- (void)applicationWillFinishLaunching:(NSNotification*)notification {
// We provide our own full screen menu item, so we don't want the OS providing
// one as well.
[[NSUserDefaults standardUserDefaults]
- (void)applicationDidFinishLaunching:(NSNotification*)notification {
if (sLaunchStatus == LaunchStatus::CollectingURLs) {
// We are in an inner `run` loop that we are spinning in order to get
// URLs that were requested while launching. `application:openURLs:` will
// have been called by this point and we will have finished reconstructing
// the command line. We now stop the app loop for the rest of startup to be
// processed and will call `run` again when the main event loop should
// start.
[NSApp stop:self];
// Send a bogus event so that the internal "app stopped" flag is processed.
// Since we aren't calling this from a responder, we need to post an event
// to have the loop iterate and respond to the stopped flag.
[NSApp postEvent:[NSEvent otherEventWithType:NSEventTypeApplicationDefined
location:NSMakePoint(0, 0)
// If we don't handle applicationShouldTerminate:, a call to [NSApp terminate:]
// (from the browser or from the OS) can result in an unclean shutdown.
- (NSApplicationTerminateReply)applicationShouldTerminate:
(NSApplication*)sender {
nsCOMPtr<nsIObserverService> obsServ =
if (!obsServ) return NSTerminateNow;
nsCOMPtr<nsISupportsPRBool> cancelQuit =
if (!cancelQuit) return NSTerminateNow;
obsServ->NotifyObservers(cancelQuit, "quit-application-requested", nullptr);
bool abortQuit;
if (abortQuit) return NSTerminateCancel;
nsCOMPtr<nsIAppStartup> appService =
if (appService) {
bool userAllowedQuit = true;
appService->Quit(nsIAppStartup::eForceQuit, 0, &userAllowedQuit);
if (!userAllowedQuit) {
return NSTerminateCancel;
return NSTerminateNow;
- (void)application:(NSApplication*)application
openURLs:(NSArray<NSURL*>*)urls {
[self openURLs:urls];
- (BOOL)application:(NSApplication*)application
willContinueUserActivityWithType:(NSString*)userActivityType {
return [userActivityType isEqualToString:NSUserActivityTypeBrowsingWeb];
- (BOOL)application:(NSApplication*)application
(void (^)(NSArray<id<NSUserActivityRestoring>>*))restorationHandler {
if (![userActivity.activityType
isEqualToString:NSUserActivityTypeBrowsingWeb]) {
return NO;
return [self openURLs:@[ userActivity.webpageURL ]];
- (void)application:(NSApplication*)application
error:(NSError*)error {
NSLog(@"Failed to continue user activity %@: %@", userActivityType, error);
- (BOOL)openURLs:(NSArray<NSURL*>*)urls {
nsTArray<const char*> args([urls count] * 2 + 2);
// Placeholder for unused program name.
for (NSURL* url in urls) {
if (!url || !url.scheme ||
[url.scheme caseInsensitiveCompare:@"chrome"] == NSOrderedSame) {
const char* const urlString = [[url absoluteString] UTF8String];
if (sLaunchStatus == LaunchStatus::CollectingURLs) {
if (args.Length() <= 1) {
// No URLs were added to the command line.
return NO;
nsCOMPtr<nsICommandLineRunner> cmdLine(new nsCommandLine());
nsCOMPtr<nsIFile> workingDir;
nsresult rv = NS_GetSpecialDirectory(NS_OS_CURRENT_WORKING_DIR,
if (NS_FAILED(rv)) {
// Couldn't find a working dir. Uh oh. Good job cmdline::Init can cope.
workingDir = nullptr;
rv = cmdLine->Init(args.Length(), args.Elements(), workingDir,
if (NS_FAILED(rv)) {
return NO;
rv = cmdLine->Run();
if (NS_FAILED(rv)) {
return NO;
return YES;