CKTIS / JavaScript
Array.prototype.splice: rimuovere, sostituire e inserire
splice modifica un array nella posizione scelta, ne sposta la coda e restituisce un nuovo array degli elementi rimossi.
Versione: ECMAScript 2026 draft; example target: Node.js 24.22.2
Sintassi
array.splice(start, deleteCount?, ...items)array.splice(start, deleteCount?, ...items) cambia array sul posto e restituisce un nuovo array con gli elementi rimossi. start è convertito in intero: un valore negativo conta dalla fine, mentre una posizione oltre la lunghezza indica la fine. Se start è presente ma deleteCount è omesso, elimina tutta la coda; passare esplicitamente undefined significa zero. Gli altri valori sono limitati tra zero e gli elementi restanti. items sono inseriti prima della coda spostata.
La lunghezza del risultato equivale alle posizioni rimosse e i vuoti corrispondenti restano vuoti. Il ricevente può crescere, ridursi o mantenere la lunghezza; splice() senza argomenti non rimuove nulla. Per sottoclassi di Array la creazione del risultato rispetta Symbol.species.
Il metodo è generico per oggetti array-like mutabili: legge length, copia o elimina proprietà indicizzate e scrive la nuova lunghezza. Può generare TypeError se scrittura, eliminazione o length sono vietate, oppure se la nuova lunghezza supererebbe 2^53 - 1; si propagano errori di conversione, accessori, trap di proxy e costruttore species.
Esempi
const queue = ["build", "test", "deploy"];
const removed = queue.splice(1, 1, "lint", "test");
console.log(removed.join(","));
console.log(queue.join(","));
const tail = queue.splice(-2);
console.log(tail.join(","));
console.log(queue.join(","));
const none = queue.splice(1, undefined, "docs");
console.log(none.length, queue.join(","));
const sparse = [, "b", "c"];
const cut = sparse.splice(0, 2);
console.log(cut.length, 0 in cut, 1 in cut, cut[1], sparse.join(","));Risultato
test build,lint,test,deploy test,deploy build,lint 0 build,docs,lint 2 false true b c