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

CKTIS / JavaScript

encodeURIComponent — codificación de un componente URI

encodeURIComponent codifica un único componente URI, como el valor de un parámetro de consulta. Convierte los caracteres especiales y los que no son ASCII en secuencias porcentuales que representan bytes UTF-8.

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

encodeURIComponent(uriComponent)

encodeURIComponent(uriComponent) es una función global de ECMAScript, no una API exclusiva del navegador. Convierte su argumento en una cadena y devuelve una cadena codificada. Úsala para un valor individual, no para una dirección completa.

Deja sin cambios las letras A–Z, a–z, los dígitos 0–9 y - _ . ! ~ * ' ( ). Los demás caracteres se convierten en bytes UTF-8 escritos como %HH. Un espacio se convierte en %20, no en +; un + literal se convierte en %2B.

A diferencia de encodeURI, también codifica separadores como &, =, /, ? y #. Una vez codificados, esos caracteres no actúan como delimitadores al construir una URI. Los apóstrofos y los paréntesis, en cambio, quedan intactos y pueden seguir actuando como delimitadores en ciertas sintaxis de URI, por ejemplo, en las URL de OData. Sin embargo, no es un escape HTML ni una validación de direcciones. Si vuelves a codificar el resultado, % se convierte en %25.

decodeURIComponent revierte la codificación de datos válidos. Un sustituto UTF-16 sin pareja en el argumento de encodeURIComponent provoca un URIError; la función no lo reemplaza automáticamente. El ejemplo muestra cómo codificar un carácter Unicode, un espacio y separadores, y después comprueba que se pueda revertir.

Ejemplos

const value = "ż &+/";
const encoded = encodeURIComponent(value);
console.log(encoded);
console.log(decodeURIComponent(encoded) === value);

Resultado

%C5%BC%20%26%2B%2F
true

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