CKTIS / JavaScript
encodeURI() — kódovanie celého URI
encodeURI() kóduje znaky celého URI a niektoré oddeľovače ponecháva nezmenené. Vráti nový reťazec s percentuálnym kódovaním UTF-8; nie je určená na kódovanie jednotlivých hodnôt parametrov.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
encodeURI(uri)encodeURI(uri) je globálna funkcia ECMAScriptu, nie rozhranie prehliadača. Prevedie argument na reťazec a vráti nový reťazec, v ktorom vybrané znaky nahradí sekvenciami %HH predstavujúcimi bajty UTF-8. Medzera sa zmení na %20, nie na +.
Písmená ASCII, číslice a znaky -_.!~*'();/?:@&=+$,# ponechá nezmenené. Znaky &, = a # si tak zachovávajú osobitný význam, funkcia však nezachováva štruktúru každého platného URI. Napríklad hranaté zátvorky okolo literálu adresy IPv6 percentuálne zakóduje: z http://[::1]/ vznikne http://%5B::1%5D/, teda adresa URL s neplatným hostiteľom. Pre jednotlivú hodnotu parametra použite encodeURIComponent(), ktorá kóduje aj znaky &, = a #.
Ak pomocou encodeURIComponent() kódujete jeden segment cesty, hodnoty tvorené presne . alebo .. pred kódovaním odmietnite. Funkcia ich ponechá nezmenené, takže ich analyzátor URL môže pri normalizácii cesty vyhodnotiť ako bodkové segmenty namiesto toho, aby ich zachoval ako doslovné údaje. Segment .. môže odstrániť predchádzajúci segment cesty.
Funkcia neoveruje platnosť ani bezpečnosť adresy. Znak % kóduje ako %25, takže opakované kódovanie mení existujúce escape sekvencie: %20 sa zmení na %2520. Nespárovaná náhradná kódová jednotka UTF-16 spôsobí URIError; platný pár týchto jednotiek sa zakóduje ako jeden kódový bod.
Príklad ukazuje, ktoré oddeľovače zostanú v uvedenej adrese URL nezmenené, ako sa kódujú é a medzery a aký je rozdiel medzi kódovaním celého URI a kódovaním jednej jeho časti.
Prí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ýsledok
https://example.com/caf%C3%A9%20menu?q=tea&size=large#top tea%26size%3Dlarge %2520
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.