Array.prototype.reverse()

Keine.

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

Die reverse()-Methode transponiert die Elemente des aufrufenden Array-Objekts in Ort, verändert das Array und gibt eine Referenz auf das Array zurück.

Die reverse()-Methode bewahrt leere Felder. Wenn das Quellarray dünn besiedelt ist, werden die entsprechenden neuen Indizes der leeren Felder gelöscht und bleiben ebenfalls leere Felder.

Die reverse()-Methode ist generisch. Sie erwartet lediglich, dass der this-Wert eine length-Eigenschaft und ganzzahlige Schlüssel-Eigenschaften hat. Obwohl Zeichenfolgen ebenfalls array-ähnlich sind, ist diese Methode nicht geeignet, auf ihnen angewendet zu werden, da Zeichenfolgen unveränderlich sind.

Im folgenden Beispiel wird ein Array items mit drei Elementen erstellt und dann das Array umgekehrt. 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 das Mutieren 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 mutiert, sondern ein flachkopiertes Array wie andere Array-Methoden (z. B. map()) zurückgibt, verwenden Sie die toReversed()-Methode. Alternativ können Sie eine flache Kopie vor dem Aufruf von reverse() machen, 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

Dünn besiedelte Arrays bleiben nach dem Aufruf von reverse() dünn besiedelt. Leere Felder werden als leere Felder 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 durchläuft dann jede Eigenschaft mit einem ganzzahligen Schlüssel zwischen 0 und length / 2 und vertauscht die beiden entsprechenden Indizes an beiden Enden, indem sie alle Ziel-Eigenschaften löscht, für die die Quell-Eigenschaft nicht vorhanden war.

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()