Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

`Function.length` y aridad de las funciones

`fn.length` describe la aridad esperada de una función, mientras que `arguments.length` cuenta los argumentos de una llamada concreta.

Versión: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxis

fn.length
Function.length
Function.prototype.length
fn.bind(thisArg, ...presetArgs).length
arguments.length

La aridad de una función se refiere al número de parámetros que toma. En JavaScript, fn.length es una propiedad numérica que describe la aridad esperada, no un método ni un requisito de la llamada. El constructor integrado tiene Function.length igual a 1; el objeto invocable Function.prototype tiene length igual a 0.

En una función definida en el código fuente se cuentan los parámetros de izquierda a derecha hasta el primero con un valor predeterminado para todo el parámetro, sin incluirlo ni contar los siguientes. Un parámetro resto como ...tail nunca cuenta. Un patrón de desestructuración cuenta como un solo parámetro: el valor predeterminado interno de { x = 0 } no detiene el recuento, pero el = {} externo de { x = 0 } = {} sí lo hace.

Dentro de una función ordinaria, arguments.length cuenta los argumentos que se pasaron en esa llamada, incluido un undefined explícito. Las funciones flecha no tienen su propio arguments; si toda su lista de parámetros es (...args), args.length cuenta todos sus argumentos. Tras los parámetros con nombre, el array del parámetro resto solo contiene los argumentos sobrantes.

Si la función tiene una propiedad propia length sin modificar cuyo valor es un entero finito, bind le resta el número de argumentos fijados de antemano, sin bajar de cero. thisArg no cuenta. La propiedad length inicial no es escribible ni enumerable, pero sí configurable. No la uses para validar llamadas: JavaScript permite pasar otra cantidad de argumentos y el resultado depende de la función.

Ejemplos

{
  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);
}

Resultado

1
0
1:0
5:2
1
0

`inspect.length` vale `1` porque solo cuenta `{ x = 0 }`. Fijar `{}` como argumento de antemano reduce el valor a `0`. En `1:0` y `5:2`, el primer número cuenta todos los argumentos pasados y el segundo solo los elementos de `tail`. El `undefined` explícito cuenta como argumento aunque active el valor predeterminado de `y`.

Lecciones relacionadas

  • JavaScript · Lección 21 · Avanzado · Versión: 4

Fuentes