contentScripts.RegisteredContentScript

Un RegisteredContentScript est renvoyé par un appel à  contentScripts.register() et représente les scripts de contenu enregistrés dans cet appel.

Il définit une seule fonction unregister(), qui peut être utilisée pour annuler l'enregistrement des scripts de contenu.

Note: Si cet objet est détruit (par exemple parce qu'il est hors de portée), les scripts de contenu seront automatiquement désinscrits. Vous devriez donc garder une référence à cet objet aussi longtemps que vous voulez que les scripts de contenu restent enregistrés.

Méthodes

unregister()
Annule l'inscription des scripts de contenu représentés par cet objet.

Compatibilité du navigateur

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxOperaFirefox pour Android
RegisteredContentScriptChrome Aucun support Non
Notes
Aucun support Non
Notes
Notes There is a polyfill available.
Edge Aucun support NonFirefox Support complet 59Opera Aucun support NonFirefox Android Support complet 59
unregisterChrome Aucun support Non
Notes
Aucun support Non
Notes
Notes There is a polyfill available.
Edge Aucun support NonFirefox Support complet 59Opera Aucun support NonFirefox Android Support complet 59

Légende

Support complet  
Support complet
Aucun support  
Aucun support
Voir les notes d'implémentation.
Voir les notes d'implémentation.

Exemples

Ce code permet de basculer un script de contenu enregistré sur un clic d'action du navigateur :

var registered = null;

async function register() {

  registered = await browser.contentScripts.register({
    matches: ["*://*.org/*"],
    js: [{
      code: "document.body.innerHTML = '<h1>This page has been eaten<h1>'"
    }],
    runAt: "document_idle"
  });

}

function toggle() {
  if (registered) {
    registered.unregister();
    registered = null;
  } else {
    register();
  }
}

browser.browserAction.onClicked.addListener(toggle);