CKTIS / JavaScript
decodeURIComponent — dekodiranje komponente URI
decodeURIComponent dekodira odstotkovne ubežne sekvence v posamezni komponenti URI in kodirane bajte razume kot UTF-8. Vrne besedilo, znak + pusti nespremenjen in ob napačnem kodiranju sproži URIError.
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
decodeURIComponent(encodedURIComponent)decodeURIComponent(encodedURIComponent) je globalna funkcija ECMAScript za dekodiranje posamezne komponente URI. Argument najprej pretvori v niz, nato pa sekvence %HH zamenja z ustreznimi znaki; kodirane bajte pri tem razume kot UTF-8. Vrne niz in argumenta ne spremeni.
Za razliko od decodeURI dekodira tudi kodirane rezervirane znake, kot so %26, %2F in %3D. Naslov najprej razdeli na komponente, šele nato dekodiraj njihove vrednosti: prezgodnje dekodiranje lahko podatke spremeni v ločila. Dobesedni + ostane nespremenjen; funkcija ga ne obravnava kot presledek.
Nepopolne odstotkovne sekvence, neveljavne šestnajstiške števke ali neveljaven UTF-8 povzročijo napako URIError. Pri zunanjih podatkih obravnavaj to izjemo. Dekodiraj glede na pričakovano število plasti kodiranja: %252F se po enem klicu spremeni v %2F, po drugem pa v /.
Primer prikazuje dekodiranje besedila Unicode in rezerviranih znakov, ohranjanje znaka + ter obravnavo napačnega vnosa. To je funkcija jezika ECMAScript, ne API, ki bi zahteval brskalniško okolje.
Primeri
const encoded = "caf%C3%A9%20%26%20tea%2Bcake";
console.log(decodeURIComponent(encoded));
console.log(decodeURIComponent("a+b"));
try {
decodeURIComponent("%E0%A4%A");
} catch (error) {
console.log(error.name);
}Rezultat
café & tea+cake a+b URIError
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.