#Change Array by Copy S4

中文标题：通过复制更改数组

注意 此提案已'完成'并已合并到 ECMAScript 规范中。PR

#通过复制更改数组

在 Array.prototype 和 TypedArray.prototype 上提供额外的方法，通过返回包含更改的新副本来实现对数组的更改。

#状态

此提案目前处于阶段 4。

• 候选规范文本

#支持者

• Robin Ricard (Bloomberg)
• Ashley Claymore (Bloomberg)

#审查者

• Jordan Harband
• Justin Ridgewell
• Sergey Rubanov

#概述

此提案为 Array.prototype 引入了以下函数属性：

• Array.prototype.toReversed() -> Array
• Array.prototype.toSorted(compareFn) -> Array
• Array.prototype.toSpliced(start, deleteCount, ...items) -> Array
• Array.prototype.with(index, value) -> Array

所有这些方法都保持目标数组不变，并返回执行更改后其副本。

toReversed、toSorted 和 with 也将添加到类型化数组：

• TypedArray.prototype.toReversed() -> TypedArray
• TypedArray.prototype.toSorted(compareFn) -> TypedArray
• TypedArray.prototype.with(index, value) -> TypedArray

这些方法随后将可在 TypedArray 的子类上使用。例如：

• Int8Array
• Uint8Array
• Uint8ClampedArray
• Int16Array
• Uint16Array
• Int32Array
• Uint32Array
• Float32Array
• Float64Array
• BigInt64Array
• BigUint64Array

#示例

const sequence = [1, 2, 3];
sequence.toReversed(); // => [3, 2, 1]
sequence; // => [1, 2, 3]

const outOfOrder = new Uint8Array([3, 1, 2]);
outOfOrder.toSorted(); // => Uint8Array [1, 2, 3]
outOfOrder; // => Uint8Array [3, 1, 2]

const correctionNeeded = [1, 1, 3];
correctionNeeded.with(1, 2); // => [1, 2, 3]
correctionNeeded; // => [1, 1, 3]

#动机

Tuple.prototype 引入了这些函数作为处理 Record & Tuple 中元组不可变性的方式。虽然数组本质上不是不可变的，但这种编程风格可能对处理冻结数组的用户有益。

此提案尤其使得编写能够交替处理数组和元组的代码变得更加容易。

#与 Record & Tuple 的关系

虽然此提案源自 Record & Tuple，但应独立推进。

如果 Web 兼容性要求如此，此提案中定义的属性名称将被更改。这些更改应反映在 Tuple.prototype 上。

#实现

• Firefox/SpiderMonkey，自 Firefox 115 起无需标志即可使用

• Safari/JavaScriptCore，自 Safari 技术预览版 146 起无需标志即可使用

• Chrome/V8，自 Chrome 110 起无需标志即可使用

• Ladybird/LibJS，无需标志即可使用

• core-js

  • change-array-by-copy

• es-shims：

  • array.prototype.tosorted
  • array.prototype.toreversed
  • array.prototype.tospliced
  • array.prototype.with

• ./polyfill.js（极简参考实现）