Datos en archivos

En resumen: CSV es un archivo de texto en el que cada línea es un registro y los valores van separados por comas; el programa divide las líneas en partes y las convierte en objetos.

Problema

Texto, pero necesitas números

El almacén exporta sus productos a un archivo. Cada fila es un producto: nombre, precio y existencias, separados por comas. La primera fila dice qué hay en cada columna:

products.csv

Nombre,Precio,Existencias
Pan,1.20,30
Leche,2.10,18
Café en grano,18.90,12

Ya sabes leer el archivo. Pero para el programa, la fila es solo texto:

const line = "Pan,1.20,30";
console.log(line.length);
console.log(line[4]);

Salida

11
1

No sabe que 1.20 es un precio y que 30 es una cantidad. Para calcular cuánto vale la mercancía, tienes que convertir cada fila en algo con campos: un objeto Product.

La idea

CSV: de fila a objeto

Un archivo así se llama CSV (comma-separated values, «valores separados por comas»). Lo lee Excel, lo leen las bases de datos, lo lee cualquier programa. Una fila se convierte en objeto en tres pasos: split, convertir cada parte al tipo que necesitas y el constructor.

Lo más cómodo es que sea un método estático (static) en la propia clase:

function toNumber(text) {
  const n = Number(text);
  if (text.trim() === "" || Number.isNaN(n)) {
    throw new Error(`número incorrecto (${text.trim()})`);
  }
  return n;
}

class Product {
  constructor(name, price, stock) {
    this.name = name;
    this.price = price;
    this.stock = stock;
  }

  static fromCsv(line) {
    const f = line.split(",");
    if (f.length !== 3) {
      throw new Error(`esperaba 3 columnas, pero hay ${f.length}`);
    }
    return new Product(f[0].trim(), toNumber(f[1]), toNumber(f[2]));
  }

  toCsv() {
    return `${this.name},${this.price},${this.stock}`;
  }
}

const p = Product.fromCsv("Café en grano,18.90,12");
console.log(`${p.name}: ${p.price.toFixed(2)} € x ${p.stock} = ${(p.price * p.stock).toFixed(2)} €`);

Salida

Café en grano: 18.90 € x 12 = 226.80 €

fromCsv es el único lugar que sabe cómo es la fila. Si el formato cambia, cambias solo eso. La comprobación del número de columnas lanza un error con un mensaje claro, en lugar de que el programa se detenga más tarde con uno confuso.

Number("siete") no lanza ningún error: da NaN («no es un número»), y Number("") da 0. Un programa que no lo comprueba calcula en silencio con números equivocados. Por eso toNumber comprueba el texto y lanza por su cuenta.

Qué hace fromCsv con la fila, paso a paso, con su cuerpo desarrollado línea por línea:

const line = "Café en grano,18.90,12";
const f = line.split(",");
const name = f[0];
const price = Number(f[1]);
const stock = Number(f[2]);
const p = new Product(name, price, stock);
console.log(`${p.name}: ${p.price} € x ${p.stock}`);
console.log(`${(p.price * p.stock).toFixed(2)} €`);

Paso a paso, en palabras

1. La fila del archivo es una sola cadena. Para el programa, el 18.90 que hay en ella son solo cuatro caracteres.
2. split corta la fila en cada coma: un array de tres cadenas.
3. El nombre sigue siendo una cadena.
4. Number convierte la cadena "18.90" en el número 18.9. Ya se puede calcular con él.
5. Number saca de "12" el número 12. En JavaScript tanto el precio como la cantidad son number.
6. new Product pone los tres valores en los campos de un objeto nuevo, y p apunta a él.
7. p.price se imprime como 18.9: el cero del final solo estaba en el texto.
8. El precio por las existencias: ahora es un cálculo con números.

Míralo

El archivo completo

Cargas todos los productos en un array y calculas el valor de la mercancía. Aquí y a partir de ahora, import { readFileSync, writeFileSync } from "node:fs"; está arriba del todo y no se muestra:

try {
  writeFileSync("products.csv", "Nombre,Precio,Existencias\nPan,1.20,30\nLeche,2.10,18\nCafé en grano,18.90,12\n");
  const lines = readFileSync("products.csv", "utf8").trimEnd().split("\n");
  const products = [];
  let header = true;
  for (const line of lines) {
    if (header) {
      header = false;
      continue;
    }
    products.push(Product.fromCsv(line));
  }
  let value = 0;
  for (const p of products) {
    value += p.price * p.stock;
  }
  console.log(`${products.length} productos, existencias por valor de ${value.toFixed(2)} €`);
} catch (e) {
  console.log(`No puedo leer products.csv: ${e.message}`);
}

Salida

3 productos, existencias por valor de 300.60 €

