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

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

Biblioteka `xlsx` jest popularnym narzędziem w ekosystemie Node.js, które umożliwia pracę z arkuszami kalkulacyjnymi w formatach Excel (XLSX). Dzięki niej możemy efektywnie czytać, pisać oraz manipulować danymi w plikach Excel. W tym artykule omówimy, jak zainstalować i używać tej biblioteki w projekcie Node.js.

## Instalacja biblioteki

Na początek musimy zainstalować bibliotekę `xlsx`. Możemy to zrobić, korzystając z menedżera pakietów npm. Otwórz terminal i przejdź do katalogu swojego projektu, a następnie uruchom poniższą komendę:

```bash

npm install xlsx

```

## Podstawowe operacje

Po zainstalowaniu biblioteki możemy zacząć używać jej w kodzie. Oto kilka podstawowych operacji, które możemy zrealizować przy pomocy `xlsx`.

### 1. Odczyt pliku XLSX

Aby odczytać dane z pliku Excel, możemy użyć metody `readFile`. Poniższy przykład ilustruje, jak to zrobić:

```javascript

const xlsx = require('xlsx');

// Odczytanie pliku XLSX

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

// Wybór pierwszego arkusza

const sheetName = workbook.SheetNames[0];

const worksheet = workbook.Sheets[sheetName];

// Konwersja danych z arkusza do formatu JSON

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

console.log(data);

```

### 2. Tworzenie nowego pliku XLSX

Możemy również stworzyć nowy plik XLSX. Oto przykład, jak to zrobić:

```javascript

const xlsx = require('xlsx');

// Tworzenie nowego arkusza

const data = [

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

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

];

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

// Tworzenie nowego workbooka

const workbook = xlsx.utils.book_new();

xlsx.utils.book_append_sheet(workbook, worksheet, 'PierwszyArkusz');

// Zapisywanie workbooka do pliku

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

```

### 3. Modyfikacja istniejącego pliku XLSX

Mamy również możliwość modyfikacji istniejącego pliku. Oto przykład, który ilustruje, jak dodać nowe dane do istniejącego arkusza:

```javascript

const xlsx = require('xlsx');

// Odczytanie istniejącego pliku

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

const sheetName = workbook.SheetNames[0];

const worksheet = workbook.Sheets[sheetName];

// Przykładowe nowe dane

const newData = { Imię: 'Pawel', Nazwisko: 'Zalewski', Wiek: 28 };

// Dodawanie nowych danych do arkusza

const newRow = xlsx.utils.json_to_sheet([newData], { header: ['Imię', 'Nazwisko', 'Wiek'], skipHeader: true });

xlsx.utils.sheet_add_json(worksheet, newRow, { skipHeader: true, origin: -1 });

// Zapisywanie zmodyfikowanego workbooka

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

```

### 4. Praca z wieloma arkuszami

Biblioteka `xlsx` umożliwia także pracę z wieloma arkuszami w tym samym pliku. Można je odczytywać oraz zapisywać w prosty sposób.

```javascript

const xlsx = require('xlsx');

// Tworzenie nowego workbooka z dwoma arkuszami

const sheet1 = xlsx.utils.json_to_sheet([{ A: 1, B: 2 }]);

const sheet2 = xlsx.utils.json_to_sheet([{ C: 3, D: 4 }]);

const workbook = xlsx.utils.book_new();

xlsx.utils.book_append_sheet(workbook, sheet1, 'Arkusz1');

xlsx.utils.book_append_sheet(workbook, sheet2, 'Arkusz2');

// Zapisywanie workbooka do pliku

xlsx.writeFile(workbook, 'plik_z_wieloma_arkuszami.xlsx');

```

## Podsumowanie

Biblioteka `xlsx` w Node.js umożliwia łatwą i efektywną obsługę plików Excel. Dzięki prostym metodom możemy czytać, pisać oraz modyfikować dane w arkuszach kalkulacyjnych. W powyższych przykładach przedstawiliśmy najważniejsze operacje, które można wykonać z użyciem tej biblioteki. Aby zgłębić wszystkie możliwości, warto zapoznać się z dokumentacją biblioteki.