Intersection Observer 无效的 root
快速摘要
你把 null 或已脱离 DOM 的元素作为 observer root——交叉状态永不报告。
为什么发生
root 元素在创建 observer 前已从 DOM 移除
把字符串选择器而非 Element 作为 root 传入
querySelector 未找到元素导致 root 为 null
最小示例
✗ 错误代码
const root = document.querySelector('#nonexistent'); // null
const obs = new IntersectionObserver(entries => console.log(entries), { root });
obs.observe(document.querySelector('#target'));✓ 修复代码
const root = document.querySelector('#scroll-container');
if (root) {
const obs = new IntersectionObserver(entries => console.log(entries), { root });
obs.observe(document.querySelector('#target'));
}querySelector 对缺失选择器返回 null,用 null 作 root 可能静默失败。创建 observer 前检查 root 存在可避免问题。
如何诊断
检查 root 参数是已挂载 DOM 的合法 Element
通过记录 entries 确认回调是否触发
若要用视口作 root 则显式传 null
如何修复
创建 observer 前确保 root 元素存在且在 DOM 中
用 null(而非 undefined)以浏览器视口作 root
若 root 后续重新挂载则重建 observer
如何预防
用 instanceof Element 校验 root 元素
DOM 就绪且 root 存在后再创建 observer