Skip to content

Lupa API Reference / @pawel-up/lupa/runner / BaseConfig

Interface: BaseConfig ​

Defined in: src/runner/types.ts:256

Base configuration options

Properties ​

concurrency? ​

optional concurrency?: number | "auto"

Defined in: src/runner/types.ts:362

Number of concurrent pages to run per browser. Can be 'auto' or a specific number.


configPath? ​

optional configPath?: string

Defined in: src/runner/types.ts:266

Path to the Lupa configuration file.


coverage? ​

optional coverage?: boolean | CoverageOptions

Defined in: src/runner/types.ts:346

Whether to enable code coverage reporting using istanbul, or specific options to configure the coverage instrumentation.


cwd? ​

optional cwd?: string

Defined in: src/runner/types.ts:261

Current working directory. It is required to search for the test files


exclude? ​

optional exclude?: string[]

Defined in: src/runner/types.ts:328

An array of directories to exclude when searching for test files.

For example, if you search for test files inside the entire project, you might want to exclude "node_modules"


filters? ​

optional filters?: Filters

Defined in: src/runner/types.ts:286

Test filters to apply


harness? ​

optional harness?: HarnessConfig

Defined in: src/runner/types.ts:351

Customize the HTML harness environment


list? ​

optional list?: boolean

Defined in: src/runner/types.ts:367

Whether to output the list of suites and tests


parallel? ​

optional parallel?: boolean

Defined in: src/runner/types.ts:356

Whether to run tests in parallel across browsers and pages


refiner? ​

optional refiner?: Refiner

Defined in: src/runner/types.ts:319

Overwrite tests refiner. Check documentation for refiner usage


reporters? ​

optional reporters?: object

Defined in: src/runner/types.ts:292

A hook to configure suites. The callback will be called for each suite before it gets executed.

activated ​

activated: string[]

list? ​

optional list?: NamedReporterContract[]


retries? ​

optional retries?: number

Defined in: src/runner/types.ts:281

The retries to apply on all the tests, unless overwritten explicitly


runnerPlugins? ​

optional runnerPlugins?: LupaPlugin[]

Defined in: src/runner/types.ts:313

Node-side runner plugins. Can hook into the orchestrator lifecycle to start proxy servers, perform planning, or collect metrics.


testPlugins? ​

optional testPlugins?: TestPluginEntry[]

Defined in: src/runner/types.ts:307

Browser-side test plugins. Module specifiers that export a default setup function conforming to WebPluginFn. Executed in the browser before test files load. Plugins receive the WebRunner, Emitter, and config.

Example ​

ts
testPlugins: ['@pawel-up/lupa/assert']
testPlugins: [['@pawel-up/lupa/assert', { openApi: false }]]

timeout? ​

optional timeout?: number

Defined in: src/runner/types.ts:276

The timeout to apply on all the tests, unless overwritten explicitly


vite? ​

optional vite?: InlineConfig

Defined in: src/runner/types.ts:340

Inline Vite configuration to merge with Lupa's defaults. Do not use together with 'viteConfig'.


viteConfig? ​

optional viteConfig?: string

Defined in: src/runner/types.ts:334

Path to the Vite configuration file. Do not use together with 'vite'.


watch? ​

optional watch?: boolean

Defined in: src/runner/types.ts:271

Whether to run tests in watch mode