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 odczyt i zapis plików Excel (.xls i .xlsx). Umożliwia manipulację arkuszami kalkulacyjnymi oraz interakcję z danymi w formacie Excela w prosty sposób. W tym artykule omówimy, jak zainstalować i używać tej biblioteki w projekcie Node.js.

## Instalacja

Aby rozpocząć, musisz zainstalować bibliotekę xlsx w swoim projekcie. W tym celu użyj npm (Node Package Manager). Otwórz terminal i wykonaj następujące polecenie:

```bash

npm install xlsx

```

Upewnij się, że jesteś w katalogu swojego projektu, aby zainstalować bibliotekę lokalnie.

## Odczyt pliku Excel

Po zainstalowaniu biblioteki możesz zacząć odczytywać pliki Excel. Poniżej znajduje się przykład, jak to zrobić:

```javascript

const XLSX = require('xlsx');

// Wskaź do pliku Excel

const filePath = 'ścieżka/do/twojego/pliku.xlsx';

// Odczyt pliku

const workbook = XLSX.readFile(filePath);

// Wybór pierwszego arkusza

const sheetName = workbook.SheetNames[0];

const worksheet = workbook.Sheets[sheetName];

// Konwersja arkusza do formatu JSON

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

// Wyświetlanie danych

console.log(data);

```

W tym przykładzie używamy funkcji `XLSX.readFile` do załadowania pliku Excel, a następnie wybieramy pierwszy arkusz. Funkcja `sheet_to_json` konwertuje dane z arkusza na format JSON, co ułatwia ich dalszą obróbkę.

## Zapis do pliku Excel

Zapis danych do pliku Excel jest również prosty. Oto przykład, jak można to zrobić:

```javascript

const XLSX = require('xlsx');

// Przykładowe dane do zapisania

const data = [

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

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

];

// Konwersja danych do arkusza

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

// Tworzenie nowego skoroszytu

const workbook = XLSX.utils.book_new();

// Dodawanie arkusza do skoroszytu

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

// Zapisywanie skoroszytu do pliku

XLSX.writeFile(workbook, 'ścieżka/do/zapisu/pliku.xlsx');

```

W tym przypadku używamy `json_to_sheet`, aby przekonwertować tablicę obiektów na arkusz, a następnie tworzymy nowy skoroszyt i dodajemy arkusz do niego. Funkcja `writeFile` zapisuje skoroszyt do podanego pliku.

## Dodatkowe funkcje

Biblioteka xlsx oferuje wiele funkcjonalności. Możesz na przykład:

- Zmieniać styl komórek.

- Dodawać formuły.

- Wczytywać i zapisywać z plików CSV.

- Pracować z wieloma arkuszami w jednym skoroszycie.

Aby bardziej zgłębić możliwości biblioteki, warto zapoznać się z oficjalną dokumentacją [XLSX.js na GitHubie](https://github.com/SheetJS/sheetjs).

## Podsumowanie

Biblioteka xlsx w Node.js jest potężnym narzędziem do pracy z plikami Excel. Dzięki prostemu interfejsowi API można szybko i łatwo odczytywać oraz zapisywać dane w tym formacie. Zachęcam do eksplorowania dodatkowych opcji i funkcjonalności, które ta biblioteka oferuje, aby w pełni wykorzystać jej możliwości w swoich projektach.