parseInt() 的作用是把字串轉成整數,這點大多數人都知道。但很多人從來只帶一個參數使用,於是遇到類似 parseInt("08") 的結果不如預期時就一頭霧水。問題的根源在於它的第二個參數:基數(radix)。
省略第二個參數時,引擎會依字串開頭的形式來猜測進位制:
0x 或 0X 開頭,視為十六進位。0 開頭(例如 "012"),在舊的 ECMAScript 3 環境中會被視為八進位。正是第二條規則造成了長期的困擾。在使用舊引擎的時代,parseInt("08") 會因為「8 不是合法的八進位數字」而只解析出 0;而 parseInt("012") 則被當成八進位,得到十進位的 10。這是當年無數 bug 的來源。
值得補充的是,ECMAScript 5 已經取消了「前導 0 代表八進位」的假設,因此在現代瀏覽器與 Node.js 中,parseInt("08") 與 parseInt("012") 都會得到 8 與 12。也就是說,這個經典陷阱今日已不復見,但明確帶上基數仍是必须坚持的好習慣——各項 lint 規則也普遍會對省略 radix 發出警告。
寫成 parseInt(字串, 基數) 之後,就不必再猜:
parseInt("12", 8); // 把八進位的 12 轉成十進位
parseInt("78", 10); // 明確指定十進位
parseInt("012", 10); // 強制以十進位解析,前導 0 不影響結果
parseInt("12", 8); // 10 → 1×8 + 2×1
parseInt("012"); // 12 → ES5 之後按十進位解析(ES3 為 10)
parseInt("012", 8); // 10
parseInt("012", 10); // 12
parseInt("78", 8); // 7 → 遇到非法的 8 就停止,只解析 7
parseInt("08", 8); // 0 → 首位 0 合法,第二位 8 不合法
parseInt("08", 10); // 8
parseInt("08"); // 8 → ES5 之後為 8(ES3 為 0)
parseInt("8", 8); // NaN → 第一位就超出範圍
parseInt("0x12"); // 18 → 偵測到 0x 前綴,按十六進位解析
從這些例子可以歸納出兩個關鍵行為:
第一,parseInt 是「逐字解析、遇到非法字元就停」,而不是「驗證整個字串」。所以 parseInt("78", 8) 不會回傳 NaN,而是回傳 7;parseInt("123abc", 10) 也會得到 123。
第二,前綴的優先級高於預設值。0x 開頭的字串即使不寫基數也會被當成十六進位。
需要把使用者輸入轉成數字時,建議依情境選擇更合適的工具:整數用 parseInt(value, 10),小數用 Number() 或 parseFloat(),需要嚴格驗證整串是否為數字時,Number() 反而更安全,因為它不會像 parseInt 那樣把 "12px" 靜靜轉成 12。養成「永遠寫出基數」的習慣,能省下不少排查時間。