開啟預覽,關閉,再開啟。下一次更新觸發了兩次回呼。重新啟動應用程式後恢復正常,但重複這組操作,問題又會出現。先別急著修改事件發送端,看看第一次開啟的預覽留下了什麼。
假設多個預覽共用一個事件匯流排,匯流排比單次預覽存活得更久。用一個小型 Node.js 範例就能模擬開啟與關閉,不需要繪製視窗。要查清的是:每一步結束後,還剩哪些訂閱。
在一次重新開啟前後數清訂閱
重新開啟後只發送一次 change,同時記錄監聽器數量與收到更新的檢視:
| 步驟 | 錯誤實作的監聽器數 | 修正後的監聽器數 |
|---|---|---|
| 開啟前 | 0 | 0 |
| 開啟第一個檢視 | 1 | 1 |
| 關閉第一個檢視 | 1 | 0 |
| 開啟第二個檢視 | 2 | 1 |
| 發送一次事件 | 第一、第二個檢視都收到 | 只有第二個檢視收到 |
最早出錯的是關閉第一個檢視的步驟。它的訂閱原本應在這裡消失。只盯著更新處理函式,會錯過更早發生的問題。
範例用 listenerCount('change') 讀取數量,emit 同步呼叫回呼。不需要計時器,也不需要連續點擊,就能重現重複傳遞。
追蹤函式參照,而非函式外觀
下面的掛載函式有缺陷。它回傳一個函式,呼叫端應在檢視關閉時執行:
export function mountUnsafeView(bus, publish) {
bus.on('change', (value) => publish(value));
return () => bus.off('change', (value) => publish(value));
}
傳給 on 與傳給 off 的箭頭函式長得一樣,但兩個運算式分別建立了新的函式物件。清理時找的是新物件,原本的訂閱還留在匯流排上。第一個回呼也仍能存取第一次傳入的發布函式。
Node 把 off 定義為 removeListener 的別名,後者移除指定監聽器。這裡應核對 Events API 文件。在這個 EventEmitter 範例中,事件名稱與回呼函式內容相同還不夠,清理時必須拿到註冊時的函式參照。
每次掛載回傳自己的清理函式
把回呼保存一次,讓清理閉包持有同一個參照:
export function mountView(bus, publish) {
const onChange = (value) => publish(value);
bus.on('change', onChange);
let disposed = false;
return function dispose() {
if (disposed) return;
disposed = true;
bus.off('change', onChange);
};
}
每次掛載都建立獨立的 onChange。回傳的 dispose 移除這次掛載的訂閱,後續重複呼叫直接返回。旗標明確定義重複清理的行為,獨立回呼參照則區分不同掛載。
即使兩個檢視收到相同的 publish 函式,各自的包裝函式也讓訂閱保持獨立。如果兩個檢視都把 publish 直接傳給 on,同一個函式會註冊兩次,一次 off 只移除其中一份,最後一個重現測試示範了這種情況。回傳的清理函式要由建立它的檢視保存;如果關閉前被丟棄或覆寫,修正後的函式也不會自己取消訂閱。
讓其他訂閱者在場,再測清理
關閉空匯流排上的檢視後,檢查監聽器數為零,很有用,但還不夠。如果改成呼叫 removeAllListeners,這項測試也會通過,卻會讓共用匯流排的其他訂閱者一起失去更新。
因此,範例先註冊一個獨立觀察者,再開啟舊檢視、關閉舊檢視、開啟新檢視,並再次呼叫舊檢視的清理函式。接著發送更新,檢查究竟是誰收到:
| 檢查時機 | 預期結果 |
|---|---|
| 再次清理舊檢視後發送更新 | 觀察者與新檢視收到 |
| 新檢視連續關閉兩次後發送更新 | 只有觀察者收到 |
| 兩個檢視共用發布函式,關閉其中一個 | 另一個仍收到更新 |
| 連續開啟、關閉三輪 | 每次開啟時收到一次,關閉後不再收到 |
這些斷言同時檢查數量與實際接收者。只看到還剩一個監聽器,無法分辨它是觀察者還是不該存活的舊檢視。在新檢視掛載後再呼叫舊 dispose,也能發現清理函式錯誤存取共用可變狀態的問題。
沿真實呼叫端讀到退出路徑
閱讀陌生程式碼時,也按這個順序走:
- 找到事件匯流排的建立位置,確認它是否跨導覽存活,還是只屬於一個檢視。
- 找到每個訂閱位置,檢查開啟、繪製、重新連線各自會走到這裡多少次。
- 從註冊追到移除,核對完整的回呼參照。
- 找到
mountView的呼叫端,看它把回傳函式存在哪裡。 - 沿相關退出路徑找到
dispose的呼叫,包括替換檢視與初始化失敗的路徑。
在每個註冊點旁記下由哪個物件保存訂閱、何時清理。「有清理函式卻沒有呼叫」與「呼叫時傳錯參照」,需要不同的修法。如果回呼還啟動非同步工作,要繼續追下去:移除訂閱不會撤銷已開始的操作。追蹤非同步介面狀態討論接下來這一步。
執行範例,確認適用範圍
下載 event-listener-lifecycle.mjs,用 Node.js 22 或更新版本執行:
node --test event-listener-lifecycle.mjs
五個測試全部通過。兩個名稱帶 reproduce: 的測試刻意斷言錯誤結果:重新開啟後仍有舊訂閱,以及同一回呼註冊兩次、移除一次後仍有訂閱。其餘三個檢查清理、重複呼叫與獨立訂閱者。不需要相依套件或計時器。
這個練習用 EventEmitter 模擬檢視生命週期,沒有實作瀏覽器,也不保證 DOM EventTarget 行為完全相同。每次掛載只註冊一次,清理發生在兩次事件發送之間。事件發送過程中移除、框架副作用機制,以及取消已開始的工作,都要按實際 API 另外檢查。
在 Yenpo 裡,可以先同時開啟入口檔案與清理檔案,沿兩處保存的回呼參照繼續讀。