关于 vitest
vitest 是面向编码 Agent 的 Vitest API 与实践参考技能,用于编写、审查和重构测试。它通过任务分类索引引导查阅 API、配置、测试模式及浏览器模式等文档。
主要功能
- 01查阅测试 API 与断言
- 02查询配置和命令行选项
- 03参考模拟与异步测试模式
- 04了解覆盖率和测试环境
- 05查找 Browser Mode 文档
适用场景
- 01编写和审查 Vitest 测试
- 02配置覆盖率或测试环境
- 03为函数、模块或 HTTP 请求编写模拟
- 04设置浏览器模式或组件测试
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ fandhe-ai/ agent-reference-skills --skill vitest安装后在 Claude Code 中输入/vitest确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/advanced/benchmark-provider.mdcustom-pool.mdextending-reporters.mdgetting-started.mdREADME.mdrunning-tests.mdreferences/api/expect.mdhooks.mdREADME.mdtest-api.mdvi.mdreferences/browser-mode/aria-snapshots.mdassertions.mdbrowser-config.mdcommands.mdcomponent-testing.mdcontext-api.mdinteractivity-api.mdlocators.mdmultiple-setups.mdoverview.mdplaywright-traces.mdREADME.mdrender-function.mdtrace-view.mdvisual-regression-testing.mdwhy.mdreferences/guide/benchmarking.mdcli.mdcommon-errors.md详细介绍
Vitest API 参考
Vitest — Vite 原生测试框架。 在编写、审查和重构测试时可参考。
目标:Vitest v5.0.5 (vitest-dev/vitest tag v5.0.5; Node ^22.12.0 / ^24 / >=26, Vite ^6.4 / ^7 / ^8 as a peer dependency)
目录结构
skills/vitest/
SKILL.md
references/
api/
README.md
test-api.md
expect.md
vi.md
hooks.md
guide/
README.md
benchmarking.md
cli.md
common-errors.md
config.md
coverage.md
debugging.md
environment.md
extending-matchers.md
filtering.md
improving-performance.md
in-source.md
lifecycle.md
migration-jest.md
migration-mocha.md
migration-v5.md
open-telemetry.md
parallelism.md
profiling-test-performance.md
snapshot.md
test-annotations.md
test-context.md
test-tags.md
testing-types.md
ui.md
workspace.md
patterns/
README.md
async.md
mocking.md
mocking-classes.md
mocking-dates.md
mocking-file-system.md
mocking-globals.md
mocking-requests.md
browser-mode/
README.md
overview.md
why.md
multiple-setups.md
browser-config.md
locators.md
interactivity-api.md
assertions.md
commands.md
context-api.md
render-function.md
component-testing.md
visual-regression-testing.md
aria-snapshots.md
trace-view.md
playwright-traces.md
recipes/
README.md
browser-locators.md
cancellable.md
conditional-mocking.md
custom-assertions.md
db-transaction.md
disable-isolation.md
explicit-resources.md
parallel-sequential.md
schema-matching.md
type-narrowing.md
wait-for.md
watch-templates.md
advanced/
README.md
getting-started.md
running-tests.md
extending-reporters.md
custom-pool.md
benchmark-provider.md
samples/
README.md
basic-test.md
benchmark-fixture.md
browser-component-test.md
conditional-mocking-vi-when.md
coverage-setup.md
describe-and-hooks.md
mocking-modules.md
parameterized-tests.md
snapshot-testing.md
spy-on-methods.md
test-environment.md
type-testing.md
workspace-setup.md
scripts/
README.md
cli.md
coverage.md
install.md
setup.md
查找步骤
根据任务查找类别,并在类别的 README.md 中确定目标页面:
- 在下方映射表中查找与任务对应的类别
- 参阅该类别的
references/{category}/README.md,确定目标页面 - Read 相应的
.md文件以查看详细信息
任务 → 类别映射
| 任务 | 类别 | 参考 README |
|---|---|---|
| 想使用 describe、it/test、hooks (aroundEach / onTestFinished)、modifiers、each/for | api | references/api/README.md |
| 想了解 expect 匹配器(相等、类型、数值、集合、快照、异步) | api | references/api/README.md |
| 想使用 vi.fn、vi.mock、vi.spyOn、计时器、存根 | api | references/api/README.md |
| 想了解 vitest.config.ts 的配置选项 | guide | references/guide/README.md |
| 想了解 CLI 命令和标志(参考) | guide | references/guide/README.md |
| 想配置覆盖率 (v8 / istanbul) | guide | references/guide/README.md |
| 想切换测试环境 (jsdom, happy-dom, edge-runtime) | guide | references/guide/README.md |
| 想配置快照测试、类型测试、projects(旧称 workspace) | guide | references/guide/README.md |
| 想了解 Test Context / fixtures、tags、annotations、filtering、lifecycle | guide | references/guide/README.md |
| 想使用自定义匹配器、reporters、UI、debugging、in-source testing | guide | references/guide/README.md |
| 想了解性能改进、分析、并行执行、OpenTelemetry、benchmarking | guide | references/guide/README.md |
| 想了解常见错误的原因和解决方法 | guide | references/guide/README.md |
| 想了解从 v4 → v5 / Jest / Mocha 迁移的步骤 | guide | references/guide/README.md |
| 想了解模拟模式 (vi.fn、vi.mock、vi.spyOn、部分模拟) | patterns | references/patterns/README.md |
| 想详细模拟日期、全局对象、文件系统、HTTP 请求、类 | patterns | references/patterns/README.md |
| 想了解异步测试、假计时器的模式 | patterns | references/patterns/README.md |
| 想使用 Browser Mode (locators, interactivity, expect.element, component testing) | browser-mode | references/browser-mode/README.md |
| 想了解 Browser Mode 的 visual regression、trace view、browser 配置 | browser-mode | references/browser-mode/README.md |
| 想了解实践方案(DB transaction、vi.when、using、wait-for、isolation) | recipes | references/recipes/README.md |
| 想实现程序化 API、自定义 reporter、自定义 pool、benchmark provider | advanced | references/advanced/README.md |
| 想查看典型用法和示例 | samples | samples/README.md |
| 想了解安装、CLI 命令和设置步骤 | scripts | scripts/README.md |
评论
支持 Markdown