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 popularne narzędzie do pracy z arkuszami kalkulacyjnymi w formacie Excel. Umożliwia odczytywanie, pisanie, a także manipulowanie danymi w plikach .xls i .xlsx. Poniżej przedstawiamy kroki, jak zainstalować i używać tej biblioteki.

## Instalacja

Aby rozpocząć, musisz mieć zainstalowane Node.js oraz npm. Jeśli masz je zainstalowane, możesz przejść do instalacji biblioteki `xlsx`. W terminalu wpisz:

```bash

npm install xlsx

```

## Odczyt pliku Excel

Aby odczytać plik Excel, wykonaj następujące kroki:

1. Załaduj bibliotekę `xlsx`.

2. Odczytaj plik za pomocą funkcji `readFile`.

3. Przechowuj dane w odpowiedniej zmiennej.

Oto przykładowy kod:

```javascript

const XLSX = require('xlsx');

// Odczytaj plik

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

// Wybierz arkusz

const sheetName = workbook.SheetNames[0];

const sheet = workbook.Sheets[sheetName];

// Konwertuj arkusz do formatu JSON

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

console.log(data);

```

W tym przykładzie najpierw odczytujemy plik Excel, następnie wybieramy pierwszy arkusz i konwertujemy go do formatu JSON, co ułatwia dalszą manipulację danymi.

## Zapis do pliku Excel

Zapisanie danych do pliku Excel również jest proste. Poniżej znajduje się przykładowy kod, który demonstruje ten proces:

1. Przygotuj dane w formacie JSON.

2. Utwórz nowy arkusz przy użyciu funkcji `json_to_sheet`.

3. Stwórz nowy skoroszyt i dodaj arkusz do niego.

4. Zapisz skoroszyt do pliku.

Oto jak to wygląda w kodzie:

```javascript

const XLSX = require('xlsx');

// Przykładowe dane

const data = [

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

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

];

// Utwórz nowy arkusz

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

// Stwórz nowy skoroszyt

const wb = XLSX.utils.book_new();

XLSX.utils.book_append_sheet(wb, ws, 'Arkusz1');

// Zapisz do pliku

XLSX.writeFile(wb, 'wyniki.xlsx');

```

## Manipulacja danymi

Możesz również dokonywać podstawowych operacji na danych, takich jak filtrowanie czy sortowanie, przed zapisaniem ich do pliku. Biblioteka xlsx nie posiada wbudowanych funkcji do sortowania danych, więc będziesz musiał użyć JavaScript do przetwarzania danych np. za pomocą metody `sort()`.

## Odczyt danych z konkretnych komórek

Aby uzyskać wartości z konkretnych komórek, możesz skorzystać z notacji obiektowej. Na przykład:

```javascript

const cell = sheet['A1']; // Zwróci wartość z komórki A1

console.log(cell.v); // Wyświetli wartość

```

Możesz używać tej samej metody do odczytania innych komórek, zmieniając odpowiednio indeks.

## Wsparcie dla wielu arkuszy

Jeśli twój plik Excel zawiera wiele arkuszy, możesz łatwo przełączać się między nimi, używając ich nazw znajdujących się w tablicy `SheetNames`. Odczyt kilku arkuszy można osiągnąć poprzez:

```javascript

workbook.SheetNames.forEach((sheetName) => {

const sheet = workbook.Sheets[sheetName];

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

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

});

```

## Wnioski

Biblioteka `xlsx` w Node.js jest świetnym narzędziem do pracy z plikami Excel. Dzięki prostocie użycia i wszechstronności, możesz łatwo odczytywać, zapisywać i manipulować danymi, co czyni ją niezwykle przydatnym narzędziem dla programistów.