Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

`Function.length` a arita funkcí

`fn.length` udává očekávanou aritu funkce, zatímco `arguments.length` počítá argumenty předané při konkrétním volání.

Verze: ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

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

Arita funkce souvisí s počtem jejích parametrů. V JavaScriptu je fn.length číselná vlastnost popisující očekávanou aritu, nikoli metoda ani podmínka platnosti volání. Samotný vestavěný konstruktor má Function.length rovno 1; volatelný objekt Function.prototype má length rovno 0.

U funkce definované ve zdrojovém kódu se počítají parametry zleva až k prvnímu parametru s výchozí hodnotou pro celý parametr. Tento ani žádný následující parametr se nezapočítává. Zbytkový parametr jako ...tail se nepočítá nikdy. Destrukturovaný vzor se počítá jako jeden parametr: vnitřní výchozí hodnota v { x = 0 } počítání nezastaví, ale vnější = {} v { x = 0 } = {} ano.

Uvnitř běžné funkce počítá arguments.length argumenty skutečně předané při daném volání, včetně výslovně předaného undefined. Šipkové funkce nemají vlastní arguments; pokud celý seznam parametrů tvoří (...args), jejich argumenty spočítá args.length. Pokud zbytkový parametr následuje po pojmenovaných parametrech, obsahuje jeho pole jen zbývající argumenty.

Má-li funkce nezměněnou vlastní vlastnost length s konečnou celočíselnou hodnotou, odečte bind počet předem navázaných argumentů, nejvýše však do nuly. thisArg se nepočítá. Počáteční vlastnost length není zapisovatelná ani vyčíslitelná, ale je konfigurovatelná. Nepoužívej ji k ověřování volání: JavaScript připouští jiný počet argumentů a výsledek závisí na funkci.

Příklady

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

Výsledek

1
0
1:0
5:2
1
0

`inspect.length` je `1`, protože se počítá jen `{ x = 0 }`. Předem navázaný argument `{}` sníží hodnotu na `0`. V `1:0` a `5:2` první číslo udává počet všech předaných argumentů, druhé jen počet prvků v `tail`. Výslovně předané `undefined` se počítá jako argument, přestože aktivuje výchozí hodnotu `y`.

Související lekce

  • JavaScript · Lekce 21 · Pokročilá · Verze: 4

Zdroje