Безкоштовна бібліотека 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.