適合:JavaScript 開發者、串接 API 的前端工程師
JavaScript 資料與字串排錯
陣列裡多了空位、數字變成 NaN、日期差一天、emoji 字數算錯?這些 bug 通常出在資料轉換的某一步。這個專題沿著資料進出程式的路線,帶你找出值是在哪裡變了樣。
陣列裡到底裝了什麼?
空位、空陣列、NaN 和超大陣列,都會讓搜尋和統計的結果出乎意料。
- 1. 分清空槽與 undefined
new Array(n).map() 為什麼沒執行?空槽與 Array.from 的初始化差別
new Array(n).map() 沒有建立預期項目,是因為空槽會被跳過。本文以可執行斷言區分空槽與 undefined,說明 Array.from 初始化、fill 共用參照與 delete 留洞,並加入二維陣列的尺寸驗證及逐格建立方法,讓表單列與矩陣格子各自擁有獨立狀態。
- 2. 補上非空清單的驗證
JavaScript every 空陣列為何是 true?非空清單與空槽驗證
JavaScript every 在空陣列會回傳 true,稀疏陣列的空槽也會被跳過。本文用可執行斷言拆開資料型別、至少一筆與逐項驗證,提供拒絕空槽的清單檢查函式,並說明 async callback 為何無法等待驗證,避免表單或 API 資料在沒有有效項目時仍被判定通過。
- 3. 用空陣列表達跳過項目
JavaScript flatMap 為什麼留下 undefined?跳過項目要回傳空陣列
JavaScript flatMap 會攤平一層陣列,回傳 undefined 仍會留下元素。本文用可執行斷言比較空陣列、null、空槽與巢狀陣列,示範保留 0 和 false 的資料轉換,並說明 async callback 為何得到 Promise,以及先等待再攤平的修正方式。
- 4. 處理篩選後的空陣列
JavaScript reduce 空陣列錯誤:初始值與 filter 後的資料契約
JavaScript reduce 在空陣列報錯,常出現在 filter 把資料全部移除之後。本文用可執行案例說明 initialValue、單筆資料不呼叫 callback、稀疏陣列與數字字串的差異,並區分總和可回傳零、平均值應回傳無資料,避免用 catch 掩蓋資料問題。
- 5. 選對 includes、indexOf 與 findIndex
indexOf 找不到 NaN?includes、空槽與索引 0 的判斷差別
JavaScript indexOf 找不到 NaN,直接放進 if 又會漏掉索引 0。本文用可執行斷言比較 includes、indexOf 與 findIndex 的選用,分辨陣列空槽、明確 undefined 和物件參照,並示範只查自有欄位的缺值定位方法,避免存在檢查與資料驗證互相混用。
- 6. 處理大陣列的最大值與空陣列
Math.max 大陣列出現 RangeError?改用迴圈並定義資料契約
JavaScript 用 Math.max(...values) 處理大陣列,可能因為把每個元素展開成函式參數而出現 RangeError。本文以可執行斷言示範逐項取最大值,明確處理空陣列、負數、NaN、Infinity、字串與空槽,並說明引擎參數上限為何不能拿固定筆數當通用保證。
排序、去重、分組結果怪怪的?
先想清楚用什麼比較、用什麼當 key,再選 Set、Map 或其他做法。
- 7. 檢查比較函式與次排序
JavaScript sort 排序不正確:比較函式別只回傳布林值
JavaScript sort 比較函式需要負值、零與正值,布林比較器與 toSorted 都無法代替正確契約。本文提供有限數值、同分唯一 ID 與 Intl.Collator 數字字串比較範例,檢查輸入順序、相等名稱的次排序、原陣列未變及淺複製邊界,區分識別碼與顯示名稱排序。
- 8. 依 ID 去重並保留順序
JavaScript Set 無法去除重複物件?依 ID 去重與保留順序
JavaScript 用 new Set 處理物件陣列,內容一樣的兩筆仍可能留下,因為比較的是物件身分。本文用可執行斷言示範依字串 ID 保留第一筆或最後一筆,確認輸出順序、缺少 ID 的拒絕方式與物件共用邊界,避免把去重誤當成資料合併或深複製。
- 9. 區分刪除結果與原陣列
JavaScript splice 回傳空陣列?分清刪除結果與原陣列
JavaScript splice 插入成功卻回傳空陣列,是因為回傳值代表被刪除的元素。本文用可執行斷言比較 splice、slice 與 toSpliced,檢查省略 deleteCount 和傳入 undefined 的差異,並提供先處理 findIndex 的 -1、找不到 ID 時保留原資料的刪除方法。
- 10. 決定分組結果要用 Object 還是 Map
Object.groupBy 分組排錯:hasOwnProperty、key 合併與 Map 選擇
Object.groupBy 分組後沒有 hasOwnProperty,或數字 key 改變顯示順序,先確認物件與 key 契約。本文以可執行斷言比較 Map 的首次出現順序、Object 的索引排序與共用參照,並用陣列保留 JSON 傳輸順序,避免轉回普通物件後再次重排分類。
- 11. 檢查深複製後的物件身分
structuredClone 深拷貝怎麼選:DataCloneError、class 與 transfer 限制
structuredClone 深拷貝後 Map 用原物件當 key 卻查不到,原因是副本建立了新的物件身分。本文新增同一物件圖與分開複製的對照測試,說明穩定 ID 的選擇,並保留 DataCloneError、getter、class、subarray 與 transfer 的檢查方法。
- 12. 確認巢狀設定是否真的凍結
Object.freeze 後巢狀物件還會變?設定凍結與資料所有權檢查
Object.freeze 只凍結傳入物件本身,巢狀設定、陣列元素與 Map 內容仍有不同邊界。本文用 Node.js 斷言檢查外層與內層的差異,示範已知結構的逐層凍結,並說明何時先複製資料,避免把共用參照凍結後影響其他呼叫端。
數字、null、日期轉一轉就變了?
parseInt、預設值和時區都有自己的規則,先弄懂再寫驗證。
- 13. 避免 map(parseInt) 的進位陷阱
map(parseInt) 為什麼出現 NaN?JavaScript 進位參數與整數驗證
JavaScript 把字串陣列交給 map(parseInt),第二個 index 會被當成 radix,造成 NaN 或意外的進位轉換。本文重現逐筆參數,比較明確指定十進位與 Number 的差異,再提供拒絕空字串、單位尾碼及不安全整數的檢查,避免把轉換成功誤認成輸入有效。
- 14. 分清 undefined 與 null 的預設值
JavaScript 解構預設值遇到 null 為什麼失效?分清欄位與參數預設
JavaScript 解構的預設值只在 undefined 時生效,API 回傳 null 不會自動替換,函式參數預設也無法接住 null。本文提供可執行的分層反例,示範保留 0 與 false、以 nullish 規則補值及拒絕錯誤欄位型別,避免用空物件掩蓋不合法回應。
- 15. 分開語系、時區與純日期
JavaScript 日期差一天?用 Intl.DateTimeFormat 分開語系與時區
JavaScript 日期差一天,先分清時間點與純日期,再以 Intl.DateTimeFormat 指定時區。本文補上 YYYY-MM-DD 嚴格驗證,拒絕不存在日期並保留原字串,涵蓋閏年、0099 年與不同 TZ 的測試,避免把生日轉成午夜時間後再次跨日。
- 16. 評估現在能不能改用 Temporal
JavaScript Temporal 可以直接用了嗎?新舊專案的導入判斷
Temporal 已在 Node.js 26、Chrome 144 與 Firefox 139 預設可用,Safari 則到 27.3 beta 才加入。本文依執行環境整理能否直接用、何時該搭配 polyfill,用可執行範例比較 Date 的日期位移、月底與夏令時間問題,並給新舊專案的導入建議。
API 資料和字串對不上?
網址、JSON、localStorage 和字串處理,都要確認轉換前後的值一致。
- 17. 確認相對網址的實際目的地
new URL() 為什麼吃掉 API 路徑?基底尾斜線與相對網址排錯
JavaScript new URL() 會解析相對網址,不是把兩段字串接起來。本文用可執行斷言比較基底尾斜線、開頭斜線、上一層與完整網址,說明 API 路徑為何消失,並提供送出請求前檢查 origin、pathname 和查詢參數的方法,避免只改字串卻沒有驗證實際目的地。
- 18. 保留重複的查詢參數
URLSearchParams 重複參數遺失:getAll 與物件轉換排錯
URLSearchParams 多選參數轉成物件只剩一值,或 C++、百分比字串解碼後變形,應分別檢查多值與編碼邊界。本文提供 getAll、局部更新網址及單次解碼測試,並檢查頁碼結尾換行與空白遭拒絕,保留既有 query 與 hash 的解析值。
- 19. 保留大整數 ID 精度
JSON 大整數 ID 變號:字串契約、BigInt 與解析精度檢查
JSON.parse 沒有報錯,API 的大整數 ID 卻可能已被 Number 捨入。本文用可執行測試重現兩個 ID 合併,說明字串契約、Number.isSafeInteger 的拒絕邊界,以及原始 JSON 搭配 reviver context.source 轉 BigInt 的條件與序列化限制。
- 20. 分清欄位省略、設定與清空
JSON.stringify 欄位不見了?undefined、null 與更新契約排錯
JavaScript 物件有欄位,JSON.stringify 後卻消失,先分清 undefined 在物件、陣列與根值的不同結果。本文提供可執行斷言與單欄更新函式,明確區分保留原值、設定新值和清空,拒絕不合法輸入,避免全域 replacer 悄悄改變 API 契約。
- 21. 讀取損壞或舊版的本機資料
localStorage JSON 讀寫失敗:安全 fallback 與版本檢查
localStorage 解析失敗後顯示 fallback,不代表可以自動回寫預設值。本文以狀態與原字串快照阻擋未知版本、損壞資料和已觀察到的過時寫入,附可執行替身測試,並保留 JSON 驗證、寫入錯誤及 storage 事件清理方法,說明跨分頁比較並非原子操作。
- 22. 排查重複 test 的游標狀態
RegExp test 一下 true 一下 false?檢查 g、y 與 lastIndex
同一個 JavaScript 正則表達式重複 test,結果卻交替 true 與 false,或 filter 漏掉相同資料,先檢查 g、y 與 lastIndex。本文提供跨字串重現、無狀態驗證及保留掃描游標的測試,區分搜尋、整欄驗證和 sticky 解析的不同契約。
- 23. 保留替換字串中的原始文字
JavaScript replaceAll 取代後文字變了?字串搜尋與 $ 替換排錯
JavaScript replace 只改第一個符合項目,改成 replaceAll 後,替換文字中的 $&、$$ 仍可能被展開。本文用可執行斷言分開檢查搜尋模式與替換規則,提供拒絕空搜尋字串、保留使用者原文的 helper,並釐清正則 g 旗標與 HTML 輸出的界線。
- 24. 正確計算 emoji 與組合字元
JavaScript emoji 字數怎麼算?Intl.Segmenter 計數與安全截斷
JavaScript 的 length 計算 UTF-16 code units,展開字串也只能分開 code points,家庭 emoji 和組合重音仍可能被拆開。本文以 Intl.Segmenter 實作字素計數與截斷,提供空字串、國旗、膚色與邊界斷言,並分清畫面字數、位元組和 API 限制。