es-toolkit 兼容版 isNaN 全解析与 Number.isNaN 的取舍及源码级实现原理【免费下载链接】es-toolkitA modern JavaScript utility library thats 2-3 times faster and up to 97% smaller, a major upgrade to lodash.项目地址: https://gitcode.com/GitHub_Trending/es/es-toolkit本文围绕 es-toolkit 的 Lodash 兼容 APIisNaN文档原文展开说明它检查一个值是否为 NaN的语义、与原生Number.isNaN/全局isNaN的差异、何时该用、为何官方建议优先使用Number.isNaN并结合仓库源码与测试用例剖析其底层实现。读完你将能准确判断项目中每一个是不是 NaN的场景并写出既兼容 Lodash 又高性能的判空代码。一、为什么需要检查 NaN先厘清 NaN 的本质NaNNot-a-Number是 IEEE 754 浮点数标准中一个特殊的数值用于表示无法产生有意义的数值结果的运算结果例如0 / 0、parseInt(abc)。它有两个让初学者头疼的特性它不等于它自己NaN NaN为false因此无法用直接判断。它是number类型typeof NaN number为true所以又不能用typeof区分。于是各路判 NaN方案层出不穷但行为各不相同。es-toolkit 的isNaN正是为了在 Lodash 兼容场景下给出一个行为确定、可预期的答案。二、API 一览签名、参数与返回值es-toolkit 兼容版isNaN的完整类型签名来自 src/compat/predicate/isNaN.tsexport function isNaN(value?: any): boolean;项目说明参数value类型为unknown实现中放宽为any即要检查是否为 NaN 的值返回值boolean值为 NaN 时返回true否则返回false导出位置es-toolkit/compat子路径见 src/compat/compat.ts典型调用方式import { isNaN } from es-toolkit/compat; isNaN(NaN); // true isNaN(Number.NaN); // true isNaN(undefined); // false isNaN(null); // false isNaN(0); // false isNaN(NaN); // false三、三种 isNaN 的对比行为差异决定了选型要理解 es-toolkit 兼容版isNaN的价值必须先分清 JavaScript 里三种isNaN函数判断逻辑isNaN(NaN)isNaN(new Number(NaN))适用场景全局isNaN(value)先Number(value)强转再判trueNaN 被转成 NaNtrue几乎不推荐语义过于宽松Number.isNaN(value)严格判断类型必须本身就是 number 且值为 NaNfalsefalse现代推荐方案语义精确es-toolkitisNaN(value)Lodash 兼容先判是 number含装箱对象再对数值取 NaNfalsetrue需要 Lodash 行为一致时关键差异点字符串NaN全局isNaN会返回true因为它先做隐式转换而 es-toolkit 兼容版与Number.isNaN都返回false——字符串不是数值。装箱对象new Number(NaN)Number.isNaN返回false对象不是原始 number而 es-toolkit 兼容版返回true。这是与 Lodash 保持一致的兼容性行为Lodash 的_.isNaN会通过isNumber判断数值对象也算 number。四、源码级实现剖析两层判断的调用链es-toolkit 兼容版isNaN的实现非常精简只有一行核心逻辑// src/compat/predicate/isNaN.ts import { isNumber } from ./isNumber; export function isNaN(value?: any): boolean { return isNumber(value) Number.isNaN(Number(value)); }它由两层判断组成第一层isNumber(value)过滤掉所有非数值。isNumber定义在 src/compat/predicate/isNumber.tsexport function isNumber(value?: any): value is number { return typeof value number || (isObjectLike(value) getTag(value) numberTag); }它识别两类数字原始类型typeof value number装箱对象isObjectLike(value)非 null 的对象且Object.prototype.toString.call(value)的结果为[object Number]即new Number(...)。getTag来自 src/compat/_internal/getTag.ts本质就是安全的Object.prototype.toString.call封装并单独处理了null/undefined的标签。第二层Number.isNaN(Number(value))在数字上做严格的 NaN 判定。这里有两个细节值得注意先Number(value)再交给Number.isNaN。由于第一层已经保证了value是 number或装箱 NumberNumber()只是把装箱对象解包成原始数字不会产生意外的字符串强转——这正是它能正确处理new Number(NaN)的原因。最终判定用的仍是原生Number.isNaN保证了 NaN 判定的精确性。整体调用链可概括为isNaN(value) └─ isNumber(value) // 原始 number 或装箱 Number 才继续 ├─ typeof value number └─ isObjectLike(value) getTag(value) numberTag // 处理 new Number(...) └─ Number.isNaN(Number(value)) // 解包后严格判 NaN从源码结构可以推断兼容版isNaN的慢主要来自isNumber内部的类型标签检测——对装箱对象需要调用Object.prototype.toString.call获取标签且整个判断路径比Number.isNaN多出若干函数调用层这正是文档开头警示operates slowly due to additional function calls的由来。五、测试用例验证行为边界一览仓库在 src/compat/predicate/isNaN.spec.ts 中用 Vitest 固化了该函数的行为边界可作为行为契约参考describe(isNaN, () { it(should return true for NaN, () { expect(isNaN(NaN)).toBe(true); }); it(should return false for non-NaN numbers, () { expect(isNaN(0)).toBe(false); expect(isNaN(new Number(0))).toBe(false); }); it(should return true for boxed NaN, () { expect(isNaN(new Number(NaN))).toBe(true); }); it(should return false for objects inheriting Number.prototype without number data, () { expect(isNaN(Object.create(Number.prototype))).toBe(false); }); it(should return false for non-numbers, () { expect(isNaN(NaN)).toBe(false); expect(isNaN(true)).toBe(false); expect(isNaN(null)).toBe(false); expect(isNaN(undefined)).toBe(false); expect(isNaN({})).toBe(false); expect(isNaN([])).toBe(false); expect(isNaN(() {})).toBe(false); }); });几个值得留意的边界new Number(NaN)返回trueLodash 兼容行为new Number(0)返回false——装箱对象只要内部值不是 NaN 就不算 NaNObject.create(Number.prototype)返回false——虽然它继承了Number.prototype但没有实际的数值数据isNumber的getTag检测会得到[object Object]而非[object Number]因此被正确排除函数、数组、对象、null、undefined、布尔值、字符串NaN一律返回false。六、工程实践建议什么时候用哪一个根据文档的明确警示与上述实现分析给出如下选型建议新代码、性能敏感路径直接用Number.isNaN。文档在 docs/compat/reference/predicate/isNaN.md 顶部即给出::: warning提示ThisisNaNfunction operates slowly due to additional function calls. Instead, use the faster and modernNumber.isNaN. 对于绝大多数判断一个数是不是 NaN的需求Number.isNaN语义精确、零函数调用开销是最优解。需要与 Lodash 行为 100% 一致如迁移存量 Lodash 代码使用es-toolkit/compat的isNaN。es-toolkit 的 compat 子路径专为 Lodash 兼容设计本函数对new Number(NaN)的处理与 Lodash 保持一致可作为_.isNaN的平替。此时请先审视业务是否真的会传入装箱 Number——若不会用Number.isNaN更省心。永远不要用全局isNaN做严格判空。它的隐式类型转换会让isNaN(NaN)返回true极易埋下隐患。七、相关函数与进一步探索主实现src/compat/predicate/isNaN.ts类型判断依赖src/compat/predicate/isNumber.ts、src/compat/_internal/getTag.ts测试用例src/compat/predicate/isNaN.spec.ts导出入口src/compat/compat.ts若你正在把项目从 Lodash 迁移到 es-toolkit还可以参考 docs/compat/intro.md 了解整个 compat 模块的覆盖范围与迁移策略判空类函数isNil、isNumber、isFinite等的完整文档位于 docs/compat/reference/predicate/ 目录下可与isNaN配合使用构建完整的类型守卫体系。【免费下载链接】es-toolkitA modern JavaScript utility library thats 2-3 times faster and up to 97% smaller, a major upgrade to lodash.项目地址: https://gitcode.com/GitHub_Trending/es/es-toolkit创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
es-toolkit 兼容版 isNaN 全解析：与 Number.isNaN 的取舍及源码级实现原理
es-toolkit 兼容版 isNaN 全解析与 Number.isNaN 的取舍及源码级实现原理【免费下载链接】es-toolkitA modern JavaScript utility library thats 2-3 times faster and up to 97% smaller, a major upgrade to lodash.项目地址: https://gitcode.com/GitHub_Trending/es/es-toolkit本文围绕 es-toolkit 的 Lodash 兼容 APIisNaN文档原文展开说明它检查一个值是否为 NaN的语义、与原生Number.isNaN/全局isNaN的差异、何时该用、为何官方建议优先使用Number.isNaN并结合仓库源码与测试用例剖析其底层实现。读完你将能准确判断项目中每一个是不是 NaN的场景并写出既兼容 Lodash 又高性能的判空代码。一、为什么需要检查 NaN先厘清 NaN 的本质NaNNot-a-Number是 IEEE 754 浮点数标准中一个特殊的数值用于表示无法产生有意义的数值结果的运算结果例如0 / 0、parseInt(abc)。它有两个让初学者头疼的特性它不等于它自己NaN NaN为false因此无法用直接判断。它是number类型typeof NaN number为true所以又不能用typeof区分。于是各路判 NaN方案层出不穷但行为各不相同。es-toolkit 的isNaN正是为了在 Lodash 兼容场景下给出一个行为确定、可预期的答案。二、API 一览签名、参数与返回值es-toolkit 兼容版isNaN的完整类型签名来自 src/compat/predicate/isNaN.tsexport function isNaN(value?: any): boolean;项目说明参数value类型为unknown实现中放宽为any即要检查是否为 NaN 的值返回值boolean值为 NaN 时返回true否则返回false导出位置es-toolkit/compat子路径见 src/compat/compat.ts典型调用方式import { isNaN } from es-toolkit/compat; isNaN(NaN); // true isNaN(Number.NaN); // true isNaN(undefined); // false isNaN(null); // false isNaN(0); // false isNaN(NaN); // false三、三种 isNaN 的对比行为差异决定了选型要理解 es-toolkit 兼容版isNaN的价值必须先分清 JavaScript 里三种isNaN函数判断逻辑isNaN(NaN)isNaN(new Number(NaN))适用场景全局isNaN(value)先Number(value)强转再判trueNaN 被转成 NaNtrue几乎不推荐语义过于宽松Number.isNaN(value)严格判断类型必须本身就是 number 且值为 NaNfalsefalse现代推荐方案语义精确es-toolkitisNaN(value)Lodash 兼容先判是 number含装箱对象再对数值取 NaNfalsetrue需要 Lodash 行为一致时关键差异点字符串NaN全局isNaN会返回true因为它先做隐式转换而 es-toolkit 兼容版与Number.isNaN都返回false——字符串不是数值。装箱对象new Number(NaN)Number.isNaN返回false对象不是原始 number而 es-toolkit 兼容版返回true。这是与 Lodash 保持一致的兼容性行为Lodash 的_.isNaN会通过isNumber判断数值对象也算 number。四、源码级实现剖析两层判断的调用链es-toolkit 兼容版isNaN的实现非常精简只有一行核心逻辑// src/compat/predicate/isNaN.ts import { isNumber } from ./isNumber; export function isNaN(value?: any): boolean { return isNumber(value) Number.isNaN(Number(value)); }它由两层判断组成第一层isNumber(value)过滤掉所有非数值。isNumber定义在 src/compat/predicate/isNumber.tsexport function isNumber(value?: any): value is number { return typeof value number || (isObjectLike(value) getTag(value) numberTag); }它识别两类数字原始类型typeof value number装箱对象isObjectLike(value)非 null 的对象且Object.prototype.toString.call(value)的结果为[object Number]即new Number(...)。getTag来自 src/compat/_internal/getTag.ts本质就是安全的Object.prototype.toString.call封装并单独处理了null/undefined的标签。第二层Number.isNaN(Number(value))在数字上做严格的 NaN 判定。这里有两个细节值得注意先Number(value)再交给Number.isNaN。由于第一层已经保证了value是 number或装箱 NumberNumber()只是把装箱对象解包成原始数字不会产生意外的字符串强转——这正是它能正确处理new Number(NaN)的原因。最终判定用的仍是原生Number.isNaN保证了 NaN 判定的精确性。整体调用链可概括为isNaN(value) └─ isNumber(value) // 原始 number 或装箱 Number 才继续 ├─ typeof value number └─ isObjectLike(value) getTag(value) numberTag // 处理 new Number(...) └─ Number.isNaN(Number(value)) // 解包后严格判 NaN从源码结构可以推断兼容版isNaN的慢主要来自isNumber内部的类型标签检测——对装箱对象需要调用Object.prototype.toString.call获取标签且整个判断路径比Number.isNaN多出若干函数调用层这正是文档开头警示operates slowly due to additional function calls的由来。五、测试用例验证行为边界一览仓库在 src/compat/predicate/isNaN.spec.ts 中用 Vitest 固化了该函数的行为边界可作为行为契约参考describe(isNaN, () { it(should return true for NaN, () { expect(isNaN(NaN)).toBe(true); }); it(should return false for non-NaN numbers, () { expect(isNaN(0)).toBe(false); expect(isNaN(new Number(0))).toBe(false); }); it(should return true for boxed NaN, () { expect(isNaN(new Number(NaN))).toBe(true); }); it(should return false for objects inheriting Number.prototype without number data, () { expect(isNaN(Object.create(Number.prototype))).toBe(false); }); it(should return false for non-numbers, () { expect(isNaN(NaN)).toBe(false); expect(isNaN(true)).toBe(false); expect(isNaN(null)).toBe(false); expect(isNaN(undefined)).toBe(false); expect(isNaN({})).toBe(false); expect(isNaN([])).toBe(false); expect(isNaN(() {})).toBe(false); }); });几个值得留意的边界new Number(NaN)返回trueLodash 兼容行为new Number(0)返回false——装箱对象只要内部值不是 NaN 就不算 NaNObject.create(Number.prototype)返回false——虽然它继承了Number.prototype但没有实际的数值数据isNumber的getTag检测会得到[object Object]而非[object Number]因此被正确排除函数、数组、对象、null、undefined、布尔值、字符串NaN一律返回false。六、工程实践建议什么时候用哪一个根据文档的明确警示与上述实现分析给出如下选型建议新代码、性能敏感路径直接用Number.isNaN。文档在 docs/compat/reference/predicate/isNaN.md 顶部即给出::: warning提示ThisisNaNfunction operates slowly due to additional function calls. Instead, use the faster and modernNumber.isNaN. 对于绝大多数判断一个数是不是 NaN的需求Number.isNaN语义精确、零函数调用开销是最优解。需要与 Lodash 行为 100% 一致如迁移存量 Lodash 代码使用es-toolkit/compat的isNaN。es-toolkit 的 compat 子路径专为 Lodash 兼容设计本函数对new Number(NaN)的处理与 Lodash 保持一致可作为_.isNaN的平替。此时请先审视业务是否真的会传入装箱 Number——若不会用Number.isNaN更省心。永远不要用全局isNaN做严格判空。它的隐式类型转换会让isNaN(NaN)返回true极易埋下隐患。七、相关函数与进一步探索主实现src/compat/predicate/isNaN.ts类型判断依赖src/compat/predicate/isNumber.ts、src/compat/_internal/getTag.ts测试用例src/compat/predicate/isNaN.spec.ts导出入口src/compat/compat.ts若你正在把项目从 Lodash 迁移到 es-toolkit还可以参考 docs/compat/intro.md 了解整个 compat 模块的覆盖范围与迁移策略判空类函数isNil、isNumber、isFinite等的完整文档位于 docs/compat/reference/predicate/ 目录下可与isNaN配合使用构建完整的类型守卫体系。【免费下载链接】es-toolkitA modern JavaScript utility library thats 2-3 times faster and up to 97% smaller, a major upgrade to lodash.项目地址: https://gitcode.com/GitHub_Trending/es/es-toolkit创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考