scripting.updateContentScripts()
Aktualisiert registrierte Inhalts-Skripte. Wenn während der Skript-Analyse und der Dateiüberprüfung Fehler auftreten 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 zu verwenden, müssen Sie die Berechtigung "scripting"
und die Berechtigung für die URL der Seite entweder explizit als Host-Berechtigung oder mithilfe der activeTab-Berechtigung besitzen.
Dies ist eine asynchrone Funktion, die ein Promise
zurückgibt.
Syntax
await browser.scripting.updateContentScripts(
scripts // object
)
Parameter
scripts
-
array
vonscripting.RegisteredContentScript
. Details eines Skripts, das aktualisiert werden soll. Alle Eigenschaften sind optional, außerid
.
Rückgabewert
Ein Promise
, das mit einem Array von scripting.RegisteredContentScript
erfüllt wird. Tritt ein Fehler auf, wird das Versprechen abgelehnt.
Beispiele
Dieses Beispiel aktualisiert ein Content-Skript, das mit der ID a-script
registriert wurde, 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
BCD tables only load in the browser
Hinweis: Diese API basiert auf der chrome.scripting
API von Chromium.