es-toolkit 的 isBoolean 详解Lodash 兼容的布尔类型判断与 TypeScript 类型守卫【免费下载链接】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-toolkitisBoolean是 es-toolkit 中用于判断值是否为 boolean 类型含 Boolean 对象包装器的类型安全函数。本文以 compat 兼容层中的 isBoolean 文档 为骨架结合 源码实现 与 测试用例 深入讲解其行为边界、与原生typeof的取舍、与 es-toolkit 严格 API 版本的差异以及从 Lodash 迁移时的实际用法。一、函数概览签名、参数与返回值isBoolean位于es-toolkit/compat兼容层其调用签名与 Lodash 完全一致const result isBoolean(value);项目说明参数valueunknown类型即要判断是否为 boolean 的任意值返回值value is boolean若值为 boolean 类型返回true否则返回false类型守卫是 TypeScript 类型谓词type predicate可收窄参数类型从源码看compat 版本的实现非常简洁核心逻辑只有一行export function isBoolean(value?: any): value is boolean { return typeof value boolean || value instanceof Boolean; }实现位于 src/compat/predicate/isBoolean.ts由两个条件组成typeof value boolean命中true/false两个原始值primitivevalue instanceof Boolean命中new Boolean(true)这类 Boolean 对象包装器。两个条件任意成立即判定为 boolean。注意参数被声明为value?: any这是兼容层为了与 Lodash 行为 1:1 对齐而保留的宽松签名详见后文与严格 API 的对比。二、使用方式与行为对照在 TypeScript 项目中从 compat 入口导入并使用import { isBoolean } from es-toolkit/compat; // 原始 boolean 值 isBoolean(true); // true isBoolean(false); // true // Boolean 对象包装器 isBoolean(new Boolean(true)); // true isBoolean(new Boolean(false)); // true // 其他类型一律返回 false isBoolean(0); // false isBoolean(1); // false isBoolean(true); // false isBoolean(false); // false isBoolean(null); // false isBoolean(undefined); // false isBoolean({}); // false isBoolean([]); // false判断边界速查表输入结果原因true/falsetruetypeof为booleannew Boolean(true)/new Boolean(false)trueinstanceof Boolean成立0/1/NaN//null/undefinedfalse均为非 boolean 类型true/false字符串false字符串不会隐式转换{}/[]/ 函数 / 正则 / Date 等false不属于 boolean 家族值得强调的是字符串true、false、数字0、1都不会被误判为 boolean这一点与某些语言或宽松框架的行为不同符合 Lodash 的语义。三、为什么文档建议优先使用typeof运算符官方文档在开头用醒目警告提出了建议请使用typeof运算符。isBoolean函数因处理 Boolean 对象包装器而变得复杂。建议改用更简单、更现代的typeof value boolean。其背后的原因是为了兼容 Lodash 行为compat 版isBoolean必须额外处理new Boolean()包装器这引入了instanceof判断。而实际项目中几乎不会出现 Boolean 包装器对象绝大多数场景下直接写const isBool typeof value boolean;更直接、零函数调用开销、也无须处理instanceof的边界问题。因此若你正在新写代码或使用 es-toolkit 的严格 API建议直接用typeof或严格版isBoolean若你在迁移存量 Lodash 代码为了不改动调用点可使用 compat 版isBoolean保持行为一致。四、源码级解析兼容层实现与严格版实现的差异4.1 兼容层compat实现src/compat/predicate/isBoolean.ts 完整实现如下export function isBoolean(value?: any): value is boolean { return typeof value boolean || value instanceof Boolean; }它额外判断了 Boolean 包装器这是 Lodash 行为的一部分——Lodash 的isBoolean同样对new Boolean()返回true。4.2 严格 APIes-toolkit 主入口实现主包非 compat中的 src/predicate/isBoolean.ts 则只保留最纯粹的判断export function isBoolean(x: unknown): x is boolean { return typeof x boolean; }两个版本的差异总结对比维度es-toolkit严格 APIes-toolkit/compat参数类型unknown类型更严格any与 Lodash 签名对齐是否识别 Boolean 包装器否是instanceof Boolean语义纯原始 booleanLodash 兼容语义典型使用场景新代码、类型安全优先迁移存量 Lodash 代码从 src/predicate/index.ts 可以看到严格版isBoolean会从es-toolkit主入口导出而 compat 版从 src/compat/compat.ts 的es-toolkit/compat入口导出。这也印证了 compat 层的设计初衷——与 Lodash 1:1 对齐含隐式类型转换、多重参数形态等代价是体积与运行开销略大详见 docs/compat/intro.md。五、测试用例验证行为边界有据可查compat 版isBoolean的行为边界由 src/compat/predicate/isBoolean.spec.ts 中的 Vitest 用例完整覆盖正向用例——以下输入均应返回trueisBoolean(true); // true isBoolean(false); // true isBoolean(Object(true)); // true isBoolean(Object(false)); // true反向用例——以下输入均应返回falsearguments对象、数组、Date、Error、函数slice、普通对象、数字、正则、字符串、Symbol 等。测试还借助 src/compat/_internal/falsey.ts 中的假值集合[, null, undefined, false, 0, NaN, ]做了系统性验证对每个假值调用isBoolean只有false本身返回true即falsey.map(value value false)与falsey.map(value isBoolean(value))结果完全一致。这从侧面确认了undefined、null、0、NaN、空字符串这些常见的类布尔陷阱值都不会被误判。六、在 TypeScript 中使用类型守卫isBoolean的返回类型被声明为value is boolean因此它天然是 TypeScript 的类型守卫type predicate可以直接用于条件分支收窄类型import { isBoolean } from es-toolkit/compat; function process(value: unknown) { if (isBoolean(value)) { // 此处 value 已被收窄为 boolean 类型 return value ? yes : no; } // 此处 value 仍为 unknown return String(value); }在if分支内 TypeScript 编译器会依据类型谓词将value从unknown收窄为boolean从而避免手写类型断言提升代码的类型安全性。严格版isBoolean参数为unknown同样具备这一能力且由于不包含instanceof分支收窄语义更为纯粹。七、迁移与使用建议总结新项目、新代码优先使用typeof value boolean或从es-toolkit主入口导入严格版isBoolean类型更严格、体积更小、语义更纯粹。存量 Lodash 代码库将import isBoolean from lodash/isBoolean替换为import { isBoolean } from es-toolkit/compat或import isBoolean from es-toolkit/compat/isBoolean按需引入无需改动调用点即可获得与 Lodash 一致的行为。需要处理 Boolean 包装器若确实存在new Boolean()产生的对象例如来自旧代码或某些序列化框架必须使用 compat 版isBoolean严格版与typeof均无法识别。性能与体积敏感场景isBoolean是 O(1) 的常量级判断无任何遍历或递归在热路径中直接使用typeof可省去一次函数调用。相关资源compat 版实现src/compat/predicate/isBoolean.ts严格版实现src/predicate/isBoolean.tscompat 版测试src/compat/predicate/isBoolean.spec.ts兼容层设计说明docs/compat/intro.md兼容层导出入口src/compat/compat.ts【免费下载链接】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），仅供参考
