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

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

Biblioteka `xlsx` jest popularnym narzędziem do pracy z plikami Excel w aplikacjach Node.js. Umożliwia odczytywanie, pisanie oraz manipulowanie danymi w formacie XLSX. W poniższym artykule przedstawimy, jak zainstalować i używać tej biblioteki w swoim projekcie.

## Instalacja

Aby rozpocząć korzystanie z biblioteki `xlsx`, najpierw należy ją zainstalować za pomocą menedżera pakietów npm. Możesz to zrobić, otwierając terminal w katalogu swojego projektu i wpisując polecenie:

```bash

npm install xlsx

```

## Odczyt pliku Excel

Aby odczytać plik Excel, można użyć metody `readFile` dostarczanej przez bibliotekę `xlsx`. Oto przykład, jak to zrobić:

```javascript

const XLSX = require('xlsx');

// Odczyt pliku Excel

const workbook = XLSX.readFile('ścieżka/do/pliku.xlsx');

// Wybór pierwszego arkusza

const sheetName = workbook.SheetNames[0];

const worksheet = workbook.Sheets[sheetName];

// Konwersja danych do formatu JSON

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

console.log(data);

```

W powyższym przykładzie najpierw importujemy bibliotekę `xlsx`, a następnie odczytujemy plik Excel, wybieramy pierwszy arkusz i konwertujemy go na format JSON.

## Tworzenie pliku Excel

Oprócz odczytu plików, za pomocą biblioteki `xlsx` można również tworzyć nowe pliki Excel. Oto jak to zrobić:

```javascript

const XLSX = require('xlsx');

// Dane 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);

// Utworzenie nowego skoroszytu

const workbook = XLSX.utils.book_new();

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

// Zapisanie pliku Excel

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

```

W tym przypadku tworzymy dane w formacie JSON, konwertujemy je do formatu arkusza, a następnie dodajemy do nowego skoroszytu i zapisujemy go jako plik Excel.

## Modyfikacja istniejącego pliku Excel

Możesz także modyfikować istniejące pliki Excel. Oto przykład, jak dodać nowy wiersz do istniejącego pliku:

```javascript

const XLSX = require('xlsx');

// Odczyt istniejącego pliku

const workbook = XLSX.readFile('ścieżka/do/istniejącego_pliku.xlsx');

const sheetName = workbook.SheetNames[0];

const worksheet = workbook.Sheets[sheetName];

// Dodawanie nowego wiersza

const newRow = { Imię: 'Marek', Nazwisko: 'Zieliński', Wiek: 28 };

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

newSheetData.push(newRow);

const updatedWorksheet = XLSX.utils.json_to_sheet(newSheetData);

// Aktualizacja arkusza w skoroszycie

workbook.Sheets[sheetName] = updatedWorksheet;

// Zapisanie zmodyfikowanego pliku

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

```

Przykład ten pokazuje, jak odczytać istniejący plik, dodać nowy wiersz do danych, a następnie zapisać zmodyfikowany plik Excel.

## Obsługa formatów

Biblioteka `xlsx` pozwala także na obsługę różnych formatów plików. Możesz odczytywać i zapisywać pliki w formatach XLS, XLSX, CSV oraz wielu innych. W przypadku zapisywania pliku w innym formacie, wystarczy zmienić rozszerzenie w funkcji `writeFile`:

```javascript

XLSX.writeFile(workbook, 'plik.csv');

```

## Użycie w projektach

Biblioteka `xlsx` jest elastycznym narzędziem idealnym do różnych zastosowań w projektach, w tym do generowania raportów, przetwarzania danych z arkuszy kalkulacyjnych czy konwersji danych między formatami. Dzięki prostemu interfejsowi i możliwościom, które oferuje, można z łatwością wbudować ją w wiele aplikacji.

Dzięki przedstawionym przykładom możesz teraz zacząć korzystać z biblioteki `xlsx` w swoich projektach Node.js, aby efektywnie pracować z danymi w formacie Excel.