web_accessible_resources

Type Tableau
Obligatoire Non
Exemple
"web_accessible_resources": [
  "images/my-image.png"
]

Description

Parfois, vous souhaitez associer certaines ressources - par exemple, images, HTML, CSS ou JavaScript - avec votre extension pour les mettre à la disposition des pages Web.

Par exemple, l'extensions d'exemple "beastify" remplace une page web avec des images de certaines bêtes, en ajoutant les élements  <img> dont l'attribut src pointe vers les images sont empaquetées avec l'extension, et pour que la page Web puisse les charger, elles doivent être rendues accessibles sur le Web.

La clé web_accessible_resources liste toutes les ressources que vous souhaitez mettre à la disposition des pages Web de cette façon. Vous les spécifiez comme des chemins relatifs dans le fichier manifest.json.

Notez que les scripts de contenu n'ont pas besoin d'être répertoriés en tant que ressources accessibles sur le Web.

Cependant, si une extension souhaite utiliser l'API webRequest pour rediriger une URL publique (par exemple HTTPS) vers une page empaquetée dans l'extension, l'extension doit lister la page dans votre clé web_accessible_resources.

Utiliser web_accessible_resources

Par exemple, supposons que votre extension inclut un fichier image sur images images/my-image.png, comme ceci :

my-extension-files/
    manifest.json
    my-background-script.js
    images/
        my-image.png

Pour permettre à une page Web de contenir un élément <img> dont l'attribut src pointe sur cette image, vous pouvez spécifier "web_accessible_resources" comme suit :

"web_accessible_resources": ["images/my-image.png"]

Le fichier sera alors disponible en utilisant une URL comme :

moz-extension://<extension-UUID>/images/my-image.png"

<extension-UUID> n'est pas l'identifiant de votre extension. Il est généré de manière aléatoire pour chaque instance de navigateur. Cela empêche les sites Web de prendre des empreintes digitales sur un navigateur en examinant les extensions qu'il a installées..

Le moyen le plus simple d'obtenir cette URL depuis votre extension est d'utiliser l'API  browser.extension.getURL, et de lui donner le chemin relatif à manifest.json:

browser.extension.getURL("images/my-image.png");
// something like:
// moz-extension://944cfddf-7a95-3c47-bd9a-663b3ce8d699/images/my-image.png

Caractères génériques

web_accessible_resources peuvent contenir des caractères génériques. Par exemple, l'entrée suivante fonctionnera également pour inclure la ressource à  "images/my-image.png":

  "web_accessible_resources": ["images/*.png"]

Sécurité

Notez que si vous créez une page accessible sur le Web, n'importe quel site Web peut alors lier ou rediriger vers cette page. La page doit ensuite traiter toute entrée (données POST, par exemple) comme si elle provenait d'une source non fiable, tout comme une page Web normale.

Exemple

"web_accessible_resources": ["images/my-image.png"]

Crée un fichier dans "images/my-image.png" accessible sur le web.

Compatibilité du navigateur

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxOperaFirefox pour Android
Support simpleChrome Support complet OuiEdge Support complet 14Firefox Support complet 48Opera Support complet OuiFirefox Android Support complet 48

Légende

Support complet  
Support complet

Étiquettes et contributeurs liés au document

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