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

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

Biblioteka `xlsx` jest popularnym narzędziem w ekosystemie Node.js, umożliwiającym odczyt i zapis plików Excel w formatach takich jak `.xlsx` i `.xls`. W niniejszym artykule omówimy, jak zainstalować tę bibliotekę oraz jak jej używać do podstawowych operacji na plikach Excel.

## Instalacja biblioteki

Aby rozpocząć, należy zainstalować bibliotekę `xlsx` przy użyciu menedżera pakietów npm. Otwórz terminal i wykonaj następujące polecenie:

```bash

npm install xlsx

```

Po zakończeniu instalacji możesz rozpocząć korzystanie z biblioteki w swojej aplikacji Node.js.

## Odczyt pliku Excel

Aby odczytać plik Excel, najpierw musimy zaimportować bibliotekę `xlsx`, a następnie użyć metody `readFile`. Oto przykład:

```javascript

const xlsx = require('xlsx');

// Odczytanie pliku Excel

const workbook = xlsx.readFile('nazwa_pliku.xlsx');

// Wybór pierwszego arkusza

const sheetName = workbook.SheetNames[0];

const worksheet = workbook.Sheets[sheetName];

// Konwersja danych arkusza na format JSON

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

console.log(jsonData);

```

W powyższym kodzie:

- Używamy metody `readFile`, aby załadować plik.

- Wybieramy pierwszy arkusz z pliku.

- Konwertujemy dane z arkusza na format JSON, który jest przyjazny dla dalszego przetwarzania w JavaScript.

## Zapis do pliku Excel

Zapisanie danych do pliku Excel również jest proste. Możemy stworzyć nowy arkusz, a następnie zbudować nowy plik Excel z tych danych. Oto przykład:

```javascript

const xlsx = require('xlsx');

// Tworzenie nowych danych

const data = [

{ Imie: 'Jan', Nazwisko: 'Kowalski', Wiek: 30 },

{ Imie: 'Anna', Nazwisko: 'Nowak', Wiek: 25 },

];

// Konwersja danych na arkusz

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

// Tworzenie nowego skoroszytu

const workbook = xlsx.utils.book_new();

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

// Zapis do pliku Excel

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

```

W tym przykładzie:

- Tworzymy tablicę obiektów z danymi.

- Konwertujemy te dane na arkusz za pomocą `json_to_sheet`.

- Tworzymy nowy skoroszyt i dodajemy arkusz.

- Zapisujemy plik jako `nowy_plik.xlsx`.

## Przykłady na bardziej złożone operacje

Biblioteka `xlsx` oferuje wiele możliwości, takich jak formatowanie komórek, dodawanie stylów czy manipulowanie istniejącymi plikami. Poniżej przedstawiamy kilka przykładów bardziej zaawansowanych operacji.

### Odczyt z wieloma arkuszami

Jeśli plik Excel zawiera wiele arkuszy, można je wszystkie odczytać w następujący sposób:

```javascript

const xlsx = require('xlsx');

const workbook = xlsx.readFile('wielu_arkuszach.xlsx');

const allSheetsData = {};

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

const worksheet = workbook.Sheets[sheetName];

allSheetsData[sheetName] = xlsx.utils.sheet_to_json(worksheet);

});

console.log(allSheetsData);

```

W tym kodzie iterujemy przez wszystkie nazwy arkuszy i konwertujemy każdy z nich na format JSON, przechowując wyniki w obiekcie.

### Manipulowanie danymi

Możesz również manipulować danymi przed ich zapisem do pliku. Poniższy przykład pokazuje, jak dodać nową kolumnę:

```javascript

const xlsx = require('xlsx');

// Odczyt danych z pliku

const workbook = xlsx.readFile('nazwa_pliku.xlsx');

const worksheet = workbook.Sheets[workbook.SheetNames[0]];

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

// Dodawanie nowej kolumny

jsonData.forEach((row) => {

row['NowaKolumna'] = row['Wiek'] >= 30 ? 'Dorosły' : 'Młody';

});

// Zapis do pliku Excel

const newWorksheet = xlsx.utils.json_to_sheet(jsonData);

const newWorkbook = xlsx.utils.book_new();

xlsx.utils.book_append_sheet(newWorkbook, newWorksheet, 'ZaktualizowanyArkusz');

xlsx.writeFile(newWorkbook, 'zaktualizowany_plik.xlsx');

```

W tym przykładzie dodajemy nową kolumnę na podstawie istniejącej wartości w kolumnie "Wiek".

## Wnioski

Biblioteka `xlsx` w Node.js to potężne narzędzie do pracy z danymi Excel. Oferuje przystępne metody do odczytu, zapisu i manipulacji danymi, co czyni ją idealnym wyborem dla programistów zajmujących się danymi. Dzięki tej bibliotece można łatwo integrować funkcje związane z plikami Excel w aplikacjach Node.js.