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 Methode copyWithin() von TypedArray-Instanzen kopiert flach einen Teil dieses typisierten Arrays an eine andere Position im selben typisierten Array und gibt dieses typisierte Array zurück, ohne dessen Länge zu ändern. Diese Methode verwendet denselben Algorithmus wie Array.prototype.copyWithin().

Probieren Sie es aus

Syntax

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

Parameter

target

Der nullbasierte Index, an den die Sequenz kopiert wird, in eine Ganzzahl umgewandelt. Dies entspricht der Stelle, an die das Element bei start kopiert wird, und alle Elemente zwischen start und end werden an nachfolgende Indizes kopiert.

start

Der nullbasierte Index, ab dem die Elemente kopiert werden, in eine Ganzzahl umgewandelt.

end Optional

Der nullbasierte Index, bei dem das Kopieren der Elemente endet, in eine Ganzzahl umgewandelt. copyWithin() kopiert bis, aber nicht einschließlich end.

Rückgabewert

Das modifizierte typisierte Array.

Beschreibung

Für weitere Details siehe Array.prototype.copyWithin(). Diese Methode ist nicht generisch und kann nur auf typisierten Array-Instanzen aufgerufen werden.

Beispiele

Verwendung von copyWithin()

js
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 Language Specification
# sec-%typedarray%.prototype.copywithin

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch