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

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

W dzisiejszych czasach obsługa plików Excela w aplikacjach Node.js stała się standardem. Jedną z najpopularniejszych bibliotek do pracy z formatem XLSX jest biblioteka `xlsx`. W tym artykule przedstawimy, jak zainstalować i używać tej biblioteki w projektach Node.js.

## Instalacja

Aby zainstalować bibliotekę `xlsx`, należy najpierw upewnić się, że mamy zainstalowane środowisko Node.js oraz menedżer pakietów npm. Następnie, w terminalu, w katalogu swojego projektu należy wykonać poniższe polecenie:

```bash

npm install xlsx

```

Po zakończeniu instalacji biblioteki, możemy przystąpić do jej użycia.

## Importowanie biblioteki

W pierwszej kolejności musimy zaimportować bibliotekę do naszego pliku JavaScript:

```javascript

const XLSX = require('xlsx');

```

## Odczyt pliku XLSX

Aby odczytać dane z pliku XLSX, użyjemy funkcji `readFile`. Poniżej znajduje się przykład, jak to zrobić:

```javascript

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

// Wyświetlenie nazw arkuszy w skoroszycie

const sheetNames = workbook.SheetNames;

console.log(sheetNames);

// Odczyt danych z pierwszego arkusza

const firstSheet = workbook.Sheets[sheetNames[0]];

const data = XLSX.utils.sheet_to_json(firstSheet);

console.log(data);

```

W powyższym przykładzie najpierw wczytujemy plik XLSX, a następnie odczytujemy nazwy arkuszy oraz konwertujemy dane z pierwszego arkusza do formatu JSON.

## Tworzenie pliku XLSX

Biblioteka `xlsx` umożliwia również tworzenie własnych plików XLSX. Możemy zbudować prostą strukturę danych i zapisać ją w pliku. Oto przykład:

```javascript

const data = [

{ imię: 'Jan', nazwisko: 'Kowalski', wiek: 30 },

{ imię: 'Anna', nazwisko: 'Nowak', wiek: 25 }

];

const newWorkbook = XLSX.utils.book_new();

const newSheet = XLSX.utils.json_to_sheet(data);

// Dodanie arkusza do skoroszytu

XLSX.utils.book_append_sheet(newWorkbook, newSheet, 'Arkusz1');

// Zapisanie pliku

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

```

W tym przykładzie tworzymy prostą tablicę obiektów, konwertujemy ją na arkusz, dodajemy do nowego skoroszytu, a na końcu zapisujemy plik o nazwie `nowy_plik.xlsx`.

## Podsumowanie

Biblioteka `xlsx` w Node.js to potężne narzędzie do pracy z plikami Excela. Oferuje wiele funkcji zarówno do odczytu, jak i zapisu danych w formatcie XLSX. Dzięki prostym w użyciu metodom, programiści mogą skutecznie manipulować danymi w arkuszach kalkulacyjnych.