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

nameプロパティは、URIErrorオブジェクトが持つエラーの種類を示す文字列を保持するプロパティです。Node.jsを含むJavaScript環境では、プログラムの実行中に様々な問題が発生することがあります。その中でも、URIErrorクラスは、URI（Uniform Resource Identifier）を扱う関数、例えばencodeURI()やdecodeURI()などにおいて、不正なURI形式の文字列が渡された場合などに発生するエラーを表します。

このnameプロパティは、発生したエラーがURIErrorであることを識別するために使用されます。具体的には、URIErrorオブジェクトが生成されると、そのnameプロパティには自動的に文字列「'URIError'」が設定されます。これにより、プログラム中でtry...catch文を使ってエラーを捕捉した際に、どの種類のエラーが発生したのかをnameプロパティの値を参照することで判別できます。

例えば、Webアプリケーションでユーザーからの入力をURLとして処理する際に、入力された文字列がURIとして不適切だった場合、URIErrorが発生する可能性があります。その際、catchブロック内でエラーオブジェクトのnameプロパティをチェックすることで、「これはURIに関するエラーだ」と判断し、それに応じた適切なエラー処理（例：ユーザーに正しい形式で再入力を促す、ログを記録するなど）を実行できます。このように、nameプロパティはエラーの特定と、それに基づく堅牢なエラーハンドリングを実装するために非常に重要な役割を果たします。

Copy
1try {
2  decodeURIComponent('%');
3} catch (e) {
4  console.log(e.name);
5}

引数なし

引数はありません

string

URIErrorオブジェクトの名前を表す文字列です。通常は "URIError" となります。