Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

zh-CN: create UserScripts.UserScriptOptions #24967

Merged
merged 1 commit into from
Dec 18, 2024
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
@@ -0,0 +1,36 @@
---
title: UserScripts.UserScriptOptions
slug: Mozilla/Add-ons/WebExtensions/API/userScripts/UserScriptOptions
l10n:
sourceCommit: d6856a051d0ba078ec1d24b80908b1ca174917db
---

{{AddonSidebar}}

UserScriptOptions 对象表示要注册的内容脚本。它具有与 browser.contentScripts.register 支持的 contentScript 选项类似的语法。不同之处在于:

- 它不支持 CSS 属性(使用 browser.contentScripts.register 动态注册/注销样式表)
- 它支持一个可选的 scriptMetadata 属性(作为一个普通的 JSON 对象,其中包含与注册的 userScripts 关联的一些元数据属性)

UserScriptOptions 对象具有以下属性:

- `allFrames` {{optional_inline}}
- : 与 [`content_scripts`](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/manifest.json/content_scripts) 键中的 `all_frames` 相同。
- `excludeGlobs` {{optional_inline}}
- : 与 [`content_scripts`](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/manifest.json/content_scripts) 键中的 `exclude_globs` 相同。
- `excludeMatches` {{optional_inline}}
- : 与 [`content_scripts`](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/manifest.json/content_scripts) 键中的 `exclude_matches` 相同。
- `includeGlobs` {{optional_inline}}
- : 与 [`content_scripts`](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/manifest.json/content_scripts) 键中的 `include_globs` 相同。
- `js` {{optional_inline}}
- : 一个对象数组。每个对象都有一个名为 `file` 且值为一个从扩展的 manifest.json 开始指向要注册的 JavaScript 文件的 URL 的属性,或者是一个名为 `code` 且包含要注册的一些 JavaScript 代码的属性。
- `matchAboutBlank` {{optional_inline}}
- : 与 [`content_scripts`](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/manifest.json/content_scripts) 键中的 `match_about_blank` 相同。
- `matches`
- : 与 [`content_scripts`](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/manifest.json/content_scripts) 键中的 `matches` 相同。
- `runAt` {{optional_inline}}
- : 与 [`content_scripts`](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/manifest.json/content_scripts) 键中的 `run_at` 相同。
- `scriptMetadata` {{optional_inline}}
- : 一个用户脚本元数据值

它具有与 browser.contentScripts.register 支持的 contentScript 选项类似的语法。
Loading