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 typisierten Arrays an eine andere Stelle im selben typisierten Array und gibt dieses zurück, ohne seine Länge zu ändern. Diese Methode verwendet den 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 den die Sequenz kopiert werden soll, in eine ganze Zahl umgewandelt. Dies entspricht dem Ort, an den das Element bei start kopiert wird, und alle Elemente zwischen start und end werden auf die nachfolgenden Indizes kopiert.
start: Nullbasierter Index, ab dem begonnen wird, Elemente zu kopieren, in eine ganze Zahl umgewandelt.
end Optional: Nullbasierter Index, an dem das Kopieren der Elemente endet, in eine ganze Zahl umgewandelt. copyWithin() kopiert bis zu, aber nicht einschließlich end.

Rückgabewert

Das modifizierte typisierte Array.

Beschreibung

Weitere Details finden Sie unter Array.prototype.copyWithin(). Diese Methode ist nicht generisch und kann nur auf 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