Files
streamline/satellite/test/tracking_guard.test.ts
2026-11-16 17:26:44 -08:00

108 lines
4.2 KiB
TypeScript

import { test, expect, describe } from "bun:test";
import {
scanTrackingDiff, summarizeTrackingImpact, trackingNeedsAttention, renderTrackingImpactMarkdown,
TRACKING_GUARD_BLOCK,
} from "@bbbug/shared/tracking_guard";
/**
* 埋点扫描的判定。
*
* 这些用例钉的是**档位**,不是命中数:档位是唯一进入卡片、飞书通知和抽屉的东西,
* 而命中数只是给人读的注脚。尤其是 `removed`(有删无增)和 `changed`(有删有增)
* 必须分开 —— 前者是「埋点没了」,后者是「埋点改了」,提需人对这两件事的反应不同。
*/
const diff = (file: string, body: string) =>
`diff --git a/${file} b/${file}\n--- a/${file}\n+++ b/${file}\n@@ -1,5 +1,5 @@\n${body}\n`;
describe("埋点扫描 · 档位判定", () => {
test("删掉一个上报调用且无对应新增 → removed", () => {
const i = scanTrackingDiff(diff("app/src/Entry.kt", [
" fun onClick() {",
'- MobClickHelper.onEventV3("story_camera_click", params)',
" navigate()",
" }",
].join("\n")));
expect(i.verdict).toBe("removed");
expect(i.removed).toBe(1);
expect(i.eventKeys).toContain("story_camera_click");
expect(trackingNeedsAttention(i)).toBe(true);
});
test("有删有增(改名 / 挪位置)→ changed", () => {
const i = scanTrackingDiff(diff("app/src/Entry.kt", [
'- MobClickHelper.onEventV3("story_camera_click", params)',
'+ MobClickHelper.onEventV3("story_camera_tap", params)',
].join("\n")));
expect(i.verdict).toBe("changed");
expect(trackingNeedsAttention(i)).toBe(true);
});
test("只新增上报 → added,且不算需要人确认", () => {
const i = scanTrackingDiff(diff("app/src/Entry.kt",
'+ MobClickHelper.onEventV3("new_entry_show", params)'));
expect(i.verdict).toBe("added");
expect(trackingNeedsAttention(i)).toBe(false);
});
test("改动紧挨着既有埋点但没碰它 → nearby(漏埋的信号)", () => {
const i = scanTrackingDiff(diff("app/src/Entry.kt", [
' MobClickHelper.onEventV3("story_camera_click", params)',
"- navigate(OLD)",
"+ navigate(NEW)",
].join("\n")));
expect(i.verdict).toBe("nearby");
expect(i.removed + i.added).toBe(0);
expect(trackingNeedsAttention(i)).toBe(false);
});
test("完全不沾埋点 → none", () => {
const i = scanTrackingDiff(diff("app/src/Entry.kt", "- val a = 1\n+ val a = 2"));
expect(i.verdict).toBe("none");
expect(summarizeTrackingImpact(i)).toContain("未触碰埋点");
});
test("非源码文件的命中不算数(锁文件 / 快照里的同名字符串)", () => {
const i = scanTrackingDiff(diff("bun.lock", '- "trackEvent": "1.0.0"'));
expect(i.verdict).toBe("none");
});
test("iOS 侧的上报家族同样识别", () => {
const i = scanTrackingDiff(diff("Sources/AWEEntry.m",
'- [AWEUserTrackManager trackEvent:@"story_camera_click" params:p];'));
expect(i.verdict).toBe("removed");
});
test("空 diff 不炸", () => {
expect(scanTrackingDiff("").verdict).toBe("none");
expect(scanTrackingDiff(" \n").verdict).toBe("none");
});
});
describe("埋点扫描 · 产物", () => {
test("removed 档的 markdown 明确要求提需人确认", () => {
const i = scanTrackingDiff(diff("app/src/Entry.kt",
'- MobClickHelper.onEventV3("story_camera_click", params)'));
const md = renderTrackingImpactMarkdown(i);
expect(md).toContain("## 埋点影响");
expect(md).toContain("需要提需人确认");
expect(md).toContain("app/src/Entry.kt");
});
test("扫描失败时的摘要说的是「没扫成」,不是「没事」", () => {
// 这两者混为一谈,正是这套护栏要防的那类沉默。
const s = summarizeTrackingImpact({
verdict: "none", files: [], removed: 0, added: 0, nearby: 0, eventKeys: [], error: "仓库不存在",
});
expect(s).toContain("未能扫描");
expect(s).not.toContain("未触碰");
});
});
describe("埋点铁律块", () => {
test("不再把覆盖率插桩和业务埋点绑在一起", () => {
expect(TRACKING_GUARD_BLOCK).not.toContain("调试插桩");
expect(TRACKING_GUARD_BLOCK).not.toContain("行覆盖");
expect(TRACKING_GUARD_BLOCK).toContain("业务埋点");
});
});