CKTIS / JavaScript
Array.prototype.toReversed: copia invertita
toReversed crea una copia superficiale invertita senza modificare il ricevente e trasforma i vuoti in undefined.
Versione: ECMAScript 2023; example target: Node.js 24.22.2
Sintassi
array.toReversed()array.toReversed() legge la lunghezza del ricevente, crea un nuovo Array ordinario e scrive i valori in ordine inverso. Non accetta argomenti, non cambia array e non consulta Symbol.species; gli oggetti contenuti mantengono gli stessi riferimenti perché la copia è superficiale.
A differenza di reverse(), il risultato è sempre denso: leggere uno slot vuoto produce undefined, poi nella copia viene creata una proprietà propria con tale valore. Il metodo è generico e opera su valori array-like tramite length e proprietà indicizzate.
Un ricevente null o undefined genera TypeError. Si propagano errori di conversione della lunghezza, getter e trap di proxy; una lunghezza eccessiva per un Array ordinario può produrre RangeError. Il metodo è stato standardizzato in ECMAScript 2023.
Esempi
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);Risultato
c,b,a a,b,c true true 3 true true true true