Vitest 测试框架模式与最佳实践。适用于编写单元测试、集成测试、配置 vitest.config、使用 vi.mock/vi.fn 进行模拟等...
测试最佳操作 QQ快速引用 Common Assertions.
功能概述
测试最佳操作 QQ快速引用 Common Assertions.是一项面向实际任务的技能,主要用于Async Testing QQ快速模拟引用 校验门 : 当您添加或更改测试时使用此顺序。它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。
核心要点
- 使用时应结合输入条件选择合适的执行方式,核对必要参数、依赖环境与输出内容,并按原始要求处理异常情况。
- 该技能适合需要稳定复用相关能力的场景,可作为自动化工作流的一部分,也便于后续检查、调整和扩展。
- 从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。
使用与执行
实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。
结果检查与注意事项
执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。
Vitest 最佳实践
速查表
import { describe, it, expect, beforeEach, vi } from 'vitest';
describe('feature name', () => {
beforeEach(() => {
vi.clearAllMocks();
});
it('should do something specific', () => {
expect(actual).toBe(expected);
});
it.todo('planned test');
it.skip('temporarily disabled');
it.only('run only this during dev');
});
常用断言
// 相等性
expect(value).toBe(42) // 严格相等(===)
expect(obj).toEqual({ a: 1 }) // 深度相等
expect(obj).toStrictEqual({ a: 1 }) // 严格深度相等(检查类型)
// 真值性
expect(value).toBeTruthy();
expect(value).toBeFalsy();
expect(value).toBeNull();
expect(value).toBeUndefined();
// 数值
expect(0.1 + 0.2).toBeCloseTo(0.3);
expect(value).toBeGreaterThan(5);
// 字符串 / 数组
expect(str).toMatch(/pattern/);
expect(str).toContain('substring');
expect(array).toContain(item);
expect(array).toHaveLength(3);
// 对象
expect(obj).toHaveProperty('key');
expect(obj).toHaveProperty('nested.key', 'value');
expect(obj).toMatchObject({ subset: 'of properties' });
// 异常
expect(() => fn()).toThrow();
expect(() => fn()).toThrow('error message');
expect(() => fn()).toThrow(/pattern/);
异步测试
// Async/await(推荐方式)
it('fetches data', async () => {
const data = await fetchData();
expect(data).toEqual({ id: 1 });
});
// Promise 断言 —— 必须始终使用 await
await expect(fetchData()).resolves.toEqual({ id: 1 });
await expect(fetchData()).rejects.toThrow('Error');
// 错误示例 —— 将导致误报
expect(promise).resolves.toBe(value); // 缺少 await!
快速 Mock 参考
const mockFn = vi.fn();
mockFn.mockReturnValue(42);
mockFn.mockResolvedValue({ data: 'value' });
expect(mockFn).toHaveBeenCalled();
expect(mockFn).toHaveBeenCalledWith('arg1', 'arg2');
expect(mockFn).toHaveBeenCalledTimes(2);
验证关卡(Verification gates)
在新增或修改测试时,请遵循以下流程;每个步骤均有明确的通过标准。
- 运行测试套件 —— 在 package 或 workspace 根目录下,执行 CI 所使用的相同命令(查看
package.json中的 scripts;通常为vitest run、pnpm test或npm test)。通过条件:进程退出码为 0,且测试报告中显示失败用例数为 0。 - 异步断言(Async matchers) —— 通过条件:所有
expect(...).resolves和expect(...).rejects均以await开头(即await expect(...)),参见「异步测试」章节。若某行中出现resolves或rejects却未前置await,则该关卡不通过。
补充文档
- Mocking:参阅 references/mocking.md,了解模块 Mock、Spy 及清理方法
- 配置:参阅 references/config.md,了解 vitest.config、setup 文件及覆盖率配置
- 模式:参阅 references/patterns.md,了解定时器、快照及反模式等内容
测试方法速查表
| 方法 | 用途 |
|---|---|
it() / test() |
定义单个测试 |
describe() |
对测试进行分组 |
beforeEach() / afterEach() |
每个测试前/后执行的钩子 |
beforeAll() / afterAll() |
整个测试套件前/后执行的钩子 |
.skip |
跳过当前测试或测试套件 |
.only |
仅运行当前测试或测试套件 |
.todo |
占位符测试(标记待实现) |
.concurrent |
启用并发执行 |
.each([...]) |
参数化测试 |
热门AI工具
相关专题
Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章,帮助读者完成上线流程。
0
2026.10.28
Vite搭配Vue.js专题汇集创建Vue 3项目、配置开发环境、路径别名、Vue插件、代理、多环境构建与调试的已审核文章,帮助读者完成从初始化到日常开发的配置。
0
2026.10.28
Vite项目目录专题汇集入口文件、src源码、public静态资源、路径别名、项目根目录和构建输出目录相关的已审核文章,帮助读者理解各文件夹的用途与引用方式。
0
2026.10.28
本专题面向前端开发者,深入讲解 TypeScript 类型系统与大型项目结构设计方法,并结合 Vite 构建工具优化前端工程化流程。内容包括模块化设计、类型声明管理、代码分割、热更新原理以及构建性能调优。通过完整项目示例,帮助开发者提升代码可维护性与开发效率。
192
2026.02.13
本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。
0
2026.11.17
本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。
0
2026.11.17
本专题整理GoFrame框架的入门知识,从模块化设计理念、环境准备到跑通第一个Web服务,讲清目录分层、配置加载、日志与中间件的用法,并对比Gin、Go-Zero的差异,帮助Go开发者建立整体认知。
0
2026.11.17
SQLAlchemy 一对多关系怎么建立?本专题整理父子表外键、relationship 双向映射、关联查询、级联删除和加载优化等相关文章,帮助你理解并实现常见的 ORM 关系建模。
0
2026.11.17
SQLAlchemy 如何增删改查?本专题整理 ORM 新增记录、条件查询、更新和删除、Session 事务提交与批量处理等实用文章,帮助你掌握 Python 数据库操作流程。
0
2026.11.17
热门下载
相关下载
精品课程