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

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

decodeURIメソッドの使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

decodeURIメソッドは、URI(Uniform Resource Identifier)においてエンコードされた文字列を、元の可読な形式にデコードするメソッドです。URIでは、スペースや日本語のような一部の文字が、URIの構造を安全に保つために %xx のような形式でエンコードされることがあります。このメソッドは、そうした %xx 形式のエンコードを解釈し、対応する文字に変換することで、人間が読みやすい形式に戻します。

ただし、decodeURI メソッドは、URI全体の構造を維持するために、特定の予約文字(セミコロン、スラッシュ、疑問符、コロン、アットマーク、アンパサンド、イコール、プラス、ドル記号、カンマ、ハッシュ記号など)や、英数字、ハイフン、アンダースコア、ピリオド、チルダといった非予約文字はデコードしません。これらの文字は、URIにおいて特別な意味を持つか、あるいは常に安全な文字であるため、デコードの対象外となります。

このメソッドは、ウェブアプリケーションなどでURL(Uniform Resource Locator)などのURIに含まれるパスやクエリパラメータの値を、正しく解釈する必要がある場合に非常に重要です。例えば、ユーザーが入力した文字列がURLの一部として送信され、その中に特殊文字が含まれていた場合に、その文字列を元の状態で取得するために利用されます。Node.js環境において、URLの処理を行う際に標準的に用いられる組み込みの機能の一つです。

構文(syntax)

1const encodedURI = "https://example.com/my%20page?id=123&name=%E3%83%86%E3%82%B9%E3%83%88";
2const decodedURI = decodeURI(encodedURI);
3console.log(decodedURI);

引数(parameters)

encodedURI

  • encodedURI: string: デコードしたいURI文字列

戻り値(return)

string

エンコードされたURI文字列をデコードした結果の文字列を返します。

関連コンテンツ

関連プログラミング言語