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.