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

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

Biblioteka xlsx to potężne narzędzie, które umożliwia pracę z plikami Excel (formaty .xls i .xlsx) w aplikacjach napisanych w Node.js. Dzięki niej można łatwo odczytywać, tworzyć oraz modyfikować arkusze kalkulacyjne. W niniejszym artykule przedstawimy podstawowe kroki, jak zainstalować i używać biblioteki xlsx w projekcie Node.js.

## Instalacja

Aby rozpocząć korzystanie z biblioteki xlsx, najpierw musisz ją zainstalować. Można to zrobić przy użyciu menedżera pakietów npm. Otwórz terminal w folderze swojego projektu i uruchom poniższe polecenie:

```bash

npm install xlsx

```

Po pomyślnej instalacji biblioteki możesz rozpocząć jej użycie w swoim kodzie.

## Odczytywanie plików Excel

Aby odczytać plik Excel, najpierw zaimportuj bibliotekę xlsx do swojego pliku JavaScript. Następnie użyj metody `readFile`, aby załadować arkusz kalkulacyjny.

Przykład:

```javascript

const xlsx = require('xlsx');

// Ścieżka do pliku Excel

const filePath = 'ścieżka/do/twojego/pliku.xlsx';

// Odczytanie pliku

const workbook = xlsx.readFile(filePath);

// Wybór arkusza

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

const worksheet = workbook.Sheets[sheetName];

// Konwersja arkusza do formatu JSON

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

console.log(data);

```

W powyższym przykładzie plik Excel jest wczytywany, a dane z pierwszego arkusza są konwertowane do formatu JSON i wyświetlane w konsoli.

## Tworzenie plików Excel

Biblioteka xlsx pozwala również na tworzenie nowych plików Excel. Możesz utworzyć nowy arkusz kalkulacyjny, dodać dane i zapisać go jako plik.

Przykład:

```javascript

const xlsx = require('xlsx');

// Tworzenie nowego workbook

const workbook = xlsx.utils.book_new();

// Tworzenie danych do arkusza

const data = [

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

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

];

// Tworzenie arkusza z danych

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

// Dodawanie arkusza do workbook

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

// Zapis pliku Excel

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

```

W tym przykładzie tworzymy nowy plik Excel, dodajemy do niego arkusz z danymi i zapisujemy go pod nazwą `nowy_plik.xlsx`.

## Modyfikacja istniejących plików Excel

Możesz również modyfikować istniejące pliki Excel, zmieniając ich zawartość. W poniższym przykładzie odczytujemy plik, modyfikujemy dane, a następnie zapisujemy zmiany.

Przykład:

```javascript

const xlsx = require('xlsx');

// Odczytanie istniejącego pliku

const filePath = 'ścieżka/do/twojego/pliku.xlsx';

const workbook = xlsx.readFile(filePath);

const sheetName = workbook.SheetNames[0];

const worksheet = workbook.Sheets[sheetName];

// Konwersja do JSON, modyfikacja danych

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

data[0].Wiek = 31; // Zmiana wieku pierwszej osoby

// Tworzenie nowego arkusza z zmodyfikowanymi danymi

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

// Zastąpienie starego arkusza nowym

workbook.Sheets[sheetName] = newWorksheet;

// Zapisanie zmienionego pliku

xlsx.writeFile(workbook, filePath);

```

W tym przykładzie odczytujemy plik Excel, modyfikujemy wiek pierwszej osoby, a następnie zapisujemy zmiany z powrotem do tego samego pliku.

## Podsumowanie

Biblioteka xlsx w Node.js to niezwykle przydatne narzędzie do pracy z plikami Excel. Oferuje możliwość odczytywania, tworzenia i edytowania arkuszy kalkulacyjnych w prosty i efektywny sposób. Dzięki prezentowanym przykładom można szybko zacząć korzystać z tej biblioteki w swoich projektach.