Кодировщик и декодировщик URL

Структура URL опирается на то, что определённые символы — `/` для разделения сегментов пути, `?` для начала строки запроса, `&` для разделения параметров, `#` для фрагмента — несут фиксированное структурное значение везде, где встречаются. Если значение, помещаемое внутрь URL, например поисковый запрос или имя пользователя, случайно содержит один из этих же символов буквально, должен существовать способ отличить «этот амперсанд — часть настоящего значения» от «этот амперсанд разделяет два параметра запроса». Percent-кодирование — именно такой механизм: любой символ со структурным значением, когда ему нужно появиться как буквальные данные, а не как структура, заменяется на `%`, за которым следует его шестнадцатеричное значение байта, поэтому `&` превращается в `%26` и однозначно читается как данные, а не как разделитель параметров.

Самая частая ошибка URL-кодирования — кодирование целого собранного URL не той функцией: использование `encodeURIComponent`, которая экранирует каждый зарезервированный символ, включая `/`, `:`, `&` и `?`, применительно ко всему адресу, а не к одному отдельному значению. `://` после протокола превращается в `%3A%2F%2F`, каждый `&`, разделяющий параметры запроса, превращается в `%26`, и URL вообще перестаёт быть URL — он становится одной длинной закодированной строкой без какой-либо структуры, которую сервер способен разобрать. Правильный подход — обратный порядок: сначала закодировать каждое отдельное значение — поисковый запрос, целевой адрес редиректа, что бы ни было реальными данными, — и только потом вставить эти уже закодированные значения в окружающую структуру URL, никогда не кодируя повторно уже собранный результат целиком.

Именно поэтому этот инструмент предлагает два отдельных режима вместо одной общей кнопки «кодировать»: режим компонента — для кодирования одного значения, которое вот-вот станет частью URL, и режим полного URL — для более редкого случая кодирования целого адреса с намеренным сохранением его структурных символов.

Сегодня в активном использовании остаются сразу две разные схемы кодирования пробела, и они не взаимозаменяемы. Percent-кодирование, стандарт общего назначения, представляет пробел как `%20` и валидно везде в URL — в пути, в строке запроса, повсюду. Схема с `+` для пробела пришла из более старого и узкого стандарта, специально предназначенного для отправки HTML-форм с типом содержимого `application/x-www-form-urlencoded`, и валидна только внутри строки запроса; буквальный `+`, встретившийся в пути URL, вообще не интерпретируется как пробел — это просто символ плюс. Этот инструмент всегда выдаёт `%20`, валидный в любом контексте, и корректно декодирует обе формы при чтении закодированного URL обратно.

Правила percent-кодирования применяются к любому URL независимо от того, что его строит или потребляет — payload вебхука, построенный бэкенд-сервисом, deep link, открытый мобильным приложением, запрос API, собранный скриптом. Везде, где значение, потенциально содержащее пробелы, амперсанды или не-ASCII символы, подставляется в строку URL, действует то же самое правило — кодировать значение перед вставкой, — поэтому это не только вопрос браузера, но и в той же мере вопрос бэкенда и скриптов.