# bun test 基础用法

URL: https://caijiao.org/bun/test/usage
Source: docs/bun/test/usage.md
Description: 介绍 Bun 的测试框架基础用法，涵盖如何编写和运行测试，帮助开发者快速验证代码逻辑，确保应用质量。

Bun 提供了内置的测试框架，使得开发者能够轻松编写、运行和管理测试。通过 `bun test`，开发者可以快速验证代码逻辑，确保应用的正确性和稳定性。以下是 [Bun](/bun/) 测试框架的基础用法。

## 1. 安装 Bun 测试框架

Bun 默认集成了测试框架，开发者无需额外安装任何依赖即可使用。直接使用 `bun test` 命令运行测试。

## 2. 编写测试

Bun 测试框架使用 Jest 风格的语法，开发者可以编写简单的单元测试来验证功能。以下是一个简单的测试示例：

```js
import { expect } from 'bun:test';

it('should add two numbers correctly', () => {
  const sum = 1 + 2;
  expect(sum).toBe(3);
});
````

这个测试验证了 `1 + 2` 的计算结果是否为 `3`。

## 3. 运行测试

编写完测试用例后，使用 `bun test` 命令运行测试。

```bash
bun test
```

该命令会自动查找项目中的测试文件，并执行它们。默认情况下，测试文件以 `.test.js` 或 `.test.ts` 为后缀。

## 4. 运行特定测试

如果只想运行某个特定的测试文件或测试用例，可以在命令后指定文件或用例的名称。例如：

```bash
bun test my-test-file.test.js
```

这将仅运行指定的测试文件中的测试。

## 5. 监视模式

在开发过程中，热重载测试是一个非常有用的功能。通过使用 `--watch` 标志，Bun 会在测试文件发生变化时自动重新运行测试。

```bash
bun test --watch
```

这种方式可以提高开发效率，确保在编写代码的同时，测试始终保持最新。

## 6. 测试报告

Bun 提供了清晰的测试报告，可以显示每个测试的通过/失败状态，以及相关的错误信息。在测试执行完成后，Bun 会自动输出结果，并为失败的测试提供详细的错误堆栈信息，帮助开发者定位问题。

## 总结

Bun 提供了简单易用的测试框架，开发者可以快速编写和运行测试，确保代码的稳定性和可靠性。通过支持监视模式和清晰的测试报告，Bun 提供了一套高效的工具，帮助开发者更好地进行测试和调试。