Vitest Testing

Polar Sponsor
爱发电 赞助
.NET 9.0

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)

在新增或修改测试时,请遵循以下流程;每个步骤均有明确的通过标准。

  1. 运行测试套件 —— 在 package 或 workspace 根目录下,执行 CI 所使用的相同命令(查看 package.json 中的 scripts;通常为 vitest run、pnpm test 或 npm test)。通过条件:进程退出码为 0,且测试报告中显示失败用例数为 0。
  2. 异步断言(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([...]) 参数化测试

相关专题

更多
Vite 项目如何打包和部署
Vite 项目如何打包和部署

Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章,帮助读者完成上线流程。

2026.10.28

0

16

Vite 如何搭配 Vue.js
Vite 如何搭配 Vue.js

Vite搭配Vue.js专题汇集创建Vue 3项目、配置开发环境、路径别名、Vue插件、代理、多环境构建与调试的已审核文章,帮助读者完成从初始化到日常开发的配置。

2026.10.28

0

15

Vite 项目目录怎么看
Vite 项目目录怎么看

Vite项目目录专题汇集入口文件、src源码、public静态资源、路径别名、项目根目录和构建输出目录相关的已审核文章,帮助读者理解各文件夹的用途与引用方式。

2026.10.28

0

10

TypeScript工程化开发与Vite构建优化实践
TypeScript工程化开发与Vite构建优化实践

本专题面向前端开发者,深入讲解 TypeScript 类型系统与大型项目结构设计方法,并结合 Vite 构建工具优化前端工程化流程。内容包括模块化设计、类型声明管理、代码分割、热更新原理以及构建性能调优。通过完整项目示例,帮助开发者提升代码可维护性与开发效率。

2026.02.13

192

17

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

2026.11.17

0

15

GoFrame框架安装与gf命令行工具
GoFrame框架安装与gf命令行工具

本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.17

0

15

GoFrame框架零基础入门
GoFrame框架零基础入门

本专题整理GoFrame框架的入门知识,从模块化设计理念、环境准备到跑通第一个Web服务,讲清目录分层、配置加载、日志与中间件的用法,并对比Gin、Go-Zero的差异,帮助Go开发者建立整体认知。

2026.11.17

0

15

SQLAlchemy 一对多关系怎么建立
SQLAlchemy 一对多关系怎么建立

SQLAlchemy 一对多关系怎么建立?本专题整理父子表外键、relationship 双向映射、关联查询、级联删除和加载优化等相关文章,帮助你理解并实现常见的 ORM 关系建模。

2026.11.17

0

10

SQLAlchemy 如何增删改查
SQLAlchemy 如何增删改查

SQLAlchemy 如何增删改查?本专题整理 ORM 新增记录、条件查询、更新和删除、Session 事务提交与批量处理等实用文章,帮助你掌握 Python 数据库操作流程。

2026.11.17

0

11

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
第二期_大前端线上班
第二期_大前端线上班

共345课时 | 83万人学习