Array.prototype.toReversed()

Keine.

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

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

Wenn sie auf dünn besetzte Arrays angewendet wird, iteriert die toReversed()-Methode über leere Felder, als hätten sie den Wert undefined.

Die toReversed()-Methode ist generisch. Sie erwartet nur, dass der this-Wert über eine length-Eigenschaft und integer-beschlüsselte Eigenschaften verfügt.

Das folgende Beispiel erstellt ein Array items, das drei Elemente enthält, und 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 dünn besetzt. Leere Felder werden zu undefined im zurückgegebenen Array.

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 ganzzahligen Schlüssel zwischen length - 1 und 0 in absteigender Reihenfolge und fügt den Wert der aktuellen Eigenschaft an das 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
• Leitfaden zu indizierten Sammlungen
• Array.prototype.reverse()
• Array.prototype.toSorted()
• Array.prototype.toSpliced()
• Array.prototype.with()
• TypedArray.prototype.toReversed()