CKTIS / JavaScript
decodeURIComponent — dekódovanie časti URI
decodeURIComponent dekóduje percentuálne sekvencie v jednotlivých častiach URI a interpretuje zakódované bajty ako UTF-8. Vráti text, znak + ponechá nezmenený a pri chybnom kódovaní vyvolá URIError.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
decodeURIComponent(encodedURIComponent)decodeURIComponent(encodedURIComponent) je globálna funkcia ECMAScriptu na dekódovanie jednotlivých častí URI. Najprv prevedie argument na reťazec a potom nahradí sekvencie %HH príslušnými znakmi, pričom zakódované bajty interpretuje ako UTF-8. Vráti reťazec a argument nezmení.
Na rozdiel od decodeURI dekóduje aj zakódované rezervované znaky, napríklad %26, %2F a %3D. Pred dekódovaním hodnôt rozdeľ adresu na jednotlivé časti: predčasné dekódovanie môže zmeniť údaje na oddeľovače. Doslovné + zostáva nezmenené; funkcia ho nepovažuje za medzeru.
Neúplné percentuálne sekvencie, neplatné hexadecimálne číslice alebo neplatné UTF-8 spôsobia chybu URIError. Pri externom vstupe túto výnimku ošetri. Dekóduj podľa očakávaného počtu vrstiev kódovania: %252F sa po jednom volaní zmení na %2F a po druhom na /.
Príklad ukazuje dekódovanie textu Unicode a rezervovaných znakov, zachovanie + a ošetrenie chybného vstupu. Ide o funkciu jazyka ECMAScript, nie o API, ktoré vyžaduje prostredie prehliadača.
Príklady
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);
}Výsledok
café & tea+cake a+b URIError
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.