CKTIS / JavaScript
encodeURIComponent — kodiranje komponente URI
encodeURIComponent kodira eno komponento URI, na primer vrednost parametra poizvedbe. Posebne znake in znake zunaj ASCII pretvori v odstotkovna zaporedja, ki predstavljajo bajte UTF-8.
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
encodeURIComponent(uriComponent)encodeURIComponent(uriComponent) je globalna funkcija ECMAScript, ne API, ki bi bil na voljo samo v brskalnikih. Argument pretvori v niz in vrne kodiran niz. Uporabite jo za posamezno vrednost, ne za celoten naslov.
Nespremenjene pusti črke A–Z, a–z, števke 0–9 in znake - _ . ! ~ * ' ( ). Druge znake pretvori v bajte UTF-8, zapisane kot %HH. Presledek postane %20, ne +; dobesedni + postane %2B.
Za razliko od encodeURI kodira tudi ločila, kot so &, =, /, ? in #. Ko so ti znaki kodirani, pri sestavljanju URI ne delujejo kot ločila. Opuščaji in oklepaji pa ostanejo nespremenjeni in imajo v nekaterih skladnjah URI še vedno lahko vlogo ločil, na primer v naslovih URL protokola OData. Vendar to ni ubežanje HTML-ja niti preverjanje veljavnosti naslova. Če rezultat kodirate še enkrat, se % spremeni v %25.
decodeURIComponent razveljavi kodiranje veljavnih podatkov. Nepovezan nadomestni znak UTF-16 v argumentu funkcije encodeURIComponent povzroči URIError; funkcija ga ne zamenja samodejno. Primer prikaže kodiranje znaka Unicode, presledka in ločil, nato pa preveri, ali je kodiranje mogoče razveljaviti.
Primeri
const value = "ż &+/";
const encoded = encodeURIComponent(value);
console.log(encoded);
console.log(decodeURIComponent(encoded) === value);Rezultat
%C5%BC%20%26%2B%2F true
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.