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 do pracy z plikami Excel w aplikacjach napisanych w Node.js. Umożliwia zarówno odczyt, jak i zapis plików w formatach `.xlsx` oraz `.xls`. Poniżej przedstawiam kroki, jak zainstalować i wykorzystać tę bibliotekę.

## Instalacja biblioteki

Aby rozpocząć korzystanie z biblioteki `xlsx`, najpierw musisz zainstalować ją za pomocą npm. Możesz to zrobić, uruchamiając poniższe polecenie w terminalu:

```bash

npm install xlsx

```

## Odczyt pliku Excel

Aby odczytać plik Excel, musisz zaimportować bibliotekę `xlsx` oraz użyć odpowiednich metod do wczytania i przetworzenia danych.

```javascript

const XLSX = require('xlsx');

// Wczytaj plik Excel

const workbook = XLSX.readFile('nazwa_pliku.xlsx');

// Wybierz pierwszy arkusz

const sheetName = workbook.SheetNames[0];

const worksheet = workbook.Sheets[sheetName];

// Przekształć arkusz na format JSON

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

console.log(data);

```

W powyższym kodzie:

1. Importujemy bibliotekę `xlsx`.

2. Wczytujemy plik Excel do obiektu `workbook`.

3. Wybieramy pierwszy arkusz z pliku.

4. Konwertujemy dane arkusza do formatu JSON, co ułatwia manipulację danymi.

## Zapis do pliku Excel

Zapis danych z powrotem do pliku Excel również jest prosty. Poniżej przedstawiam przykład, jak to zrobić.

```javascript

const XLSX = require('xlsx');

// Przykładowe dane do zapisania

const data = [

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

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

];

// Konwertuj dane do arkusza

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

// Utwórz nowy skoroszyt

const workbook = XLSX.utils.book_new();

// Dodaj arkusz do skoroszytu

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

// Zapisz plik Excel

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

```

W tej części:

1. Tworzymy prostą tablicę obiektów, które chcemy zapisać.

2. Konwertujemy te dane do formatu arkusza.

3. Tworzymy nowy skoroszyt i dodajemy arkusz do niego.

4. Na końcu zapisujemy nowy plik Excel.

## Używanie dodatkowych funkcji

Biblioteka `xlsx` oferuje wiele dodatkowych funkcji, takich jak możliwość formatowania komórek, dodawania stylów czy obsługi zaawansowanych struktur danych. Możesz zapoznać się z dokumentacją biblioteki, aby dowiedzieć się więcej o dostępnych opcjach.

## Wskazówki dotyczące wydajności

Podczas pracy z dużymi plikami Excel warto zwrócić uwagę na wydajność. Biblioteka `xlsx` może zużywać dużo pamięci podczas przetwarzania dużych zbiorów danych, więc zawsze warto testować swoje skrypty na mniejszych próbkach przed ich wykorzystaniem w produkcji.

Znajomość tych podstawowych funkcji pozwoli Ci efektywnie wykorzystać bibliotekę `xlsx` w Twoich projektach Node.js.