scripting.getRegisteredContentScripts()

Gibt alle mit scripting.registerContentScripts() registrierten Inhalts-Skripte oder eine Teilmenge der registrierten Skripte zurück, wenn ein Filter verwendet wird.

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

Um diese API zu verwenden, müssen Sie die "scripting" Berechtigung und die Berechtigung für die URL der Seite besitzen, entweder explizit als Host-Berechtigung oder unter Verwendung der activeTab-Berechtigung.

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

Syntax

js
let scripts = await browser.scripting.getRegisteredContentScripts(
  filter          // object
)

Parameter

filter Optional

scripting.ContentScriptFilter. Ein Filter für die zu rückgebenden Details der registrierten Skripte.

Rückgabewert

Ein Promise, das ein Array von scripting.RegisteredContentScript zurückgibt. Falls ein Fehler auftritt, wird das Promise abgelehnt.

Beispiele

Dieses Beispiel gibt alle registrierten Inhalts-Skripte zurück:

js
// Register two content scripts.
await browser.scripting.registerContentScripts([
  {
    id: "script-1",
    js: ["script-1.js"],
    matches: ["*://example.com/*"],
  },
  {
    id: "script-2",
    js: ["script-2.js"],
    matches: ["*://example.com/*"],
  },
]);

// Retrieve all content scripts.
let scripts = await browser.scripting.getRegisteredContentScripts();
console.log(scripts.map((script) => script.id)); // ["script-1", "script-2"]

// Only retrieve the second script.
scripts = await browser.scripting.getRegisteredContentScripts({
  ids: ["script-2"],
});
console.log(scripts.map((script) => script.id)); // ["script-2"]

Browser-Kompatibilität

BCD tables only load in the browser

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