user_scripts
类型 | 对象 |
---|---|
必填 | 否 |
清单版本 | 2 |
示例 |
json
|
指示浏览器加载打包在扩展中的脚本,称为 API 脚本,该脚本用于导出一组自定义 API 方法以供用户脚本使用。 API 脚本路径相对于 manifest.json 文件,在 "api_script"
中定义为一个 string
。
注意: user_script
键对于 userScripts
API 的正常运作是必需的,即使没有指定 API 脚本。例如: user_scripts: {}
。
API 脚本
- 在内容进程中运行。
- 可以访问与其附加到的网页相关的窗口和文档全局变量。
- 可以访问内容脚本通常可用的 WebExtension API 的同一子集。
该脚本会自动在 userScripts.register
中由 matches
定义的任何网页上执行。但是,这发生在用户脚本沙箱对象创建之前,自定义 API 方法可以导出。
要导出自定义 API 方法,该脚本会监听 userScripts.onBeforeScript
,然后导出自定义 API 方法。
并非每个用户脚本都需要使用所有自定义 API 方法。因此,您可以在运行 userScripts.register
时在 scriptMetadata
中包含所需 API 的详细信息。然后,API 脚本通过 userScripts.onBeforeScript
监听器 (作为 script.metadata
) 收到的 script
参数访问 scriptMetadata
。
浏览器兼容性
BCD 表仅在启用 JavaScript 的浏览器中加载。