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

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

Biblioteka xlsx to popularne narzędzie w ekosystemie Node.js, umożliwiające odczytywanie i zapisywanie plików w formacie Excel (XLSX). Dzięki niej możemy łatwo pracować z danymi tabelarycznymi w aplikacjach JavaScript. W poniższym artykule przedstawimy, jak zainstalować tę bibliotekę oraz jak wykorzystać jej funkcje w praktyce.

## Instalacja biblioteki xlsx

Aby zacząć pracę z biblioteką xlsx, najpierw musisz zainstalować ją w swoim projekcie. Otwórz terminal i przejdź do katalogu swojego projektu, a następnie wykonaj następującą komendę:

```bash

npm install xlsx

```

Po zainstalowaniu biblioteki możesz rozpocząć jej używanie w swoim kodzie.

## Odczytywanie danych z pliku Excel

Aby odczytać dane z pliku XLSX, najpierw musisz zaimportować bibliotekę xlsx i użyć funkcji `readFile`, która pozwala na załadowanie pliku. Poniżej znajduje się przykładowy kod pokazujący, jak to zrobić:

```javascript

const XLSX = require('xlsx');

// Odczyt pliku Excel

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

// Wybór arkusza

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

const worksheet = workbook.Sheets[sheetName];

// Konwersja danych na format JSON

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

console.log(data);

```

Powyższy kod odczytuje dane z pierwszego arkusza pliku Excel i konwertuje je na format JSON, który jest bardziej przystępny w JavaScript.

## Zapisywanie danych do pliku Excel

Aby zapisać dane do pliku Excel, potrzebujesz stworzyć nowy arkusz (worksheet) oraz workbook. Oto jak to zrobić:

```javascript

const XLSX = require('xlsx');

// Przykładowe dane do zapisania

const data = [

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

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

];

// Konwersja danych na arkusz

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

// Stworzenie nowego workbook

const workbook = XLSX.utils.book_new();

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

// Zapisanie workbook do pliku

XLSX.writeFile(workbook, 'ścieżka/do/zapisu/pliku.xlsx');

```

W powyższym przykładzie tworzymy arkusz z przykładowymi danymi, a następnie zapisujemy go do nowego pliku Excel.

## Dodatkowe opcje

Biblioteka xlsx oferuje wiele dodatkowych funkcji, takich jak:

- Odczytywanie formuł z komórek.

- Stylizacja komórek.

- Obsługa różnych formatów (XLS, CSV, itp.).

Można je znaleźć w dokumentacji biblioteki, co daje wielką elastyczność w pracy z plikami Excel.

## Przykłady praktycznego użycia

Poniżej przedstawiamy kilka scenariuszy, w których biblioteka xlsx może być szczególnie użyteczna:

1. **Generowanie raportów** - Tworzenie dynamicznych raportów finansowych lub sprzedażowych na podstawie danych z bazy danych.

2. **Import i eksport danych** - Umożliwienie użytkownikom importowania lub eksportowania danych do i z aplikacji w formacie Excel.

3. **Analiza danych** - Wczytywanie dużych zbiorów danych z plików Excel do aplikacji do analizy i wizualizacji.

Biblioteka xlsx to wszechstronne narzędzie, które może znacznie ułatwić pracę z danymi w formacie Excel w aplikacjach napisanych w Node.js.