Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes