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

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

Biblioteka `xlsx` to popularne narzędzie do pracy z plikami Excel w Node.js. Pozwala na odczyt, zapis oraz modyfikację arkuszy kalkulacyjnych w formatach .xlsx i .xls. W poniższym artykule przedstawimy, jak zainstalować tę bibliotekę oraz jak używać jej w praktyce.

### Instalacja biblioteki xlsx

Aby rozpocząć pracę z biblioteką `xlsx`, najpierw musisz zainstalować ją w swoim projekcie Node.js. Można to zrobić za pomocą npm. Oto kroki, które należy wykonać:

1. Otwórz terminal lub konsolę.

2. Przejdź do katalogu swojego projektu.

3. Użyj poniższego polecenia, aby zainstalować bibliotekę:

```bash

npm install xlsx

```

### Odczyt pliku Excel

Po zainstalowaniu biblioteki możesz przystąpić do odczytu pliku Excel. Oto przykładowy kod, który pokazuje, jak to zrobić:

```javascript

const XLSX = require('xlsx');

// Załaduj plik Excel

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

// Pobierz pierwszym arkusz

const sheetName = workbook.SheetNames[0];

const worksheet = workbook.Sheets[sheetName];

// Konwertuj arkusz na format JSON

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

// Wyświetl dane w konsoli

console.log(data);

```

Powyższy kod odczytuje plik o nazwie `przykladowy_plik.xlsx`, następnie z pierwszego arkusza konwertuje go na format JSON i wyświetla dane w konsoli.

### Zapis do pliku Excel

Aby zapisać dane do pliku Excel, można wykorzystać poniższy kod:

```javascript

const XLSX = require('xlsx');

// Dane do zapisania

const data = [

{ Imie: 'Jan', Nazwisko: 'Kowalski' },

{ Imie: 'Anna', Nazwisko: 'Nowak' }

];

// Tworzenie arkusza z danych

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');

// Zapisanie skoroszytu do pliku Excel

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

```

W powyższym kodzie tworzymy dane w formacie JSON, a następnie konwertujemy je do formatu arkusza. Następnie tworzymy nowy skoroszyt, dodajemy do niego arkusz, a na końcu zapisujemy go jako `wynik.xlsx`.

### Modyfikacja istniejącego pliku Excel

Można również modyfikować istniejące pliki Excel, na przykład dodając nowe dane do istniejącego arkusza. Oto przykład:

```javascript

const XLSX = require('xlsx');

// Załaduj istniejący plik Excel

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

const sheetName = workbook.SheetNames[0];

const worksheet = workbook.Sheets[sheetName];

// Odczytaj istniejące dane

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

// Nowe dane do dodania

const newData = { Imie: 'Katarzyna', Nazwisko: 'Wójcik' };

existingData.push(newData);

// Konwertuj zaktualizowane dane na arkusz

const updatedWorksheet = XLSX.utils.json_to_sheet(existingData);

// Zaktualizuj arkusz w skoroszycie

XLSX.utils.book_append_sheet(workbook, updatedWorksheet, sheetName, true);

// Zapisz zmodyfikowany plik

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

```

W powyższym przykładzie ładujemy istniejący plik Excel, odczytujemy dane, dodajemy nowe dane do tablicy, a następnie zapisujemy zmodyfikowany plik.

### Obsługa błędów

Podczas pracy z plikami Excel warto pamiętać o obsłudze ewentualnych błędów. Oto przykład, jak to zrobić:

```javascript

try {

const workbook = XLSX.readFile('nieistniejący_plik.xlsx');

} catch (error) {

console.error('Wystąpił błąd podczas odczytu pliku:', error.message);

}

```

W powyższym kodzie, jeżeli plik nie istnieje, program wyświetli komunikat o błędzie w konsoli.

### Wnioski

Biblioteka `xlsx` w Node.js umożliwia łatwe i wygodne zarządzanie plikami Excel. Dzięki powyższym przykładom możesz szybko zacząć pracę z systemem odczytu, zapisu i modyfikacji arkuszy kalkulacyjnych. Czerp z jej możliwości w swoich projektach, aby efektywnie pracować z danymi w formacie Excel.