userScripts.register()

注册扩展的用户脚本。

语法

js
let registeredUserScript = browser.userScripts.register(
  scripts       // array of objects
)

参数

scripts

array of userScripts.RegisteredUserScript。要注册的用户脚本的详细信息。

每个 userScripts.RegisteredUserScript 对象必须包含一个非空数组的 js 属性,并且在 matchesincludeGlobs 中包含一个非空数组。

返回值

一个 Promise,如果所有请求的用户脚本都已注册,则以无参数的形式解析。如果任何用户脚本注册失败或请求因其他原因失败,则不会注册任何脚本,并且 promise 会因错误消息而被拒绝。

示例

此代码段将“hello world”代码注册到 "myScriptId" 执行世界,以便在所有匹配 "*://example.com/*" 的网站上运行。

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

扩展程序示例

浏览器兼容性