scripting.registerContentScripts()

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

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

要使用此 API，您必须拥有 "scripting" 权限以及页面 URL 的权限，可以将其作为主机权限明确指定，也可以使用 activeTab 权限。

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

语法

await browser.scripting.registerContentScripts(
  scripts         // array
)

参数

scripts: scripting.RegisteredContentScript 的 数组。要注册的脚本列表。

返回值

一个 Promise，在没有参数的情况下完成，或者在发生错误时被拒绝。错误可能发生在脚本解析和文件验证期间，或者如果指定的 ID 已存在。当发生错误时，不会注册任何脚本。

示例

此示例注册一个内容脚本，该脚本注入文件 "script.js"

const aScript = {
  id: "a-script",
  js: ["script.js"],
  matches: ["https://example.com/*"],
};

try {
  await browser.scripting.registerContentScripts([aScript]);
} catch (err) {
  console.error(`failed to register content scripts: ${err}`);
}

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

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