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

Кодировщик URL преобразует символы, которые нельзя напрямую использовать в URL, в процентно-кодированные последовательности. Декодировщик URL выполняет обратную операцию, превращая закодированный текст обратно в исходные символы. Эта страница выполняет обе операции в обоих направлениях — для отдельного компонента URL или для полного URL-адреса.

Инструмент использует четыре стандартные функции JavaScript:

• encodeURIComponent — для кодирования отдельного компонента URL, например значения параметра запроса.
• encodeURI — для кодирования полного URL-адреса с сохранением зарезервированных символов (: / ? # & =), имеющих структурное значение.
• decodeURIComponent — для декодирования отдельного компонента URL обратно в исходные символы.
• decodeURI — для декодирования полного URL без изменения зарезервированных символов.

Все преобразования поддерживают UTF-8: символы с диакритикой, эмодзи и символы нелатинских алфавитов обрабатываются корректно. Никакие данные не загружаются на сервер, не сохраняются и не передаются через API.

Несколько практических примеров того, как выглядит кодирование URL:

• Пробел становится %20: «привет мир» кодируется как %D0%BF%D1%80%D0%B8%D0%B2%D0%B5%D1%82%20%D0%BC%D0%B8%D1%80.
• Косая черта в значении параметра становится %2F: a/b превращается в a%2Fb.
• Знак вопроса в значении становится %3F: «что?» превращается в %D1%87%D1%82%D0%BE%3F.
• Амперсанд в значении становится %26, что предотвращает нарушение структуры строки запроса.
• Символ решётки в значении становится %23: c# превращается в c%23.
• Символы за пределами ASCII используют многобайтовые последовательности UTF-8. Например, café становится caf%C3%A9 (é — два байта UTF-8).
• Эмодзи также используют многобайтовый UTF-8: 😀 становится %F0%9F%98%80.

Переключите инструмент в режим «Декодировать» и вставьте любую из этих закодированных строк, чтобы получить исходный текст в точности.

Выбор правильного режима важен, так как два кодировщика по-разному обрабатывают зарезервированные символы.

Используйте режим «Компонент» (encodeURIComponent / decodeURIComponent), когда кодируете отдельное значение для вставки в URL — например, значение параметра запроса, сегмент пути или значение фрагмента. В этом режиме зарезервированные символы (: / ? # [ ] @ ! $ & ' ( ) * + , ; =) кодируются процентной кодировкой, чтобы они не могли случайно нарушить структуру окружающего URL.

Используйте режим «Полный URL» (encodeURI / decodeURI), когда у вас есть готовый URL-адрес вида https://example.com/path?query=value#fragment и нужно лишь экранировать небезопасные символы (пробелы, символы не-ASCII), не затрагивая зарезервированные структурные символы.

Распространённая ошибка — применение encodeURI к значению, которое должно стать параметром запроса. Зарезервированные символы останутся нетронутыми и могут испортить окружающий URL. При сомнениях кодируйте каждое значение через encodeURIComponent, а затем собирайте URL.

Процентное кодирование (другое название — URL-кодирование) — это способ представления в URL зарезервированных символов (имеющих структурное значение) или символов, вообще недопустимых в URL. Каждый небезопасный байт записывается как знак процента, за которым следуют две шестнадцатеричные цифры: например, %20 для пробела, %2F для косой черты или %3F для знака вопроса.

Кодирование работает на уровне байтов, а не символов напрямую. Современные URL используют UTF-8 для предварительного преобразования символов в байты, поэтому один символ с диакритикой может давать два закодированных байта, а эмодзи — четыре. Инструмент всегда использует UTF-8, что обеспечивает совместимость закодированных строк с остальной частью веба.

Процентное кодирование определено в RFC 3986. Нативные функции JavaScript, используемые здесь, реализуют эту спецификацию, поэтому значение, закодированное через encodeURIComponent в любом современном браузере, корректно декодируется через decodeURIComponent везде.

Этот кодировщик-декодировщик URL пригодится всякий раз, когда нужно безопасно переместить текст в URL или из него. Типичные сценарии:

• Кодирование текста для строки запроса перед вставкой в API-запрос, строку лога или адресную строку браузера.
• Декодирование параметров URL из лога запросов или экспорта аналитики для чтения исходных значений.
• Проверка длинного закодированного URL путём декодирования — посмотреть, что реально передаётся.
• Экранирование специальных символов в URL перед публикацией в чате, документации или JSON-payload.
• Изучение того, как процентное кодирование и байтовые последовательности UTF-8 соответствуют символам.

Поскольку инструмент работает полностью в браузере, он подходит и для конфиденциальных URL (внутренние ссылки, токены, подписанные URL), которые нежелательно вставлять в сторонние сервисы.

Кодирование URL и очистка URL — это две разные операции, которые часто путают.

Кодирование URL (этот инструмент) преобразует символы в процентно-кодированную форму и обратно. Структура URL при этом сохраняется: ничего не добавляется и не удаляется.

Очистка URL (отдельный тип инструмента) удаляет трекинговые параметры — utm_source, utm_medium, fbclid, gclid и подобные ключи запроса, — чтобы итоговая ссылка не содержала метаданных отслеживания. Очистка URL изменяет параметры в адресе — кодирование этого не делает.

Если нужно удалить трекинговые параметры, используйте специализированный очиститель URL. Если нужно закодировать или декодировать текст в процентную кодировку или из неё — это нужный инструмент.