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

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

Biblioteka xlsx jest potężnym narzędziem do pracy z plikami Excel (XLSX) w aplikacjach opartych na Node.js. Umożliwia odczyt, zapis oraz konwersję danych z i do formatów Excel. W tym artykule przedstawimy, jak zainstalować i używać tej biblioteki w swoim projekcie.

### Instalacja

Aby rozpocząć korzystanie z biblioteki xlsx, należy najpierw zainstalować ją w swoim projekcie. Można to zrobić za pomocą npm, narzędzia do zarządzania paczkami w Node.js. W terminalu wprowadź następujące polecenie:

```bash

npm install xlsx

```

Po zakończeniu instalacji w folderze projektu pojawi się nowy folder `node_modules`, w którym znajduje się zainstalowana biblioteka.

### Podstawowe użycie

Po zainstalowaniu biblioteki, możesz zacząć korzystać z jej funkcji. Oto przykładowy kod, który demonstruje, jak odczytać dane z pliku XLSX oraz jak zapisać dane do nowego pliku.

#### Odczyt danych

Pierwszym krokiem jest zaimportowanie biblioteki oraz odczytanie pliku XLSX. Załóżmy, że masz plik o nazwie `example.xlsx`.

```javascript

const XLSX = require('xlsx');

// Odczyt pliku

const workbook = XLSX.readFile('example.xlsx');

// Wybór pierwszego arkusza

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

// Konwersja arkusza do formatu JSON

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

console.log(data);

```

W powyższym kodzie najpierw wczytujemy plik XLSX do zmiennej `workbook`. Następnie wybieramy pierwszy arkusz za pomocą `workbook.SheetNames[0]`. Funkcja `XLSX.utils.sheet_to_json` konwertuje arkusz do formatu JSON, co ułatwia dalszą manipulację danymi.

#### Zapis danych

Możemy również tworzyć nowe pliki XLSX i zapisywać do nich dane. Oto przykład, jak to zrobić:

```javascript

const XLSX = require('xlsx');

// Tworzenie nowego workbooka

const newWorkbook = XLSX.utils.book_new();

// Przygotowanie danych do zapisania

const newData = [

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

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

];

// Konwersja danych do arkusza

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

// Dodawanie arkusza do workbooka

XLSX.utils.book_append_sheet(newWorkbook, newWorksheet, 'Dane');

// Zapis do pliku

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

```

W tym przykładzie tworzymy nowy workbook, przygotowujemy przykładowe dane, konwertujemy je na arkusz, a następnie dodajemy arkusz do workbooka i zapisujemy do pliku `nowy_plik.xlsx`.

### Dodatkowe funkcje

Biblioteka xlsx oferuje wiele dodatkowych funkcji, które mogą być przydatne w bardziej złożonych aplikacjach. Oto kilka z nich:

1. **Odczyt wielu arkuszy**: Możesz łatwo odczytać wszystkie arkusze w pliku oraz przetworzyć je.

2. **Formatowanie komórek**: Możesz modyfikować formatowanie poszczególnych komórek w arkuszu.

3. **Obsługa formularzy i wykresów**: Biblioteka xlsx pozwala na pracę z bardziej zaawansowanymi elementami plików Excel, takimi jak formularze czy wykresy.

### Przykłady bardziej zaawansowanego użycia

Możesz łączyć różne arkusze w jeden plik lub konwertować dane z różnych formatów. Oto przykład, jak odczytać dane z wielu arkuszy:

```javascript

const workbook = XLSX.readFile('example.xlsx');

workbook.SheetNames.forEach(sheetName => {

const worksheet = workbook.Sheets[sheetName];

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

console.log(`Dane z arkusza ${sheetName}:`, data);

});

```

W powyższym kodzie używamy metody `forEach`, aby przejść przez wszystkie arkusze w workbooku i odczytać dane z każdego z nich.

### Wnioski

Biblioteka xlsx w Node.js jest bardzo przydatnym narzędziem do pracy z plikami Excel. Dzięki prostym metodom, możesz łatwo odczytywać i zapisywać dane w formacie XLSX. W miarę rozwijania projektu możesz odkrywać bardziej zaawansowane opcje, które biblioteka oferuje.