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

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

Biblioteka xlsx to jedna z najpopularniejszych bibliotek do pracy z plikami Excel w środowisku Node.js. Umożliwia odczytywanie oraz zapisywanie plików w formatach XLSX oraz XLS, co czyni ją bardzo przydatną w aplikacjach, które wymagają interakcji z danymi przechowywanymi w arkuszach kalkulacyjnych. W tym artykule przedstawimy, jak zainstalować oraz używać biblioteki xlsx, aby móc efektywnie pracować z plikami Excel w Node.js.

## Instalacja

Aby zainstalować bibliotekę xlsx, należy użyć menedżera pakietów npm. Otwórz terminal i wpisz poniższą komendę:

```bash

npm install xlsx

```

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

## Odczyt pliku XLSX

Aby odczytać plik XLSX, należy załadować bibliotekę xlsx oraz użyć funkcji do odczytu pliku. Oto przykład:

```javascript

const XLSX = require('xlsx');

// Ładowanie pliku

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

// Odczyt pierwszego arkusza

const sheetName = workbook.SheetNames[0];

const worksheet = workbook.Sheets[sheetName];

// Konwersja arkusza do formatu JSON

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

console.log(data);

```

W powyższym przykładzie najpierw importujemy bibliotekę xlsx, a następnie ładujemy plik XLSX. Za pomocą `SheetNames` uzyskujemy listę arkuszy w pliku i odczytujemy pierwszy z nich. Następnie konwertujemy arkusz na format JSON, co pozwala nam na łatwe manipulowanie danymi.

## Zapis do pliku XLSX

Zapis do pliku XLSX jest także prosty. Możemy stworzyć nowy arkusz oraz plik i zapisać dane w formacie XLSX. Oto przykład:

```javascript

const XLSX = require('xlsx');

// Przygotowanie danych

const data = [

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

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

];

// Konwersja danych do 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, 'Arkusz1');

// Zapis do pliku

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

```

W tym przykładzie tworzymy tablicę z danymi, a następnie konwertujemy je na arkusz. Następnie tworzymy nowy skoroszyt, dodajemy arkusz, a na końcu zapisujemy skoroszyt jako nowy plik Excel.

## Odczyt z pliku XLSX bezpośrednio na poziomie komórki

Czasami może być potrzebne odczytanie danych z konkretnej komórki. Oto jak to zrobić:

```javascript

const XLSX = require('xlsx');

// Ładowanie pliku

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

const sheetName = workbook.SheetNames[0];

const worksheet = workbook.Sheets[sheetName];

// Odczyt konkretnej komórki

const cell = worksheet['A1']; // A1 to adres komórki

const cellValue = cell ? cell.v : undefined; // v to wartość komórki

console.log(cellValue);

```

W tym przypadku, po załadowaniu pliku, możemy uzyskać dostęp do konkretnej komórki, podając jej adres (np. 'A1'). Wartość komórki jest przechowywana w atrybucie `v`.

## Praca z wieloma arkuszami

Jeśli plik XLSX zawiera wiele arkuszy, można w łatwy sposób iterować przez nie:

```javascript

const XLSX = require('xlsx');

// Ładowanie pliku

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

// Iteracja przez arkusze

workbook.SheetNames.forEach(sheetName => {

const worksheet = workbook.Sheets[sheetName];

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

console.log(`Dane z arkusza ${sheetName}:`, data);

});

```

Dzięki temu kodowi możemy przetworzyć wszystkie arkusze w pliku i uzyskać dane z każdego z nich.

## Wnioski

Biblioteka xlsx w Node.js to potężne narzędzie do pracy z plikami Excel. Pozwala na łatwy odczyt i zapis danych, umożliwiając twórcom aplikacji efektywne zarządzanie danymi w arkuszach kalkulacyjnych. Dzięki przedstawionym przykładom użytkownicy mogą szybko zrozumieć podstawy działania tej biblioteki i zacząć ją wykorzystywać w swoich projektach.