Array.prototype.toReversed()

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2023 browserübergreifend verfügbar.

Die toReversed()-Methode von Array Instanzen ist das kopierende Gegenstück zur reverse()-Methode. Sie gibt ein neues Array mit den Elementen in umgekehrter Reihenfolge zurück.

In diesem Artikel

Syntax

toReversed()

Rückgabewert

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

Beschreibung

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

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

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 enthält, und dann ein neues Array, das die Umkehrung von items darstellt. Das items-Array bleibt unverändert.

js
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 von toReversed() ist niemals lückenhaft. Leere Plätze werden zu undefined im zurückgegebenen Array.

js
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-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.

js
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

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

Eingebaute Standardobjekte
Array
Konstruktor
1. Array()
Statische Methoden
Statische Eigenschaften
1. [Symbol.species]
Instanzmethoden
Instanzeigenschaften
1. length
2. [Symbol.unscopables]
Vererbung
Object/Function
Statische Methoden
Statische Eigenschaften
Instanzmethoden
Instanzeigenschaften
1. __proto__
2. constructor