import { ErrorWithDiff, Awaitable } from '@vitest/utils'; type ChainableFunction = { (...args: Args): R; } & { [x in T]: ChainableFunction; } & { fn: (this: Record, ...args: Args) => R; } & E; declare function createChainable(keys: T[], fn: (this: Record, ...args: Args) => R): ChainableFunction; type RunMode = 'run' | 'skip' | 'only' | 'todo'; type TaskState = RunMode | 'pass' | 'fail'; interface TaskBase { id: string; name: string; mode: RunMode; meta: TaskMeta; each?: boolean; concurrent?: boolean; shuffle?: boolean; suite?: Suite; file?: File; result?: TaskResult; retry?: number; repeats?: number; } interface TaskMeta { } interface TaskCustom extends TaskBase { type: 'custom'; } interface TaskResult { state: TaskState; duration?: number; startTime?: number; heap?: number; /** * @deprecated Use "errors" instead */ error?: ErrorWithDiff; errors?: ErrorWithDiff[]; htmlError?: string; hooks?: Partial>; retryCount?: number; repeatCount?: number; } type TaskResultPack = [id: string, result: TaskResult | undefined, meta: TaskMeta]; interface Suite extends TaskBase { type: 'suite'; tasks: Task[]; filepath?: string; projectName?: string; } interface File extends Suite { filepath: string; collectDuration?: number; setupDuration?: number; } interface Test extends TaskBase { type: 'test'; suite: Suite; result?: TaskResult; fails?: boolean; context: TestContext & ExtraContext; onFailed?: OnTestFailedHandler[]; /** * Store promises (from async expects) to wait for them before finishing the test */ promises?: Promise[]; } type Task = Test | Suite | TaskCustom | File; type DoneCallback = (error?: any) => void; type TestFunction = (context: TestContext & ExtraContext) => Awaitable | void; type ExtractEachCallbackArgs> = { 1: [T[0]]; 2: [T[0], T[1]]; 3: [T[0], T[1], T[2]]; 4: [T[0], T[1], T[2], T[3]]; 5: [T[0], T[1], T[2], T[3], T[4]]; 6: [T[0], T[1], T[2], T[3], T[4], T[5]]; 7: [T[0], T[1], T[2], T[3], T[4], T[5], T[6]]; 8: [T[0], T[1], T[2], T[3], T[4], T[5], T[6], T[7]]; 9: [T[0], T[1], T[2], T[3], T[4], T[5], T[6], T[7], T[8]]; 10: [T[0], T[1], T[2], T[3], T[4], T[5], T[6], T[7], T[8], T[9]]; fallback: Array ? U : any>; }[T extends Readonly<[any]> ? 1 : T extends Readonly<[any, any]> ? 2 : T extends Readonly<[any, any, any]> ? 3 : T extends Readonly<[any, any, any, any]> ? 4 : T extends Readonly<[any, any, any, any, any]> ? 5 : T extends Readonly<[any, any, any, any, any, any]> ? 6 : T extends Readonly<[any, any, any, any, any, any, any]> ? 7 : T extends Readonly<[any, any, any, any, any, any, any, any]> ? 8 : T extends Readonly<[any, any, any, any, any, any, any, any, any]> ? 9 : T extends Readonly<[any, any, any, any, any, any, any, any, any, any]> ? 10 : 'fallback']; interface SuiteEachFunction { (cases: ReadonlyArray): (name: string | Function, fn: (...args: T) => Awaitable) => void; >(cases: ReadonlyArray): (name: string | Function, fn: (...args: ExtractEachCallbackArgs) => Awaitable) => void; (cases: ReadonlyArray): (name: string | Function, fn: (...args: T[]) => Awaitable) => void; } interface TestEachFunction { (cases: ReadonlyArray): (name: string | Function, fn: (...args: T) => Awaitable, options?: number | TestOptions) => void; >(cases: ReadonlyArray): (name: string | Function, fn: (...args: ExtractEachCallbackArgs) => Awaitable, options?: number | TestOptions) => void; (cases: ReadonlyArray): (name: string | Function, fn: (...args: T[]) => Awaitable, options?: number | TestOptions) => void; (...args: [TemplateStringsArray, ...any]): (name: string | Function, fn: (...args: any[]) => Awaitable, options?: number | TestOptions) => void; } type ChainableTestAPI = ChainableFunction<'concurrent' | 'only' | 'skip' | 'todo' | 'fails', [ name: string | Function, fn?: TestFunction, options?: number | TestOptions ], void, { each: TestEachFunction; (name: string | Function, fn?: TestFunction, options?: number | TestOptions): void; }>; interface TestOptions { /** * Test timeout. */ timeout?: number; /** * Times to retry the test if fails. Useful for making flaky tests more stable. * When retries is up, the last test error will be thrown. * * @default 0 */ retry?: number; /** * How many times the test will run. * Only inner tests will repeat if set on `describe()`, nested `describe()` will inherit parent's repeat by default. * * @default 0 */ repeats?: number; } type TestAPI = ChainableTestAPI & { each: TestEachFunction; skipIf(condition: any): ChainableTestAPI; runIf(condition: any): ChainableTestAPI; extend = {}>(fixtures: Fixtures): TestAPI<{ [K in keyof T | keyof ExtraContext]: K extends keyof T ? T[K] : K extends keyof ExtraContext ? ExtraContext[K] : never; }>; }; type Fixtures, ExtraContext = {}> = { [K in keyof T]: T[K] | ((context: { [P in keyof T | keyof ExtraContext as P extends K ? P extends keyof ExtraContext ? P : never : P]: K extends P ? K extends keyof ExtraContext ? ExtraContext[K] : never : P extends keyof T ? T[P] : never; } & TestContext, use: (fixture: T[K]) => Promise) => Promise); }; type ChainableSuiteAPI = ChainableFunction<'concurrent' | 'only' | 'skip' | 'todo' | 'shuffle', [ name: string | Function, factory?: SuiteFactory, options?: number | TestOptions ], SuiteCollector, { each: TestEachFunction; (name: string | Function, factory?: SuiteFactory): SuiteCollector; }>; type SuiteAPI = ChainableSuiteAPI & { each: SuiteEachFunction; skipIf(condition: any): ChainableSuiteAPI; runIf(condition: any): ChainableSuiteAPI; }; type HookListener = (...args: T) => Awaitable; type HookCleanupCallback = (() => Awaitable) | void; interface SuiteHooks { beforeAll: HookListener<[Readonly], HookCleanupCallback>[]; afterAll: HookListener<[Readonly]>[]; beforeEach: HookListener<[TestContext & ExtraContext, Readonly], HookCleanupCallback>[]; afterEach: HookListener<[TestContext & ExtraContext, Readonly]>[]; } interface SuiteCollector { readonly name: string; readonly mode: RunMode; options?: TestOptions; type: 'collector'; test: TestAPI; tasks: (Suite | TaskCustom | Test | SuiteCollector)[]; custom: (name: string) => TaskCustom; collect: (file?: File) => Promise; clear: () => void; on: >(name: T, ...fn: SuiteHooks[T]) => void; } type SuiteFactory = (test: (name: string | Function, fn: TestFunction) => void) => Awaitable; interface RuntimeContext { tasks: (SuiteCollector | Test)[]; currentSuite: SuiteCollector | null; } interface TestContext { /** * Metadata of the current test * * @deprecated Use `task` instead */ meta: Readonly; /** * Metadata of the current test */ task: Readonly; /** * Extract hooks on test failed */ onTestFailed: (fn: OnTestFailedHandler) => void; } type OnTestFailedHandler = (result: TaskResult) => Awaitable; type SequenceHooks = 'stack' | 'list' | 'parallel'; type SequenceSetupFiles = 'list' | 'parallel'; export { ChainableFunction as C, DoneCallback as D, File as F, HookListener as H, OnTestFailedHandler as O, RunMode as R, Suite as S, Task as T, Test as a, TaskCustom as b, createChainable as c, SuiteAPI as d, TestAPI as e, SuiteCollector as f, SuiteHooks as g, TaskState as h, TaskBase as i, TaskMeta as j, TaskResult as k, TaskResultPack as l, TestFunction as m, TestOptions as n, Fixtures as o, HookCleanupCallback as p, SuiteFactory as q, RuntimeContext as r, TestContext as s, SequenceHooks as t, SequenceSetupFiles as u };