Formatear, codificar, generar, validar: elegir la herramienta correcta

Las herramientas de desarrollo suelen usar palabras parecidas para trabajos muy distintos. Formatear, codificar, generar, validar, convertir e inspeccionar suenan simples, pero elegir la operación equivocada puede producir resultados confusos.

El flujo más rápido empieza por nombrar la operación correctamente.

Formatear: hacer legibles los datos existentes

Formatear cambia la presentación sin alterar el significado de los datos. Un formateador JSON añade saltos de línea e indentación, pero los valores del objeto deben permanecer iguales.

Usa el formateo cuando los datos ya son válidos y quieres leerlos, revisarlos o commitearlos con diffs más limpios. El Formateador JSON es el ejemplo más claro: puede pretty-print, minificar, ordenar claves y mostrar una vista en árbol para JSON válido.

Codificar: representar datos para un transporte

Codificar cambia cómo se representan los datos para que puedan moverse por un sistema concreto. URL encoding protege caracteres reservados en URLs. Base64 representa bytes como texto. Ninguna de las dos operaciones significa que los datos estén cifrados.

Usa Codificador y decodificador URL para query strings, valores de formulario y componentes URI. Usa Codificador y decodificador Base64 para texto o datos de archivo que necesiten una representación segura para el transporte.

Generar: crear datos nuevos

Generar crea valores nuevos en lugar de transformar la entrada existente. Un generador UUID crea identificadores aleatorios. Un generador de contraseñas crea secretos o frases de contraseña según reglas seleccionadas.

Usa la generación cuando reutilizar datos reales sería arriesgado o engorroso. El Generador UUID es útil para fixtures e IDs temporales. El Generador de contraseñas es útil cuando necesitas valores fuertes creados con criptografía del navegador.

Validar: comprobar si los datos siguen reglas

Validar responde a una pregunta de sí o no: ¿esta entrada sigue la sintaxis o el schema esperado?

La validación JSON comprueba la sintaxis. La validación JSON Schema comprueba estructura y restricciones. La inspección de timestamps comprueba si un número probablemente representa segundos o milisegundos. Validar suele ser el primer paso antes de formatear o convertir.

Convertir: cambiar la forma o la unidad

Convertir transforma una representación en otra. Un timestamp Unix puede convertirse en una fecha ISO 8601. YAML puede convertirse en JSON. JSON puede convertirse en tipos TypeScript. Convertir es útil cuando la misma información debe encajar en otro sistema.

Usa el Conversor de timestamp UTC cuando el mismo instante deba moverse entre segundos Unix, milisegundos, hora local, UTC y cadenas ISO.

Escapar: hacer el texto seguro para HTML

Escapar HTML no es URL encoding. Cuando documentación de API, páginas de error o plantillas SSR incrustan fragmentos JSON, la codificación de entidades evita que <, > y & rompan el markup. Usa Codificador / Decodificador de entidades HTML cuando el límite es HTML, no el transporte.

Una regla de decisión simple

Pregunta qué quieres que le pase a la entrada:

• ¿Necesitas leerla? Formatear.
• ¿Necesitas enviarla por un canal restringido? Codificar.
• ¿Necesitas un valor nuevo? Generar.
• ¿Necesitas saber si es correcta? Validar.
• ¿Necesitas la misma información en otra representación? Convertir.

Esa pequeña distinción ahorra tiempo y evita cambios accidentales en datos que solo querías inspeccionar.