# Test Report

## v1.5.6 验证
- 验证文件事件、`rs` 与 `SIGUSR1` 重启请求串行执行。
- 验证旧进程退出并释放资源后才启动新进程。
- 全量测试、竞态测试和基准测试均通过。

## 单元测试结果
执行时间: 2026-06-27

```
=== RUN   TestWatch
--- PASS: TestWatch (0.21s)
=== RUN   TestDirEventWithTypeFilter
--- PASS: TestDirEventWithTypeFilter (0.15s)
=== RUN   TestDebounce
--- PASS: TestDebounce (0.26s)
=== RUN   TestEasyStart
--- PASS: TestEasyStart (0.00s)
PASS
ok  	apigo.cc/go/watch	1.018s
```

## 性能测试结果 (Benchmark)
```
BenchmarkIsMatch-16                 	26264806	        45.35 ns/op
BenchmarkIsExcluded-16              	42229480	        28.65 ns/op
BenchmarkDebounce-16                	 8131125	       148.0 ns/op
BenchmarkKeyGeneration-16           	47584114	        25.56 ns/op
BenchmarkKeyGenerationWithFmt-16    	13956841	        88.51 ns/op
```

## 测试覆盖场景
1. **基础监听**: 验证文件创建事件。
2. **Gitignore 语义过滤**:
   - 验证 `*.log` 后缀匹配。
   - 验证 `**/node_modules/**` 目录及其内容的深度匹配与拦截。
3. **事件防抖 (Debounce)**:
   - 验证 100ms 内对同一文件的 5 次连续写入被合并为 1 次回调。
4. **路径归一化**: 验证绝对路径下的准确匹配。
5. **极简接口**: 验证 `EasyStart` 的可用性。
6. **性能优化验证**: 验证在高频匹配场景下的 $O(1)$ 查找能力。
7. **类型白名单与目录过滤**: 验证开启 Types 白名单时，正常过滤目录变更事件，不误触发回调 (`TestDirEventWithTypeFilter`)。
8. **重启并发控制**: 连续发送多个 `SIGUSR1` 时重启串行执行，旧监听端口释放后才启动新进程。