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 zwischenstart
undend
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 |