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

# Użycie biblioteki xlsx w Node.js z npm

Biblioteka xlsx to popularne narzędzie w ekosystemie Node.js, które umożliwia tworzenie, odczytywanie i manipulowanie plikami Excel (format .xlsx). W tym artykule omówimy, jak zainstalować tę bibliotekę oraz jak jej używać do podstawowych operacji.

## Instalacja biblioteki

Aby zacząć korzystać z biblioteki xlsx, musisz najpierw zainstalować ją za pomocą npm. Otwórz terminal i wprowadź poniższą komendę w katalogu projektu:

```bash

npm install xlsx

```

Po zakończeniu instalacji możesz zacząć używać biblioteki w swoim projekcie.

## Importowanie biblioteki

W kodzie JavaScript musisz zaimportować bibliotekę xlsx, co można zrobić w sposób pokazany poniżej:

```javascript

const XLSX = require('xlsx');

```

## Tworzenie arkusza i pliku Excel

Możesz stworzyć nowy arkusz i plik Excel, definiując dane w formacie tablicy obiektów. Oto przykład, jak to zrobić:

```javascript

const data = [

{ A: 'Imię', B: 'Nazwisko', C: 'Wiek' },

{ A: 'Jan', B: 'Kowalski', C: 30 },

{ A: 'Anna', B: 'Nowak', C: 25 },

];

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

const workbook = XLSX.utils.book_new();

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

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

```

W powyższym przykładzie tworzymy arkusz z danymi użytkownika i zapisujemy go jako plik o nazwie `przykladowy_plik.xlsx`.

## Odczyt pliku Excel

Możesz również odczytać dane z istniejącego pliku Excel. Oto jak można to zrobić:

```javascript

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

const worksheet = workbook.Sheets['Arkusz1'];

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

console.log(data);

```

W tym przypadku plik `przykladowy_plik.xlsx` jest odczytywany, arkusz "Arkusz1" jest wydobywany, a następnie zamieniany na tablicę obiektów, które są następnie wypisywane na konsolę.

## Modyfikowanie danych w pliku Excel

Możesz również modyfikować dane w arkuszu przed zapisaniem ich do pliku Excel. Oto przykład:

```javascript

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

const worksheet = workbook.Sheets['Arkusz1'];

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

// Modyfikacja wartości

data[0].C = 31; // Przykład: zmiana wieku Jana Kowalskiego

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

XLSX.utils.book_append_sheet(workbook, newWorksheet, 'ZmienionyArkusz');

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

```

Tutaj odczytujemy dane, modyfikujemy jedną z wartości, a następnie zapisujemy zmodyfikowany arkusz jako nowy plik `zmodyfikowany_plik.xlsx`.

## Obsługa różnych formatów

Biblioteka xlsx obsługuje różne formaty plików Excel, w tym .xls i .csv. Możesz z łatwością konwertować pliki CSV na format Excel i odwrotnie. Oto przykład konwersji pliku CSV do pliku Excel:

```javascript

const fs = require('fs');

const csvData = fs.readFileSync('przykladowy_plik.csv', 'utf8');

const workbook = XLSX.read(csvData, { type: 'string', codepage: 65001 });

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

```

W powyższym kodzie wczytujemy dane z pliku CSV i zapisujemy je jako plik Excel.

## Podsumowanie

Biblioteka xlsx w Node.js jest potężnym narzędziem do obsługi plików Excel. Dzięki prostemu interfejsowi API można łatwo wykonywać operacje związane z tworzeniem, odczytem i modyfikowaniem danych w plikach Excel. Wprowadzone przykłady stanowią podstawę do dalszego eksplorowania możliwości biblioteki xlsx.