# Vitest 中文文档

> 基于 Vite 的原生测试框架，提供极速的测试体验和丰富的功能。

## Table of Contents

### 配置参考

- [配置 Vitest](/config.md)
- [include | 配置](/config/include.md)
- [exclude | 配置](/config/exclude.md)
- [includeSource | 配置](/config/include-source.md)
- [name | 配置](/config/name.md)
- [server | 配置](/config/server.md)
- [deps | 配置](/config/deps.md)
- [运行器 | 配置](/config/runner.md)
- [基准测试 | 配置](/config/benchmark.md)
- [alias | 配置](/config/alias.md)
- [globals | 配置](/config/globals.md)
- [injectCjsGlobals | 配置](/config/injectcjsglobals.md)
- [environment | 配置](/config/environment.md)
- [environmentOptions | 配置](/config/environmentoptions.md)
- [watch | 配置](/config/watch.md)
- [watchTriggerPatterns | 配置](/config/watchtriggerpatterns.md)
- [root | 配置](/config/root.md)
- [dir | 配置](/config/dir.md)
- [reporters | 配置](/config/reporters.md)
- [outputFile | 配置](/config/outputfile.md)
- [pool | 配置](/config/pool.md)
- [execArgv | 配置](/config/execargv.md)
- [vmMemoryLimit | 配置](/config/vmmemorylimit.md)
- [fileParallelism | 配置](/config/fileparallelism.md)
- [maxWorkers | 配置](/config/maxworkers.md)
- [testTimeout | 配置](/config/testtimeout.md)
- [hookTimeout | 配置](/config/hooktimeout.md)
- [teardownTimeout | 配置](/config/teardowntimeout.md)
- [silent | 配置](/config/silent.md)
- [setupFiles | 配置](/config/setupfiles.md)
- [provide | 配置](/config/provide.md)
- [globalSetup | 配置](/config/globalsetup.md)
- [forceRerunTriggers | 配置](/config/forcereruntriggers.md)
- [覆盖率 | 配置](/config/coverage.md)
- [testNamePattern | 配置](/config/testnamepattern.md)
- [ui | 配置](/config/ui.md)
- [open | 配置](/config/open.md)
- [api | 配置](/config/api.md)
- [clearMocks | 配置](/config/clearmocks.md)
- [mockReset | 配置](/config/mockreset.md)
- [restoreMocks | 配置](/config/restoremocks.md)
- [unstubEnvs | 配置](/config/unstubenvs.md)
- [unstubGlobals | 配置](/config/unstubglobals.md)
- [snapshotFormat | 配置](/config/snapshotformat.md)
- [snapshotSerializers | 配置](/config/snapshotserializers.md)
- [resolveSnapshotPath | 配置](/config/resolvesnapshotpath.md)
- [allowOnly | 配置](/config/allowonly.md)
- [passWithNoTests | 配置](/config/passwithnotests.md)
- [logHeapUsage | 配置](/config/logheapusage.md)
- [css | 配置](/config/css.md)
- [maxConcurrency | 配置](/config/maxconcurrency.md)
- [cache | 配置](/config/cache.md)
- [fsModuleCache | 配置](/config/fsmodulecache.md)
- [fsModuleCachePath | 配置](/config/fsmodulecachepath.md)
- [sequence | 配置](/config/sequence.md)
- [tags | 配置](/config/tags.md)
- [strictTags | 配置](/config/stricttags.md)
- [typecheck | 配置](/config/typecheck.md)
- [slowTestThreshold | 配置](/config/slowtestthreshold.md)
- [chaiConfig | 配置](/config/chaiconfig.md)
- [bail | 配置](/config/bail.md)
- [retry | 配置](/config/retry.md)
- [repeats | Config](/config/repeats.md)
- [onConsoleLog | 配置](/config/onconsolelog.md)
- [onStackTrace | 配置](/config/onstacktrace.md)
- [onUnhandledError | 配置](/config/onunhandlederror.md)
- [dangerouslyIgnoreUnhandledErrors | 配置](/config/dangerouslyignoreunhandlederrors.md)
- [diff | 配置](/config/diff.md)
- [fakeTimers | 配置](/config/faketimers.md)
- [项目 | 配置](/config/projects.md)
- [sharedViteServer | 配置](/config/sharedviteserver.md)
- [isolate | 配置](/config/isolate.md)
- [includeTaskLocation | 配置](/config/includetasklocation.md)
- [snapshotEnvironment | 配置](/config/snapshotenvironment.md)
- [env | 配置](/config/env.md)
- [expect | 配置](/config/expect.md)
- [printConsoleTrace | 配置](/config/printconsoletrace.md)
- [attachmentsDir | 配置](/config/attachmentsdir.md)
- [hideSkippedTests | 配置](/config/hideskippedtests.md)
- [mode | 配置](/config/mode.md)
- [expandSnapshotDiff | 配置](/config/expandsnapshotdiff.md)
- [disableConsoleIntercept | 配置](/config/disableconsoleintercept.md)
- [changed | Config](/config/changed.md)
- [实验性 | 配置](/config/experimental.md)

