browser.extension

Description

L'API chrome.extension dispose d'utilitaires qui peuvent être utilisés par n'importe quelle page d'extension. Elle permet d'échanger des messages entre une extension et ses scripts de contenu, ou entre des extensions, comme décrit en détail dans Transmission de messages.

Types

ViewType

Chrome 44+ browser.* depuis Chrome 148

Type de vue de l'extension.

Énumération

"tab"

"popup"

Propriétés

inIncognitoContext

"True" pour les scripts de contenu s'exécutant dans des onglets de navigation privée et pour les pages d'extension s'exécutant dans un processus de navigation privée. Cette dernière ne s'applique qu'aux extensions dont le paramètre "incognito_behavior" est défini sur "split".

Type

booléen

Méthodes

getBackgroundPage()

Premier plan uniquement 
browser.extension.getBackgroundPage(): Window | undefined

Renvoie l'objet JavaScript "window" pour la page d'arrière-plan exécutée dans l'extension actuelle. Renvoie la valeur "null" si l'extension n'a pas de page d'arrière-plan.

Renvoie

  • Fenêtre | undefined

getViews()

Premier plan uniquement 
browser.extension.getViews(
  fetchProperties?: object,
): Window[]

Renvoie un tableau des objets "window" JavaScript pour chacune des pages exécutées dans l'extension actuelle.

Paramètres

  • fetchProperties

    objet facultatif

    • tabId

      number facultatif

      Chrome 54 ou version ultérieure browser.* depuis Chrome 148

      Recherchez une vue en fonction d'un ID d'onglet. Si ce champ est omis, toutes les vues sont renvoyées.

    • type

      ViewType (facultatif)

      Type de vue à obtenir. Si ce paramètre est omis, toutes les vues sont renvoyées (y compris les pages et les onglets en arrière-plan).

    • windowId

      number facultatif

      Fenêtre à laquelle limiter la recherche. Si ce paramètre est omis, toutes les vues sont renvoyées.

Renvoie

  • Window[]

    Tableau d'objets globaux

isAllowedFileSchemeAccess()

browser.extension.isAllowedFileSchemeAccess(): Promise<boolean>

Récupère l'état de l'accès de l'extension au schéma "file://". Cela correspond au paramètre "Autoriser l'accès aux URL de fichier" par extension, contrôlé par l'utilisateur et accessible via la page chrome://extensions.

Renvoie

  • Promise<boolean>

    Chrome 99+ browser.* depuis Chrome 148

isAllowedIncognitoAccess()

browser.extension.isAllowedIncognitoAccess(): Promise<boolean>

Récupère l'état de l'accès de l'extension au mode navigation privée. Cela correspond au paramètre "Autoriser en mode navigation privée" contrôlé par l'utilisateur pour chaque extension, accessible via la page chrome://extensions.

Renvoie

  • Promise<boolean>

    Chrome 99+ browser.* depuis Chrome 148

setUpdateUrlData()

browser.extension.setUpdateUrlData(
  data: string,
): void

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 la galerie d'extensions Chrome.

Paramètres

  • données

    chaîne