Cómo usar la herramienta
- Elija Codificar o Decodificar.
- Elija el modo: componente / valor de parámetro, URL completa o datos de formulario.
- Pegue el texto o la URL: el resultado aparece al instante.
- Opciones: codificar todos los caracteres o procesar cada línea por separado.
- Consulte el desglose de la URL y copie el resultado.
¿Por qué hay que codificar las URL?
Las URL solo pueden contener un conjunto limitado de caracteres ASCII. Los espacios, las tildes, la ñ y los caracteres con un significado especial, como &, ?, = o #, deben codificarse en los valores. La codificación con porcentaje sustituye cada byte por % seguido de dos dígitos hexadecimales. Un espacio se convierte en %20, y la «ñ», que ocupa dos bytes en UTF-8, en %C3%B1. Sin codificar, un término de búsqueda como «sal & pimienta» rompería la URL, porque el & separaría los parámetros.
Los tres modos
| Modo | Equivalente en JavaScript | Conserva | Uso |
|---|---|---|---|
| Componente / valor de parámetro | encodeURIComponent | solo letras, cifras y - _ . ! ~ * ' ( ) | valores de parámetros, segmentos de ruta |
| URL completa | encodeURI | además : / ? & = # y otros | URL enteras con espacios o tildes |
| Datos de formulario | application/x-www-form-urlencoded | como componente, espacio como + | formularios HTML, cuerpos POST |
Error frecuente: codificar una URL completa con el modo componente. Entonces https:// se convierte en https%3A%2F%2F y la URL deja de funcionar. Al contrario, un valor de parámetro con & debe codificarse como componente; si no, rompe la cadena de consulta.
Decodificar y evitar la doble codificación
Al decodificar, la herramienta convierte las secuencias de porcentaje en texto legible y, en modo formulario, también los signos + en espacios. Los errores se señalan con precisión: un % sin dos dígitos hexadecimales válidos se indica con su posición, igual que las secuencias de bytes que no son UTF-8 válido. Una señal típica de doble codificación es %2520: es un %20 codificado otra vez. Decodifique varias veces hasta recuperar el texto original.
El desglose de la URL
Si introduce una URL completa, la herramienta muestra sus componentes: protocolo, usuario, host, puerto, ruta, cadena de consulta y fragmento. Todos los parámetros de consulta aparecen en una tabla con su clave y su valor decodificado. Resulta muy útil con enlaces de seguimiento de campañas, URL de redirección de inicios de sesión o peticiones de API largas, en las que de otro modo los parámetros cuesta leerlos.
Un ejemplo
Quiere crear un enlace de búsqueda para «café y churros en Málaga». En modo componente, el valor se convierte en caf%C3%A9%20y%20churros%20en%20M%C3%A1laga, que se añade como ?q=… a la URL. En modo formulario obtendría caf%C3%A9+y+churros+en+M%C3%A1laga, que es lo que envía un formulario HTML. Ambas variantes las entiende correctamente el servidor de destino. Para una lista de términos, active «Codificar/decodificar cada línea por separado».
Caracteres reservados y no reservados
La norma RFC 3986 distingue dos grupos. Los caracteres no reservados, letras, cifras y - _ . ~, nunca necesitan codificarse. Los reservados, como : / ? # [ ] @ ! $ & ' ( ) * + , ; =, tienen un significado estructural en la URL y deben codificarse cuando forman parte de un valor. Todo lo demás, incluidos los espacios, las letras con tilde y los emojis, se codifica siempre. Si duda, codifique cada valor de parámetro con el modo componente: es la opción más segura y la que usan las bibliotecas HTTP.
Preguntas frecuentes
¿Cuál es la diferencia entre %20 y +?
Ambos representan un espacio. El + solo es válido en cadenas de consulta de formularios; %20 funciona en todas partes.
¿encodeURI o encodeURIComponent?
encodeURI para URL completas, encodeURIComponent para valores de parámetros y segmentos de ruta.
¿Por qué veo %25 en mi URL?
%25 es el signo de porcentaje codificado y suele indicar doble codificación.
¿Se admiten las tildes y la ñ?
Sí, todos los caracteres se codifican en UTF-8, como esperan los navegadores y servidores modernos.
¿Se envían mis datos?
No, todo ocurre localmente en su navegador.