### 浏览器模式

- [browser.enabled | 配置](/config/browser/enabled.md)
- [browser.instances | 配置](/config/browser/instances.md)
- [browser.headless | 配置](/config/browser/headless.md)
- [browser.testerHtmlPath | 配置](/config/browser/testerhtmlpath.md)
- [browser.provider | 配置](/config/browser/provider.md)
- [browser.ui | 配置](/config/browser/ui.md)
- [browser.detailsPanelPosition | 配置](/config/browser/detailspanelposition.md)
- [browser.viewport | 配置](/config/browser/viewport.md)
- [browser.locators | 配置](/config/browser/locators.md)
- [browser.screenshotDirectory | 配置](/config/browser/screenshotdirectory.md)
- [browser.screenshotFailures | 配置](/config/browser/screenshotfailures.md)
- [browser.dependencySourcemaps | 配置](/config/browser/dependencysourcemaps.md)
- [browser.orchestratorScripts | 配置](/config/browser/orchestratorscripts.md)
- [browser.commands | 配置](/config/browser/commands.md)
- [browser.connectTimeout | 配置](/config/browser/connecttimeout.md)
- [browser.trace | 配置](/config/browser/trace.md)
- [browser.trackUnhandledErrors | 配置](/config/browser/trackunhandlederrors.md)
- [browser.expect | 配置](/config/browser/expect.md)

#### 提供程序

- [配置 Playwright](/config/browser/playwright.md)
- [配置 WebdriverIO](/config/browser/webdriverio.md)
- [配置 Preview](/config/browser/preview.md)

### 入门

- [为什么选择 Vitest | 指南](/guide/why.md)
- [入门 | 指南](/guide.md)
- [特性 | 指南](/guide/features.md)

### 学习

- [编写测试 | 指南](/guide/learn/writing-tests.md)
- [使用匹配器 | 指南](/guide/learn/matchers.md)
- [异步代码测试 | 指南](/guide/learn/async.md)
- [Setup 和 Teardown | 指南](/guide/learn/setup-teardown.md)
- [模拟函数 | 指南](/guide/learn/mock-functions.md)
- [快照测试 | 指南](/guide/learn/snapshots.md)
- [实践中的测试 | 指南](/guide/learn/testing-in-practice.md)
- [调试失败的测试 | 指南](/guide/learn/debugging-tests.md)
- [使用 AI 编写测试 | 指南](/guide/learn/writing-tests-with-ai.md)

### 浏览器模式

- [为什么需要浏览器模式 | 浏览器模式](/guide/browser/why.md)
- [浏览器模式 | 指南](/guide/browser.md)
- [多种设置](/guide/browser/multiple-setups.md)
- [组件测试 | 指南](/guide/browser/component-testing.md)
- [视觉回归测试](/guide/browser/visual-regression-testing.md)
- [Trace View  5.0.0](/guide/browser/trace-view.md)
- [Playwright 跟踪](/guide/browser/playwright-traces.md)
- [ARIA 快照 | 指南](/guide/browser/aria-snapshots.md)

### 测试编写

- [测试上下文 | 指南](/guide/test-context.md)
- [测试运行生命周期 | 指南](/guide/lifecycle.md)
- [快照 | 指南](/guide/snapshot.md)
- [模拟 | 指南](/guide/mocking.md)
- [测试标签 | 指南](/guide/test-tags.md)
- [测试注解 | 指南](/guide/test-annotations.md)
- [扩展匹配器 | 指南](/guide/extending-matchers.md)
- [类型测试 | 指南](/guide/testing-types.md)
- [基准测试 | 指南](/guide/benchmarking.md)
- [源内测试 | 指南](/guide/in-source.md)

#### 模拟

- [模拟日期](/guide/mocking/dates.md)
- [模拟函数](/guide/mocking/functions.md)
- [模拟全局变量](/guide/mocking/globals.md)
- [模拟模块](/guide/mocking/modules.md)
- [模拟文件系统](/guide/mocking/file-system.md)
- [模拟请求](/guide/mocking/requests.md)
- [定时器](/guide/mocking/timers.md)
- [模拟类](/guide/mocking/classes.md)

### 工作流

