【Node.js24.x】encodeURI::encodeURI()関数の使い方
encodeURI関数の使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
encodeURI関数は、URI（Uniform Resource Identifier）全体を適切にエンコードする関数です。この関数は、URIとして使用できない特殊文字や非ASCII文字（日本語など）を、ウェブで安全に転送できるパーセントエンコーディング形式に変換します。具体的には、スペース文字は %20 のように変換されます。
ただし、encodeURI関数は、URIの構造を定義する特定の予約文字はエンコードしません。これには、セミコロン（;）、スラッシュ（/）、疑問符（?）、コロン（:）、アットマーク（@）、アンパサンド（&）、イコール（=）、プラス（+）、ドル記号（$）、カンマ（,）などが含まれます。これは、URI全体の構造が破壊されないようにするためです。たとえば、http://example.com/path?query=value のようなURIをエンコードする場合、http:// や /、?、= などの記号はそのまま維持されます。
主に、完全なURIを構成する文字列全体を、ブラウザやサーバーが正しく解釈できるように安全な形式に変換したい場合に利用されます。Node.js環境では、ウェブリクエストの構築や外部APIへのアクセス時などに、URIを扱う際に役立ちます。この関数を使用することで、URIの有効性と互換性を保ちながら、特殊文字による問題を回避できます。
構文(syntax)
encodeURI(uri)
引数(parameters)
uri
- uri: string: エンコードするURI全体を指定する文字列
戻り値(return)
string
URIコンポーネントをエンコードした文字列を返します。