Stage 01

陣列裡到底裝了什麼?

空位、空陣列、NaN 和超大陣列,都會讓搜尋和統計的結果出乎意料。

  1. 1. 分清空槽與 undefined

    new Array(n).map() 為什麼沒執行?空槽與 Array.from 的初始化差別

    new Array(n).map() 沒有建立預期項目,是因為空槽會被跳過。本文以可執行斷言區分空槽與 undefined,說明 Array.from 初始化、fill 共用參照與 delete 留洞,並加入二維陣列的尺寸驗證及逐格建立方法,讓表單列與矩陣格子各自擁有獨立狀態。

  2. 2. 補上非空清單的驗證

    JavaScript every 空陣列為何是 true?非空清單與空槽驗證

    JavaScript every 在空陣列會回傳 true,稀疏陣列的空槽也會被跳過。本文用可執行斷言拆開資料型別、至少一筆與逐項驗證,提供拒絕空槽的清單檢查函式,並說明 async callback 為何無法等待驗證,避免表單或 API 資料在沒有有效項目時仍被判定通過。

  3. 3. 用空陣列表達跳過項目

    JavaScript flatMap 為什麼留下 undefined?跳過項目要回傳空陣列

    JavaScript flatMap 會攤平一層陣列,回傳 undefined 仍會留下元素。本文用可執行斷言比較空陣列、null、空槽與巢狀陣列,示範保留 0 和 false 的資料轉換,並說明 async callback 為何得到 Promise,以及先等待再攤平的修正方式。

  4. 4. 處理篩選後的空陣列

    JavaScript reduce 空陣列錯誤:初始值與 filter 後的資料契約

    JavaScript reduce 在空陣列報錯,常出現在 filter 把資料全部移除之後。本文用可執行案例說明 initialValue、單筆資料不呼叫 callback、稀疏陣列與數字字串的差異,並區分總和可回傳零、平均值應回傳無資料,避免用 catch 掩蓋資料問題。

  5. 5. 選對 includes、indexOf 與 findIndex

    indexOf 找不到 NaN?includes、空槽與索引 0 的判斷差別

    JavaScript indexOf 找不到 NaN,直接放進 if 又會漏掉索引 0。本文用可執行斷言比較 includes、indexOf 與 findIndex 的選用,分辨陣列空槽、明確 undefined 和物件參照,並示範只查自有欄位的缺值定位方法,避免存在檢查與資料驗證互相混用。

  6. 6. 處理大陣列的最大值與空陣列

    Math.max 大陣列出現 RangeError?改用迴圈並定義資料契約

    JavaScript 用 Math.max(...values) 處理大陣列,可能因為把每個元素展開成函式參數而出現 RangeError。本文以可執行斷言示範逐項取最大值,明確處理空陣列、負數、NaN、Infinity、字串與空槽,並說明引擎參數上限為何不能拿固定筆數當通用保證。

Stage 02

排序、去重、分組結果怪怪的?

先想清楚用什麼比較、用什麼當 key,再選 Set、Map 或其他做法。

  1. 7. 檢查比較函式與次排序

    JavaScript sort 排序不正確:比較函式別只回傳布林值

    JavaScript sort 比較函式需要負值、零與正值,布林比較器與 toSorted 都無法代替正確契約。本文提供有限數值、同分唯一 ID 與 Intl.Collator 數字字串比較範例,檢查輸入順序、相等名稱的次排序、原陣列未變及淺複製邊界,區分識別碼與顯示名稱排序。

  2. 8. 依 ID 去重並保留順序

    JavaScript Set 無法去除重複物件?依 ID 去重與保留順序

    JavaScript 用 new Set 處理物件陣列,內容一樣的兩筆仍可能留下,因為比較的是物件身分。本文用可執行斷言示範依字串 ID 保留第一筆或最後一筆,確認輸出順序、缺少 ID 的拒絕方式與物件共用邊界,避免把去重誤當成資料合併或深複製。

  3. 9. 區分刪除結果與原陣列

    JavaScript splice 回傳空陣列?分清刪除結果與原陣列

    JavaScript splice 插入成功卻回傳空陣列,是因為回傳值代表被刪除的元素。本文用可執行斷言比較 splice、slice 與 toSpliced,檢查省略 deleteCount 和傳入 undefined 的差異,並提供先處理 findIndex 的 -1、找不到 ID 時保留原資料的刪除方法。

  4. 10. 決定分組結果要用 Object 還是 Map

    Object.groupBy 分組排錯:hasOwnProperty、key 合併與 Map 選擇

    Object.groupBy 分組後沒有 hasOwnProperty,或數字 key 改變顯示順序,先確認物件與 key 契約。本文以可執行斷言比較 Map 的首次出現順序、Object 的索引排序與共用參照,並用陣列保留 JSON 傳輸順序,避免轉回普通物件後再次重排分類。

  5. 11. 檢查深複製後的物件身分

    structuredClone 深拷貝怎麼選:DataCloneError、class 與 transfer 限制

    structuredClone 深拷貝後 Map 用原物件當 key 卻查不到,原因是副本建立了新的物件身分。本文新增同一物件圖與分開複製的對照測試,說明穩定 ID 的選擇,並保留 DataCloneError、getter、class、subarray 與 transfer 的檢查方法。

  6. 12. 確認巢狀設定是否真的凍結

    Object.freeze 後巢狀物件還會變?設定凍結與資料所有權檢查

    Object.freeze 只凍結傳入物件本身,巢狀設定、陣列元素與 Map 內容仍有不同邊界。本文用 Node.js 斷言檢查外層與內層的差異,示範已知結構的逐層凍結,並說明何時先複製資料,避免把共用參照凍結後影響其他呼叫端。

Stage 03

