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

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

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

作成日: 更新日:

基本的な使い方

encodeURIComponent()関数は、URLの一部として安全に利用できない文字をエンコード(符号化)するために実行する関数です。WebブラウザやWebサーバーは、URLの中に半角スペースや日本語、一部の特殊記号(例えば &, =, ?, / など)が含まれていると、その構造を誤って解釈したり、意図しない動作を引き起こしたりする可能性があります。

この関数は、そのような安全でない文字を、Web上で一意かつ安全に扱える「パーセントエンコーディング」形式(例: 半角スペースは %20、日本語は %E3%81%82 のように)に変換します。これにより、データがブラウザからサーバーへ、またはサーバーからブラウザへ正確に伝達されることを保証します。

主に、URLのクエリ文字列(URLの ? 以降の、キー=値 の部分)における値、またはURLパスの一部など、URIを構成する個々のコンポーネント(部品)をエンコードする際に利用されます。URI全体のエンコードには encodeURI() 関数が適していますが、encodeURIComponent() はより多くの種類の文字をエンコードするため、URIの特定の部品を安全に渡す目的に非常に適しています。システムエンジニアがWebアプリケーション開発でURLを扱う際、データの完全性と正確性を保つために不可欠な関数の一つです。

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

構文(syntax)

1encodeURIComponent("Your string here");

引数(parameters)

uriComponent

  • uriComponent: string: エンコードするURIコンポーネント文字列

戻り値(return)

string

encodeURIComponent() は、URI コンポーネントとして安全に送信できるように、指定された文字列をパーセントエンコーディングした結果を文字列で返します。

関連コンテンツ