scripting.registerContentScripts()

Registriert ein oder mehrere Content-Skripte.

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 nutzen zu können, müssen Sie die "scripting"-Berechtigung und eine Berechtigung für die URL der Seite haben, entweder explizit als Host-Berechtigung oder durch die activeTab-Berechtigung.

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

Syntax

js
await browser.scripting.registerContentScripts(
  scripts         // array
)

Parameter

scripts

array von scripting.RegisteredContentScript. Eine Liste von Skripten, die registriert werden sollen.

Rückgabewert

Ein Promise, das entweder ohne Argumente erfüllt oder bei Fehlern abgelehnt wird. Fehler können während des Skriptparsing und der Dateivalidierung auftreten oder wenn die angegebenen IDs existieren. Wenn ein Fehler auftritt, werden keine Skripte registriert.

Beispiele

Dieses Beispiel registriert ein Content-Skript, das die Datei "script.js" injiziert:

js
const aScript = {
  id: "a-script",
  js: ["script.js"],
  matches: ["https://example.com/*"],
};

try {
  await browser.scripting.registerContentScripts([aScript]);
} catch (err) {
  console.error(`failed to register content scripts: ${err}`);
}

Browser-Kompatibilität

BCD tables only load in the browser

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