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 w ekosystemie Node.js, które umożliwia łatwe zarządzanie plikami Excel. Dzięki niej można zarówno odczytywać, jak i zapisywać dane w formacie XLSX. W tym artykule opisujemy, jak zainstalować tę bibliotekę oraz jak ją wykorzystać w swoim projekcie.

## Instalacja biblioteki xlsx

Aby rozpocząć korzystanie z biblioteki xlsx, należy najpierw zainstalować ją w swoim projekcie. W tym celu wykorzystaj npm (Node Package Manager). Oto kroki, które należy wykonać:

1. Otwórz terminal i przejdź do katalogu swojego projektu.

2. Wykonaj polecenie:

```bash

npm install xlsx

```

To polecenie zainstaluje bibliotekę xlsx oraz doda ją jako zależność w pliku `package.json`.

## Odczytywanie plików XLSX

Kiedy biblioteka jest już zainstalowana, można rozpocząć odczytywanie danych z plików XLSX. Poniżej przedstawiamy prosty przykład:

```javascript

const XLSX = require('xlsx');

// Odczyt pliku XLSX

const workbook = XLSX.readFile('sciezka/do/twojego/pliku.xlsx');

// Wybór arkusza

const sheetName = workbook.SheetNames[0];

const worksheet = workbook.Sheets[sheetName];

// Konwersja arkusza na format JSON

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

console.log(data);

```

W tym przykładzie odczytujemy plik XLSX, wybieramy pierwszy arkusz oraz konwertujemy go na format JSON, co umożliwia łatwiejsze przetwarzanie danych w aplikacji.

## Zapisywanie danych do pliku XLSX

Możemy także zapisywać dane do plików XLSX. Oto jak można to zrobić:

```javascript

const XLSX = require('xlsx');

// Przygotowanie danych

const data = [

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

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

];

// Konwersja danych do arkusza

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

// Utworzenie nowego skoroszytu i dodanie arkusza

const workbook = XLSX.utils.book_new();

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

// Zapis do pliku XLSX

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

```

W tym przypadku tworzymy prostą tablicę obiektów, konwertujemy ją na arkusz, a następnie zapisujemy do pliku o nazwie `wynik.xlsx`.

## Manipulacja istniejącymi plikami

Można także manipulować istniejącymi plikami XLSX, dodając nowe dane lub aktualizując te, które już istnieją. Oto przykład, jak dodać dane do istniejącego arkusza:

```javascript

const XLSX = require('xlsx');

// Odczyt istniejącego pliku

const workbook = XLSX.readFile('sciezka/do/twojego/pliku.xlsx');

const sheetName = workbook.SheetNames[0];

const worksheet = workbook.Sheets[sheetName];

// Dodanie nowego wiersza

const newRow = { Imie: 'Piotr', Nazwisko: 'Zalewski' };

// Konwersja istniejących danych do tablicy

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

data.push(newRow); // Dodanie nowego wiersza

// Konwersja zaktualizowanej tablicy z powrotem na arkusz

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

// Aktualizacja arkusza w skoroszycie

workbook.Sheets[sheetName] = updatedWorksheet;

// Zapis zaktualizowanego skoroszytu

XLSX.writeFile(workbook, 'sciezka/do/zaktualizowanego/pliku.xlsx');

```

W tym przypadku odczytujemy istniejący plik, dodajemy nowy wiersz, a następnie zapisujemy zaktualizowany skoroszyt jako nowy plik.

## Podsumowanie

Biblioteka xlsx w Node.js to potężne narzędzie do pracy z plikami Excela. Pozwala na łatwe odczytywanie, zapisywanie i manipulowanie danymi w formacie XLSX. Dzięki jej prostocie i funkcjonalności, można szybko zintegrować operacje na plikach Excel w swoich aplikacjach Node.js.