函數簽名
parseInt(string, radix)
// string: 要解析的字符串
// radix: 進制基數(2-36),默認 10
// 返回:解析後的整數,無法解析返回 NaN
進制自動檢測規則(無 radix 時)
| 字符串開頭 | 推斷進制 | 示例 | 結果 |
0x 或 0X | 16 進制 | parseInt("0x10") | 16 |
0(後跟數字) | ES5: 8 進制 ES6+: 10 進制 | parseInt("010") | ES5: 8, ES6+: 10 |
| 其他數字 | 10 進制 | parseInt("10") | 10 |
經典陷阱案例
// 1. "09" 在 ES5 下視為八進制,9 非法 → 解析為 0
parseInt("09"); // ES5: 0, ES6+: 9
// 2. 非數字字符導致截斷
parseInt("100px"); // 100 (停在 p)
parseInt("12.34"); // 12 (停在 .)
parseInt("abc"); // NaN
// 3. 科學計數法
parseInt("1e3"); // 1 (停在 e)
parseInt("0x1e3"); // 483 (16進制完整解析)
// 4. 空白字符
parseInt(" 123 "); // 123 (自動 trim)
// 5. null/undefined/對象
parseInt(null); // NaN (先轉 "null")
parseInt({}); // NaN (先轉 "[object Object]")
ES5 vs ES6 行為差異
// ES5 (舊瀏覽器、舊標準)
parseInt("010") === 8 // 八進制
parseInt("09") === 0 // 八進制中 9 非法
// ES6+ (現代標準,所有現代瀏覽器)
parseInt("010") === 10 // 十進制
parseInt("09") === 9 // 十進制
// 建議:永遠顯式指定 radix
parseInt("010", 10) === 10 // 明確十進制,無歧義
實用工具函數封裝
/**
* 安全解析整數
* @param {String|Number} val - 輸入值
* @param {Number} radix - 進制 (默認 10)
* @param {Number} defaultVal - 解析失敗默認值
* @returns {Number}
*/
function parseIntSafe(val, radix = 10, defaultVal = 0) {
if (val === null || val === undefined) return defaultVal;
const num = parseInt(String(val).trim(), radix);
return isNaN(num) ? defaultVal : num;
}
/**
* 解析像素值 "100px" -> 100
*/
function parsePx(val, defaultVal = 0) {
if (val === null || val === undefined) return defaultVal;
const num = parseFloat(String(val).replace(/[^\d.-]/g, ''));
return isNaN(num) ? defaultVal : num;
}
// 測試
console.log(parseIntSafe("09")); // 9
console.log(parseIntSafe("09", 8)); // 0 (八進制下 9 非法)
console.log(parseIntSafe("100px")); // 100
console.log(parsePx("100px")); // 100
console.log(parsePx("12.5em")); // 12.5
替代方案對比
| 方法 | 用途 | 特點 |
parseInt(str, 10) | 字符串轉整數 | 截斷小數、支援進制、需指定 radix |
parseFloat(str) | 字符串轉浮點數 | 保留小數、不支援進制 |
Number(str) | 轉數字 | 嚴格、整串無效返回 NaN |
+str / str - 0 | 快速轉數字 | 同 Number()、簡潔 |
Math.floor(val) | 向下取整 | 數字輸入、處理負數正確 |
val | 0 | 位運算截斷 | 極快、限 32 位有符號整數 |
最佳實踐清單
- ✅ 永遠指定 radix:
parseInt(str, 10)
- ✅ 處理
NaN 回退值
- ✅ CSS 像素值用
parseFloat 或正則提取
- ✅ 位運算
val | 0 仅用於性能極敏感且確定範圍場景
- ✅ 使用 TypeScript 類型檢查避免運行時驚喜