Stage 01

非同步工作到底做完了沒?

迴圈裡的 await、部分失敗、收尾時的錯誤,選對 Promise 寫法就能確定結果。

  1. 1. 接住 async 迴圈的完成與例外

    forEach async 為什麼沒等完?用 for...of 或 Promise.all 接住工作

    在 forEach 的 async callback 裡使用 await,外層流程仍可能先回傳或顯示完成。本文用可控制順序的範例重現問題,分別驗證 for...of 的序列停止、map 搭配 Promise.all 的結果順序,並說明例外傳遞、並行上限與已啟動工作不會自動取消的界線。

  2. 2. 等待判斷結果後再篩選

    async filter 為什麼全部保留?JavaScript 非同步篩選的兩種寫法

    JavaScript filter 不會等待 async callback,回傳的 Promise 會被當成真值,連 false 都可能留下。本文用可執行範例重現問題,比較 for...of 循序篩選與 Promise.all 並行判定,並檢查保留順序、空陣列與拒絕行為,避免把查詢失敗誤判為不符合條件。

  3. 3. 保留成功結果並檢查錯誤

    Promise.allSettled 怎麼用?多個 API 部分失敗時保留成功結果

    Promise.allSettled 仍把錯誤列為 fulfilled,先檢查 catch 是否吞掉 rejection,或把 Error 當成正常值回傳。本文用可執行斷言區分記錄後重拋、明確 fallback 與部分成功結果,保留任務名稱驗證、並行限制及 HTTP 狀態的判讀方法。

  4. 4. 等待工作結束再清理資源

    Promise.all 失敗後還在執行?等所有工作結束再清理資源

    Promise.all 第一個失敗就會 reject,其他工作仍可能使用暫存檔或連線。本文以可控制完成順序的 Node.js 範例重現提早清理,提供等待全部 settled 與失敗後取消的 wrapper,驗證 abort 之後仍要等待 cleanup,並保留原始失敗原因及不支援取消的限制。

  5. 5. 驗證回應後再選最快結果

    Promise.any 搶到錯誤回應?先驗證 HTTP 與 JSON 再選最快結果

    Promise.any 只選第一個 fulfilled,HTTP 503 仍可能讓 fetch 成功回傳 Response。本文先驗證 HTTP、JSON 與資料形狀,再補上勝出後取消其他候選、等待清理才回傳的 helper,以可控制測試確認取消通知、清理等待與全部失敗的錯誤順序。

  6. 6. 保留工作與清理兩邊的錯誤

    Promise finally 蓋掉原本錯誤?保留工作與清理失敗的原因

    Promise finally 裡的清理若拋錯,回傳的新 Promise 會改以清理錯誤拒絕,原本工作失敗的原因就容易在呼叫端遺失。本文用可執行的 Node.js 範例比較四種成功失敗組合,透過 AggregateError 保留兩個原因,並測試 reject(undefined) 與清理回傳值。

  7. 7. 把一次性事件包成可取消的等待

    Promise.withResolvers 怎麼用?把一次性事件轉成可取消的等待

    Promise.withResolvers 可以把 promise、resolve 與 reject 一起取出,適合等待由外部事件完成的操作。本文用 EventTarget 範例示範如何在事件到達或 AbortSignal 中止時移除監聽器,並驗證已中止、重複事件與晚到事件的結果。

Stage 02

fetch 太慢、失敗或順序錯了?

