IntersectionObserver v2 并不存在，浏览器仅支持v1标准；所谓v2是社区对已废弃或调整的草案特性的误称，实际可用的是稳定原生API，需关注threshold数组配置、trackVisibility兼容性及root边界设置等核心实践。
IntersectionObserver v2 并不存在——浏览器至今（截至 2024 年）只实现了 IntersectionObserver（v1），而所谓“v2”是社区误传或对草案特性的混淆。你实际能用的，就是原生 IntersectionObserver API，它已稳定支持多年，且具备足够强的可见性检测能力。
为什么搜“IntersectionObserver v2”会得到错误结果
早期 Chromium 曾实验性实现过 thresholds 的扩展语法（如支持 { threshold: [0, 0.25, 0.5, 0.75, 1] }）、trackVisibility 和 delay 等提案特性，部分文档/博客将其称为“v2”，但这些功能后来被拆解、调整或弃用。目前：
-
trackVisibility: true已被 Chrome/Edge 支持（需配合visibilityState属性），但它不是独立版本，而是同一 API 的可选配置项 -
delay从未进入标准，已被移除 -
getBoundingClientRect()仍是最可靠 fallback，不要指望“v2”自动帮你做像素级懒加载优化
真正该关注的 IntersectionObserver 兼容性与配置陷阱
多数“检测失效”问题出在初始化时机或 root 边界设置上，而非版本缺失：
- 确保目标元素已挂载 DOM 后再调用
observe()；在 Vue/React 中，别在mounted或useEffect外提前实例化观察器 -
root默认为视口，若设为某个容器（如document.querySelector('.scroll-area')），必须确认该容器有明确高度 +overflow: auto/scroll，否则无法触发交叉 -
threshold是数组，不是单个数字：写成[0, 0.5, 1]表示在 0%、50%、100% 进入时都触发回调；写成0.1（非数组）会被自动转为[0.1]，仅触发一次 - Safari 15.4+ 才完整支持
trackVisibility；旧版 Safari 会静默忽略该字段，不报错也不生效
如何安全启用 visibilityState 检测（最接近“v2”需求的实践）
当需要判断元素是否“真正可见”（比如被其他元素遮挡、tab 切换后隐藏），可用 trackVisibility: true + visibilityState：
立即学习“前端免费学习笔记（深入）”；
const observer = new IntersectionObserver(
(entries) => {
entries.forEach(entry => {
// entry.isIntersecting 只表示在 root 内有交集
// entry.visibilityState 才反映真实可见性（'visible' / 'hidden'）
if (entry.isIntersecting && entry.visibilityState === 'visible') {
console.log('元素不仅在视口内，而且未被遮挡、未被冻结');
}
});
},
{
trackVisibility: true,
delay: 100 // ❌ 错误！delay 已废弃，此行会被忽略
}
);
注意：delay 字段必须删掉，否则整个 options 可能被部分浏览器拒绝解析；Chrome 当前仅支持 trackVisibility，不支持任何延迟机制。
真正难的是处理嵌套滚动、iframe、position: fixed 元素的边界判定，这些和“v2”无关，但直接影响你的懒加载是否卡顿或漏触发——别被版本名带偏，先校验 root 和 threshold 是否按需配置。
