[READ-ONLY] Mirror of https://github.com/vitest-dev/vitest. Next generation testing framework powered by Vite.
vitest.dev
test
testing-tools
vite
fix!: remove deprecated entry points (#10222)
+18
-141
+13
docs/guide/migration.md
+13
docs/guide/migration.md
···
56
56
}
57
57
```
58
58
59
+
### Removed Deprecated Entrypoints
60
+
61
+
Several entry points were marked as deprecated in Vitest 4.1. This release removes them entirely.
62
+
63
+
- `vitest/coverage`: use `vitest/node` instead
64
+
- `vitest/reporters`: use `vitest/node` instead
65
+
- `vitest/environments`: use `vitest/runtime` instead
66
+
- `vitest/snapshot`: use `vitest/runtime` instead
67
+
- `vitest/runners`: use `TestRunner` from `vitest` instead
68
+
- `vitest/suite`: use static methods on `TestRunner` from vitest instead (for example, `TestRunner.getCurrentTest()`)
69
+
- `vitest/mocker` is removed completely, use `@vitest/mocker` package directly (this was published by accident at one point and never removed)
70
+
- `vitest/internal/module-runner` is removed
71
+
59
72
## Migrating to Vitest 4.0 {#vitest-4}
60
73
61
74
::: warning Prerequisites
-20
packages/vitest/package.json
-20
packages/vitest/package.json
···
77
77
"__vitest_source__": "./src/utils/traces.ts",
78
78
"default": "./dist/traces.js"
79
79
},
80
-
"./runners": {
81
-
"types": "./dist/runners.d.ts",
82
-
"default": "./dist/runners.js"
83
-
},
84
-
"./suite": {
85
-
"types": "./dist/suite.d.ts",
86
-
"default": "./dist/suite.js"
87
-
},
88
-
"./environments": {
89
-
"types": "./dist/environments.d.ts",
90
-
"default": "./dist/environments.js"
91
-
},
92
80
"./config": {
93
81
"types": "./config.d.ts",
94
82
"require": "./dist/config.cjs",
95
83
"default": "./dist/config.js"
96
-
},
97
-
"./coverage": {
98
-
"types": "./coverage.d.ts",
99
-
"default": "./dist/coverage.js"
100
-
},
101
-
"./reporters": {
102
-
"types": "./dist/reporters.d.ts",
103
-
"default": "./dist/reporters.js"
104
84
},
105
85
"./runtime": {
106
86
"types": "./dist/runtime.d.ts",
-10
packages/vitest/rollup.config.js
-10
packages/vitest/rollup.config.js
···
21
21
'cli': 'src/node/cli.ts',
22
22
'config': 'src/public/config.ts',
23
23
'node': 'src/public/node.ts',
24
-
'suite': 'src/public/suite.ts',
25
24
'browser': 'src/public/browser.ts',
26
-
'runners': 'src/public/runners.ts',
27
-
'environments': 'src/public/environments.ts',
28
25
'spy': 'src/integrations/spy.ts',
29
26
'runtime': 'src/public/runtime.ts',
30
-
'coverage': 'src/public/coverage.ts',
31
-
'reporters': 'src/public/reporters.ts',
32
27
'worker': 'src/public/worker.ts',
33
28
'module-evaluator': 'src/runtime/moduleRunner/moduleEvaluator.ts',
34
29
'nodejs-worker-loader': 'src/runtime/nodejsWorkerLoader.ts',
···
47
42
const dtsEntries = {
48
43
'index': 'src/public/index.ts',
49
44
'node': 'src/public/node.ts',
50
-
'environments': 'src/public/environments.ts',
51
45
'browser': 'src/public/browser.ts',
52
-
'runners': 'src/public/runners.ts',
53
46
'runtime': 'src/public/runtime.ts',
54
-
'suite': 'src/public/suite.ts',
55
47
'config': 'src/public/config.ts',
56
-
'coverage': 'src/public/coverage.ts',
57
-
'reporters': 'src/public/reporters.ts',
58
48
'worker': 'src/public/worker.ts',
59
49
'module-evaluator': 'src/runtime/moduleRunner/moduleEvaluator.ts',
60
50
}
+1
-1
test/e2e/package.json
+1
-1
test/e2e/package.json
+1
-1
test/unit/package.json
+1
-1
test/unit/package.json
+1
-1
docs/api/advanced/runner.md
+1
-1
docs/api/advanced/runner.md
···
142
142
:::
143
143
144
144
::: tip
145
-
Snapshot support and some other features depend on the runner. If you don't want to lose it, you can extend your runner from `VitestTestRunner` imported from `vitest/runners`. It also exposes `NodeBenchmarkRunner`, if you want to extend benchmark functionality.
145
+
Snapshot support and some other features depend on the runner. If you don't want to lose it, you can extend your runner from `TestRunner` imported from `vitest`. It also exposes `NodeBenchmarkRunner`, if you want to extend benchmark functionality.
146
146
:::
147
147
148
148
## Tasks
-40
test/unit/test/exports.test.ts
-40
test/unit/test/exports.test.ts
···
56
56
"defineProject": "function",
57
57
"mergeConfig": "function",
58
58
},
59
-
"./coverage": {
60
-
"BaseCoverageProvider": "function",
61
-
},
62
-
"./environments": {
63
-
"builtinEnvironments": "object",
64
-
"populateGlobal": "function",
65
-
},
66
59
"./internal/browser": {
67
60
"DecodedMap": "function",
68
61
"SpyModule": "object",
···
143
136
"version": "string",
144
137
"viteVersion": "string",
145
138
},
146
-
"./reporters": {
147
-
"AgentReporter": "function",
148
-
"BenchmarkReporter": "function",
149
-
"BenchmarkReportsMap": "object",
150
-
"DefaultReporter": "function",
151
-
"DotReporter": "function",
152
-
"GithubActionsReporter": "function",
153
-
"HangingProcessReporter": "function",
154
-
"JUnitReporter": "function",
155
-
"JsonReporter": "function",
156
-
"MinimalReporter": "function",
157
-
"ReportersMap": "object",
158
-
"TapFlatReporter": "function",
159
-
"TapReporter": "function",
160
-
"VerboseBenchmarkReporter": "function",
161
-
"VerboseReporter": "function",
162
-
},
163
-
"./runners": {
164
-
"NodeBenchmarkRunner": "function",
165
-
"VitestTestRunner": "function",
166
-
},
167
139
"./runtime": {
168
140
"VitestSnapshotEnvironment": "function",
169
141
"__INTERNAL": "object",
170
142
"builtinEnvironments": "object",
171
143
"populateGlobal": "function",
172
-
},
173
-
"./suite": {
174
-
"createChainable": "function",
175
-
"createTaskCollector": "function",
176
-
"getBenchFn": "function",
177
-
"getBenchOptions": "function",
178
-
"getCurrentSuite": "function",
179
-
"getCurrentTest": "function",
180
-
"getFn": "function",
181
-
"getHooks": "function",
182
-
"setFn": "function",
183
-
"setHooks": "function",
184
144
},
185
145
"./worker": {
186
146
"init": "function",
-3
packages/vitest/src/public/coverage.ts
-3
packages/vitest/src/public/coverage.ts
-9
packages/vitest/src/public/environments.ts
-9
packages/vitest/src/public/environments.ts
···
1
-
export { environments as builtinEnvironments } from '../integrations/env/index'
2
-
export { populateGlobal } from '../integrations/env/utils'
3
-
export type {
4
-
Environment,
5
-
EnvironmentReturn,
6
-
VmEnvironmentReturn,
7
-
} from '../types/environment'
8
-
9
-
console.warn('Importing from "vitest/environments" is deprecated since Vitest 4.1. Please use "vitest/runtime" instead.')
-31
packages/vitest/src/public/reporters.ts
-31
packages/vitest/src/public/reporters.ts
···
1
-
export {
2
-
AgentReporter,
3
-
BenchmarkReporter,
4
-
BenchmarkReportsMap,
5
-
DefaultReporter,
6
-
DotReporter,
7
-
GithubActionsReporter,
8
-
HangingProcessReporter,
9
-
JsonReporter,
10
-
JUnitReporter,
11
-
MinimalReporter,
12
-
ReportersMap,
13
-
TapFlatReporter,
14
-
TapReporter,
15
-
VerboseBenchmarkReporter,
16
-
VerboseReporter,
17
-
} from '../node/reporters'
18
-
export type {
19
-
BaseReporter,
20
-
BenchmarkBuiltinReporters,
21
-
BuiltinReporterOptions,
22
-
BuiltinReporters,
23
-
JsonAssertionResult,
24
-
JsonTestResult,
25
-
JsonTestResults,
26
-
ReportedHookContext,
27
-
Reporter,
28
-
TestRunEndReason,
29
-
} from '../node/reporters'
30
-
31
-
console.warn('Importing from "vitest/reporters" is deprecated since Vitest 4.1. Please use "vitest/node" instead.')
-5
packages/vitest/src/public/runners.ts
-5
packages/vitest/src/public/runners.ts
···
1
-
export { NodeBenchmarkRunner } from '../runtime/runners/benchmark'
2
-
export { TestRunner as VitestTestRunner } from '../runtime/runners/test'
3
-
export type { VitestRunner } from '@vitest/runner'
4
-
5
-
console.warn('Importing from "vitest/runners" is deprecated since Vitest 4.1. Please use "vitest" instead.')
-4
packages/vitest/src/public/snapshot.ts
-4
packages/vitest/src/public/snapshot.ts
···
1
-
export { VitestNodeSnapshotEnvironment as VitestSnapshotEnvironment } from '../integrations/snapshot/environments/node'
2
-
export type { SnapshotEnvironment } from '@vitest/snapshot/environment'
3
-
4
-
console.warn('Importing from "vitest/snapshot" is deprecated since Vitest 4.1. Please use "vitest/runtime" instead.')
-14
packages/vitest/src/public/suite.ts
-14
packages/vitest/src/public/suite.ts
···
1
-
export { getBenchFn, getBenchOptions } from '../runtime/benchmark'
2
-
export {
3
-
createTaskCollector,
4
-
getCurrentSuite,
5
-
getCurrentTest,
6
-
getFn,
7
-
getHooks,
8
-
setFn,
9
-
setHooks,
10
-
} from '@vitest/runner'
11
-
export type { VitestRunner, VitestRunnerConfig } from '@vitest/runner'
12
-
export { createChainable } from '@vitest/runner/utils'
13
-
14
-
console.warn('Importing from "vitest/suite" is deprecated since Vitest 4.1. Please use static methods of "TestRunner" from the "vitest" entry point instead: e.g., `TestRunner.getCurrentTest()`.')
+2
-2
test/e2e/dts/exact-optional-property-no-node/src/runner.ts
+2
-2
test/e2e/dts/exact-optional-property-no-node/src/runner.ts
···
1
1
import type { VitestRunner } from '@vitest/runner'
2
2
import type { FailureScreenshotArtifact } from '@vitest/runner/types'
3
-
import { VitestTestRunner } from 'vitest/runners'
3
+
import { TestRunner } from 'vitest'
4
4
5
5
type _Override = FailureScreenshotArtifact
6
6
7
-
export class MyRunner extends VitestTestRunner implements VitestRunner {}
7
+
export class MyRunner extends TestRunner implements VitestRunner {}