scripting.getRegisteredContentScripts()
Gibt alle mit scripting.registerContentScripts() registrierten Content Scripts zurück oder, wenn ein Filter verwendet wird, eine Teilmenge der registrierten Skripte.
Hinweis: Diese Methode ist in Manifest V3 oder höher in Chrome und ab Firefox 101 verfügbar. Ab Firefox 102 ist diese Methode auch in Manifest V2 verfügbar.
Um diese API zu verwenden, benötigen Sie die scripting-Berechtigung. Um Skripte auszuführen, 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.
Dies ist eine asynchrone Funktion, die ein Promise zurückgibt.
Syntax
let scripts = await browser.scripting.getRegisteredContentScripts(
filter // object
)
Parameter
filterOptional-
scripting.ContentScriptFilter. Ein Filter für die zurückzugebenden Details der registrierten Skripte.
Rückgabewert
Ein Promise, das mit einem Array von scripting.RegisteredContentScript erfüllt wird. Tritt ein Fehler auf, wird das Promise zurückgewiesen.
Beispiele
Dieses Beispiel gibt alle registrierten Content Scripts zurück:
// Register two content scripts.
await browser.scripting.registerContentScripts([
{
id: "script-1",
js: ["script-1.js"],
matches: ["*://example.com/*"],
},
{
id: "script-2",
js: ["script-2.js"],
matches: ["*://example.com/*"],
},
]);
// Retrieve all content scripts.
let scripts = await browser.scripting.getRegisteredContentScripts();
console.log(scripts.map((script) => script.id)); // ["script-1", "script-2"]
// Only retrieve the second script.
scripts = await browser.scripting.getRegisteredContentScripts({
ids: ["script-2"],
});
console.log(scripts.map((script) => script.id)); // ["script-2"]
Browser-Kompatibilität
Hinweis:
Diese API basiert auf der chrome.scripting-API von Chromium.