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 do pracy z arkuszami kalkulacyjnymi w formacie Excel w środowisku Node.js. Umożliwia odczyt i zapis plików Excel, a także manipulację danymi zawartymi w tych plikach. W poniższym artykule przedstawimy kroki potrzebne do zainstalowania i korzystania z tej biblioteki.

## Instalacja biblioteki

Aby zainstalować bibliotekę `xlsx`, należy najpierw upewnić się, że mamy zainstalowane środowisko Node.js oraz npm (Node Package Manager). W terminalu można to zrobić wydając następujące polecenie:

```bash

npm install xlsx

```

Po zakończeniu instalacji, biblioteka będzie dostępna w projekcie.

## Odczyt pliku Excel

Aby odczytać plik Excel, należy zaimportować bibliotekę `xlsx` i użyć funkcji do wczytania pliku. Oto prosty przykład:

```javascript

const XLSX = require('xlsx');

// Odczyt pliku Excel

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

// Wybór arkusza

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

const worksheet = workbook.Sheets[sheetName];

// Konwersja arkusza na format JSON

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

console.log(data);

```

W powyższym kodzie najpierw wczytujemy plik Excel, a następnie wybieramy pierwszy arkusz i konwertujemy go do formatu JSON, co ułatwia dalszą pracę z danymi.

## Zapis pliku Excel

Zapis danych do pliku Excel jest równie prosty. Można stworzyć nowy arkusz i zapisać go do pliku. Poniżej znajduje się przykład:

```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 skoroszytu

const workbook = XLSX.utils.book_new();

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

// Zapis do pliku

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

```

W tym przykładzie tworzymy nowy arkusz za pomocą danych w formacie JSON, a następnie zapisujemy go do nowego pliku Excel.

## Praca z większymi zestawami danych

Biblioteka `xlsx` obsługuje także większe zestawy danych. Kluczowe funkcje, takie jak `sheet_to_json`, mogą przyjąć różne opcje, które pozwalają na dostosowanie procesu konwersji i manipulacji danymi. Na przykład:

```javascript

const options = {

header: 1, // Odczyt nagłówków

range: 1 // Pominięcie pierwszego wiersza

};

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

```

## Zrozumienie struktury pliku Excel

Pliki Excel są zorganizowane w skoroszyty, które składają się z arkuszy. Każdy arkusz ma komórki z danymi. Warto zrozumieć tę strukturę, aby móc efektywnie manipulować danymi.

## Obsługa błędów

Podczas pracy z plikami Excel warto także zaimplementować obsługę błędów, aby upewnić się, że program będzie stabilny nawet w przypadku nieprawidłowych danych lub brakujących plików.

```javascript

try {

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

// inne operacje na workbook

} catch (error) {

console.error('Błąd podczas odczytu pliku:', error);

}

```

## Wnioski

Biblioteka `xlsx` w Node.js to potężne narzędzie do pracy z plikami Excel. Umożliwia użytkownikom wczytywanie, edytowanie i zapisywanie danych w formacie arkuszy kalkulacyjnych. Dzięki prostocie użycia i elastyczności, staje się nieocenionym wsparciem w projektach, które wymagają operacji na danych.