數字、null、日期轉一轉就變了?

parseInt、預設值和時區都有自己的規則,先弄懂再寫驗證。

  1. 13. 避免 map(parseInt) 的進位陷阱

    map(parseInt) 為什麼出現 NaN?JavaScript 進位參數與整數驗證

    JavaScript 把字串陣列交給 map(parseInt),第二個 index 會被當成 radix,造成 NaN 或意外的進位轉換。本文重現逐筆參數,比較明確指定十進位與 Number 的差異,再提供拒絕空字串、單位尾碼及不安全整數的檢查,避免把轉換成功誤認成輸入有效。

  2. 14. 分清 undefined 與 null 的預設值

    JavaScript 解構預設值遇到 null 為什麼失效?分清欄位與參數預設

    JavaScript 解構的預設值只在 undefined 時生效,API 回傳 null 不會自動替換,函式參數預設也無法接住 null。本文提供可執行的分層反例,示範保留 0 與 false、以 nullish 規則補值及拒絕錯誤欄位型別,避免用空物件掩蓋不合法回應。

  3. 15. 分開語系、時區與純日期

    JavaScript 日期差一天?用 Intl.DateTimeFormat 分開語系與時區

    JavaScript 日期差一天,先分清時間點與純日期,再以 Intl.DateTimeFormat 指定時區。本文補上 YYYY-MM-DD 嚴格驗證,拒絕不存在日期並保留原字串,涵蓋閏年、0099 年與不同 TZ 的測試,避免把生日轉成午夜時間後再次跨日。

  4. 16. 評估現在能不能改用 Temporal

    JavaScript Temporal 可以直接用了嗎?新舊專案的導入判斷

    Temporal 已在 Node.js 26、Chrome 144 與 Firefox 139 預設可用,Safari 則到 27.3 beta 才加入。本文依執行環境整理能否直接用、何時該搭配 polyfill,用可執行範例比較 Date 的日期位移、月底與夏令時間問題,並給新舊專案的導入建議。

Stage 04

API 資料和字串對不上?

網址、JSON、localStorage 和字串處理,都要確認轉換前後的值一致。

  1. 17. 確認相對網址的實際目的地

    new URL() 為什麼吃掉 API 路徑?基底尾斜線與相對網址排錯

    JavaScript new URL() 會解析相對網址,不是把兩段字串接起來。本文用可執行斷言比較基底尾斜線、開頭斜線、上一層與完整網址,說明 API 路徑為何消失,並提供送出請求前檢查 origin、pathname 和查詢參數的方法,避免只改字串卻沒有驗證實際目的地。

  2. 18. 保留重複的查詢參數

    URLSearchParams 重複參數遺失:getAll 與物件轉換排錯

    URLSearchParams 多選參數轉成物件只剩一值,或 C++、百分比字串解碼後變形,應分別檢查多值與編碼邊界。本文提供 getAll、局部更新網址及單次解碼測試,並檢查頁碼結尾換行與空白遭拒絕,保留既有 query 與 hash 的解析值。

  3. 19. 保留大整數 ID 精度

    JSON 大整數 ID 變號:字串契約、BigInt 與解析精度檢查

    JSON.parse 沒有報錯,API 的大整數 ID 卻可能已被 Number 捨入。本文用可執行測試重現兩個 ID 合併,說明字串契約、Number.isSafeInteger 的拒絕邊界,以及原始 JSON 搭配 reviver context.source 轉 BigInt 的條件與序列化限制。

  4. 20. 分清欄位省略、設定與清空

    JSON.stringify 欄位不見了?undefined、null 與更新契約排錯

    JavaScript 物件有欄位,JSON.stringify 後卻消失,先分清 undefined 在物件、陣列與根值的不同結果。本文提供可執行斷言與單欄更新函式,明確區分保留原值、設定新值和清空,拒絕不合法輸入,避免全域 replacer 悄悄改變 API 契約。

  5. 21. 讀取損壞或舊版的本機資料

    localStorage JSON 讀寫失敗:安全 fallback 與版本檢查

    localStorage 解析失敗後顯示 fallback,不代表可以自動回寫預設值。本文以狀態與原字串快照阻擋未知版本、損壞資料和已觀察到的過時寫入,附可執行替身測試,並保留 JSON 驗證、寫入錯誤及 storage 事件清理方法,說明跨分頁比較並非原子操作。

  6. 22. 排查重複 test 的游標狀態

    RegExp test 一下 true 一下 false?檢查 g、y 與 lastIndex

    同一個 JavaScript 正則表達式重複 test,結果卻交替 true 與 false,或 filter 漏掉相同資料,先檢查 g、y 與 lastIndex。本文提供跨字串重現、無狀態驗證及保留掃描游標的測試,區分搜尋、整欄驗證和 sticky 解析的不同契約。

  7. 23. 保留替換字串中的原始文字

    JavaScript replaceAll 取代後文字變了?字串搜尋與 $ 替換排錯

    JavaScript replace 只改第一個符合項目,改成 replaceAll 後,替換文字中的 $&、$$ 仍可能被展開。本文用可執行斷言分開檢查搜尋模式與替換規則,提供拒絕空搜尋字串、保留使用者原文的 helper,並釐清正則 g 旗標與 HTML 輸出的界線。

  8. 24. 正確計算 emoji 與組合字元

    JavaScript emoji 字數怎麼算?Intl.Segmenter 計數與安全截斷

    JavaScript 的 length 計算 UTF-16 code units,展開字串也只能分開 code points,家庭 emoji 和組合重音仍可能被拆開。本文以 Intl.Segmenter 實作字素計數與截斷,提供空字串、國旗、膚色與邊界斷言,並分清畫面字數、位元組和 API 限制。