CKTIS / JavaScript
Array.prototype.toReversed: cópia invertida
toReversed cria uma cópia superficial invertida sem alterar o recetor e materializa espaços vazios como undefined.
Versão: ECMAScript 2023; example target: Node.js 24.22.2
Sintaxe
array.toReversed()array.toReversed() lê o comprimento do recetor, cria um novo Array normal e escreve os valores pela ordem inversa. Não recebe argumentos, não altera array nem consulta Symbol.species; os objetos dos elementos mantêm as mesmas referências porque a cópia é superficial.
Ao contrário de reverse(), o resultado é sempre denso: ler um espaço vazio produz undefined e depois é criada na cópia uma propriedade própria com esse valor. O método é genérico e trabalha com valores array-like através de length e propriedades indexadas.
Um recetor null ou undefined lança TypeError. Propagam-se erros da conversão do comprimento, getters e traps de proxy; um comprimento demasiado grande para um Array normal pode produzir RangeError. O método foi normalizado no ECMAScript 2023.
Exemplos
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);Resultado
c,b,a a,b,c true true 3 true true true true