Es fácil equivocarse al escapar porque varios trabajos diferentes parecen similares desde la distancia. Tienes texto, el texto contiene caracteres especiales y otro sistema necesita recibirlo sin malinterpretarlo. El error es suponer que un tipo de escape funciona en todas partes.
La codificación de URL, el escape HTML y el escape JSON resuelven diferentes problemas. Un espacio en una cadena de consulta no es el mismo problema que un carácter < en HTML renderizado o una comilla dentro de una cadena JSON. La herramienta Case / Slug / Escape ayuda a mantener esas salidas juntas, pero la parte útil es saber qué salida pertenece al destino que estás preparando.
La codificación de URL es para URL y valores de consulta
Utilice la codificación de URL cuando el texto vaya a un componente de URL, especialmente un parámetro de consulta o un valor que pueda contener espacios, puntuación o caracteres que no sean seguros para la ruta.
Supongamos que un enlace de soporte necesita incluir un término de búsqueda como pricing & billing. Pegar esa frase directamente en una URL puede cambiar la forma en que se interpreta la URL porque & ya tiene significado dentro de una cadena de consulta. La codificación de URL convierte el texto en una forma que puede viajar dentro de la URL sin confundirse con la sintaxis de la URL.
Esto es diferente a crear un slug. Un slug generalmente convierte un título en un segmento de ruta legible como pricing-and-billing. La codificación de URL conserva el valor original de forma más directa para el transporte.
El escape HTML es para el texto que se representará en HTML
Utilice el escape HTML cuando el texto necesite aparecer como texto dentro de un contexto HTML, no convertirse en marcado.
Si un ejemplo de código incluye <button> y desea que los lectores vean esos caracteres, el navegador necesita que los caracteres se escapen. De lo contrario podrá interpretarlos como un elemento real. El escape HTML consiste en evitar que el texto se lea como sintaxis HTML en lugares donde el contenido debería permanecer como texto visible.
Eso importa en la documentación, los campos de CMS, los registros de cambios y la copia del producto. Es especialmente relevante cuando el texto fuente incluye ejemplos de marcas, fragmentos o valores generados por el usuario que no deberían formar parte de la estructura de la página.
El escape JSON es para valores de cadena dentro de JSON
Utilice el escape JSON cuando el texto necesite ubicarse de forma segura dentro de una cadena JSON.
Una comilla es inofensiva en prosa normal, pero dentro de una cadena JSON puede cerrar la cadena antes de tiempo. Una nueva línea también puede necesitar una representación que mantenga válido el JSON. El escape JSON consiste en preservar el valor y al mismo tiempo mantener analizable el JSON circundante.
Esto suele aparecer cuando los equipos comparten ejemplos de API, fragmentos de configuración, cargas útiles de análisis o datos de muestra. Si el siguiente paso es una limpieza más amplia de datos estructurados, combine este artículo con Cómo formatear JSON antes de compartir un ejemplo de API y el Convertidor JSON/YAML/TOML.
Elija el escape según el destino.
La regla más simple es el destino primero.
| Destino | Usar | Por qué |
|---|---|---|
| Valor de consulta de URL o componente de URL | codificación de URL | Evita que el texto se interprete como sintaxis de URL |
| Texto visible dentro de HTML | escape HTML | Evita que los caracteres especiales se conviertan en marcas |
| Valor de cadena dentro de JSON | JSON escapando | Mantiene comillas, barras y saltos de línea analizables |
| Artículo público o título de ruta. | Slug generación | Crea texto de ruta legible en lugar de conservar cada carácter |
Converty ayuda porque puedes pegar una vez y comparar las salidas sin abrir un codificador separado para cada caso. Eso mantiene el trabajo proporcional. No estás construyendo un oleoducto; está preparando un valor de texto para el lugar al que debe ir.
Abra la herramienta Case / Slug / Escape cuando necesite decidir si la siguiente salida debe ser un slug, un valor codificado en URL, texto seguro HTML o una cadena segura JSON.
