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

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

Biblioteka xlsx to popularne narzędzie do pracy z plikami Excel w JavaScript, które można wykorzystać w aplikacjach Node.js. Umożliwia zarówno odczyt, jak i zapis danych do formatów XLSX i XLS. W tym artykule omówimy, jak zainstalować i używać tej biblioteki w projekcie Node.js.

## Instalacja

Aby zacząć korzystać z biblioteki xlsx, należy najpierw zainstalować ją za pomocą npm. Otwórz terminal w katalogu swojego projektu i wpisz następującą komendę:

```bash

npm install xlsx

```

Po zainstalowaniu biblioteki, możesz zaimportować ją w swoim pliku JavaScript.

## Odczyt pliku Excel

Aby odczytać dane z pliku Excel, należy użyć metody `readFile` z biblioteki xlsx. Poniżej przedstawiono przykład kodu, który odczytuje dane z pliku o nazwie `dane.xlsx`:

```javascript

const xlsx = require('xlsx');

// Odczytanie pliku Excel

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

// Wybór pierwszego arkusza

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

// Przekształcenie danych arkusza na format JSON

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

// Wyświetlenie danych w konsoli

console.log(data);

```

W powyższym kodzie najpierw importujemy bibliotekę `xlsx`, a następnie odczytujemy plik Excel. Następnie wybieramy pierwszy arkusz i przekształcamy go na format JSON, co ułatwia dalszą pracę z danymi.

## Zapis do pliku Excel

Zapis danych do pliku Excel jest równie prosty. Możesz zbudować obiekt, który chcesz zapisać, a następnie użyć metody `writeFile`, aby zapisać go w formacie XLSX. Oto przykład:

```javascript

const xlsx = require('xlsx');

// Tworzenie danych do zapisania

const data = [

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

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

];

// Przekształcanie danych do formatu arkusza

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

// Tworzenie nowego skoroszytu

const workbook = xlsx.utils.book_new();

// Dodawanie arkusza do skoroszytu

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

// Zapis do pliku Excel

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

```

W powyższym przykładzie najpierw tworzymy dane w formacie tablicy obiektów, które następnie przekształcamy na arkusz. Po tym tworzymy nowy skoroszyt i dodajemy do niego nasz arkusz. Na końcu zapisujemy skoroszyt jako `nowe_dane.xlsx`.

## Obsługa błędów

Podczas pracy z plikami Excel warto zadbać o obsługę potencjalnych błędów. Można to zrobić, stosując blok `try-catch`. Oto przykład:

```javascript

const xlsx = require('xlsx');

try {

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

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

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

console.log(data);

} catch (error) {

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

}

```

W ten sposób, jeśli wystąpiłaby jakaś nieprawidłowość podczas odczytu pliku, zostanie to odpowiednio zgłoszone.

## Wnioski

Biblioteka xlsx w Node.js to potężne narzędzie do pracy z plikami Excel. Dzięki prostym metodom umożliwia łatwy odczyt i zapis danych, co sprawia, że jest idealnym rozwiązaniem dla wielu zastosowań w aplikacjach serwerowych. Dzięki możliwości konwersji danych do formatu JSON oraz pełnej obsłudze błędów, praca z plikami Excel staje się bardziej intuicyjna i bezpieczna.