scripting.unregisterContentScripts()

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

注意:此方法在 Chrome 的 Manifest V3 或更高版本以及 Firefox 101 中可用。在 Firefox 102+ 中,此方法在 Manifest V2 中也可用。

要使用此 API,您必须拥有 "scripting" 权限,并且拥有页面 URL 的权限,该权限可以明确地作为 主机权限,或者使用 activeTab 权限

这是一个异步函数,返回一个 Promise

语法

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

参数

scripts 可选

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

返回值

一个 Promise,当所有脚本都已注销时,它将以无参数的形式解析。如果发生任何错误,Promise 将被拒绝。

示例

此示例注销一个已注册的内容脚本,其 ID 为 a-script

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

浏览器兼容性

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