CKTIS / JavaScript
Array.prototype.toSpliced: cópia alterada sem mutação
toSpliced devolve um novo array após remover e inserir posições escolhidas, sem alterar o recetor.
Versão: ECMAScript 2023; example target: Node.js 24.22.2
Sintaxe
array.toSpliced(start, skipCount?, ...items)array.toSpliced(start, skipCount?, ...items) é a variante por cópia de splice(): cria um novo Array normal, ignora um intervalo, insere items e deixa array inalterado. Um start negativo conta desde o fim; uma posição além do comprimento significa o fim. Com start, omitir skipCount remove a cauda, undefined explícito significa zero e outros valores são limitados ao intervalo disponível.
O resultado é a cópia alterada completa, não um array dos elementos removidos. É superficial, sempre densa e ignora Symbol.species: os espaços vazios tornam-se propriedades próprias com valor undefined. Sem argumentos devolve uma cópia densa.
O método foi normalizado no ECMAScript 2023 e é genérico para valores array-like. Um recetor null ou undefined lança TypeError; um comprimento calculado excessivo produz TypeError ou RangeError, e propagam-se erros de conversão, getters e traps de proxy.
Exemplos
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]);Resultado
build,lint,test,deploy build,test,deploy build,test build,docs,test,deploy 4 true true true true 1 2 undefined 3