Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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

Fonti