URL kódovanie a dekódovanie

URL môže obsahovať iba obmedzenú sadu znakov ASCII. RFC 3986, špecifikácia syntaxe URI z roku 2005, ich delí na dve skupiny. Nerezervované znaky, A–Z, a–z, 0–9 a štyri znaky - . _ ~, sa nikdy nemusia kódovať. Rezervované znaky majú svoju úlohu: všeobecné oddeľovače : / ? # [ ] @ oddeľujú schému, hostiteľa, cestu, dopyt a fragment a pododdeľovače ! $ & ' ( ) * + , ; = oddeľujú položky v nich, ako to robia & a = v reťazci dopytu. Všetko ostatné, aj rezervovaný znak použitý ako bežné dáta, sa musí kódovať percentami.

Percentové kódovanie zapíše bajt ako % a dve hexadecimálne číslice. Text sa najprv prevedie do UTF-8, takže medzera sa zmení na %20, znak é (dva bajty) na %C3%A9 a emoji na štyri skupiny %XX. Preto sa vyhľadávanie „café & bar“ v odkaze zobrazí ako caf%C3%A9%20%26%20bar: znak & sa zakóduje, aby ho server nepovažoval za začiatok nového parametra.

encodeURIComponent je správna voľba pre jednu časť, napríklad hodnotu dopytu, segment cesty alebo URL presmerovania odovzdanú ako parameter. Kóduje všetko okrem nerezervovaných znakov a ! ' ( ) *, ktoré JavaScript z historických dôvodov ponecháva. encodeURI (celá URL) predpokladá, že vstup je už úplná adresa, a rezervované znaky ponecháva, takže v https://example.com/a b?q=1 sa zakóduje iba medzera. Použiť encodeURI na hodnotu parametra je klasická chyba: znak & alebo # v hodnote by zostal a pokazil by URL.

Dekódovať vráti späť obe funkcie. Formuláre HTML odoslané metódou GET používajú starší formát application/x-www-form-urlencoded, v ktorom sa medzera zapisuje ako + namiesto %20; pre ne nechajte zaškrtnuté Považovať + za medzeru a odškrtnite ho, keď záleží na doslovnom znaku plus, napríklad v telefónnom čísle. Ak vstup obsahuje % bez dvoch hexadecimálnych číslic alebo bajty, ktoré nie sú platné UTF-8, dekódovanie zlyhá s jasnou správou namiesto hádania. Ak text obsahuje reťazec dopytu, jeho parametre sa zobrazia dekódované v tabuľke pod nástrojom. Pre binárne dáta v URL je bežnou alternatívou Base64url.