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

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

Biblioteka `xlsx` pozwala na łatwe odczytywanie i zapisywanie plików Excel w formacie .xls oraz .xlsx przy użyciu Node.js. Jest to niezwykle przydatne narzędzie dla programistów, którzy potrzebują manipulować danymi w arkuszach kalkulacyjnych. W tym artykule przedstawimy krok po kroku, jak zainstalować i używać biblioteki `xlsx` w swoim projekcie Node.js.

## Krok 1: Instalacja biblioteki

Aby zainstalować bibliotekę `xlsx`, należy najpierw zainstalować Node.js i npm (Node Package Manager). Po zainstalowaniu tych narzędzi otwórz terminal i przejdź do katalogu swojego projektu. Następnie wykonaj następujące polecenie, aby zainstalować bibliotekę:

```bash

npm install xlsx

```

## Krok 2: Importowanie biblioteki

Po zainstalowaniu, możesz zaimportować bibliotekę `xlsx` do swojego pliku JavaScript. Poniższy przykład pokazuje, jak to zrobić:

```javascript

const XLSX = require('xlsx');

```

## Krok 3: Odczytywanie pliku Excel

Aby odczytać plik Excel, musisz użyć metody `readFile`. Poniżej znajduje się przykład odczytu pliku `example.xlsx`:

```javascript

const workbook = XLSX.readFile('example.xlsx');

const sheetName = workbook.SheetNames[0]; // Nazwa pierwszego arkusza

const worksheet = workbook.Sheets[sheetName];

// Konwersja danych do formatu JSON

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

console.log(jsonData);

```

W powyższym kodzie najpierw wczytujemy plik Excel, a następnie uzyskujemy dostęp do jego pierwszego arkusza. Na końcu konwertujemy arkusz do formatu JSON, co pozwala na łatwe przetwarzanie danych.

## Krok 4: Zapisywanie danych do pliku Excel

Możesz również tworzyć nowe pliki Excel lub zapisywać modyfikacje w istniejących plikach. Poniżej znajduje się przykład tworzenia nowego pliku Excel i zapisywania danych:

```javascript

const data = [

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

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

];

// Konwersja danych do arkusza

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

const newWorkbook = XLSX.utils.book_new();

XLSX.utils.book_append_sheet(newWorkbook, newWorksheet, 'Arkusz1');

// Zapisywanie pliku

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

```

W tym przypadku tworzony jest nowy arkusz z danymi, a następnie zapisywany jako `nowy_plik.xlsx`.

## Krok 5: Używanie opcji zaawansowanych

Biblioteka `xlsx` oferuje także wiele zaawansowanych opcji, takich jak formatowanie komórek, ustawianie szerokości kolumn i wiele innych. Oto przykład, jak można zmienić szerokość kolumny:

```javascript

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

ws['!cols'] = [{ wch: 25 }, { wch: 25 }]; // Ustawienie szerokości kolumn

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

```

## Wnioski

Biblioteka `xlsx` w Node.js jest potężnym narzędziem ułatwiającym pracę z plikami Excel. Dzięki prostym metodom i możliwościom konwersji danych, programiści mogą z łatwością odczytywać, modyfikować i zapisywać dane w arkuszach kalkulacyjnych. Używanie tej biblioteki jest intuicyjne i dobrze udokumentowane, co pozwala na szybkie wdrożenie w projektach.