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 arkuszami kalkulacyjnymi Excel w aplikacjach Node.js. Pozwala na odczyt, zapis i manipulowanie plikami .xls i .xlsx. Dzięki niej możemy łatwo przetwarzać dane przechowywane w tych formatach. W poniższym artykule opiszę, jak zainstalować bibliotekę xlsx, a następnie zaprezentuję podstawowe przykłady jej użycia w środowisku Node.js.

## Instalacja biblioteki xlsx

Aby zacząć korzystać z biblioteki xlsx, należy zainstalować ją za pomocą menedżera pakietów npm. Wykonaj poniższe polecenie w terminalu, w katalogu swojego projektu:

```bash

npm install xlsx

```

Po zainstalowaniu biblioteki, możesz ją zaimportować do swojego pliku JavaScript:

```javascript

const xlsx = require('xlsx');

```

## Odczyt pliku Excel

Aby odczytać plik Excel, użyj metody `readFile`. Poniżej przedstawiam prosty przykład, który ilustruje, jak to zrobić:

```javascript

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

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

const worksheet = workbook.Sheets[sheetName];

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

console.log(data);

```

W powyższym kodzie:

1. `readFile` odczytuje plik Excel.

2. `SheetNames` zawiera nazwę arkuszy w pliku, z których możemy korzystać.

3. `sheet_to_json` konwertuje dane z wybranego arkusza na format JSON, co ułatwia ich dalszą obróbkę.

## Zapis do pliku Excel

Aby zapisać dane do pliku Excel, możemy skorzystać z metody `writeFile`. Oto przykład, jak stworzyć nowy plik Excel:

```javascript

const data = [

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

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

];

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

const workbook = xlsx.utils.book_new();

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

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

```

W tym przypadku:

1. Definiujemy dane w formacie tablicy obiektów.

2. `json_to_sheet` konwertuje dane JSON na arkusz.

3. `book_new` tworzy nowy skoroszyt, a `book_append_sheet` dodaje arkusz do skoroszytu.

4. `writeFile` zapisuje skoroszyt do pliku o podanej nazwie.

## Edytowanie istniejącego pliku Excel

Możemy również edytować istniejący plik Excel, odczytując go, modyfikując dane, a następnie zapisując ponownie.

```javascript

const workbook = xlsx.readFile('istniejący_plik.xlsx');

const sheetName = workbook.SheetNames[0];

const worksheet = workbook.Sheets[sheetName];

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

// Modyfikacja danych

data.push({ Imię: 'Ewa', Nazwisko: 'Wiśniewska', Wiek: 28 });

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

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

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

```

W powyższym przykładzie:

1. Odczytujemy istniejący plik i przekształcamy arkusz do formatu JSON.

2. Dodajemy nowy obiekt do danych.

3. Tworzymy nowy arkusz z zmienionymi danymi i zapisujemy go z powrotem.

## Wnioski

Biblioteka xlsx w Node.js jest wszechstronnym narzędziem do pracy z plikami Excel, które pozwala na łatwe odczyt, zapis i manipulowanie danymi. Przykłady podane w artykule powinny pomóc w rozpoczęciu pracy z tą biblioteką i umożliwić zbudowanie własnych rozwiązań do obsługi arkuszy kalkulacyjnych.