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

# Jak używać biblioteki xlsx w Node.js za pomocą npm

Biblioteka `xlsx` to popularne narzędzie, które umożliwia pracę z arkuszami kalkulacyjnymi Excel w aplikacjach Node.js. Dzięki niej możemy czytać, pisać i manipulować danymi w formacie XLSX. Poniżej znajduje się przewodnik krok po kroku dotyczący korzystania z tej biblioteki.

## Instalacja

Aby rozpocząć pracę z biblioteką `xlsx`, najpierw musisz zainstalować ją w swoim projekcie Node.js. Użyj poniższego polecenia w terminalu:

```bash

npm install xlsx

```

## Importowanie biblioteki

Po zainstalowaniu biblioteki, możesz ją zaimportować do swojego pliku JavaScript:

```javascript

const xlsx = require('xlsx');

```

## Odczyt plików Excel

Aby odczytać plik Excel, użyj metody `readFile`. Poniżej znajduje się przykład:

```javascript

const workbook = xlsx.readFile('nazwa_pliku.xlsx');

```

`workbook` to obiekt, który zawiera wszystkie dane i arkusze z pliku. Aby uzyskać dostęp do konkretnego arkusza, użyj metody `sheetNames`, aby wylistować wszystkie arkusze, a następnie `sheet` do ich odczytu:

```javascript

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

const sheet = workbook.Sheets[sheetName];

const jsonData = xlsx.utils.sheet_to_json(sheet);

console.log(jsonData);

```

`sheet_to_json` zamienia dane arkusza na format JSON, co ułatwia ich dalsze przetwarzanie.

## Zapis danych do pliku Excel

Aby stworzyć nowy plik Excel lub zapisać zmodyfikowane dane, można użyć metody `utils.json_to_sheet` do konwersji danych JSON na arkusz, a następnie `writeFile` do zapisu:

```javascript

const newData = [

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

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

];

const newSheet = xlsx.utils.json_to_sheet(newData);

const newWorkbook = xlsx.utils.book_new();

xlsx.utils.book_append_sheet(newWorkbook, newSheet, 'Arkusz1');

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

```

W tym przykładzie tworzony jest nowy plik Excel zawierający dane z tablicy `newData`.

## Manipulacja danymi

Możesz również wprowadzać zmiany w danych przed ich zapisaniem. Na przykład, aby dodać nową kolumnę do istniejącego arkusza:

```javascript

const newColumnName = 'Wiek';

const ages = [25, 30]; // Przykładowe dane

jsonData.forEach((row, index) => {

row[newColumnName] = ages[index];

});

```

Po modyfikacji danych możesz ponownie zapisać je do pliku Excel, wykonując te same kroki, co wcześniej.

## Obsługa błędów

Ważnym aspektem pracy z plikami Excel jest obsługa błędów. Możesz zastosować blok `try-catch`, aby złapać potencjalne wyjątki, które mogą wystąpić podczas odczytu lub zapisu plików:

```javascript

try {

const workbook = xlsx.readFile('nazwa_pliku.xlsx');

// Dalsza obróbka

} catch (error) {

console.error('Błąd podczas odczytu pliku:', error);

}

```

## Podsumowanie

Biblioteka `xlsx` oferuje wszechstronne możliwości pracy z plikami Excel w aplikacjach Node.js. Dzięki prostym funkcjom możesz łatwo odczytywać, zapisywać i manipulować danymi w formacie XLSX, co czyni ją niezwykle użytecznym narzędziem dla programistów.