userScripts.resetWorldConfiguration()

將由 userScripts.configureWorld 設定的 USER_SCRIPT 世界的配置重置為 userScripts.WorldProperties 中指定的預設值。當預設世界被重置時,所有沒有顯式配置的世界也會被重置。

對世界配置的更改僅適用於世界的*新例項*:配置不會應用到使用者指令碼執行已初始化的世界,直到文件被重新載入。然而,瀏覽器可能會在更新配置時撤銷某些許可權。例如,當 messaging 重置為 false 時,來自 USER_SCRIPT 世界的訊息呼叫可能會失敗。

語法

js
let resettingWorldConfiguration = browser.userScripts.resetWorldConfiguration(
  worldId       // optional string
);

引數

worldId 可選

string 要重置的 USER_SCRIPT 世界的 ID。如果省略或為空,則重置預設世界以及所有未透過 userScripts.configureWorld 設定配置的世界。

返回值

一個 Promise,如果世界配置已重置,則會以無引數的形式 fulfilled。如果請求失敗,則 promise 會被一個錯誤訊息 reject。

擴充套件程式示例

瀏覽器相容性