数组实例的 copyWithin()

数组实例的copyWithin()方法，在当前数组内部，将指定位置的成员复制到其他位置（会覆盖原有成员），然后返回当前数组。也就是说，使用这个方法，会修改当前数组。

  1. Array.prototype.copyWithin(target, start = 0, end = this.length)

它接受三个参数。

  • target（必需）：从该位置开始替换数据。如果为负值，表示倒数。
  • start（可选）：从该位置开始读取数据，默认为 0。如果为负值，表示从末尾开始计算。
  • end（可选）：到该位置前停止读取数据，默认等于数组长度。如果为负值，表示从末尾开始计算。

这三个参数都应该是数值，如果不是，会自动转为数值。

  1. [1, 2, 3, 4, 5].copyWithin(0, 3)
  2. // [4, 5, 3, 4, 5]

上面代码表示将从 3 号位直到数组结束的成员（4 和 5），复制到从 0 号位开始的位置，结果覆盖了原来的 1 和 2。

下面是更多例子。

  1. // 将3号位复制到0号位
  2. [1, 2, 3, 4, 5].copyWithin(0, 3, 4)
  3. // [4, 2, 3, 4, 5]
  5. // -2相当于3号位，-1相当于4号位
  6. [1, 2, 3, 4, 5].copyWithin(0, -2, -1)
  7. // [4, 2, 3, 4, 5]
  9. // 将3号位复制到0号位
  10. [].copyWithin.call({length: 5, 3: 1}, 0, 3)
  11. // {0: 1, 3: 1, length: 5}
  13. // 将2号位到数组结束，复制到0号位
  14. let i32a = new Int32Array([1, 2, 3, 4, 5]);
  15. i32a.copyWithin(0, 2);
  16. // Int32Array [3, 4, 5, 4, 5]
  18. // 对于没有部署 TypedArray 的 copyWithin 方法的平台
  19. // 需要采用下面的写法
  20. [].copyWithin.call(new Int32Array([1, 2, 3, 4, 5]), 0, 3, 4);
  21. // Int32Array [4, 2, 3, 4, 5]