我所理解的 JavaScript 最佳实践(25):避免数组空位
- 使用现代化工具
- 尽量去掉只用一次的中间变量
- 遍历的起点决定按 ID 取数的顺序
- 不用 reduce
- 按遍历任务选择循环和数组方法
- 异步遍历按任务依赖选择并发或串行
- 卫语句让主流程保持平直
- 用函数给可复用的业务规则命名
- 让顺序无关的代码按名称排列
- 正确写注释
- 一行代码只做一件事
- 给函数起合适的名字
- 用空值合并运算符更好地控制默认值生效逻辑
- 用队列串行处理偏好更新,避免修改互相覆盖
- 确认弹窗关闭时,让等待中的 Promise 得到结果
- 用独立的预期值捕获实现错误
- 控制文件行数
- 控制函数圈复杂度和认知复杂度
- 使用工具函数进行类型判断
- 会演进的函数用对象参数
- 使用改进的原生 API
- 使用模板字符串优化多行文字展示
- 用查表取值,用 switch 分派动作
- 正确使用纯函数和副作用
- 避免数组空位(当前)
- 把条件写在可选元素和字段旁边
- 让独立条件各自表达
给分页结果补一行时,如果直接写 rows[3] = row,而原数组只有一项,rows.length 会变成 4,中间两个位置却没有元素。用下标读取会得到 undefined,用 map() 处理时,这两个位置的回调一次也不会执行。同一份数据换个遍历方法,就可能得到不同的结果。
我会让业务数组的每个位置都有值。确实需要表达「这个位置没有记录」时,可以显式写入 null 或按接口约定使用 undefined。只需要按编号存取少量记录时,用 Map 保存已有的条目。
空位会改变遍历行为
数组空位(也叫空槽)指的是索引落在 length 范围内,但数组没有该索引的自有属性。对于普通数组,下面两份数据的长度相同,直接读取下标也得到相同的值。用 Object.hasOwn() 可以看到属性是否真的存在。
const sparse = ['A', , 'C'];
const dense = ['A', undefined, 'C'];
console.log(sparse[1], dense[1]); // undefined undefined
console.log(Object.hasOwn(sparse, 1), Object.hasOwn(dense, 1)); // false true
console.log(sparse.map(() => 1).join(',')); // '1,,1'
console.log(dense.map(() => 1).join(',')); // '1,1,1'
map() 跳过空位并在结果中保留它,for…of 和数组展开则逐个读取索引,读到空位时得到 undefined。因此 [...sparse] 的下标 1 已经有一个实际元素。校验时直接对源数组调用 every() 也会跳过空位,若要断言没有空位,应遍历从 0 到 length - 1 的索引,逐个检查 Object.hasOwn()。这些方法的行为可以对照 MDN 的稀疏数组说明逐一验证。
从数据来源和写入方式保证稠密
按 RFC 8259 的数组语法,合法 JSON 数组的每个位置都要有值。["A",null,"C"] 可以直接解析,中间的 null 是实际元素。如果用 JSON.parse() 的 reviver 转换输入,回调对某个数组元素返回 undefined 会删除该索引。要移除不需要的记录,可以先正常解析,再用 filter() 取得连续的列表。
自己生成数据时,知道长度就用 Array.from() 逐项初始化,不知道长度就从空数组开始,用 push() 追加。单参数的 Array(3) 会生成三个空位,再调用 map() 也无法用回调填上它们。
const skipped = Array(3).map((_, index) => index + 1);
const initialized = Array.from({ length: 3 }, (_, index) => index + 1);
console.log(Object.keys(skipped)); // []
console.log(initialized); // [1, 2, 3]
后续写入也要遵守同一个约定。要移除一项并让后面的元素前移,用 splice(index, 1) 或按需求生成过滤后的新数组。要保留下标并清空该项,显式赋成约定的空值。要追加记录,用 push()。赋值的索引大于当前 length,或直接把 length 调大,都会留下空位。把 length 调小只会截断末尾。
用 lint 拦住容易认出来的写法
| 检查 | 能发现的写法 | 适用范围 |
|---|---|---|
ESLint no-sparse-arrays |
['A', , 'C'] |
@eslint/js 推荐集已包含它,检测数组字面量。 |
typescript-eslint no-array-delete |
delete rows[index] |
需要类型信息识别数组。若原下标有业务含义,先决定是显式清空这一项,还是移除并移动后续项。 |
Unicorn 79 no-new-array |
new Array(3) |
单参数 new Array(…) 会被检查,普通调用 Array(3) 仍会通过。ESLint 的 no-array-constructor 则保留了单参数构造的例外。 |
Biome noSparseArray |
['A', , 'C'] |
同样检查字面量。把空位改成显式 undefined 是会改变行为的修复,Biome 将它标为 unsafe。 |
团队可以用 ESLint no-restricted-syntax 明确约束直接写出的 Array(n) 和 new Array(n)。同样形状的代码也可能在构造单元素数组,或紧接着调用 .fill(),因此这种限制适合明确统一构造方式的目录。变量索引是否跳号、length 是否真的增大,以及 reviver 是否删除某项,要结合运行时的值判断。
稀疏数组用下标读取和遍历时可能得到不同结果,这比性能差异更直接。JavaScript Standard Style 默认禁止稀疏字面量,typescript-eslint 的遍历规则文档也建议避免稀疏数组。V8 的元素类型说明还解释了引擎优化上的差异,并指出真实应用里通常很难测到这部分影响。
迁移到复制式数组方法时先看调用点
sort() 会把空位移到末尾,reverse() 会把空位移到相应的反转位置。相同输入换成 toSorted() 或 toReversed(),结果数组会在相应位置存入实际的 undefined。toSpliced() 也会把保留下来的空位读成 undefined 后写入新数组。这些方法的索引读写行为见 ECMAScript 的 Array 方法规范。
如果数组来自普通 JSON 解析或逐项初始化,且到调用点之前的写入都保持稠密,就可以排除这类空位差异。接着确认谁持有原数组,以及调用方用的是什么结果。例如 const alias = rows.reverse() 会让 alias 和 rows 指向同一个已反转的数组,改用 toReversed() 后两者指向不同数组。splice() 的返回值是删除项,toSpliced() 的返回值是编辑后的副本。如何把计算结果和原地修改分别写清楚,见《正确使用纯函数和副作用》。