URL-koda och avkoda

En URL får bara innehålla en begränsad uppsättning ASCII-tecken. RFC 3986, specifikationen för URI-syntax från 2005, delar in dem i två grupper. De oreserverade tecknen, A–Z, a–z, 0–9 och de fyra tecknen - . _ ~, behöver aldrig kodas. De reserverade tecknen har en uppgift: de allmänna avgränsarna : / ? # [ ] @ skiljer schema, värd, sökväg, frågesträng och fragment åt, och underavgränsarna ! $ & ' ( ) * + , ; = skiljer objekt inom dem åt, som & och = gör i en frågesträng. Allt annat, och varje reserverat tecken som används som vanlig data, måste procentkodas.

Procentkodning skriver en byte som % följt av två hexadecimala siffror. Texten omvandlas först till UTF-8, så ett blanksteg blir %20, ett é (två byte) blir %C3%A9 och en emoji blir fyra %XX-grupper. Därför hamnar en sökning på "café & bar" i en länk som caf%C3%A9%20%26%20bar: tecknet & kodas så att servern inte tolkar det som starten på en ny parameter.

encodeURIComponent är rätt val för en enskild del, till exempel ett värde i en frågesträng, ett sökvägssegment eller en omdirigerings-URL som skickas som parameter. Funktionen kodar allt utom de oreserverade tecknen och ! ' ( ) *, som JavaScript av historiska skäl lämnar orörda. encodeURI (hela URL:en) utgår från att indata redan är en komplett adress och behåller de reserverade tecknen, så i https://example.com/a b?q=1 kodas bara blanksteget. Att använda encodeURI på ett parametervärde är ett klassiskt fel: ett & eller # i värdet skulle finnas kvar och förstöra URL:en.

Avkoda gör det omvända för båda funktionerna. HTML-formulär som skickas med GET använder det äldre formatet application/x-www-form-urlencoded, där ett blanksteg skrivs som + i stället för %20. Låt Behandla + som blanksteg vara ikryssat för sådana, och avmarkera det när ett riktigt plustecken spelar roll, som i ett telefonnummer. Om indata innehåller ett % som inte följs av två hexadecimala siffror, eller byte som inte är giltig UTF-8, misslyckas avkodningen med ett tydligt meddelande i stället för att gissa. När texten innehåller en frågesträng visas dess parametrar avkodade i en tabell under verktyget. För binärdata i URL:er är Base64url det vanliga alternativet.