scripting.updateContentScripts()
Aktualisiert registrierte Content-Skripte. Wenn beim Parsen der Skripte oder bei der Validierung der Dateien Fehler auftreten oder 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 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.updateContentScripts(
scripts // object
)
Parameter
scripts-
arrayvonscripting.RegisteredContentScript. Angaben zu einem Skript, das aktualisiert werden soll. Mit Ausnahme vonidsind alle Eigenschaften optional.
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 aktualisiert ein unter der ID a-script registriertes Content-Skript, indem es allFrames auf true setzt:
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
Hinweis:
Diese API basiert auf Chromiums chrome.scripting-API.