Skip to content

Commit

Permalink
zh-cn: update the translation of isNaN() (#17579)
Browse files Browse the repository at this point in the history
  • Loading branch information
yin1999 authored Dec 24, 2023
1 parent c229291 commit 5d255d6
Showing 1 changed file with 21 additions and 102 deletions.
123 changes: 21 additions & 102 deletions files/zh-cn/web/javascript/reference/global_objects/isnan/index.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,13 @@
---
title: isNaN()
slug: Web/JavaScript/Reference/Global_Objects/isNaN
l10n:
sourceCommit: e5f0e1070962ee4a595369218d85481542ec7ded
---

{{jsSidebar("Objects")}}

**`isNaN()`** 函数用来确定一个值是否为 {{jsxref("NaN")}} 。注:`isNaN` 函数内包含一些非常有趣的[规则](#描述);你也可以使用 ECMAScript 2015 中定义的 {{jsxref("Number.isNaN()")}} 来判断
**`isNaN()`** 函数用来确定一个值是否为 {{jsxref("NaN")}},若有必要,则首先将值转换为数字。由于 `isNaN()` 函数内部的强制类型转换可能[令人迷惑](#描述),因此你可能更想要使用 {{jsxref("Number.isNaN()")}}。

{{EmbedInteractiveExample("pages/js/globalprops-isnan.html")}}

Expand All @@ -22,37 +24,26 @@ isNaN(value)

### 返回值

如果给定值为 {{jsxref("NaN")}}则返回值为`true`;否则为`false`
如果给定值[在被转换为数字后](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Number#number_强制转换) {{jsxref("NaN")}} 则返回值为 `true`;否则为 `false`

## 描述

### `isNaN` 函数的必要性
`isNaN()` 是全局对象的一个函数属性。

与 JavaScript 中其他的值不同,{{jsxref("Global_Objects/NaN", "NaN")}}不能通过相等操作符(== 和 ===)来判断,因为 `NaN == NaN``NaN === NaN` 都会返回 `false`。因此,`isNaN` 就很有必要了
对于数字值,`isNaN()` 检测该值是否为 [`NaN`](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/NaN) 值。当 `isNaN()` 函数的参数不是[数字](/zh-CN/docs/Web/JavaScript/Data_structures#number_类型)类型时,其会首先被转换为数字,然后将其结果值与 {{jsxref("NaN")}} 进行比较

### `NaN`的产生
`isNaN()` 对于非数字参数的行为可能会令人困惑!例如,空字符串被强制转换为 0,布尔值被强制转换为 0 或 1;直观上,两者均“不是数字”,仅因它们的运算结果不是 `NaN`,而使得 `isNaN()` 返回 `false`。因此,`isNaN()` 既不回答“输入是否为浮点数值 {{jsxref("NaN")}}”,也不回答“输入是否为数字”这两个问题。

当算术运算返回一个未定义的或无法表示的值时,`NaN`就产生了。但是,`NaN`并不一定用于表示某些值超出表示范围的情况。将某些不能强制转换为数值的非数值转换为数值的时候,也会得到`NaN`
{{jsxref("Number.isNaN()")}} 是检测一个值是否为数字值 `NaN` 的更可靠的方法。或者,也可以使用表达式 `x !== x`,这两种方法都不会产生全局 `isNaN()` 不可靠的误判。要检测一个值是否为数字,请使用 [`typeof x === "number"`](/zh-CN/docs/Web/JavaScript/Reference/Operators/typeof)

例如,0 除以 0 会返回 `NaN`——但是其他数除以 0 则不会返回 `NaN`
`isNaN()` 函数回答的问题是“在数字上下文中,输入是否在功能上与 {{jsxref("NaN")}} 等价”。如果 `isNaN(x)` 返回 `false`,则可以在算术表达式中使用 `x`,就好像它是一个有效的数字,而不是 `NaN`。如果 `isNaN(x)` 返回 `true`,则 `x` 将被强制转换为 `NaN`,并使大多数算术表达式返回 `NaN`(因为 `NaN` 会传播)。例如,可以使用这种方法来测试函数的参数是否可以进行算术处理(像数字一样使用),并通过抛出错误、提供默认值等来处理不是数字的值。这样,就可以拥有一个可以利用 JavaScript 提供的全部灵活性的函数,该函数可以根据上下文隐式地转换值

### 令人费解的怪异行为

如果`isNaN`函数的参数不是`Number`类型, `isNaN`函数会首先尝试将这个参数转换为数值,然后才会对转换后的结果是否是{{jsxref("NaN")}}进行判断。因此,对于能被强制转换为有效的非 NaN 数值来说(空字符串和布尔值分别会被强制转换为数值 0 和 1),返回`false`值也许会让人感觉莫名其妙。比如说,空字符串就明显“不是数值(not a number)”。这种怪异行为起源于:"不是数值(not a number)"在基于 IEEE-754 数值的浮点计算体制中代表了一种特定的含义。`isNaN`函数其实等同于回答了这样一个问题:被测试的值在被强制转换成数值时会不会返回 IEEE-754 中所谓的“不是数值(not a number)”。

下一个版本的 ECMAScript (ES2015) 包含{{jsxref("Number.isNaN()")}}函数。通过`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;
};
```
> **备注:** [`+` 运算符](/zh-CN/docs/Web/JavaScript/Reference/Operators/Addition)既执行数字加法又执行字符串连接。因此,即使 `isNaN()` 对两个操作数都返回 `false``+` 运算符仍可能因为它不是被用作算术运算符而返回字符串。例如,`isNaN("1")` 返回 `false`,而 `"1" + 1` 返回 `"11"`。要确保你正在使用数字,请[将值强制转换为数字](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Number#number_强制转换)并使用 {{jsxref("Number.isNaN()")}} 来测试结果。
## 示例

注意 `isNaN()` 为什么会对一些既不是数字也不是 {{jsxref("NaN")}} 的值返回 `true`

```js
isNaN(NaN); // true
isNaN(undefined); // true
Expand All @@ -62,89 +53,17 @@ isNaN(true); // false
isNaN(null); // false
isNaN(37); // false

// strings
isNaN("37"); // false: 可以被转换成数值 37
isNaN("37.37"); // false: 可以被转换成数值 37.37
// 字符串
isNaN("37"); // false:可以被转换成数字 37,不是 NaN
isNaN("37.37"); // false:可以被转换成数字 37.37,不是 NaN
isNaN("37,5"); // true
isNaN("123ABC"); // true: parseInt("123ABC") 的结果是 123,但是 Number("123ABC") 结果是 NaN
isNaN(""); // false: 空字符串被转换成 0
isNaN(" "); // false: 包含空格的字符串被转换成 0

// dates
isNaN(new Date()); // false
isNaN(new Date().toString()); // true
isNaN("123ABC"); // true:Number("123ABC") 的结果是 NaN
isNaN(""); // false:空字符串被转换成 0,不是 NaN
isNaN(" "); // false:由空格组成的字符串被转换成 0,不是 NaN

isNaN("blabla"); // true: "blabla"不能转换成数值
// 转换成数值失败,返回 NaN
```

### 有用的特殊行为

有许多方式来看待 `isNaN()`:如果`isNaN(x)`返回 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) 是这些表达式中最短的表达。

举个例子,可以利用这个特殊行为来检测函数的参数是可运算的(可以像 number 一样进行加减乘除等运算)。如果不可运算,则可赋予这个参数一个默认的值或其他合适的内容。这样,就可以得到一个隐式转换参数值的函数,而这得益于 Javascript 的全功能性。

## 示例

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

// The same effect with Number.isNaN():
function increment(x) {
if (Number.isNaN(Number(x))) x = 0;
return x + 1;
}

// In the following cases for the function's argument x,
// isNaN(x) is always false, although x is indeed not a
// number, but can be used as such in arithmetical
// expressions
increment(""); // 1: "" is converted to 0
increment(new String()); // 1: String object representing an empty string is converted to 0
increment([]); // 1: [] is converted to 0
increment(new Array()); // 1: Array object representing an empty array is converted to 0
increment("0"); // 1: "0" is converted to 0
increment("1"); // 2: "1" is converted to 1
increment("0.1"); // 1.1: "0.1" is converted to 0.1
increment("Infinity"); // Infinity: "Infinity" is converted to Infinity
increment(null); // 1: null is converted to 0
increment(false); // 1: false is converted to 0
increment(true); // 2: true is converted to 1
increment(new Date()); // returns current date/time in milliseconds plus 1

// In the following cases for the function's argument x,
// isNaN(x) is always false and x is indeed a number
increment(-1); // 0
increment(-0.1); // 0.9
increment(0); // 1
increment(1); // 2
increment(2); // 3
// ... and so on ...
increment(Infinity); // Infinity

// In the following cases for the function's argument x,
// isNaN(x) is always true and x is really not a number,
// thus the function replaces it by 0 and returns 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) is always the same as isNaN(Number(x)),
// but the presence of x is mandatory here!
isNaN(x) == isNaN(Number(x)); // true for every value of x, including x == undefined,
// because isNaN(undefined) == true and Number(undefined) returns NaN,
// but ...
isNaN() == isNaN(Number()); // false, because isNaN() == true and Number() == 0
// 日期
isNaN(new Date()); // false;Date 对象可以转换为数字(时间戳)
isNaN(new Date().toString()); // true;Date 对象的字符串表示形式不能解析为数字
```

## 规范
Expand Down

0 comments on commit 5d255d6

Please sign in to comment.