Array.prototype.toReversed()
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2023 browserübergreifend verfügbar.
Die Methode toReversed() von Array-Instanzen ist das kopierende Gegenstück zur Methode reverse(). Sie gibt ein neues Array zurück, dessen Elemente in umgekehrter Reihenfolge angeordnet sind.
Syntax
toReversed()
Parameter
Keine.
Rückgabewert
Ein neues Array mit den Elementen in umgekehrter Reihenfolge.
Beschreibung
Die Methode toReversed() ordnet die Elemente des aufrufenden Array-Objekts in umgekehrter Reihenfolge an und gibt ein neues Array zurück.
Bei Arrays mit Lücken behandelt die Methode toReversed() leere Positionen so, als hätten sie den Wert undefined.
Die Methode toReversed() ist generisch. Sie setzt lediglich voraus, dass der this-Wert eine length-Eigenschaft und Eigenschaften mit ganzzahligen Schlüsseln besitzt.
Beispiele
Elemente eines Arrays umkehren
Das folgende Beispiel erstellt ein Array items mit drei Elementen und anschließend ein neues Array, dessen Elemente gegenüber items in umgekehrter Reihenfolge angeordnet sind. Das Array items bleibt unverändert.
const items = [1, 2, 3];
console.log(items); // [1, 2, 3]
const reversedItems = items.toReversed();
console.log(reversedItems); // [3, 2, 1]
console.log(items); // [1, 2, 3]
toReversed() bei Arrays mit Lücken verwenden
Der Rückgabewert von toReversed() enthält niemals Lücken. Leere Positionen werden im zurückgegebenen Array zu undefined.
console.log([1, , 3].toReversed()); // [3, undefined, 1]
console.log([1, , 3, 4].toReversed()); // [4, 3, undefined, 1]
toReversed() für Objekte aufrufen, die keine Arrays sind
Die Methode toReversed() liest die length-Eigenschaft von this. Anschließend besucht sie in absteigender Reihenfolge jede Eigenschaft mit einem ganzzahligen Schlüssel zwischen length - 1 und 0 und fügt deren Wert am Ende des zurückzugebenden Arrays hinzu.
const arrayLike = {
length: 3,
unrelated: "foo",
2: 4,
};
console.log(Array.prototype.toReversed.call(arrayLike));
// [4, undefined, undefined]
// The '0' and '1' indices are not present so they become undefined
Spezifikationen
| Spezifikation |
|---|
| ECMAScript® 2027 Language Specification # sec-array.prototype.toreversed |