Skip to content

API > wxt > IsolatedWorldContentScriptDefinition

Interface: IsolatedWorldContentScriptDefinition

Contents

Extends

Properties

allFrames

allFrames?: PerBrowserOption<undefined | boolean>

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

Default

ts
false

Inherited from

IsolatedWorldContentScriptEntrypointOptions.allFrames

Source

packages/wxt/src/types.ts:610


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

ts
"manifest"

Inherited from

IsolatedWorldContentScriptEntrypointOptions.cssInjectionMode

Source

packages/wxt/src/types.ts:629


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

ts
undefined

Inherited from

IsolatedWorldContentScriptEntrypointOptions.exclude

Source

packages/wxt/src/types.ts:560


excludeGlobs

excludeGlobs?: PerBrowserOption<undefined | string[]>

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

Default

ts
[]

Inherited from

IsolatedWorldContentScriptEntrypointOptions.excludeGlobs

Source

packages/wxt/src/types.ts:605


excludeMatches

excludeMatches?: PerBrowserOption<undefined | string[]>

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

Default

ts
[]

Inherited from

IsolatedWorldContentScriptEntrypointOptions.excludeMatches

Source

packages/wxt/src/types.ts:595


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

ts
undefined

Inherited from

IsolatedWorldContentScriptEntrypointOptions.include

Source

packages/wxt/src/types.ts:553


includeGlobs

includeGlobs?: PerBrowserOption<undefined | string[]>

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

Default

ts
[]

Inherited from

IsolatedWorldContentScriptEntrypointOptions.includeGlobs

Source

packages/wxt/src/types.ts:600


matchAboutBlank

matchAboutBlank?: PerBrowserOption<undefined | boolean>

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

Default

ts
false

Inherited from

IsolatedWorldContentScriptEntrypointOptions.matchAboutBlank

Source

packages/wxt/src/types.ts:588


matchOriginAsFallback

matchOriginAsFallback?: PerBrowserOption<boolean>

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

Default

ts
false

Inherited from

IsolatedWorldContentScriptEntrypointOptions.matchOriginAsFallback

Source

packages/wxt/src/types.ts:615


matches

matches: PerBrowserOption<string[]>

Inherited from

IsolatedWorldContentScriptEntrypointOptions.matches

Source

packages/wxt/src/types.ts:578


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

ts
"manifest"

Inherited from

IsolatedWorldContentScriptEntrypointOptions.registration

Source

packages/wxt/src/types.ts:641


runAt

runAt?: PerBrowserOption<undefined | RunAt>

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

Default

ts
"documentIdle"

Inherited from

IsolatedWorldContentScriptEntrypointOptions.runAt

Source

packages/wxt/src/types.ts:583


world

world?: "ISOLATED"

See https://developer.chrome.com/docs/extensions/develop/concepts/content-scripts#isolated_world

Default

ts
"ISOLATED"

Inherited from

IsolatedWorldContentScriptEntrypointOptions.world

Source

packages/wxt/src/types.ts:658

Methods

main()

main(ctx): any

Main function executed when the content script is loaded.

When running a content script with browser.scripting.executeScript, values returned from this function will be returned in the executeScript result as well. Otherwise returning a value does nothing.

Parameters

ctx: ContentScriptContext

Source

packages/wxt/src/types.ts:784


Generated using typedoc-plugin-markdown and TypeDoc