Darmowa biblioteka Node.js do otwierania i odczytywania plików Excel

Rozpoczęcie pracy z read-excel-file

Aby zainstalować read-excel-file, możesz użyć npm, menedżera pakietów dla JavaScript. Użyj poniższych poleceń, aby przeprowadzić pomyślną instalację.

npm install read-excel-file --save

Odczyt dużych plików Excel w aplikacjach Node.js

Programiści często potrzebują wbudować możliwość odczytu plików Excel w swoich aplikacjach. Biblioteka open‑source read‑excel‑file ułatwia deweloperom ładowanie i odczyt małych oraz dużych plików Excel w aplikacjach Node.js za pomocą kilku linijek kodu. Obsługuje różne formaty plików, w tym .xls i .xlsx, co czyni ją kompatybilną z wieloma wersjami Excela. Ponadto radzi sobie z parsowaniem i formatowaniem danych, zapewniając programistom łatwy dostęp do wyodrębnionych informacji i możliwość ich manipulacji. Poniższy prosty przykład pokazuje, jak odczytać plik Excel w środowisku Node.js przy użyciu poleceń 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);
});

Elastyczne parsowanie danych w Node.js

Biblioteka open‑source read‑excel‑file zawiera pełne wsparcie dla elastycznego parsowania danych, umożliwiając programistom definiowanie własnych schematów interpretacji danych. Funkcja ta jest szczególnie przydatna w przypadku złożonych plików Excel zawierających różne typy danych i struktury. Definiując schemat, możesz zapewnić, że dane są parsowane poprawnie i spójnie. W bardziej zaawansowanych scenariuszach możesz zdefiniować schemat mapujący kolumny Excela na określone typy danych i struktury. Poniższy przykład pokazuje, jak programiści mogą zdefiniować własny schemat weryfikujący strukturę i zawartość plików Excel w aplikacjach 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);
  }
});

Niestandardowe typy i parsowanie dat w Node.js

Biblioteka read‑excel‑file zapewnia solidne wsparcie dla własnych typów i parsowania dat, co jest szczególnie przydatne przy obsłudze złożonych struktur danych w plikach Excel. Jest to bardzo użyteczna funkcja, pozwalająca programistom określić, jak różne typy danych, w tym daty, powinny być parsowane, zapewniając integralność i spójność danych. Aby zdefiniować własny schemat, tworzysz obiekt, w którym klucze to nazwy kolumn z pliku Excel, a wartości opisują właściwości, typy i reguły walidacji dla tych kolumn. W poniższym przykładzie wartości w kolumnie "Event Date" są parsowane na obiekty Date, a metoda toISOString jest używana do formatowania dat jako łańcuchów 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);
});

Lepsze wsparcie obsługi błędów

W pakiecie open‑source read‑excel‑file zaimplementowano solidne mechanizmy obsługi błędów. Problemy z walidacją, które pojawiają się podczas parsowania, są rejestrowane i mogą być odpowiednio obsłużone lub zalogowane. Aby zagwarantować integralność odczytywanych danych, biblioteka zawiera reguły walidacji i oferuje czytelne komunikaty o błędach. Dzięki temu programiści szybciej wykrywają i naprawiają problemy z danymi lub samym plikiem Excel.