Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Array.prototype.toSpliced: copia modificata senza mutazione

toSpliced restituisce un nuovo array dopo rimozioni e inserimenti selezionati, lasciando invariato il ricevente.

Versione: ECMAScript 2023; example target: Node.js 24.22.2

Sintassi

array.toSpliced(start, skipCount?, ...items)

array.toSpliced(start, skipCount?, ...items) è la variante con copia di splice(): crea un nuovo Array ordinario, salta un intervallo, inserisce items e lascia invariato array. Un start negativo conta dalla fine; una posizione oltre la lunghezza indica la fine. Con start, omettere skipCount rimuove la coda, undefined esplicito significa zero e gli altri valori sono limitati all’intervallo disponibile.

Il risultato è l’intera copia modificata, non un array degli elementi rimossi. È superficiale, sempre densa e ignora Symbol.species: i vuoti diventano proprietà proprie con valore undefined. Senza argomenti restituisce una copia densa.

Il metodo è stato standardizzato in ECMAScript 2023 ed è generico per valori array-like. Un ricevente null o undefined genera TypeError; una lunghezza calcolata eccessiva produce TypeError o RangeError, mentre si propagano errori di conversione, getter e trap di proxy.

Esempi

const source = ["build", "test", "deploy"];
const changed = source.toSpliced(1, 1, "lint", "test");
console.log(changed.join(","));
console.log(source.join(","));
console.log(source.toSpliced(-1).join(","));
console.log(source.toSpliced(1, undefined, "docs").join(","));

const dense = [1, , 3].toSpliced(1, 0, 2);
console.log(dense.length, 0 in dense, 1 in dense, 2 in dense, 3 in dense);
console.log(dense[0], dense[1], String(dense[2]), dense[3]);

Risultato

build,lint,test,deploy
build,test,deploy
build,test
build,docs,test,deploy
4 true true true true
1 2 undefined 3

Fonti