CKTIS / JavaScript
encodeURI() — kodiranje celotnega URI
encodeURI() kodira znake v celotnem URI, pri tem pa nekatera ločila pusti nespremenjena. Vrne nov niz z odstotkovno kodiranimi bajti UTF-8; ni namenjena kodiranju posameznih vrednosti parametrov.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
encodeURI(uri)encodeURI(uri) je globalna funkcija ECMAScript, ne brskalniški API. Argument pretvori v niz in vrne nov niz, v katerem izbrane znake nadomesti z zaporedji %HH, ki predstavljajo bajte UTF-8. Presledek postane %20, ne +.
Črke ASCII, števke in znaki -_.!~*'();/?:@&=+$,# ostanejo nespremenjeni. Znaki &, = in # tako ohranijo poseben pomen, vendar funkcija ne ohrani strukture vsakega veljavnega URI. Na primer, oglate oklepaje okoli dobesedno zapisanega naslova IPv6 odstotkovno kodira: http://[::1]/ postane http://%5B::1%5D/, kar je URL z neveljavnim gostiteljem. Za posamezno vrednost parametra uporabi encodeURIComponent(), ki kodira tudi &, = in #.
Če z encodeURIComponent() kodiraš posamezen segment poti, pred kodiranjem zavrni vrednosti, ki so natanko . ali ... Funkcija jih pusti nespremenjene, zato jih lahko razčlenjevalnik URL pri normalizaciji poti obravnava kot segmente s pikami, namesto da bi jih ohranil kot dobesedne podatke. Segment .. lahko odstrani predhodni segment poti.
Funkcija ne preverja veljavnosti ali varnosti naslova. Znak % kodira kot %25, zato ponovno kodiranje spremeni obstoječa ubežna zaporedja: %20 postane %2520. Nadomestni znak UTF-16 brez para povzroči URIError; veljaven par nadomestnih znakov se kodira kot ena kodna točka.
Primer prikazuje, katera ločila v navedenem URL ostanejo nespremenjena, kako se kodirajo é in presledki ter kakšna je razlika med kodiranjem celotnega URI in kodiranjem ene od njegovih sestavin.
Primeri
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"));Rezultat
https://example.com/caf%C3%A9%20menu?q=tea&size=large#top tea%26size%3Dlarge %2520
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.