Libreria Node.js gratuita per aprire e leggere file Excel

Guida introduttiva a read-excel-file

Per installare read-excel-file, è possibile utilizzare npm, il gestore di pacchetti per JavaScript. Si prega di usare i comandi seguenti per un'installazione riuscita.

npm install read-excel-file --save

Leggi grandi file Excel nelle app Node.js

Gli sviluppatori software spesso hanno bisogno di integrare la capacità di leggere file Excel nelle loro applicazioni. La libreria open source read-excel-file semplifica l'operazione, consentendo di caricare e leggere file Excel sia piccoli che grandi all'interno delle applicazioni Node.js con sole poche righe di codice. Supporta diversi formati di file, inclusi .xls e .xlsx, rendendola compatibile con un'ampia gamma di versioni di Excel. Inoltre, gestisce il parsing e la formattazione dei dati, garantendo che gli sviluppatori possano accedere e manipolare facilmente le informazioni estratte. L'esempio base seguente dimostra come leggere un file Excel in un ambiente Node.js usando comandi JavaScript.

const readXlsxFile = require('read-excel-file/node');

// Path to your Excel file
const filePath = 'path/to/your/excel-file.xlsx';

readXlsxFile(filePath).then((rows) => {
  // rows is an array of arrays representing the rows and columns of the Excel file
  console.log(rows);
}).catch((error) => {
  console.error('Error reading Excel file:', error);
});

Parsing flessibile dei dati in Node.js

La libreria open source read-excel-file include un supporto completo per il parsing flessibile dei dati, consentendo agli sviluppatori software di definire schemi personalizzati per interpretare i dati. Questa funzionalità è particolarmente utile quando si gestiscono file Excel complessi contenenti vari tipi di dati e strutture. Definendo uno schema, è possibile garantire che i dati vengano analizzati in modo corretto e coerente. Per scenari più avanzati, è possibile definire uno schema per mappare le colonne Excel a tipi di dati e strutture specifiche. L'esempio seguente mostra come gli sviluppatori software possano definire uno schema personalizzato per convalidare la struttura e il contenuto dei file Excel nelle applicazioni Node.js.

const schema = {
  'Column 1': {
    prop: 'column1',
    type: String,
    required: true
  },
  'Column 2': {
    prop: 'column2',
    type: Number
  }
};

readXlsxFile(filePath, { schema }).then(({ rows, errors }) => {
  if (errors.length > 0) {
    console.error('Validation errors:', errors);
  } else {
    console.log(rows);
  }
});

Tipi personalizzati e parsing delle date in Node.js

La libreria read-excel-file fornisce un supporto robusto per tipi personalizzati e il parsing delle date, particolarmente utile quando si gestiscono strutture di dati complesse in file Excel. È una funzionalità molto utile che permette agli sviluppatori di definire come diversi tipi di dati, comprese le date, debbano essere analizzati, garantendo l'integrità e la coerenza dei dati. Per definire uno schema personalizzato, si crea un oggetto in cui le chiavi sono i nomi delle colonne del file Excel e i valori descrivono le proprietà, i tipi e le regole di validazione per quelle colonne. Nell'esempio sotto i valori della colonna 'Event Date' sono convertiti in oggetti Date e il metodo toISOString è usato per formattare le date come stringhe ISO.

const readXlsxFile = require('read-excel-file/node');

// Schema with date parsing
const schema = {
  'Event Date': {
    prop: 'eventDate',
    type: Date,
    required: true
  }
};

// Read and parse the Excel file with date parsing
readXlsxFile('path/to/file.xlsx', { schema }).then(({ rows, errors }) => {
  if (errors.length > 0) {
    console.error('Validation errors:', errors);
  } else {
    rows.forEach(row => {
      console.log(`Event Date: ${row.eventDate.toISOString()}`);
    });
  }
}).catch((error) => {
  console.error('Error reading Excel file:', error);
});

Miglior supporto per la gestione degli errori

Funzionalità robuste di gestione degli errori sono incorporate nel pacchetto open source read-excel-file. I problemi di validazione che si verificano durante il parsing vengono registrati e possono essere affrontati o loggati in modo appropriato. Per garantire l'integrità dei dati letti, la libreria include regole di validazione e offre chiari segnali di errore. Ciò rende più semplice per gli sviluppatori individuare e correggere rapidamente i problemi relativi ai dati o al file Excel stesso.