Kit de herramientas CSV

¿Qué es un kit de herramientas de CSV?#

CSV es el formato de mínimo común denominador para datos tabulares: toda hoja de cálculo, todo asistente de importación de base de datos y toda herramienta de analítica pueden leerlo, y casi ninguna se pone de acuerdo en los detalles. ¿El delimitador es una coma o un punto y coma? ¿La primera fila contiene las cabeceras? ¿Los valores van entre comillas " o '? Un archivo que se abre perfecto en una herramienta puede llegar destrozado a otra, simplemente porque los valores por defecto difieren. Un kit de herramientas de CSV existe para hacer explícitas esas decisiones y remodelar un archivo para que haga lo que necesitas.

Esta página hace cuatro trabajos, todos con papaparse. Alinear analiza el archivo y rellena cada celda hasta el ancho de su columna, produciendo una cuadrícula monoespaciada y alineada por columnas que puedes pegar directamente en una revisión de código, un README o un informe de fallos: el tipo de disposición que hace saltar una fila desalineada al instante. Vista previa analiza y renderiza la tabla en la propia página, para que puedas echarle un ojo a los datos antes de hacer nada con ellos. CSV → JSON convierte filas en un array JSON (de objetos si hay cabecera, de arrays si no). JSON → CSV va en la otra dirección, tomando un array JSON y emitiendo CSV. Encima de todo eso, puedes ordenar por cualquier columna, deduplicar filas completas, cambiar el delimitador (coma, punto y coma, tabulador o un carácter personalizado) y elegir el carácter de comilla: justo las perillas que deciden si el archivo sobrevive a la siguiente herramienta de tu pipeline.

Cómo usarlo#

1. Pega tu CSV (o JSON, en modo JSON → CSV) en el panel de Entrada a la izquierda. El marcador de posición muestra la forma esperada; Ejemplo carga un pequeño conjunto de datos.
2. Elige un botón de Modo: Alinear, Vista previa o JSON. Cuando se selecciona JSON, aparece un segundo grupo de botones para la dirección: CSV → JSON o JSON → CSV.
3. Ajusta las opciones estructurales en la barra de herramientas:
   • Delimitador: coma, punto y coma, tabulador o personalizado (aparece un campo de un carácter para el valor personalizado, por defecto |).
   • Comilla: doble (") o simple (').
   • Fila de encabezado: marca cuando la fila 1 contiene los nombres de columna; desmárcalo para datos sin cabecera. El modo cabecera rige tanto el análisis como la forma de la salida JSON.
4. Opcionalmente adecenta los datos: elige una columna de Ordenar por (poblada desde tu cabecera, o un índice numérico para entradas sin cabecera), elige Orden ascendente o descendente, y marca Deduplicar para eliminar filas totalmente duplicadas.
5. Lee el resultado en el panel de Salida (o en la cuadrícula de vista previa en modo Vista previa). La cabecera muestra el tamaño de salida y el conteo de filas; usa Copiar para llevártelo. Limpiar reinicia ambos paneles.

Si una fila tiene un número equivocado de campos, o la entrada está mal formada, la barra de estado reporta el número de fila para que arregles el origen en vez de adivinar.

Características principales#

• Salida alineada por columnas. El modo Alinear rellena cada celda hasta el valor más largo de su columna, así un CSV que parecía una pared de comas de pronto se alinea: incalculable para detectar una fila a la que le falta un campo.
• Ambas direcciones a JSON. CSV → JSON produce un array de objetos (con cabecera) o un array de arrays (sin cabecera). JSON → CSV acepta de vuelta cualquiera de las dos formas.
• Consciente del delimitador. Alterna entre coma, punto y coma (común en configuraciones regionales europeas donde la coma es el separador decimal), tabulador (TSV) o un carácter personalizado. La pista bajo la barra de herramientas te recuerda por qué existen los puntos y coma.
• Ordenar y deduplicar. Ordena numéricamente cuando ambos valores parecen números, de lo contrario lexicográficamente. Dedup elimina las repeticiones exactas de fila completa (la fila de cabecera se conserva siempre).
• Vista previa segura. La cuadrícula de vista previa se construye con APIs DOM seguras: solo textContent, nunca innerHTML con tus datos, así incluso un CSV lleno de etiquetas <script> se renderiza como texto inerte.
• Estrictamente lado del cliente, con un Web Worker para entradas de más de 1 MB.

Ejemplo detallado#

Una pequeña lista pegada con una fila duplicada y una cabecera:

Entrada:

name,role,city
Ada,Engineer,London
Lin,Designer,Taipei
Ada,Engineer,London
Sam,Manager,Berlin

La tercera fila repite Ada exactamente. Pulsa Alinear con delimitador Coma, cabecera activada, y luego marca Deduplicar:

name role     city
Ada  Engineer London
Lin  Designer Taipei
Sam  Manager  Berlin

Cada columna rellenada hasta su valor más ancho, así las tres filas se alinean y el Ada duplicado ha desaparecido: la barra de estado reporta una fila eliminada. Ahora cambia el modo a JSON (CSV → JSON) con las mismas opciones:

[
  { "name": "Ada", "role": "Engineer", "city": "London" },
  { "name": "Lin", "role": "Designer", "city": "Taipei" },
  { "name": "Sam", "role": "Manager", "city": "Berlin" }
]

La fila de cabecera se convirtió en las claves del objeto; cada fila de datos restante se convirtió en un objeto. Ordenar por role reordenaría las filas lexicográficamente; ordenar por una columna numérica lo haría por valor.

Preguntas frecuentes#

¿Cuándo debo usar punto y coma en vez de coma?#

Cuando los datos contienen comas como parte de los valores y estás en una configuración regional (gran parte de Europa, América Latina) donde la coma es el separador decimal —3,14 allí es un único número, no dos campos. Excel en esas configuraciones exporta CSV con puntos y coma por defecto. Si un archivo se abre con todo amontonado en la columna A, el delimitador es casi con seguridad el equivocado: cambia a punto y coma y vuelve a alinear.

¿Qué compara exactamente Deduplicar?#

Compara filas enteras en busca de igualdad exacta, después de haber separado la cabecera. Dos filas son duplicadas solo si cada campo coincide, celda a celda. La fila de cabecera nunca se considera duplicada y se conserva siempre. Las coincidencias parciales (mismo nombre, ciudad distinta) no cuentan como duplicados.

¿Cómo decide CSV → JSON entre objetos y arrays?#

Si Fila de encabezado está marcado, cada fila de datos se convierte en un objeto cuyas claves son los nombres de la cabecera. Si está desmarcado, cada fila se convierte en un array de cadenas, etiquetadas como Col 1, Col 2 y siguientes solo en la vista previa: la salida JSON es un array plano de arrays. Marca la opción de cabecera cuando la fila 1 es de verdad nombres de columna; desmárcala para cuadrículas numéricas en bruto.

¿Mis datos se suben a algún sitio?#

No. El análisis y la composición se ejecutan en tu navegador a través de papaparse, empaquetado con la página. Los archivos de más de 1 MB se manejan en un Web Worker para que la interfaz se mantenga responsiva, pero los datos nunca salen de tu dispositivo.