URL encode: кодирование URL (percent-encoding)

Как закодировать строку для URL

1. Введите или вставьте текст в поле Текст или URL. Результат обновляется по мере ввода.
2. Выберите режим в поле Кодирование:
   • Компонент (encodeURIComponent): для одного значения параметра, поля формы или сегмента пути.
   • Полный URL (encodeURI): для целого URL, в котором есть пробелы или не-ASCII символы.
   • Данные формы (пробел как +): для тел application/x-www-form-urlencoded и query-строк, собранных так, как это делают HTML-формы.
   • Все символы: закодировать все байты, включая буквы, чтобы проверить декодер.
3. Оставьте в поле Кодировка UTF-8, если принимающая система не ждёт старую кодировку.
4. Отметьте Каждую строку отдельно, чтобы закодировать список значений за раз, затем нажмите Скопировать результат. Поменять местами отправляет результат в декодер, чтобы проверить преобразование туда и обратно.

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

encodeURIComponent, encodeURI и кодирование форм

Один и тот же ввод, a b&c=d/é?#+, в трёх распространённых стилях:

Компонент оставляет без экранирования только A–Z a–z 0–9 - _ . ! ~ * ' ( ). Полный URL сохраняет ещё и ; / ? : @ & = + $ , #, то есть символы, которые задают структуру URL, поэтому защитить значение с ними он не может. Данные формы оставляют только буквы, цифры и - _ . *, а пробелы пишут как +.

Классическая ошибка: URL собирают в режиме Полный URL. Тогда в ?q=C++ & Go остаются + и &, и сервер получает q=C плюс лишний параметр. Закодируйте значение в режиме Компонент: ?q=C%2B%2B%20%26%20Go.

Пробелы, плюсы и другие проблемные символы

На +, / и = чаще всего спотыкается Base64 в URL. Либо закодируйте его как компонент, либо перейдите на Base64URL, где этих символов нет.

Кодировки, отличные от UTF-8

Percent-encoding работает с байтами, поэтому результат зависит от кодировки. é даёт %C3%A9 в UTF-8 и %E9 в Windows-1252 или ISO-8859-1. Современные браузеры и API используют UTF-8, но старые PHP-приложения, некоторые платёжные шлюзы и устаревшие интранет-системы до сих пор ждут Latin-1 или Windows-1252, а японские сайты иногда ждут Shift_JIS. Выберите подходящую в поле Кодировка. Символ, которого нет в выбранной кодировке, представить нельзя, так что проверьте на них результат.

URL-кодирование в коде

encodeURIComponent("a b&c")              // "a%20b%26c"
new URLSearchParams({ q: "C++ & Go" }).toString()   // "q=C%2B%2B+%26+Go"

from urllib.parse import quote, quote_plus, urlencode
quote("/files/a b.txt")            # '/files/a%20b.txt'  (keeps / by default)
quote("/files/a b.txt", safe="")   # '%2Ffiles%2Fa%20b.txt'
quote_plus("a b&c")                # 'a+b%26c'
urlencode({"q": "C++ & Go"})       # 'q=C%2B%2B+%26+Go'

quote в Python не трогает /, если не передать safe=""; при кодировании значения это часто становится сюрпризом. В других языках: rawurlencode в PHP даёт %20, а urlencode даёт +; URLEncoder.encode в Java кодирует по правилам HTML-форм, с +; в Go есть url.PathEscape (%20) и url.QueryEscape (+). encodeURIComponent не трогает ! ' ( ) *; для строгого вывода по RFC 3986 замените их отдельно:

const strict = s => encodeURIComponent(s).replace(/[!'()*]/g,
  c => "%" + c.charCodeAt(0).toString(16).toUpperCase());

Подробнее о JavaScript рассказывает страница Base64 в JavaScript. Чтобы всё это раскодировать обратно, используйте URL decode.

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