CKTIS / JavaScript
decodeURIComponent — decodificar un componente URI
decodeURIComponent decodifica escapes porcentuales en un componente URI individual e interpreta los bytes codificados como UTF-8. Devuelve texto, deja + sin cambios y lanza URIError si la codificación no es válida.
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
decodeURIComponent(encodedURIComponent)decodeURIComponent(encodedURIComponent) es una función global de ECMAScript para decodificar un componente URI individual. Primero convierte su argumento en una cadena y luego reemplaza los escapes %HH por los caracteres correspondientes, interpretando los bytes codificados como UTF-8. Devuelve una cadena sin modificar el argumento.
A diferencia de decodeURI, también decodifica caracteres reservados escapados como %26, %2F y %3D. Divide una dirección en componentes antes de decodificar sus valores: decodificar antes de tiempo puede convertir los datos en delimitadores. Un + literal permanece sin cambios; la función no lo trata como un espacio.
Los escapes porcentuales incompletos, los dígitos hexadecimales no válidos o un UTF-8 no válido provocan un URIError. Gestiona esta excepción cuando trabajes con datos externos. Decodifica según el número de capas de codificación esperado: %252F se convierte en %2F tras una llamada y en / tras una segunda.
El ejemplo muestra cómo decodificar texto Unicode y caracteres reservados, conservar + y gestionar una entrada mal formada. Esta es una función del lenguaje ECMAScript, no una API que requiera un entorno de navegador.
Ejemplos
const encoded = "caf%C3%A9%20%26%20tea%2Bcake";
console.log(decodeURIComponent(encoded));
console.log(decodeURIComponent("a+b"));
try {
decodeURIComponent("%E0%A4%A");
} catch (error) {
console.log(error.name);
}Resultado
café & tea+cake a+b 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.