Array.prototype.reverse()

Keine.

Die Referenz auf das ursprüngliche Array, jetzt umgekehrt. Beachten Sie, dass das Array in place umgekehrt wird und keine Kopie erstellt wird.

Die reverse()-Methode vertauscht die Elemente des aufrufenden Array-Objekts direkt, mutiert das Array und gibt eine Referenz auf das Array zurück.

Die reverse()-Methode behält leere Slots bei. Wenn das Quellarray sparse ist, werden die entsprechenden neuen Indizes der leeren Slots gelöscht und auch zu leeren Slots.

Die reverse()-Methode ist generisch. Sie erwartet nur, dass der this-Wert eine length-Eigenschaft und ganzzahlig indizierte Eigenschaften hat. Obwohl Strings ebenfalls array-ähnlich sind, ist diese Methode nicht geeignet, um auf sie angewendet zu werden, da Strings unveränderlich sind.

Das folgende Beispiel erstellt ein Array items, das drei Elemente enthält, und kehrt dann das Array um. Der Aufruf von reverse() gibt eine Referenz auf das umgekehrte Array items zurück.

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 das ursprüngliche Array zurück, sodass eine Veränderung des zurückgegebenen Arrays auch das ursprüngliche Array verändert.

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 möchten, dass reverse() das ursprüngliche Array nicht verändert, sondern ein flach kopiertes Array wie andere Array-Methoden (z.B. map()) zurückgibt, verwenden Sie die toReversed()-Methode. Alternativ können Sie vor dem Aufruf von reverse() eine flache Kopie mittels der Spread-Syntax oder Array.from() erstellen.

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

Sparse Arrays bleiben sparse, nachdem reverse() aufgerufen wurde. Leere Slots werden als leere Slots auf ihre jeweiligen neuen Indizes kopiert.

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

Die reverse()-Methode liest die length-Eigenschaft von this. Sie durchsucht dann jede Eigenschaft mit einem ganzzahligen Schlüssel zwischen 0 und length / 2 und vertauscht die zwei entsprechenden Indizes an beiden Enden, wobei jede Zieleigenschaft gelöscht wird, für 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

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