scripting.unregisterContentScripts()

注销一个或多个内容脚本。

备注： 该方法在 Chrome 和 Firefox 101 的 Manifest V3 或更高版本中可用。在 Firefox 102+ 中，你也可以在 Manifest V2 中使用该方法。

要使用该方法，你必须取得 "scripting" 权限 以及页面的 URL 权限，可以是明确的主机权限，也可以使用 activeTab 权限。

这是一个返回 Promise 的异步函数。

语法

js
await browser.scripting.unregisterContentScripts(
  scripts         // 对象
)

参数

scripts 可选

scripting.ContentScriptFilter。用于识别要注销的动态内容脚本的过滤器。如果未指定则会注销所有动态内容脚本。

返回值

Promise，当所有脚本都被注销时将不带参数地兑现。如果发生了错误，则该 promise 将被拒绝。

示例

该示例注销以 ID a-script 注册的内容脚本：

js
try {
  await browser.scripting.unregisterContentScripts({
    ids: ["a-script"],
  });
} catch (err) {
  console.error(`无法注销内容脚本：${err}`);
}

浏览器兼容性

BCD tables only load in the browser

备注： 该 API 基于 Chromium 的 chrome.scripting API。