請求逾時、回應不是 JSON、舊結果蓋掉新結果,各有對應的處理方式。

  1. 8. 取消超過等待時間的請求

    fetch 逾時怎麼處理:用 AbortSignal.timeout() 取消慢請求

    fetch 收到標頭後,JSON 本文仍可能逾時。本文用 AbortSignal 處理慢請求與第一個取消原因,新增可清除計時器及 listener 的 wrapper,附本機 HTTP 測試,檢查成功、慢本文、解析失敗與手動取消,避免 finally 提早移除逾時保護。

  2. 9. 排查空回應與 HTML 回應

    fetch JSON 解析失敗:Unexpected token、空回應與 HTML 排錯

    fetch JSON 解析失敗,先分清 HTTP、格式、空本文與串流讀取狀態。本文提供分層 helper 和可執行測試,補上 bodyUsed 為 false 仍被鎖定的情況、releaseLock 的恢復邊界及 clone 時機,避免把 TypeError 誤當成損壞 JSON。

  3. 10. 避免舊請求覆蓋新結果

    搜尋結果被舊請求覆蓋?用 AbortController 與序號處理 fetch 競態

    搜尋框加了 debounce,等待期間的舊 fetch 仍可能覆蓋畫面。本文用 AbortController 與序號保護成功、錯誤及 loading,補上每次輸入立即失效、延後送出、清空與卸載取消的完整實作,並以可控制計時器的 Node 測試重現舊回應晚到。

  4. 11. 為動態 import() 保留重試入口

    JavaScript 動態 import() 失敗怎麼重試?Chrome 155 Beta 的模組載入邊界

    動態 import() 加了有限重試,按鈕卻可能因 once 失去第二次操作機會。本文保留載入失敗後的入口、阻擋連點重複初始化,區分模組載入與 start 失敗,提供 Node 狀態測試,並交代 Chrome 155 Beta 與舊瀏覽器的快取限制。

Stage 03

抓不到元素、表單少欄位、事件重複觸發?

先確認選擇器、表單狀態,還有監聽器掛了幾次。

  1. 12. 選取含特殊字元的 ID

    querySelector 找不到特殊 ID?用 CSS.escape 與 getElementById 分流

    querySelector 遇到冒號、問號或數字開頭的 ID,可能拋出 SyntaxError,也可能選錯元素。本文分清 HTML id 與 CSS selector 語法,示範 getElementById、CSS.escape 和複合選擇器,附 HTML 案例,避免把 URL 編碼當成 selector 跳脫。

  2. 13. 找回 FormData 少掉的欄位

    FormData 欄位不見了?檢查 disabled、name 與 submitter

    FormData 少欄位或發布 intent 不見時,先查 name、disabled 與 submitter。本文提供表單快照與 requestSubmit 的瀏覽器檢查,區分指定按鈕、無參數送出及驗證失敗,並說明多值欄位、鎖定介面時點與 multipart boundary。

  3. 14. 用 AbortController 清理監聽器

    addEventListener 重複觸發怎麼修?用 AbortController 管理事件生命週期

    addEventListener 在元件重掛後重複觸發,先核對 callback 身分、capture 與掛載次數。本文用 AbortController 管理清理,補上再註冊 once 不會更新既有 listener 的可執行檢查,區分匿名函式累積、只執行一次與重新掛載。

  4. 15. 找出 wheel 擋不住捲動的原因

    wheel 的 preventDefault 無效?檢查 passive 與 cancelable

    wheel 事件明明有觸發,呼叫 preventDefault 後頁面卻照樣捲動,先分開檢查監聽器的 passive 選項和事件的 cancelable。本文提供可在 Chrome 跑的三組對照,並說明如何把可取消的監聽器限制在需要自訂滾輪行為的元件。

Stage 04

捲動載入一直重複?

Observer 被呼叫的次數比你想的多。先鎖住載入狀態,再處理尺寸互相影響的問題。

  1. 16. 避免無限捲動重複請求

    IntersectionObserver 無限捲動重複請求?先鎖定載入與分頁狀態

    IntersectionObserver callback 不只在手動捲動時執行,也可能帶入多筆 entry。本文用可測試的分頁載入器處理重複通知、失敗重試、cursor 不前進與卸載取消,並保留載入更多按鈕,避免無限捲動把 API 叫出重複資料。

  2. 17. 找出 ResizeObserver 的尺寸回授

    ResizeObserver loop 錯誤怎麼修?先找尺寸回授,不要只隱藏訊息

    ResizeObserver loop 錯誤可能來自 callback 改動被觀察元素的尺寸。本文用 Chrome 對照兩組尺寸序列,說明 requestAnimationFrame 何時仍會持續回授,並提供固定目標、清理觀察器與驗收步驟。