【Node.js24.x】Object::getSystemErrorName()メソッドの使い方

getSystemErrorNameメソッドは、オペレーティングシステムが発行する数値のシステムエラーコードを受け取り、それに対応するエラー名の文字列に変換して返すメソッドです。

Node.jsアプリケーションがファイル操作やネットワーク通信などのシステムレベルの処理を実行する際、何らかの問題が発生すると、オペレーティングシステムから負の整数値の「システムエラーコード」が返されることがあります。しかし、この数値だけでは、開発者が具体的に何が原因でエラーが発生したのかを正確に把握することは困難です。例えば、「-4058」という数値だけを見ても、直感的にどのような問題が起きているのかを理解することは難しいでしょう。

このgetSystemErrorNameメソッドは、そうした分かりにくい数値のエラーコードを、「ENOENT」（ファイルが見つからない）や「EACCES」（アクセスが拒否された）といった、より具体的で意味が明確なエラー名に変換する役割を担っています。これにより、システムエンジニアはエラーの具体的な原因を迅速に特定し、適切なデバッグ作業やエラーハンドリングを行うことが可能になります。

特に、アプリケーションがファイルへのアクセスに失敗したり、ネットワーク接続が確立できなかったりといった状況において、開発者やエンドユーザーに対してより分かりやすいエラーメッセージを表示する際に非常に役立ちます。このメソッドを利用することで、システムの安定性を高め、エラー発生時の問題解決を効率的に進めることができるため、Node.jsアプリケーション開発におけるエラー原因を詳細に把握するための重要なツールの一つです。

Copy
1const errorNumber = -2; // 例: ファイルが見つからない (ENOENT) エラーに対応する数値
2const errorName = Object.getSystemErrorName(errorNumber);
3console.log(errorName);

code

• code: string: エラーコードを指定する文字列

string

指定されたシステムエラーコードに対応する、エラー名を表す文字列を返します。