userScripts.configureWorld()

為擴充套件配置USER_SCRIPT的執行環境。

對世界配置的更改僅適用於世界的新例項:在文件重新載入之前,配置不會應用於透過使用者指令碼執行而初始化的世界。但是,當配置更新時,瀏覽器可能會撤銷某些特權。例如,如果擴充套件將messaging設定為false,則來自USER_SCRIPT世界的訊息呼叫可能會失敗。

世界配置會一直保留,直到擴充套件程式更新或透過 userScripts.resetWorldConfiguration() 重置配置。

語法

js
let configuredWorld = browser.userScripts.configureWorld(
  properties       // object
);

引數

properties

userScripts.WorldPropertiesUSER_SCRIPT世界配置的詳細資訊。

當省略worldId或字串為空時,更新將應用於預設世界以及所有沒有顯式配置的世界。當指定worldId時,則僅配置該世界。

更新預設世界和沒有顯式配置的世界時,如果省略了屬性,將使用 userScripts.WorldProperties 的預設值。

返回值

如果請求成功,則返回一個不帶引數的已解析 Promise。如果請求失敗,則返回一個帶有錯誤訊息的拒絕的 Promise。

擴充套件程式示例

瀏覽器相容性