Codifica y decodifica URLs y cadenas de consulta con codificación porcentual. Elige modo componente, URI completa o datos de formulario, con conversión bidireccional instantánea.
Codifica texto para URLs con codificación porcentual, o vuelve al original. Escribe en cualquiera de los dos campos y el otro se actualiza al instante. Elige el modo según dónde vaya a usarse el valor: un parámetro de consulta, una URL completa o el envío de un formulario HTML.
Una URL no es texto libre. Caracteres como ?, #, &, / y = son reservados: tienen significado estructural y marcan dónde termina la ruta y empieza la consulta, o separan un parámetro del siguiente. Si el valor que quieres transmitir contiene uno de esos caracteres, el analizador del otro extremo leerá mal tu URL. La codificación porcentual lo resuelve sustituyendo el byte problemático por un % seguido de su valor hexadecimal de dos dígitos, de modo que un & dentro de un valor viaja como %26 y nunca puede confundirse con un separador.
RFC 3986 divide el espacio de caracteres en tres grupos.
A-Z a-z 0-9 - . _ ~. Nunca necesitan codificación y conviene dejarlos tal cual. Codificarlos es legal, pero produce URLs más feas y puede romper comparaciones de cadenas ingenuas.: / ? # [ ] @ ! $ & ' ( ) * + , ; =. Solo son seguros donde deben ser estructurales. Dentro de un valor hay que codificarlos.La codificación porcentual opera sobre bytes, no sobre caracteres, así que primero hay que convertir el texto a bytes. La respuesta moderna es siempre UTF-8. El signo € ocupa tres bytes en UTF-8 (E2 82 AC), por lo que se codifica como %E2%82%AC. Los sistemas antiguos usaban a veces el propio juego de caracteres de la página, y por eso todavía aparece alguna URL ilegible codificada en Latin-1 o GBK. Esta herramienta usa UTF-8 en todo momento, igual que los navegadores y todos los frameworks actuales.
encodeURIComponent es la opción segura por defecto y escapa todos los caracteres reservados. Úsalo siempre que insertes un valor dentro de una URL. encodeURI conserva deliberadamente los caracteres reservados para que una URL completa siga intacta: úsalo solo para ordenar una URL ya montada, nunca sobre un parámetro suelto, porque dejará tal cual un & de tu valor y corromperá la cadena de consulta.
El modo formulario es el caso raro. La serialización application/x-www-form-urlencoded, anterior a las especificaciones modernas de URL, codifica un espacio como + y no como %20. Ambas son correctas en una cadena de consulta y los servidores aceptan las dos, pero si construyes a mano el cuerpo de un POST deberías seguir la convención de formulario.
+Como la codificación de formulario da un significado especial al +, un signo más literal dentro de un valor de formulario debe codificarse como %2B. Este es el fallo de codificación más habitual: una cadena base64 o un teléfono en formato internacional se pasan tal cual y el receptor convierte cada + en un espacio. Si tus datos pueden contener signos más, codifícalos explícitamente o evita el modo formulario.
Codificar una cadena ya codificada convierte cada % en %25, así que %20 pasa a ser %2520. Casi siempre es un error: ocurre cuando el código de la aplicación codifica un valor y luego un framework o un proxy lo vuelven a codificar. Si ves %25 en una URL donde no pretendías un signo de porcentaje literal, estás ante un valor doblemente codificado. Decodificar dos veces recupera el original, pero la solución real es eliminar uno de los pasos.