URL-koding og -dekoding

En URL kan bare inneholde et begrenset sett med ASCII-tegn. RFC 3986, spesifikasjonen for URI-syntaks fra 2005, deler dem i to grupper. De ureserverte tegnene, A–Z, a–z, 0–9 og de fire tegnene - . _ ~, trenger aldri koding. De reserverte tegnene har egne oppgaver: de generelle skilletegnene : / ? # [ ] @ skiller skjema, vert, bane, spørring og fragment, og underskilletegnene ! $ & ' ( ) * + , ; = skiller elementer innenfor dem, slik & og = gjør i en spørrestreng. Alt annet, og alle reserverte tegn som brukes som vanlige data, må prosentkodes.

Prosentkoding skriver en byte som % etterfulgt av to heksadesimale sifre. Teksten konverteres først til UTF-8, slik at et mellomrom blir %20, en é (to byte) blir %C3%A9 og en emoji blir fire %XX-grupper. Derfor havner et søk etter «café & bar» i en lenke som caf%C3%A9%20%26%20bar: &-tegnet kodes slik at serveren ikke tolker det som starten på en ny parameter.

encodeURIComponent er riktig valg for en enkelt del, for eksempel en spørreverdi, et banesegment eller en omdirigerings-URL som sendes som parameter. Den koder alt unntatt de ureserverte tegnene og ! ' ( ) *, som JavaScript lar stå av historiske grunner. encodeURI (hele URL-en) forutsetter at inndataene allerede er en komplett adresse og beholder de reserverte tegnene, så i https://example.com/a b?q=1 er det bare mellomrommet som kodes. Å bruke encodeURI på en parameterverdi er en klassisk feil: en & eller # inni verdien blir stående og ødelegger URL-en.

Dekod reverserer begge funksjonene. HTML-skjemaer som sendes med GET bruker det eldre formatet application/x-www-form-urlencoded, der et mellomrom skrives som + i stedet for %20. La Behandle + som mellomrom være avkrysset for slike, og fjern avkrysningen når et ekte plusstegn betyr noe, for eksempel i et telefonnummer. Hvis inndataene inneholder en % som ikke følges av to heksadesimale sifre, eller byte som ikke er gyldig UTF-8, feiler dekodingen med en tydelig melding i stedet for å gjette. Når teksten inneholder en spørrestreng, vises parameterne dekodet i en tabell under verktøyet. For binærdata i URL-er er Base64url det vanlige alternativet.