URL decode: декодирование URL (percent-decoding)

Как декодировать URL

1. Вставьте закодированный текст в поле Закодированный URL или текст.
2. Для query-строк и данных форм оставьте Считать + пробелом включённым, а для путей и значений в Base64 выключите.
3. Если в результате остались последовательности %XX, строка статуса подскажет: отметьте Декодировать повторно.
4. Для лог-файла или столбца значений отметьте Каждую строку отдельно, чтобы каждая строка декодировалась сама по себе.
5. Если исходник был не в UTF-8, выберите Кодировка, затем нажмите Скопировать результат.

Если на входе полный URL, таблица под полями показывает схему, хост, декодированный путь, каждый параметр запроса отдельной строкой и фрагмент. Это самый быстрый способ прочитать длинную ссылку с трекингом или редиректом.

Примеры

Двойное кодирование

Каждый раз, когда уже закодированную строку кодируют снова, каждый % превращается в %25. Так / становится %2F, затем %252F, затем %25252F. Это случается, когда URL редиректа проходит через несколько сервисов или когда фреймворк кодирует значение, которое код уже закодировал.

Чтобы прочитать такую строку, декодируйте её, пока не исчезнут escape-последовательности; Декодировать повторно делает именно это и сообщает число проходов. Чтобы устранить причину, найдите слой, который кодирует второй раз. Законно вложенному URL, например в параметре next= или url= с другим адресом внутри, нужен ровно один дополнительный слой, не больше.

Такую вложенность часто дают почтовые шлюзы безопасности. Ссылка Microsoft Defender Safe Links выглядит как https://eur01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fexample.com%2Freset%3Fid%3D42&data=…; вставьте её, и таблица параметров покажет реальный адрес назначения, https://example.com/reset?id=42, без единого клика по ссылке.

Битые escape-последовательности и старые кодировки

После % должны идти ровно две hex-цифры. 100%, %zz или URL, обрезанный посреди последовательности, считаются ошибкой. Декодер не гадает и сообщает Битая escape-последовательность в позиции N. decodeURIComponent в JavaScript в тех же случаях бросает URIError: URI malformed, а unquote в Python оставляет последовательность как есть.

Второй источник ошибок связан с кодировкой. Percent-последовательности кодируют байты, а одиночный %E9 не образует корректный UTF-8. Python декодирует его в символ замены, JavaScript бросает исключение. Если в Кодировка выбрать Windows-1252 или ISO-8859-1, получится é. В том же списке есть Shift_JIS, GBK, EUC-KR, KOI8-R и другие старые кодировки.

URL decode в коде

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 encode, а для Base64, пришедшего через URL, подойдёт декодер Base64URL.

Вопросы и ответы