userScripts.register()

語法

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

引數

scripts

array of userScripts.RegisteredUserScript。要註冊的使用者指令碼的詳細資訊。

每個 userScripts.RegisteredUserScript 物件必須包含一個非空陣列的 js 屬性，並且在 matches 或 includeGlobs 中包含一個非空陣列。

返回值

一個 Promise，如果所有請求的使用者指令碼都已註冊，則以無引數的形式解析。如果任何使用者指令碼註冊失敗或請求因其他原因失敗，則不會註冊任何指令碼，並且 promise 會因錯誤訊息而被拒絕。

示例

此程式碼段將“hello world”程式碼註冊到 "myScriptId" 執行世界，以便在所有匹配 "*://example.com/*" 的網站上執行。

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

擴充套件程式示例

• userScripts-mv3

瀏覽器相容性