DietoReversed()-Methode vonArray Instanzen ist daskopierende Gegenstück zurreverse()-Methode. Sie gibt ein neues Array mit den Elementen in umgekehrter Reihenfolge zurück.

Syntax

toReversed()

Parameter

Keine.

Rückgabewert

Ein neues Array, das die Elemente in umgekehrter Reihenfolge enthält.

Beschreibung

DietoReversed()-Methode transponiert die Elemente des aufrufenden Array-Objekts in umgekehrter Reihenfolge und gibt ein neues Array zurück.

Wenn sie auflückenhafte Arrays angewendet wird, durchläuft dietoReversed()-Methode leere Plätze, als ob sie den Wertundefined hätten.

DietoReversed()-Methode istgenerisch. Sie erwartet nur, dass derthis-Wert einelength-Eigenschaft und integerindizierte Eigenschaften hat.

Beispiele

Umkehren der Elemente in einem Array

Im folgenden Beispiel wird ein Arrayitems erstellt, das drei Elemente enthält, und dann ein neues Array, das die Umkehrung vonitems darstellt. Dasitems-Array 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]

Verwenden von toReversed() bei lückenhaften Arrays

Der Rückgabewert vontoReversed() ist niemals lückenhaft. Leere Plätze werden zuundefined im zurückgegebenen Array.

console.log([1, , 3].toReversed()); // [3, undefined, 1]console.log([1, , 3, 4].toReversed()); // [4, 3, undefined, 1]

Aufrufen von toReversed() auf Nicht-Array-Objekten

DietoReversed()-Methode liest dielength-Eigenschaft vonthis. Sie besucht dann jede Eigenschaft mit einem Integer-Schlüssel zwischenlength - 1 und0 in absteigender Reihenfolge und fügt den Wert der aktuellen Eigenschaft 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

Browser-Kompatibilität

Siehe auch

• Polyfill vonArray.prototype.toReversed incore-js
• es-shims Polyfill vonArray.prototype.toReversed
• Leitfaden für indizierte Sammlungen
• Array.prototype.reverse()
• Array.prototype.toSorted()
• Array.prototype.toSpliced()
• Array.prototype.with()
• TypedArray.prototype.toReversed()