scripting.registerContentScripts()
Registriert ein oder mehrere Content-Skripte.
Hinweis: Diese Methode ist in Manifest V3 oder höher in Chrome und ab Firefox 101 verfügbar. Ab Firefox 102 ist sie auch in Manifest V2 verfügbar.
Um diese API aufzurufen, benötigen Sie die scripting-Berechtigung. Damit das eingefügte Skript ausgeführt werden kann, muss die Erweiterung über eine Berechtigung für die URL der Seite verfügen, entweder ausdrücklich als Host-Berechtigung oder über die activeTab-Berechtigung.
Syntax
await browser.scripting.registerContentScripts(
scripts // array
)
Parameter
scripts-
arrayvonscripting.RegisteredContentScript. Eine Liste der zu registrierenden Skripte.
Rückgabewert
Ein Promise, das ohne Argumente erfüllt oder bei Fehlern abgelehnt wird. Fehler können beim Parsen von Skripten und beim Validieren von Dateien auftreten oder wenn die angegebenen IDs bereits existieren. Tritt ein Fehler auf, wird keines der Skripte registriert.
Beispiele
Dieses Beispiel registriert ein Content-Skript, das die Datei "script.js" einfügt:
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.