此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

userScripts.RegisteredUserScript

表示已注册用户脚本的对象。由 userScripts.getScripts() 返回,并用作 userScripts.register() 和 userScripts.update() 的输入。

类型

此类型的值是包含以下属性的对象:

allFrames 可选

boolean。如果 allFrames 为 true,脚本将注入到页面的所有框架中。默认情况下为 false,此时脚本仅注入到顶层框架中。

id

string。用户脚本的 ID。该属性不得以“_”开头,因为它是为生成的脚本保留的脚本 ID 的前缀。

js 对于 userScripts.update() 是 可选 的,而对于 userScripts.register() 是必需的

userScripts.ScriptSource 的数组(array)。要注入到匹配页面的脚本。

matches 可选

string 的数组(array)。用于匹配执行脚本的页面的匹配模式。在 userScripts.register() 调用中必须指定 matches 或 includeGlobs 其中之一。

excludeMatches 可选

string 的数组(array)。用于匹配不应让脚本执行的页面的匹配模式。

includeGlobs 可选

string。用于匹配执行脚本的页面的 glob 模式。在 userScripts.register() 调用中必须指定 matches 或 includeGlobs 其中之一。

excludeGlobs 可选

string。用于匹配不应让脚本执行的页面的 glob 模式。

runAt 可选

extensionTypes.RunAt。脚本注入到标签页的最早时间。默认为 "document_idle"。

world 可选

userScripts.ExecutionWorld。运行脚本的执行环境。默认为 "USER_SCRIPT"。

worldId 可选

string。脚本执行的用户脚本环境的 ID。仅当 world 为 USER_SCRIPT 或省略时有效。如果省略 worldId,脚本将在默认的 USER_SCRIPT 环境("")中执行。以下划线(_)开头的值是保留的。最大长度为 256 个字符。一个环境可以被多个脚本用作其执行环境。要配置环境的行为,请在第一个脚本在该环境中执行之前,将其 worldId 传入 userScripts.configureWorld。

浏览器兼容性