Бесплатная библиотека Node.js для открытия и чтения файлов Excel

Начало работы с read-excel-file

Для установки read-excel-file вы можете использовать npm, менеджер пакетов для JavaScript. Пожалуйста, используйте следующие команды для успешной установки.

npm install read-excel-file --save

Чтение больших файлов Excel в приложениях Node.js

Разработчикам часто нужно интегрировать возможности чтения файлов Excel в свои приложения. Открытая библиотека read-excel-file упрощает загрузку и чтение как небольших, так и крупных файлов Excel внутри приложений Node.js, используя всего несколько строк кода. Она поддерживает различные форматы файлов, включая .xls и .xlsx, что делает её совместимой с широким спектром версий Excel. Кроме того, она обрабатывает парсинг и форматирование данных, гарантируя, что разработчики могут легко получить доступ к извлечённой информации и манипулировать ею. Ниже приведён базовый пример, демонстрирующий, как прочитать файл Excel в среде Node.js с помощью 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);
});

Гибкий парсинг данных в Node.js

Открытый исходный код библиотеки read-excel-file предоставляет полную поддержку гибкой обработки данных, позволяя разработчикам определять пользовательские схемы для интерпретации данных. Эта функция особенно полезна при работе со сложными файлами Excel, содержащими различные типы данных и структуры. Определяя схему, вы можете гарантировать корректный и последовательный разбор данных. Для более продвинутых сценариев можно определить схему, сопоставляющую столбцы Excel с конкретными типами данных и структурами. Следующий пример показывает, как разработчики могут определить пользовательскую схему для проверки структуры и содержимого файлов Excel в приложениях 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);
  }
});

Пользовательские типы и парсинг дат в Node.js

Библиотека read-excel-file предоставляет надёжную поддержку пользовательских типов и разбора дат, что особенно полезно при работе со сложными структурами данных в файлах Excel. Это очень полезная функция, позволяющая разработчикам определять, как должны разбираться разные типы данных, включая даты, обеспечивая целостность и согласованность данных. Чтобы определить пользовательскую схему, вы создаёте объект, где ключи – это имена столбцов из файла Excel, а значения описывают свойства, типы и правила проверки для этих столбцов. В приведённом ниже примере значения столбца "Event Date" преобразуются в объекты Date, а метод toISOString используется для форматирования дат в виде строк 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);
});

Поддержка лучшей обработки ошибок

В пакете с открытым исходным кодом read-excel-file реализованы функции надёжной обработки ошибок. Проблемы проверки, возникающие при разборе, фиксируются и могут быть исправлены или задокументированы соответствующим образом. Чтобы гарантировать целостность считываемых данных, библиотека включает правила проверки и предоставляет чёткие сигналы об ошибках. Это облегчает разработчикам поиск и исправление проблем с данными или самим файлом Excel быстрее.