萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript 事件監聽器完整指南:addEventListener/removeEventListener 參數對應、選項物件、跨瀏覽器相容與記憶體管理

事件監聽是前端互動核心。addEventListener 第三參數在不同瀏覽器預設值不同、removeEventListener 需精確匹配參數、IE 歷史差異、記憶體洩漏風險。本文系統整理標準用法、陷阱避坑、現代最佳實務與封裝工具。

標準語法與參數詳解

target.addEventListener(type, listener, options);

第三參數演進

形式支援說明
useCapture (布林)所有現代瀏覽器 + IE9+true=捕獲階段, false=冒泡階段 (預設)
options 物件Chrome 55+, Firefox 59+, Safari 11+{capture, once, passive, signal}

Options 物件完整屬性

element.addEventListener('click', handler, {
    capture: false,      // 捕獲階段觸發
    once: false,         // true: 執行一次後自動移除
    passive: false,      // true: 永不呼叫 preventDefault(),瀏覽器可優化滾動
    signal: abortSignal  // AbortController 信號,統一移除
});

關鍵陷阱:removeEventListener 參數必須完全一致

// ❌ 錯誤:第三參數不一致
element.addEventListener('click', handler, true);   // 捕獲
element.removeEventListener('click', handler, false); // 冒泡 - 無法移除!

// ✅ 正確:參數完全一致
element.addEventListener('click', handler, true);
element.removeEventListener('click', handler, true); // 成功移除

// ✅ 現代寫法:使用 options 物件
const options = { capture: true, passive: true };
element.addEventListener('click', handler, options);
element.removeEventListener('click', handler, options); // 物件引用相同或屬性相同

IE 歷史差異與 Polyfill 策略

// 統一封裝:支援 IE8+
function addEvent(element, type, handler, options = {}) {
    const capture = !!options.capture;
    const once = !!options.once;
    const passive = !!options.passive;
    
    if (element.addEventListener) {
        // 現代瀏覽器
        const opts = { capture, once, passive };
        element.addEventListener(type, handler, opts);
        return () => element.removeEventListener(type, handler, opts);
    } else if (element.attachEvent) {
        // IE8-
        const wrapped = function(e) {
            e = e || window.event;
            e.target = e.srcElement;
            e.preventDefault = () => e.returnValue = false;
            e.stopPropagation = () => e.cancelBubble = true;
            return handler.call(element, e);
        };
        element.attachEvent('on' + type, wrapped);
        return () => element.detachEvent('on' + type, wrapped);
    } else {
        // 極舊瀏覽器 fallback
        element['on' + type] = handler;
        return () => element['on' + type] = null;
    }
}

// 使用:回傳移除函式
const removeClick = addEvent(btn, 'click', () => console.log('clicked'), { once: true });
// 手動移除
removeClick();

現代最佳實務:AbortController 統一管理

const controller = new AbortController();
const { signal } = controller;

// 批次綁定多個事件
['click', 'keydown', 'mouseover'].forEach(type => {
    element.addEventListener(type, handler, { signal, passive: true });
});

// 一次性全部移除
controller.abort();

記憶體洩漏防範

洩漏來源原因解決
匿名函式無法移除el.addEventListener('click', () => {}) 無引用命名函式或保存引用
元素移除未解綁DOM 移除但監聽器殘留元素移除前調用 removeEventListener
閉包捕獲大量資料監聽器閉包持有大物件弱引用 WeakMap / 手動清理
重複綁定元件重複掛載未清理掛載前清理、使用 once、AbortController

被動事件監聽器 關鍵知識

// 捲動容器內的 touchstart,預設 passive=true (現代瀏覽器)
container.addEventListener('touchstart', handler, { passive: true });
// 內部不可呼叫 e.preventDefault(),否則瀏覽器忽略並警告

// 需要 preventDefault 時必須顯式 passive: false
container.addEventListener('touchstart', e => {
    if (shouldPrevent) e.preventDefault();
}, { passive: false });

事件物件標準化 (跨瀏覽器)

function normalizeEvent(e) {
    e = e || window.event;
    e.target = e.target || e.srcElement;
    e.currentTarget = e.currentTarget || e.target; // 近似
    e.preventDefault = e.preventDefault || function() { this.returnValue = false; };
    e.stopPropagation = e.stopPropagation || function() { this.cancelBubble = true; };
    e.which = e.which || e.keyCode; // 鍵盤
    e.pageX = e.pageX || e.clientX + document.documentElement.scrollLeft;
    e.pageY = e.pageY || e.clientY + document.documentElement.scrollTop;
    return e;
}

// 使用
element.addEventListener('click', function(e) {
    e = normalizeEvent(e);
    // 統一使用 e.target, e.preventDefault(), e.stopPropagation()
});

進階:自訂事件與事件委派模式

// 自訂事件
const event = new CustomEvent('user-login', { 
    detail: { userId: 123, token: 'abc' },
    bubbles: true,
    cancelable: true
});
document.dispatchEvent(event);

// 監聽
document.addEventListener('user-login', e => {
    console.log(e.detail.userId);
});

// 事件委派:父層監聽子元素事件
document.body.addEventListener('click', e => {
    const btn = e.target.closest('[data-action]');
    if (!btn) return;
    
    const action = btn.dataset.action;
    const payload = JSON.parse(btn.dataset.payload || '{}');
    
    switch (action) {
        case 'delete': deleteItem(payload.id); break;
        case 'edit': editItem(payload.id); break;
    }
});

框架整合注意事項

  • React:合成事件系統,onClick 自動綁定、清理,勿混用原生 addEventListener 除非 useEffect 清理函式中
  • Vue:@click 編譯為原生監聽,組件銷毀自動移除
  • 原生 Web Components:connectedCallback 綁定、disconnectedCallback 清理

總結

事件監聽核心在於:參數完全對稱 (add/remove 同參數)、選項物件現代化 (once/passive/signal/AbortController)、記憶體洩漏預防 (命名函式、清理時機、弱引用)。理解捕獲/冒泡、事件物件標準化、IE 歷史差異,能寫出健壯、高效、可維護的事件處理代碼。

copyright © 萬盛學電腦網 all rights reserved