KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Array.prototype.unshift: vooraan toevoegen

unshift schuift bestaande indexen naar rechts, voegt argumenten vooraan in en retourneert de nieuwe lengte van de ontvanger.

Versie: ECMAScript 1 onward; example target: Node.js 24.22.2

Syntax

array.unshift(...items)

array.unshift(...items) muteert array: bestaande geïndexeerde eigenschappen schuiven met het aantal argumenten naar hogere indexen, items worden vanaf nul geschreven en length wordt bijgewerkt. De nieuwe lengte wordt geretourneerd; argumenten houden hun volgorde, dus unshift("a", "b") zet a vóór b. Zonder argumenten blijft de lengte gelijk.

Gaten blijven bij het schuiven behouden: een ontbrekende broneigenschap laat de overeenkomstige doeleigenschap verwijderen. De methode is generiek voor muteerbare array-achtige objecten en maakt geen resultaatarray.

Als de nieuwe lengte groter zou zijn dan 2^53 - 1, werpt ze TypeError; gewone Arrays hebben nog een lengtegrens. Niet-schrijfbare indexen of length, niet-verwijderbare eigenschappen en fouten van getters, setters of proxytraps kunnen de bewerking na gedeeltelijke wijzigingen stoppen. De API bestaat sinds ECMAScript 1.

Voorbeelden

const queue = ["test", "deploy"];
const length = queue.unshift("lint", "build");
console.log(length, queue.join(","));

const sparse = [, "b"];
const sparseLength = sparse.unshift("a");
console.log(sparseLength, 0 in sparse, 1 in sparse, 2 in sparse, sparse[0], sparse[2]);

const arrayLike = { 1: "second", length: 2 };
const result = Array.prototype.unshift.call(arrayLike, "first");
console.log(result, arrayLike.length, arrayLike[0], 1 in arrayLike, arrayLike[2]);

Resultaat

4 lint,build,test,deploy
3 true false true a b
3 3 first false second

Bronnen