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

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

Biblioteka `xlsx` w Node.js to potężne narzędzie do pracy z plikami programu Excel. Umożliwia odczyt, zapis oraz manipulację danymi w formatach .xls i .xlsx. W tym artykule przedstawimy podstawowe kroki potrzebne do wykorzystania tej biblioteki w projekcie Node.js.

## Instalacja

Aby rozpocząć korzystanie z biblioteki `xlsx`, musisz najpierw zainstalować ją w swoim projekcie. Można to zrobić za pomocą menedżera pakietów npm. W terminalu wpisz poniższe polecenie:

```bash

npm install xlsx

```

## Importowanie biblioteki

Po zainstalowaniu `xlsx`, możesz zaimportować ją do swojego projektu. W przypadku używania modułów ES6 zrób to za pomocą:

```javascript

import * as XLSX from 'xlsx';

```

Jeśli używasz CommonJS (domyślne w Node.js przed wersją 14), użyj:

```javascript

const XLSX = require('xlsx');

```

## Odczyt pliku Excel

Aby odczytać plik Excel, musisz najpierw załadować plik i następnie przekształcić go w obiekt, który można przetwarzać w JavaScript. Poniżej znajduje się przykład, jak to zrobić:

```javascript

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

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

const worksheet = workbook.Sheets[sheetName];

const data = XLSX.utils.sheet_to_json(worksheet); // Konwertowanie arkusza na tablicę obiektów

console.log(data);

```

W powyższym przykładzie najpierw odczytujemy plik Excel, a następnie uzyskujemy jego pierwszą nazwę arkusza. Używając `sheet_to_json`, konwertujemy dane z arkusza na tablicę obiektów, która jest łatwa do obsługi w JavaScript.

## Zapis danych do pliku Excel

Możesz również zapisywać dane do pliku Excel. Oto przykład, jak stworzyć nowy plik Excel i zapisać dane:

```javascript

const newData = [

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

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

];

// Tworzenie nowego arkusza

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

// Tworzenie nowego skoroszytu

const newWorkbook = XLSX.utils.book_new();

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

// Zapis do pliku

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

```

W powyższym kodzie najpierw definiujemy dane, które chcemy zapisać, a następnie tworzymy nowy arkusz i skoroszyt. Na koniec zapisujemy nasz nowy skoroszyt jako plik Excel.

## Manipulacja danymi

Możesz również manipulować danymi w istniejących arkuszach. Na przykład, jeśli chcesz dodać nowy wiersz do już załadowanego arkusza:

```javascript

// Przykładowe dane do dodania

const additionalRow = { Imię: "Krzysztof", Nazwisko: "Wiśniewski", Wiek: 40 };

// Dodawanie nowego wiersza do danych

data.push(additionalRow);

// Tworzenie nowego arkusza na podstawie zmodyfikowanych danych

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

// Aktualizowanie skoroszytu

const modifiedWorkbook = XLSX.utils.book_new();

XLSX.utils.book_append_sheet(modifiedWorkbook, modifiedWorksheet, 'Arkusz1');

// Zapis do pliku

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

```

W tym przykładzie dodajemy dodatkowy wiersz do wcześniej załadowanej tablicy obiektów, a następnie zapisujemy zmodyfikowane dane w nowym pliku.

## Wnioski

Biblioteka `xlsx` w Node.js to wszechstronne narzędzie do pracy z plikami Excel. Dzięki niej można łatwo odczytywać, zapisywać i manipulować danymi w arkuszach. Wystarczy kilka prostych kroków, aby rozpocząć korzystanie z jej funkcji w swoim projekcie.