userScripts.update()

scripts

array von userScripts.RegisteredUserScript. Details der zu aktualisierenden Benutzerskripte.

Eigenschaften, die null sind oder weggelassen werden, werden nicht geändert. Das Übergeben eines leeren Arrays an matches, excludeMatches, globs und excludeGlobs löscht diese Eigenschaften.

Ein Promise, das ohne Argumente erfüllt wird, wenn alle angeforderten Benutzerskripte aktualisiert werden. Wenn das Aktualisieren eines Benutzerskripts fehlschlägt oder die Anforderung aus einem anderen Grund fehlschlägt, werden keine Skripte aktualisiert, und das Promise wird mit einer Fehlermeldung zurückgewiesen.

Dieses Beispiel zeigt zwei Aktualisierungen von Benutzerskripten. Die erste Aktualisierung schlägt fehl, da versucht wird, eine ungültige Skriptregistrierung zu erstellen. Das zweite Beispiel zeigt eine erfolgreiche Aktualisierung.

// Valid registration:
await browser.userScripts.register([
  {
    worldId: "myScriptId",
    js: [{ code: "console.log('Hello world!');" }],
    matches: ["*://example.com/*"],
  },
]);

// Invalid! Would result in script without matches or includeGlobs!
await browser.userScripts.update([{ matches: [] }]);

// Valid: replaces matches with includeGlobs.
await browser.userScripts.update([
  {
    matches: [],
    includeGlobs: ["*example*"],
  },
]);

• userScripts-mv3