background

Type Object
Obligatoire No
Exemple
json
"background": {
  "scripts": ["background.js"]
}

Utilisez la clé background pour inclure un ou plusieurs scripts d'arrière-plan, et éventuellement une page d'arrière-plan dans votre extension.

Les scripts d'arrière-plan sont l'endroit pour placer le code qui doit maintenir l'état à long terme, ou effectuer des opérations à long terme, indépendamment de la durée de vie de toutes les pages Web ou les fenêtres du navigateur.

Les scripts d'arrière-plan sont chargés dès que l'extension est chargée et restent chargés jusqu'à ce que l'extension soit désactivée ou désinstallée. Vous pouvez utiliser n'importe laquelle des WebExtension APIs dans le script, tant que vous avez demandé les permissions nécessaires.

Voir la section "Pages arrière-plan" dans l'anatomie d'une WebExtension pour plus de détails.

La clé background est un objet qui peut avoir l'une des deux propriétés suivantes, toutes deux facultatives :

"scripts"

Un ensemble de chaînes, chacune étant un chemin d'accès à une source JavaScript. Le chemin est relatif au fichier manifest.json lui-même. Ce sont les scripts d'arrière-plan qui seront inclus dans l'extension.

Les scripts partagent la même fenêtre globale.

Les scripts sont chargés dans l'ordre où 'ils apparaissent dans le tableau.

Notez qu'il y a un bug affectant les versions de Firefox antérieures à la version 50 : lorsque le débogueur Firefox est ouvert, les scripts ne sont pas toujours chargés dans l'ordre indiqué dans le tableau. Pour contourner ce bug, vous pouvez utiliser la propriété "page" et inclure des scripts de fond de page en utilisant les balises <script>. Ce bug est résolu dans Firefox 50, et à partir de ce moment, les scripts sont toujours chargés dans l'ordre indiqué dans le tableau.

"page"

Note : Si vous souhaitez récupérer un script à partir d'un emplacement distant avec la balise <script> (par exemple : <script src = "https://code.jquery.com/jquery-1.7.1.min.js"> ), vous devrez également modifier la clé content_security_policy dans le fichier manifest.json de votre extension.

Si vous spécifiez des "scripts", une page vide sera créée pour que vos scripts s'exécutent.

Si vous avez besoin de contenu particulier dans la page, vous pouvez définir votre propre page en utilisant l'option "page".

Si vous utilisez cette propriété, vous ne pouvez plus spécifier de scripts de fond à l'aide de «scripts», mais vous pouvez inclure vos propres scripts à partir de la page, tout comme dans une page Web normale.

Exemple

json
 "background": {
    "scripts": ["jquery.js", "my-background.js"]
  }

Chargez deux scripts de fond.

json
  "background": {
    "page": "my-background.html"
  }

Chargez une page d'arrière-plan personnalisée.

Compatibilité des navigateurs

BCD tables only load in the browser