KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Array.prototype.toSpliced: gewijzigde kopie zonder mutatie

toSpliced retourneert na verwijderen en invoegen op gekozen posities een nieuwe array en laat de ontvanger ongewijzigd.

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

Syntax

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

array.toSpliced(start, skipCount?, ...items) is de kopiërende variant van splice(): ze maakt een nieuwe gewone Array, slaat een bereik over, voegt items in en laat array intact. Een negatieve start telt vanaf het einde; voorbij de lengte betekent het einde. Met start verwijdert een ontbrekende skipCount de staart, expliciet undefined betekent nul en andere waarden worden tot het beschikbare bereik begrensd.

Het resultaat is de volledige gewijzigde kopie, niet een array van verwijderde elementen. Het is ondiep, altijd dicht en negeert Symbol.species: gaten worden eigen eigenschappen met waarde undefined. Zonder argumenten ontstaat een dichte kopie.

De methode is in ECMAScript 2023 gestandaardiseerd en generiek voor array-achtige waarden. Een ontvanger null of undefined werpt TypeError; een te grote berekende lengte geeft TypeError of RangeError, terwijl conversie-, getter- en proxytrapfouten worden doorgegeven.

Voorbeelden

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]);

Resultaat

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

Bronnen