Как организовать экспорт данных в Excel и PDF на фронтенде?

Основные подходы к экспорту

Экспорт данных на фронтенде позволяет пользователю скачать файл без обращения к серверу, что ускоряет работу и снижает нагрузку. Существует два популярных формата: Excel для табличных данных и PDF для документов с произвольной версткой. Для каждого формата есть свои библиотеки, которые работают прямо в браузере.

Экспорт в Excel

Для создания файлов Excel чаще всего используют библиотеку SheetJS (xlsx). Она позволяет преобразовать массив объектов или JSON в рабочий лист и сохранить его как .xlsx. Пример кода:

import * as XLSX from 'xlsx';

const data = [
  { name: 'Иван', age: 30 },
  { name: 'Мария', age: 25 }
];

const worksheet = XLSX.utils.json_to_sheet(data);
const workbook = XLSX.utils.book_new();
XLSX.utils.book_append_sheet(workbook, worksheet, 'Данные');
XLSX.writeFile(workbook, 'report.xlsx');

Этот подход прост и подходит для большинства случаев. Если нужны сложные стили, формулы или несколько листов, можно использовать ExcelJS, который предоставляет более широкий API.

Экспорт в PDF

Для PDF часто применяют jsPDF или pdfmake. jsPDF позволяет добавлять текст и изображения напрямую, а pdfmake поддерживает декларативное описание документа. Пример с jsPDF:

import { jsPDF } from 'jspdf';

const doc = new jsPDF();
doc.text('Отчет за месяц', 10, 10);
doc.text('Продажи: 100 000 руб.', 10, 20);
doc.save('report.pdf');

Если нужно экспортировать HTML-таблицу в PDF, можно использовать html2canvas для снятия скриншота и вставки его в PDF, но это менее гибко и тяжелее по производительности.

Когда выбирать фронтенд, а когда сервер

Фронтенд-экспорт удобен для небольших объемов данных и простых отчетов. Если данные большие (сотни тысяч строк) или требуются сложные вычисления, лучше генерировать файл на сервере, чтобы не блокировать браузер. Также серверный экспорт позволяет использовать мощные шаблонизаторы и защитить данные от несанкционированного доступа.

Вывод

Используйте фронтенд-библиотеки для быстрого экспорта небольших и средних объемов данных, когда важна интерактивность и мгновенная реакция. Для тяжелых отчетов или требований к безопасности предпочтите серверную генерацию файлов.