API > wxt > BaseContentScriptEntrypointOptions

Interface: BaseContentScriptEntrypointOptions

Contents

• Extends
• Properties
  • allFrames
  • cssInjectionMode
  • exclude
  • excludeGlobs
  • excludeMatches
  • globalName
  • include
  • includeGlobs
  • matchAboutBlank
  • matchOriginAsFallback
  • matches
  • registration
  • runAt

Extends

• BaseEntrypointOptions

Properties

allFrames

allFrames?: PerBrowserOption<undefined | boolean>

See https://developer.chrome.com/docs/extensions/mv3/content_scripts/

Default

false

Source

packages/wxt/src/types.ts:621

---

cssInjectionMode

cssInjectionMode?: PerBrowserOption<"manifest" | "manual" | "ui">

Customize how imported/generated styles are injected with the content script. Regardless of the mode selected, CSS will always be built and included in the output directory.

• "manifest" - Include the CSS in the manifest, under the content script's css array.
• "manual" - Exclude the CSS from the manifest. You are responsible for manually loading it onto the page. Use browser.runtime.getURL("content-scripts/<name>.css") to get the file's URL
• "ui" - Exclude the CSS from the manifest. CSS will be automatically added to your UI when calling createShadowRootUi

Default

"manifest"

Source

packages/wxt/src/types.ts:640

---

exclude

exclude?: string[]

List of target browsers to exclude this entrypoint from. Cannot be used with include. You must choose one of the two options.

Default

undefined

Inherited from

BaseEntrypointOptions.exclude

Source

packages/wxt/src/types.ts:553

---

excludeGlobs

excludeGlobs?: PerBrowserOption<undefined | string[]>

See https://developer.chrome.com/docs/extensions/mv3/content_scripts/

Default

[]

Source

packages/wxt/src/types.ts:616

---

excludeMatches

excludeMatches?: PerBrowserOption<undefined | string[]>

See https://developer.chrome.com/docs/extensions/mv3/content_scripts/

Default

[]

Source

packages/wxt/src/types.ts:606

---

globalName

globalName?: string | boolean | (entrypoint) => string

The variable name for the IIFE in the JS output bundle.

This option is for content scripts with world=MAIN, and unlisted scripts. It's relevant for scripts that are inserted into the page context where the default IIFE variable name may conflict with an existing variable on the target page. This applies to content scripts with world=MAIN, and others, such as unlisted scripts, that could be dynamically injected into the page with a <script> tag.

Available options:

• true: automatically generate a name for the IIFE based on the entrypoint name
• false: Output the IIFE without a variable name, making it anonymous. This is the safest option to avoid conflicts with existing variables on the page. This will become the default in a future version of WXT.
• string: Use the provided string as the global variable name.
• function: A function that receives the entrypoint and returns a string to use as the variable name.

Default

true

Inherited from

BaseEntrypointOptions.globalName

Source

packages/wxt/src/types.ts:572

---

include

include?: string[]

List of target browsers to include this entrypoint in. Defaults to being included in all builds. Cannot be used with exclude. You must choose one of the two options.

Default

undefined

Inherited from

BaseEntrypointOptions.include

Source

packages/wxt/src/types.ts:546

---

includeGlobs

includeGlobs?: PerBrowserOption<undefined | string[]>

See https://developer.chrome.com/docs/extensions/mv3/content_scripts/

Default

[]

Source

packages/wxt/src/types.ts:611

---

matchAboutBlank

matchAboutBlank?: PerBrowserOption<undefined | boolean>

See https://developer.chrome.com/docs/extensions/mv3/content_scripts/

Default

false

Source

packages/wxt/src/types.ts:599

---

matchOriginAsFallback

matchOriginAsFallback?: PerBrowserOption<boolean>

See https://developer.chrome.com/docs/extensions/mv3/content_scripts/

Default

false

Source

packages/wxt/src/types.ts:626

---

matches

matches?: PerBrowserOption<string[]>

Source

packages/wxt/src/types.ts:589

---

registration

registration?: PerBrowserOption<"runtime" | "manifest">

Specify how the content script is registered.

• "manifest": The content script will be added to the content_scripts entry in the manifest. This is the normal and most well known way of registering a content script.
• "runtime": The content script's matches is added to host_permissions and you are responsible for using the scripting API to register/execute the content script dynamically at runtime.

Default

"manifest"

Source

packages/wxt/src/types.ts:652

---

runAt

runAt?: PerBrowserOption<undefined | RunAt>

See https://developer.chrome.com/docs/extensions/mv3/content_scripts/

Default

"documentIdle"

Source

packages/wxt/src/types.ts:594

---

Generated using typedoc-plugin-markdown and TypeDoc