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

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

Biblioteka `xlsx` w Node.js to potężne narzędzie do pracy z arkuszami kalkulacyjnymi w formacie Excel. Umożliwia ona zarówno odczyt, jak i zapis plików XLSX. W tym artykule przedstawimy, jak zainstalować tę bibliotekę oraz jak rozpocząć pracę z jej funkcjami.

### Instalacja

Aby zainstalować bibliotekę `xlsx`, musisz mieć zainstalowane Node.js oraz zarządzacz pakietami NPM. Jeśli wszystko jest gotowe, otwórz terminal i uruchom poniższe polecenie:

```bash

npm install xlsx

```

Po zainstalowaniu biblioteki, możesz rozpocząć pracę w swoim projekcie Node.js.

### Odczyt plików XLSX

Aby odczytać dane z arkusza XLSX, wykonaj następujące kroki:

1. Najpierw załaduj bibliotekę `xlsx` w swoim pliku JavaScript:

```javascript

const xlsx = require('xlsx');

```

2. Użyj metody `readFile`, aby wczytać plik XLSX:

```javascript

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

```

3. Możesz uzyskać dostęp do arkuszy w pliku za pomocą metody `SheetNames`:

```javascript

const sheetName = workbook.SheetNames[0]; // pobierz pierwszy arkusz

const worksheet = workbook.Sheets[sheetName];

```

4. Następnie użyj metody `utils.sheet_to_json`, aby przekonwertować dane arkusza na format JSON:

```javascript

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

console.log(data);

```

### Zapis do plików XLSX

Aby zapisać dane do pliku XLSX, postępuj według następujących kroków:

1. Najpierw stwórz dane, które chcesz zapisać. Na przykład:

```javascript

const jsonData = [

{ nazwa: "Produkt 1", cena: 100 },

{ nazwa: "Produkt 2", cena: 200 },

];

```

2. Użyj metody `utils.json_to_sheet`, aby przekonwertować dane JSON na arkusz:

```javascript

const newWorksheet = xlsx.utils.json_to_sheet(jsonData);

```

3. Następnie stwórz nowy skoroszyt i dodaj arkusz:

```javascript

const newWorkbook = xlsx.utils.book_new();

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

```

4. Na końcu użyj metody `writeFile`, aby zapisać nowy plik XLSX:

```javascript

xlsx.writeFile(newWorkbook, 'sciezka/do/nowego_pliku.xlsx');

```

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

Biblioteka `xlsx` obsługuje różne formaty danych, co pozwala na elastyczne zarządzanie danymi w arkuszach. Możesz łatwo zmieniać typy danych podczas konwersji, manipulować wartościami, a także formatować komórki.

### Wskazówki i uwagi

- Upewnij się, że pliki XLSX, które próbujesz odczytać lub zapisać, są dobrze sformatowane, aby uniknąć błędów.

- Eksperymentuj z różnymi metodami biblioteki `xlsx`, aby poznać jej pełne możliwości.

Powyższe kroki pozwolą Ci rozpocząć pracę z biblioteką `xlsx` w Node.js. Dzięki niej możesz efektywnie zarządzać danymi w arkuszach Excel w swoim projekcie.