URL-kóðun og afkóðun

Vefslóð (URL) má aðeins innihalda takmarkað safn ASCII-stafa. RFC 3986, staðallinn frá 2005 um setningafræði URI, skiptir þeim í tvo hópa. Óvarðir stafir (unreserved), A–Z, a–z, 0–9 og táknin fjögur - . _ ~, þarf aldrei að kóða. Varðir stafir (reserved) hafa sitt hlutverk: almennu aðgreinarnir : / ? # [ ] @ skilja að samskiptareglu, hýsil, slóð, fyrirspurn og brotamerki, og undiraðgreinarnir ! $ & ' ( ) * + , ; = skilja að atriði innan þeirra, eins og & og = gera í fyrirspurnarstreng. Alla aðra stafi, og alla varða stafi sem eru notaðir sem venjuleg gögn, verður að prósentukóða.

Prósentukóðun skrifar bæti sem % og síðan tvo sextándakerfisstafi. Texta er fyrst umbreytt í UTF-8, þannig að bil verður %20, é (tvö bæti) verður %C3%A9 og emoji-tákn verður fjórir %XX-hópar. Þess vegna endar leit að „café & bar“ í hlekk sem caf%C3%A9%20%26%20bar: & er kóðað svo þjónninn túlki það ekki sem upphaf nýrrar færibreytu.

encodeURIComponent er rétti kosturinn fyrir stakan hluta, eins og gildi í fyrirspurn, slóðarhluta eða endurvísunarvefslóð sem er send sem færibreyta. Það kóðar allt nema óvarða stafi og ! ' ( ) *, sem JavaScript lætur í friði af sögulegum ástæðum. encodeURI (heil vefslóð) gerir ráð fyrir að inntakið sé þegar fullt vistfang og skilur varða stafi eftir óbreytta, þannig að í https://example.com/a b?q=1 er aðeins bilið kóðað. Að nota encodeURI á gildi færibreytu er klassísk villa: & eða # inni í gildinu situr eftir og brýtur vefslóðina.

Afkóða snýr hvoru tveggja við. HTML-eyðublöð sem eru send með GET nota eldra sniðið application/x-www-form-urlencoded, þar sem bil er skrifað sem + í stað %20. Hafðu Meðhöndla + sem bil hakað við fyrir slík gögn og taktu hakið af þegar plúsmerki skiptir máli, til dæmis í símanúmeri. Ef inntakið inniheldur % sem tveir sextándakerfisstafir fylgja ekki, eða bæti sem eru ekki gilt UTF-8, mistekst afkóðun með skýrum skilaboðum í stað þess að giska. Þegar textinn inniheldur fyrirspurnarstreng birtast færibreytur hans afkóðaðar í töflu fyrir neðan tólið. Fyrir tvíundargögn í vefslóðum er Base64url venjulegur valkostur.