Парсер строки запроса

Что делает парсер строки запроса

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

Как он разбирает и декодирует

Строка запроса URL — это часть после ?, составленная из пар key=value, соединённых &, тогда как фрагмент — это то, что идёт после #. Этот парсер сначала отрезает фрагмент, затем запрос, а потом передаёт запрос встроенному в браузер URLSearchParams — тому самому движку, который ваш браузер использует внутри. Это бесплатно даёт вам декодирование, корректное по стандартам:

• Процентное кодирование отменяется — %20 становится пробелом, %2F становится /, а многобайтовые последовательности UTF-8, такие как %D0%9F, снова собираются в правильные символы.
• Знаки плюса становятся пробелами в компоненте запроса, в соответствии с тем, как отправка форм кодирует пробелы.
• Повторяющиеся ключи сохраняются, так что ссылка с двумя параметрами id= показывает обе строки, а не молча отбрасывает одну.
• Фрагмент декодируется отдельно, потому что он играет по собственным правилам.

Одна деталь, которую стоит усвоить: фрагмент после # браузер никогда не отправляет на сервер — он остаётся целиком на стороне клиента и используется для якорей внутри страницы или маршрутизации одностраничных приложений. Вот почему одностраничные приложения часто запихивают состояние во фрагмент и почему токен, размещённый после #, ведёт себя совсем иначе, чем размещённый в запросе. Увидеть здесь запрос и фрагмент разделёнными делает эту границу очевидной.

Конкретные примеры и советы

Вставьте типичную ссылку из рассылки, такую как https://example.com/article?utm_source=news&utm_campaign=july&gclid=abc123#top — и таблица сразу отделяет настоящее назначение от мусора отслеживания: utm_source, utm_campaign, Google gclid и безобидный якорь #top. Это делает тривиальным удаление параметров отслеживания перед тем, как вы поделитесь ссылкой, чтобы вы не передавали дальше идентификаторы, которые привязывают клик обратно к вам. Разработчики постоянно обращаются к нему, чтобы окинуть взглядом перенаправления OAuth, подписанные URL-адреса загрузки и обратные вызовы вебхуков без ручного декодирования на глаз — тот же вид отладки, который вы делали бы с нашим API. Пара подводных камней: голый + в значении законно декодируется в пробел, так что если вам нужен буквальный плюс, его нужно закодировать как %2B; а если ссылка кодирует значение дважды (%2520), вы увидите здесь снятый один слой и, возможно, придётся пропустить результат ещё раз.

Ваша приватность здесь

Всё происходит локально в вашем браузере. URL, который вы вставляете, разбирается с помощью JavaScript на этой странице и никогда не передаётся — мы не видим, не журналируем и не храним ссылки, которые вы рассматриваете. Это важно, потому что строки запроса регулярно содержат сеансовые токены, адреса электронной почты и другие чувствительные значения, а с этим инструментом они никогда не покидают ваше устройство.