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

CKTIS / JavaScript

URIError — chyba při kódování nebo dekódování URI

URIError je vestavěný typ chyby JavaScriptu, který označuje chybná data při kódování nebo dekódování URI. Seznamte se s obvyklými příčinami, vytvořením chyby a selektivním zpracováním výjimek.

Verze: Introduced in ECMAScript 3 (1999). URIError is an ECMAScript built-in, not a Web API.

Syntaxe

new URIError(message)
URIError(message)

URIError je standardní typ chyby ECMAScriptu, který dědí z Error; nejde o rozhraní Web API. Neoznačuje libovolnou neplatnou adresu, ale chyby při operacích kódování a dekódování URI.

decodeURI a decodeURIComponent vyvolají URIError, když narazí na chybné procentové escape sekvence, například %ZZ, nebo na posloupnosti bajtů, které nekódují platné UTF-8. encodeURI a encodeURIComponent jej vyvolají při nespárovaném náhradním znaku UTF-16. Varianty s Component zpracovávají jednotlivé komponenty URI; ostatní berou v úvahu roli vyhrazených znaků v úplném URI.

new URIError(message) vytvoří objekt; samotné vytvoření výjimku nevyvolá. Objekt vytvoří také volání URIError(message) bez new. Chcete-li vyvolat vlastní chybu, použijte throw new URIError(message). Vlastnost name má výchozí hodnotu "URIError"; automaticky vytvořený text message závisí na implementaci.

Dekódování nedůvěryhodných dat obalte do bloku try...catch. V běžném kódu běžícím v jednom realm ověřte error instanceof URIError a ostatní výjimky vyvolejte znovu. Tato kontrola může selhat u chyby z jiného realm, například z jiného rámce. Příklad dekóduje platný text a zpracuje neúplnou sekvenci UTF-8, aniž by se spoléhal na text zprávy.

Příklady

for (const input of ["hello%20world", "%E0%A4"]) {
  try {
    console.log(decodeURIComponent(input));
  } catch (error) {
    if (!(error instanceof URIError)) throw error;
    console.log(error.name);
  }
}

Výsledek

hello world
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