使い方
- 「エンコード」を選んで左の欄に文字を入れると、右にパーセントエンコードした結果が出ます。「デコード」に切り替えると、
%E3%81%82のような文字列を読める形に戻します。どちらも入力と同時に変換されます。 - エンコードの方式は用途に合わせて選びます。クエリの値やパスの一部に入れるなら「部分」、日本語を含む URL を丸ごと変換するなら「URL 全体」、フォームの送信内容と同じ形にするなら「フォーム」です。
- 入力が
https://などで始まる URL なら、下に「URL を分解」が出て、ホスト名・パス・ハッシュとクエリパラメータをデコードした一覧を表示します。パラメータの値を書き換えたり、追加・削除したりすると、組み立て直した URL ができあがります。 - デコードできない
%がある場合は、何文字目のどの部分が問題かを表示し、その部分は元のまま残します。
URL エンコード(パーセントエンコーディング)とは
URL に使える文字は、英数字と一部の記号に限られています(RFC 3986)。日本語や空白、URL の中で特別な意味を持つ記号(&・=・?・# など)をそのまま値として使うと、正しく届かなかったり、区切りと間違われたりします。そこで、文字を UTF-8 のバイト列にし、1 バイトずつ % と 16 進数 2 桁で表すのが URL エンコードです。
| 文字 | UTF-8 のバイト | エンコード結果 |
|---|---|---|
| 空白 | 20 | %20(フォーム形式では +) |
& | 26 | %26 |
| あ | E3 81 82 | %E3%81%82 |
| 🍣 | F0 9F 8D A3 | %F0%9F%8D%A3 |
このツールの文字コードは UTF-8 です。現在の Web では UTF-8 が標準ですが、古いサイトや一部のシステムでは Shift_JIS や EUC-JP でエンコードされた URL が使われていることがあります。その場合はバイト列が違うため、UTF-8 としてはデコードできません(このツールは「UTF-8 として正しくありません」と表示します)。
3 つの方式の違い
| 方式 | エンコードしない文字 | 向いている用途 |
|---|---|---|
部分(encodeURIComponent) | 英数字と - _ . ! ~ * ' ( ) | クエリの値、パスの 1 区間など、URL の「部品」 |
URL 全体(encodeURI) | 上に加えて ; , / ? : @ & = + $ # | 日本語を含む URL を、構造を保ったまま変換する |
フォーム(application/x-www-form-urlencoded) | 英数字と * - . _。空白は + | HTML フォームの送信内容、URLSearchParams の出力と同じ形 |
「URL 全体」は & や = をエンコードしないので、値の中に & を含む文字列をこの方式で変換すると、パラメータの区切りと区別できなくなります。値を 1 つずつ変換するときは「部分」を使います。また「URL 全体」はすでにある % も %25 に変換するため、エンコード済みの URL に使うと二重エンコードになります。
「RFC 3986 準拠」をオンにすると、encodeURIComponent が残す ! ' ( ) * もエンコードします。OAuth 1.0 の署名や AWS の署名(Signature Version 4)など、厳密なエンコードが求められる場面で使います。
具体例
// JavaScript
encodeURIComponent('猫 カフェ') // "%E7%8C%AB%20%E3%82%AB%E3%83%95%E3%82%A7"
decodeURIComponent('%E7%8C%AB') // "猫"
new URLSearchParams({ q: '猫 カフェ' }).toString() // "q=%E7%8C%AB+%E3%82%AB%E3%83%95%E3%82%A7"
# Python
from urllib.parse import quote, unquote_plus
quote('猫 カフェ') # '%E7%8C%AB%20%E3%82%AB%E3%83%95%E3%82%A7'
unquote_plus('%E7%8C%AB+a') # '猫 a'
# PHP
rawurlencode('猫 カフェ'); // %20(RFC 3986)
urlencode('猫 カフェ'); // +(フォーム形式)よくある質問
- 空白は %20 と + のどちらですか?
- どちらも空白を表しますが、使える場所が違います。
+を空白として読むのはクエリ文字列とフォームの送信内容(application/x-www-form-urlencoded)だけで、パスの中の+は文字どおりの「+」です。迷ったら%20にしておくとどこでも空白として扱われます。デコードでは「+ を空白として読む」で切り替えられます。 - デコードすると「UTF-8 として正しくありません」と出ます
- URL が途中で切れているか、Shift_JIS・EUC-JP など UTF-8 以外の文字コードでエンコードされている可能性があります。たとえば「あ」は UTF-8 では
%E3%81%82、Shift_JIS では%82%A0になります。 - %25 が付いた文字列が出てきます
%25は%自体をエンコードしたものです。%25E3%2581%2582のように並んでいる場合は二重にエンコードされています。デコード後に「もう一度デコード」を押すと元の文字に戻せます。- 日本語のドメイン名(
例え.jp)はどうなりますか? - ドメイン名はパーセントエンコードではなく、Punycode(
xn--で始まる形)に変換されるのが決まりです。「URL を分解」ではブラウザが実際に使う Punycode の形も表示します。 - 入力した内容はどこかに送られますか?
- 送られません。変換と URL の分解はすべてお使いのブラウザの中で行っています。
最終更新: