CKTIS / JavaScript
decodeURIComponent — dekódování části URI
decodeURIComponent dekóduje procentové sekvence v jednotlivé části URI a interpretuje zakódované bajty jako UTF-8. Vrací text, znak + ponechává beze změny a při chybném kódování vyvolá URIError.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
decodeURIComponent(encodedURIComponent)decodeURIComponent(encodedURIComponent) je globální funkce ECMAScriptu určená k dekódování jednotlivé části URI. Nejprve převede argument na řetězec a potom nahradí sekvence %HH odpovídajícími znaky; zakódované bajty přitom interpretuje jako UTF-8. Vrací řetězec a argument nemění.
Na rozdíl od decodeURI dekóduje také zakódované rezervované znaky, například %26, %2F a %3D. Než dekódujete hodnoty, rozdělte adresu na jednotlivé části: předčasné dekódování může změnit data na oddělovače. Doslovné + zůstává beze změny; funkce ho nepovažuje za mezeru.
Neúplné procentové sekvence, neplatné šestnáctkové číslice nebo neplatné UTF-8 způsobí chybu URIError. U externího vstupu tuto výjimku ošetřete. Dekódujte podle očekávaného počtu vrstev kódování: %252F se po jednom volání změní na %2F a po druhém na /.
Příklad ukazuje dekódování textu Unicode a rezervovaných znaků, zachování + a ošetření chybného vstupu. Jde o funkci jazyka ECMAScript, nikoli o API vyžadující prostředí prohlížeče.
Pří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ýsledek
café & tea+cake a+b URIError
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.