vitest单元测试配合@vue/test-utils之组件单元测试篇

Vue组件单元测试实战:Jest+Vue Test Utils白盒验证指南 Vue组件测试本质是验证声明式响应式抽象的内部契约——它既不是黑盒点击,也不是端到端走查,而是通过可隔离、可断言的白盒执行环境,精准覆盖props输入、events输出、computed响应、lifecycle副作用及异步状态流转。Jest提供稳定运行时与断言能力,Vue Test Utils封装组件挂载、事件触发与内部状态访问API,二者协同构成Vue单元测试的事实标准。该方案直击中大型项目中‘改一处崩一片’的集成风险,支撑CI门禁、重构信心与覆盖率治理,适用于所有Vue 2.6+/3工程化团队。 阅读详情

what is vitest & test-utils

vitest 是由 vite 提供支持的极速单元测试框架,VueTestUtils 是 Vue.js 的官方测试实用程序库,vitest 本身是不支持单元组件测试的,需要配合 test-utils 来完成组件单元测试,安装与基本 API 就不再赘述,学会阅读文档与查找资料是一个程序员的基本功

demo

/* Component */
<template>
  <div>
    <div class="test-utils-value">值为:{{ num }}</div>
    <button class="test-utils-button" @click="increment">测试按钮</button>
  </div>
</template>

<script setup lang="ts">
  import { ref } from 'vue'
  import type { Ref } from 'vue'
  const num: Ref<number> = ref(1)
  function increment() {
    num.value++
  }
</script>
// spec | test
import { describe, it, expect } from 'vitest'
import { shallowMount } from '@vue/test-utils'
import AddNum from '@/views/AddNum.vue'

describe('组件单元测试', () => {
  it('test1', async () => {
    const wrapper = shallowMount(AddNum)
    const btn = '.test-utils-button'
    const value = '.test-utils-value'
    expect(wrapper.find(value).text()).toContain('值为:1')
    await wrapper.find(btn).trigger('click')
    expect(wrapper.find(value).text()).toBe('值为:2')
  })
})
  1. demo 由一个组件和测试文件组成
  2. 组件的逻辑非常简单,按下按钮则数字+1,页面显示实时数字
  3. 测试代码中使用 test-utils 库的 shallowMount 方法浅渲染挂载组件(*:浅渲染只渲染当前组件,不会渲染它的子组件,从而避免在测试中与子组件的行为产生干扰)
  • 组件通过 find 方法返回查找元素,再通过 text 方法返回元素的文本内容
  • 然后使用 vitest 库的 expect 创建断言,toContain 是断言检查值是否在数组中,toBe 是断言基础对象是否相等
  • trigger 是 test-utils 中触发 DOM 事件的方法,demo 中触发了点击事件,模拟用户按下了按钮的操作,按下按钮前后都断言了,会判断实际执行结果与预期结果是否一致,如果不一致则会抛出错误
  • 如将tobe('值为:2')改为tobe('值为:3'),就会提示哪一个测试文件中的哪一个测试用例失败,并展示错误的预期值和实际的执行结果
- Expected   "值为:3"
+ Received   "值为:2"

tips

虽然这是一个非常简单 demo,但它还是有很多值得注意的知识点的

  • describe 可以在文件顶层直接使用test和bench,它们会被收集为隐式套件的一部分,也可以用describe在当前上下文定义一个新套件,作为一组相关的测试或嵌套套件
  • it it是test的别名,使用it或test都是可以的
  • shallowMount 按照文档描述它是使用挂载组件的别名,所以也可以使用mount(Component, { shallow: true })来浅渲染挂载组件,shallow 的默认值是 false
  • async/await 可以看到 trigger 前使用了 await,这与我们寻常使用 async/await 有一点细微的差别,假如我们去掉 async/await,测试用例将会失败,因为按钮虽然按下了,值也自增了,但 vue 不会立即更新 DOM,而是等到下一个事件循环勾选之后再更新,所以断言会在在 vue 更新之前被调用,拿到的实际执行结果还是初始值 1,与预期值 2 不符,然后抛出错误,这感觉是不是很熟悉,这不就像 Vue 的异步更新策略导致我们对数据的修改不会立马体现到页面变化上,此时如果想要立即获取更新后的 dom 的状态,我们就需要使用到…对,没错就是我们的老朋友nexttick()
