萬盛學電腦網

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

JavaScript parseInt 函數完整解析:進制陷阱與最佳實踐

函數簽名


parseInt(string, radix)
// string: 要解析的字符串
// radix: 進制基數(2-36),默認 10
// 返回:解析後的整數,無法解析返回 NaN

進制自動檢測規則(無 radix 時)

字符串開頭推斷進制示例結果
0x 或 0X16 進制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 位有符號整數

最佳實踐清單

  1. ✅ 永遠指定 radix:parseInt(str, 10)
  2. ✅ 處理 NaN 回退值
  3. ✅ CSS 像素值用 parseFloat 或正則提取
  4. ✅ 位運算 val | 0 仅用於性能極敏感且確定範圍場景
  5. ✅ 使用 TypeScript 類型檢查避免運行時驚喜
copyright © 萬盛學電腦網 all rights reserved