Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Array.prototype.reverse : inversion sur place

reverse inverse l’ordre des indices sur place, conserve les trous et renvoie le même objet.

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

Syntaxe

array.reverse()

array.reverse() échange les propriétés par paires depuis le début et la fin selon la longueur du receveur, puis renvoie exactement ce receveur. La méthode modifie le tableau. Pour un tableau creux, elle teste l’existence des deux propriétés : un trou est déplacé par la suppression correspondante plutôt que converti en élément de valeur undefined.

La méthode ne prend aucun argument et est générique pour les objets array-like modifiables. Une longueur zéro ou un ne demande aucun échange. Un receveur null ou undefined lève TypeError. Getter, setter, Proxy, propriété non inscriptible ou indice non configurable peut lever une erreur ; les échanges antérieurs ne sont pas forcément annulés et le receveur peut rester partiellement inversé.

Exemples

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

Résultat

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

Sources