CKTIS / JavaScript
Array.prototype.toReversed: umgekehrte Kopie
toReversed erzeugt eine umgekehrte flache Kopie, ohne den Empfänger zu ändern, und macht Lücken zu undefined.
Version: ECMAScript 2023; example target: Node.js 24.22.2
Syntax
array.toReversed()array.toReversed() liest die Länge des Empfängers, erstellt ein neues gewöhnliches Array und schreibt die Werte in umgekehrter Reihenfolge. Die Methode hat keine Argumente, ändert array nicht und beachtet Symbol.species nicht; enthaltene Objekte behalten dieselben Referenzen, da die Kopie flach ist.
Anders als reverse() ist das Ergebnis immer dicht: Das Lesen einer Lücke ergibt undefined, anschließend wird in der Kopie eine eigene Eigenschaft mit diesem Wert angelegt. Die Methode ist generisch und arbeitet über length und indizierte Eigenschaften mit array-ähnlichen Werten.
Ein Empfänger null oder undefined löst TypeError aus. Fehler der Längenkonvertierung, von Gettern und Proxy-Traps werden weitergegeben; eine für ein gewöhnliches Array zu große Länge kann RangeError erzeugen. Die Methode wurde in ECMAScript 2023 standardisiert.
Beispiele
const source = [{ id: "a" }, { id: "b" }, { id: "c" }];
const copy = source.toReversed();
console.log(copy.map(item => item.id).join(","));
console.log(source.map(item => item.id).join(","));
console.log(copy !== source, copy[0] === source[2]);
const sparse = [1, , 3];
const dense = sparse.toReversed();
console.log(dense.length, 0 in dense, 1 in dense, 2 in dense, dense[1] === undefined);Ergebnis
c,b,a a,b,c true true 3 true true true true