這個問題值得單獨記一篇,因為它的症狀極具誤導性。
當時在改一份百度地圖的開源程式碼,想把裡面耦合在一起的邏輯拆開。拆完之後,某些該出現的效果不出現了。邏輯顯然沒問題,於是就埋頭找程式碼哪裡寫錯,找了大半天一無所獲。
直到在開發者工具中設中斷點逐步執行,才發現對應的事件被執行了兩次。當下就明白了:某個地方重複綁定了事件。回頭一看,果然在不同位置各綁了一次。
這是關鍵。重複綁定不一定表現為「做兩遍」,很多時候反而表現為「結果不對」或「什麼都沒發生」。例如:
· 第一次呼叫把元素隱藏,第二次呼叫把它顯示,看起來就像事件沒作用。
· 第一次新增一筆資料,第二次因名稱重複而失敗,最終什麼都沒存進去。
· 計數器被加兩次,總數對不上,你卻以為是初始值算錯。
因此,當你發現「邏輯明明正確但效果不對」,請把「事件是否被觸發多次」列入首要懷疑名單,而不是急著逐行檢查業務邏輯。
在處理函式第一行打中斷點或 console.trace(),看呼叫堆疊有沒有出現兩次不同的來源。也可以在 Elements 面板的 Event Listeners 分頁中,選取該元素,直接看到掛了幾個監聽器、分別來自哪一行程式碼。
1. 初始化只做一次。把綁定事件的程式放在確定只會執行一次的進入點,別寫在每次渲染都會重跑的函式裡。
2. 用 onclick = fn 而非 addEventListener 時,重複指派不會累加。屬性指派是覆蓋式的,這既是它的缺點也是某種保護。
3. 用 AbortController 管理生命週期。這是現代最可靠的做法:
var controller = new AbortController();
el.addEventListener('click', handler, { signal: controller.signal });
// 需要解除時,一次全部取消
controller.abort();
4. 元件化框架中,記得在 cleanup 中移除監聽器。React 的 useEffect 要回傳清理函式,Vue 的 onUnmounted 要 off 掉,否則每次重新掛載都會再綁一次。
5. 如果非要用匿名函式,先複製一份參照。匿名函式無法被 removeEventListener 移除,這是很多人乾脆就不解除綁定的藉口,也正是重複累積的溫床。
6. 事件委派可以天然免疫。把監聽器掛在穩定的父容器上,父容器不重建,監聽器就不會重複。