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.lengthfn.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.