import { describe, expect, test } from "bun:test"; import type { RawKeyedExpectations } from "../../../../../src/server/checker/expect/types"; import { checkHeaderExpectations } from "../../../../../src/server/checker/expect/headers"; import { resolveKeyedExpectations } from "../../../../../src/server/checker/expect/keyed"; import { checkStatusCode } from "../../../../../src/server/checker/expect/status"; function checkHeaders(headers: Record, raw?: RawKeyedExpectations) { return checkHeaderExpectations(headers, resolveKeyedExpectations(raw)); } describe("checkHeaders", () => { test("未配置 headers expect 时匹配成功", () => { const result = checkHeaders({}); expect(result.matched).toBe(true); expect(result.failure).toBeNull(); }); test("字符串格式按等值匹配", () => { const headers = { "content-type": "application/json", "x-api": "v1" }; expect(checkHeaders(headers, { "content-type": "application/json" }).matched).toBe(true); expect(checkHeaders(headers, { "content-type": "text/html" }).matched).toBe(false); }); test("header 名称按小写响应头匹配", () => { const headers = { "content-type": "application/json" }; expect(checkHeaders(headers, { "Content-Type": "application/json" }).matched).toBe(true); }); test("操作符格式匹配", () => { const headers = { "content-type": "application/json" }; expect(checkHeaders(headers, { "content-type": { contains: "json" } }).matched).toBe(true); expect(checkHeaders(headers, { "content-type": { regex: "^application/" } }).matched).toBe(true); expect(checkHeaders(headers, { "content-type": { contains: "xml" } }).matched).toBe(false); }); test("缺失 header 默认返回失败", () => { const result = checkHeaders({}, { "x-missing": "value" }); expect(result.matched).toBe(false); expect(result.failure!.phase).toBe("headers"); expect(result.failure!.kind).toBe("mismatch"); }); test("缺失 header 且 exists=false 时匹配成功", () => { const result = checkHeaders({}, { "x-missing": { exists: false } }); expect(result.matched).toBe(true); expect(result.failure).toBeNull(); }); }); describe("checkStatusCode 范围匹配", () => { test("无 expect 配置时默认 status [200] 可由调用方使用 checkStatusCode 表达", () => { const result = checkStatusCode(200, [200]); expect(result.matched).toBe(true); expect(result.failure).toBeNull(); }); test("status 不匹配返回 phase=status 的失败", () => { const result = checkStatusCode(503, [200]); expect(result.matched).toBe(false); expect(result.failure!.phase).toBe("status"); expect(result.failure!.expected).toEqual([200]); expect(result.failure!.actual).toBe(503); }); test("2xx 范围匹配 200", () => { expect(checkStatusCode(200, ["2xx"]).matched).toBe(true); }); test("2xx 范围匹配 204", () => { expect(checkStatusCode(204, ["2xx"]).matched).toBe(true); }); test("2xx 范围不匹配 301", () => { expect(checkStatusCode(301, ["2xx"]).matched).toBe(false); }); test("5xx 范围匹配 503", () => { expect(checkStatusCode(503, ["5xx"]).matched).toBe(true); }); test("混合精确值与范围模式命中精确值", () => { expect(checkStatusCode(301, ["2xx", 301]).matched).toBe(true); }); test("混合精确值与范围模式命中范围", () => { expect(checkStatusCode(204, ["2xx", 301]).matched).toBe(true); }); test("混合模式都不匹配", () => { expect(checkStatusCode(404, ["2xx", 301]).matched).toBe(false); }); test("纯精确值仍正常工作", () => { expect(checkStatusCode(200, [200, 201]).matched).toBe(true); expect(checkStatusCode(404, [200, 201]).matched).toBe(false); }); test("1xx 范围匹配 101", () => { expect(checkStatusCode(101, ["1xx"]).matched).toBe(true); }); test("3xx 范围匹配 301", () => { expect(checkStatusCode(301, ["3xx"]).matched).toBe(true); }); test("4xx 范围匹配 404", () => { expect(checkStatusCode(404, ["4xx"]).matched).toBe(true); }); });