如何用 Array.prototype.toSpliced 在不修改原始数据的前提下获取增删元素后的新数组

如何用 Array.prototype.toSpliced 在不修改原始数据的前提下获取增删元素后的新数组

toSpliced 是什么，和 splice 有什么根本区别

简单来说，toSpliced 是 ES2023 引入的一个新数组方法，它的核心价值就体现在“纯函数式”这四个字上：不修改原数组，只返回一个新数组。这恰恰是它与老牌方法 splice 最根本的区别。

要知道，splice 是“就地修改”的典型代表，调用之后，原始数组就被直接改写了。如果还想保留原始数据，开发者就得手动先做一次复制，比如用 slice() 或者展开运算符。这一步看似简单，却很容易被遗忘，或者一不小心就写错。

好消息是，toSpliced 的参数签名和 splice 完全一致，都是 (start, deleteCount, ...items)。但它的行为模式完全不同：它只读取原数组，然后构造并返回一个全新的数组，原数组则毫发无损。

这里有个常见的误区需要警惕：有人会误以为 toSpliced 只是 splice 的一个别名，或者在旧环境（比如 Node.js 的早期版本）中直接使用，这会导致运行时错误。

基础用法：删除、插入、替换元素都靠它

toSpliced 的妙处在于，一个方法就覆盖了三种最常见的数组操作场景，无需再手动组合 filter、concat 和 slice 这些方法：

• 删除：只传前两个参数。例如，arr.toSpliced(2, 1) 表示从索引 2 开始，删除 1 个元素。
• 插入：将 deleteCount 设为 0。例如，arr.toSpliced(1, 0, 'a', 'b') 会在索引 1 的位置之前，插入 ‘a’ 和 ‘b’ 两个新元素。
• 替换：当 deleteCount > 0 并且传入了新增项时，就是替换操作。例如，arr.toSpliced(0, 2, 'x', 'y') 会先删除前两个元素，再插入 ‘x’ 和 ‘y’。

另外，和 splice 一样，toSpliced 也支持负数索引，-1 就表示倒数第一个位置。但有一点不同：deleteCount 参数不能为负数，否则会抛出一个 RangeError。

兼容性与降级方案必须主动处理

必须清醒地认识到，toSpliced 并非在所有环境下都立即可用。Node.js 需要 19.5 及以上版本，浏览器端则要 Safari 16.4+ 才支持。一些旧版的微信 WebView 或特定 Electron 内核也可能缺失这个方法。

因此，绝不能依赖用户的运行环境自动降级。正确的做法是，在代码中明确检查并提供备选方案（fallback）：

const safeToSpliced = (arr, start, deleteCount, ...items) => {
  if (Array.prototype.toSpliced) {
    return arr.toSpliced(start, deleteCount, ...items);
  }
  // 手动模拟：slice + splice 组合，但确保不改原数组
  const result = [...arr];
  result.splice(start, deleteCount, ...items);
  return result;
};

这里有个关键细节：在 fallback 实现里，推荐使用 [...arr] 来创建副本，而不是 arr.slice()。这样做能更好地处理稀疏数组或带有自定义属性的类数组对象，避免意外出错。同时，确保所有的 splice 操作都只作用于这个副本，从而百分之百保证原数组的安全。

性能和边界情况要注意什么

虽然 toSpliced 带来了便利，但它并非“零成本”。其内部仍然需要遍历并拷贝元素，面对大数据量时，性能开销需要考虑。不过，它比手动组合 slice 和 concat 更简洁，也更能减少人为错误。

再来看看几个关键的边界情况：

• 当 start 超出数组范围（比如大于 arr.length）时，它会将新增的 items 追加到新数组的末尾，而不会报错。
• 当 deleteCount 大于从起始位置到末尾的元素数量时，它只会删除到末尾为止，不会引发越界错误。
• 即使是空数组调用，如 [].toSpliced(0, 0, 1)，也能正常返回 [1]。
• 如果原数组被冻结了（即使用了 Object.freeze(arr)），toSpliced 依然可以正常工作，因为它根本不尝试修改原数组。

最后，有一个真正容易被忽略的陷阱：toSpliced 进行的是浅拷贝。如果你删除或操作的是一个对象，那么新数组中对应的对象引用仍然是原来的那个。换句话说，它不负责处理嵌套引用的深拷贝，这部分工作需要开发者另行处理。