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

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

Biblioteka `xlsx` w Node.js to potężne narzędzie do pracy z plikami Excel. Umożliwia odczyt i zapis dokumentów w formatach XLSX, XLS, CSV oraz wielu innych. W tym artykule przedstawimy krok po kroku, jak zainstalować i używać tej biblioteki w aplikacji Node.js.

## Instalacja

Aby rozpocząć pracę z biblioteką `xlsx`, najpierw należy zainstalować ją za pomocą menedżera pakietów npm. Otwórz terminal i uruchom poniższą komendę w katalogu swojego projektu:

```bash

npm install xlsx

```

Po zakończeniu instalacji biblioteka będzie dostępna w twoim projekcie.

## Odczyt pliku Excel

Aby odczytać plik Excel, użyj funkcji `readFile()` z biblioteki `xlsx`. Przykład:

```javascript

const xlsx = require('xlsx');

// Ścieżka do pliku Excel

const filePath = 'przykladowy_plik.xlsx';

// Odczyt pliku

const workbook = xlsx.readFile(filePath);

// Wybór arkusza

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

const worksheet = workbook.Sheets[sheetName];

// Konwersja arkusza na JSON

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

console.log(data);

```

W tym przykładzie otwieramy plik `przykladowy_plik.xlsx`, wybieramy pierwszy arkusz i konwertujemy jego zawartość na format JSON, co ułatwia dalszą analizę danych.

## Tworzenie pliku Excel

Możesz również tworzyć nowe pliki Excel za pomocą biblioteki `xlsx`. Przykład tworzenia prostego pliku Excel:

```javascript

const xlsx = require('xlsx');

// Tworzenie nowego arkusza

const data = [

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

{ Name: 'Anna', Age: 25 },

{ Name: 'Marek', Age: 35 }

];

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

// Tworzenie nowego workbooka i dodanie arkusza

const workbook = xlsx.utils.book_new();

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

// Zapis do pliku Excel

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

```

W tym przykładzie tworzymy arkusz z danymi w formacie JSON, a następnie zapisujemy go do pliku `nowy_plik.xlsx`.

## Odczyt pliku CSV

Biblioteka `xlsx` obsługuje również pliki CSV. Odczyt pliku CSV jest równie prosty jak odczyt pliku Excel. Oto jak to zrobić:

```javascript

const xlsx = require('xlsx');

// Ścieżka do pliku CSV

const filePath = 'przykladowy_plik.csv';

// Odczyt pliku CSV

const workbook = xlsx.readFile(filePath);

// Podobnie jak wcześniej wybieramy arkusz

const sheetName = workbook.SheetNames[0];

const worksheet = workbook.Sheets[sheetName];

// Konwersja na JSON

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

console.log(data);

```

## Zapisywanie danych do pliku CSV

Możesz także zapisywać dane do pliku CSV. Oto przykład:

```javascript

const xlsx = require('xlsx');

// Tworzenie danych

const data = [

{ Name: 'Katarzyna', Age: 28 },

{ Name: 'Tomasz', Age: 33 }

];

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

const workbook = xlsx.utils.book_new();

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

// Zapis do pliku CSV

xlsx.writeFile(workbook, 'nowy_plik.csv', { bookType: 'csv' });

```

W tym przypadku zapisujemy dane do pliku `nowy_plik.csv`.

## Podsumowanie

Biblioteka `xlsx` w Node.js to niezwykle użyteczne narzędzie do pracy z plikami Excel i CSV. Dzięki prostym metodom można odczytywać, tworzyć oraz zapisywać dane, co pozwala na efektywne zarządzanie informacjami w aplikacjach. Wykorzystując przedstawione przykłady, można z łatwością zintegrować obsługę plików Excel w swojej aplikacji.