Bezplatná Node.js knihovna pro otevření a čtení Excel souborů

Začínáme s read-excel-file

Pro instalaci read-excel-file můžete použít npm, správce balíčků pro JavaScript. Pro úspěšnou instalaci použijte prosím následující příkazy.

npm install read-excel-file --save

Čtení velkých Excel souborů v Node.js aplikacích

Vývojáři softwaru často potřebují integrovat schopnost číst Excel soubory do svých aplikací. Open source knihovna read-excel-file usnadňuje vývojářům načítání a čtení malých i velkých Excel souborů v aplikacích Node.js pomocí jen několika řádků kódu. Podporuje různé formáty souborů, včetně .xls a .xlsx, čímž je kompatibilní s širokou škálou verzí Excelu. Dále zajišťuje parsování a formátování dat, takže vývojáři mohou snadno přistupovat k extrahovaným informacím a manipulovat s nimi. Následující jednoduchý příklad demonstruje, jak přečíst Excel soubor v prostředí Node.js pomocí JavaScriptových příkazů.

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);
});

Flexibilní parsování dat v Node.js

Open source knihovna read-excel-file zahrnuje kompletní podporu pro flexibilní parsování dat, což umožňuje vývojářům definovat vlastní schémata pro interpretaci dat. Tato funkce je obzvláště užitečná při práci s komplexními Excel soubory, které obsahují různé datové typy a struktury. Definováním schématu můžete zajistit, že data budou parsována správně a konzistentně. Pro pokročilejší scénáře můžete definovat schéma, které mapuje sloupce Excelu na konkrétní datové typy a struktury. Následující příklad ukazuje, jak mohou vývojáři definovat vlastní schéma pro validaci struktury a obsahu Excel souborů v aplikacích 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);
  }
});

Vlastní typy a parsování data v Node.js

Knihovna read-excel-file poskytuje robustní podporu pro vlastní typy a parsování datumů, což je zvláště užitečné při práci s komplexními datovými strukturami v Excel souborech. Jedná se o velmi užitečnou funkci, která umožňuje vývojářům definovat, jak mají být různé datové typy, včetně datumů, parsovány, čímž se zajišťuje integrita a konzistence dat. Pro definování vlastního schématu vytvoříte objekt, kde klíče jsou názvy sloupců z Excel souboru a hodnoty popisují vlastnosti, typy a validační pravidla pro tyto sloupce. V níže uvedeném příkladu jsou hodnoty sloupce "Event Date" parsovány do objektů Date a metoda toISOString se používá k formátování datumů jako ISO řetězců.

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);
});

Lepší podpora pro zpracování chyb

Robustní funkce pro zpracování chyb jsou zahrnuty v open-source balíčku read-excel-file. Problémy s validací, které nastanou během parsování, jsou zaznamenány a lze je vhodně vyřešit nebo zalogovat. Aby byla zajištěna integrita načítaných dat, knihovna zahrnuje validační pravidla a nabízí jasné chybové signály. To vývojářům usnadňuje rychleji najít a opravit problémy s daty nebo samotným Excel souborem.