CKTIS / JavaScript
encodeURI() — kodiranje cijelog URI-ja
encodeURI() kodira znakove cijelog URI-ja, ostavljajući neke razdjelnike nepromijenjenima. Vraća novi niz s UTF-8 postotnim kodiranjem; nije namijenjena kodiranju pojedinačnih vrijednosti parametara.
Verzija: 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) globalna je funkcija ECMAScripta, a ne API preglednika. Pretvara argument u niz i vraća novi niz u kojem odabrane znakove zamjenjuje nizovima %HH koji predstavljaju UTF-8 bajtove. Razmak postaje %20, a ne +.
ASCII slova, znamenke i znakovi -_.!~*'();/?:@&=+$,# ostaju nepromijenjeni. Znakovi &, = i # stoga zadržavaju posebno značenje, no funkcija ne čuva strukturu svakog valjanog URI-ja. Primjerice, postotno kodira uglate zagrade oko literala IPv6 adrese: http://[::1]/ postaje http://%5B::1%5D/, URL s nevaljanim nazivom glavnog računala. Za pojedinačnu vrijednost parametra upotrijebite encodeURIComponent(), koji kodira i znakove &, = i #.
Ako funkcijom encodeURIComponent() kodirate jedan segment putanje, prije kodiranja odbacite vrijednosti koje su točno . ili ... Funkcija ih ostavlja nepromijenjenima pa ih raščlanjivač URL-a pri normalizaciji putanje može protumačiti kao segmente s točkama umjesto da ih sačuva kao doslovne podatke. Segment .. može ukloniti prethodni segment putanje.
Funkcija ne provjerava valjanost ni sigurnost adrese. Znak % kodira kao %25, pa ponovno kodiranje mijenja postojeće escape nizove: %20 postaje %2520. Neupareni UTF-16 surogat uzrokuje URIError; valjani par surogata kodira se kao jedna kodna točka.
Primjer prikazuje koji razdjelnici u navedenom URL-u ostaju nepromijenjeni, kako se kodiraju é i razmaci te razliku između kodiranja cijelog URI-ja i kodiranja jedne njegove komponente.
Primjeri
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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.