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

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

Biblioteka `xlsx` to potężne narzędzie, które umożliwia odczyt i zapis plików Excel (formaty .xlsx, .xls) w aplikacjach Node.js. Dzięki niej można łatwo manipulować danymi w skoroszytach bez potrzeby korzystania z zewnętrznych aplikacji biurowych. W tym artykule przedstawimy krok po kroku, jak zainstalować i używać tej biblioteki.

### Instalacja biblioteki

Aby rozpocząć pracę z biblioteką `xlsx`, najpierw musisz zainstalować ją w swoim projekcie. Użyj poniższego polecenia w terminalu:

```bash

npm install xlsx

```

### Odczyt danych z pliku Excel

Po zainstalowaniu biblioteki `xlsx`, można przystąpić do odczytu danych z pliku Excela. Oto prosty przykład:

```javascript

const xlsx = require('xlsx');

// Wczytanie skoroszytu

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

// Wybór arkusza z pierwszej zakładki

const worksheet = workbook.Sheets[workbook.SheetNames[0]];

// Przekształcenie danych arkusza do formatu JSON

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

// Wyświetlenie odczytanych danych

console.log(data);

```

Powyższy kod odczytuje plik Excel i konwertuje zawartość pierwszego arkusza na format JSON, co ułatwia dalszą obróbkę danych.

### Zapis danych do pliku Excel

Zapisowanie danych do pliku Excel również jest niezwykle proste. Oto przykład, jak to zrobić:

```javascript

const xlsx = require('xlsx');

// Przygotowanie danych do zapisania

const data = [

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

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

];

// Tworzenie arkusza z danych

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

// Tworzenie nowego skoroszytu

const workbook = xlsx.utils.book_new();

// Dodawanie arkusza do skoroszytu

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

// Zapis do pliku Excel

xlsx.writeFile(workbook, 'ścieżka/do/twojego/nowego_pliku.xlsx');

```

W powyższym przykładzie dane są konwertowane ze struktury JSON do arkusza, który następnie jest dodawany do nowego skoroszytu, a na końcu zapisywany jako plik Excel.

### Manipulacja danymi w pliku Excel

Biblioteka `xlsx` pozwala także na manipulację danymi w istniejących plikach Excel. Możesz dodawać nowe arkusze, aktualizować istniejące i usuwać arkusze. Oto przykład aktualizacji danych:

```javascript

const xlsx = require('xlsx');

// Wczytanie istniejącego pliku

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

const worksheet = workbook.Sheets[workbook.SheetNames[0]];

// Odczyt danych jako JSON

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

// Modyfikacja danych - przykład dodania nowego rekordu

data.push({ Imię: 'Tomasz', Nazwisko: 'Wiśniewski', Wiek: 28 });

// Aktualizacja arkusza po zmianach

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

xlsx.utils.book_append_sheet(workbook, newWorksheet, 'ZaktualizowanyArk');

// Zapis do pliku

xlsx.writeFile(workbook, 'ścieżka/do/aktualizowanego_pliku.xlsx');

```

### Obsługa różnych formatów

Biblioteka `xlsx` obsługuje różne formaty plików, w tym .xls i .xlsx. Dzięki temu możesz pracować z plikami starych wersji Excela lub nowszymi wersjami, co czyni ją elastycznym narzędziem w wielu sytuacjach.

### Wnioski

Biblioteka `xlsx` dla Node.js to niezwykle funkcjonalne narzędzie do pracy z danymi w arkuszach kalkulacyjnych. Oferuje szeroki wachlarz funkcji, od odczytu po zapis i manipulację danymi. Dzięki prostej składni i potężnym możliwościom, staje się niezastąpionym elementem większości projektów wykorzystujących dane w formacie Excel.