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 plików Excel w aplikacjach Node.js. Dzięki niej można łatwo manipulować danymi w formacie XLSX. W niniejszym artykule omówimy, jak zainstalować i używać tej biblioteki w swoich projektach.

## Instalacja

Aby zainstalować bibliotekę xlsx, należy mieć zainstalowane Node.js oraz npm (Node Package Manager). Można zainstalować xlsx, wykonując poniższe polecenie w terminalu:

```bash

npm install xlsx

```

Po zainstalowaniu biblioteki, można rozpocząć pracę z plikami Excel.

## Odczyt plików XLSX

Przykład pokazujący, jak odczytać plik XLSX:

```javascript

const XLSX = require('xlsx');

// Otwórz plik

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

// Wybierz arkusz

const sheetName = workbook.SheetNames[0]; // Nazwa pierwszego arkusza

const worksheet = workbook.Sheets[sheetName];

// Konwersja arkusza na JSON

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

console.log(jsonData);

```

W powyższym przykładzie najpierw wczytujemy plik za pomocą `XLSX.readFile()`, a następnie wybieramy pierwszy arkusz z listy dostępnych arkuszy. Funkcja `XLSX.utils.sheet_to_json()` konwertuje dane arkusza na format JSON, co ułatwia ich dalsze przetwarzanie.

## Zapis danych do pliku XLSX

Możemy również zapisywać dane do plików XLSX. Oto krok po kroku, jak to zrobić:

```javascript

const XLSX = require('xlsx');

// Przygotuj dane do zapisania

const data = [

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

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

];

// Konwersja danych na arkusz

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

// Utworzenie nowego skoroszytu

const workbook = XLSX.utils.book_new();

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

// Zapisz plik

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

```

W tym przypadku przygotowaliśmy dane w formacie JSON, następnie przekonwertowaliśmy je na arkusz wykorzystując `XLSX.utils.json_to_sheet()`. Potem tworzymy nowy skoroszyt i dodajemy do niego arkusz, a na końcu zapisujemy plik przy użyciu `XLSX.writeFile()`.

## Manipulacja danymi w arkuszu

Można również modyfikować dane w arkuszu. Oto przykład, który pokazuje, jak zmienić wartość w określonej komórce:

```javascript

const XLSX = require('xlsx');

// Otwórz plik

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

const sheetName = workbook.SheetNames[0];

const worksheet = workbook.Sheets[sheetName];

// Zmiana wartości w komórce A1

worksheet['A1'].v = 'Nowa Wartość';

// Zapisz zmiany

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

```

Tutaj otwieramy plik, zmieniamy wartość w komórce A1 i zapisujemy zmodyfikowany plik pod nową nazwą.

## Podsumowanie

Dzięki bibliotece xlsx w Node.js można z łatwością odczytywać, zapisywać i manipulować danymi w plikach Excel. Jest to świetne narzędzie dla programistów, którzy często pracują z danymi z arkuszy kalkulacyjnych i potrzebują prostego sposobu na zarządzanie nimi w aplikacjach serwerowych.