Array.prototype.reverse()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

La méthode reverse() transpose les éléments d'un tableau : le premier élément devient le dernier et le dernier devient le premier et ainsi de suite.

Exemple interactif

Syntaxe

js
arr.reverse();

Valeur de retour

Le tableau inversé.

Description

La méthode reverse() permet d'inverser l'ordre des éléments du tableau. La méthode modifie le tableau courant et renvoie une référence à ce tableau.

Cette méthode est intentionnellement générique et peut être appelée (via Function.call()) ou appliquée (via Function.apply()) sur des objets semblables à des tableaux. Les objets qui ne contiennent pas de propriété length qui soit cohérente avec leurs propriétés indexées sur des nombres ne seront pas traités par reverse().

Exemples

Inverser l'ordre des éléments d'un tableau

L'exemple qui suit crée un tableau monArray, qui contient trois éléments, puis inverse celui-ci.

js
var monArray = ["un", "deux", "trois"];
monArray.reverse();

console.log(monArray); // ["trois", "deux", "un"]

Inverser l'ordre des éléments d'un objet semblable à un tableau

Dans l'exemple suivant, on crée un objet semblable à un tableau a qui contient trois éléments et une propriété length. On appelle ensuite reverse() grâce à call() sur cet objet pour inverser ses éléments :

js
const a = { 0: 1, 1: 2, 2: 3, length: 3 };

console.log(a); // {0: 1, 1: 2, 2: 3, length: 3}

Array.prototype.reverse.call(a); // On aurait pu utiliser apply() également

console.log(a); // {0: 3, 1: 2, 2 : 1, length: 3}

Spécifications

Specification
ECMAScript Language Specification
# sec-array.prototype.reverse

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi