TypedArray.prototype.copyWithin()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2016.

Die copyWithin()-Methode von TypedArray-Instanzen kopiert flach einen Teil dieses Typ-Arrays an eine andere Position im selben Typ-Array und gibt dieses Typ-Array zurück, ohne seine Länge zu ändern. Diese Methode verwendet denselben Algorithmus wie Array.prototype.copyWithin().

Probieren Sie es aus

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

// Insert position, start position, end position
uint8.copyWithin(3, 1, 3);

console.log(uint8);
// Expected output: Uint8Array [1, 2, 3, 2, 3, 6, 7, 8]

Syntax

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

Parameter

target: Nullbasierter Index, an den die Sequenz kopiert werden soll, in eine Ganzzahl umgewandelt. Dies entspricht der Position, an die das Element bei start kopiert wird, und alle Elemente zwischen start und end werden an nachfolgende Indizes kopiert.
start: Nullbasierter Index, ab dem das Kopieren der Elemente beginnen soll, in eine Ganzzahl umgewandelt.
end Optional: Nullbasierter Index, an dem das Kopieren der Elemente enden soll, in eine Ganzzahl umgewandelt. copyWithin() kopiert bis, aber nicht einschließlich end.

Rückgabewert

Das modifizierte Typ-Array.

Beschreibung

Weitere Details finden Sie in Array.prototype.copyWithin(). Diese Methode ist nicht generisch und kann nur auf Instanzen von Typ-Arrays angewendet werden.

Beispiele

Verwendung von 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 ]

Spezifikationen

Specification
ECMAScript® 2026 Language Specification # sec-%typedarray%.prototype.copywithin