Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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 zu nutzen, müssen Sie die "scripting"- Berechtigung sowie die Berechtigung für die URL der Seite haben, entweder explizit als Host-Berechtigung oder unter Verwendung der 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 ohne Argumente erfüllt wird oder zurückgewiesen wird, wenn Fehler auftreten. Fehler können während der Skript-Analyse und Datei-Validierung oder wenn die angegebenen IDs existieren, auftreten. Tritt ein Fehler auf, werden keine Skripte registriert.

Beispiele

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

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

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

Browser-Kompatibilität

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