KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

`Function.length` en de ariteit van functies

`fn.length` geeft de verwachte ariteit van een functie aan, terwijl `arguments.length` de argumenten telt die bij een specifieke aanroep zijn doorgegeven.

Versie: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

fn.length
Function.length
Function.prototype.length
fn.bind(thisArg, ...presetArgs).length
arguments.length

De ariteit van een functie gaat over het aantal parameters. In JavaScript beschrijft de numerieke eigenschap fn.length de verwachte ariteit. Het is geen methode of aanroepvereiste. De ingebouwde constructor zelf heeft Function.length gelijk aan 1; het aanroepbare Function.prototype heeft length gelijk aan 0.

Tel bij een functie die in broncode is gedefinieerd van links naar rechts tot de eerste parameter met een standaardwaarde voor de hele parameter. Die parameter en alle volgende tellen niet mee. Een restparameter zoals ...tail telt nooit mee. Een destructureringspatroon telt als één parameter: de interne standaardwaarde in { x = 0 } stopt het tellen niet, maar het buitenste = {} in { x = 0 } = {} wel.

Binnen een gewone functie telt arguments.length de argumenten die daadwerkelijk bij die aanroep zijn doorgegeven, inclusief een expliciete undefined. Pijlfuncties hebben geen eigen arguments; als (...args) de volledige parameterlijst is, telt args.length al hun argumenten. Na benoemde parameters bevat de restarray alleen de overgebleven argumenten.

Heeft een functie een ongewijzigde eigen length-eigenschap met een eindige gehele waarde, dan trekt bind het aantal vooraf vastgelegde argumenten ervan af, met nul als ondergrens. thisArg telt niet mee. De oorspronkelijke length-eigenschap is niet beschrijfbaar of opsombaar, maar wel configureerbaar. Gebruik haar niet om aanroepen te valideren: JavaScript staat een ander aantal argumenten toe en de uitkomst hangt af van de functie.

Voorbeelden

{
  function inspect({ x = 0 }, y = 10, z, ...tail) {
    return `${arguments.length}:${tail.length}`;
  }

  console.log(inspect.length);
  console.log(inspect.bind(null, {}).length);
  console.log(inspect({}));
  console.log(inspect({}, undefined, 3, 4, 5));
  console.log(Function.length);
  console.log(Function.prototype.length);
}

Resultaat

1
0
1:0
5:2
1
0

`inspect.length` is `1`, omdat alleen `{ x = 0 }` meetelt. Door `{}` vooraf te binden wordt de waarde `0`. Bij `1:0` en `5:2` telt het eerste getal alle doorgegeven argumenten en het tweede alleen de elementen in `tail`. De expliciete `undefined` telt mee, ook al activeert die de standaardwaarde voor `y`.

Gerelateerde lessen

  • JavaScript · Les 21 · Gevorderd · Versie: 4

Bronnen