Array : méthode toReversed()

Baseline Large disponibilité

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2023.

La méthode toReversed() des instances de Array est la version copiante de la méthode reverse(). Elle retourne un nouveau tableau avec les éléments dans l'ordre inversé.

Dans cet article

Syntaxe

toReversed()

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

js
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é.

js
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é.

js
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