CKTIS / JavaScript
`Function.length` e arità delle funzioni
`fn.length` descrive l’arità attesa di una funzione, mentre `arguments.length` conta gli argomenti passati in una specifica chiamata.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
fn.length
Function.length
Function.prototype.length
fn.bind(thisArg, ...presetArgs).length
arguments.lengthL’arità di una funzione riguarda il numero di parametri che accetta. In JavaScript fn.length è una proprietà numerica che descrive l’arità attesa, non un metodo né un requisito per la chiamata. Il costruttore predefinito ha Function.length pari a 1; l’oggetto invocabile Function.prototype ha length pari a 0.
Per una funzione definita nel codice sorgente, si contano i parametri da sinistra fino al primo con un valore predefinito per l’intero parametro, escludendo quel parametro e tutti i successivi. Un parametro rest come ...tail non conta mai. Un pattern di destrutturazione conta come un solo parametro: il valore predefinito interno in { x = 0 } non interrompe il conteggio, mentre il = {} esterno in { x = 0 } = {} lo interrompe.
In una funzione ordinaria, arguments.length conta gli argomenti effettivamente passati in quella chiamata, incluso un undefined esplicito. Le funzioni freccia non hanno un proprio arguments; se (...args) è l’intera lista dei parametri, args.length conta tutti gli argomenti. Dopo i parametri con nome, l’array del parametro rest contiene solo gli argomenti rimanenti.
Se una funzione ha una proprietà propria length invariata con valore intero finito, bind sottrae il numero di argomenti preimpostati, senza scendere sotto zero. thisArg non conta. La proprietà length iniziale non è scrivibile né enumerabile, ma è configurabile. Non usarla per convalidare le chiamate: JavaScript consente un numero diverso di argomenti e l’esito dipende dalla funzione.
Esempi
{
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);
}Risultato
1 0 1:0 5:2 1 0
`inspect.length` vale `1` perché conta solo `{ x = 0 }`. Preimpostare `{}` porta il valore a `0`. In `1:0` e `5:2`, il primo numero conta tutti gli argomenti passati e il secondo solo gli elementi di `tail`. L’`undefined` esplicito conta come argomento, anche se fa scattare il valore predefinito di `y`.
Lezioni correlate
- JavaScript · Lezione 21 · Avanzato · Versione: 4
Fonti
- ECMAScript® 2024 Language Specification — Static Semantics: ExpectedArgumentCount
- ECMAScript® 2024 Language Specification — Function Instances: length
- ECMAScript® 2024 Language Specification — Function.prototype.bind
- Function: length - JavaScript | MDN
- The arguments object - JavaScript | MDN
- Rest parameters - JavaScript | MDN