【Node.js24.x】decodeURIComponent::decodeURIComponent()関数の使い方

decodeURIComponent関数は、URI (Uniform Resource Identifier) のコンポーネントに含まれるパーセントエンコードされた文字をデコードし、元の文字列に戻す関数です。 インターネット上でのデータのやり取りでは、日本語などの非ASCII文字や、URL内で特別な意味を持つ記号（スペース、&、=、/、?など）は、安全にURLの一部として送信するために%xx形式でエンコードされます。このパーセントエンコーディングは、特定の文字をその16進数表現に置き換えることで、URLの構文を崩さずに様々な情報を伝達する役割を持っています。

decodeURIComponent関数は、このようにエンコードされた文字列を受け取り、その%xx形式を元の文字に変換します。これにより、URLのクエリパラメータやパスの一部として渡された情報を、アプリケーション側で正しく解釈し、処理できるようになります。例えば、%E3%83%86%E3%82%B9%E3%83%88というエンコードされた文字列をテストという元の日本語文字列に変換します。

引数にはデコードしたいURIコンポーネントの文字列を一つ指定します。もし、入力文字列に不正なパーセントエンコードシーケンスが含まれている場合、この関数はURIErrorをスローしますので、エラーハンドリングを適切に行うことが重要です。この関数は、ウェブアプリケーションでURLから情報を取り出す際や、サーバーサイドでクライアントから送られてきたURLエンコードされたデータを処理する際に広く利用されます。

const encodedURIcomponent = '%E3%83%86%E3%82%B9%E3%83%88%20String';
const decodedString = decodeURIComponent(encodedURIcomponent);
console.log(decodedString);

encodedURIcomponent

• encodedURIcomponent: string: URIコンポーネントとしてエンコードされた文字列

string

URI コンポーネント文字列をデコードした結果の文字列を返します。