Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

【Node.js24.x】Symbol::length定数の使い方

length定数の使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

length定数は、Node.js環境で利用可能なJavaScriptの組み込みオブジェクトであるSymbolコンストラクタが、必須引数をいくつ受け取るかを表す定数です。具体的には、Symbol.lengthとして参照されます。

Symbolは、JavaScriptにおいて新しくユニークで不変な値を生成するために使用されるデータ型です。例えば、オブジェクトのプロパティキーとして利用することで、他のプロパティと名前が衝突するのを防ぐことができます。Symbol()のように引数を指定せずに呼び出すことも、Symbol('description')のように文字列を引数として与えることも可能ですが、この文字列はシンボルの説明として機能し、必須ではありません。

そのため、Symbolコンストラクタは、その機能のために必ずしも引数を必要としません。この事実を反映して、Symbolコンストラクタのlengthプロパティの値は0となります。関数のlengthプロパティは、その関数が期待する必須引数の数を表すというJavaScriptの一般的な規則に従っているためです。

システムエンジニアを目指す初心者の方にとって、このSymbol.lengthは、Symbolコンストラクタの基本的な呼び出し方と、その際に必須の引数がないことを明確に示しています。また、JavaScriptの関数やコンストラクタが持つlengthプロパティが、単に引数の総数ではなく、必須引数の数を示すという重要な原則を理解する上での良い例となります。

構文(syntax)

1console.log(Symbol.length);

引数(parameters)

引数なし

引数はありません

戻り値(return)

number

Symbol.lengthは、Symbolインスタンスが持つ、そのシンボルが表す値の長さを数値で返します。

関連コンテンツ