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

ChromeEdgeFirefoxFirefox for AndroidOpera
ViewType Oui Non4548 Oui
getBackgroundPage Oui144548 Oui
getExtensionTabs Oui Non Non Non Non
getURL Oui144548 Oui
getViews Oui1445 *48 * Oui
inIncognitoContext Oui174548 Oui
isAllowedFileSchemeAccess Oui Non4848 Oui
isAllowedIncognitoAccess Oui174848 Oui
lastError Oui Non4748 Oui
onRequest Oui Non Non Non Oui
onRequestExternal Oui Non Non Non Oui
sendRequest Oui Non Non Non Non
setUpdateUrlData Oui Non Non Non Oui

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,