【Node.js24.x】encodeURIComponent::encodeURIComponent()関数の使い方
encodeURIComponent関数の使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
encodeURIComponent関数は、URI (Uniform Resource Identifier) の各構成要素（コンポーネント）を、ネットワーク上で安全に伝送できる形式に変換する組み込み関数です。Web通信において、URIにはスペース、日本語、特定の記号など、そのまま使用すると誤って解釈されたり、エラーを引き起こしたりする文字が存在します。
この関数は、そのような安全でない文字や特別な意味を持つ文字を、%に続く2桁の16進数コード（パーセントエンコーディング）に変換します。例えば、空白文字は%20に、日本語のような非ASCII文字はUTF-8でエンコードされたバイト列がそれぞれ%XX形式になります。これにより、URIの各コンポーネントが、その意味を変えることなく、正しく解釈されることが保証されます。
主に、Webアプリケーションでユーザー入力値やデータをURLのクエリパラメータやパスの一部として利用する際に使われます。URI全体ではなく、個々のコンポーネントをエンコードする目的で設計されています。この関数を適切に利用することで、URIの破損や誤った解釈を防ぎ、データの正確な送受信を可能にします。
構文(syntax)
1const originalString = "検索ワード 日本語 スペース & ="; 2const encodedString = encodeURIComponent(originalString); 3console.log(encodedString);
引数(parameters)
uriComponent
- uriComponent: string: エンコードするURIコンポーネント
戻り値(return)
string
encodeURIComponent()関数は、URLのコンポーネントとして安全に使用できる形式にエンコードされた文字列を返します。