scripting.unregisterContentScripts()

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

注意：此方法在 Chrome 的清单文件 V3 或更高版本以及 Firefox 101 中可用。在 Firefox 102 及更高版本中，此方法在清单文件 V2 中也可用。

要使用此 API，您必须拥有 "scripting" 权限和页面 URL 的权限，可以显式地作为主机权限或使用 activeTab 权限。

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

语法

await browser.scripting.unregisterContentScripts(
  scripts         // object
)

参数

scripts 可选: scripting.ContentScriptFilter。用于识别要注销的动态内容脚本的筛选器。如果未指定，则注销所有动态内容脚本。

返回值

一个 Promise，当所有脚本都注销后，它将以无参数的方式完成。如果发生任何错误，则 promise 将被拒绝。

示例

此示例注销了 ID 为 a-script 的已注册内容脚本

try {
  await browser.scripting.unregisterContentScripts({
    ids: ["a-script"],
  });
} catch (err) {
  console.error(`failed to unregister content scripts: ${err}`);
}

浏览器兼容性

BCD 表格仅在浏览器中加载

注意：此 API 基于 Chromium 的 chrome.scripting API。