【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 コンポーネントとして安全に送信できるように、指定された文字列をパーセントエンコーディングした結果を文字列で返します。