URL Encode/Decode

Cuando pegás una URL con espacios, acentos o símbolos como <code>&amp;</code>, <code>?</code> o <code>#</code> en un navegador o en tu código, el resultado es impredecible: el servidor puede rechazar la petición, el parámetro se trunca o el link simplemente no abre. El codificador/decodificador de URLs convierte cada carácter problemático a su equivalente <strong>percent-encoding</strong> (por ejemplo, el espacio se vuelve <code>%20</code> y la ñ se vuelve <code>%C3%B1</code>) de acuerdo al estándar RFC 3986.

¿Cuándo hace falta codificar una URL?

El percent-encoding reemplaza cada carácter no permitido por %XX donde XX es el valor hexadecimal del byte UTF-8 correspondiente, según RFC 3986.

El caso más común ocurre con los parámetros GET: si tenés una URL como https://ejemplo.com/buscar?q=café con leche, el espacio y los acentos deben convertirse antes de enviarla. El resultado correcto sería q=caf%C3%A9%20con%20leche. Sin codificación, distintos servidores interpretan el espacio de maneras diferentes — algunos lo aceptan como +, otros devuelven error 400.

También es crítico cuando construís links de compartir en redes sociales, parámetros UTM con caracteres especiales, o cuando armás solicitudes a APIs REST que esperan valores en query string. Los frameworks modernos como React o Vue encodean automáticamente, pero si construís URLs a mano en JavaScript con concatenación de strings, el problema puede pasar desapercibido hasta producción.

Diferencias entre encodeURI y encodeURIComponent

En JavaScript existen dos funciones nativas que hacen cosas distintas: encodeURI() preserva los caracteres estructurales de la URL completa (como /, :, ? y &), mientras que encodeURIComponent() codifica todo lo que no sea alfanumérico, incluyendo esos caracteres. La segunda es la correcta cuando codificás el valor de un parámetro individual, no la URL entera.

Este codificador aplica la lógica equivalente a encodeURIComponent para el modo encode completo, lo que lo hace seguro para valores de parámetros que contienen caracteres como =, & o +. Si estás enviando, por ejemplo, un email como parámetro, el @ debe convertirse en %40; si no lo hacés, el servidor puede confundirlo con la sintaxis de autenticación.

Decodificar: recuperar el texto original

La operación inversa es igual de útil: cuando encontrás una URL larga llena de % en logs de servidor, en parámetros de analytics o en redirects, decodificarla te muestra el texto humano legible en un clic. Por ejemplo, %2Ftienda%2Fproductos%3Fcategoria%3Dropa decodifica a /tienda/productos?categoria=ropa.

En debugging de integraciones con APIs de terceros — como Mercado Libre, Shopify o cualquier OAuth 2.0 — es frecuente que el redirect_uri llegue codificado. Pegarlo aquí te ahorra tener que correrlo manualmente en la consola del navegador.

Cómo funciona — paso a paso

1. 1
   Pegá tu texto o URL

   Ingresá el texto con caracteres especiales (acentos, espacios, símbolos) en el campo de entrada.
2. 2
   Elegí la operación

   Seleccioná Codificar para obtener la versión percent-encoded, o Decodificar para recuperar el texto original desde una URL codificada.
3. 3
   Copiá el resultado

   El resultado aparece instantáneamente. Usá el botón Copiar para llevarlo a tu código, buscador o documento.