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 Node.js, które pozwala na odczyt i zapis plików Excel (formaty .xlsx i .xls). Działa zarówno w przeglądarkach, jak i w środowisku Node.js, co czyni ją wszechstronnym rozwiązaniem do pracy z danymi w formacie arkuszy kalkulacyjnych. W tym artykule omówimy, jak używać biblioteki xlsx w Node.js, korzystając z menedżera pakietów npm.

## Instalacja biblioteki xlsx

Aby zainstalować bibliotekę `xlsx`, otwórz terminal i przejdź do folderu swojego projektu. Następnie uruchom polecenie:

```bash

npm install xlsx

```

Po wykonaniu tego polecenia, biblioteka zostanie dodana do twojego projektu jako zależność.

## Odczyt pliku Excel

Aby odczytać plik Excel, musisz najpierw zaimportować bibliotekę `xlsx`, a następnie użyć jej funkcji do załadowania arkusza kalkulacyjnego.

```javascript

const XLSX = require('xlsx');

// Wczytanie pliku Excel

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

// Wybór arkusza

const sheetName = workbook.SheetNames[0]; // wybieramy pierwszy arkusz

const sheet = workbook.Sheets[sheetName];

// Konwersja arkusza na format JSON

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

// Wyświetlenie danych

console.log(data);

```

W powyższym przykładzie:

1. Importujemy bibliotekę `xlsx`.

2. Używamy funkcji `readFile`, aby wczytać plik Excel.

3. Wybieramy pierwszy arkusz z listy arkuszy.

4. Konwertujemy wybrany arkusz na format JSON za pomocą `sheet_to_json`, co pozwala na łatwe manipulowanie danymi.

## Zapis do pliku Excel

Aby zapisać dane do pliku Excel, również musisz korzystać z funkcji z biblioteki `xlsx`. Oto, 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();

// Dodanie arkusza do skoroszytu

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

// Zapisanie skoroszytu do pliku

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

```

W tym przykładzie:

1. Przygotowujemy dane w formie tablicy obiektów.

2. Tworzymy arkusz za pomocą `json_to_sheet`.

3. Tworzymy nowy skoroszyt.

4. Dodajemy arkusz do skoroszytu.

5. Zapisujemy skoroszyt do pliku, korzystając z `writeFile`.

## Wykonywanie dodatkowych operacji

Biblioteka `xlsx` oferuje także dodatkowe funkcjonalności, takie jak formatowanie komórek, tworzenie wykresów czy modyfikowanie istniejących arkuszy. Można to osiągnąć przez manipulację właściwościami arkuszy i skoroszytów.

Przykładowo, jeśli chcesz zmienić format wartości w komórce, możesz to zrobić w następujący sposób:

```javascript

const cell = sheet['A1'];

cell.z = XLSX.SSF.get_table()['@']; // Ustawianie formatu jako tekst

```

W powyższym kodzie zakładamy, że zaczynamy od arkusza, w którym dostępna jest komórka `A1`. Przypisujemy odpowiedni format, aby komórka była traktowana jako tekst.

## Wnioski

Biblioteka `xlsx` w Node.js jest potężnym narzędziem do pracy z plikami Excel. Dzięki prostym funkcjom do odczytu i zapisu, a także możliwości manipulacji danymi, jest przydatna w wielu scenariuszach związanych z przetwarzaniem danych. Może być wykorzystywana w aplikacjach serwerowych, do automatyzacji raportów i wszędzie tam, gdzie istnieje potrzeba interakcji z danymi z arkuszy kalkulacyjnych.