【JavaScript ECMAScript】encodeURI::encodeURI()関数の使い方
encodeURI()関数の使い方について、初心者にもわかりやすく解説します。
基本的な使い方
encodeURI()関数は、Uniform Resource Identifier(URI)全体を適切にエンコードする関数です。
URIは、ウェブ上のリソースを一意に識別するための文字列ですが、スペースや日本語、特定の記号など、URIとして直接使用できない文字が含まれると、正しく解釈されなかったり、エラーが発生したりする可能性があります。この関数は、そうした問題を防ぐために、URIで安全に扱えない文字を「%XX」形式(パーセントエンコーディング)に変換します。
具体的には、URIの構造を定義する役割を持つ予約文字(例: /, ?, :, @, &, =, +, $, ,, #)や、英数字、および一部の安全な記号(-, _, ., !, ~, *, ', (, ))はエンコードせず、それ以外のすべての文字をエンコード対象とします。これにより、URIの全体的な構造を保ちつつ、無効な文字を安全な形式に変換することが可能です。
主に、ウェブページのURL全体を扱う際や、特定のURIをアプリケーション内で安全に利用する目的で使用されます。例えば、ユーザーが入力した文字列を基に完全なURLを生成するような場合に役立ちます。ただし、URIの個々のコンポーネント(パスの一部やクエリパラメータの値など)をエンコードする際には、すべての予約文字をエンコードするencodeURIComponent()関数の方が適している場合がありますので、用途に応じて使い分けることが重要です。
構文(syntax)
1encodeURI("URIとしてエンコードする文字列");
引数(parameters)
uri
- uri: string: エンコードするURI文字列
戻り値(return)
String
encodeURI() 関数は、URI(Uniform Resource Identifier)全体をエンコードした文字列を返します。これにより、URI 内の特殊文字が安全に送信できるようになります。