userScripts.resetWorldConfiguration()
重置由 userScripts.configureWorld
设置的 USER_SCRIPT
环境的配置为 userScripts.WorldProperties
中指定的默认值。当默认环境被重置时,所有未显式配置的环境也会被重置。
对环境配置的更改仅适用于新实例:在重新加载文档之前,配置不会应用于通过执行文档中的用户脚本而初始化的环境。然而,当更新配置时,浏览器可能会撤销某些权限。例如,如果扩展将 messaging
设置为 false
,USER_SCRIPT
环境中的消息调用可能会失败。
语法
js
let resettingWorldConfiguration = browser.userScripts.resetWorldConfiguration(
worldId // 可选字符串
);
参数
worldId
可选-
string
。要重置的USER_SCRIPT
环境的 ID。如果省略或为空,则重置默认环境和所有未通过userScripts.configureWorld
设置配置的环境。
返回值
一个 Promise
,如果环境配置被重置,则其会不带参数地兑现。如果请求失败,promise 会以错误消息拒绝。