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

【Node.js24.x】RangeError::messageプロパティの使い方

messageプロパティの使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

messageプロパティは、Node.jsのRangeErrorオブジェクトが持つエラーメッセージの文字列を保持するプロパティです。RangeErrorは、プログラム内で数値が許容される範囲外であった場合に発生する、JavaScriptに組み込まれたエラータイプの一つです。例えば、関数に渡された引数が特定の数値範囲内であるべきにもかかわらず、その範囲外の値が指定された際にこのエラーがスローされます。

このmessageプロパティには、発生したRangeErrorの具体的な内容を説明するテキスト情報が格納されています。これにより、開発者はエラーが発生した原因を迅速に特定し、問題を解決するための手がかりを得ることができます。RangeErrorのインスタンスが作成される際に、エラーの具体的な状況を示す文字列がこのプロパティに設定され、通常は読み取り専用として扱われます。

プログラムにおいて、try...catch構文などを用いてRangeErrorを捕捉した場合、捕捉したエラーオブジェクトのmessageプロパティにアクセスすることで、エラーの詳細な記述を取得できます。この情報は、エラーログの出力、ユーザーへのエラー通知、またはデバッグ処理の補助に非常に役立ちます。RangeErrorオブジェクトはmessageプロパティの他にも、エラーの種類を示すnameプロパティ(「RangeError」など)や、エラーが発生した呼び出し履歴を示すstackプロパティも持っており、これらを総合的に参照することで、より包括的なエラー分析が可能になります。

構文(syntax)

1const errorObject = new RangeError('The provided number is outside the acceptable range.');
2const errorMessage = errorObject.message;

引数(parameters)

引数なし

引数はありません

戻り値(return)

string

RangeErrorオブジェクトが生成された際に、エラーの原因を説明する文字列が返されます。

関連コンテンツ