Array : méthode toReversed()

Syntaxe

toReversed()

Paramètres

Aucun.

Valeur de retour

Un nouveau tableau contenant les éléments dans l'ordre inversé.

Description

La méthode toReversed() retourne un nouveau tableau dont les éléments sont dans l'ordre inverse de celui du tableau d'origine.

Lorsqu'elle est utilisée sur un tableau creux, la méthode toReversed() parcourt les cases vides comme si elles avaient la valeur undefined.

La méthode toReversed() est générique. Elle attend seulement que la valeur de this possède une propriété length et des propriétés à clés entières.

Exemples

Inversion des éléments d'un tableau

L'exemple suivant crée un tableau items contenant trois éléments, puis crée un nouveau tableau qui est l'inverse de items. Le tableau items reste inchangé.

const items = [1, 2, 3];
console.log(items); // [1, 2, 3]

const reversedItems = items.toReversed();
console.log(reversedItems); // [3, 2, 1]
console.log(items); // [1, 2, 3]

Utilisation de toReversed() sur un tableau creux

La valeur de retour de toReversed() n'est jamais un tableau creux. Les cases vides deviennent undefined dans le tableau retourné.

console.log([1, , 3].toReversed()); // [3, undefined, 1]
console.log([1, , 3, 4].toReversed()); // [4, 3, undefined, 1]

Appeler toReversed() sur un objet qui n'est pas un tableau

La méthode toReversed() lit la propriété length de this. Elle parcourt ensuite chaque propriété dont la clé est un entier compris entre length - 1 et 0 (ordre décroissant), et ajoute la valeur de chaque propriété à la fin du tableau retourné.

const objetSimilaireTableau = {
  length: 3,
  unrelated: "foo",
  2: 4,
};
console.log(Array.prototype.toReversed.call(objetSimilaireTableau));
// [4, undefined, undefined]
// Les indices '0' et '1' ne sont pas présents donc deviennent undefined

Spécifications

Compatibilité des navigateurs

Voir aussi

• Guide des collections indexées
• La méthode Array.prototype.reverse()
• La méthode Array.prototype.toSorted()
• La méthode Array.prototype.toSpliced()
• La méthode Array.prototype.with()
• La méthode TypedArray.prototype.toReversed()
• Prothèse d'émulation de Array.prototype.toReversed dans core-js ^(angl.)
• Prothèse d'émulation es-shims de Array.prototype.toReversed ^(angl.)