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 do pracy z plikami Excel w środowisku Node.js. Umożliwia tworzenie, odczytywanie i edytowanie plików w formacie XLSX i CSV. Poniżej przedstawiamy kroki, jak skutecznie zainstalować i używać tej biblioteki.

## Instalacja

Aby rozpocząć, należy zainstalować bibliotekę `xlsx` za pomocą npm. Można to zrobić, otwierając terminal i wykonując polecenie:

```bash

npm install xlsx

```

## Odczyt pliku XLSX

Aby odczytać plik XLSX, należy zaimportować bibliotekę `xlsx` i użyć odpowiednich funkcji. Oto przykład odczytu pliku:

```javascript

const XLSX = require('xlsx');

// Odczyt pliku

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

// Wybierz arkusz

const sheetName = workbook.SheetNames[0];

const worksheet = workbook.Sheets[sheetName];

// Konwersja na JSON

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

console.log(jsonData);

```

W powyższym kodzie:

1. Wczytujemy plik Excela.

2. Wybieramy pierwszy arkusz z książki.

3. Konwertujemy arkusz na format JSON, co ułatwia dalszą obróbkę danych.

## Tworzenie pliku XLSX

Aby stworzyć nowy plik XLSX, możemy użyć następującego kodu:

```javascript

const XLSX = require('xlsx');

// Dane do zapisania

const data = [

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

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

];

// Konwersja danych na arkusz

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

// Tworzenie nowej książki roboczej

const workbook = XLSX.utils.book_new();

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

// Zapis do pliku

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

```

W tym przypadku:

1. Tworzymy dane jako tablicę obiektów.

2. Konwertujemy te dane na arkusz.

3. Tworzymy nową książkę roboczą i dodajemy arkusz do niej.

4. Zapisujemy książkę roboczą do pliku XLSX.

## Odczyt pliku CSV

Biblioteka `xlsx` umożliwia również odczyt plików CSV. Przykład poniżej pokazuje, jak to zrobić:

```javascript

const XLSX = require('xlsx');

// Odczyt pliku CSV

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

// Wybierz arkusz

const sheetName = workbook.SheetNames[0];

const worksheet = workbook.Sheets[sheetName];

// Konwersja na JSON

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

console.log(jsonData);

```

## Zapis danych do pliku CSV

Zapis danych do pliku CSV również jest prosty:

```javascript

const XLSX = require('xlsx');

// Dane do zapisania

const data = [

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

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

];

// Konwersja danych na arkusz

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

// Tworzenie nowej książki roboczej

const workbook = XLSX.utils.book_new();

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

// Zapis do pliku CSV

XLSX.writeFile(workbook, 'ścieżka/do/nowy_plik.csv');

```

## Dodatkowe funkcje

Biblioteka `xlsx` oferuje szereg dodatkowych funkcji, takich jak:

- Praca z formatowaniem komórek.

- Wykonywanie obliczeń matematycznych w arkuszach.

- Umożliwienie manipulacji danymi w bardziej zaawansowany sposób.

Aby uzyskać więcej informacji na temat tych funkcji, zaleca się zapoznanie się z dokumentacją biblioteki `xlsx` na stronie npm lub na GitHubie.

## Podsumowanie

Wykorzystując bibliotekę `xlsx` w Node.js, możemy łatwo czytać, tworzyć i modyfikować pliki Excel oraz CSV. Dzięki prostemu interfejsowi i licznych funkcjach, praca z danymi staje się bardziej efektywna.