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

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

Biblioteka `xlsx` to jedna z najczęściej używanych bibliotek w Node.js do pracy z plikami Excel. Umożliwia odczytywanie, zapisywanie i manipulowanie arkuszami kalkulacyjnymi w formatach XLSX i XLS. W poniższym artykule przedstawimy, jak zainstalować i wykorzystać bibliotekę `xlsx` w projekcie Node.js.

## Instalacja biblioteki xlsx

Aby rozpocząć pracę z biblioteką `xlsx`, należy najpierw zainstalować ją za pomocą npm. Otwórz terminal w katalogu swojego projektu i wpisz następującą komendę:

```bash

npm install xlsx

```

Po zainstalowaniu biblioteki, możesz zacząć jej używać w swoim projekcie.

## Odczyt pliku Excel

Aby odczytać plik Excel, najpierw zaimportuj bibliotekę `xlsx` w swoim pliku JavaScript. Następnie użyj funkcji `readFile`, aby załadować zawartość pliku. Przykładowy kod wygląda następująco:

```javascript

const XLSX = require('xlsx');

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

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

const worksheet = workbook.Sheets[sheetName];

// Konwertujemy arkusz na format JSON

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

console.log(data);

```

W powyższym kodzie:

1. Importujemy bibliotekę `xlsx`.

2. Ładujemy plik Excel za pomocą `readFile`.

3. Wybieramy pierwszy arkusz z pliku.

4. Konwertujemy wybrany arkusz na format JSON, co ułatwia dalsze manipulacje danymi.

## Zapis do pliku Excel

Możemy również tworzyć i zapisywać nowe pliki Excel. Aby to zrobić, utwórz notebook (obiekt roboczy) i dodaj arkusze do niego. Oto przykład:

```javascript

const XLSX = require('xlsx');

// Tworzymy nowy obiekt roboczy

const workbook = XLSX.utils.book_new();

// Tworzymy dane do arkusza

const data = [

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

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

];

// Konwertujemy dane na arkusz

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

// Dodajemy arkusz do obiektu roboczego

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

// Zapisujemy obiekt roboczy do pliku Excel

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

```

W tym przykładzie:

1. Tworzymy nowy obiekt roboczy.

2. Definiujemy dane do dodania.

3. Konwertujemy dane do formatu arkusza.

4. Dodajemy arkusz do obiektu roboczego.

5. Zapisujemy obiekt roboczy do nowego pliku Excel.

## Manipulowanie danymi

Biblioteka `xlsx` oferuje wiele funkcji umożliwiających manipulację danymi w arkuszach. Możemy dodawać, edytować czy usuwać komórki. Oto krótki przykład, jak zaktualizować wartość w istniejącym arkuszu:

```javascript

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

const sheetName = workbook.SheetNames[0];

const worksheet = workbook.Sheets[sheetName];

// Aktualizujemy wartość w komórce A1

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

// Zapisujemy zmodyfikowany arkusz do pliku

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

```

W powyższym kodzie zmieniamy wartość w komórce `A1` i zapisujemy zmodyfikowany plik.

## Podsumowanie

Biblioteka `xlsx` w Node.js to potężne narzędzie do pracy z plikami Excel. Pozwala na odczyt, zapis oraz manipulację danymi w prosty sposób. Dzięki niej można łatwo przetwarzać dane i generować raporty w formacie XLSX. Warto eksplorować dokumentację biblioteki `xlsx`, aby odkryć wszystkie dostępne funkcje i możliwości, które ułatwią pracę z danymi w aplikacjach Node.js.