scripting.updateContentScripts()
Aktualisiert registrierte Inhaltsskripte. Wenn es Fehler bei der Skriptanalyse und Dateivalidierung gibt oder wenn die angegebenen IDs nicht existieren, werden keine Skripte aktualisiert.
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 Berechtigung "scripting"
permission haben. Um das eingefügte Skript auszuführen, muss die Erweiterung die Berechtigung für die URL der Seite haben, entweder explizit als host permission oder unter Verwendung der activeTab permission.
Syntax
await browser.scripting.updateContentScripts(
scripts // object
)
Parameter
scripts
-
array
vonscripting.RegisteredContentScript
. Details eines Skriptes, das aktualisiert werden soll. Alle Eigenschaften sind optional, außerid
.
Rückgabewert
Ein Promise
, das mit einem Array von scripting.RegisteredContentScript
erfüllt wird. Wenn ein Fehler auftritt, wird das Promise abgelehnt.
Beispiele
Dieses Beispiel aktualisiert ein Inhaltsskript, das mit der ID a-script
registriert ist, indem allFrames
auf true
gesetzt wird:
try {
await browser.scripting.registerContentScripts([
{
id: "a-script",
js: ["script.js"],
matches: ["*://example.org/*"],
},
]);
// Update content script registered before to allow execution
// in all frames:
await browser.scripting.updateContentScripts([
{
id: "a-script",
allFrames: true,
},
]);
} catch (err) {
console.error(`failed to register or update content scripts: ${err}`);
}
Browser-Kompatibilität
Loading…
Hinweis:
Diese API basiert auf Chromiums chrome.scripting
API.