CKTIS / JavaScript
Array.prototype.splice: verwijderen, vervangen en invoegen
splice muteert een array op een gekozen positie, verschuift het vervolg en retourneert een nieuwe array met verwijderde elementen.
Versie: ECMAScript 2026 draft; example target: Node.js 24.22.2
Syntax
array.splice(start, deleteCount?, ...items)array.splice(start, deleteCount?, ...items) wijzigt array zelf en retourneert een nieuwe array met de verwijderde elementen. start wordt naar een geheel getal omgezet: een negatieve waarde telt vanaf het einde en een positie voorbij de lengte betekent het einde. Als start is gegeven maar deleteCount ontbreekt, wordt het hele vervolg verwijderd; expliciet undefined betekent nul. Andere waarden worden begrensd van nul tot het resterende aantal. items worden vóór het verschoven vervolg ingevoegd.
De resultaatlengte is gelijk aan het aantal verwijderde posities en bijbehorende gaten blijven gaten. De ontvanger kan groeien, krimpen of even lang blijven; splice() zonder argumenten verwijdert niets. Bij Array-subklassen respecteert de resultaatcreatie Symbol.species.
De methode is generiek voor muteerbare array-achtige objecten: ze leest length, kopieert of verwijdert geïndexeerde eigenschappen en schrijft de nieuwe lengte. Ze kan TypeError werpen als schrijven, verwijderen of length verboden is, of als de nieuwe lengte groter zou zijn dan 2^53 - 1; fouten uit conversie, accessors, proxytraps en de species-constructor worden doorgegeven.
Voorbeelden
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(","));Resultaat
test build,lint,test,deploy test,deploy build,lint 0 build,docs,lint 2 false true b c