Парсер рядка запиту

Що робить парсер рядка запиту

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 на цій сторінці й ніколи не передається — ми не бачимо, не журналюємо й не зберігаємо посилання, які ви оглядаєте. Це має значення, бо рядки запиту регулярно містять сеансові токени, адреси електронної пошти та інші чутливі значення, а з цим інструментом вони ніколи не залишають ваш пристрій.