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 oberflächlich einen Teil dieses typisierten Arrays an eine andere Position im selben typisierten Array und gibt dieses typisierte Array zurück, ohne seine Länge zu verändern. Diese Methode folgt dem gleichen 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 dem 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 aufeinanderfolgende Indizes kopiert.
start: Nullbasierter Index, ab dem das Kopieren der Elemente beginnt, in eine Ganzzahl umgewandelt.
end Optional: Nullbasierter Index, an dem das Kopieren der Elemente endet, in eine Ganzzahl umgewandelt. copyWithin() kopiert bis zu, aber nicht einschließlich, end.

Rückgabewert

Das modifizierte typisierte Array.

Beschreibung

Siehe Array.prototype.copyWithin() für mehr Details. Diese Methode ist nicht generisch und kann nur an typisierten Array-Instanzen aufgerufen 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