userScripts.configureWorld()
為擴充套件配置USER_SCRIPT的執行環境。
對世界配置的更改僅適用於世界的新例項:在文件重新載入之前,配置不會應用於透過使用者指令碼執行而初始化的世界。但是,當配置更新時,瀏覽器可能會撤銷某些特權。例如,如果擴充套件將messaging設定為false,則來自USER_SCRIPT世界的訊息呼叫可能會失敗。
世界配置會一直保留,直到擴充套件程式更新或透過 userScripts.resetWorldConfiguration() 重置配置。
語法
js
let configuredWorld = browser.userScripts.configureWorld(
properties // object
);
引數
properties-
userScripts.WorldProperties。USER_SCRIPT世界配置的詳細資訊。當省略
worldId或字串為空時,更新將應用於預設世界以及所有沒有顯式配置的世界。當指定worldId時,則僅配置該世界。更新預設世界和沒有顯式配置的世界時,如果省略了屬性,將使用
userScripts.WorldProperties的預設值。
返回值
如果請求成功,則返回一個不帶引數的已解析 Promise。如果請求失敗,則返回一個帶有錯誤訊息的拒絕的 Promise。
擴充套件程式示例
瀏覽器相容性
載入中…