База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

`Function.length` и арност на функциите

`fn.length` описва очакваната арност на функцията, а `arguments.length` брои аргументите, подадени при конкретно извикване.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

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

Арността на функцията се отнася до броя на параметрите ѝ. В JavaScript fn.length е числово свойство, което описва очакваната арност, а не метод или условие за валидно извикване. За самия вграден конструктор Function.length е 1, а за извикваемия обект Function.prototype свойството length е 0.

При функция, дефинирана в изходния код, параметрите се броят отляво до първия параметър със стойност по подразбиране за целия параметър. Той и всички следващи параметри не се броят. Параметър за остатъчните аргументи като ...tail никога не се брои. Шаблонът за деструктуриране се брои като един параметър: вътрешната стойност по подразбиране в { x = 0 } не прекъсва броенето, но външното = {} в { x = 0 } = {} го прекъсва.

В обикновена функция arguments.length брои действително подадените при извикването аргументи, включително изрично подадено undefined. Стрелковите функции нямат собствено arguments; ако (...args) е целият списък с параметри, args.length брои всички техни аргументи. След именувани параметри масивът с остатъчните аргументи съдържа само останалите аргументи.

Ако функцията има непроменено собствено свойство length с крайна целочислена стойност, bind изважда броя на предварително обвързаните аргументи, без резултатът да пада под нула. thisArg не се брои. Първоначално length не може да се променя чрез присвояване и не е изброимо, но е конфигурируемо. Не го използвай за проверка на извикванията: JavaScript позволява различен брой аргументи, а резултатът зависи от функцията.

Примери

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

Резултат

1
0
1:0
5:2
1
0

`inspect.length` е `1`, защото се брои само `{ x = 0 }`. Предварителното обвързване на аргумента `{}` сваля стойността до `0`. В `1:0` и `5:2` първото число брои всички подадени аргументи, а второто — само елементите в `tail`. Изрично подаденото `undefined` се брои като аргумент, въпреки че задейства стойността по подразбиране за `y`.

Свързани уроци

  • JavaScript · Урок 21 · Напреднало · Версия: 4

Източници