Nuestros voluntarios aún no han traducido este artículo al Español. ¡Únete a nosotros y ayúdanos a traducirlo!
También puedes leer el artículo en English (US).

Utilities related to your extension. Get URLs to resources packages with your extension, get the Window object for your extension's pages, get the values for various settings. Note that the messaging APIs in this module are deprecated in favor of the equivalent APIs in the runtime module.

Types

extension.ViewType
The type of extension view.

Properties

extension.lastError
Set for the lifetime of a callback if an ansychronous extension api has resulted in an error. If no error has occured 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 'split' incognito_behavior.

Functions

extension.getBackgroundPage()
Returns the Window object for the background page running inside the current extension. Returns null if the extension has no background page.
extension.getExtensionTabs()
Returns an array of the JavaScript Window objects for each of the tabs running inside the current extension.
extension.getURL()
Converts a relative path within an extension install directory to a fully-qualified URL.
extension.getViews()
Returns an array of the Window 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 the 'file://' scheme (as determined by the user-controlled 'Allow access to File URLs' checkbox).
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.

Events

extension.onRequest
Fired when a request is sent from either an extension process or a content script.
extension.onRequestExternal
Fired when a request is sent from another extension.
extension.sendRequest()
Sends a single request to other listeners within the extension.

Browser compatibility

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxOperaFirefox for Android
ViewTypeChrome Full support YesEdge No support NoFirefox Full support 45Opera Full support YesFirefox Android Full support 48
getBackgroundPageChrome Full support YesEdge Full support 14Firefox Full support 45Opera Full support YesFirefox Android Full support 48
getExtensionTabs
DeprecatedNon-standard
Chrome Full support YesEdge No support NoFirefox No support NoOpera No support NoFirefox Android No support No
getURL
DeprecatedNon-standard
Chrome Full support YesEdge Full support 14Firefox Full support 45Opera Full support YesFirefox Android Full support 48
getViewsChrome Full support YesEdge Full support 14Firefox Full support 45
Notes
Full support 45
Notes
Notes If this is called from a page that is part of a private browsing window, such as a sidebar in a private window or a popup opened from a private window, then its return value will not include the extension's background page.
Opera Full support YesFirefox Android Full support 48
Notes
Full support 48
Notes
Notes If this is called from a page that is part of a private browsing window, such as a sidebar in a private window or a popup opened from a private window, then its return value will not include the extension's background page.
inIncognitoContextChrome Full support YesEdge Full support 17Firefox Full support 45Opera Full support YesFirefox Android Full support 48
isAllowedFileSchemeAccessChrome Full support YesEdge No support NoFirefox Full support 48Opera Full support YesFirefox Android Full support 48
isAllowedIncognitoAccessChrome Full support YesEdge Full support 17Firefox Full support 48Opera Full support YesFirefox Android Full support 48
lastErrorChrome Full support YesEdge No support NoFirefox Full support 47Opera Full support YesFirefox Android Full support 48
onRequest
DeprecatedNon-standard
Chrome Full support YesEdge No support NoFirefox No support NoOpera Full support YesFirefox Android No support No
onRequestExternal
DeprecatedNon-standard
Chrome Full support YesEdge No support NoFirefox No support NoOpera Full support YesFirefox Android No support No
sendRequest
DeprecatedNon-standard
Chrome Full support YesEdge No support NoFirefox No support NoOpera No support NoFirefox Android No support No
setUpdateUrlDataChrome Full support YesEdge No support NoFirefox No support NoOpera Full support YesFirefox Android No support No

Legend

Full support  
Full support
No support  
No support
Non-standard. Expect poor cross-browser support.
Non-standard. Expect poor cross-browser support.
Deprecated. Not for use in new websites.
Deprecated. Not for use in new websites.
See implementation notes.
See implementation notes.

Example extensions

Acknowledgements

This API is based on Chromium's chrome.extension API. This documentation is derived from extension.json in the Chromium code.

Microsoft Edge compatibility data is supplied by Microsoft Corporation and is included here under the Creative Commons Attribution 3.0 United States License.

Etiquetas y colaboradores del documento

Colaboradores en esta página: ExE-Boss, hellosct1, wbamberg, andrewtruongmoz, abbycar, bsilverberg
Última actualización por: ExE-Boss,