内容脚本
使用此 API 注册内容脚本。注册内容脚本会指示浏览器将给定的内容脚本插入到与给定 URL 模式匹配的页面中。
注意:使用清单 V3 或更高版本时,请使用scripting.registerContentScripts()
来注册脚本。
此 API 与"content_scripts"
manifest.json
密钥非常相似,区别在于使用 "content_scripts"
时,内容脚本集和关联模式在安装时是固定的。使用 contentScripts
API,扩展程序可以在运行时注册和注销脚本。
要使用此 API,请调用contentScripts.register()
并传入一个对象,该对象定义要注册的脚本、URL 模式和其他选项。这将返回一个Promise
,该对象解析为一个contentScripts.RegisteredContentScript
对象。
RegisteredContentScript
对象表示在 register()
调用中注册的脚本。它定义了一个 unregister()
方法,您可以使用该方法注销内容脚本。当创建它们的页面被销毁时,内容脚本也会自动注销。例如,如果它们是从后台页面注册的,则当后台页面被销毁时,它们将自动注销;如果它们是从侧边栏或弹出窗口注册的,则当侧边栏或弹出窗口关闭时,它们将自动注销。
没有 contentScripts
API 权限,但扩展程序必须具有与其传递给 register()
的任何模式相关的适当主机权限。
类型
contentScripts.RegisteredContentScript
-
此类型的对象由
contentScripts.register()
函数返回。它表示通过该调用注册的内容脚本,可用于注销内容脚本。
函数
contentScripts.register()
-
注册给定的内容脚本。
浏览器兼容性
BCD 表格仅在启用了 JavaScript 的浏览器中加载。