Конвертер Excel в JSON

Современные рабочие книги .xlsx — это файлы SpreadsheetML, определённые стандартом ECMA-376 / ISO/IEC 29500 (Office Open XML): расширение .xlsx представляет собой ZIP-контейнер, записи которого — XML-документы в xl/worksheets/sheetN.xml, строки хранятся в таблице общих строк xl/sharedStrings.xml, а типы ячеек объявляются атрибутом t (s = общая строка, n = число, b = логическое, str = встроенная строка, d = дата в ISO 8601). Страница читает загруженный файл через FileReader.readAsArrayBuffer, затем передаёт ArrayBuffer в SheetJS (xlsx). XLSX.read(buffer, {type: 'array'}) возвращает объект рабочей книги, чей массив SheetNames управляет выбором листа, а XLSX.utils.sheet_to_json(sheet, options) обходит сетку ячеек, формируя либо массив объектов (с ключами из строки заголовков), либо массив массивов при header: 1. Устаревший формат .xls — это бинарный BIFF8 (Excel 97-2003), который SheetJS также декодирует через тот же entry point read(), но с type: 'binary' для FileReader.readAsBinaryString или 'array' при чтении байтами. Значения дат в обоих форматах хранятся как серийные номера (дни с начала эпохи 1900 в Excel, с исторической ошибкой високосного года 1900-02-29, сдвигающей даты до 1900-03-01 на один день, или дни с 1904-01-01 при установленном флаге date1904 в Excel для Mac). Преобразование в JavaScript Date: (serial - 25569) * 86400 * 1000 миллисекунд от Unix-эпохи для системы 1900 после учёта ошибки високосного года. Формулы хранятся в атрибуте f, а SheetJS сообщает их последний кэшированный результат в v; если рабочая книга сохранена инструментом без пересчёта (например, при скриптовом экспорте), v может отсутствовать или быть устаревшим. Когда первая строка используется как заголовок, дублирующиеся или пустые ячейки заголовков вынуждают SheetJS пропускать или автоматически переименовывать ключи (например, __EMPTY, __EMPTY_1), что нарушает контракт нижележащего JSON. Диапазоны объединённых ячеек (объявленные в worksheet/mergeCells)отображают значение только в ячейке-якоре верхнего левого угла и выдают undefined в хвостовых ячейках объединения, поэтому объединённая строка заголовков даёт одну заполненную запись, за которой следуют N - 1 записей с пустыми полями. Для рабочих книг размером в десятки мегабайт синхронный путь XLSX.read() может заблокировать поток UI; альтернатива с потоковым разбором — перенести парсинг в Web Worker, чтобы основной поток оставался отзывчивым.

• .xlsx — ZIP-контейнер с XML (ECMA-376 / ISO/IEC 29500); .xls — бинарный формат BIFF8; SheetJS XLSX.read(buffer, {type: 'array'}) обрабатывает оба через FileReader.readAsArrayBuffer.
• Опции sheet_to_json: header: 1 возвращает массив массивов; header: 'A' использует буквы столбцов электронной таблицы; defval: null заполняет разреженные ячейки null вместо удаления ключа; raw: false применяет формат отображения Excel.
• Серийный номер даты Excel — дни с 1900-01-01 (с ошибкой високосного года 1900-02-29; для Mac-системы 1904 — дни с 1904-01-01); JS Date мс = (serial - 25569) * 86400000 от Unix-эпохи.
• Дублирующиеся или пустые ячейки заголовков становятся автоматически переименованными ключами (__EMPTY, __EMPTY_1) или молча конфликтуют; проверяйте JSON на наличие этих строк, прежде чем полагаться на схему.
• Диапазоны объединённых ячеек (worksheet.mergeCells)отображают значение только в ячейке-якоре верхнего левого угла; хвостовые ячейки объединения содержат undefined, поэтому объединённая строка заголовков даёт одну запись со значением и N-1 записей с пустыми полями.
• Ячейки с формулами хранят выражение в f, а последний кэшированный результат в v; инструменты, сохраняющие без пересчёта, оставляют v устаревшим или отсутствующим, а SheetJS возвращает v как есть.
• Перенесите XLSX.read в Web Worker для рабочих книг объёмом более ~10 МБ; синхронный парсинг блокирует requestAnimationFrame и может заморозить вкладку на несколько секунд при больших листах.