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é des navigateurs

BCD tables only load in the browser

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