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

# Użycie biblioteki xlsx w Node.js z npm

Biblioteka `xlsx` to popularne narzędzie w ekosystemie Node.js, które umożliwia odczyt i zapis arkuszy kalkulacyjnych w różnych formatach, takich jak Excel (XLSX) oraz CSV. W tym artykule skupimy się na tym, jak używać tej biblioteki w swoim projekcie Node.js.

## Instalacja biblioteki xlsx

Pierwszym krokiem jest zainstalowanie biblioteki `xlsx` za pomocą menedżera pakietów npm. Aby to zrobić, otwórz terminal i wpisać następującą komendę:

```bash

npm install xlsx

```

To polecenie doda bibliotekę do Twojego projektu i zapisz ją w pliku `package.json`.

## Odczyt danych z pliku XLSX

Aby odczytać dane z istniejącego pliku XLSX, możemy użyć funkcji `readFile` z biblioteki `xlsx`. Oto przykładowy kod:

```javascript

const xlsx = require('xlsx');

// Wczytanie pliku XLSX

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

// Wybranie pierwszego arkusza

const sheetName = workbook.SheetNames[0];

const worksheet = workbook.Sheets[sheetName];

// Konwersja danych na format JSON

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

console.log(data);

```

W powyższym przykładzie:

1. Wczytujemy plik XLSX przy użyciu `readFile`.

2. Uzyskujemy nazwę pierwszego arkusza i następnie ładujemy ten arkusz.

3. Konwertujemy dane arkusza na format JSON, co ułatwia dalszą obróbkę.

## Zapis danych do pliku XLSX

Aby zapisać dane do pliku XLSX, użyjemy metody `writeFile`. Poniżej znajduje się 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 nowego arkusza

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

// Tworzenie nowego skoroszytu

const workbook = xlsx.utils.book_new();

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

// Zapis do pliku XLSX

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

```

W tym przypadku:

1. Przygotowujemy dane w formacie tablicy obiektów.

2. Tworzymy nowy arkusz z tych danych.

3. Tworzymy nowy skoroszyt i dodajemy do niego arkusz.

4. Zapisujemy skoroszyt do nowego pliku XLSX.

## Odtwarzanie formatu CSV

Biblioteka `xlsx` pozwala również na odczyt i zapis plików CSV. Oto przykład odczytu pliku CSV:

```javascript

const xlsx = require('xlsx');

// Wczytanie pliku CSV

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

// Użycie pierwszego arkusza

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

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

console.log(data);

```

Aby zapisać dane do formatu CSV, można użyć następującego kodu:

```javascript

const xlsx = require('xlsx');

// Przygotowanie danych do zapisania

const data = [

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

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

];

// Tworzenie nowego arkusza

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

// Tworzenie nowego skoroszytu

const workbook = xlsx.utils.book_new();

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

// Zapis do pliku CSV

xlsx.writeFile(workbook, 'ścieżka/do/nowego_pliku.csv', { bookType: 'csv' });

```

Ten kod pokazuje, jak możesz utworzyć plik CSV przy użyciu podobnych danych, co w przypadku pliku XLSX.

## Podsumowanie

Biblioteka `xlsx` w Node.js jest wszechstronnym narzędziem do pracy z arkuszami kalkulacyjnymi. Umożliwia łatwe odczytywanie i zapisywanie danych w różnych formatach. Dzięki tej bibliotece, praca z danymi w plikach Excel i CSV staje się znacznie prostsza, co może być niezwykle użyteczne w wielu projektach programistycznych.