Convertidor JSON a CSV — Convierte JSON a CSV en línea _

¿Qué es la conversión de JSON a CSV?

JSON (JavaScript Object Notation, RFC 8259) es un formato de texto en forma de árbol para datos estructurados; CSV (Comma-Separated Values, RFC 4180) es un formato de texto plano y tabular. Convertir JSON a CSV aplana ese árbol en filas y columnas, de modo que un conjunto de datos que empezó como respuesta de API se abre limpiamente en una hoja de cálculo sin reescribir una sola fila.

¿Cómo funciona la conversión de JSON a CSV?

Cada conversión se ejecuta localmente en tu navegador. Los pasos principales son:

1. JSON.parse valida la entrada y confirma que es un array de registros en el nivel superior. Se muestra un error claro si los corchetes, comas o claves entrecomilladas no cuadran.
2. El escritor deriva las columnas de cabecera de tus registros: bien la unión de todas las claves vistas, o solo las del primer registro, según el interruptor.
3. Los objetos anidados se aplanan a claves con punto (user.id, user.city) o se serializan como una sola celda JSON, a tu elección. Los arrays dentro de objetos se serializan como JSON en ambos casos.
4. Cada celda se escapa conforme a RFC 4180: cualquier valor que contenga el delimitador, una comilla doble o un salto de línea se envuelve en comillas, y las comillas internas se duplican. Las filas se unen con terminadores de línea \r\n.
5. El CSV aparece en el área de texto de solo lectura, y un enlace de descarga construye un Blob con el tipo MIME text/csv;charset=utf-8 para que puedas guardar el archivo con un clic.

¿Por qué convertir JSON a CSV con esta herramienta?

• Privacidad: cada pasada de análisis, aplanado y escritura ocurre en tu navegador. Los datos nunca llegan a nuestros servidores.
• Corrección: el escritor sigue RFC 4180. Un valor como Bob, Jr. se convierte en "Bob, Jr." — una celda entrecomillada, no dos columnas — y los saltos de línea o comillas embebidas sobreviven la conversión intactos.
• Listo para hoja de cálculo: la salida se pega directamente en Excel o Google Sheets, con las columnas de cabecera ya derivadas de tus claves, así no hay limpieza manual antes de que los datos sean utilizables.
• Flexibilidad: aplana objetos anidados a claves con punto o serializalos como una sola celda, elige cualquier delimitador para dialectos CSV no separados por coma, y decide si las cabeceras vienen de todas las claves o solo del primer registro.

¿Cuáles son las aplicaciones comunes de la conversión de JSON a CSV?

Aplanar JSON a CSV aparece en todo el trabajo de datos y el tooling:

• Exportación de datos: convertir una respuesta de API en un fichero CSV que tu equipo de finanzas, operaciones o producto pueda abrir en Excel o Google Sheets sin escribir código.
• Informes: volcar el resultado de una consulta JSON en una hoja de cálculo para una tabla dinámica, un gráfico o una columna de fórmulas. Ese tipo de trabajo es doloroso contra JSON crudo.
• Revisión en hoja de cálculo: aplanar una configuración JSON anidada (ajustes, feature flags, variantes A/B) en CSV para que revisores no técnicos puedan leerla y editarla celda a celda.

¿Cómo es un ejemplo de conversión de JSON a CSV?

Pega [{"name":"Alice","age":30},{"name":"Bob, Jr.","age":25}], deja el delimitador en coma y pulsa CONVERTIR. Obtienes tres líneas: una fila de cabecera name,age, una fila de datos Alice,30 y una fila "Bob, Jr.",25. Esa coma embebida es exactamente lo que tropieza con una unión ingenua — aquí activa el entrecomillado RFC 4180, de modo que la celda se mantiene entera.

¿Este convertidor de JSON a CSV se ejecuta íntegramente en mi navegador?

Sí. Cada pasada de análisis, aplanado y escritura se ejecuta localmente como JavaScript dentro de tu pestaña del navegador. La herramienta no llama a fetch, XMLHttpRequest ni navigator.sendBeacon en absoluto — tus payloads JSON nunca llegan a nuestros servidores, a un convertidor de terceros ni a ninguna canalización de analítica. La herramienta también funciona sin conexión una vez que la página se ha cargado, porque es un bundle estático HTML/CSS/JS sin dependencias de API en tiempo de ejecución.

¿Cuál es el tamaño máximo de entrada que este convertidor puede gestionar?

El convertidor almacena toda la entrada en memoria y se ejecuta de forma síncrona en el hilo principal, así que los límites prácticos dependen de tu dispositivo. Arrays JSON de hasta unos 10 MB (aproximadamente 100.000 registros típicos) se convierten sin pausa perceptible en un portátil moderno. Más allá de eso la interfaz puede quedarse colgada mientras corre el escritor. La conversión por flujos con un Web Worker más un escritor por chunks es un seguimiento planeado — por ahora, divide los conjuntos de datos muy grandes antes de pegarlos.

¿Cómo gestiona el escritor los valores con comas, comillas o saltos de línea?

Conforme a RFC 4180. Cualquier valor que contenga el delimitador activo, una comilla doble, un CR o un LF se envuelve en comillas dobles, y las comillas internas se duplican. Así un nombre como Bob, Jr. se convierte en la celda única "Bob, Jr." en vez de desbordarse en dos columnas, y una descripción multilínea permanece en una sola celda en lugar de romper la fila. Esta es la parte en que un join(',') ingenuo se equivoca.

¿Qué ocurre con los objetos JSON anidados al convertir a CSV?

Los objetos anidados se gestionan según el interruptor Objetos anidados. En modo Aplanar (el predeterminado), las claves se unen con puntos — {"user":{"id":1,"city":"Paris"}} se convierte en las columnas user.id y user.city. En modo Serializar, el objeto anidado se serializa como un único valor de celda JSON con el escape de comillas de RFC 4180 intacto, preservando su estructura para la ida y vuelta. Los arrays dentro de objetos se serializan como JSON en ambos modos.

¿Qué delimitadores puede usar la salida CSV?

Cuatro: coma (,, el valor predeterminado de RFC 4180), punto y coma (;, habitual en locales europeos), tabulador (\t, el dialecto TSV) y barra vertical (|). Elige el que espera tu herramienta de destino. El escritor escapa cualquier celda que contenga el delimitador elegido, de modo que la elección nunca corrompe un valor.

Este convertidor JSON a CSV aplana tu array y emite salida conforme a RFC 4180 que puedes pegar directamente en una hoja de cálculo, un informe o una revisión de código, sin subir un solo byte. ¿Necesitas la dirección inversa? El convertidor de CSV a JSON analiza en sentido contrario.