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 do pracy z arkuszami kalkulacyjnymi w formacie Excel w środowisku Node.js. Umożliwia ona odczyt, zapis oraz manipulację danymi w formatów takich jak .xls i .xlsx. W poniższym artykule przedstawimy, jak zainstalować tę bibliotekę oraz jak jej używać w swoich projektach.

## Instalacja biblioteki

Aby rozpocząć korzystanie z biblioteki `xlsx`, najpierw musisz zainstalować ją w swoim projekcie. Użyj poniższej komendy w terminalu:

```bash

npm install xlsx

```

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

## Odczyt pliku Excel

Aby odczytać dane z pliku Excel, należy zaimportować bibliotekę oraz użyć odpowiednich metod. Oto przykładowy kod, który pokazuje, jak to zrobić:

```javascript

const XLSX = require('xlsx');

// Odczytaj plik Excel

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

// Wybierz pierwszy arkusz

const sheetName = workbook.SheetNames[0];

const worksheet = workbook.Sheets[sheetName];

// Konwertuj dane do formatu JSON

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

// Wyświetl dane w konsoli

console.log(data);

```

W powyższym kodzie `XLSX.readFile` odczytuje plik Excel, a następnie wybiera pierwszy arkusz za pomocą `workbook.SheetNames[0]`. Funkcja `XLSX.utils.sheet_to_json` konwertuje dane do formatu JSON, co ułatwia ich dalsze przetwarzanie.

## Tworzenie pliku Excel

Teraz zobaczmy, jak stworzyć nowy plik Excel i zapisać go na dysku. Oto przykład:

```javascript

const XLSX = require('xlsx');

// Utwórz nowe dane

const data = [

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

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

];

// Konwertuj dane na arkusz

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

// Utwórz nowy skoroszyt

const workbook = XLSX.utils.book_new();

// Dodaj arkusz do skoroszytu

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

// Zapisz skoroszyt do pliku

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

```

W tym przykładzie tworzymy dane w formie tablicy obiektów, które następnie konwertujemy na arkusz przy użyciu `XLSX.utils.json_to_sheet`. Nowy skoroszyt tworzony jest za pomocą `XLSX.utils.book_new`, a arkusz dodawany do niego przy użyciu `XLSX.utils.book_append_sheet`. Na koniec zapisujemy skoroszyt do pliku z wykorzystaniem `XLSX.writeFile`.

## Manipulacja danymi w arkuszu

Możesz również modyfikować istniejące dane w arkuszu. Oto przykład, jak zmienić wartość w określonej komórce:

```javascript

const XLSX = require('xlsx');

// Odczytaj plik Excel

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

const sheetName = workbook.SheetNames[0];

const worksheet = workbook.Sheets[sheetName];

// Zmodyfikuj wartość w komórce A1

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

// Zapisz zmodyfikowany plik z powrotem

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

```

W tym przypadku zostaje odczytany plik, a następnie wartość w komórce A1 jest zmieniana na 'Nowa Wartość'. Zmodyfikowany arkusz zapisujemy do nowego pliku.

## Podsumowanie

W artykule omówiliśmy podstawowe funkcje biblioteki `xlsx`, takie jak odczyt i zapis plików Excel oraz modyfikację danych w arkuszach. Dzięki tej bibliotece możliwe jest łatwe zarządzanie danymi w formacie Excel w aplikacjach Node.js.