KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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

Bronnen