CKTIS / JavaScript
decodeURI — decodificar una URI
decodeURI decodifica las secuencias de porcentaje del texto de una URI y conserva los delimitadores codificados, como %2F. Aprende en qué se diferencia de decodeURIComponent y cómo trata las entradas mal formadas.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
decodeURI(encodedURI)decodeURI(encodedURI) es una función global de ECMAScript diseñada para decodificar URI completas. Primero convierte su argumento en una cadena y después devuelve una cadena nueva: las secuencias %HH que representan bytes UTF-8 se convierten en los caracteres Unicode correspondientes. No modifica la entrada ni requiere API del navegador.
Conserva las secuencias de porcentaje que representan ;/?:@&=+$,#, incluida la combinación de mayúsculas y minúsculas de sus dígitos hexadecimales. Por eso, %20 se convierte en un espacio, pero %2F sigue siendo %2F. Un + literal también permanece igual: la función no decodifica la convención de formularios que representa los espacios con +.
decodeURIComponent está pensada para componentes individuales de una URI y también decodifica los delimitadores codificados, por ejemplo, %2F como /. No la apliques sin cuidado a una URI completa, porque podrías cambiar los límites de sus componentes. decodeURI no es un analizador ni un validador de la dirección completa.
Una secuencia de porcentaje mal formada, como %ZZ, o una codificación UTF-8 incompleta o no válida provoca una excepción URIError, en lugar de devolver un resultado parcial. Para datos externos, gestiona este caso con try...catch. Decodifica solo el nivel de codificación necesario: otra llamada puede volver a cambiar el resultado; por ejemplo, %2520 primero se convierte en %20 y luego en un espacio.
Ejemplos
const encoded = '/caf%C3%A9%20menu?q=a%2Fb+c';
console.log(decodeURI(encoded));
console.log(decodeURIComponent(encoded));
try {
decodeURI('%E0%A4');
} catch (error) {
console.log(error.name);
}Resultado
/café menu?q=a%2Fb+c /café menu?q=a/b+c 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.