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

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

Biblioteka `xlsx` umożliwia łatwe odczytywanie, zapisywanie oraz manipulowanie plikami Excela (.xls, .xlsx) w aplikacjach Node.js. Poniżej przedstawiamy krok po kroku, jak zainstalować i używać tej biblioteki.

## 1. Instalacja

Aby zainstalować bibliotekę `xlsx`, należy użyć menedżera pakietów npm. W terminalu projektu wpisz następujące polecenie:

```bash

npm install xlsx

```

Po zainstalowaniu biblioteki możesz rozpocząć jej użycie w swoim projekcie.

## 2. Odczyt pliku Excel

Aby odczytać dane z pliku Excel, należy zaimportować bibliotekę `xlsx` i użyć funkcji `readFile`. Przykład:

```javascript

const XLSX = require('xlsx');

// Odczytujemy plik Excel

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

// Wybieramy arkusz

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

// Konwertujemy arkusz na format JSON

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

console.log(data);

```

W powyższym przykładzie plik `nazwa_pliku.xlsx` jest odczytywany, a jego pierwszy arkusz konwertowany na format JSON, który następnie jest wyświetlany w konsoli.

## 3. Tworzenie pliku Excel

Możesz również tworzyć nowe pliki Excel za pomocą biblioteki `xlsx`. Oto przykład:

```javascript

const XLSX = require('xlsx');

// Tworzymy nowy skoroszyt

const workbook = XLSX.utils.book_new();

// Przygotowujemy dane

const data = [

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

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

];

// Konwertujemy dane na arkusz

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

// Dodajemy arkusz do skoroszytu

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

// Zapisujemy do pliku

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

```

W tym przykładzie tworzymy nowy plik Excel o nazwie `nowy_plik.xlsx`, do którego dodajemy dane w formacie JSON.

## 4. Modyfikacja istniejącego pliku Excel

Możesz także modyfikować istniejące pliki Excel. Oto jak to zrobić:

```javascript

const XLSX = require('xlsx');

// Odczytujemy plik Excel

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

// Wybieramy arkusz

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

// Modyfikujemy dane

worksheet['A1'].v = 'Nowa Wartość';

// Zapisujemy zmodyfikowany plik

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

```

W tym przypadku zmieniamy wartość komórki A1 w istniejącym pliku i zapisujemy zmiany do nowego pliku.

## 5. Obsługa różnych formatów

Biblioteka `xlsx` obsługuje różne formaty plików, w tym .xls, .xlsx, .csv itp. Możesz wykorzystać tę funkcję, aby odczytać lub zapisać pliki w odpowiednim formacie, zmieniając jedynie rozszerzenie w nazwie pliku.

## 6. Złożone operacje

Biblioteka `xlsx` umożliwia również wykonywanie bardziej złożonych operacji, takich jak łączenie arkuszy, filtrowanie danych, czy stosowanie różnych formatów komórek. Aby dowiedzieć się więcej na ten temat, warto zapoznać się z dokumentacją biblioteki, która szczegółowo opisuje wszystkie dostępne funkcje i możliwości.

Dzięki bibliotece `xlsx` praca z plikami Excel w Node.js staje się bardziej efektywna i przyjemna. Możliwość łatwego odczytu, zapisu i modyfikacji danych sprawia, że jest to nieocenione narzędzie dla każdego developera pracującego z arkuszami kalkulacyjnymi.