Конвертация Excel в JSON с помощью npm и xlsx: руководство для разработчиков

Конвертация данных из формата Excel в JSON — важная задача для разработчиков и специалистов в области data science в России, особенно когда речь идет об интеграции с веб-приложениями и API. В этой статье вы узнаете, как с помощью npm и популярной библиотеки `xlsx` легко и быстро преобразовать файлы Excel в формат JSON.

Шаг 1: Установка Node.js и npm

Перед тем как приступить, убедитесь, что у вас установлены Node.js и npm. Эти инструменты можно скачать с официального сайта. Установка npm происходит автоматически вместе с Node.js.

Проверка установки:

Откройте терминал и выполните команды:

node -v
npm -v

Если команды вернут версии, значит, установка прошла успешно.

Шаг 2: Установка библиотеки для работы с Excel

Для преобразования Excel в JSON вы можете использовать несколько npm-пакетов, но мы сосредоточимся на библиотеке `xlsx`, так как она проста в использовании и многофункциональна.

Установка библиотеки:

npm install xlsx

Шаг 3: Создание проекта и написание скрипта конвертации

Создание проекта: Выполните следующие команды в терминале:

mkdir excel-to-json
cd excel-to-json
npm init -y

Теперь создайте файл convert.js и добавьте в него следующий код:

const XLSX = require('xlsx');
const fs = require('fs');

// Чтение Excel-файла
const workbook = XLSX.readFile('input.xlsx');

// Получение имени первого листа
const sheetName = workbook.SheetNames[0];

// Получение данных листа
const worksheet = workbook.Sheets[sheetName];

// Преобразование данных в JSON
const jsonData = XLSX.utils.sheet_to_json(worksheet);

// Запись JSON в файл
fs.writeFileSync('output.json', JSON.stringify(jsonData, null, 2));

console.log('Конвертация завершена. Результат сохранен в output.json');

Шаг 4: Запуск скрипта

Запустите созданный скрипт, выполнив команду:

node convert.js

После успешного выполнения скрипта, файл output.json будет создан в вашем проекте.

Шаг 5: Расширенные возможности и настройки

Теперь, когда базовая конвертация завершена, рассмотрим несколько расширенных возможностей.

Обработка нескольких листов

Если у вас много листов в Excel-файле, вы можете конвертировать все листы сразу:

const jsonData = workbook.SheetNames.map(sheetName => {
    const worksheet = workbook.Sheets[sheetName];
    return { sheetName, data: XLSX.utils.sheet_to_json(worksheet) };
});

Фильтрация и преобразование данных

Для еще большего контроля над данными можно настроить фильтрацию:

const jsonData = XLSX.utils.sheet_to_json(worksheet).map(row => {
    if (row.Age && row.Age > 18) {
        return {
            name: row.Name,
            age: row.Age,
            email: row.Email.toLowerCase()
        };
    }
}).filter(Boolean);

Шаг 6: Автоматизация конвертации

Для автоматизации процесса добавьте скрипт в файл package.json:

{
    "scripts": {
        "convert": "node convert.js"
    }
}

Запускайте его с помощью команды:

npm run convert

Заключение

Конвертация Excel в JSON с помощью npm и библиотеки `xlsx` — это надежный способ обработки данных. Применяя различные настройки и фильтрацию, вы можете адаптировать процесс под ваши потребности. Обязательно следите за обработкой ошибок и безопасностью, особенно если работаете с пользовательскими данными.