userScripts.update()

Syntax

let updatingUserScript = browser.userScripts.update(
  scripts       // array of objects
);

Parameters

scripts

array of userScripts.RegisteredUserScript. Details of user scripts to update.

Properties that are null or omitted are not changed. Passing an empty array to matches, excludeMatches, globs, and excludeGlobs clears these properties.

Return value

A Promise fulfilled with no arguments if all the requested user scripts are updated. If any user scripts fail to update or the request fails for another reason, none of the scripts are updated, and the promise is rejected with an error message.

Examples

This snippet shows two examples of updates to a user scripts. The first update fails because it attempts to create an invalid script registration. The second example shows a successful update.

// 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*"],
  },
]);

Example extensions

• userScripts-mv3

Browser compatibility