108 lines
4.2 KiB
TypeScript
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("业务埋点");
|
|
});
|
|
});
|