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。
扩展程序示例
浏览器兼容性
加载中…