CKTIS / JavaScript
Array.prototype.toReversed : copie inversée
toReversed crée une copie superficielle inversée sans modifier le receveur et matérialise les trous en undefined.
Version : ECMAScript 2023; example target: Node.js 24.22.2
Syntaxe
array.toReversed()array.toReversed() lit la longueur du receveur, crée un nouvel Array ordinaire et écrit les valeurs dans l’ordre inverse. Elle ne prend aucun argument, ne modifie pas array et ne consulte pas Symbol.species ; les objets éléments gardent les mêmes références, car la copie est superficielle.
Contrairement à reverse(), le résultat est toujours dense : la lecture d’un emplacement vide donne undefined, puis une propriété propre de cette valeur est créée dans la copie. La méthode est générique et utilise length et les propriétés indexées des valeurs array-like.
Un receveur null ou undefined lève TypeError. Les erreurs de conversion de longueur, des getters et des traps de proxy se propagent ; une longueur trop grande pour un Array ordinaire peut produire RangeError. La méthode a été normalisée dans ECMAScript 2023.
Exemples
const source = [{ id: "a" }, { id: "b" }, { id: "c" }];
const copy = source.toReversed();
console.log(copy.map(item => item.id).join(","));
console.log(source.map(item => item.id).join(","));
console.log(copy !== source, copy[0] === source[2]);
const sparse = [1, , 3];
const dense = sparse.toReversed();
console.log(dense.length, 0 in dense, 1 in dense, 2 in dense, dense[1] === undefined);Résultat
c,b,a a,b,c true true 3 true true true true