Codificar y decodificar URL
Pega un texto o una URL y mira al instante la versión codificada o decodificada, con la codificación porcentual (%20, %C3%A7) que usan los navegadores.
Resultado
https://exemplo.com.br/busca?q=ação rápida&cidade=São Paulo
Qué es la codificación de URL
Una URL solo puede llevar un conjunto pequeño de caracteres ASCII. Los espacios, las tildes y símbolos como & y # se convierten en un % seguido de dos dígitos hexadecimales por cada byte UTF-8. La "ç" pasa a %C3%A7 y el espacio a %20.
Por eso una dirección copiada del navegador suele venir llena de %. Decodificar muestra el texto original, y codificar prepara un valor para entrar sin problemas en una URL.
Qué formato elegir
- Componente (encodeURIComponent): para un valor aislado, como el contenido de un parámetro. Codifica / ? & = # y todo lo que podría romper la URL.
- URL completa (encodeURI): para una dirección entera. Deja / ? & = # y : como están, y codifica solo espacios, tildes y otros caracteres no válidos.
- Formulario: igual que el componente, pero el espacio pasa a +. Es el formato de los formularios HTML y de URLSearchParams.
Errores comunes
- Codificar la URL entera como componente, lo que convierte https:// en https%3A%2F%2F y rompe el enlace.
- Codificar dos veces. El % pasa a %25 y %20 pasa a %2520. Si aparece %25 en el resultado, el texto ya estaba codificado.
- Decodificar un valor de formulario como componente. El + sigue siendo + en lugar de pasar a espacio.
Preguntas frecuentes sobre codificar y decodificar URL
Diferencia entre formatos, el espacio y errores de decodificación.
encodeURI conserva los caracteres que estructuran una URL, como / ? & = y #. encodeURIComponent los codifica todos, por eso sirve para valores de parámetros. Para una URL completa, usa encodeURI.
Aparecen los dos. %20 vale en cualquier parte de la URL. El + vale solo en formularios y en la query string, con el formato application/x-www-form-urlencoded. Si dudas, usa %20.
Un % debe ir seguido de dos dígitos hexadecimales, y los bytes de una secuencia deben formar UTF-8 válido. Cuando eso falla, el decodificador nativo lanza un error. Aquí el tramo se queda como está y aparece en la lista de problemas.
Es codificar un texto que ya estaba codificado: %20 pasa a %2520. Si el resultado tiene %25, decodifica una vez y comprueba si ahora es correcto.