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

# Używanie biblioteki xlsx w Node.js z npm

Biblioteka xlsx to popularne narzędzie w ekosystemie Node.js, które pozwala na łatwe czytanie i pisanie plików Excel (w formacie .xlsx). Dzięki niej można manipulować danymi w arkuszach kalkulacyjnych bez potrzeby posiadania aplikacji Microsoft Excel. W poniższym artykule przedstawimy, jak zainstalować bibliotekę, jak czytać pliki oraz jak tworzyć nowe pliki Excel.

## Instalacja biblioteki xlsx

Aby rozpocząć korzystanie z biblioteki xlsx, należy najpierw zainstalować ją w swoim projekcie Node.js. Można to zrobić za pomocą menedżera pakietów npm. W terminalu wpisz poniższą komendę:

```bash

npm install xlsx

```

Po zainstalowaniu biblioteki, możemy przejść do jej użycia w naszym kodzie.

## Czytanie plików Excel

Aby odczytać dane z pliku Excel, musimy zaimportować bibliotekę xlsx i użyć odpowiednich metod do wczytania pliku. Oto przykładowy kod, który ilustruje ten proces:

```javascript

const XLSX = require('xlsx');

// Wczytanie pliku

const workbook = XLSX.readFile('sciezka/do/pliku.xlsx');

// Wybór pierwszego arkusza

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

// Konwersja arkusza do formatu JSON

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

console.log(data);

```

W powyższym przykładzie najpierw odczytujemy plik Excel, a następnie wybieramy pierwszy arkusz. Używając metody `sheet_to_json`, konwertujemy dane z arkusza na format JSON, co pozwala na łatwe manipulowanie nimi w JavaScript.

## Tworzenie pliku Excel

Poza odczytem, biblioteka xlsx pozwala również na tworzenie nowych plików Excel. Poniżej znajduje się przykład, jak utworzyć prosty plik:

```javascript

const XLSX = require('xlsx');

// Tworzenie nowego arkusza

const data = [

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

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

];

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

// Tworzenie nowego skoroszytu

const workbook = XLSX.utils.book_new();

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

// Zapisanie pliku

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

```

W tym przykładzie tworzymy nowy arkusz, wypełniamy go danymi w formie tabeli JSON, a następnie zapisujemy go jako plik .xlsx.

## Formatowanie danych

Biblioteka xlsx oferuje również możliwości formatowania danych w arkuszach. Można na przykład ustawić szerokość kolumny:

```javascript

const column = { wch: 20 }; // Ustalamy szerokość kolumny na 20 jednostek

worksheet['!cols'] = [column, column]; // Przypisujemy formatowanie do dwóch kolumn

```

## Obsługa błędów

Ważnym aspektem pracy z plikami Excel jest odpowiednia obsługa błędów, aby upewnić się, że nasza aplikacja nie przestanie działać w przypadku nieprawidłowego wejścia. Można to osiągnąć za pomocą odpowiednich bloków `try-catch`:

```javascript

try {

const workbook = XLSX.readFile('sciezka/do/pliku.xlsx');

// dalsze operacje

} catch (error) {

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

}

```

## Podsumowanie

Biblioteka xlsx w Node.js jest potężnym narzędziem do pracy z plikami Excel. Jej łatwość użycia oraz wszechstronność sprawiają, że jest idealnym wyborem do aplikacji, które wymagają manipulacji danymi w formacie arkuszy kalkulacyjnych. Wykorzystując powyższe przykłady, można w prosty sposób wczytywać oraz tworzyć pliki Excel w projektach opartych na Node.js.