Онлайн-кодировщик/декодировщик URL-адресов

Что это за инструмент?

Кодирование URL (процентное кодирование) заменяет символы, недопустимые в URL-адресах, на знак % и следующее за ним шестнадцатеричное значение символа в байтах — пробел превращается в %20, а 你 — в %E4%BD%A0. Без него такие символы, как пробелы, &, ? и текст, не входящий в набор ASCII, нарушили бы структуру URL-адреса или были бы неверно интерпретированы серверами.

Существует две распространенные задачи, и этот инструмент поддерживает обе: кодирование значения, которое вставляется в параметр запроса (режим «компонент» — кодирует символы /, ? и =), а также кодирование всего URL-адреса с сохранением его структуры (режим «полный URL» — оставляет символы ://, ? и & без изменений).

Зачем его использовать?

• Создавайте строки запроса безопасно — пользовательские данные, содержащие символы «&», «=» или пробелы, не приведут к сбою URL-адреса.
• Декодируйте длинные закодированные URL-адреса из логов, аналитики или цепочек перенаправлений, чтобы увидеть их фактическое содержание.
• Правильная обработка UTF-8 для китайского языка, эмодзи и другого текста, выходящего за пределы ASCII.
• Два режима, чтобы вы случайно не закодировали символы «:» и «/» во всём URL-адресе.
• Бесплатно, мгновенно, без загрузки.

Как использовать

1. Вставьте текст или URL-адрес в поле ввода.
2. Выберите режим: «Компонент» для значений, передаваемых в параметрах запроса, «Полный URL» — для полных URL-адресов.
3. Нажмите «Кодировать» или «Декодировать».
4. Скопируйте результат.

Пример

Ввод

https://example.com/search?q=hello world & 你好

Результат

Component mode: https%3A%2F%2Fexample.com%2Fsearch%3Fq%3Dhello%20world%20%26%20%E4%BD%A0%E5%A5%BD
Full URL mode:  https://example.com/search?q=hello%20world%20&%20%E4%BD%A0%E5%A5%BD

В режиме «Компоненты» также кодируются символы структуры; в режиме «Полный URL» они сохраняются.

Типичные сценарии использования

• Создание URL-адреса для совместного использования, в котором поисковый запрос или значение фильтра формируются на основе ввода пользователя и могут содержать пробелы, символ «&» или другие специальные символы.
• Расшифровка длинного URL-адреса с отслеживанием или перенаправлением из электронного письма или рекламной кампании, чтобы увидеть фактический адрес назначения и параметры перед тем, как перейти по нему.
• Отладка ситуации, когда сервер некорректно считывает параметр запроса — зачастую причиной является зарезервированный символ, который должен был быть закодирован, но не был.
• Подготовка значения на языке, отличном от английского (китайский, японский, арабский и т. д.), для использования в строке запроса URL.

encodeURIComponent и encodeURI: сравнение на практике

Они напрямую соотносятся с двумя режимами работы данного инструмента и соответствуют реальным функциям JavaScript, с которыми разработчики уже знакомы: encodeURIComponent (режим компонентов) кодирует всё, кроме небольшого набора незарезервированных символов, что делает его безопасным для вставки любого отдельного значения в URL — именно его следует использовать для параметра запроса, сегмента пути или значения фрагмента хэша. encodeURI (режим полного URL) оставляет структурные символы URL (:, /, ?, #, &, =) без изменений, поскольку предполагает, что вы кодируете целый, уже структурированный URL, а не исходное значение — использование этой функции для отдельного значения параметра приведёт к тому, что символы & или =, которые могут содержаться в этом значении, не будут закодированы, что является самой распространённой ошибкой, которую допускают люди при выборе неподходящего режима.

Зарезервированные и незарезервированные символы

Спецификация URL (RFC 3986) делит символы на две группы: незарезервированные символы (буквы, цифры, - _ . ~) всегда безопасны и никогда не кодируются, тогда как зарезервированные символы (: / ? # [ ] @ ! $ & ' ( ) * + , ; =) имеют особое значение в структуре URL и требуют кодирования только в том случае, если они выступают в качестве литеральных данных, а не структурных разделителей. Именно поэтому и существуют эти два режима — «режим компонентов» рассматривает зарезервированные символы как данные, которые нужно защитить, а «режим полного URL» — как структуру, которую нужно сохранить. Понимание этого различия полезнее, чем запоминание того, когда использовать тот или иной режим, поскольку оно объясняет, почему один и тот же символ (например, &) иногда кодируется, а иногда остаётся без изменений в зависимости от того, какую роль он играет в конкретном URL.

Часто задаваемые вопросы