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。

扩展程序示例

浏览器兼容性