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

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

Biblioteka `xlsx` jest jedną z najpopularniejszych bibliotek w ekosystemie Node.js, która pozwala na odczytywanie i zapisywanie plików w formacie Excel (XLSX). Poniżej znajdziesz szczegółowe instrukcje, jak zainstalować i wykorzystać tę bibliotekę w swoim projekcie Node.js.

## Instalacja

Aby zacząć korzystać z biblioteki `xlsx`, należy najpierw zainstalować ją za pomocą narzędzia npm. Otwórz terminal i przejdź do katalogu swojego projektu, a następnie wpisz:

```bash

npm install xlsx

```

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

## Użycie biblioteki xlsx

### 1. Odczyt pliku XLSX

Aby odczytać dane z pliku XLSX, należy załadować bibliotekę i użyć funkcji `readFile`. Przykład:

```javascript

const XLSX = require('xlsx');

// Ścieżka do pliku XLSX

const filePath = 'ścieżka/do/twojego/pliku.xlsx';

// Odczyt danych z pliku

const workbook = XLSX.readFile(filePath);

// Użycie pierwszego arkusza

const sheetName = workbook.SheetNames[0];

const worksheet = workbook.Sheets[sheetName];

// Konwersja danych na JSON

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

console.log(data);

```

W tym przykładzie najpierw ładujemy plik XLSX, a następnie odczytujemy zawartość pierwszego arkusza i konwertujemy go na format JSON.

### 2. Zapis danych do pliku XLSX

Zapis danych do pliku XLSX również jest prosty. Można to zrobić przy pomocy funkcji `utils.json_to_sheet` oraz `writeFile`. Oto przykład:

```javascript

const XLSX = require('xlsx');

// Przykładowe dane do zapisania

const data = [

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

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

];

// Konwersja danych na arkusz

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

// Zapisywanie pliku XLSX

const filePath = 'ścieżka/do/nowego/pliku.xlsx';

XLSX.writeFile(workbook, filePath);

```

W tym przykładzie tworzony jest nowy arkusz na podstawie tablicy obiektów i zapisany jest do nowego pliku XLSX.

### 3. Modyfikacja istniejącego pliku XLSX

Można również odczytać istniejący plik, dodać nowe dane, a następnie zapisać go ponownie. Oto jak to zrobić:

```javascript

const XLSX = require('xlsx');

// Odczyt istniejącego pliku

const filePath = 'ścieżka/do/twojego/pliku.xlsx';

const workbook = XLSX.readFile(filePath);

const sheetName = workbook.SheetNames[0];

const worksheet = workbook.Sheets[sheetName];

// Konwersja na JSON

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

// Dodanie nowego rekordu

data.push({ Imię: 'Katarzyna', Nazwisko: 'Wiśniewska', Wiek: 28 });

// Konwersja z powrotem na arkusz

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

// Modyfikacja arkusza w skoroszycie

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

// Zapis zmodyfikowanego pliku

XLSX.writeFile(workbook, filePath);

```

W tym przykładzie odczytujemy istniejący plik XLSX, modyfikujemy dane, a następnie zapisujemy je z powrotem do tego samego pliku.

## Obsługa błędów

Podczas pracy z plikami XLSX warto pamiętać o obsłudze błędów. Można to zrobić, stosując konstrukcje `try...catch`. Oto prosty przykład:

```javascript

try {

const workbook = XLSX.readFile(filePath);

// Operacje na workbook

} catch (error) {

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

}

```

Dzięki temu można wychwycić błędy, które mogą wystąpić podczas odczytu lub zapisu plików.

## Podsumowanie

Biblioteka `xlsx` w Node.js jest wszechstronnym narzędziem do pracy z plikami XLSX, umożliwiającym ich odczyt, zapis i modyfikację. Dzięki prostym funkcjom jest łatwa w użyciu, co czyni ją popularnym wyborem wśród programistów. Warto eksplorować więcej funkcji, które oferuje ta biblioteka, aby w pełni wykorzystać jej możliwości.