Skip to content

API / wxt / UnlistedScriptDefinition

Interface: UnlistedScriptDefinition

Source: packages/wxt/src/types.ts:1041

Contents

Extends

Properties

exclude?

optional exclude?: string[]

Source: packages/wxt/src/types.ts:673

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

BaseScriptEntrypointOptions.exclude


globalName?

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

Source: packages/wxt/src/types.ts:713

The variable name for the IIFE in the output bundle.

This option is relevant for scripts 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.
  • 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

ts
false

Inherited from

BaseScriptEntrypointOptions.globalName


include?

optional include?: string[]

Source: packages/wxt/src/types.ts:666

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

BaseScriptEntrypointOptions.include

Methods

main()

main(): any

Source: packages/wxt/src/types.ts:1049

Main function executed when the unlisted script is ran.

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.

Returns

any


Generated using typedoc-plugin-markdown and TypeDoc