stopImmediatePropagation用于阻止当前事件对象上尚未执行的同级监听器继续执行，即相同事件类型、相同目标元素、相同捕获/冒泡阶段的其余监听器；它同时阻止事件传播，而stopPropagation仅阻止传播但不阻止同级监听器执行。
stopImmediatePropagation 用于阻止**当前事件对象上尚未执行的同级监听器**（即相同事件类型、相同目标元素、相同捕获/冒泡阶段）继续执行，但它不会影响其他事件类型或不同目标元素上的监听器。
它和 stopPropagation 的区别
很多人容易混淆这两个方法：
- stopPropagation()：只阻止事件继续向父元素传播（即中断冒泡或捕获链），但**不影响同一元素上其他同级监听器执行**；
- stopImmediatePropagation()：既阻止事件传播，也**立即终止当前事件对象上剩余未执行的监听器调用**——哪怕它们是同一个元素、同一个事件、同一个阶段。
什么时候会触发“同级多个监听器”？
常见场景包括：
- 对同一个元素多次调用
addEventListener绑定相同事件（如两个click）； - 使用
onXXX属性 +addEventListener混合绑定（注意：onXXX不算“同级监听器”，它和 addEventListener 是独立机制，stopImmediatePropagation对它无效）； - 在捕获阶段和冒泡阶段分别添加监听器（它们属于不同阶段，互不影响）。
实际用法示例
下面代码中，点击按钮会触发两个 click 监听器，但第二个不会执行：
立即学习“Java免费学习笔记（深入）”；
const btn = document.getElementById('myBtn');
btn.addEventListener('click', function(e) {
console.log('第一个监听器');
e.stopImmediatePropagation(); // ⚠️ 关键：在此处调用
});
btn.addEventListener('click', function(e) {
console.log('第二个监听器'); // ❌ 不会输出
});
// 即使还有第三个，也不会执行
btn.addEventListener('click', function(e) {
console.log('第三个监听器'); // ❌ 同样被跳过
});
注意事项
- 必须在事件处理函数内部、且在其他同级监听器被调用前调用，才有效；
- 它不影响已开始执行的监听器，只跳过队列中排在后面的；
- 不能阻止通过
onclick="..."或element.onclick = ...设置的内联事件处理器（它们不是 addEventListener 队列的一部分）； - 如果监听器是通过
{ once: true }添加的，它仍会被 stopImmediatePropagation 影响——只要还没执行，就会被跳过。
