js includes方法为何对NaN判断失效？

Question

在JavaScript中，`includes()` 方法用于判断数组是否包含某个值，其底层使用严格相等（`===`）进行比较。然而，`NaN !== NaN`，这是IEEE 754标准定义的特性，导致 `includes()` 无法正确识别数组中的 `NaN`。例如，`[NaN].includes(NaN)` 返回 `true`，看似正常，但若通过变量引用或复杂类型判断时，行为可能出人意料。更深层问题是：`includes()` 并不专门处理 `NaN` 的特殊性，仅依赖值比较。因此，在涉及 `NaN` 的查找场景中，开发者应结合 `Number.isNaN()` 或使用 `indexOf()` 配合自定义逻辑来确保准确性。

Answer 1

1. JavaScript中includes()方法的基本行为分析

includes() 是 JavaScript 中数组的一个实例方法，用于判断数组是否包含某个指定值。其底层使用的是严格相等（===）进行比较。这意味着在大多数情况下，类型和值都必须完全一致才能返回 true。

console.log([1, 2, 3].includes(2)); // true
console.log([1, 2, 3].includes('2')); // false（类型不同）

然而，当涉及到特殊值如 NaN 时，这种基于 === 的机制会暴露出问题。根据 IEEE 754 浮点数标准，NaN !== NaN，即它不等于自身。这导致了在某些查找逻辑中出现反直觉的行为。

2. NaN 的特殊性及其对 includes() 的影响

尽管 NaN !== NaN，但以下代码却返回 true：

console.log([NaN].includes(NaN)); // true

这一现象看似矛盾，实则源于 includes() 方法的内部实现规范。ECMAScript 标准特别规定：在使用 includes() 检查 NaN 时，即使严格相等失败，也会通过调用 SameValueZero 算法来处理。该算法认为两个 NaN 值是“可接受相等”的。

比较方式	表达式	结果
严格相等 (===)	NaN === NaN	false
includes()	[NaN].includes(NaN)	true
indexOf()	[NaN].indexOf(NaN)	-1

注意：indexOf() 使用的是严格相等而非 SameValueZero，因此无法识别 NaN，返回 -1。

3. 复杂场景下的行为差异与潜在陷阱

虽然 [NaN].includes(NaN) 返回 true，但在涉及变量引用或嵌套结构时，行为可能变得不可预测。例如：

const a = NaN;
const b = NaN;
console.log(a === b); // false
console.log([a].includes(b)); // true（仍成立，因 SameValueZero）

但如果将 NaN 包装在对象或更复杂的结构中，则 includes() 不再适用：

const arr = [{ value: NaN }];
console.log(arr.includes({ value: NaN })); // false（引用不同）
console.log(arr.some(item => Number.isNaN(item.value))); // true（推荐做法）

由此可见，includes() 仅适用于原始值的直接比较，不能处理复合类型中的 NaN 判断。

4. 深层机制：ECMAScript 规范中的 SameValueZero 算法

为了理解为何 includes() 能“正确”识别 NaN，我们需要深入 ECMAScript 规范。该方法在内部使用了 SameValueZero 比较算法，其定义如下：

• 如果两个值都是 undefined，返回 true。
• 如果两个值都是 null，返回 true。
• 如果是数字类型，且均为 NaN，返回 true。
• 否则执行严格相等（===）。

这解释了为什么 includes() 在面对 NaN 时表现得比其他方法更“智能”，但它并未真正“解决”NaN 的语义问题，只是规避了部分风险。

5. 实际开发中的解决方案与最佳实践

在实际项目中，尤其是涉及数据清洗、科学计算或用户输入解析时，NaN 的检测应更加严谨。以下是几种推荐策略：

1. 使用 Number.isNaN() 显式检测：相比全局 isNaN()，它不会强制转换类型。
2. 结合 Array.prototype.some() 或 find() 配合自定义谓词函数。
3. 封装通用工具函数，统一处理 NaN 查找逻辑。

function containsNaN(arr) {
  return arr.some(Number.isNaN);
}

console.log(containsNaN([1, 2, NaN])); // true
console.log(containsNaN([1, 2, 'hello'])); // false

6. 可视化流程：如何安全地判断数组是否包含 NaN

graph TD A[开始] --> B{数组是否存在?} B -- 否 --> C[返回 false] B -- 是 --> D[遍历每个元素] D --> E{元素是否为 NaN?} E -- 是 --> F[返回 true] E -- 否 --> G[检查下一个元素] G --> E F --> H[结束] C --> H

上述流程图展示了一个健壮的 NaN 检测逻辑，避免依赖 includes() 的隐式行为。