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 w ekosystemie Node.js, które umożliwia pracę z plikami Excel (.xlsx). Umożliwia odczyt, zapis oraz manipulację danymi zawartymi w arkuszach kalkulacyjnych. Poniżej przedstawiamy kroki, jak zainstalować i korzystać z tej biblioteki.

## Instalacja

Aby rozpocząć korzystanie z biblioteki `xlsx`, należy najpierw zainstalować ją za pomocą npm. W terminalu wpisz:

```bash

npm install xlsx

```

## Odczyt pliku Excel

Po zainstalowaniu biblioteki możesz przystąpić do odczytu pliku Excel. Poniższy przykład demonstruje, jak wczytać plik oraz odczytać dane z arkusza:

```javascript

const xlsx = require('xlsx');

// Wczytanie pliku

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

// Wybór arkusza

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

const worksheet = workbook.Sheets[sheetName];

// Odczyt danych jako JSON

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

console.log(data);

```

## Zapis do pliku Excel

Można również tworzyć nowe arkusze i zapisywać dane do pliku Excel. Oto jak to zrobić:

```javascript

const xlsx = require('xlsx');

// Tworzenie nowego arkusza

const data = [

{ Name: 'Jan', Age: 30 },

{ Name: 'Anna', Age: 25 }

];

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

// Tworzenie nowego skoroszytu

const workbook = xlsx.utils.book_new();

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

// Zapis do pliku

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

```

## Praca z danymi

Biblioteka `xlsx` pozwala na bardziej złożoną manipulację danymi. Możesz np. dodawać nowe wiersze lub kolumny, modyfikować istniejące dane itp. Oto przykład dodawania nowego wiersza do istniejącego arkusza:

```javascript

const xlsx = require('xlsx');

// Wczytanie istniejącego pliku

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

const sheetName = workbook.SheetNames[0];

const worksheet = workbook.Sheets[sheetName];

// Dodanie nowego wiersza

const newRow = { Name: 'Krzysztof', Age: 40 };

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

data.push(newRow);

// Przekształcenie z powrotem do arkusza

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

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

// Zapis do pliku

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

```

## Przykłady konwersji formatu

Używając biblioteki `xlsx`, można również konwertować pliki między różnymi formatami, na przykład między `.xls` a `.xlsx`. Oto przykład konwersji:

```javascript

const xlsx = require('xlsx');

// Wczytanie pliku .xls

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

// Zapis jako plik .xlsx

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

```

## Podsumowanie

Biblioteka `xlsx` w Node.js jest potężnym narzędziem do pracy z danymi w formacie Excel. Dzięki intuicyjnym funkcjom, można łatwo wczytywać, edytować i zapisywać pliki, co czyni ją przydatną w wielu scenariuszach programistycznych.