必须用closest()查找data-track元素，因event.target常为子元素而无该属性；需监听pointerdown防移动端click失效；上报必须用sendbeacon避免跳转丢包；防重复需字符串严格比对dataset.tracked。
data-track 属性必须用 closest() 查找，不能靠 event.target 直接读取
用户点击按钮内部的图标或文字时，event.target 往往是子元素（比如 <i></i> 或 <span></span>），它本身没有 data-track。如果写成 if (e.target.hasAttribute('data-track'))，90% 的点击都会漏报。
正确做法是用 event.target.closest('[data-track]') 向上查找最近的带埋点属性的祖先元素。这个 API 兼容所有现代浏览器（包括 iOS Safari 和 Android Chrome），且性能开销极小。
-
closest()返回 null 时说明点击区域没埋点，直接 return 即可 - 不要在循环里反复调用
closest()—— 每次事件只查一次 - 如果元素有多个嵌套层级（如
<button><div><span>提交</span></div></button>），closest()仍能准确命中button
移动端必须监听 pointerdown，click 不可靠
iOS 和多数安卓 WebView 对 click 事件有 300ms 延迟，甚至在某些 Hybrid 场景下完全不触发。用户点了就跳转，click 还没执行上报就丢了。
优先使用 pointerdown：它响应快、兼容性好（Chrome 56+、Safari 13+、Firefox 59+），且不会像 touchstart 那样在滚动时误触发。
文章转信息图。将文章/笔记转化为手机可读的 HTML 信息图，自动匹配视觉风格。触发场景：文章转图、笔记转图、信息图、转小红书图、做张图、可视化这篇文章、文生图。
- 监听时建议同时注册
pointerdown和降级的click：document.addEventListener('pointerdown', handler, { passive: true }) -
passive: true能避免阻止默认滚动行为，提升滑动流畅度 - 不要在
pointerdown回调里做 DOM 查询以外的重操作——比如解析 JSON 或计算路径，这些应延迟到上报前统一处理
上报必须用 navigator.sendBeacon，fetch / XMLHttpRequest 在页面跳转时大概率失败
用户点击“立即购买”后立刻跳转到支付页，此时浏览器会终止所有未完成的 fetch 或 XMLHttpRequest 请求。实测丢包率高达 60%~80%，尤其在低端安卓机上。
navigator.sendBeacon 是唯一被浏览器保证能在卸载前发出的机制。它不阻塞导航，也不需要等待响应，适合埋点这种“发了就行”的场景。
- body 必须是
ArrayBuffer、Blob、FormData或URLSearchParams—— 推荐用new URLSearchParams(payload)构造 - 不能用
JSON.stringify(payload)直接传，否则会报错Failed to execute 'sendBeacon' on 'Navigator': parameter 2 is not of type 'Blob' - 上报失败无法重试（
sendBeacon无回调），所以关键字段（如event、timestamp）必须在调用前校验非空
dataset.tracked 标记防重复必须用字符串比较，不能用布尔值
很多人写 if (el.dataset.tracked === true) 或 if (el.dataset.tracked)，结果发现重复上报依然发生。因为 HTML 中 data-tracked 属性无论写成 data-tracked、data-tracked="true" 还是 data-tracked="1"，JS 读出来都是字符串 "true"、"1" 或空字符串 ""，不是布尔值。
防重复标记必须显式赋值并严格比对字符串：
- 设置：
el.dataset.tracked = 'true' - 判断：
if (el.dataset.tracked === 'true') return - 不要用
==，避免隐式转换导致误判（比如'true' == true为 false，但'1' == true为 true） - 这个标记只对当前元素有效；不同按钮之间互不影响，无需全局去重逻辑
document.body 或 document 上，closest() 就能自然捕获它们。但如果你把监听器挂在某个局部容器上，又没考虑后续 appendChild，就会漏掉新节点。前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
