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

# Używanie biblioteki xlsx w Node.js z npm

Biblioteka `xlsx` jest jedną z najpopularniejszych bibliotek w ekosystemie Node.js do pracy z plikami Excela. Umożliwia odczytywanie, zapisywanie oraz modyfikowanie plików w formatach XLSX i XLS. W tym artykule dowiesz się, jak zainstalować bibliotekę oraz jak wykorzystać jej funkcje w swoim projekcie Node.js.

## Instalacja biblioteki xlsx

Aby zainstalować bibliotekę `xlsx`, musisz najpierw mieć zainstalowanego Node.js oraz npm. Otwórz terminal i przejdź do katalogu swojego projektu. Następnie wykonaj poniższe polecenie:

```bash

npm install xlsx

```

Po zakończeniu instalacji możesz zacząć używać biblioteki w swoim kodzie.

## Odczytywanie plików XLSX

Aby odczytać plik XLSX, załaduj bibliotekę i użyj funkcji `readFile`. Oto przykład:

```javascript

const XLSX = require('xlsx');

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

const sheetName = workbook.SheetNames[0]; // nazwa pierwszego arkusza

const worksheet = workbook.Sheets[sheetName];

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

console.log(data);

```

W powyższym przykładzie:

1. Używamy `XLSX.readFile`, aby wczytać plik Excel.

2. Uzyskujemy nazwę pierwszego arkusza za pomocą `workbook.SheetNames[0]`.

3. Używamy `XLSX.utils.sheet_to_json`, aby przekształcić dane z arkusza do formatu JSON.

## Zapisywanie plików XLSX

Możesz także tworzyć i zapisywać nowe pliki XLSX. Oto przykład, jak zbudować obiekt, a następnie zapisać go jako plik:

```javascript

const XLSX = require('xlsx');

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, 'Arkusz1');

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

```

W tej sekcji:

1. Tworzymy tablicę obiektów, które chcemy zapisać do pliku Excel.

2. Używamy `XLSX.utils.json_to_sheet`, aby przekształcić dane do arkusza.

3. Tworzymy nowy skoroszyt i dodajemy do niego arkusz.

4. Na końcu zapisujemy skoroszyt jako plik `output.xlsx`.

## Modyfikowanie istniejących plików XLSX

Biblioteka `xlsx` umożliwia także modyfikację istniejących plików. Możesz np. dodać nowy wiersz danych do arkusza:

```javascript

const XLSX = require('xlsx');

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

const sheetName = workbook.SheetNames[0];

const worksheet = workbook.Sheets[sheetName];

const newData = { Imię: 'Krzysztof', Nazwisko: 'Nowakowski', Wiek: 40 };

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

data.push(newData);

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

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

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

```

W tym przykładzie:

1. Wczytujemy istniejący plik i uzyskujemy dostęp do arkusza.

2. Odczytujemy dotychczasowe dane, dodajemy nowy rekord oraz przekształcamy zaktualizowaną tablicę z powrotem na arkusz.

3. Zapisujemy zmodyfikowany skoroszyt.

## Wnioski

Biblioteka `xlsx` w Node.js to potężne narzędzie do pracy z plikami Excela. Oferuje proste metody do odczytu, zapisu oraz modyfikacji danych, co czyni ją idealnym wyborem dla projektów, w których potrzebujesz interakcji z plikami XLSX.