Interface nsIAppShellType

Exit the handle event loop

Ask the native event queue notification mechanism to favor Gecko tasks (instead of native tasks) for a short while. (Content processes always favor Gecko tasks.)

Resumes the use of additional platform-specific methods to run Gecko events on the main application thread. Calls to suspendNative() and resumeNative() may be nested. On some platforms this will be a no-op.

Enter an event loop. Don't leave until exit() is called.

Suspends the use of additional platform-specific methods (besides the nsIAppShell->run() event loop) to run Gecko events on the main application thread. Under some circumstances these "additional methods" can cause Gecko event handlers to be re-entered, sometimes leading to hangs and crashes. Calls to suspendNative() and resumeNative() may be nested. On some platforms (those that don't use any "additional methods") this will be a no-op. Does not (in itself) stop Gecko events from being processed on the main application thread. But if the nsIAppShell->run() event loop is blocked when this call is made, Gecko events will stop being processed until resumeNative() is called (even if a plugin or library is temporarily processing events on a nested event loop).