jak używać biblioteki xlsx w node js z npm

# Jak używać biblioteki xlsx w Node.js z npm

Biblioteka `xlsx` w Node.js umożliwia pracę z arkuszami kalkulacyjnymi Excel (.xlsx). Dzięki niej można czytać, pisać i manipulować danymi w plikach Excel w prosty sposób. W tym artykule omówimy, jak zainstalować tę bibliotekę, jak jej używać oraz jak wykonać kilka podstawowych operacji na plikach Excel.

## Instalacja biblioteki xlsx

Aby rozpocząć korzystanie z biblioteki `xlsx`, należy najpierw zainstalować ją przy użyciu npm. Otwórz terminal i w projekcie Node.js wpisz następującą komendę:

```bash

npm install xlsx

```

Po zainstalowaniu biblioteki można ją zaimportować do projektu.

## Importowanie biblioteki

W pliku JavaScript, w którym chcesz pracować z biblioteką `xlsx`, zaimportuj ją w następujący sposób:

```javascript

const xlsx = require('xlsx');

```

Teraz możesz korzystać z metod tej biblioteki.

## Odczyt pliku Excel

Aby odczytać plik Excel, użyj metody `xlsx.readFile()`. Poniższy kod pokazuje, jak to zrobić:

```javascript

const workbook = xlsx.readFile('ścieżka/do/pliku.xlsx');

```

Po załadowaniu pliku możesz uzyskać dostęp do arkuszy. Aby to zrobić, użyj metody `xlsx.utils.sheet_to_json()`:

```javascript

const sheetName = workbook.SheetNames[0]; // nazwa pierwszego arkusza

const worksheet = workbook.Sheets[sheetName];

const data = xlsx.utils.sheet_to_json(worksheet);

console.log(data);

```

Dzięki temu uzyskasz tablicę obiektów, w której każdy obiekt reprezentuje wiersz w arkuszu.

## Tworzenie pliku Excel

Możesz również stworzyć nowy plik Excel. Przykład pokazuje, jak wykonać tę operację:

```javascript

const newData = [

{ Imię: 'Jan', Nazwisko: 'Kowalski', Wiek: 30 },

{ Imię: 'Anna', Nazwisko: 'Nowak', Wiek: 25 },

];

const newWorksheet = xlsx.utils.json_to_sheet(newData);

const newWorkbook = xlsx.utils.book_new();

xlsx.utils.book_append_sheet(newWorkbook, newWorksheet, 'Arkusz1');

xlsx.writeFile(newWorkbook, 'nowy_plik.xlsx');

```

W powyższym kodzie tworzysz nowy arkusz na podstawie danych w formacie JSON i zapisujesz go w nowym pliku Excel.

## Modyfikacja istniejącego pliku Excel

Możesz również modyfikować istniejące pliki Excel. Najpierw wczytaj plik, a następnie wprowadź zmiany:

```javascript

const workbook = xlsx.readFile('istniejący_plik.xlsx');

const sheetName = workbook.SheetNames[0];

const worksheet = workbook.Sheets[sheetName];

// Dodaj nowy wiersz

const newRow = { Imię: 'Katarzyna', Nazwisko: 'Wiśniewska', Wiek: 28 };

const newData = xlsx.utils.sheet_to_json(worksheet);

newData.push(newRow);

const updatedWorksheet = xlsx.utils.json_to_sheet(newData);

xlsx.utils.book_append_sheet(workbook, updatedWorksheet, sheetName);

xlsx.writeFile(workbook, 'zmieniony_plik.xlsx');

```

W przykładowym kodzie wczytujesz istniejący plik, a następnie dodajesz do niego nowy wiersz przed zapisaniem go jako nowy plik.

## Zapis danych do pliku Excel

Możesz również zapisać dane z bazy danych lub z innych źródeł w Excelu. Przykład poniżej pokazuje, jak to zrobić:

```javascript

const data = [

{ Nazwa: 'Produkt A', Cena: 100, Ilość: 50 },

{ Nazwa: 'Produkt B', Cena: 200, Ilość: 30 },

];

const worksheet = xlsx.utils.json_to_sheet(data);

const workbook = xlsx.utils.book_new();

xlsx.utils.book_append_sheet(workbook, worksheet, 'Produkty');

xlsx.writeFile(workbook, 'produkty.xlsx');

```

Dzięki tym krokom można łatwo zapisać dane do pliku Excel, co jest przydatne przy tworzeniu raportów lub eksportowaniu danych.

## Wnioski

Biblioteka `xlsx` w Node.js to potężne narzędzie do pracy z arkuszami kalkulacyjnymi Excel. Umożliwia ona łatwy odczyt, zapis i modyfikację plików Excel, co czyni ją idealnym rozwiązaniem dla projektów wymagających manipulacji danymi w formacie XLSX.