【Node.js24.x】Function::length定数の使い方
length定数の使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
length定数は、JavaScriptにおいてFunctionオブジェクトが保持する、関数の引数の数を表す定数です。具体的には、このlength定数は、関数が定義された際に明示的に宣言された必須の引数の数を数値で示します。
例えば、function add(a, b) { return a + b; }のような関数では、add.lengthは2となります。これは、関数addがaとbの二つの必須引数を受け取ることを意味しています。
この定数は、デフォルト値が設定された引数や、残余引数（rest parameters、...argsのような形式）はカウントしません。例えば、function greet(name, age = 30) { console.log(name, age); }という関数では、greet.lengthは1です。これは、name引数のみが必須と見なされるためです。同様に、function log(...messages) { console.log(messages); }のような残余引数のみを持つ関数の場合、log.lengthは0となります。
Function.lengthは、関数の定義時に期待される引数の数をプログラムで確認したい場合に有用です。これは、関数のシグネチャに関する基本的な情報を提供し、特に引数のバリデーションや動的な関数呼び出しのロジックを実装する際に役立ちます。
構文(syntax)
1function myFunction(arg1, arg2, arg3) { 2 // 関数本体 3} 4 5// 関数の宣言された引数の数を取得 6console.log(myFunction.length);
引数(parameters)
引数なし
引数はありません
戻り値(return)
number
このlengthプロパティは、関数が定義されている引数の数を示します。