Utilitaires liés à votre extension. Obtenez des URL vers des packages de ressources avec votre extension, récupérez l'objet Window pour les pages de votre extension, récupérez les valeurs pour différents paramètres. Notez que les API de messagerie de ce module sont déconseillées au profit des API équivalentes dans le module runtime.

Types

extension.ViewType
Le type de vue d'extension.

Propriétés

extension.lastError
Défini pour la durée de vie d'un rappel si une extension ansychronique a généré une erreur. Si aucune erreur n'est survenue, lastError sera indéfini.
extension.inIncognitoContext
True pour les scripts de contenu s'exécutant dans les onglets de navigation privée et pour les pages d'extension exécutées dans un processus de navigation privée. Ce dernier ne s'applique qu'aux extensions avec 'incognito_behavior'.

Fonctions

extension.getBackgroundPage()
Renvoie l'objet Window pour la page d'arrière-plan qui s'exécute dans l'extension en cours. Renvoie null si l'extension n'a pas de page d'arrière-plan.
extension.getExtensionTabs()
Renvoie un tableau des objets de la Window JavaScript pour chacun des onglets qui s'exécutent dans l'extension actuelle.
extension.getURL()
Convertit un chemin relatif dans un répertoire d'installation d'extension en une URL complète.
extension.getViews()
Renvoie un tableau des objets Window pour chacune des pages exécutées dans l'extension en cours.
extension.isAllowedIncognitoAccess()
Récupère l'état de l'accès de l'extension en mode navigation privée (déterminé par la case à cocher "Autorisé dans navigation privée").
extension.isAllowedFileSchemeAccess()
Récupère l'état de l'accès de l'extension au schéma 'file://' (déterminé par la case à cocher 'Autoriser l'accès aux URL des fichiers').
extension.setUpdateUrlData()
Définit la valeur du paramètre CGI AP utilisé dans l'URL de mise à jour de l'extension. Cette valeur est ignorée pour les extensions hébergées dans le magasin du fournisseur du navigateur.

Evénements

extension.onRequest
Lancé lorsqu'une requête est envoyée par un processus d'extension ou un script de contenu.
extension.onRequestExternal
Lancé lorsqu'une requête est envoyée depuis une autre extension.
extension.sendRequest()
Envoie une seule requête aux autres écouteurs de l'extension.

Compatibilité du navigateur

 

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxOperaFirefox pour Android
ViewTypeChrome Support complet OuiEdge Aucun support NonFirefox Support complet 45Opera Support complet OuiFirefox Android Support complet 48
getBackgroundPageChrome Support complet OuiEdge Support complet 14Firefox Support complet 45Opera Support complet OuiFirefox Android Support complet 48
getExtensionTabs
ObsolèteNon-standard
Chrome Support complet OuiEdge Aucun support NonFirefox Aucun support NonOpera Aucun support NonFirefox Android Aucun support Non
getURL
ObsolèteNon-standard
Chrome Support complet OuiEdge Support complet 14Firefox Support complet 45Opera Support complet OuiFirefox Android Support complet 48
getViewsChrome Support complet OuiEdge Support complet 14Firefox Support complet 45
Notes
Support complet 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 Support complet OuiFirefox Android Support complet 48
Notes
Support complet 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 Support complet OuiEdge Support complet 17Firefox Support complet 45Opera Support complet OuiFirefox Android Support complet 48
isAllowedFileSchemeAccessChrome Support complet OuiEdge Aucun support NonFirefox Support complet 48Opera Support complet OuiFirefox Android Support complet 48
isAllowedIncognitoAccessChrome Support complet OuiEdge Support complet 17Firefox Support complet 48Opera Support complet OuiFirefox Android Support complet 48
lastErrorChrome Support complet OuiEdge Aucun support NonFirefox Support complet 47Opera Support complet OuiFirefox Android Support complet 48
onRequest
ObsolèteNon-standard
Chrome Support complet OuiEdge Aucun support NonFirefox Aucun support NonOpera Support complet OuiFirefox Android Aucun support Non
onRequestExternal
ObsolèteNon-standard
Chrome Support complet OuiEdge Aucun support NonFirefox Aucun support NonOpera Support complet OuiFirefox Android Aucun support Non
sendRequest
ObsolèteNon-standard
Chrome Support complet OuiEdge Aucun support NonFirefox Aucun support NonOpera Aucun support NonFirefox Android Aucun support Non
setUpdateUrlDataChrome Support complet OuiEdge Aucun support NonFirefox Aucun support NonOpera Support complet OuiFirefox Android Aucun support Non

Légende

Support complet  
Support complet
Aucun support  
Aucun support
Fonctionnalité non-standard. Celle-ci peut être incorrectement supportée par les autres navigateurs.
Fonctionnalité non-standard. Celle-ci peut être incorrectement supportée par les autres navigateurs.
Obsolète. Les nouveaux sites web ne doivent pas utiliser cette fonctionnalité.
Obsolète. Les nouveaux sites web ne doivent pas utiliser cette fonctionnalité.
Voir les notes d'implémentation.
Voir les notes d'implémentation.

Example extensions

 

Remerciements :

Cette API est basée sur l'API Chromium chrome.extension. Cette documentation est dérivée de extension.json dans le code Chromium.

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.

Étiquettes et contributeurs liés au document

Contributeurs à cette page : hellosct1
Dernière mise à jour par : hellosct1,