在 javascript 中,addeventlistener 的第三个参数用于配置事件监听器的行为,它接受一个布尔值或一个包含详细选项的对象。如果传入布尔值 true,表示使用捕获阶段(capturing phase)触发回调;如果传入 false 或不传,则默认在冒泡阶段(bubbling phase)触发。现代开发推荐使用对象形式,除了指定 capture 外,还可以设置 once(自动移除)、passive(提升滚动性能)等属性。

如何区分捕获与冒泡阶段的执行顺序
要理解第三个参数的影响,需要明确 DOM 事件流的三个阶段:捕获、目标、冒泡。当第三个参数为 true 时,监听器会在浏览器从根节点向下查找目标节点的“捕获”过程中被调用;默认为 false 时,则在从目标节点向上传递的“冒泡”过程中调用。这决定了父级和子级元素同时绑定事件时的执行先后顺序。

const parent = document.getElementById('parent');
const child = document.getElementById('child');
// 父级:捕获阶段
parent.addEventListener('click', () => console.log('Parent Capture'), true);
// 父级:冒泡阶段
parent.addEventListener('click', () => console.log('Parent Bubble'));
// 子级:冒泡阶段
child.addEventListener('click', () => console.log('Child Bubble'));
// 点击 child 输出顺序:
// 1. Parent Capture
// 2. Child Bubble
// 3. Parent Bubble
如何使用 passive 选项优化滚动性能
在处理触摸或滚轮事件时,浏览器为了安全起见,会阻塞主线程直到确定事件是否调用了 preventDefault()。通过设置第三个参数为 { passive: true },开发者明确告知浏览器该监听器不会阻止默认行为,从而允许浏览器立即进行滚动渲染,显著提升页面流畅度。
FilePond 是一个 JavaScript 文件上传库,支持通过拖拽、粘贴和 API 方式处理文件、目录、URL 和 Data URI。它包含内置的图像优化功能、异步分块上传功能,并提供了适用于 React、Vue、Angular 和 Svelte 的适配器。
立即学习“Java免费学习笔记(深入)”;

window.addEventListener('touchstart', (e) => {
// 这里不需要调用 e.preventDefault()
console.log('Touch started');
}, { passive: true });
// 错误示范:如果设置了 passive: true 却调用 preventDefault
// window.addEventListener('scroll', (e) => {
// e.preventDefault(); // 无效且可能抛出警告
// }, { passive: true });
once 选项如何实现一次性监听
在实际业务中,很多事件只需要触发一次,例如弹窗关闭后的遮罩层点击。使用第三个参数中的 once: true 可以简化代码,避免手动在回调内部调用 removeEventListener。当事件触发后,监听器会自动从元素上移除,防止内存泄漏。

















