跳到正文

我所理解的 JavaScript 最佳实践(25):避免数组空位

我所理解的 JavaScript 最佳实践

  1. 使用现代化工具
  2. 尽量去掉只用一次的中间变量
  3. 遍历的起点决定按 ID 取数的顺序
  4. 不用 reduce
  5. 按遍历任务选择循环和数组方法
  6. 异步遍历按任务依赖选择并发或串行
  7. 卫语句让主流程保持平直
  8. 用函数给可复用的业务规则命名
  9. 让顺序无关的代码按名称排列
  10. 正确写注释
  11. 一行代码只做一件事
  12. 给函数起合适的名字
  13. 用空值合并运算符更好地控制默认值生效逻辑
  14. 用队列串行处理偏好更新,避免修改互相覆盖
  15. 确认弹窗关闭时,让等待中的 Promise 得到结果
  16. 用独立的预期值捕获实现错误
  17. 控制文件行数
  18. 控制函数圈复杂度和认知复杂度
  19. 使用工具函数进行类型判断
  20. 会演进的函数用对象参数
  21. 使用改进的原生 API
  22. 使用模板字符串优化多行文字展示
  23. 用查表取值,用 switch 分派动作
  24. 正确使用纯函数和副作用
  25. 避免数组空位(当前)
  26. 把条件写在可选元素和字段旁边
  27. 让独立条件各自表达

给分页结果补一行时,如果直接写 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() 的返回值是编辑后的副本。如何把计算结果和原地修改分别写清楚,见《正确使用纯函数和副作用》。