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