在 javascript 事件捕获与冒泡中,passive 选项通过告知浏览器该事件监听器不会调用 preventdefault(),从而允许浏览器跳过等待用户输入以决定是否需要取消默认行为的同步阻塞阶段,实现滚动性能的即时提升。具体做法是在添加事件监听器时,将第三个参数或 options 对象中的 passive 设置为 true。这样做能让浏览器立即响应滚动操作,消除因等待 js 执行而导致的界面卡顿。

为什么非 passive 监听器会阻塞滚动
当未设置 passive 为 true 时,浏览器必须假设监听器可能会调用 preventDefault() 来阻止默认的滚动行为。因此,浏览器在触发事件前必须暂停渲染线程,同步执行所有注册的 touchstart 或 wheel 监听器,确认没有代码调用 preventDefault() 后,才继续处理滚动逻辑。这种同步检查机制导致了明显的输入延迟。
document.addEventListener('touchstart', function(e) {
// 如果这里不调用 e.preventDefault()
// 浏览器仍要等待这段代码执行完
}, false);上述代码中,即使开发者并未意图阻止滚动,浏览器也无法提前知晓这一点,必须等待函数体执行完毕。若监听器中包含复杂的计算或网络请求,这种等待时间会被进一步拉长,造成页面掉帧。
如何正确配置 passive 选项
要启用被动模式,需在 addEventListener 的 options 参数中显式声明 passive: true。这通常应用于那些明确不需要阻止默认行为的触摸或滚轮事件上,如自定义手势识别或无限滚动加载。
立即学习“Java免费学习笔记(深入)”;
element.addEventListener('touchmove', handleScroll, { passive: true });
// 或者使用旧版兼容写法
element.addEventListener('wheel', handleWheel, false); // 注意:旧版无法直接设 passive
// 现代浏览器推荐始终使用对象参数形式
window.addEventListener('scroll', onScroll, { passive: true });配置后,浏览器知道无需等待该监听器的执行结果来决定是否取消默认动作,可以直接开始滚动动画,显著提升交互流畅度。需要注意的是,如果在 passive: true 的监听器中调用 preventDefault(),现代浏览器会在控制台抛出警告,且该调用无效,因为默认行为已被提前执行。
基于 scroll 事件中 passive 对布局重排的影响
在 scroll 事件中应用 passive 选项不仅能加速滚动启动,还能减少因同步执行 JS 而引发的强制同步布局(Forced Synchronous Layouts)。当滚动监听器内包含读取布局属性(如 offsetTop、getBoundingClientRect)的操作时,非 passive 模式会导致浏览器在每次滚动帧都重新计算样式和布局,以准备可能发生的 preventDefault 决策。设为 passive 后,浏览器可异步调度这些读取操作,避免阻塞主线程。
window.addEventListener('scroll', () => {
const height = document.body.offsetHeight;
console.log(height);
}, { passive: true });在此场景下,尽管读取操作本身仍在 JS 线程执行,但由于滚动过程不再被 JS 执行流阻塞,视觉上的滚动连续性得以保持。若移除 passive 标志,且监听器执行时间较长,用户会感觉到滚动指针滞后于手指滑动轨迹。



















