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.