scripting.unregisterContentScripts()

Registriert einen oder mehrere Inhaltsskripte ab.

Hinweis: Diese Methode ist in Manifest V3 oder höher in Chrome und Firefox 101 verfügbar. In Firefox 102+ ist diese Methode auch in Manifest V2 verfügbar.

Um diese API zu nutzen, müssen Sie die "scripting" Berechtigung und die Berechtigung für die URL der Seite haben, entweder explizit als Host-Berechtigung oder mit der activeTab-Berechtigung.

Dies ist eine asynchrone Funktion, die ein Promise zurückgibt.

Syntax

js
await browser.scripting.unregisterContentScripts(
  scripts         // object
)

Parameter

scripts Optional

scripting.ContentScriptFilter. Ein Filter zur Identifizierung der dynamischen Inhaltsskripte, die abgeriegelt werden sollen. Wenn nicht angegeben, werden alle dynamischen Inhaltsskripte abgeriegelt.

Rückgabewert

Ein Promise, das ohne Argumente erfüllt wird, wenn alle Skripte abgeriegelt sind. Tritt ein Fehler auf, wird das Promise abgelehnt.

Beispiele

Dieses Beispiel registriert ein registriertes Inhaltsskript mit der ID a-script ab:

js
try {
  await browser.scripting.unregisterContentScripts({
    ids: ["a-script"],
  });
} catch (err) {
  console.error(`failed to unregister content scripts: ${err}`);
}

Browser-Kompatibilität

BCD tables only load in the browser

Hinweis: Diese API basiert auf der chrome.scripting API von Chromium.