Utilisez cette API pour enregistrer des scripts de contenu. L'enregistrement d'un script de contenu demande au navigateur d'insérer les scripts de contenu donnés dans des pages correspondant aux modèles d'URL donnés.

Cette API est très similaire à la clé manifest.json "content_scripts", sauf qu'avec  "content_scripts" , l'ensemble des scripts de contenu et des modèles associés est fixé au moment de l'installation. Avec l'API contentScripts, une extension peut enregistrer et désenregistrer des scripts lors de l'exécution.

Pour utiliser l'API, appelez contentScripts.register() en transmettant un objet définissant les scripts à enregistrer,les modèles d'URL et d'autres options. Cela renvoie une Promise résolue avec un objet contentScripts.RegisteredContentScript.

L'objet RegisteredContentScript représente les scripts enregistrés dans l'appel register() . Il définit une méthode unregister() que vous pouvez utiliser pour annuler l'inscription des scripts de contenu. Les scripts de contenu sont également désenregistrés automatiquement lorsque la page qui les a créés est détruite. Par exemple, s'ils sont enregistrés à partir de la page d'arrière-plan, ils seront automatiquement désenregistrés lorsque la page d'arrière-plan est détruite et s'ils sont enregistrés depuis une barre latérale ou une fenêtre contextuelle, ils seront automatiquement désinscrits.

Il n'y a pas de permission de l'API contentScripts, mais une extension doit disposer des permissions d'hôte appropriées pour tous les modèles qu'elle transmet à register().

Types

contentScripts.RegisteredContentScript

Un objet de ce type est renvoyé par la fonction  contentScripts.register(). Il représente les scripts de contenu enregistrés par cet appel et peut être utilisé pour annuler l'enregistrement du script de contenu.

Fonctions

contentScripts.register()
Enregistre les scripts de contenu donnés.

Compatibilité du navigateur

ChromeEdgeFirefoxFirefox for AndroidOpera
RegisteredContentScript Non Non5959 Non
RegisteredContentScript.unregister Non Non5959 Non
register Non Non5959 Non

 

Example extensions

Étiquettes et contributeurs liés au document

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