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.lengthArita 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
- 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