- [命令行界面 | 指南](/guide/cli.md)
- [测试过滤 | 指南](/guide/filtering.md)
- [测试项目 | 指南](/guide/projects.md)
- [测试环境 | 指南](/guide/environment.md)
- [并行性 | 指南](/guide/parallelism.md)
- [报告器 | 指南](/guide/reporters.md)
- [Vitest UI | 指南](/guide/ui.md)
- [IDE 集成 | 指南](/guide/ide.md)

### 质量与调试

- [覆盖率 | 指南](/guide/coverage.md)
- [调试 | 指南](/guide/debugging.md)
- [常见错误 | 指南](/guide/common-errors.md)
- [Open Telemetry 支持  {#open-telemetry-support}](/guide/open-telemetry.md)

#### 性能

- [分析测试性能](/guide/profiling-test-performance.md)
- [提升性能](/guide/improving-performance.md)

### 实践方案

- [每个测试使用数据库事务 | 食谱](/guide/recipes/db-transaction.md)
- [可取消的测试资源 | 配方](/guide/recipes/cancellable.md)
- [等待异步条件 | Recipes](/guide/recipes/wait-for.md)
- [测试中的类型收窄 | 诀窍](/guide/recipes/type-narrowing.md)
- [自定义断言辅助函数 | 配方](/guide/recipes/custom-assertions.md)
- [监视未导入文件 | 配方](/guide/recipes/watch-templates.md)
- [扩展浏览器定位器 | 配方](/guide/recipes/browser-locators.md)
- [基于 Schema 的断言 | 配方](/guide/recipes/schema-matching.md)
- [使用 `using` 自动清理 | 配方](/guide/recipes/explicit-resources.md)
- [使用 vi.when 进行条件模拟 | 配方](/guide/recipes/conditional-mocking.md)
- [按文件隔离设置 | 食谱](/guide/recipes/disable-isolation.md)
- [并行与顺序测试文件 | 方案](/guide/recipes/parallel-sequential.md)

### 高级

- [高级 API](/guide/advanced.md)
- [运行测试 高级 {#running-tests}](/guide/advanced/tests.md)
- [扩展报告器 高级 {#extending-reporters}](/guide/advanced/reporters.md)
- [自定义池 高级 {#custom-pool}](/guide/advanced/pool.md)
- [自定义基准测试提供程序 5.0.0 高级 {#custom-benchmark-provider}](/guide/advanced/benchmark-provider.md)

### 迁移

- [迁移指南 | 指南](/guide/migration.md)
- [从 Jest 迁移 | 指南](/guide/migration/jest.md)
- [从 Mocha + Chai + Sinon 迁移 | 指南](/guide/migration/mocha.md)

- [与其他测试运行器的比较 | 指南](/guide/comparisons.md)

### 测试 API 参考

- [测试](/api/test.md)
- [describe](/api/describe.md)
- [钩子](/api/hooks.md)

### 浏览器模式

- [上下文 API | 浏览器模式](/api/browser/context.md)
- [交互 API | 浏览器模式](/api/browser/interactivity.md)
- [定位器 | 浏览器模式](/api/browser/locators.md)
- [断言 API | 浏览器模式](/api/browser/assertions.md)
- [命令 | 浏览器模式](/api/browser/commands.md)

#### 渲染函数

- [vitest-browser-react](/api/browser/react.md)
- [vitest-browser-vue](/api/browser/vue.md)
- [vitest-browser-svelte](/api/browser/svelte.md)

### 高级

- [Vitest API](/api/advanced/vitest.md)
- [测试项目](/api/advanced/test-project.md)
- [TestSpecification](/api/advanced/test-specification.md)
- [测试用例](/api/advanced/test-case.md)
- [TestSuite](/api/advanced/test-suite.md)
- [TestModule](/api/advanced/test-module.md)
- [TestCollection](/api/advanced/test-collection.md)
- [插件 API](/api/advanced/plugin.md)
- [运行器 API 高级](/api/advanced/runner.md)
- [报告器](/api/advanced/reporters.md)
- [任务元数据 高级](/api/advanced/metadata.md)
- [测试工件](/api/advanced/artifacts.md)

### Other

- [assert](/api/assert.md)
- [assertType](/api/assert-type.md)
- [browser.traceView | 配置](/config/browser/traceview.md)
- [detectAsyncLeaks | 配置](/config/detectasyncleaks.md)
- [expect](/api/expect.md)
- [expectTypeOf](/api/expect-typeof.md)
- [taskTitleValueFormatTruncate | Config](/config/tasktitlevalueformattruncate.md)
- [Untitled](/api/advanced/import-example.md)
- [update | 配置](/config/update.md)
- [Vi](/api/vi.md)
- [使用插件 | 指南](/guide/using-plugins.md)
- [发布](/releases.md)
- [模拟](/api/mock.md)
- [移除 UnoCSS - 迁移完成](/todo.md)