Array.prototype.reverse()
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