企业官网建设流程全解析

• 测试

Chance.js（Chance - Random generator helper for JavaScript）是一个开源的 JavaScript 随机数据生成库，而chance.falsy()是它 Basics 基础模块中专门用于生成"假值（falsy value）"的 API。本文将完整讲解falsy()的默认行为、六种内置假值类型、pool自定义选项的底层实现机制，并结合仓库源码与测试用例给出可验证的依据，帮助你快速掌握如何在测试数据构造、表单校验与边界场景模拟中灵活使用它。

一、falsy()是什么

在 JavaScript 中，假值（falsy value）指的是在布尔上下文中会被强制转换为false的值。chance.falsy()的职责就是等概率地随机返回一个假值，其默认候选池（pool）包含六种最经典的假值：

false、null、undefined、0、NaN、''

这一设计让开发者可以一次性覆盖"非真值"的多种形态，而不必手动从布尔、数字、字符串、空值等类型中逐一挑选。

在 docs/basics/falsy.md 中，官方给出的最基础用法只有一行：

// usages chance.falsy()

调用后返回的是六种假值中的随机一个，例如：

chance.falsy(); => false

二、默认 Pool 与六种内置假值

原文档明确声明：falsy()返回一个随机的假值（false、null、undefined、0、NaN、''）。这六个值在源码中体现为方法的默认参数，位于 chance.js 第 149-157 行：

Chance.prototype.falsy = function (options) { // return a random falsy value options = initOptions(options, {pool: [false, null, 0, NaN, '', undefined]}) var pool = options.pool, index = this.integer({min: 0, max: pool.length - 1}), value = pool[index]; return value; }

从源码结构可以梳理出三个关键点：

1. 默认池顺序与内容：[false, null, 0, NaN, '', undefined]，共 6 个元素，与文档描述完全一致；
2. 随机索引的生成：falsy()复用了 Chance.js 内置的integer({min: 0, max: pool.length - 1})来生成下标，再按下标从池中取值。这意味着池中每个假值被选中的概率近似相等（均为 1/6）；
3. 返回值不做二次转换：方法直接返回池中元素本身，因此返回值一定是严格的假值原值，而不会如Number()、Boolean()等函数那样被强制转换。

值得一提的细节是默认池中同时包含0与''，它们分别代表了"数字零"与"空字符串"这两种极常见的假值形态，方便直接用于数值与文本两类场景的边界测试。

三、使用pool自定义假值候选池

现实业务中，默认的六种假值未必全部适用——例如某个校验逻辑只关心null与undefined，或者你想混入自定义的假值形态（如0n、-0或特定场景的空对象）。此时可以传入pool选项覆盖默认池。

原文档中的示例：

chance.falsy({ pool: [ NaN, undefined ] }); => NaN

传入{ pool: [NaN, undefined] }后，返回值只可能是NaN或undefined中的随机一个。官方文档还给出了两种用法的并排对比：

// usages chance.falsy() chance.falsy({ pool: [ NaN, undefined ] })

底层原理：initOptions的默认值合并机制

自定义pool之所以能生效，依赖的是 Chance.js 内部的选项初始化函数initOptions（位于 chance.js 第 78-90 行）：

function initOptions(options, defaults) { options = options || {}; if (defaults) { for (var i in defaults) { if (typeof options[i] === 'undefined') { options[i] = defaults[i]; } } } return options; }

其合并规则是：只有当调用方传入的options中某个键为undefined时，才用默认值填充。因此：

• 调用chance.falsy()时，options为空对象，pool键缺失（值为undefined），于是被默认池[false, null, 0, NaN, '', undefined]填充；
• 调用chance.falsy({ pool: [NaN, undefined] })时，pool键已有自定义数组，initOptions不会覆盖它，最终从新池中随机取值。

这种"默认值兜底 + 用户值优先"的合并策略在整个 Chance.js 中广泛使用（bool、integer、string等方法均遵循同一套机制），falsy()是理解这一机制的最小范例。

使用建议与注意事项

• pool数组长度不限，可以传入 1 个或多个假值，甚至可以混合0与-0这类"在===下相等但在Object.is下不同"的值，以测试严格相等逻辑；
• 传入空数组[]时，this.integer({min: 0, max: -1})的取值行为会变得不可预期，不建议传入空池；
• 传入非假值（如1、'str'）虽然技术上可行，但违背了falsy()的语义契约，会让"保证返回假值"的前提失效，除非你有意构造非假值混合池，否则应避免。

四、测试用例如何验证falsy()的行为

仓库的测试文件 test/test.basic.js 第 533-545 行提供了两组针对falsy()的自动化断言，可用于验证上述全部行为：

test('falsy() should return a falsy value', t => { _.times(1000, () => { const value = chance.falsy() t.falsy(value) }) }) test('falsy() should return a falsy value using a pool data', t => { _.times(1000, () => { const value = chance.falsy({pool: [null, undefined]}) t.falsy(value) }) })

两组测试的关键点：

1. 默认池测试：连续执行 1000 次chance.falsy()，每次都断言返回值通过t.falsy(value)判定（即返回的是假值）；
2. 自定义池测试：传入{ pool: [null, undefined] }连续执行 1000 次，同样断言返回值是假值，验证了pool选项确实生效且新池元素均为假值。

从测试规模（每组 1000 次迭代）可以看出，falsy()的随机分布足够稳定，可以放心用于需要大量生成假值数据的场景。如果要在本地复现测试，可在仓库根目录运行测试脚本（具体命令参见 package.json 中的 scripts 配置）。

五、falsy()在 Basics 模块中的定位

在文档导航 docs/README.md 中，falsy()被归类在Basics（基础）板块，与bool、integer、floating、natural、prime、string、template等基础数据类型生成器并列。

它与同板块的 bool 形成天然互补：

• chance.bool()：在true/false两个布尔值之间随机，可通过likelihood调整true的出现概率；
• chance.falsy()：覆盖所有类型的假值（布尔假、空值、零、NaN、空字符串），适合不限定具体类型、只要求"非真值"的场景。

例如，构造一个"必填字段校验"的测试数据时，可以这样组合使用：

const invalidInput = chance.pickone([chance.falsy(), chance.bool({ likelihood: 0 })]); // invalidInput 可能是 false / null / undefined / 0 / NaN / '' 中的任意一个

六、常见应用场景小结

综合原文档与源码，chance.falsy()最典型的应用场景包括：

1. 单元测试的边界输入：把假值作为函数的输入，验证"空值 / 零值 / 缺省值"分支逻辑是否健壮；
2. 表单与参数校验测试：用chance.falsy({ pool: [null, undefined] })模拟"字段缺失"与"字段为空"两类异常提交；
3. 数据清洗与兜底逻辑验证：混合0与''覆盖数值与文本两条取值路径的默认回退行为；
4. 随机测试数据批量生成：结合循环（如测试中的_.times(1000, ...)模式）一次性产出大量假值样本。

总结

chance.falsy()是 Chance.js 中实现最简单、语义最清晰的基础 API 之一：默认从[false, null, 0, NaN, '', undefined]六种假值中随机返回一个，并允许通过pool选项完全替换候选池。其底层实现（chance.js 第 149-157 行）与initOptions默认值合并机制（chance.js 第 78-90 行）共同保证了"开箱即用、自定义灵活"的双重体验，而 test/test.basic.js 中的两组千次迭代测试则为这一行为提供了自动化保障。无论你是为测试框架构造边界数据，还是需要快速产出多样化的假值样本，falsy()都是一个值得常备的工具函数。

• 测试