Kódování a dekódování URL

URL smí obsahovat jen omezenou sadu znaků ASCII. RFC 3986, specifikace syntaxe URI z roku 2005, je dělí do dvou skupin. Nevyhrazené znaky, tedy A–Z, a–z, 0–9 a čtyři značky - . _ ~, se kódovat nikdy nemusejí. Vyhrazené znaky mají svou úlohu: obecné oddělovače : / ? # [ ] @ oddělují schéma, hostitele, cestu, dotaz a fragment, zatímco pododdělovače ! $ & ' ( ) * + , ; = oddělují položky uvnitř nich, jako to dělají & a = v dotazu (query string). Vše ostatní a také každý vyhrazený znak použitý jako obyčejná data se musí zakódovat procentovým kódováním.

Procentové kódování zapíše bajt jako % následované dvěma hexadecimálními číslicemi. Text se nejprve převede do UTF-8, takže mezera se změní na %20, znak é (dva bajty) na %C3%A9 a emoji na čtyři skupiny %XX. Proto se hledaný výraz „café & bar“ v odkazu objeví jako caf%C3%A9%20%26%20bar: znak & je zakódován, aby ho server nepovažoval za začátek nového parametru.

encodeURIComponent je správná volba pro jednotlivou část, například hodnotu dotazu, segment cesty nebo adresu přesměrování předávanou jako parametr. Zakóduje vše kromě nevyhrazených znaků a ! ' ( ) *, které JavaScript z historických důvodů nechává být. encodeURI (celá URL) předpokládá, že vstup je už úplná adresa, a vyhrazené znaky ponechá beze změny, takže u https://example.com/a b?q=1 se zakóduje jen mezera. Použít encodeURI na hodnotu parametru je klasická chyba: znak & nebo # uvnitř hodnoty by zůstal a URL by rozbil.

Dekódovat vrátí zpět obě funkce. Formuláře HTML odeslané metodou GET používají starší formát application/x-www-form-urlencoded, ve kterém se mezera zapisuje jako + místo %20; pro ně nechte zaškrtnuté Považovat + za mezeru a zrušte to, když záleží na skutečném znaku plus, například v telefonním čísle. Pokud vstup obsahuje % bez dvou hexadecimálních číslic nebo bajty, které nejsou platné UTF-8, dekódování selže s jasnou zprávou, místo aby hádalo. Pokud text obsahuje dotaz (query string), jeho parametry se zobrazí dekódované v tabulce pod nástrojem. Pro binární data v URL je obvyklou alternativou Base64url.