Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Function.length — nombre de paramètres d’une fonction

La propriété length d’une fonction indique son nombre de paramètres selon les règles de déclaration, et non le nombre d’arguments fournis lors de son appel.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

fn.length
Function.length

fn.length lit le nombre de paramètres d’une fonction. Le constructeur Function est lui-même une fonction : Function.length vaut 1. Il s’agit d’une propriété de données, pas d’une méthode.

Seuls les paramètres situés avant le premier paramètre ayant une valeur par défaut sont comptés. Chaque motif de décomposition compte comme un paramètre ; un paramètre rest ne compte pas. La propriété standard length n’est ni modifiable ni énumérable, mais elle est configurable.

En revanche, arguments.length dans une fonction ordinaire indique le nombre d’arguments réellement fournis lors de cet appel. Ce nombre peut être supérieur ou inférieur à fn.length ; ne confondez pas ces deux valeurs.

Exemples

function inspect({ value }, scale = 1, ...extra) {
  console.log(arguments.length);
}

console.log(Function.length);
console.log(inspect.length);
inspect({ value: 7 }, 2, 9);
console.log((({ x }, [y]) => {}).length);
console.log(((...items) => {}).length);

Résultat

1
1
3
2
0

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources