isNaN() 是全域函數,用於判斷傳入值是否為 NaN(Not-a-Number)。它常與 parseInt()、parseFloat() 搭配,驗證解析結果是否為合法數字。本文詳細說明其類型轉換規則、常見誤區與替代方案。
isNaN(value) // 返回 Boolean
// true => value 是 NaN,或經 ToNumber 轉換後為 NaN
// false => value 是合法數字(含 Infinity、-Infinity)
isNaN 會先嘗試將參數轉為數字(ToNumber(value)),再判斷是否為 NaN。因此:
| 輸入 | ToNumber 結果 | isNaN 返回 | 說明 |
|---|---|---|---|
| 123 | 123 | false | 數字 |
| -1.23 | -1.23 | false | 負浮點數 |
| 5-2 | 3 | false | 表達式求值後傳入 |
| 0 | 0 | false | 零也是數字 |
| "Hello" | NaN | true | 字符串無法轉數字 |
| "2005/12/12" | NaN | true | 日期字符串非標準數字格式 |
| "123" | 123 | false | 純數字字符串可轉換 |
| "" | 0 | false | 空字符串轉 0 |
| null | 0 | false | null 轉 0 |
| undefined | NaN | true | undefined 轉 NaN |
| [] | 0 | false | 空陣列轉 0 |
| [123] | 123 | false | 單元素陣列轉該元素 |
isNaN(" ") // false (空白字符串 ToNumber -> 0)
isNaN("\t\n") // false (同理)
isNaN("123abc") // true (ToNumber -> NaN)
這導致 isNaN 無法準確判斷「是否為純數字字符串」。
Number.isNaN(NaN) // true
Number.isNaN("Hello") // false (不做類型轉換,直接判斷值是否為 NaN)
Number.isNaN(undefined) // false
Number.isNaN(0/0) // true
強烈建議:現代環境優先使用 Number.isNaN(),語義精確,無隱式轉換副作用。
function toInt(str, defaultVal = 0) {
var num = parseInt(str, 10);
return Number.isNaN(num) ? defaultVal : num;
}
function toFloat(str, defaultVal = 0) {
var num = parseFloat(str);
return Number.isNaN(num) ? defaultVal : num;
}
// 用法
var age = toInt($("#age").val(), 18);
var price = toFloat($("#price").val(), 0.0);
function isNumeric(val) {
// 排除空數組、null、undefined、非數字字符串
return typeof val === 'number' && !Number.isNaN(val) && isFinite(val);
// 或 jQuery: $.isNumeric(val) (已棄用)
}
理解 isNaN 的隱式轉換行為,改用 Number.isNaN(),能避免大量「以為是數字實則非數字」的邏輯 Bug。