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.