scripting.registerContentScripts()
Registriert ein oder mehrere Inhalts-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 aufzurufen, müssen Sie die "scripting" Berechtigung haben. Um das injizierte Skript auszuführen, muss die Erweiterung über eine Berechtigung für die URL der Seite verfügen, entweder explizit als Host-Berechtigung oder unter Verwendung der activeTab-Berechtigung.
Syntax
await browser.scripting.registerContentScripts(
scripts // array
)
Parameter
scripts-
arrayvonscripting.RegisteredContentScript. Eine Liste von Skripten, die registriert werden sollen.
Rückgabewert
Ein Promise, das ohne Argumente erfüllt wird oder abgelehnt wird, wenn Fehler auftreten. Fehler können während der Skript-Analyse und Datei-Validierung auftreten oder wenn die angegebenen IDs existieren. Wenn ein Fehler auftritt, werden keine Skripte registriert.
Beispiele
Dieses Beispiel registriert ein Inhalts-Skript, das die Datei "script.js" injiziert:
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
Loading…
Hinweis:
Diese API basiert auf Chromiums chrome.scripting API.