URL デコーダー（パーセントデコード）

URL をデコードする方法

1. エンコードされたテキストを エンコード済みの URL またはテキスト に貼り付けます。
2. クエリ文字列やフォームデータでは + を空白として扱う をオンのままにし、パスや Base64 の値ではオフにします。
3. 結果にまだ %XX が含まれている場合はステータスに案内が出るので、繰り返しデコード にチェックを入れます。
4. ログファイルや値の列を扱う場合は 1 行ずつ処理 にチェックを入れると、各行が個別にデコードされます。
5. 元データが UTF-8 でなければ 文字コード を選び、出力をコピー します。

入力が完全な URL の場合、入出力欄の下の表に、スキーム、ホスト、デコード済みのパス、1 行に 1 つずつのクエリパラメータ、フラグメントが表示されます。長いトラッキング URL やリダイレクト URL を読むにはこれが一番手早い方法です。

例

二重エンコード

エンコード済みの文字列をさらにエンコードするたびに、% はすべて %25 になります。そのため / は %2F、%252F、%25252F と変わっていきます。リダイレクト URL が複数のサービスを経由したときや、コードがすでにエンコードした値をフレームワークがもう一度エンコードしたときに起こります。

こうした文字列を読むには、エスケープがなくなるまでデコードします。繰り返しデコード がそれを行い、回数を表示します。原因を直すには、2 回目のエンコードをしている層を見つけてください。別の URL を保持する next= や url= パラメータのように、正当に入れ子になった URL では、追加の層はちょうど 1 つで、それ以上にはなりません。

こうした入れ子のよくある発生源は、メールのセキュリティゲートウェイです。Microsoft Defender の Safe Links の URL は https://eur01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fexample.com%2Freset%3Fid%3D42&data=… のような形をしています。貼り付ければ、何もクリックせずに、パラメータ表で本当のリンク先 https://example.com/reset?id=42 を確認できます。

不正なエスケープとレガシー文字コード

% の後にはちょうど 2 桁の16進数が必要です。100%、%zz、エスケープの途中で切れた URL はエラーで、デコーダーは「位置 N のエスケープが壊れています」と報告します。JavaScript の decodeURIComponent は同じ場合に URIError: URI malformed を投げ、Python の unquote はそのシーケンスをそのまま残します。

もう一つのエラーの原因は文字コードです。パーセントエスケープはバイトを表し、%E9 単独では有効な UTF-8 ではありません。Python はこれを置換文字としてデコードし、JavaScript は例外を投げます。文字コード を Windows-1252 や ISO-8859-1 にすれば é にデコードされます。Shift_JIS、GBK、EUC-KR、KOI8-R などのレガシー文字コードも同じリストにあります。

コードでの URL デコード

decodeURIComponent("a%20b%26c")                   // "a b&c"
new URLSearchParams("q=a+b%2Bc").get("q")          // "a b+c"

from urllib.parse import unquote, unquote_plus, parse_qs
unquote("caf%C3%A9")                     # 'café'
unquote("caf%E9", encoding="latin-1")    # 'café'
unquote_plus("q=a+b%2Bc")                # 'q=a b+c'
parse_qs("q=a+b%2Bc&tag=x&tag=y")        # {'q': ['a b+c'], 'tag': ['x', 'y']}

decodeURIComponent は + をスペースに変えませんが、URLSearchParams と unquote_plus は変えます。文字列がどう作られたかに合わせて選んでください。エンコードについては URL エンコーダー を、URL を経由して届いた Base64 については Base64URL デコーダー を参照してください。

よくある質問