• products empieza como un array vacío, y push añade cada producto nuevo al final. products.length es cuántos hay.
• header es true solo en la primera vuelta. Entonces la fila se salta con continue.

Hay más sobre los arrays que crecen en el módulo «Colecciones».

La idea

Filas incorrectas

Los archivos los escriben personas y otros programas. Tarde o temprano llega una fila a la que le falta una columna, con una palabra en lugar de un número, o una fila vacía:

products.csv

Nombre,Precio,Existencias
Pan,1.20,30
Leche,2.10
Café,siete,4

Té,3.50,25

Un error no debe detener la carga de todo lo demás. Cada fila va en su propio try, y el mensaje da el número de fila, para que alguien pueda corregirla:

try {
  writeFileSync("products.csv", "Nombre,Precio,Existencias\nPan,1.20,30\nLeche,2.10\nCafé,siete,4\n\nTé,3.50,25\n");
  const lines = readFileSync("products.csv", "utf8").trimEnd().split("\n");
  const products = [];
  let row = 0;
  for (const line of lines) {
    row++;
    if (row === 1 || line.trim() === "") {
      continue;
    }
    try {
      products.push(Product.fromCsv(line));
    } catch (e) {
      console.log(`Fila ${row}: ${e.message}`);
    }
  }
  console.log(`Cargados: ${products.length}`);
} catch (e) {
  console.log(`No puedo leer products.csv: ${e.message}`);
}

Salida

Fila 3: esperaba 3 columnas, pero hay 2
Fila 4: número incorrecto (siete)
Cargados: 2

• Las filas vacías se saltan con line.trim() === "".
• Un solo catch atrapa los dos errores que lanza fromCsv: el del número de columnas y el de toNumber. e.message dice cuál ocurrió.
• El programa dice «Cargados: 2» y sigue con ellos.

Pruébalo

Columnas vacías

En la primera fila el precio está vacío, en la segunda las existencias. La tercera fila convierte una columna vacía en número:

¿Qué imprimirá el programa?

console.log("Café,,4".split(",").length);
console.log("Café,7.50,".split(",").length);
console.log(Number(""));

Respuesta

3
3
NaN

3
2
NaN

3
3
0

Comprobar

La idea

De objetos a CSV

La otra dirección es un método que arma la fila:

toCsv() {
  return `${this.name},${this.price},${this.stock}`;
}

Escribes la fila de encabezado y después una fila por cada objeto:

const stock = [new Product("Pan", 1.2, 30), new Product("Leche", 2.1, 18)];
try {
  let text = "Nombre,Precio,Existencias\n";
  for (const p of stock) {
    text += `${p.toCsv()}\n`;
  }
  writeFileSync("stock.csv", text);
  process.stdout.write(readFileSync("stock.csv", "utf8"));
} catch (e) {
  console.log(`No puedo escribir stock.csv: ${e.message}`);
}

Salida

Nombre,Precio,Existencias
Pan,1.2,30
Leche,2.1,18

fromCsv puede volver a leer este archivo. Guardar y leer tienen que usar el mismo formato.

Cuidado si formateas los precios con toLocaleString. Sigue la configuración de idioma, y en español, alemán y muchos otros idiomas la marca decimal es una coma:

const es = `Pan,${(1.2).toLocaleString("es-ES", { minimumFractionDigits: 2 })},30`;
console.log(`${es}  -> ${es.split(",").length} columnas`);
const fixed = `Pan,${(1.2).toFixed(2)},30`;
console.log(`${fixed}  -> ${fixed.split(",").length} columnas`);

Salida

Pan,1,20,30  -> 4 columnas
Pan,1.20,30  -> 3 columnas

1,20 se convierte en dos columnas, y las filas se desplazan. Para archivos que leerá otro programa, usa toFixed(2). Siempre da un punto, en cualquier computadora.

Pruébalo

Encuentra el error

El programa debería cargar los tres productos de products.csv, pero se detiene ya en la primera fila:

Error

Error: número incorrecto (Precio)

Elige la línea con el error.

1let row = 0;2let loaded = 0;3for (const line of lines) {4 row++;5 if (row === 0) {6 continue;7 }8 const p = Product.fromCsv(line);9 loaded++;10}11console.log(`Cargados: ${loaded}`);

Comprobar

La idea

Columnas por nombre

Otro programa exporta los mismos datos, pero con las columnas en otro orden y con una más. Si escribes f[1] para el precio, con un formato nuevo leerás la columna equivocada y no te darás cuenta. Es más seguro buscar la columna por su nombre en la fila de encabezado:

function column(header, name) {
  for (let i = 0; i < header.length; i++) {
    if (header[i].trim().toLowerCase() === name.toLowerCase()) {
      return i;
    }
  }
  throw new Error(`No existe la columna ${name}`);
}

