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

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

Biblioteka `xlsx` w Node.js to popularne narzędzie do odczytu i zapisu plików w formacie Excel (xls, xlsx). Umożliwia łatwą pracę z danymi tabelarycznymi, co jest szczególnie przydatne w aplikacjach webowych i backendowych. W tym artykule przedstawimy kroki potrzebne do zainstalowania i używania tej biblioteki.

### Krok 1: Instalacja biblioteki

Aby rozpocząć, musisz mieć zainstalowane Node.js oraz npm. Jeśli nie masz ich jeszcze, odwiedź stronę [Node.js](https://nodejs.org/) i pobierz odpowiednią wersję. Następnie otwórz terminal i przejdź do katalogu swojego projektu. Wykonaj poniższą komendę, aby zainstalować bibliotekę `xlsx`:

```bash

npm install xlsx

```

### Krok 2: Odczyt pliku Excel

Po zainstalowaniu biblioteki można przystąpić do odczytu pliku Excel. Utwórz plik JavaScript, na przykład `readExcel.js`, a następnie zaimportuj bibliotekę `xlsx` oraz odczytaj plik:

```javascript

const xlsx = require('xlsx');

// Ścieżka do pliku Excel

const filePath = 'sciezka/do/twojego/pliku.xlsx';

// Odczyt pliku

const workbook = xlsx.readFile(filePath);

// Wybór arkusza

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

const worksheet = workbook.Sheets[sheetName];

// Odczyt danych jako JSON

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

console.log(jsonData);

```

### Krok 3: Zapis danych do pliku Excel

Aby zapisać dane do pliku Excel, należy przygotować odpowiednią strukturę danych, a następnie użyć funkcji zapisu. Przykład:

```javascript

const xlsx = require('xlsx');

// Przygotowanie danych

const data = [

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

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

];

// Tworzenie arkusza

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

// Tworzenie nowego skoroszytu

const workbook = xlsx.utils.book_new();

// Dodawanie arkusza do skoroszytu

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

// Zapis do pliku

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

```

### Krok 4: Obsługa różnych formatów

Biblioteka `xlsx` obsługuje różne formaty plików, zarówno `.xls`, jak i `.xlsx`. Możesz używać tych samych metod do odczytu i zapisu dla obu formatów. Wystarczy, że podasz odpowiednią ścieżkę do pliku.

### Krok 5: Praca z danymi

Możesz również manipulować danymi bezpośrednio w arkuszu. Oto przykład, jak dodać nowy wiersz do istniejącego arkusza:

```javascript

const xlsx = require('xlsx');

// Odczyt istniejącego pliku

const filePath = 'sciezka/do/twojego/pliku.xlsx';

const workbook = xlsx.readFile(filePath);

const sheetName = workbook.SheetNames[0];

const worksheet = workbook.Sheets[sheetName];

// Dodawanie nowego wiersza

const newRow = { Imię: 'Katarzyna', Nazwisko: 'Wiśniewska', Wiek: 28 };

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

data.push(newRow);

// Tworzenie nowego arkusza z zaktualizowanymi danymi

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

xlsx.utils.book_append_sheet(workbook, newWorksheet, 'ZaktualizowaneDane');

// Zapis do pliku

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

```

### Krok 6: Używanie opcji

Biblioteka `xlsx` pozwala także na korzystanie z różnych opcji podczas konwersji danych. Możesz na przykład określić, które kolumny chcesz odczytać lub zapisać. Opcje można przekazać jako drugi argument do odpowiednich funkcji.

Oto przykład:

```javascript

const xlsx = require('xlsx');

// Wczytanie pliku z opcjami

const workbook = xlsx.readFile(filePath, { cellDates: true }); // Odczyt dat jako obiektów Date

```

### Krok 7: Przykłady i dokumentacja

Aby poznać więcej możliwości biblioteki `xlsx`, warto zajrzeć do dokumentacji dostępnej na stronie [GitHub](https://github.com/SheetJS/sheetjs). Znajdziesz tam szczegółowy opis wszystkich funkcji oraz użycia biblioteki.

Biblioteka `xlsx` w Node.js to potężne narzędzie umożliwiające pracę z danymi w formacie Excel. Dzięki prostym w użyciu metodom, można szybko i efektywnie odczytywać i zapisywać dane, co czyni ją idealnym rozwiązaniem dla wielu aplikacji.