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.

Notez que 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

contentScripts.RegisteredContentScript.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
Support simpleChrome Aucun support NonEdge Aucun support NonFirefox Support complet 59Opera Aucun support NonFirefox Android Support complet 59
unregisterChrome Aucun support NonEdge Aucun support NonFirefox Support complet 59Opera Aucun support NonFirefox Android Support complet 59

Légende

Support complet  
Support complet
Aucun support  
Aucun support

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);

 

Étiquettes et contributeurs liés au document

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