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, które umożliwia odczyt i zapis arkuszy kalkulacyjnych w formatach Excel (XLSX). W tym artykule przedstawimy, jak zainstalować tę bibliotekę oraz jak jej używać w projekcie Node.js.

### Instalacja biblioteki

Aby rozpocząć korzystanie z biblioteki `xlsx`, najpierw musisz mieć zainstalowany Node.js oraz menedżer pakietów npm. W terminalu przejdź do katalogu swojego projektu, a następnie uruchom następujące polecenie, aby zainstalować bibliotekę:

```bash

npm install xlsx

```

### Odczyt pliku XLSX

Po zainstalowaniu biblioteki możemy przystąpić do odczytu pliku XLSX. Stwórz plik JavaScript, na przykład `read.js`, i zaimportuj bibliotekę `xlsx`. Następnie użyj poniższego kodu do odczytania danych z pliku XLSX:

```javascript

const XLSX = require('xlsx');

// Odczyt pliku XLSX

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

// Wybór arkusza

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

const worksheet = workbook.Sheets[sheetName];

// Konwersja arkusza na format JSON

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

console.log(data);

```

W powyższym kodzie najpierw odczytujemy plik `dane.xlsx`. Następnie wybieramy pierwszy arkusz oraz konwertujemy go na format JSON, który jest łatwy do manipulacji w Node.js.

### Zapis do pliku XLSX

Oprócz odczytu, biblioteka `xlsx` pozwala również na zapis danych do pliku XLSX. Poniżej znajdziesz przykład, jak to zrobić:

```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

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

```

W tym przykładzie stworzyliśmy przykładowe dane, a następnie przekształciliśmy je w arkusz. Stworzyliśmy również nowy skoroszyt i dodaliśmy do niego nasz arkusz, a na końcu zapisaliśmy wszystko do nowego pliku `nowe_dane.xlsx`.

### Inne funkcjonalności

Biblioteka `xlsx` oferuje wiele innych możliwości, takich jak:

- Odczyt danych z różnych arkuszy.

- Możliwość ustawiania stylów komórek.

- Obsługa różnych formatów plików (CSV, XLS, itp.).

- Możliwość manipulowania formułami i wartościami.

Można to osiągnąć dzięki różnym metodom, które są dostępne w bibliotece. Warto zapoznać się z dokumentacją, aby w pełni wykorzystać jej potencjał.

### Przykłady i dokumentacja

Więcej informacji oraz dodatkowe przykłady można znaleźć w oficjalnej dokumentacji bibliotek `xlsx`: [xlsx GitHub](https://github.com/SheetJS/sheetjs). Znajdziesz tam szczegółowe informacje na temat wszystkich funkcji oferowanych przez tę bibliotekę oraz przykłady ich zastosowania.

Używanie biblioteki `xlsx` w Node.js jest proste i efektywne, co czyni ją idealnym rozwiązaniem do pracy z danymi arkuszy kalkulacyjnych.