Array.prototype.toReversed()

Syntax

toReversed()

Parameter

Keine.

Rckgabewert

Ein neues Array, das die Elemente in umgekehrter Reihenfolge enthlt.

Beschreibung

Die toReversed()-Methode transponiert die Elemente des aufrufenden Array-Objekts in umgekehrter Reihenfolge und gibt ein neues Array zurck.

Wenn sie auf lckenhafte Arrays angewendet wird, durchluft die toReversed()-Methode leere Pltze, als ob sie den Wert undefined htten.

Die toReversed()-Methode ist generisch. Sie erwartet nur, dass der this-Wert eine length-Eigenschaft und integerindizierte Eigenschaften hat.

Beispiele

Umkehren der Elemente in einem Array

Im folgenden Beispiel wird ein Array items erstellt, das drei Elemente enthlt, und dann ein neues Array, das die Umkehrung von items darstellt. Das items-Array bleibt unverndert.

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 lckenhaften Arrays

Der Rckgabewert von toReversed() ist niemals lckenhaft. Leere Pltze werden zu undefined im zurckgegebenen 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

Die toReversed()-Methode liest die length-Eigenschaft von this. Sie besucht dann jede Eigenschaft mit einem Integer-Schlssel zwischen length - 1 und 0 in absteigender Reihenfolge und fgt den Wert der aktuellen Eigenschaft am Ende des zurckzugebenden 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-Kompatibilitt

Siehe auch

• Polyfill von Array.prototype.toReversed in core-js
• es-shims Polyfill von Array.prototype.toReversed
• Leitfaden fr indizierte Sammlungen
• Array.prototype.reverse()
• Array.prototype.toSorted()
• Array.prototype.toSpliced()
• Array.prototype.with()
• TypedArray.prototype.toReversed()