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

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.

Fuentes