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
。