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

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

Biblioteka `xlsx` to popularne narzędzie w ekosystemie JavaScript, które umożliwia łatwe odczytywanie oraz zapisywanie arkuszy kalkulacyjnych w formatach XLSX i CSV. Dzięki tej bibliotece możemy niezwykle efektywnie manipulować danymi, co jest szczególnie przydatne w aplikacjach serwerowych stworzonych w Node.js. Poniżej przedstawiamy kroki, jak zainstalować oraz wykorzystać tę bibliotekę w praktyce.

#### Krok 1: Instalacja biblioteki

Aby rozpocząć korzystanie z biblioteki `xlsx`, najpierw musimy zainstalować ją w naszym projekcie. Możemy to zrobić za pomocą menedżera pakietów npm. W terminalu przechodzimy do katalogu naszego projektu i wpisujemy następującą komendę:

```bash

npm install xlsx

```

#### Krok 2: Odczytywanie danych z pliku XLSX

Po zainstalowaniu biblioteki możemy przystąpić do odczytywania danych. Poniższy kod demonstruje, jak załadować plik XLSX i uzyskać dostęp do danych z jego arkuszy.

```javascript

const xlsx = require('xlsx');

// Załaduj plik

const workbook = xlsx.readFile('sciezka/do/twojego/pliku.xlsx');

// Uzyskaj nazwę arkusza

const sheetName = workbook.SheetNames[0];

// Uzyskaj arkusz

const worksheet = workbook.Sheets[sheetName];

// Konwertuj arkusz na JSON

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

console.log(data);

```

W powyższym przykładzie `workbook` to obiekt reprezentujący nasz plik, a `worksheet` to obiekt pojedynczego arkusza. Używamy funkcji `sheet_to_json`, aby przekształcić zawartość arkusza w formacie JSON, co ułatwia dalszą manipulację danymi.

#### Krok 3: Zapis danych do pliku XLSX

Oprócz odczytu danych, biblioteka `xlsx` pozwala również na zapis danych do pliku XLSX. Poniższy przykład pokazuje, jak stworzyć nowy arkusz, dodać do niego dane i zapisać go jako plik XLSX.

```javascript

const xlsx = require('xlsx');

// Stwórz nowy arkusz

const data = [

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

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

];

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

// Utwórz nowy skoroszyt

const newWorkbook = xlsx.utils.book_new();

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

// Zapisz plik

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

```

W tym przypadku tworzymy arkusz na podstawie tablicy obiektów, a następnie dodajemy go do nowego skoroszytu. Na końcu zapisujemy skoroszyt jako nowy plik XLSX.

#### Krok 4: Obsługa plików CSV

Biblioteka `xlsx` pozwala także na pracę z plikami CSV. Odbywa się to w sposób podobny do pracy z plikami XLSX. Możemy na przykład wczytać plik CSV i przekonwertować go na JSON, jak pokazano poniżej:

```javascript

const xlsx = require('xlsx');

// Załaduj plik CSV

const workbook = xlsx.readFile('sciezka/do/twojego/pliku.csv', { codepage: 65001 });

// Uzyskaj pierwszy arkusz

const sheetName = workbook.SheetNames[0];

const worksheet = workbook.Sheets[sheetName];

// Konwertuj arkusz na JSON

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

console.log(data);

```

Również możemy zapisać dane w formacie CSV. W powyższym przypadku wystarczy zmienić rozszerzenie na `.csv`.

#### Krok 5: Dodatkowe opcje i formatowanie

Biblioteka `xlsx` oferuje szereg dodatkowych opcji, które umożliwiają dostosowanie procesu odczytu i zapisu, w tym formatowanie komórek, dodawanie stylów, a także obsługę zaawansowanych funkcji XLSX. Wykorzystywanie tych opcji może wymagać głębszej analizy dokumentacji biblioteki.

W celu uzyskania bardziej zaawansowanych informacji na temat użycia biblioteki `xlsx`, warto zapoznać się z jej dokumentacją dostępną na [GitHubie](https://github.com/SheetJS/sheetjs).

Dzięki powyższym krokowym instrukcjom użytkowanie biblioteki `xlsx` w Node.js stało się prostsze, a zarządzanie danymi w formacie arkuszy kalkulacyjnych jest teraz w zasięgu ręki.