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

【JavaScript ECMAScript】encodeURI::encodeURI()関数の使い方

encodeURI()関数の使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

encodeURI()関数は、Uniform Resource Identifier(URI)全体を適切にエンコードする関数です。

URIは、ウェブ上のリソースを一意に識別するための文字列ですが、スペースや日本語、特定の記号など、URIとして直接使用できない文字が含まれると、正しく解釈されなかったり、エラーが発生したりする可能性があります。この関数は、そうした問題を防ぐために、URIで安全に扱えない文字を「%XX」形式(パーセントエンコーディング)に変換します。

具体的には、URIの構造を定義する役割を持つ予約文字(例: /, ?, :, @, &, =, +, $, ,, #)や、英数字、および一部の安全な記号(-, _, ., !, ~, *, ', (, ))はエンコードせず、それ以外のすべての文字をエンコード対象とします。これにより、URIの全体的な構造を保ちつつ、無効な文字を安全な形式に変換することが可能です。

主に、ウェブページのURL全体を扱う際や、特定のURIをアプリケーション内で安全に利用する目的で使用されます。例えば、ユーザーが入力した文字列を基に完全なURLを生成するような場合に役立ちます。ただし、URIの個々のコンポーネント(パスの一部やクエリパラメータの値など)をエンコードする際には、すべての予約文字をエンコードするencodeURIComponent()関数の方が適している場合がありますので、用途に応じて使い分けることが重要です。

公式リファレンス: encodeURI()

構文(syntax)

1encodeURI("URIとしてエンコードする文字列");

引数(parameters)

uri

  • uri: string: エンコードするURI文字列

戻り値(return)

String

encodeURI() 関数は、URI(Uniform Resource Identifier)全体をエンコードした文字列を返します。これにより、URI 内の特殊文字が安全に送信できるようになります。

関連コンテンツ