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

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

Biblioteka xlsx to popularne narzędzie w ekosystemie JavaScript, które umożliwia odczyt i zapis plików w formacie Excel (XLSX). Jest to szczególnie przydatne w aplikacjach Node.js, gdzie można łatwo manipulować danymi w arkuszach kalkulacyjnych. W tym artykule omówimy, jak zainstalować tę bibliotekę i jak ją wykorzystać w praktyce.

## Instalacja biblioteki xlsx

Aby zainstalować bibliotekę xlsx, należy najpierw upewnić się, że masz zainstalowany Node.js oraz npm (Node Package Manager). Jeśli wszystko jest gotowe, można przejść do instalacji:

1. Otwórz terminal (linuksowy lub wiersz polecenia w systemie Windows).

2. Wybierz katalog, w którym chcesz utworzyć projekt lub otwórz istniejący projekt.

3. Wykonaj polecenie:

```bash

npm install xlsx

```

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

## Odczyt pliku XLSX

Aby odczytać plik XLSX, wystarczy zaimportować bibliotekę i użyć odpowiednich metod. Oto prosty przykład:

```javascript

const XLSX = require('xlsx');

// Ścieżka do pliku XLSX

const path = 'ścieżka/do/twojego/plik.xlsx';

// Odczyt pliku

const workbook = XLSX.readFile(path);

// Wydobycie arkusza z pliku

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

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 i definiujemy ścieżkę do pliku. Następnie czytamy plik i wydobywamy arkusz, który konwertujemy na format JSON, co umożliwia łatwe manipulowanie danymi w aplikacji.

## Zapis danych do pliku XLSX

Zapis danych do pliku XLSX również jest prosty. Można to osiągnąć, tworząc nowy arkusz, a następnie zapisując go do pliku. Oto przykład:

```javascript

const XLSX = require('xlsx');

// Przykładowe dane do zapisania

const data = [

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

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

];

// Konwersja danych do arkusza

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

// Stworzenie nowego skoroszytu

const workbook = XLSX.utils.book_new();

// Dodanie arkusza do skoroszytu

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

// Zapis do pliku XLSX

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

```

W tym przykładzie tworzymy dane w postaci tablicy obiektów, a następnie konwertujemy ją na arkusz. Tworzymy nowy skoroszyt, dodajemy arkusz do niego i zapisujemy jako plik XLSX.

## Odczyt i zapis arkuszy

Możesz również odczytać i zapisać wiele arkuszy w jednym pliku XLSX. Aby to zrobić, wystarczy powtórzyć proces dodawania arkuszy do skoroszytu. Oto przykład:

```javascript

// Odczyt pliku

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

// Odczyt wszystkich arkuszy

workbook.SheetNames.forEach(sheetName => {

const worksheet = workbook.Sheets[sheetName];

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

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

});

// Przykładowe dane do nowego arkusza

const newData = [

{ Kraj: 'Polska', Stolicą: 'Warszawa' },

{ Kraj: 'Niemcy', Stolicą: 'Berlin' }

];

const newWorksheet = XLSX.utils.json_to_sheet(newData);

XLSX.utils.book_append_sheet(workbook, newWorksheet, 'NowyArkusz');

// Zapis do tego samego pliku

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

```

W tym przypadku odczytujemy wszystkie arkusze z istniejącego pliku i wypisujemy ich zawartość, a następnie dodajemy nowy arkusz z przykładowymi danymi i zapisujemy zmodyfikowany plik.

## Podsumowanie

Biblioteka xlsx w Node.js jest niezwykle potężnym narzędziem do pracy z plikami Excel. Dzięki niej mamy możliwość łatwego odczytu i zapisu danych, co czyni ją bardzo użyteczną w różnych projektach związanych z manipulacją danymi. W powyższych przykładach omówiliśmy podstawowe operacje, jednak biblioteka ta oferuje wiele innych możliwości, które można dostosować do swoich potrzeb.