URL 要素をパーセント符号化

URL に入れる一つの値を符号化する

クエリパラメーターの値、パスの一部分など、URL に入れる一つの値を作るときに使います。空白は %20 になり、値の中の & は新しいパラメーターの区切りと誤認されないよう %26 になります。非 ASCII 文字はまず UTF-8 のバイト列に変わり、必要なバイトが一つ以上の %HH に置き換わります。この順序によって、URL の構造を示す記号と値そのものを区別できます。完成済みの URL 全体を入力する用途ではありません。

URL の他の部分は別に組み立てます。URL 全体を貼り付けると、コロン、スラッシュ、疑問符、等号などの区切り記号まで符号化され、元のようには開けないアドレスになります。検索 URL なら基底のアドレスとパラメーター名を決め、値だけを一度符号化して所定の位置に入れます。URLSearchParams のような API を使えば、この組み立てを管理できます。受け取り側が入れ子の符号化を明示的に要求しない限り、符号化済みの値をもう一度符号化しないでください。

URL 要素のパーセント符号化

URL には値と、それらを区切る構文があります。/ はパス区間を分け、? はクエリを始め、& はクエリの項目を分けます。値自体に空白や &、非 ASCII 文字があれば、パーセント符号化で構造上の記号と区別します。テキストを UTF-8 に変換した後、エスケープが必要な各バイトを % と 2 桁の 16 進数で表します。空白なら通常 %20 です。アクセント付き文字では複数の UTF-8 バイトを使うため、複数の %HH が続くことがあります。

変換結果を確認する

元のテキストを使い、受け取り側が符号化した表現を要求しているか確認してください。テキストを貼り付けるか例を読み込み、結果を確認してからコピーします。処理はこのブラウザー内で行われ、入力は変換サービスへ送信されません。変わるのは情報の書き方であり、文の意味ではありません。結果を後で検証する必要があれば元の入力を残してください。アクセント記号、絵文字、句読点、改行があると、符号化後の文字列は元の見た目と大きく異なる場合があります。空白、アンパサンド、アクセント付き文字を含む一つのクエリ値を、URL を組み立てる前に符号化します。完成したアドレスを URL パーサーで確認し、値の中の句読点でパラメーター数が増えていないか確かめてください。URL 全体を符号化するとルーティングに必要な区切りも隠れるため、URL 構築 API には個々の値を渡します。このページの例では「コーヒーと本」を「%E3%82%B3%E3%83%BC%E3%83%92%E3%83%BC%E3%81%A8%E6%9C%AC」へ変換します。表示結果を省略せず確認し、自分のデータに適用する前に句読点と文字を照合してください。