contentScripts.RegisteredContentScript

Ein RegisteredContentScript wird durch einen Aufruf von contentScripts.register() zurückgegeben und repräsentiert die in diesem Aufruf registrierten Inhalts-Skripte.

Es definiert eine einzelne Funktion unregister(), die verwendet werden kann, um die Inhalts-Skripte zu deregistrieren.

Hinweis: Wenn dieses Objekt zerstört wird (zum Beispiel, weil es außerhalb des Gültigkeitsbereichs liegt), werden die Inhalts-Skripte automatisch deregistriert. Sie sollten daher eine Referenz auf dieses Objekt behalten, solange Sie möchten, dass die Inhalts-Skripte registriert bleiben.

Methoden

unregister()

Deregistriert die durch dieses Objekt repräsentierten Inhalts-Skripte.

Browser-Kompatibilität

BCD tables only load in the browser

Beispiele

Dieser Code schaltet ein registriertes Inhalts-Skript bei einem Klick auf eine Browser-Aktion um:

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