Кодувальник / Декодувальник 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%D1%96%D1%82%20%D1%81%D0%B2%D1%96%D1%82.
• Коса риска у значенні параметра стає %2F: a/b перетворюється на a%2Fb.
• Знак питання у значенні стає %3F: «що?» перетворюється на %D1%89%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. Якщо потрібно закодувати або декодувати текст у відсоткове кодування або з нього — це потрібний інструмент.