KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Array.prototype.push: aan het einde toevoegen

push voegt elk aantal waarden toe vanaf de huidige lengte en retourneert de nieuwe lengte van de ontvanger.

Versie: ECMAScript 2026 draft; example target: Node.js 24.22.2

Syntax

array.push(...items)

array.push(...items) leest length, schrijft de opeenvolgende items vanaf die index, stelt de nieuwe length in en retourneert die als getal. Argumenten worden zonder afvlakking opgeslagen; een aanroep zonder argumenten retourneert nog steeds de huidige lengte. De methode muteert de ontvanger en is generiek voor wijzigbare array-achtige objecten.

null of undefined als ontvanger werpt TypeError. Als lengte plus aantal argumenten de maximale veilige lengte 2^53 - 1 zou overschrijden, werpt het algoritme TypeError. Een echte Array heeft daarnaast de limiet 2^32 - 1. Een niet-schrijfbare index, alleen-lezen length of Proxy-trap kan een fout werpen; eerdere writes hoeven niet teruggedraaid te worden. Het voorbeeld toont een array, een array-achtig object en een niet-uitbreidbare array.

Voorbeelden

const values = ["a"];
console.log(values.push("b", "c"), values.join(","));
const record = { 0: "x", length: 1 };
console.log(Array.prototype.push.call(record, "y", "z"), record.length, record[1] + record[2]);
const fixed = Object.preventExtensions(["x"]);
try { fixed.push("y"); } catch (error) {
  console.log(error.name, fixed.length);
}

Resultaat

3 a,b,c
3 3 yz
TypeError 1

Bronnen