Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

encodeURIComponent — kodiranje komponente URI-ja

encodeURIComponent kodira jednu komponentu URI-ja, primjerice vrijednost parametra upita. Posebne znakove i znakove izvan ASCII-ja pretvara u postotne nizove koji predstavljaju UTF-8 bajtove.

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

encodeURIComponent(uriComponent)

encodeURIComponent(uriComponent) globalna je funkcija ECMAScripta, a ne API dostupan samo u pregledniku. Pretvara argument u niz znakova i vraća kodirani niz. Koristite je za pojedinačnu vrijednost, a ne za cijelu adresu.

Ne mijenja slova A–Z, a–z, znamenke 0–9 ni znakove - _ . ! ~ * ' ( ). Ostale znakove pretvara u UTF-8 bajtove zapisane kao %HH. Razmak postaje %20, a ne +; doslovni + postaje %2B.

Za razliku od encodeURI, kodira i razdjelnike kao što su &, =, /, ? i #. Nakon kodiranja ti znakovi pri sastavljanju URI-ja ne služe kao razdjelnici. Apostrofi i zagrade, međutim, ostaju nepromijenjeni i u pojedinim sintaksama URI-ja i dalje mogu služiti kao razdjelnici, primjerice u URL-ovima protokola OData. Ipak, to nije HTML escape ni provjera valjanosti adrese. Ponovnim kodiranjem rezultata znak % postaje %25.

decodeURIComponent poništava kodiranje valjanih podataka. Neupareni UTF-16 surogat u argumentu funkcije encodeURIComponent uzrokuje URIError; funkcija ga ne zamjenjuje automatski. Primjer prikazuje kodiranje Unicode znaka, razmaka i razdjelnika, a zatim provjerava može li se kodiranje poništiti.

Primjeri

const value = "ż &+/";
const encoded = encodeURIComponent(value);
console.log(encoded);
console.log(decodeURIComponent(encoded) === value);

Rezultat

%C5%BC%20%26%2B%2F
true

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori