parseInt(string, radix) 是 JS 將字串轉整數的核心函數,但其「進制自動推斷」與「非數字字元截斷」行為常造成難以察覺的 Bug。本文系統整理規則、陷阱與最佳實踐。
parseInt(string, radix)
// string: 要解析的字串,前導空白會被忽略
// radix: 基數(進制),2~36。省略時觸發自動推斷
| 字串開頭 | 推斷進制 | 範例結果 |
|---|---|---|
0x 或 0X | 16 進制 | parseInt('0x10') === 16 |
0 後接 0-7(ES5 非嚴格模式) | 8 進制 | parseInt('010') === 8 ⚠️ |
| 其他數字開頭 | 10 進制 | parseInt('10') === 10 |
| 非數字開頭 | NaN | parseInt('abc') === NaN |
重大變更:ES5 嚴格模式("use strict")及 ES6+ 移除八進制自動推斷,'010' 視為十進制 10。為避免環境差異,**永遠顯式傳入 radix**。
parseInt('100px') // 100 (停在 'p')
parseInt('12.34') // 12 (停在 '.')
parseInt('0xFF') // 255 (16進制完整解析)
parseInt('0xGG') // 0 (G 非 16進制字元,停在 '0x' -> 0)
parseInt(' 42 ') // 42 (自動 trim 空白)
parseInt('') // NaN
parseInt('abc') // NaN
parseInt('09') === 0(非嚴格模式下)因 09 被視為八進制,但 9 非八進制合法字元,解析停在 0。
.map(parseInt) 陷阱['1','2','3'].map(parseInt)
// parseInt('1', 0) -> 1
// parseInt('2', 1) -> NaN (radix 1 非法)
// parseInt('3', 2) -> NaN (3 非二進制)
// 結果:[1, NaN, NaN]
// 正確寫法
['1','2','3'].map(x => parseInt(x, 10));
// 或
['1','2','3'].map(Number); // 只需十進制時
parseInt('1e3') // 1 (停在 'e')
parseInt('999999999999999999999') // 999999999999999900000 (精度失真,超過 Number.MAX_SAFE_INTEGER)
parseInt(str, 10)。Number(str) 或 +str,行為更直觀(不截斷、支援科學記號、小數)。Math.floor()、Math.trunc()(ES6)。BigInt:BigInt('999999999999999999999')。Number.isInteger(Number(str)) 判斷是否為純整數字串。// 環境:ES6+ 嚴格模式
parseInt('10', 10) // 10
parseInt('010', 10) // 10 (不再視為八進制)
parseInt('010', 8) // 8
parseInt('0x10', 16) // 16
parseInt('10', 2) // 2
parseInt('abc', 10) // NaN
parseInt('10px', 10) // 10
Number('10px') // NaN (Number 不截斷)
+'10px' // NaN