scripting.updateContentScripts()

Aktualisiert registrierte Inhalts-Skripte. Wenn während des Skriptparsing und der Dateivalidierung 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 diese Methode auch in Manifest V2 verfügbar.

Um diese API verwenden zu können, müssen Sie die Berechtigung "scripting" sowie die Berechtigung für die URL der Seite besitzen, entweder explizit als Host-Berechtigung oder durch Verwendung der activeTab-Berechtigung.

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 zur Aktualisierung. Alle Eigenschaften sind optional, außer id.

Rückgabewert

Ein Promise, das mit einem Array von scripting.RegisteredContentScript erfüllt wird. Wenn ein Fehler auftritt, wird das Versprechen abgelehnt.

Beispiele

Dieses Beispiel aktualisiert ein Inhalts-Skript, das mit der ID a-script registriert ist, 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

Hinweis: Diese API basiert auf Chromiums chrome.scripting API.