CKTIS / JavaScript
Array-destructurering in functieparameters
Met een arraypatroon in de parameterlijst pak je één itereerbaar argument uit. Standaardwaarden voor het hele argument en voor losse waarden werken afzonderlijk.
Versie: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
function f([first = 1, , third = 3, ...rest] = []) { /* function body */ }In een parameterlijst is [first, third] een arraybindingspatroon voor één argument, niet voor twee afzonderlijke parameters. Bij elke aanroep initialiseert het patroon lokale namen in iteratievolgorde, voordat de functiebody wordt uitgevoerd. Een array werkt, maar een andere itereerbare waarde zoals een Set ook. Een gewoon object met numerieke sleutels en een length-eigenschap is niet genoeg.
In [first = 1, , third = 3, ...rest] slaat de lege plek tussen de komma’s de tweede waarde over. ...rest verzamelt de overige waarden in een nieuwe array. Het is een restelement in het patroon, geen restparameter die afzonderlijke argumenten van de aanroep verzamelt. Het moet als laatste komen, zonder komma erachter.
De buitenste = [] vervangt het hele argument alleen als het is weggelaten of undefined is. De binnenste standaardwaarden = 1 en = 3 gelden als de betreffende waarde ontbreekt of undefined is. Een null in de array blijft null. Als het hele argument null of een andere niet-itereerbare waarde is, ontstaat er een TypeError voordat de functiebody wordt uitgevoerd. Zonder = [] leidt het weglaten van het argument of het doorgeven van undefined ook tot een TypeError.
Voorbeelden
function describe([first = 1, , third = 3, ...rest] = []) {
return [first, third, rest];
}
console.log(JSON.stringify(describe()));
console.log(JSON.stringify(describe([undefined, 20, null, 40, 50])));
console.log(JSON.stringify(describe(new Set([10, 20, 30]))));
try {
describe(null);
} catch (error) {
console.log(error.name);
}Resultaat
[1,3,[]] [1,null,[40,50]] [10,30,[]] TypeError
De eerste aanroep gebruikt beide niveaus van standaardwaarden. In de tweede wordt `20` overgeslagen, blijft `null` behouden en is `rest` gelijk aan `[40,50]`. De derde laat zien dat een `Set` ook werkt. De laatste toont de foutnaam in plaats van een melding die van de runtime afhangt.
Gerelateerde lessen
- JavaScript · Les 28 · Gemiddeld · Versie: 3