WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Array.prototype.reverse: Umkehrung an Ort und Stelle

reverse kehrt die Indexreihenfolge direkt um, erhält Lücken und liefert denselben Empfänger.

Version: ECMAScript 2026 draft; example target: Node.js 24.22.2

Syntax

array.reverse()

array.reverse() vertauscht anhand der Empfängerlänge Eigenschaften paarweise von Anfang und Ende und liefert genau diesen Empfänger. Es mutiert das Array. Bei einem dünn besetzten Array prüft es beide Eigenschaften: Eine Lücke wird durch entsprechendes Löschen verschoben und nicht in ein Element mit dem Wert undefined umgewandelt.

Die Methode nimmt keine Argumente an und ist für veränderliche array-ähnliche Objekte generisch. Länge null oder eins braucht keinen Tausch. null oder undefined als Empfänger löst TypeError aus. Getter, Setter, Proxy, nicht schreibbare oder nicht konfigurierbare Indexeigenschaften können Fehler auslösen; frühere Tausche werden nicht zwingend zurückgerollt, daher kann der Empfänger teilweise umgekehrt bleiben.

Beispiele

const values = [1, 2, 3];
const returned = values.reverse();
console.log(returned === values, values.join(","));
const sparse = [];
sparse.length = 4;
sparse[0] = "a";
sparse[2] = "c";
sparse.reverse();
console.log(sparse.length, Object.keys(sparse).join(","), sparse[1], sparse[3]);
const record = { 0: "x", 2: "z", length: 3 };
Array.prototype.reverse.call(record);
console.log(record[0], record[2], record.length === 3);

Ergebnis

true 3,2,1
4 1,3 c a
z x true

Quellen