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
await browser.scripting.registerContentScripts(
scripts // array
)
Parameter
scripts
-
array
vonscripting.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:
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 der chrome.scripting
-API von Chromium.