#测试

Rsbuild 本身不内置测试框架，它可以与各种流行的测试工具配合使用。

本指南将介绍如何在 Rsbuild 应用中添加 单元测试 和 端到端测试。

#单元测试

单元测试用于测试独立的组件和函数。Rsbuild 可以与 Rstest、Vitest、Jest 等测试框架配合使用。

下面以 Rstest 为例，介绍如何在 Rsbuild 应用中添加单元测试。

#Rstest

Rstest 基于 Rsbuild 实现的测试框架，为 Rsbuild 应用提供了一流的支持。它提供与 Jest 兼容的 API，同时原生支持 TypeScript、ESM 等现代特性。

#安装

npm add @rstest/core @rstest/adapter-rsbuild -D

yarn add @rstest/core @rstest/adapter-rsbuild -D

pnpm add @rstest/core @rstest/adapter-rsbuild -D

bun add @rstest/core @rstest/adapter-rsbuild -D

deno add npm:@rstest/core npm:@rstest/adapter-rsbuild -D

#配置脚本

在 package.json 中添加测试脚本：

{
  "scripts": {
    "test": "rstest",
    "test:watch": "rstest -w"
  }
}

#编写测试

创建测试文件，例如：

export function add(a: number, b: number) {
  return a + b;
}

import { expect, test } from '@rstest/core';
import { add } from './utils';

test('should add two numbers correctly', () => {
  expect(add(1, 2)).toBe(3);
  expect(add(-1, 1)).toBe(0);
});

#运行测试

# 运行测试
npm run test

# 运行并监听
npm run test:watch

#配置 Rstest

在项目根目录创建 rstest.config.ts 文件，并使用 @rstest/adapter-rsbuild 复用已有的 Rsbuild 配置：

import { defineConfig } from '@rstest/core';
import { withRsbuildConfig } from '@rstest/adapter-rsbuild';

export default defineConfig({
  extends: withRsbuildConfig(),
  // 额外的 rstest 特定配置
});

你可以在同一个配置文件中添加 Rstest 特定的配置，例如测试文件匹配规则、setup 文件和代码覆盖率。

以上就是使用 Rstest 的基本步骤，查看 Rstest 文档 了解更多用法。

#示例

rstack-examples 仓库收集了一些 Rstest 使用示例，可用于了解常见用法和实践。

#端到端测试

端到端测试用于测试完整的用户流程，确保应用在真实浏览器环境中正常工作。

你可以使用 Playwright 进行 E2E 测试，它是一个现代的端到端测试框架，详见 Playwright 文档。