CKTIS / JavaScript
URIError — chyba pri kódovaní alebo dekódovaní URI
URIError je vstavaný typ chyby JavaScriptu, ktorý označuje chybné údaje pri kódovaní alebo dekódovaní URI. Zoznámte sa s bežnými príčinami, vytvorením chyby a selektívnym spracovaním výnimiek.
Verzia: Introduced in ECMAScript 3 (1999). URIError is an ECMAScript built-in, not a Web API.
Syntax
new URIError(message)
URIError(message)URIError je štandardný typ chyby ECMAScriptu, ktorý dedí z Error; nejde o rozhranie Web API. Neoznačuje ľubovoľnú neplatnú adresu, ale chyby pri operáciách kódovania a dekódovania URI.
decodeURI a decodeURIComponent vyvolajú URIError, keď narazia na chybné percentuálne escape sekvencie, napríklad %ZZ, alebo na postupnosti bajtov, ktoré nekódujú platné UTF-8. encodeURI a encodeURIComponent ho vyvolajú pri nespárovanom náhradnom znaku UTF-16. Varianty s Component spracúvajú jednotlivé komponenty URI; ostatné zohľadňujú úlohu rezervovaných znakov v úplnom URI.
new URIError(message) vytvorí objekt; samotné vytvorenie výnimku nevyvolá. Objekt vytvorí aj volanie URIError(message) bez new. Ak chcete vyvolať vlastnú chybu, použite throw new URIError(message). Vlastnosť name má predvolenú hodnotu "URIError"; automaticky vytvorený text message závisí od implementácie.
Dekódovanie nedôveryhodných údajov obaľte do bloku try...catch. V bežnom kóde bežiacom v jednom realm skontrolujte error instanceof URIError a ostatné výnimky vyvolajte znova. Táto kontrola môže zlyhať pri chybe z iného realm, napríklad z iného rámca. Príklad dekóduje platný text a spracuje neúplnú sekvenciu UTF-8 bez toho, aby sa spoliehal na text správy.
Prí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ýsledok
hello world URIError
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.