URL encoderen en decoderen

Een URL mag maar een beperkte set ASCII-tekens bevatten. RFC 3986, de specificatie uit 2005 voor de URI-syntaxis, verdeelt die in twee groepen. De unreserved tekens, A–Z, a–z, 0–9 en de vier tekens - . _ ~, hoeven nooit te worden gecodeerd. De reserved tekens hebben een functie: de algemene scheidingstekens : / ? # [ ] @ scheiden schema, host, pad, query en fragment, en de subscheidingstekens ! $ & ' ( ) * + , ; = scheiden onderdelen daarbinnen, zoals & en = dat doen in een querystring. Alle andere tekens, en elk gereserveerd teken dat als gewone data wordt gebruikt, moeten met procentcodering worden gecodeerd.

Procentcodering schrijft een byte op als % gevolgd door twee hexadecimale cijfers. Tekst wordt eerst omgezet naar UTF-8, dus een spatie wordt %20, een é (twee bytes) wordt %C3%A9 en een emoji wordt vier %XX-groepen. Daarom komt een zoekopdracht naar "café & bar" in een link terecht als caf%C3%A9%20%26%20bar: de & wordt gecodeerd zodat de server hem niet leest als begin van een nieuwe parameter.

encodeURIComponent is de juiste keuze voor één onderdeel, zoals een queryWaarde, een padsegment of een doorverwijs-URL die als parameter wordt meegegeven. Het codeert alles behalve de unreserved tekens en ! ' ( ) *, die JavaScript om historische redenen met rust laat. encodeURI (hele URL) gaat ervan uit dat de invoer al een compleet adres is en laat de gereserveerde tekens intact, zodat bij https://example.com/a b?q=1 alleen de spatie wordt gecodeerd. encodeURI gebruiken op een parameterwaarde is een klassieke fout: een & of # in de waarde blijft dan staan en breekt de URL.

Decode maakt beide functies ongedaan. HTML-formulieren die met GET worden verstuurd, gebruiken het oudere formaat application/x-www-form-urlencoded, waarin een spatie als + wordt geschreven in plaats van %20; laat Treat + as a space aangevinkt voor die gevallen en vink het uit wanneer een letterlijk plusteken ertoe doet, zoals in een telefoonnummer. Als de invoer een % bevat die niet door twee hexadecimale cijfers wordt gevolgd, of bytes die geen geldige UTF-8 zijn, mislukt het decoderen met een duidelijke melding in plaats van te gokken. Als de tekst een querystring bevat, verschijnen de parameters gedecodeerd in een tabel onder de tool. Voor binaire data in URL's is Base64url het gebruikelijke alternatief.