Skip to content

API > wxt > UnlistedScriptDefinition

Interface: UnlistedScriptDefinition ​

Contents ​

Extends ​

Properties ​

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 ​

BaseScriptEntrypointOptions.exclude

Source ​

packages/wxt/src/types.ts:673


globalName ​

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

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

Source ​

packages/wxt/src/types.ts:713


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 ​

BaseScriptEntrypointOptions.include

Source ​

packages/wxt/src/types.ts:666

Methods ​

main() ​

main(): any

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.

Source ​

packages/wxt/src/types.ts:1049


Generated using typedoc-plugin-markdown and TypeDoc