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 służące do odczytu i zapisu plików Excela. Dzięki niej można łatwo manipulować danymi w formacie .xlsx oraz .xls. W tym artykule przedstawimy, jak skutecznie zainstalować i używać tej biblioteki w swoim projekcie.

## Instalacja biblioteki

Aby rozpocząć pracę z biblioteką `xlsx`, najpierw musisz mieć zainstalowane środowisko Node.js. Możesz pobrać je ze strony [nodejs.org](https://nodejs.org/).

Po zainstalowaniu Node.js, przejdź do katalogu swojego projektu i uruchom polecenie:

```bash

npm install xlsx

```

To polecenie zainstaluje bibliotekę `xlsx` w Twoim projekcie i doda ją do sekcji zależności w pliku `package.json`.

## Odczyt danych z pliku Excel

Po zainstalowaniu biblioteki, możesz zacząć odczytywać dane z pliku Excel. Najpierw załaduj bibliotekę i wczytaj plik:

```javascript

const XLSX = require('xlsx');

// Wczytaj plik Excel

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

// Wybierz arkusz

const sheetName = workbook.SheetNames[0]; // pierwsza karta

const worksheet = workbook.Sheets[sheetName];

// Odczytaj dane z arkusza

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

console.log(data);

```

W powyższym przykładzie `XLSX.readFile` jest używane do wczytania pliku Excel. Aby uzyskać dostęp do konkretnego arkusza, używamy `workbook.SheetNames`, by znaleźć nazwę pierwszego arkusza, a następnie `workbook.Sheets` do uzyskania dostępu do odpowiednich danych. Funkcja `sheet_to_json` konwertuje arkusz do formatu JSON, co ułatwia dalsze operacje na danych.

## Zapis danych do pliku Excel

Możesz również zapisywać dane do plików Excel z użyciem biblioteki `xlsx`. Poniżej znajduje się przykład, jak to zrobić:

```javascript

const XLSX = require('xlsx');

// Przygotuj dane do zapisu

const data = [

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

{ Name: 'Anna', Age: 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 skoroszyt do pliku

XLSX.writeFile(workbook, 'ścieżka/do/zapisu/pliku.xlsx');

```

W tym przykładzie zaczynamy od przygotowania danych w formacie tablicy obiektów. Używamy `XLSX.utils.json_to_sheet`, aby przekonwertować te dane na arkusz, a następnie tworzymy nowy skoroszyt i dodajemy do niego arkusz za pomocą `XLSX.utils.book_append_sheet`. Na końcu zapisujemy nasz skoroszyt do pliku za pomocą `XLSX.writeFile`.

## Obsługa różnych formatów danych

Biblioteka `xlsx` obsługuje różne formaty danych. Możesz wczytywać i zapisywać dane w formatach `.xls`, `.xlsx`, `.xlsm` i innych. W zależności od potrzeby, niektóre funkcje mogą się różnić w zależności od formatu pliku. Upewnij się, że używasz odpowiednich metod w zależności od formatu, który planujesz używać.

## Wnioski

Biblioteka `xlsx` w Node.js to wszechstronne narzędzie do pracy z plikami Excel. Dzięki jej łatwej instalacji i prostym metodyom możesz szybko zacząć odczytywać i zapisywać dane w formacie Excel. Zastosowanie tej biblioteki w Twoich projektach może znacznie usprawnić pracę z danymi tabelarycznymi.