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

Похожие

Что такое URL-кодирование?

Варианты использования

• Отладка параметров API: сравнение вывода encodeURIComponent и encodeURI для решения проблем несоответствия подписи интерфейса
• Декодирование логов: пакетное декодирование URL-закодированного содержимого в логах для восстановления читаемого текста
• Построение URL: режим Query Only сохраняет имена ключей и кодирует только значения, избегая ошибок формата при ручной конкатенации
• Фронтенд-разработка: подсветка помогает понять, какие символы экранируются, полезно для отладки перенаправлений страниц
• Миграция данных: пакетная обработка URL-закодированных данных, экспортированных из устаревших систем, для преобразования в новый формат

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

1. Введите или вставьте URL или текст для кодирования/декодирования
2. Выберите направление кодирования (Кодировать/Декодировать) и режим (Component / URI / full / RFC 3986)
3. Включите пакетный режим для многострочных данных или Query Only для кодирования только значений параметров
4. Проверьте подсвеченный результат и скопируйте закодированную строку для использования в API-запросах или построении URL

Функции

• Четыре режима кодирования: переключение между encodeURIComponent / encodeURI / full / RFC 3986 одним кликом, сравнение различий вывода в реальном времени
• Подсветка кодирования: подсвечивает экранированные %XX-символы в реальном времени, янтарная маркировка делает результаты кодирования видимыми с первого взгляда
• Пакетный режим: поддержка многострочного пакетного кодирования/декодирования, каждая строка обрабатывается независимо, идеально для логов или массовых данных
• Режим Query Only: кодирует только часть значения параметра URL (после знака равенства), сохраняя имена ключей, символы и структуру пути нетронутыми
• Дебаунс в реальном времени: автоматическое кодирование/декодирование за 300 мс, не нужно нажимать кнопки, результаты появляются при вводе
• Подсчёт символов: отображает количество введённых символов в реальном времени, удобно для проверки ограничений длины параметров API

Примеры кода

// encodeURIComponent: кодирует отдельные значения параметров (наиболее частое использование)
const param = encodeURIComponent('张三&李四');
console.log(param); // %E5%BC%A0%E4%B8%89%26%E6%9D%8E%E5%9B%9B

// encodeURI: кодирует полный URL (сохраняет структурные символы :/?#&=)
const url = encodeURI('https://example.com/search?q=привет мир');
console.log(url);

// Декодирование
const decoded = decodeURIComponent(param);
console.log(decoded); // 张三&李四

// Совместимость с RFC 3986 (~ не кодируется)
function rfc3986Encode(str) {
  return encodeURIComponent(str).replace(/[!'()*]/g, c => '%' + c.charCodeAt(0).toString(16).toUpperCase());
}

// API URLSearchParams (современный способ, автоматическая кодировка)
const params = new URLSearchParams({ name: '张三', city: '北京' });
console.log(params.toString());
// name=%E5%BC%A0%E4%B8%89&city=%E5%8C%97%E4%BA%AC

from urllib.parse import quote, unquote, urlencode, quote_plus

# quote: аналогично encodeURIComponent
encoded = quote('张三&李四')
print(encoded)  # %E5%BC%A0%E4%B8%89%26%E6%9D%8E%E5%9B%9B

# Режим RFC 3986 (~ не кодируется, по умолчанию)
print(quote('hello~world'))  # hello~world

# quote_plus: пробелы кодируются как + (формат формы)
print(quote_plus('hello world'))  # hello+world

# Декодирование
print(unquote(encoded))  # 张三&李四

# urlencode: построение строки запроса
params = urlencode({'name': '张三', 'city': '北京'})
print(params)
# name=%E5%BC%A0%E4%B8%89&city=%E5%8C%97%E4%BA%AC

import java.net.URLEncoder;
import java.net.URLDecoder;
import java.net.URI;
import java.nio.charset.StandardCharsets;

public class URLEncodeExample {
    public static void main(String[] args) throws Exception {
        // URL-кодирование (URLEncoder - формат формы, пробелы становятся +)
        String encoded = URLEncoder.encode("张三&李四", "UTF-8");
        System.out.println(encoded);
        // %E5%BC%A0%E4%B8%89%26%E6%9D%8E%E5%9B%9B

        // Декодирование
        String decoded = URLDecoder.decode(encoded, "UTF-8");
        System.out.println(decoded); // 张三&李四

        // Построение полного URL (класс URI обрабатывает кодирование автоматически)
        URI uri = new URI("https", "example.com", "/search", "q=привет", null);
        System.out.println(uri.toASCIIString());
    }
}

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

Глоссарий

Процентное кодирование (Percent-encoding)

Официальное название URL-кодирования, метод кодирования, представляющий символы с помощью % с последующими двумя шестнадцатеричными цифрами. Например, пробел кодируется как %20, китайский иероглиф «中» — как %E4%B8%AD.Википедия - Процентное кодирование

encodeURIComponent

Встроенная функция JavaScript, которая кодирует все символы, кроме A-Z a-z 0-9 - _ . ! ~ * ' ( ). Наиболее часто используется для кодирования отдельных значений параметров запроса URL.

encodeURI

Встроенная функция JavaScript, которая сохраняет структурные символы URL (: / ? # [ ] @ ! $ & ' ( ) * + , ; =) и кодирует только те символы, которые действительно нуждаются в кодировании. Используется для кодирования полных URL.

RFC 3986

Последний стандарт IETF для общего синтаксиса URI (2005 год), определяющий правила URL-кодирования и классифицирующий тильду ~ как незарезервированный символ (не требующий кодирования). Заменяет старые RFC 2396 и RFC 1738.RFC 3986

Зарезервированные символы (Reserved Characters)

Символы с особым значением в URL, такие как : / ? # [ ] @ ! $ & ' ( ) * + , ; =. Эти символы должны кодироваться при использовании в качестве данных, но не в их структурных позициях.

Незарезервированные символы (Unreserved Characters)

Безопасные символы, которые можно использовать в любой позиции URL без кодирования, включая A-Z, a-z, 0-9, -, _, ., ~ (согласно RFC 3986).

Строка запроса (Query String)

Часть URL после ?, состоящая из пар key=value, разделённых &. Например, в ?name=张三&age=20 name=张三 и age=20 — это два параметра.

URLSearchParams

API, предоставляемый современными браузерами для удобного построения и анализа строк запроса URL с автоматической обработкой кодирования и декодирования. Более безопасный и надёжный, чем ручная конкатенация строк.

application/x-www-form-urlencoded

Формат отправки по умолчанию для HTML-форм, где пробелы кодируются как + вместо %20, что немного отличается от encodeURIComponent. Серверные фреймворки обычно автоматически обрабатывают оба формата.

Кодировка UTF-8

Стандартная кодировка символов Веба. При URL-кодировании не-ASCII символы (такие как китайский, эмодзи) сначала преобразуются в последовательности байтов UTF-8, затем каждый байт кодируется в формате %XX.

Сравнение экранирования символов в 4 режимах кодирования

Краткий справочник распространённых зарезервированных символов URL

Authoritative References

• ReferenceRFC 3986 - Унифицированный идентификатор ресурса (URI): общий синтаксис
• ReferenceRFC 1738 - Унифицированные указатели ресурсов (URL)
• ReferenceMDN Web Docs - encodeURIComponent()
• ReferenceMDN Web Docs - encodeURI()
• ReferenceВикипедия - Процентное кодирование