Codificador/Decodificador de URL
Un codificador de URL convierte los caracteres no permitidos en direcciones web a un formato seguro llamado percent-encoding, definido por el RFC 3986. Caracteres como espacios, acentos, la eñe y símbolos como & o ? pueden romper una URL o cambiar su significado, por lo que se reemplazan con un signo de porcentaje seguido del valor hexadecimal del byte — un espacio se convierte en %20 y la letra 'ñ' en %C3%B1 en UTF-8. Esta herramienta codifica y decodifica cadenas al instante en tu navegador.
Elegir entre encodeURIComponent y encodeURI es importante. encodeURIComponent escapa todos los caracteres reservados, siendo la opción correcta para valores individuales de query string, datos de formularios y segmentos de ruta. encodeURI preserva los caracteres que estructuran una URL — como :, /, ? y & — y sirve para codificar una dirección completa sin romperla. La decodificación hace el proceso inverso, convirtiendo secuencias percent-encoded de vuelta a texto legible, útil para inspeccionar parámetros de analítica, solicitudes de API y enlaces compartidos.
Como funciona
El percent-encoding convierte cada carácter inseguro a su secuencia de bytes UTF-8 y representa cada byte como % seguido de dos dígitos hexadecimales. Por ejemplo, el espacio (byte 0x20) se convierte en %20 y 'é' (bytes UTF-8 0xC3 0xA9) en %C3%A9. encodeURIComponent escapa todo excepto A-Z, a-z, 0-9 y - _ . ! ~ * ' ( ), mientras que encodeURI además preserva los delimitadores reservados ; , / ? : @ & = + $ #. La decodificación interpreta cada secuencia %XX de vuelta a su byte y reconstruye el texto UTF-8.
Casos de uso
- Codificar parámetros de query string con espacios, acentos o símbolos antes de armar una URL
- Decodificar enlaces de seguimiento y parámetros UTM para inspeccionar los datos que transportan
- Preparar URLs de solicitudes de API donde la entrada del usuario debe insertarse de forma segura
- Depurar enlaces rotos causados por doble codificación o caracteres especiales sin escapar
Preguntas frecuentes
¿Qué es la codificación de URL y para qué sirve?
La codificación de URL, también llamada percent-encoding, reemplaza los caracteres inseguros o reservados con un signo % seguido del valor hexadecimal del byte, según el RFC 3986. Es necesaria porque las URLs solo aceptan un conjunto limitado de caracteres ASCII, y símbolos como &, ? e = tienen significados estructurales. La codificación garantiza que datos como términos de búsqueda o nombres con acentos viajen por la URL sin romperla.
¿Cuál es la diferencia entre encodeURI y encodeURIComponent?
encodeURIComponent escapa todos los caracteres reservados, incluidos / ? & = y :, por lo que debe usarse para valores individuales como parámetros de consulta. encodeURI mantiene intactos esos delimitadores estructurales, siendo adecuado para codificar una URL completa. Usar el método incorrecto puede romper la URL o dejar un valor ambiguo.
¿Por qué el espacio se convierte en %20 en una URL?
El carácter de espacio tiene el valor de byte 0x20 en ASCII/UTF-8, y el percent-encoding representa cada byte como % seguido de dos dígitos hexadecimales, dando %20. En el formato antiguo application/x-www-form-urlencoded, usado por formularios HTML, el espacio también puede aparecer como un signo de más (+), por eso existen ambas representaciones.
¿Cómo decodifico una URL con %C3%B1 o códigos similares?
Secuencias como %C3%B1 son caracteres UTF-8 de varios bytes que fueron percent-encoded — en este caso, la letra 'ñ'. Pega la cadena en un decodificador de URL y convertirá cada par %XX de vuelta a su byte, interpretando el conjunto como texto UTF-8. Esta herramienta decodifica al instante en el navegador, sin enviar datos a ningún servidor.
¿La doble codificación puede romper mis URLs?
Sí. Si una cadena ya codificada se codifica de nuevo, los propios signos % se escapan a %25, así que %20 se convierte en %2520 y la URL ya no decodifica al texto original. Esto ocurre cuando varios sistemas codifican el mismo valor. Para corregirlo, decodifica repetidamente hasta que no queden secuencias %25 y codifica exactamente una vez.