CKTIS / JavaScript
URIError — error de codificación o decodificación de URI
URIError es un tipo de error integrado en JavaScript que indica datos mal formados durante la codificación o decodificación de URI. Aprende cuáles son sus causas habituales, cómo crearlo y cómo gestionar excepciones de forma selectiva.
Versión: Introduced in ECMAScript 3 (1999). URIError is an ECMAScript built-in, not a Web API.
Sintaxis
new URIError(message)
URIError(message)URIError es un tipo de error estándar de ECMAScript que hereda de Error; no es una interfaz de Web API. No significa cualquier dirección no válida: se refiere a fallos en operaciones de codificación y decodificación de URI.
decodeURI y decodeURIComponent lanzan URIError cuando encuentran escapes de porcentaje mal formados, como %ZZ, o secuencias de bytes que no codifican UTF-8 válido. encodeURI y encodeURIComponent lo lanzan si hay un sustituto UTF-16 sin pareja. Las variantes con Component procesan componentes individuales de una URI; las demás tienen en cuenta la función de los caracteres reservados en una URI completa.
new URIError(message) crea un objeto; crearlo por sí solo no lanza una excepción. La llamada URIError(message) sin new también crea un objeto. Para lanzar un error propio, usa throw new URIError(message). La propiedad name tiene el valor predeterminado "URIError"; el texto de message generado automáticamente depende de la implementación.
Incluye la decodificación de datos no confiables en un bloque try...catch. En el código habitual que se ejecuta dentro de un mismo realm, comprueba error instanceof URIError y vuelve a lanzar las demás excepciones. Esta comprobación puede fallar si el error procede de otro realm, por ejemplo, de otro frame. El ejemplo decodifica texto válido y gestiona una secuencia UTF-8 incompleta sin depender del texto del mensaje.
Ejemplos
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
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.