import { nextTick } from 'vue'

it('test1', async () => {
  const wrapper = shallowMount(AddNum)
  const btn = '.test-utils-button'
  const value = '.test-utils-value'
  expect(wrapper.find(value).text()).toContain('值为:1')
  wrapper.find(btn).trigger('click')
  await nexttick()
  expect(wrapper.find(value).text()).toBe('值为:2')
})

因为这是很常见的一个问题,test-utils提供了一个快捷方式,可以直接在await后跟触发DOM的事件,省略掉nexttick(),即await wrapper.find(btn).trigger('click'),如此一来我们断言的实际结果就是自增过后的数字,与预期结果相符,测试用例通过

Vue组件单元测试实战:Jest沙盒化测试原理与落地 Vue组件是响应式数据、生命周期、事件系统与DOM渲染的耦合体,其行为验证不能依赖人工点击或视觉判断。Jest通过轻量沙盒环境实现输入可控(props/slots/mock)、触发可模拟(事件/nextTick)、断言可证伪(DOM/事件/调用),将组件行为转化为确定性代码逻辑。它不绑定Vue版本,兼容Options API与Composition API,配合vue-test-utils形成覆盖Vue 2.x至3.x的稳定测试链路。典型应用场景包括异步数据加载、动态表单交互、路由参数依赖及插槽条件渲染—— 阅读详情

相关推荐

前端测试框架选型指南:Jest、Vitest与Cypress深度对比与实践

在前端开发中,测试是保障代码质量和应用稳定性的关键环节。单元测试和端到端测试构成了现代测试体系的核心,它们分别验证代码逻辑的正确性和用户流程的完整性。理解测试框架的设计哲学与适用场景,能显著提升开发效率和项目可维护性。Jest作为成熟的单元测试框架,以其强大的Mock能力和开箱即用的特性,成为React等大型项目的可靠选择;而Vitest凭借与Vite的深度集成,提供了极速的热更新和测试运行体验,尤其适合现代前端项目。对于需要模拟真实用户操作的场景,Cypress提供了真实的浏览器环境和出色的调试能力,是端

weixin_30634661的博客 318

试试使用 Vitest 进行组件测试,确实很香。

自从尤大的构建工具Vite获得了巨大的人气,现在有了一个由它驱动的极快的单元测试框架。Vitest。Vitest 与 Jest 兼容,具有开箱即用的 ESM、Typescript 和 JSX 支持,并且由esbuild提供支持。它在测试过程中使用 Vite 开发服务器来转换你的文件,并监听你的应用程序的相同配置(通过),从而消除了使用Jest等测试替代品所涉及的重复工作。使用 Vitest 对我们的应用程序进行单元测试是无缝的,与Jest等替代品相比,需要更少的步骤来启动和运行。...

粉丝们务必加入微信粉丝群 5389

Blocks UI测试实战:从单元到集成的完整策略与Jest、Vue/React工具链配置

