Array.prototype.toReversed()

Keine.

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

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

Bei Verwendung auf sparse arrays durchläuft die Methode toReversed() leere Stellen, als ob sie den Wert undefined hätten.

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

Das folgende Beispiel erstellt ein Array items mit drei Elementen und dann ein neues Array, das die umgekehrte Version von items ist. Das items-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]

Der Rückgabewert von toReversed() ist niemals sparse. Leere Stellen 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]

Die toReversed() Methode liest die length-Eigenschaft von this. Sie besucht dann jede Eigenschaft mit einem integer-indexierten Schlüssel zwischen length - 1 und 0 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

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