try {
  writeFileSync("export.csv", "Existencias,Nombre,Código,Precio\n30,Pan,1001,1.20\n18,Leche,1002,2.10\n");
  let nameCol = -1;
  let priceCol = -1;
  for (const line of readFileSync("export.csv", "utf8").trimEnd().split("\n")) {
    const f = line.split(",");
    if (nameCol === -1) {
      nameCol = column(f, "nombre");
      priceCol = column(f, "precio");
      continue;
    }
    console.log(`${f[nameCol]}: ${f[priceCol]} €`);
  }
} catch (e) {
  console.log(e.message);
}

Salida

Pan: 1.20 €
Leche: 2.10 €

La primera vuelta solo busca dónde están las columnas. Después, cada fila se lee por esos índices. Si la columna no existe, column lanza una excepción enseguida, en lugar de leer datos equivocados.

Más precisamente, para curiosos

• Una coma en el valor. «Queso, curado» lleva una coma. En CSV un valor así va entre comillas: "Queso, curado",9.80,5, y una comilla dentro se escribe doble: "". Entonces split(",") ya no basta. Node no tiene un módulo integrado para CSV. En proyectos reales se usa una biblioteca como csv-parse o Papa Parse, que conoce todas las reglas.
• Otro separador. Excel en una computadora con la configuración en español o en alemán suele guardar el CSV con ;, precisamente porque la coma es la marca decimal. Entonces cortas la fila con split(";").
• JSON. Para datos que solo leerá tu programa, en JavaScript se usa casi siempre JSON: JSON.stringify(product) convierte el objeto en texto, y JSON.parse(text) lo devuelve a objeto.

Ejercicio

Datos que cobran vida

Resuelve las tareas en tu editor. El programa crea primero él mismo el archivo de entrada.

1. Análisis de un CSV. Crea people.csv con el contenido de abajo. Imprime la edad media (división entera), quién es la persona de más edad y cuántas personas hay de cada ciudad, en el orden en que aparecen las ciudades. Guarda las ciudades en un array, y las cantidades en otro, en los mismos índices.

people.csv

Nombre,Edad,Ciudad
Carlos,34,Madrid
María,28,Sevilla
Jorge,41,Madrid
Elena,25,Valencia

Salida

Edad media: 32
De más edad: Jorge, 41
Personas de Madrid: 2
Personas de Sevilla: 1
Personas de Valencia: 1

2. Guardar al héroe. Una clase Hero con nombre, nivel, vida y oro. El método save(path) guarda al héroe como líneas clave=valor, y el método estático load(path) crea un Hero nuevo a partir de un archivo así. Crea a «Arin» con nivel 6, 100 de vida y 120 de oro, súbele el nivel en 1, quítale 15 de vida, dale 220 de oro, guárdalo, imprime el archivo y vuelve a cargarlo.

Salida

name=Arin
level=7
health=85
gold=340
Cargado: Arin, nivel 7, vida 85, oro 340

3. Texto duplicado. Crea text.txt con el texto de abajo. Divídelo en oraciones por el punto (y los espacios que lo siguen), e imprime una sola vez cada oración que aparece más de una vez.

text.txt

Esto es texto. Esto también es texto. Esto es texto.

Salida

Texto duplicado: "Esto es texto."

Más tareas

• El producto más caro. Carga products.csv de la lección, e imprime el producto con el precio más alto y cuántos productos tienen menos de 20 en existencias.
• Filas corregidas. Carga el archivo con las filas incorrectas, y escribe las buenas en products-clean.csv, y las incorrectas, con el número de fila y el motivo, en rejected.txt.
• Informe de ventas. Un archivo sales.csv con las columnas Fecha,Producto,Cantidad,Precio. Las filas están ordenadas por fecha. Imprime los ingresos de cada día con padEnd y toFixed en columnas.

Test

Ponte a prueba

1. ¿Qué es la primera fila de la mayoría de los archivos CSV?

El primer registro con datosUna fila de encabezado con los nombres de las columnasEl número de filas

2. ¿Qué devuelve Number("siete")?

Lanza un errorNaN0

3. ¿Cuánto es "Café,7.50,".split(",").length?

123

4. Guardas precios con price.toLocaleString("es-ES", { minimumFractionDigits: 2 }). ¿Qué pasa con el archivo CSV?

El programa se detiene con un errorNada, los precios llevan puntoLos precios salen con coma, y cada uno se convierte en dos columnas

Comprobar

Empezar la lección de nuevo

Lecciones relacionadas

• Se basa en: Lanzar excepciones y crear las tuyas · Cadenas · Expresiones regulares · Archivos
• Continúa en: Bases de datos
• Ejercicios sobre el tema: Texto y archivos