Array.prototype.toReversed()

Keine.

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

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

Wenn die Methode auf lückenhafte Arrays angewendet wird, durchläuft die toReversed()-Methode leere Steckplätze, als ob sie den Wert undefined hätten.

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

Das folgende Beispiel erstellt ein Array items, das drei Elemente enthält, und erstellt dann ein neues Array, das die umgekehrte Reihenfolge 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 lückenhaft. Leere Steckplätze 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-basierten Schlüssel zwischen length - 1 und 0 in absteigender Reihenfolge, wobei der Wert der aktuellen Eigenschaft am Ende des zurückzugebenden Arrays hinzugefügt wird.

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
• Leitfaden für indizierte Sammlungen
• Array.prototype.reverse()
• Array.prototype.toSorted()
• Array.prototype.toSpliced()
• Array.prototype.with()
• TypedArray.prototype.toReversed()