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 aplikacjach Node.js. Dzięki niej można czytać, pisać i manipulować danymi w formacie XLSX oraz XLS. Poniżej przedstawiamy, jak zainstalować oraz używać tej biblioteki w projekcie Node.js.

## Instalacja biblioteki

Aby zainstalować bibliotekę `xlsx`, musisz mieć zainstalowane środowisko Node.js oraz npm. Możesz zainstalować `xlsx`, wykonując poniższe polecenie w terminalu:

```bash

npm install xlsx

```

## Czytanie pliku Excel

Aby odczytać dane z pliku Excel, należy zaimportować bibliotekę `xlsx` i użyć odpowiednich metod. Poniżej znajduje się przykładowy kod do odczytu danych:

```javascript

const XLSX = require('xlsx');

// Otwórz plik Excel

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

// Wybierz arkusz, który chcesz odczytać

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

const worksheet = workbook.Sheets[sheetName];

// Konwertuj arkusz na format JSON

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

console.log(data);

```

W powyższym przykładzie:

1. Otwieramy plik Excel za pomocą `XLSX.readFile()`.

2. Wybieramy pierwszy arkusz.

3. Konwertujemy arkusz na format JSON, aby móc łatwo przetwarzać dane.

## Pisanie do pliku Excel

Pisanie danych do pliku Excel również jest proste. Możesz utworzyć nowy arkusz i zapisać go za pomocą następującego kodu:

```javascript

const XLSX = require('xlsx');

// Przygotuj dane do zapisu

const data = [

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

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

];

// Utwórz arkusz z danych

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

// Tworzymy nowy skoroszyt

const workbook = XLSX.utils.book_new();

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

// Zapisz skoroszyt do pliku

XLSX.writeFile(workbook, 'ścieżka/do/plik.xlsx');

```

W powyższym przykładzie:

1. Przygotowujemy dane w formacie tablicy obiektów.

2. Tworzymy arkusz za pomocą `XLSX.utils.json_to_sheet()`.

3. Tworzymy nowy skoroszyt i dodajemy arkusz do skoroszytu.

4. Zapisujemy skoroszyt do pliku za pomocą `XLSX.writeFile()`.

## Manipulacja danymi

Możesz również modyfikować dane w arkuszu przed ich zapisaniem. Poniżej znajduje się przykład, jak dodać nowy wiersz do istniejącego arkusza:

```javascript

const XLSX = require('xlsx');

// Otwórz plik Excel

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

// Wybierz arkusz

const sheetName = workbook.SheetNames[0];

const worksheet = workbook.Sheets[sheetName];

// Przekształć arkusz na format JSON, aby łatwo modyfikować dane

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

// Dodaj nowy wiersz do danych

data.push({ Imię: 'Piotr', Nazwisko: 'Zalewski', Wiek: 40 });

// Utwórz arkusz z zaktualizowanych danych

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

// Zaktualizuj arkusz w skoroszycie

XLSX.utils.book_append_sheet(workbook, newWorksheet, sheetName);

// Zapisz zmodyfikowany skoroszyt

XLSX.writeFile(workbook, 'ścieżka/do/plik.xlsx');

```

W tym kodzie przekształcamy arkusz do formatu JSON, dodajemy nowy wiersz, a następnie tworzymy arkusz zaktualizowanych danych i zapisujemy zmiany.

## Wnioski

Biblioteka `xlsx` w Node.js oferuje szerokie możliwości pracy z plikami Excel. Odczyt i zapis danych są stosunkowo proste, a manipulacja danymi odbywa się za pomocą funkcji konwertujących między formatami JSON a arkuszami. Dzięki temu możesz łatwo zarządzać danymi w formacie Excel w swoich aplikacjach.