Codificador / Decodificador de URL

Un codificador de URL convierte los caracteres que no se pueden usar directamente en una URL en secuencias codificadas con porcentaje. Un decodificador de URL invierte el proceso, transformando el texto codificado porcentualmente de vuelta a los caracteres originales. Esta página hace las dos cosas, en ambas direcciones, tanto para un componente de URL individual como para una URL completa.

El sistema utiliza las cuatro funciones JavaScript estándar:

• encodeURIComponent — para codificar un componente de URL individual, como el valor de un parámetro de consulta.
• encodeURI — para codificar una URL completa preservando los caracteres reservados como : / ? # & = que tienen significado estructural.
• decodeURIComponent — para decodificar un componente de URL individual de vuelta a sus caracteres originales.
• decodeURI — para decodificar una URL completa sin tocar los caracteres reservados.

Todas las conversiones son compatibles con UTF-8, por lo que las letras acentuadas, los emoji y los caracteres de scripts no latinos se procesan correctamente. No se sube nada, no se almacena nada y no hay llamadas a API.

Algunos ejemplos prácticos de cómo se ve la codificación URL en la práctica:

• Un espacio se convierte en %20, así que hola mundo se codifica como hola%20mundo.
• Una barra diagonal en un valor de consulta se convierte en %2F, así que a/b se convierte en a%2Fb como parámetro.
• Un signo de interrogación en un valor se convierte en %3F, así que ¿qué? se convierte en %C2%BFqu%C3%A9%3F.
• Un ampersand en un valor se convierte en %26, lo que evita romper la cadena de consulta circundante.
• Una almohadilla en un valor se convierte en %23, así que c# se convierte en c%23.
• Los caracteres no ASCII usan secuencias UTF-8 multibyte. Por ejemplo café se convierte en caf%C3%A9 (la é ocupa dos bytes UTF-8).
• Los emoji también usan UTF-8 multibyte: 😀 se convierte en %F0%9F%98%80.

Cambia la herramienta a Decodificar y pega cualquiera de estas cadenas codificadas para ver el texto original restaurado exactamente.

Elegir el modo correcto importa porque los dos codificadores tratan los caracteres reservados de manera diferente.

Usa el modo Componente (encodeURIComponent / decodeURIComponent) cuando codifiques un valor individual que se insertará en una URL — por ejemplo el valor de un parámetro de consulta, un segmento de ruta o un valor de fragmento. El modo Componente codifica porcentualmente los caracteres reservados (: / ? # [ ] @ ! $ & ' ( ) * + , ; =) para que no puedan cambiar accidentalmente la estructura de la URL circundante.

Usa el modo URL completa (encodeURI / decodeURI) cuando tengas una URL completa como https://ejemplo.com/ruta?consulta=valor#fragmento y solo quieras escapar los caracteres no seguros (por ejemplo espacios o caracteres no ASCII), sin tocar los caracteres estructurales reservados.

Un error frecuente es usar encodeURI en un valor que debe ser un parámetro de consulta. Los caracteres reservados quedan intactos, lo que puede corromper la URL circundante. Ante la duda, codifica cada valor con encodeURIComponent y construye la URL después.

La codificación porcentual (también llamada codificación URL) es una forma de representar en una URL caracteres reservados (con significado estructural) o caracteres directamente no permitidos. Cada byte no seguro se escribe como un signo de porcentaje seguido de dos dígitos hexadecimales — por ejemplo %20 para un espacio, %2F para una barra o %3F para un signo de interrogación.

La codificación trabaja sobre bytes, no directamente sobre caracteres. Las URL modernas usan UTF-8 para convertir primero los caracteres en bytes, razón por la que una sola letra acentuada puede convertirse en dos bytes codificados porcentualmente y un emoji en cuatro. Esta herramienta siempre usa UTF-8 para que las cadenas codificadas sean interoperables con el resto de la web.

La codificación porcentual está definida por el RFC 3986. Las funciones JavaScript nativas usadas aquí implementan esa especificación, por lo que un valor codificado con encodeURIComponent en cualquier navegador moderno se decodifica correctamente con decodeURIComponent en cualquier otro lugar.

Este codificador decodificador de URL es útil siempre que necesites mover texto de forma segura dentro o fuera de una URL. Escenarios comunes:

• Codificar texto para una cadena de consulta antes de pegarlo en una solicitud de API, una línea de registro o la barra de dirección del navegador.
• Decodificar parámetros de URL de un registro de solicitudes o una exportación de analíticas para leer los valores originales.
• Inspeccionar una URL codificada larga decodificándola y comprobando qué se está transmitiendo realmente.
• Escapar caracteres especiales en una URL antes de compartirla en un chat, documentación o payload JSON.
• Aprender cómo la codificación porcentual y las secuencias de bytes UTF-8 se corresponden con los caracteres.

Como la herramienta se ejecuta completamente en tu navegador, también es adecuada para URL sensibles (enlaces internos, tokens, URL firmadas) que preferiría no pegar en un servicio remoto.

La codificación URL y la limpieza de URL son dos operaciones distintas que a menudo se confunden.

La codificación URL (esta herramienta) transforma caracteres a una forma segura para URL usando codificación porcentual, y la operación inversa convierte el texto codificado de vuelta a los caracteres originales. La estructura de la URL se preserva; no se añade ni elimina nada.

La limpieza de URL (un tipo de herramienta diferente) elimina parámetros de seguimiento como utm_source, utm_medium, fbclid, gclid y claves de consulta similares de una URL, de modo que el enlace resultante ya no contiene metadatos de seguimiento. La limpieza cambia los parámetros de la URL; la codificación no.

Si quieres eliminar parámetros de seguimiento, necesitas un limpiador de URL dedicado. Si quieres codificar o decodificar texto en formato codificado porcentualmente, esta es la herramienta correcta.