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 umożliwiające odczytywanie i zapisywanie plików Excel w formacie XLSX w aplikacjach napisanych w Node.js. W tym artykule zostanie przedstawione, jak zainstalować bibliotekę oraz jak z niej korzystać w praktyce.

## Instalacja

Aby zacząć korzystać z biblioteki `xlsx`, pierwszym krokiem jest jej zainstalowanie za pomocą npm. Otwórz terminal i uruchom polecenie:

```bash

npm install xlsx

```

Po zainstalowaniu biblioteki możesz zacząć ją używać w swoim projekcie.

## Odczytywanie plików Excel

Aby odczytać dane z pliku Excel, musisz najpierw zaimportować bibliotekę `xlsx`.

```javascript

const XLSX = require('xlsx');

```

Następnie możesz wczytać plik Excel, używając metody `readFile`:

```javascript

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

```

Odczytany plik Excel jest reprezentowany przez obiekt `workbook`, który zawiera arkusze i inne metadane. Możesz uzyskać dostęp do poszczególnych arkuszy w arkuszu roboczym:

```javascript

const worksheet = workbook.Sheets[workbook.SheetNames[0]];

```

Teraz możesz przekształcić dane z arkusza w formacie JSON za pomocą funkcji `sheet_to_json`:

```javascript

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

console.log(jsonData);

```

## Zapis danych do pliku Excel

Aby zapisać dane do nowego pliku Excel, najpierw musisz przygotować dane, które chcesz umieścić w arkuszu. Możesz użyć tablicy obiektów:

```javascript

const data = [

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

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

];

```

Następnie przekształć tę tablicę w arkusz za pomocą `json_to_sheet`:

```javascript

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

```

Teraz musisz stworzyć nowy arkusz roboczy i dodać do niego utworzony arkusz:

```javascript

const newWorkbook = XLSX.utils.book_new();

XLSX.utils.book_append_sheet(newWorkbook, newWorksheet, 'Arkusz1');

```

Na koniec, aby zapisać nowy plik Excel, użyj metody `writeFile`:

```javascript

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

```

## Użycie zaawansowanych opcji

Biblioteka `xlsx` oferuje wiele zaawansowanych opcji, takich jak formatowanie komórek, ustalanie szerokości kolumn czy dodawanie wykresów. Aby na przykład ustawić szerokość kolumny, możesz użyć właściwości `!cols`:

```javascript

newWorksheet['!cols'] = [{ wch: 10 }, { wch: 20 }, { wch: 5 }];

```

## Obsługa błędów

Podczas pracy z plikami Excel ważne jest, aby zaimplementować odpowiednią obsługę błędów. Możesz użyć konstrukcji `try...catch`, aby uchwycić ewentualne błędy podczas wczytywania lub zapisywania plików:

```javascript

try {

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

// dalsze operacje

} catch (error) {

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

}

```

Dzięki tym krokom możesz efektywnie korzystać z biblioteki `xlsx` w swoim projekcie Node.js, zarówno do odczytu, jak i zapisu plików Excel.