title |
---|
Coverage | Guide |
Vitest supports Native code coverage via c8
and instrumented code coverage via istanbul
.
:::tip Since Vitest v0.22.0 :::
Both c8
and istanbul
support are optional. By default, c8
will be used.
You can select the coverage tool by setting test.coverage.provider
to either c8
or istanbul
:
// vite.config.ts
import { defineConfig } from 'vitest/config'
export default defineConfig({
test: {
coverage: {
provider: 'istanbul' // or 'c8'
},
},
})
When you start the Vitest process, it will prompt you to install the corresponding support package automatically.
Or if you prefer to install them manually:
# For c8
npm i -D @vitest/coverage-c8
# For istanbul
npm i -D @vitest/coverage-istanbul
To test with coverage enabled, you can pass the --coverage
flag in CLI.
{
"scripts": {
"test": "vitest",
"coverage": "vitest run --coverage"
}
}
To configure it, set test.coverage
options in your config file:
// vite.config.ts
import { defineConfig } from 'vitest/config'
export default defineConfig({
test: {
coverage: {
reporter: ['text', 'json', 'html'],
},
},
})
It's also possible to provide your custom coverage provider by passing an object to the test.coverage.provider
:
// vite.config.ts
import { defineConfig } from 'vitest/config'
import CustomCoverageProvider from 'my-custom-coverage-provider'
export default defineConfig({
test: {
coverage: {
provider: CustomCoverageProvider()
},
},
})
Please refer to the type definition for more details.
When running a coverage report, a coverage
folder is created in the root directory of your project. If you want to move it to a different directory, use the test.coverage.reportsDirectory
property in the vite.config.js
file.
import { defineConfig } from 'vite'
export default defineConfig({
test: {
coverage: {
reportsDirectory: './tests/unit/coverage'
}
}
})
Both coverage providers have their own ways how to ignore code from coverage reports.
c8
: https://github.com/bcoe/c8#ignoring-uncovered-lines-functions-and-blocksìstanbul
https://github.com/istanbuljs/nyc#parsing-hints-ignoring-lines
When using Typescript the source codes are transpiled using esbuild
, which strips all comments from the source codes (esbuild#516).
Comments which are considered as legal comments are preserved.
For istanbul
provider you can include a @preserve
keyword in the ignore hint.
Beware that these ignore hints may now be included in final production build as well.
-/* istanbul ignore if */
+/* istanbul ignore if -- @preserve */
if (condition) {
Unfortunately this does not work for c8
at the moment.