Herramienta encodeURIComponent

Cuando arma una cadena de consulta, un solo espacio o ampersand sin escapar puede partir un parámetro y romper una integración. Esta herramienta encodeURIComponent aplica las mismas reglas que encodeURIComponent y decodeURIComponent de JavaScript: al salir, los caracteres reservados se convierten en secuencias porcentuales, y al volver, las secuencias %XX válidas recuperan su texto legible.

Qué protege realmente encodeURIComponent

Una URL completa no es un bloque opaco único. Los esquemas, los separadores de ruta, los delimitadores de consulta y los marcadores de fragmento tienen un significado estructural. encodeURIComponent es la función que usted emplea cuando el valor debe viajar como dato dentro de esa estructura sin reescribir la estructura misma.

Los espacios pasan a %20, los ampersands a %26, los signos de igual a %3D, y el texto no ASCII, como las letras acentuadas o los emojis, se expande en secuencias porcentuales UTF-8 para que los proxies y los servidores no interpreten mal los límites de bytes. Eso es distinto de encodeURI, que deja intactos muchos caracteres reservados porque supone que usted codifica una dirección entera.

Si codifica un enlace https:// completo con reglas de componente, los dos puntos y las barras se convierten en secuencias % y el enlace deja de funcionar. Si deja sin codificar un término de búsqueda de texto libre y lo pega después de ?, un & incrustado parece un parámetro nuevo.

Esta herramienta siempre usa la semántica de componente para que cada valor sea seguro al colocarse tras una clave, entre segmentos de ruta cuando el segmento es dato, o dentro del cuerpo de un formulario que después se vuelve consulta.

Cómo usarlo y leer el resultado

Envíe un campo text con la cadena que le interesa y un campo mode opcional con valor encode o decode. La codificación es lo predeterminado: el motor ejecuta encodeURIComponent sobre la entrada y devuelve mode, la entrada original, la salida transformada y la longitud de la salida, para que las tuberías puedan comprobar presupuestos de tamaño sin una segunda pasada. La decodificación ejecuta decodeURIComponent y devuelve la misma forma con la cadena recuperada en output.

Las cadenas vacías son válidas y viajan de ida y vuelta a cadenas vacías. La falta del campo text también falla la validación antes de ejecutar cualquier transformación. Prefiera codificar cada valor y luego unir con caracteres & y = literales, en vez de codificar una cadena de consulta ya armada, para que los delimitadores sigan siendo estructurales y solo se escapen los caracteres de carga útil.

Dónde encaja la codificación de componentes en flujos reales

Las interfaces de búsqueda y filtro construyen enlaces compartibles a partir de frases tecleadas por el usuario que incluyen espacios, comillas y alfabetos no latinos; codificar cada campo antes de ensamblar mantiene estable el enlace compartido entre clientes de correo y apps de chat que reescriben las URL sueltas. Las herramientas de registros y soporte suelen mostrar líneas de petición crudas con secuencias porcentuales; decodificar esos valores recupera los términos de búsqueda o los nombres de archivo originales para investigar sin pegarlos en una consola desechable.

Las migraciones de datos revierten columnas doblemente codificadas cuando un exportador antiguo codificó dos veces, o aplican una única codificación de componente coherente al guardar valores que después se insertarán en redirecciones. Las listas de verificación de enseñanza y revisión de código usan una referencia fiable de encodeURIComponent para que los desarrolladores junior comparen los ayudantes de cada lenguaje contra la base de JavaScript y detecten bibliotecas que tratan de forma distinta los signos más o las tildes.