isNaN()
=======

**`isNaN()`** 函式會判斷某個數值是不是 `NaN`。注意：在 `isNaN` 函式裡面，有個有趣的強制性規則。你可能會想改用在 ECMAScript 2015 導入的 `Number.isNaN()` (en-US)。

嘗試一下
----

語法
--


```js
isNaN(value)
```

### 參數

`value`

要測試的數值。

### 回傳值

如果給定值是 `NaN` 就回傳 **`true`**、否則就回傳 **`false`**。

描述
--

### 為什麼要用 `isNaN` 函式

與其他 JavaScript 的值不同，你不可能靠等號運算符（== 與 ===）來判斷某個值是不是 `NaN`，因為連 `NaN == NaN` 與 `NaN === NaN` 的結果都是 `false`。因此，`isNaN` 函式是必要的。

### `NaN` 值的來源

`NaN` 會在算術運算（arithmetic operations）出現 *undefined* 或是 *unrepresentable* 值的結果時產生。這些值不一定是溢出條件。`NaN` 亦為試圖給毫無可用數字的原始值、予以強制運算之結果。

例如，零除以零的結果會是 `NaN`——不過把其他數字除以零則不是 `NaN`。

### 令人困惑的特殊狀況行為

從最早的 `isNaN` 函式版本規範始，其針對非數值之行為，不斷教人困惑至極。當 `isNaN` 函式的參數並非數字型別時，此值會先強制轉換到數字。該值接著會測定此值是否為 `NaN`。因此，當被強制轉換的非數字，給出了有效的非 NaN 值（經典案例為空的字串與布林原始值：它們在強制轉換時，會給予數字結果 0 或 1）時，會回傳不如預期的「false」值：以空的字串為例，它很明顯地「非數字」。這段教人糾結的點，乃出於「非數字」術語的「數字」一詞、由 IEEE-754 浮點值定義之事實而來。這個函式要解釋為「當這個值，被強制轉換為數值時，它還是 IEEE-754 的『非數字』值嗎？」的答案。

最新的 ECMAScript（ES2015）版本導入了 `Number.isNaN()` (en-US) 函式。儘管 `Number.isNaN` 的 `NaN` 依舊維持了數字上的意義、而不是簡單的「非數字」，`Number.isNaN(x)` 在偵測 `x` 為 `NaN` 與否時比較可靠。另外，如果在缺少 `Number.isNaN` 的情況下，通過表達式`(x != x)` 來檢測變量`x`是否是 NaN 會更加的可靠。

一個 `isNaN` 的 polyfill 可以理解為（這個 polyfill 利用了 `NaN` 自身永不等於自身這一特性）：


```js
var isNaN = function (value) {
  var n = Number(value);
  return n !== n;
};
```

範例
--


```js
isNaN(NaN); // true
isNaN(undefined); // true
isNaN({}); // true

isNaN(true); // false
isNaN(null); // false
isNaN(37); // false

// 字串
isNaN("37"); // false: "37" 轉換成數字的 37 後就不是 NaN 了
isNaN("37.37"); // false: "37.37" 轉換成數字的 37.37 後就不是 NaN 了
isNaN("123ABC"); // true: parseInt("123ABC") 是 123 但 Number("123ABC") 是 NaN
isNaN(""); // false: 空字串轉換成數字的 0 後就不是 NaN 了
isNaN(" "); // false: 有空白的字串轉換成數字的 0 後就不是 NaN 了

// 日期
isNaN(new Date()); // false
isNaN(new Date().toString()); // true

// 這個偵測的錯誤是不能完全信賴 isNaN 的理由
isNaN("blabla"); // true: "blabla" 被轉換為數字，將其解析為數字失敗後回傳了 NaN
```

### 實用的特殊狀況行為

當然，你能以更用途導向的方法去思考 `isNaN()`：如果 `isNaN()` 回傳 `false`，那麼把 `x` 用在任何算術表達式都不會回傳 `NaN`。相反地，如果回傳 `true`，那麼把 `x` 用在任何算術表達式都會是 `NaN`。這在 JavaScript 的意義是 `isNaN(x) == true` 等於 `x - 0` 回傳 `NaN`（儘管在 JavaScript 裡面 `x - 0 == NaN` 永遠回傳 false，你因而無法測試）── 事實上，`isNaN(x)`、`isNaN(x - 0)`、`isNaN(Number(x))`、`Number.isNaN(x - 0)`、`Number.isNaN(Number(x))` 在 JavaScript 裡面，都會回傳一樣的東西。而 `isNaN(x)` 是所有表達式裡面最短的一種。

比方說，你可以用這個式子，去測試函式的參數能不能透過算術處理（也就是能「像」數字一樣被利用）、否則就提供預設值之類的。你可以透過上下文的根據以隱式數值轉換（implicitly converting value），以使用 JavaScript 提供的全部功能。


```js
function increment(x) {
  if (isNaN(x)) x = 0;
  return x + 1;
}

// 與 Number.isNaN() 一樣：
function increment(x) {
  if (Number.isNaN(Number(x))) x = 0;
  return x + 1;
}

// 以下範例的函式參數 x，isNaN(x) 都會回傳 false，
// 儘管 x 不是數字，依舊能用在算術表達式。
increment(""); // 1: "" 被轉換成 0
increment(new String()); // 1: 空字串的新字串物件被轉換成 0
increment([]); // 1: [] 被轉換成 0
increment(new Array()); // 1: 空陣列的新陣列物件被轉換成 0
increment("0"); // 1: "0" 被轉換成 0
increment("1"); // 2: "1" 被轉換成 1
increment("0.1"); // 1.1: "0.1" 被轉換成 0.1
increment("Infinity"); // Infinity: "Infinity" 被轉換成 Infinity
increment(null); // 1: null 被轉換成 0
increment(false); // 1: false 被轉換成 0
increment(true); // 2: true 被轉換成 1
increment(new Date()); // 回傳以毫秒為單位加 1，當今的日期/時間

// 以下範例的函式參數 x，isNaN(x) 都會回傳 false，而 x 的確是數字。
increment(-1); // 0
increment(-0.1); // 0.9
increment(0); // 1
increment(1); // 2
increment(2); // 3
// …等等…
increment(Infinity); // Infinity

// 以下範例的函式參數 x，isNaN(x) 都會回傳 true，x 也的確不是數字。
// 使得函式會被 0 取代，並回傳 1
increment(String); // 1
increment(Array); // 1
increment("blabla"); // 1
increment("-blabla"); // 1
increment(0 / 0); // 1
increment("0/0"); // 1
increment(Infinity / Infinity); // 1
increment(NaN); // 1
increment(undefined); // 1
increment(); // 1

// isNaN(x) 與 isNaN(Number(x)) 永遠一樣，不過這裡的 x 是強制存在的！
isNaN(x) == isNaN(Number(x)); // 針對所有 x 的值都是 true，x == undefined 也不例外，
// 因為 isNaN(undefined) == true 且 Number(undefined) 回傳 NaN，
// 不過……
isNaN() == isNaN(Number()); // false，因為 isNaN() == true 且 Number() == 0
```

規範
--

| Specification |
| --- |
| ECMAScript Language Specification # sec-isnan-number |

瀏覽器相容性
------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

參見
--

* `NaN`
* `Number.isNaN()` (en-US)