CKTIS / JavaScript
URIError — erro de codificação ou descodificação de URI
URIError é um tipo de erro integrado do JavaScript que indica dados malformados durante a codificação ou descodificação de URI. Aprende as causas habituais, como criar o erro e como tratar exceções de forma seletiva.
Versão: Introduced in ECMAScript 3 (1999). URIError is an ECMAScript built-in, not a Web API.
Sintaxe
new URIError(message)
URIError(message)URIError é um tipo de erro padrão do ECMAScript que herda de Error; não é uma interface de Web API. Não significa qualquer endereço inválido: diz respeito a falhas em operações de codificação e descodificação de URI.
decodeURI e decodeURIComponent lançam um URIError quando encontram escapes percentuais malformados, como %ZZ, ou sequências de bytes que não codificam UTF-8 válido. encodeURI e encodeURIComponent lançam-no perante um substituto UTF-16 sem par. As variantes com Component processam componentes individuais de URI; as restantes têm em conta o papel dos caracteres reservados numa URI completa.
new URIError(message) cria um objeto; só por si, a sua criação não lança uma exceção. A chamada URIError(message) sem new também cria um objeto. Para lançar o teu próprio erro, usa throw new URIError(message). A propriedade name tem como valor predefinido "URIError"; o texto de message gerado automaticamente depende da implementação.
Coloca a descodificação de dados não fidedignos num bloco try...catch. No código habitual executado num único realm, verifica error instanceof URIError e volta a lançar as outras exceções. Esta verificação pode falhar para um erro proveniente de outro realm, por exemplo, de outra frame. O exemplo descodifica texto válido e trata uma sequência UTF-8 incompleta sem depender do texto da mensagem.
Exemplos
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);
}
}Resultado
hello world URIError
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.