萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript parseInt 函數完整解析:進制自動判斷、字串截斷與常見坑點

前言

parseInt(string, radix) 是 JS 將字串轉整數的核心函數,但其「進制自動推斷」與「非數字字元截斷」行為常造成難以察覺的 Bug。本文系統整理規則、陷阱與最佳實踐。

語法與參數

parseInt(string, radix)
// string: 要解析的字串,前導空白會被忽略
// radix:  基數(進制),2~36。省略時觸發自動推斷

進制自動推斷規則(省略 radix 時)

字串開頭推斷進制範例結果
0x 或 0X16 進制parseInt('0x10') === 16
0 後接 0-7(ES5 非嚴格模式)8 進制parseInt('010') === 8 ⚠️
其他數字開頭10 進制parseInt('10') === 10
非數字開頭NaNparseInt('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

經典坑點案例

1. parseInt('09') === 0(非嚴格模式下)

因 09 被視為八進制,但 9 非八進制合法字元,解析停在 0。

2. 陣列 .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); // 只需十進制時

3. 科學記號與大數

parseInt('1e3')     // 1 (停在 'e')
parseInt('999999999999999999999') // 999999999999999900000 (精度失真,超過 Number.MAX_SAFE_INTEGER)

最佳實踐

  1. 永遠顯式指定 radix:parseInt(str, 10)。
  2. 單純轉數字優先用 Number(str) 或 +str,行為更直觀(不截斷、支援科學記號、小數)。
  3. 需「取整數」用 Math.floor()、Math.trunc()(ES6)。
  4. 大整數場景改用 BigInt:BigInt('999999999999999999999')。
  5. 輸入驗證: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
copyright © 萬盛學電腦網 all rights reserved