extension

Utilities related to your extension. Get URLs to resources packages with your extension. Get theWindow object for your extension's pages. Get the values for various settings.

Note:The messaging APIs in this module are deprecated in favor of the equivalent APIs in theruntime module.

Types

extension.ViewType: The type of extension view.

Properties

extension.lastErrorDeprecated: Set for the lifetime of a callback if an asynchronous extension API has resulted in an error. If no error has occurred,lastError will be undefined.
extension.inIncognitoContext: True for content scripts running inside incognito tabs, and for extension pages running inside an incognito process. (The latter only applies to extensions with"incognito": "split" set in their manifest.json file.)

Functions

extension.getBackgroundPage(): Returns theWindow object for the background page running inside the current extension. Returnsnull if the extension has no background page.
extension.getExtensionTabs()Deprecated: Returns an array of the JavaScript Window objects for each of the tabs running inside the current extension.
extension.getURL()Deprecated: Converts a relative path within an extension install directory to a fully-qualified URL.
extension.getViews(): Returns an array of theWindow objects for each of the pages running inside the current extension.
extension.isAllowedIncognitoAccess(): Retrieves the state of the extension's access to Incognito-mode (as determined by the user-controlled 'Allowed in Incognito' checkbox).
extension.isAllowedFileSchemeAccess(): Retrieves the state of the extension's access to thefile:// scheme (as determined by the user-controlled 'Allow access to File URLs' checkbox).
extension.sendRequest()Deprecated: Sends a single request to other listeners within the extension.
extension.setUpdateUrlData(): Sets the value of the ap CGI parameter used in the extension's update URL. This value is ignored for extensions that are hosted in the browser vendor's store.