Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori