Codificador / decodificador de URL

Acerca del codificador / decodificador de URL

Las URL solo pueden contener un conjunto limitado de caracteres, así que los espacios, los acentos y símbolos como &, ? y = deben codificarse por porcentaje (un espacio pasa a ser %20) para viajar con seguridad en una dirección web. Esto codifica texto a esa forma y lo decodifica de vuelta a algo legible. Los desarrolladores lo usan constantemente para valores de cadena de consulta, URL de redirección y callback, parámetros de API, y para decodificar un enlace codificado y ver lo que realmente contiene.

Cómo funciona

La codificación ofrece dos ámbitos:

• Componente (el uso por defecto) codifica un único valor que va dentro de una URL — escapa &, =, ?, /, #, + y más, así que el valor no puede romper la estructura de la URL. Este es el que se usa para un parámetro de cadena de consulta.
• URL completa preserva los caracteres que dan estructura a una URL (:, /, ?, &, #), así que puedes codificar una dirección entera sin destrozarla.

La decodificación convierte las secuencias %XX de vuelta a caracteres, y también convierte + en un espacio, siguiendo cómo los envíos de formularios codifican los espacios. Las secuencias de porcentaje inválidas se señalan.

Supuestos y comportamiento

• El modo componente es el valor por defecto seguro para codificar un valor que insertas en una URL; el modo URL completa es para codificar una dirección completa.
• La decodificación trata + como un espacio, siguiendo la convención application/x-www-form-urlencoded usada por los envíos de formularios HTML y muchas cadenas de consulta.
• La codificación se basa en UTF-8, así que los caracteres acentuados y no latinos se codifican en las secuencias de porcentaje multibyte correctas.

Limitaciones

• Los dos ámbitos de codificación no son intercambiables. El modo URL completa deja &, =, ?, / y # sin escapar, así que usarlo en un valor que contiene esos caracteres romperá la URL — usa el modo componente para valores.
• La regla + → espacio al decodificar es la convención de codificación de formularios. En contextos donde se pretendía un + literal (ya codificado como %2B), está bien, pero un + en bruto pensado literalmente se convertiría en un espacio.
• Codifica texto; no valida que el resultado sea una URL bien formada ni que la dirección exista.
• La codificación por porcentaje mal formada (como un % suelto o %ZZ) se informa como un error al decodificar.

Privacidad

La codificación y decodificación se ejecutan por completo en tu navegador. Tu texto nunca se sube ni se almacena.