Кодування й декодування URL

URL може містити лише обмежений набір символів ASCII. RFC 3986, специфікація синтаксису URI 2005 року, поділяє їх на дві групи. Незарезервовані символи, A–Z, a–z, 0–9 і чотири знаки - . _ ~, кодувати ніколи не потрібно. Зарезервовані символи мають своє призначення: загальні роздільники : / ? # [ ] @ відокремлюють схему, хост, шлях, запит і фрагмент, а піdроздільники ! $ & ' ( ) * + , ; = розділяють елементи всередині них, як & і = у рядку запиту. Усе інше, а також будь-який зарезервований символ, використаний як звичайні дані, потрібно закодувати за допомогою відсоткового кодування.

Відсоткове кодування записує байт як % і дві шістнадцяткові цифри. Спершу текст перетворюється на UTF-8, тож пропуск стає %20, літера é (два байти) стає %C3%A9, а емодзі стає чотирма групами %XX. Саме тому пошуковий запит "café & bar" потрапляє в посилання як caf%C3%A9%20%26%20bar: символ & кодується, щоб сервер не сприйняв його як початок нового параметра.

encodeURIComponent підходить для окремої частини: значення запиту, сегмента шляху або URL перенаправлення, переданого як параметр. Він екранує все, крім незарезервованих символів і ! ' ( ) *, які JavaScript залишає без змін з історичних причин. encodeURI (весь URL) виходить з того, що вхідні дані вже є повною адресою, і зберігає зарезервовані символи, тож у https://example.com/a b?q=1 кодується лише пропуск. Застосувати encodeURI до значення параметра — класична помилка: & або # усередині значення залишиться й зламає URL.

Декодувати скасовує будь-яку з цих функцій. HTML-форми, надіслані методом GET, використовують старіший формат application/x-www-form-urlencoded, у якому пропуск записується як +, а не %20; для таких випадків залиште позначеним пункт Вважати + пропуском, а зніміть позначку, коли важливий буквальний плюс, наприклад у номері телефону. Якщо у вхідних даних є % без двох шістнадцяткових цифр після нього або байти, що не є коректним UTF-8, декодування завершиться зрозумілим повідомленням про помилку, а не здогадками. Якщо в тексті є рядок запиту, його параметри відображаються декодованими в таблиці під інструментом. Для двійкових даних в URL зазвичай використовують Base64url.