CKTIS / JavaScript
URIError — errore di codifica o decodifica dell’URI
URIError è un tipo di errore integrato in JavaScript che segnala dati malformati durante la codifica o la decodifica di un URI. Scopri le cause tipiche, come crearlo e come gestire le eccezioni in modo selettivo.
Versione: Introduced in ECMAScript 3 (1999). URIError is an ECMAScript built-in, not a Web API.
Sintassi
new URIError(message)
URIError(message)URIError è un tipo di errore standard ECMAScript che eredita da Error; non è un’interfaccia di Web API. Non indica un qualsiasi indirizzo non valido: riguarda gli errori nelle operazioni di codifica e decodifica degli URI.
decodeURI e decodeURIComponent generano un URIError quando incontrano escape percentuali malformati, come %ZZ, o sequenze di byte che non codificano UTF-8 valido. encodeURI e encodeURIComponent lo generano in presenza di un surrogato UTF-16 non appaiato. Le varianti con Component elaborano singoli componenti URI; le altre considerano il ruolo dei caratteri riservati in un URI completo.
new URIError(message) crea un oggetto; la sola creazione non genera un’eccezione. Anche la chiamata URIError(message) senza new crea un oggetto. Per generare un errore personalizzato, usa throw new URIError(message). La proprietà name ha come valore predefinito "URIError"; il testo di message generato automaticamente dipende dall’implementazione.
Racchiudi la decodifica di dati non attendibili in un blocco try...catch. Nel codice tipico eseguito in un unico realm, controlla error instanceof URIError e rilancia le altre eccezioni. Questo controllo può fallire per un errore proveniente da un altro realm, ad esempio da un altro frame. L’esempio decodifica testo valido e gestisce una sequenza UTF-8 incompleta senza dipendere dal testo del messaggio.
Esempi
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);
}
}Risultato
hello world URIError
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.