Cette page a été traduite à partir de l'anglais par la communauté.Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.
Function.length
Baseline Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
La propriétélength définit le nombre de paramètres attendus par la fonction.
Dans cet article
Exemple interactif
function func1() {}function func2(a, b) {}console.log(func1.length);// Expected output: 0console.log(func2.length);// Expected output: 2Attributs deFunction.length | |
|---|---|
| Écrivable | Non |
| Énumérable | Non |
| Configurable | Oui |
Description
length est une propriété des fonctions qui indique le nombre d'arguments attendus par la fonction (ce qui correspond au nombre d'arguments formellement déclarés). Cette quantité n'inclue pas lesparamètres du reste et ne compte que les paramètres situés avant le premier paramètre avec une valeur par défaut. Cette propriété est différente dearguments.length qui est locale à la fonction et qui décrit le nombre d'arguments réellement passés à la fonction.
Propriété du constructeurFunction
Le constructeurFunction est lui-même un objetFunction. Sa propriétélength vaut 1. Les attributs de cette propriété sont : Écrivable :false, Énumérable :false, Configurable :true.
Propriété du prototype deFunction
La propriétélength du prototype deFunction vaut 0.
Exemples
console.log(Function.length); /* 1 */console.log(function () {}.length); /* 0 */console.log(function (a) {}.length); /* 1 */console.log(function (a, b) {}.length); /* 2 etc. */console.log(function (...args) {}.length);// 0, le paramètre du reste n'est pas comptéconsole.log(function (a, b = 1, c) {}.length);// 1, seuls les paramètres avant les valeurs par// défaut sont comptésSpécifications
| Specification |
|---|
| ECMAScript® 2026 Language Specification> # sec-function-instances-length> |