CKTIS / JavaScript
Function.length — número de parâmetros de uma função
A propriedade length de uma função descreve o número dos seus parâmetros de acordo com as regras de declaração, não o número de argumentos fornecidos quando é chamada.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
fn.length
Function.lengthfn.length lê o número de parâmetros de uma função. O construtor Function também é uma função: Function.length é 1. Trata-se de uma propriedade de dados, não de um método.
Só são contados os parâmetros anteriores ao primeiro parâmetro com um valor predefinido. Cada padrão de desestruturação conta como um parâmetro; um parâmetro rest não é contado. A propriedade padrão length não é gravável nem enumerável, mas é configurável.
Em contrapartida, arguments.length dentro de uma função normal indica o número de argumentos efetivamente fornecidos nessa chamada. Esse número pode ser maior ou menor do que fn.length; não confundas estes dois valores.
Exemplos
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);Resultado
1 1 3 2 0
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.