WARNING: Most of this content (with the exception of the Mozilla 1.9 XPCOM reference) is very old, and can be expected to be out of date and possibly obsolete. For better XUL documentation, please visit the XUL hub at the Mozilla Developer Center.

nsIBrowserGlue

IID:01639c88-c0eb-4d75-9ee1-f325c1e04215
Inherits From:nsISupports

nsIBrowserGlue is a dirty and rather fluid interface to host shared utility methods used by browser UI code, but which are not local to a browser window. The component implementing this interface is meant to be a singleton (service) and should progressively replace some of the shared "glue" code scattered in browser/base/content (e.g. bits of utilOverlay.js, contentAreaUtils.js, globalOverlay.js, browser.js), avoiding dynamic inclusion and initialization of a ton of JS code for *each* window. Dued to its nature and origin, this interface won't probably be the most elegant or stable in the mozilla codebase, but its aim is rather pragmatic: 1) reducing the performance overhead which affects browser window load; 2) allow global hooks (e.g. startup and shutdown observers) which survive browser windows to accomplish browser-related activities, such as shutdown sanitization (see bug #284086)

This interface is implemented by the following components:


Methods

void ensurePlacesDefaultQueriesInitialized ( ) void sanitize ( nsIDOMWindow parentWindow )

void ensurePlacesDefaultQueriesInitialized ( )

Add the special "Places" folder (with some special queries) to the personal toolbar folder.


void sanitize ( nsIDOMWindow parentWindow )

Deletes privacy sensitive data according to user preferences

Arguments:
parentWindow: an optionally null window which is the parent of the sanitization dialog (if it has to be shown per user preferences)

Reference documentation is generated from Mozilla's source.