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

js
await browser.scripting.updateContentScripts(
  scripts         // object
)

Parameter

scripts

array von scripting.RegisteredContentScript. Details eines Skripts, das aktualisiert werden soll. Alle Eigenschaften sind optional, außer id.

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:

js
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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
updateContentScripts

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
See implementation notes.

Hinweis: Diese API basiert auf der chrome.scripting API von Chromium.