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

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

Biblioteka `xlsx` to potężne narzędzie do pracy z arkuszami kalkulacyjnymi w formacie Excel w środowisku Node.js. Umożliwia odczytywanie, zapisywanie oraz modyfikowanie plików Excela zarówno w formacie `.xls`, jak i `.xlsx`. W tym artykule przedstawimy krok po kroku, jak zainstalować bibliotekę oraz jak wykorzystać jej podstawowe funkcje.

### Instalacja biblioteki

Aby rozpocząć korzystanie z biblioteki `xlsx`, najpierw musisz ją zainstalować. Otwórz terminal i przejdź do folderu swojego projektu, a następnie uruchom następującą komendę:

```bash

npm install xlsx

```

Po zainstalowaniu biblioteki możesz ją zaimportować do swojego projektu.

### Podstawowe operacje z biblioteką xlsx

#### Odczytywanie danych z pliku Excel

Aby odczytać dane z pliku Excel, należy użyć funkcji `readFile`. Oto przykład:

```javascript

const XLSX = require('xlsx');

// Wczytaj plik Excel

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

// Wybierz arkusz z pliku

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

const worksheet = workbook.Sheets[sheetName];

// Konwertujemy dane na format JSON

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

console.log(data);

```

W powyższym przykładzie najpierw wczytujemy plik Excel, następnie wybieramy pierwszy arkusz i konwertujemy go na format JSON, co umożliwia łatwe przetwarzanie danych.

#### Zapisywanie danych do pliku Excel

Możesz również tworzyć nowe arkusze kalkulacyjne i zapisywać je na dysku. Przykładowo:

```javascript

const XLSX = require('xlsx');

// Tworzymy nowy arkusz

const data = [

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

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

];

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

// Tworzymy nowy skoroszyt

const workbook = XLSX.utils.book_new();

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

// Zapisujemy plik Excel

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

```

W tym przykładzie tworzymy arkusz z danymi, następnie tworzymy nowy skoroszyt i dodajemy do niego nasz arkusz, a na końcu zapisujemy wszystko do pliku `nowy_plik.xlsx`.

#### Modyfikowanie istniejącego pliku Excel

Możliwe jest również modyfikowanie istniejącego pliku Excel. Oto jak to zrobić:

```javascript

const XLSX = require('xlsx');

// Wczytujemy istniejący plik Excel

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

const sheetName = workbook.SheetNames[0];

const worksheet = workbook.Sheets[sheetName];

// Modyfikujemy dane w arkuszu

worksheet['A1'].v = 'Zmienione Imię';

// Zapisujemy zmiany do pliku

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

```

W tym przypadku wczytujemy plik, modyfikujemy wartość w komórce A1, a następnie zapisujemy zmodyfikowany plik pod nową nazwą.

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

Podczas pracy z plikami Excel warto dodać mechanizmy obsługi błędów. Można to zrobić za pomocą standardowego bloku `try-catch`:

```javascript

try {

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

} catch (error) {

console.error('Wystąpił błąd przy odczycie pliku:', error);

}

```

### Wnioski

Biblioteka `xlsx` oferuje wiele użytecznych funkcji, które ułatwiają pracę z plikami Excel w Node.js. Dzięki prostemu interfejsowi oraz wsparciu dla szerokiej gamy operacji, programiści mogą szybko implementować funkcjonalności związane z przetwarzaniem danych w arkuszach kalkulacyjnych. Warto zapoznać się z dokumentacją biblioteki, aby w pełni wykorzystać jej potencjał.