Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje