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 pozwala na pracę z arkuszami kalkulacyjnymi w formacie Excel. Dzięki niej można odczytywać, tworzyć i modyfikować pliki .xlsx w aplikacjach Node.js. W tym artykule przedstawimy, jak zainstalować tę bibliotekę oraz jak używać jej w praktyce.

## Instalacja biblioteki

Aby rozpocząć pracę z biblioteką `xlsx`, należy najpierw zainstalować ją w projekcie Node.js. Można to zrobić za pomocą menedżera pakietów npm. Otwórz terminal i wprowadź następującą komendę:

```bash

npm install xlsx

```

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

## Odczytywanie pliku Excel

Aby odczytać plik .xlsx, należy zaimportować bibliotekę `xlsx` do swojego programu i użyć jej funkcji. Poniżej znajduje się przykład, jak to zrobić:

```javascript

const xlsx = require('xlsx');

// Odczytaj plik Excel

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

// Wyciągnij pierwszą arkusz

const sheetName = workbook.SheetNames[0];

const worksheet = workbook.Sheets[sheetName];

// Przekształć arkusz na format JSON

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

console.log(jsonData);

```

W powyższym kodzie:

1. Importujemy bibliotekę `xlsx`.

2. Używamy `xlsx.readFile()` do odczytania pliku.

3. Wyciągamy nazwy arkuszy przy pomocy `workbook.SheetNames`.

4. Używamy `xlsx.utils.sheet_to_json()` do konwersji arkusza na format JSON, co ułatwia dalszą obróbkę danych.

## Tworzenie pliku Excel

Możesz także tworzyć nowe pliki Excel. Oto 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 },

];

// Przekształć dane na arkusz

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

// Stwórz nowy skoroszyt

const workbook = xlsx.utils.book_new();

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

// Zapisz plik Excel

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

```

W tym przykładzie:

1. Tworzymy tablicę z danymi, które chcemy zapisać.

2. Używamy `xlsx.utils.json_to_sheet()` do przekształcenia danych na arkusz.

3. Tworzymy nowy skoroszyt przy użyciu `xlsx.utils.book_new()`.

4. Dodajemy arkusz do skoroszytu z oznaczeniem "Arkusz1".

5. Zapisujemy nowy plik jako `nowy_plik.xlsx`.

## Modyfikacja istniejącego pliku Excel

Możliwe jest również modyfikowanie istniejących plików Excel. Przykład poniżej pokazuje, jak można to osiągnąć:

```javascript

const xlsx = require('xlsx');

// Odczytaj istniejący plik

const workbook = xlsx.readFile('ścieżka/do/istniejącego_pliku.xlsx');

const sheetName = workbook.SheetNames[0];

const worksheet = workbook.Sheets[sheetName];

// Dodaj nowe dane

const newRow = { Imię: 'Kasia', Nazwisko: 'Wiśniewska', Wiek: 28 };

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

existingData.push(newRow);

// Przekształć zaktualizowane dane na arkusz

const updatedWorksheet = xlsx.utils.json_to_sheet(existingData);

// Zaktualizuj arkusz w skoroszycie

workbook.Sheets[sheetName] = updatedWorksheet;

// Zapisz zaktualizowany plik

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

```

W tym przypadku:

1. Odczytujemy istniejący plik przy użyciu `xlsx.readFile()`.

2. Konwertujemy arkusz na format JSON, dodajemy nowy wiersz, a następnie przekształcamy go z powrotem na arkusz.

3. Aktualizujemy arkusz w skoroszycie i zapisujemy zmiany.

## Użycie formatów i stylów

Biblioteka `xlsx` pozwala także na stosowanie prostych formatów i stylów do komórek. Poniżej przedstawiamy przykład, jak to zrealizować:

```javascript

const xlsx = require('xlsx');

// Przygotuj dane

const data = [{ Imię: 'Jan', Nazwisko: 'Kowalski' }];

// Tworzenie arkusza

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

// Ustawienia formatów komórek

worksheet['A1'].s = { fill: { fgColor: { rgb: 'FFFF00' } } }; // Żółte tło dla komórki A1

worksheet['B1'].s = { font: { bold: true } }; // Pogrubienie fontu dla komórki B1

// Stwórz nowy skoroszyt

const workbook = xlsx.utils.book_new();

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

// Zapisz plik

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

```

W tym przypadku mamy do czynienia z prostym formatowaniem kolumn. Można zmieniać kolory, czcionki i inne właściwości komórek.

## Wnioski

Biblioteka `xlsx` w Node.js oferuje wszechstronny zestaw narzędzi do pracy z plikami Excel. Możesz łatwo odczytywać, tworzyć, modyfikować oraz stosować różne formaty i style, co czyni ją niezwykle przydatnym rozwiązaniem w aplikacjach, które korzystają z danych w arkuszach kalkulacyjnych.