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

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

Biblioteka `xlsx` to popularne narzędzie do pracy z plikami Excel w środowisku Node.js. Umożliwia odczyt, zapis oraz manipulację danymi w formacie Excel (.xlsx, .xls). W tym artykule pokażemy, jak zainstalować tę bibliotekę i jak z jej pomocą wykonywać podstawowe operacje na plikach Excel.

## Instalacja biblioteki xlsx

Aby zainstalować bibliotekę `xlsx`, należy użyć menedżera pakietów npm. Otwórz terminal i przejdź do katalogu swojego projektu, a następnie uruchom następującą komendę:

```bash

npm install xlsx

```

Po zakończeniu instalacji możesz zaimportować bibliotekę w swoim skrypcie.

## Odczyt pliku Excel

Aby odczytać plik Excel, należy użyć metody `readFile` z biblioteki `xlsx`. Oto przykład, jak to zrobić:

```javascript

const XLSX = require('xlsx');

// Wczytywanie pliku

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

// Wybieranie arkusza

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

const worksheet = workbook.Sheets[sheetName];

// Konwersja do formatu JSON

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

console.log(jsonData);

```

W powyższym przykładzie wczytujemy plik `nazwa_pliku.xlsx`, a następnie konwertujemy dane z pierwszego arkusza na format JSON, co ułatwia ich przetwarzanie w aplikacji.

## Zapis do pliku Excel

Aby zapisać dane do pliku Excel, należy najpierw stworzyć nowy arkusz, a następnie dodać go do workbooka i zapisać. Oto jak to zrobić:

```javascript

const XLSX = require('xlsx');

// Tworzenie danych do zapisania

const data = [

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

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

];

// Konwersja danych do arkusza

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

// Tworzenie nowego workbooka i dodawanie arkusza

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 dane jako tablicę obiektów, konwertujemy je na arkusz, a następnie zapisujemy do nowego pliku `nowy_plik.xlsx`.

## Inne operacje

Biblioteka `xlsx` oferuje również inne funkcje, które mogą być przydatne, takie jak:

- **Odczyt wielu arkuszy**: Możesz iterować przez `workbook.SheetNames`, aby odczytać każdy arkusz.

- **Funkcje do formatowania**: Możesz stylizować komórki, zmieniając ich format, czcionkę czy kolory.

- **Manipulacja danymi**: Możliwość modyfikacji danych w arkuszu przed zapisaniem ich do pliku.

## Podsumowanie

Biblioteka `xlsx` w Node.js to potężne narzędzie do pracy z formatem Excel. Dzięki jej funkcjom możesz łatwo odczytywać, zapisywać i manipulować danymi. Warto zaznaczyć, że przed użyciem biblioteki dobrze jest zapoznać się z dokumentacją, aby w pełni wykorzystać jej możliwości.