lanyuanxiaoyao
cfca03b4d6
- 合并 20+ 细粒度 spec 为粗粒度主题规范：dashboard、data-store、probe-engine、probe-api、probe-config 等 - 删除完全冗余规范：data-retention（被 probe-engine+data-store 覆盖）、backend-code-quality（DEVELOPMENT.md 已记录） - 补充 http-checker 规范至完整标准（配置+执行+expect+校验+observation），匹配代码 440 行实现 - 清理 tcp/udp/llm checker 规范中已废弃 defaults 配置段的残留 Scenario - 清理 checker-cohesion-structure 中的实现路径引用（src/server/...） - 统一所有 spec 格式（## Purpose 开头，去除 # Capability/Title 形式） - 更新 prompt-spec-review.md 审查提示文档
28 lines
1.7 KiB
Markdown
28 lines
1.7 KiB
Markdown
## Purpose
|
||
|
||
确保测试运行时输出干净、无噪音，便于开发者快速定位问题。
|
||
|
||
## Requirements
|
||
|
||
### Requirement: 测试不应产生无关 console 输出
|
||
测试运行时，由测试用例预期的容错行为（如 JSON 解析失败、checker rejected）触发的 logger 输出 SHALL 在测试代码中被抑制，不污染测试报告。测试 SHALL 优先通过注入 no-op logger 或 memory logger 抑制预期日志，而不是直接覆盖全局 `console.warn`。
|
||
|
||
#### Scenario: 容错测试抑制 logger 输出
|
||
- **WHEN** 测试用例故意注入损坏数据或触发异常以验证系统容错行为
|
||
- **THEN** 测试 SHALL 注入 no-op logger 或 memory logger，并在断言完成后恢复默认测试上下文
|
||
|
||
#### Scenario: 非预期 logger 输出不被抑制
|
||
- **WHEN** 测试用例并非专门测试容错行为
|
||
- **THEN** 测试 SHALL NOT 抑制 logger 输出，确保意外 warn 或 error 可被观测
|
||
|
||
### Requirement: 探针执行失败日志输出单行消息
|
||
ProbeEngine 在捕获 checker rejected 时，logger SHALL 输出单行错误消息文本，MUST NOT 输出 Error 对象（会导致多行堆栈噪音）。该日志 SHALL 使用 `error` 等级，并包含 targetId、targetType 和 `formatReason()` 提取的错误消息。
|
||
|
||
#### Scenario: checker rejected 输出单行日志
|
||
- **WHEN** checker 执行抛出未捕获异常（Promise rejected）
|
||
- **THEN** logger SHALL 输出格式为 `探针执行失败: <message>` 的单行消息，其中 message 使用 `formatReason()` 提取
|
||
|
||
#### Scenario: formatReason 复用
|
||
- **WHEN** 构建失败日志消息和写入 CheckFailure
|
||
- **THEN** 两者 SHALL 共用同一个 `formatReason` 函数提取错误消息
|