WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Array.prototype.copyWithin: Bereich im selben Array kopieren

copyWithin kopiert Elemente innerhalb desselben Empfängers, behält die Länge und behandelt Überlappungen sicher.

Version: ECMAScript 2026 draft; example target: Node.js 24.22.2

Syntax

array.copyWithin(target, start[, end])

array.copyWithin(target, start[, end]) mutiert den Empfänger und gibt genau dieses Objekt zurück. Es kopiert [start, end) nach target; negative Indizes zählen vom Ende, Bruchteile werden abgeschnitten. Die Länge bleibt gleich.

Wie memmove wählt der Algorithmus die Kopierrichtung, sodass Überlappungen benötigte Werte nicht zerstören. Eine Quelllücke löscht die Ziel-Eigenschaft. Die Methode ist für beschreibbare array-ähnliche Objekte generisch; schreibgeschützte Eigenschaften oder Proxyfehler können TypeError auslösen. Das Beispiel kopiert das Ende in die Mitte.

Beispiele

const values = [1, 2, 3, 4, 5];
const returned = values.copyWithin(1, 3);
console.log(values.join(","));
console.log(returned === values, values.length);

Ergebnis

1,4,5,4,5
true 5

Quellen