Array.prototype.reverse()

Probieren Sie es aus

const array = ["one", "two", "three"];
console.log("array:", array);
// Expected output: "array:" Array ["one", "two", "three"]

const reversed = array.reverse();
console.log("reversed:", reversed);
// Expected output: "reversed:" Array ["three", "two", "one"]

// Careful: reverse is destructive -- it changes the original array.
console.log("array:", array);
// Expected output: "array:" Array ["three", "two", "one"]

Syntax

reverse()

Parameter

Keine.

Rckgabewert

Die Referenz auf das originale, nun umgekehrte Array. Beachten Sie, dass das Array in place umgekehrt wird und keine Kopie erstellt wird.

Beschreibung

Die reverse() Methode vertauscht die Elemente des aufrufenden Array-Objekts in der gleichen Struktur, mutiert das Array und gibt eine Referenz zum Array zurck.

Die reverse() Methode bewahrt leere Stellen. Wenn das Quell-Array sprlich ist, werden die entsprechenden neuen Indizes der leeren Stellen gelscht und bleiben auch leere Stellen.

Die reverse() Methode ist generisch. Sie erwartet nur, dass der this-Wert eine length-Eigenschaft und integer-basierte Eigenschaften hat. Obwohl Strings auch array-hnlich sind, ist diese Methode nicht geeignet, um auf ihnen angewendet zu werden, da Strings unvernderlich sind.

Beispiele

Umkehrung der Elemente in einem Array

Das folgende Beispiel erstellt ein Array items, das drei Elemente enthlt, und kehrt dann das Array um. Der Aufruf von reverse() gibt eine Referenz auf das umgekehrte Array items zurck.

const items = [1, 2, 3];
console.log(items); // [1, 2, 3]

items.reverse();
console.log(items); // [3, 2, 1]

Die reverse() Methode gibt die Referenz auf dasselbe Array zurck

Die reverse() Methode gibt die Referenz auf das Original-Array zurck, sodass eine Mutation des zurckgegebenen Arrays auch das Original-Array verndert.

const numbers = [3, 2, 4, 1, 5];
const reversed = numbers.reverse();
// numbers and reversed are both in reversed order [5, 1, 4, 2, 3]
reversed[0] = 5;
console.log(numbers[0]); // 5

Falls Sie mchten, dass reverse() das Original-Array nicht verndert, sondern ein flachkopiertes Array zurckgibt, wie es andere Array-Methoden (z. B. map()) tun, verwenden Sie die toReversed() Methode. Alternativ knnen Sie eine flache Kopie anfertigen, bevor Sie reverse() aufrufen, indem Sie die Spread-Syntax oder Array.from() verwenden.

const numbers = [3, 2, 4, 1, 5];
// [...numbers] creates a shallow copy, so reverse() does not mutate the original
const reverted = [...numbers].reverse();
reverted[0] = 5;
console.log(numbers[0]); // 3

Verwenden von reverse() bei sprlichen Arrays

Sprliche Arrays bleiben sprlich nach dem Aufruf von reverse(). Leere Stellen werden als leere Stellen an ihre jeweiligen neuen Indizes kopiert.

console.log([1, , 3].reverse()); // [3, empty, 1]
console.log([1, , 3, 4].reverse()); // [4, 3, empty, 1]

Aufruf von reverse() bei Nicht-Array-Objekten

Die reverse() Methode liest die length Eigenschaft dieses Objekts. Sie besucht dann jede Eigenschaft mit einem ganzzahligen Schlssel zwischen 0 und length / 2 und tauscht die zwei entsprechenden Indizes an beiden Enden, wobei sie jede Ziel-Eigenschaft lscht, fr die die Quell-Eigenschaft nicht existierte.

const arrayLike = {
  length: 3,
  unrelated: "foo",
  2: 4,
  3: 33, // ignored by reverse() since length is 3
};
console.log(Array.prototype.reverse.call(arrayLike));
// { 0: 4, 3: 33, length: 3, unrelated: 'foo' }
// The index 2 is deleted because there was no index 0 present originally
// The index 3 is unchanged since the length is 3

Spezifikationen

Browser-Kompatibilitt

Siehe auch

• Polyfill von Array.prototype.reverse in core-js
• es-shims Polyfill von Array.prototype.reverse
• Indizierte Sammlungen Leitfaden
• Array
• Array.prototype.join()
• Array.prototype.sort()
• Array.prototype.toReversed()
• TypedArray.prototype.reverse()