TypedArray.prototype.copyWithin()

試してみましょう

const uint8 = new Uint8Array([1, 2, 3, 4, 5, 6, 7, 8]);

// 挿入位置、開始位置、終了位置
uint8.copyWithin(3, 1, 3);

console.log(uint8);
// 予想される結果: Uint8Array [1, 2, 3, 2, 3, 6, 7, 8]

構文

copyWithin(target, start)
copyWithin(target, start, end)

引数

target

並びのコピー先となるゼロ基点のインデックスで、整数に変換されます。これは start にある要素がコピーされる場所に対応し、start から end までのすべての要素が後続のインデックスにコピーされます。

start

コピー元でコピーを始める位置のゼロ基点のインデックスで、整数に変換されます。

end 省略可

コピー元でコピーを終える位置のゼロ基点のインデックスで、整数に変換されます。 copyWithin() はここまでをコピーしますが、 end は含みません。

返値

変更された型付き配列です。

解説

詳細については、 Array.prototype.copyWithin() をご覧ください。このメソッドは汎用的ではなく、型付き配列インスタンスに対してのみ呼び出すことができます。

例

copyWithin() の使用

const buffer = new ArrayBuffer(8);
const uint8 = new Uint8Array(buffer);
uint8.set([1, 2, 3]);
console.log(uint8); // Uint8Array [ 1, 2, 3, 0, 0, 0, 0, 0 ]
uint8.copyWithin(3, 0, 3);
console.log(uint8); // Uint8Array [ 1, 2, 3, 1, 2, 3, 0, 0 ]

仕様書

ブラウザーの互換性

関連情報

• TypedArray.prototype.copyWithin のポリフィル (core-js)
• JavaScript の型付き配列ガイド
• TypedArray
• Array.prototype.copyWithin()