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

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