在现代前端开发中,组件化与模块化是构建复杂用户界面的核心理念。其原理在于将UI拆分为独立、可复用的单元(组件),通过组合与状态管理来构建应用。这种模式的技术价值在于提升代码的可维护性、复用性和开发效率。然而,随着组件数量和交互复杂度的增加,确保UI的稳定性和功能正确性成为关键挑战,尤其是在涉及状态管理、路由和API集成的应用场景中。为此,建立系统化的测试策略至关重要,它能够将质量保障左移,在开发阶段拦截缺陷,并为持续集成/持续部署(CI/CD)奠定基础。本文聚焦于Blocks UI(即由可复用UI块构成的界

weixin_34335458的博客 557

vitest 单元测试配合@vue/test-utils 之 pinia 篇

vitest 是由 vite 提供支持的极速单元测试框架,VueTestUtils 是 Vue.js 的官方测试实用程序库,pinia 是 Vue.js 的状态管理库,以上均为各自官网对其的描述。组件通过 find 方法返回查找元素,通过 trigger 方法触发 DOM 事件,模拟用户按下按钮的操作,按下按钮前后都断言了,会判断实际执行结果与预期结果是否一致,如果不一致则会抛出错误。项目中使用状态管理是非常常见的,所以对它也可以来个单元测试,这里我们可能会有两个场景:1. 测试在组件中使用 pinia;

Selicens的博客 1428

JESD204B系统设计实战:如何用SYSREF信号搞定多设备时钟同步(附时序图详解)

本文深入探讨了JESD204B系统中SYSREF信号在多设备时钟同步中的关键作用与实现技巧。通过详细分析SYSREF信号的生成、PCB布局和时序调整,提供了一套完整的解决方案,帮助工程师解决高速数据转换器与FPGA协同工作中的时钟同步问题。文章还包含时序图详解和实测调试技巧,助力提升系统性能。

weixin_29313239的博客 457

「模型部署系列」ubuntu 使用vllm部署Qwen3-8B模型

解决这个问题的方法正如错误信息中所提示的,需要在命令行中显式地设置。下载单个文件到指定本地文件夹(以下载README.md到当前路径下“dir”目录为例)解决:这表明你正在使用的 Tesla T4 GPU 的计算能力为 7.5,而。,用于获取更详细的 NCCL 调试信息,当所有其他问题排除,可尝试增加。1、下载vllm v0.8.5(此处已经下好了,去仓库拉资源)在下载前,请先通过如下命令安装ModelScope。,这一错误最终致使引擎进程启动失败。更多更丰富的命令行下载选项,可参见。

汪依帆的博客 5049

Vue3+Typescript+Vitest单元测试环境+组件事件测试篇

Vue3+Typescript+Vitest单元测试-组件事件篇

廖子默 2697

Cadence创建异形焊盘教程(详细操作)

背景:一些常见的矩形/圆形焊盘,设置参数就可。碰到非规则的一些焊盘,那只能用Cadence Allegro PCB来画咯。 一、新建图形 【File】——>【New…】 弹出如下窗口,选择绘制的类型Shape symbol、路径,输入名字 二、设置参数 【Setup】——>【Design Parameters…】 Enhanced display modes:增强型显示模型。全部勾选上。 在【Design】设置单位为mm 设置偏移量(-50,-50) 三、绘制图形 1、找到原点,即参考

qq_42057393的博客 2万+

Vue3+Typescript+Vitest单元测试环境+组件测试基础篇

测试Vue组件基础

廖子默 1648

新手避坑指南:HT7036计量芯片SPI读取电压的完整流程(从复位到校准)

本文详细介绍了HT7036计量芯片的SPI读取电压完整流程,从硬件准备到校准设置,重点解析了复位引脚处理、SPI通信配置、芯片初始化及数据处理等关键步骤。针对常见问题如晶振焊接、SPI时序错误等提供实用解决方案,帮助开发者高效完成电压测量与校准。

weixin_30070339的博客 328

Docker:快速部署 Temporal 工作流引擎的技术指南

Temporal是一个开源的分布式工作流引擎,适用于复杂业务流程(如订单处理、支付流程等),提供状态持久化、自动重试、多语言SDK支持等特性。部署简单,支持Docker Compose,包含核心服务、Web UI及数据库。以TypeScript为例,开发者可快速编写工作流(如订单处理)和Worker,通过CLI或SDK启动和管理。Temporal简化了分布式系统的可靠性设计,适合电商、自动化任务等场景。

木头 644

基于Vitest进行组件测试

基于Vitest的组件测试,保证项目的质量

随便写写 2221

彻底解决Win11锁屏界面黑屏或者图片不变化

windows锁屏后黑屏

renkai721的专栏 1万+

vitest 单元测试配合@vue/test-utils 之 axios 篇

vitest 是由 vite 提供支持的极速单元测试框架,VueTestUtils 是 Vue.js 的官方测试实用程序库,Axios 是一个基于 promise 的网络请求库,以上均为各自官网对其的描述。

Selicens的博客 2082

家里摄像头录像存 NAS,空间爆满了怎么办?一招实现设定容量自动清理实现循环存储!

📷 家用摄像头录像久了会撑爆 NAS 吗?别担心,这篇文章教如何实现自动清理录像,释放 NAS 空间,避免爆盘🧹

XiaoqiangClub的博客 1882

军品研制过程-转阶段

介绍军品转阶段评审

Abel的博客 2万+

vitest 单元测试配合@vue/test-utils 之 router 篇

vitest 是由 vite 提供支持的极速单元测试框架,VueTestUtils 是 Vue.js 的官方测试实用程序库,Vue Router 是 Vue.js 的官方路由,以上均为各自官网对其的描述。再通过 find 方法返回查找元素,trigger 方法触发 DOM 事件,模拟用户点击的操作,同样是因为 VueRouter 的异步性质,我们需要再断言之前完成路由,由于没有可以等待的。第一组测试首先执行了跳转,因为 VueRouter4 异步处理路由,需要告诉路由器何时准备就绪,所以使用了。

Selicens的博客 1094

VC中sqlite的使用

在VC中对sqlite的使用,实现数据库大批数据的快速插入,读取数据库中的数据在ListCtrl中显示

Vue3+Typescript+Vitest单元测试环境+基础用例篇

vue3+typescript+vitest单元测试

廖子默 3603

win10 跳过U8环境检测的IE WebControls.rar

win10 安装u8的时候 提示IE WebControls 不通过,这个工具可以欺骗u8的检查。 跳过U8环境检测的IE WebControls。提示导入失败后,重新检测通过。

Statistics and Machine Learning Toolbox

Statistics and Machine Learning Toolbox(带书签),MATLAB统计学习工具

18-Vue3 单元测试 Vitest 实战

掌握 Vitest + Vue Test Utils 测试体系,为 Vue3 项目构建可靠的自动化测试防线。

以梦想为帆,行动作桨,驶向辉煌彼岸。 161

大中型超市收银系统(可直接运行)

光步前台收银系统系统功能:商品销售、商品退货、挂单、收银员权限、会员销售、单品取消、整单取消、商品查询、脱机销售、脱机数据上传,基本资料下载,开钱箱、小票打印、收款结算,支持多币种付款方式(现金、储值卡、礼券、微信等),支持多种促销。运行环境:.net 4.0登陆信息用户名:1001 密码:123456内置商品信息,商品编码可输入00001000 - 00010000,测试效果相关功能键F5 结算 F9挂单 F11商品查询 F8退货 Insert单品取消 Del整单取消 F12开钱箱F2 会员 Ctrl+Z退出系统 Home 锁屏 相关源码待公开

mall-app-web测试与调试:单元测试、集成测试与性能测试完整方案

mall-app-web是一个基于uni-app+Vue3实现的电商移动端项目,涵盖首页门户、商品搜索、购物车、订单流程等核心功能。本文将分享一套完整的测试与调试方案,帮助开发者确保项目质量与性能,提升用户体验。 ## 一、测试环境搭建指南 ### 1.1 开发环境准备 首先确保已安装Node.js和npm,然后通过以下命令克隆项目: ```bash git clone https://g

gitblog_00443的博客 721

Vue3单元测试工具对比与示例

Vue 3测试工具对比与最佳实践 Vue 3项目中,Vitest(搭配@vue/test-utils)是官方推荐的单元测试工具,适合快速验证组件逻辑和函数;Cypress则更擅长组件交互测试和E2E测试,提供真实浏览器环境。 核心差异: Vitest:基于Vite,毫秒级运行,支持模拟DOM,适合纯逻辑测试 Cypress:真实浏览器操作,调试体验优秀,适合UI和业务流程验证 推荐方案: 新项目优先选择Vitest进行单元测试 关键组件和E2E流程补充Cypress测试 配置示例展示了两种工具的基础用法 结

大剑师兰特的GIS世界 622

3步掌握Vant组件测试:从入门到实战保障代码质量

你还在手动测试组件功能吗?每次修改都担心影响其他功能?本文将带你3步掌握Vant组件单元测试,用自动化测试守护你的代码质量,让组件迭代更放心。读完本文你将学会:测试环境搭建、基础测试编写、高级测试技巧和覆盖率分析。 ## 为什么需要单元测试 单元测试(Unit Testing)是对软件中最小可测试单元进行验证的过程。在Vant组件开发中,单元测试能帮你: - 提前发现组件逻辑错误 - 保障重构

gitblog_00142的博客 300

前端工程化实战:TypeScript+ESLint+Vitest构建高质量开发闭环

在现代前端开发中,工程化是提升代码质量和团队协作效率的核心。其原理是通过工具链的集成,在开发阶段构建自动化的质量保障体系。这套体系的技术价值在于将类型安全、代码规范和单元测试融为一体,形成开发闭环,从而显著降低维护成本并提升项目可维护性。在实际应用场景中,它尤其适合新项目技术选型、大型团队协作以及追求高交付标准的项目。本文聚焦的TypeScript、ESLint与Vitest组合,正是实现这一目标的经典实践,通过配置集成与自动化脚本,为开发者提供了一套可落地的完整解决方案。

weixin_30596343的博客 377

Vue单元测试实效性提升:响应式建模与精准挂载实践

Vue单元测试的本质是验证组件在响应式系统、生命周期和依赖追踪约束下的行为契约,而非仅确保代码不报错。其核心挑战在于模板编译抽象、Composition API 的隐式依赖以及 `ref`/`reactive` 状态更新的不可见性。有效的测试需建模 Vue 运行时机制——如 `nextTick` 的微任务调度、`watch` 的依赖收集边界、`shallowMount` 与 `mount` 在模板编译层的真实切片逻辑。技术价值体现在规避状态污染、加速调试闭环、支撑高覆盖率重构;典型场景包括表单防抖验证、`p

weixin_33851604的博客 325

Vue 3 UI组件库从零搭建:Monorepo架构、按需加载与工程化实践

组件化开发是现代前端工程的核心实践,它通过将界面拆分为独立、可复用的单元,提升了代码的可维护性和开发效率。其原理在于遵循高内聚、低耦合的设计思想,确保每个组件具备清晰的职责边界和稳定的对外接口。这一技术价值在于能够构建统一的设计系统,保障团队协作的一致性,并显著减少重复开发成本。在应用场景上,组件库广泛应用于中后台管理系统、设计系统以及需要跨项目复用的前端架构中。本文聚焦于使用Vue 3.4、Vite和TypeScript,从零构建一个支持Monorepo管理、自动化文档和单元测试的现代化UI组件库,深入探

weixin_34417183的博客 397

前端测试策略实战:基于测试金字塔的单元与UI测试完整方案

在软件开发中,测试是保障代码质量、提升开发效率的核心工程实践。其基本原理在于通过自动化验证,确保代码行为符合预期,从而在快速迭代中维持系统稳定性。从技术价值看,一套完善的测试策略能显著降低回归错误、增强重构信心,并促进团队协作与代码可维护性。尤其在**前端开发**领域,面对复杂的用户交互与频繁的界面变更,如何设计高效、可靠的测试体系成为关键挑战。常见的应用场景包括验证业务逻辑、保障用户关键流程以及实现持续集成。本文以**Material Design风格应用**为例,深入解析如何结合单元测试与UI测试,构建

weixin_30920513的博客 373
上一篇: 记一次给ant-design-vue组件库提pr的经历
下一篇: vitest 单元测试配合@vue/test-utils 之 pinia 篇
Selicens
博客等级 码龄7年 33粉丝 33原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值