CKTIS / JavaScript
encodeURI() — kódování celého URI
encodeURI() kóduje znaky celého URI a některé oddělovače ponechává beze změny. Vrací nový řetězec s procentovým kódováním UTF-8; není určena ke kódování jednotlivých hodnot parametrů.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
encodeURI(uri)encodeURI(uri) je globální funkce ECMAScriptu, nikoli rozhraní prohlížeče. Převede argument na řetězec a vrátí nový řetězec, ve kterém vybrané znaky nahradí sekvencemi %HH představujícími bajty UTF-8. Mezera se změní na %20, nikoli na +.
Písmena ASCII, číslice a znaky -_.!~*'();/?:@&=+$,# ponechá beze změny. Znaky &, = a # si tak zachovávají zvláštní význam, funkce však nezachovává strukturu každého platného URI. Například hranaté závorky kolem literálu adresy IPv6 procentově zakóduje: z http://[::1]/ vznikne http://%5B::1%5D/, tedy URL s neplatným hostitelem. Pro jednotlivou hodnotu parametru použijte encodeURIComponent(), která kóduje i znaky &, = a #.
Pokud pomocí encodeURIComponent() kódujete jeden segment cesty, hodnoty tvořené přesně . nebo .. před kódováním odmítněte. Funkce je ponechává beze změny, takže je parser URL může při normalizaci cesty vyhodnotit jako tečkové segmenty, místo aby je zachoval jako doslovná data. Segment .. může odstranit předchozí segment cesty.
Funkce neověřuje platnost ani bezpečnost adresy. Znak % kóduje jako %25, takže opakované kódování mění existující escape sekvence: %20 se změní na %2520. Nespárovaná náhradní kódová jednotka UTF-16 způsobí URIError; platný pár těchto jednotek se zakóduje jako jeden kódový bod.
Příklad ukazuje, které oddělovače zůstanou v uvedené adrese URL beze změny, jak se kódují é a mezery a jaký je rozdíl mezi kódováním celého URI a kódováním jedné jeho části.
Příklady
const uri = "https://example.com/café menu?q=tea&size=large#top";
console.log(encodeURI(uri));
console.log(encodeURIComponent("tea&size=large"));
console.log(encodeURI("%20"));Výsledek
https://example.com/caf%C3%A9%20menu?q=tea&size=large#top tea%26size%3Dlarge %2520
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.