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
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.
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 :
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