CKTIS / JavaScript
decodeURI — dekódování URI
decodeURI dekóduje procentní sekvence v textu URI a zachovává zakódované oddělovače, například %2F. Zjistěte, jak se liší od decodeURIComponent a jak zachází s chybným vstupem.
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
decodeURI(encodedURI)decodeURI(encodedURI) je globální funkce ECMAScript určená k dekódování celých URI. Nejprve převede svůj argument na řetězec a potom vrátí nový řetězec: sekvence %HH představující bajty UTF-8 převede na odpovídající znaky Unicode. Vstup nemění a nevyžaduje rozhraní prohlížeče.
Zachovává procentní sekvence představující znaky ;/?:@&=+$,#, včetně velikosti písmen hexadecimálních číslic. %20 se proto změní na mezeru, ale %2F zůstane %2F. Také doslovné + zůstává beze změny: funkce nedekóduje formulářovou konvenci, která zapisuje mezery jako +.
decodeURIComponent je určena pro jednotlivé části URI a dekóduje také zakódované oddělovače, například %2F na /. Nepoužívejte ji bez rozmyslu na celé URI, protože tím můžete změnit hranice jeho částí. decodeURI není parser ani validátor celé adresy.
Chybná procentní sekvence, například %ZZ, nebo neúplné či neplatné kódování UTF-8 vyvolá URIError místo vrácení částečného výsledku. U externích vstupů tento případ ošetřete pomocí try...catch. Dekódujte jen potřebnou vrstvu kódování: další volání může výsledek znovu změnit; například %2520 se nejprve změní na %20 a poté na mezeru.
Příklady
const encoded = '/caf%C3%A9%20menu?q=a%2Fb+c';
console.log(decodeURI(encoded));
console.log(decodeURIComponent(encoded));
try {
decodeURI('%E0%A4');
} catch (error) {
console.log(error.name);
}Výsledek
/café menu?q=a%2Fb+c /café menu?q=a/b+c 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.