適合:JavaScript 開發者、做前端互動與元件的工程師
JavaScript 非同步與事件排錯
畫面顯示舊資料、事件觸發兩次、Promise 的錯誤不知道跑去哪?非同步的 bug 最難重現。這個專題幫你替每件非同步工作定好開始、完成和收尾,問題就好抓多了。
非同步工作到底做完了沒?
迴圈裡的 await、部分失敗、收尾時的錯誤,選對 Promise 寫法就能確定結果。
- 1. 接住 async 迴圈的完成與例外
forEach async 為什麼沒等完?用 for...of 或 Promise.all 接住工作
在 forEach 的 async callback 裡使用 await,外層流程仍可能先回傳或顯示完成。本文用可控制順序的範例重現問題,分別驗證 for...of 的序列停止、map 搭配 Promise.all 的結果順序,並說明例外傳遞、並行上限與已啟動工作不會自動取消的界線。
- 2. 等待判斷結果後再篩選
async filter 為什麼全部保留?JavaScript 非同步篩選的兩種寫法
JavaScript filter 不會等待 async callback,回傳的 Promise 會被當成真值,連 false 都可能留下。本文用可執行範例重現問題,比較 for...of 循序篩選與 Promise.all 並行判定,並檢查保留順序、空陣列與拒絕行為,避免把查詢失敗誤判為不符合條件。
- 3. 保留成功結果並檢查錯誤
Promise.allSettled 怎麼用?多個 API 部分失敗時保留成功結果
Promise.allSettled 仍把錯誤列為 fulfilled,先檢查 catch 是否吞掉 rejection,或把 Error 當成正常值回傳。本文用可執行斷言區分記錄後重拋、明確 fallback 與部分成功結果,保留任務名稱驗證、並行限制及 HTTP 狀態的判讀方法。
- 4. 等待工作結束再清理資源
Promise.all 失敗後還在執行?等所有工作結束再清理資源
Promise.all 第一個失敗就會 reject,其他工作仍可能使用暫存檔或連線。本文以可控制完成順序的 Node.js 範例重現提早清理,提供等待全部 settled 與失敗後取消的 wrapper,驗證 abort 之後仍要等待 cleanup,並保留原始失敗原因及不支援取消的限制。
- 5. 驗證回應後再選最快結果
Promise.any 搶到錯誤回應?先驗證 HTTP 與 JSON 再選最快結果
Promise.any 只選第一個 fulfilled,HTTP 503 仍可能讓 fetch 成功回傳 Response。本文先驗證 HTTP、JSON 與資料形狀,再補上勝出後取消其他候選、等待清理才回傳的 helper,以可控制測試確認取消通知、清理等待與全部失敗的錯誤順序。
- 6. 保留工作與清理兩邊的錯誤
Promise finally 蓋掉原本錯誤?保留工作與清理失敗的原因
Promise finally 裡的清理若拋錯,回傳的新 Promise 會改以清理錯誤拒絕,原本工作失敗的原因就容易在呼叫端遺失。本文用可執行的 Node.js 範例比較四種成功失敗組合,透過 AggregateError 保留兩個原因,並測試 reject(undefined) 與清理回傳值。
- 7. 把一次性事件包成可取消的等待
Promise.withResolvers 怎麼用?把一次性事件轉成可取消的等待
Promise.withResolvers 可以把 promise、resolve 與 reject 一起取出,適合等待由外部事件完成的操作。本文用 EventTarget 範例示範如何在事件到達或 AbortSignal 中止時移除監聽器,並驗證已中止、重複事件與晚到事件的結果。
fetch 太慢、失敗或順序錯了?
請求逾時、回應不是 JSON、舊結果蓋掉新結果,各有對應的處理方式。
- 8. 取消超過等待時間的請求
fetch 逾時怎麼處理:用 AbortSignal.timeout() 取消慢請求
fetch 收到標頭後,JSON 本文仍可能逾時。本文用 AbortSignal 處理慢請求與第一個取消原因,新增可清除計時器及 listener 的 wrapper,附本機 HTTP 測試,檢查成功、慢本文、解析失敗與手動取消,避免 finally 提早移除逾時保護。
- 9. 排查空回應與 HTML 回應
fetch JSON 解析失敗:Unexpected token、空回應與 HTML 排錯
fetch JSON 解析失敗,先分清 HTTP、格式、空本文與串流讀取狀態。本文提供分層 helper 和可執行測試,補上 bodyUsed 為 false 仍被鎖定的情況、releaseLock 的恢復邊界及 clone 時機,避免把 TypeError 誤當成損壞 JSON。
- 10. 避免舊請求覆蓋新結果
搜尋結果被舊請求覆蓋?用 AbortController 與序號處理 fetch 競態
搜尋框加了 debounce,等待期間的舊 fetch 仍可能覆蓋畫面。本文用 AbortController 與序號保護成功、錯誤及 loading,補上每次輸入立即失效、延後送出、清空與卸載取消的完整實作,並以可控制計時器的 Node 測試重現舊回應晚到。
- 11. 為動態 import() 保留重試入口
JavaScript 動態 import() 失敗怎麼重試?Chrome 155 Beta 的模組載入邊界
動態 import() 加了有限重試,按鈕卻可能因 once 失去第二次操作機會。本文保留載入失敗後的入口、阻擋連點重複初始化,區分模組載入與 start 失敗,提供 Node 狀態測試,並交代 Chrome 155 Beta 與舊瀏覽器的快取限制。
抓不到元素、表單少欄位、事件重複觸發?
先確認選擇器、表單狀態,還有監聽器掛了幾次。
- 12. 選取含特殊字元的 ID
querySelector 找不到特殊 ID?用 CSS.escape 與 getElementById 分流
querySelector 遇到冒號、問號或數字開頭的 ID,可能拋出 SyntaxError,也可能選錯元素。本文分清 HTML id 與 CSS selector 語法,示範 getElementById、CSS.escape 和複合選擇器,附 HTML 案例,避免把 URL 編碼當成 selector 跳脫。
- 13. 找回 FormData 少掉的欄位
FormData 欄位不見了?檢查 disabled、name 與 submitter
FormData 少欄位或發布 intent 不見時,先查 name、disabled 與 submitter。本文提供表單快照與 requestSubmit 的瀏覽器檢查,區分指定按鈕、無參數送出及驗證失敗,並說明多值欄位、鎖定介面時點與 multipart boundary。
- 14. 用 AbortController 清理監聽器
addEventListener 重複觸發怎麼修?用 AbortController 管理事件生命週期
addEventListener 在元件重掛後重複觸發,先核對 callback 身分、capture 與掛載次數。本文用 AbortController 管理清理,補上再註冊 once 不會更新既有 listener 的可執行檢查,區分匿名函式累積、只執行一次與重新掛載。
- 15. 找出 wheel 擋不住捲動的原因
wheel 的 preventDefault 無效?檢查 passive 與 cancelable
wheel 事件明明有觸發,呼叫 preventDefault 後頁面卻照樣捲動,先分開檢查監聽器的 passive 選項和事件的 cancelable。本文提供可在 Chrome 跑的三組對照,並說明如何把可取消的監聽器限制在需要自訂滾輪行為的元件。
捲動載入一直重複?
Observer 被呼叫的次數比你想的多。先鎖住載入狀態,再處理尺寸互相影響的問題。
- 16. 避免無限捲動重複請求
IntersectionObserver 無限捲動重複請求?先鎖定載入與分頁狀態
IntersectionObserver callback 不只在手動捲動時執行,也可能帶入多筆 entry。本文用可測試的分頁載入器處理重複通知、失敗重試、cursor 不前進與卸載取消,並保留載入更多按鈕,避免無限捲動把 API 叫出重複資料。
- 17. 找出 ResizeObserver 的尺寸回授
ResizeObserver loop 錯誤怎麼修?先找尺寸回授,不要只隱藏訊息
ResizeObserver loop 錯誤可能來自 callback 改動被觀察元素的尺寸。本文用 Chrome 對照兩組尺寸序列,說明 requestAnimationFrame 何時仍會持續回授,並提供固定目標、清理觀察器與驗收步驟。