【vue组件库搭建07】Vitest单元测试_Vue.js

我们的测试框架选择的是 vitest 和 vue-test-utils。两者的关系为：

vitest 提供测试方法：断言、mock 、spyon 等方法。
vue-test-utils:
- 挂载和渲染组件： vue test utils 允许您在隔离中挂载组件，这意味着您可以测试单个组件而不必担心其子组件或需要完整的 vue 应用环境。它还支持浅层挂载，其中子组件被存根，使测试更快并且只关注正在测试的组件。
- 访问 vue 实例：当组件被挂载时，vue test utils 提供对 vue 实例的访问，使得可以检查和与组件的数据、计算属性、方法和生命周期钩子进行交互。
- 事件模拟：它提供了模拟用户操作（如点击或输入）的实用程序，使测试能够像用户一样与组件进行交互。
- 查找元素： vue test utils 提供了查找组件内元素的方法，既可以使用选择器也可以引用 vue 组件。这对于断言元素的存在或作为测试的一部分与它们交互非常有用。
- 存根和模拟：它支持存根子组件，这对于隔离正在测试的组件非常有用。您还可以使用 jest 或其他模拟库来模拟组件使用的外部依赖或模块。
jsdom: 在测试的运行环境 node 下提供对 web 标准的模拟实现，比如 window，document， web存储的api 在 node 运行时是不存在的，这影响了测试。 jsdom 完成了对这些标准的补充。

1.搭建环境

安装依赖

// 测试框架， 用于执行整个测试过程并提供断言库、mock、覆盖率
npm i vitest -d
npm i -d @vitest/ui
npm i -d @vitest/coverage-v8
npm i -d @vitest/coverage-istanbul
// 用于提供在 node 环境中的 dom 仿真模型
npm i jsdom -d
// 测试工具库
npm i @vue/test-utils

vite.config.js配置

export default defineconfig({
  test: {
    globals: true,
    environment: "jsdom",
    coverage: {
      provider: "v8",
      reporter: ["text", "html", "clover", "json"],
    },
  },
}

修改运行脚本 package.json

"scripts": {
    ...
    "test": "vitest"
},

编写测试用例

const add = (a, b) => {
  return a + b;
};

describe("测试 add 函数", () => {
  test("add(1, 2) === 3", () => {
    expect(add(1, 2)).tobe(3);
  });
  test("add(1, 1) === 2", () => {
    expect(add(1, 1)).tobe(2);
  });
});

运行测试

2.输出测试报告集成到组件库文档

配置package.json

{
  "scripts": {
    "dev": "vite",
    "build:lib": "vite build --config ./build/lib.config.js",
    "preview": "vite preview",
    "docs:dev": "vitepress dev docs",
    "docs:build": "vitepress build docs",
    "docs:preview": "vitepress preview docs",
    // 运行测试用例
    "test": "vitest",
    // 输出测试报告（可以设置--coverage.enabled=true开启覆盖率）
    "test:report": "vitest run --coverage.reporter=html --coverage.reportsdirectory=./docs/public/coverage  --reporter=html --outputfile.html=./docs/public/report/index.html"
  },
 
}

将报告输出格式设置成html，并将输出位置设置为docs/public目录下。

设置vite.config.js

export default defineconfig({
  test: {
    globals: true,
    environment: "jsdom",
    include: ["./components/**/_test_/*.{js,ts}"],
    coverage: {
      provider: "v8",
      include: ["components/**/*.vue"],
      reporter: ['text', 'html', 'clover', 'json'],
    },
  },
}

设置docs\.vitepress\config.js

export default defineconfig({
  themeconfig: {
    nav: [
     // 更换成实际地址
      { text: "测试用例报告", link: "http://localhost:5173/eric-ui/report/index.html",  target: '_self', },
    ],
}

最终效果