Библиотека A4 для Node.js

Что умеет

• книги .xlsx, .xlsm, .xlsb, .xls, .ods, .csv: открыть, записать число, текст или формулу, пересчитать, прочитать значение ячейки, сохранить;
• документы .docx и .docm: текст одной строкой кода;
• презентации .pptx: открыть, добавить слайд, узнать число слайдов, сохранить.

Пакет — модуль ES: подключается через import.

Установка

Пакет ставится с нашего сервера загрузок, а не из общего каталога npm. Ставьте два архива одной командой: основной пакет и ядра своей платформы. Например, для macOS на Apple silicon:

npm install https://dl.plantype.ru/a4office/release/node/2026.4.5/a4office-native-darwin-arm64-2026.4.5.tgz https://dl.plantype.ru/a4office/release/node/2026.4.5/a4office-2026.4.5.tgz

Для другой платформы замените первый архив:

Единственная зависимость пакета — koffi — ставится из каталога npm. Каталог архивов — dl.plantype.ru/a4office/release/node/2026.4.5/.

Первый пример

Файлы для примеров: report.xlsx (открыть в A4 Таблице), contract.docx (открыть в A4 Документе), deck.pptx (открыть в A4 Презентации) — или все сразу: curl -O https://tech.plantype.ru/samples/report.xlsx -O https://tech.plantype.ru/samples/contract.docx -O https://tech.plantype.ru/samples/deck.pptx (в Windows — curl.exe). Подойдут и свои файлы.

Открыть книгу, записать ячейку, пересчитать и сохранить; прочитать текст документа; добавить слайд:

import { open, text } from "a4office";

const wb = open("report.xlsx");
const sheet = wb.sheet([...wb.sheets.keys()][0]);  // первый лист
sheet.set("B11", 41).set("C11", "=B11+1");         // число, текст, null или формула
wb.recalc();
console.log(sheet.get("C11"));                     // 42
wb.save("report-edited.xlsx");
wb.close();

console.log(text("contract.docx"));

const deck = open("deck.pptx");
deck.addSlide();
console.log(deck.slideCount);
deck.save("deck-edited.pptx");
deck.close();

open() по расширению файла возвращает книгу (Workbook) или презентацию (Presentation). save() без аргумента перезаписывает исходный файл. Ошибки — OfficeError; кончилась квота — LicenseQuotaError. Версия ядер внутри пакета — coreVersion().

Что бесплатно

Квоту платят открытие и сохранение файла в любом из трёх ядер — книги, документы и презентации считаются вместе; правки внутри открытого файла, сколько бы ячеек вы ни меняли, не считаются. Чтобы получить ключ разработчика, напишите нам: вместе с ключом пришлём, как подключить его к вашей программе.

Где считается: в файле ~/.layers/a4office-state.json, а если задана переменная A4OFFICE_STATE_DIR — в этом каталоге. Ключ ищется по порядку: переменная A4OFFICE_LICENSE, файл из A4OFFICE_LICENSE_FILE, файл ~/.layers/license.jws. Ключ в последнем действует на все запуски на этой машине, и бесплатные 30 тогда не считаются; проверить бесплатный режим на такой машине — направить A4OFFICE_LICENSE_FILE на пустой файл.

Чего нет

• просмотрщика и редактора в браузере: показать документ людям — Сервер A4;
• преобразования в PDF и картинок страниц;
• документы Word в коротком API только читаются; правка — через низкоуровневый Session;
• макросы VBA не исполняются.

Показать документ людям

Библиотека создаёт и меняет файлы внутри вашей программы. Просмотрщика и редактора в браузере в ней нет: view() отвечает, где взять сервер, и ссылкой на его страницу. Показать документы людям и дать их править — задача остальных изделий A4:

• В браузере — Сервер A4. Файлы, которые создаёт ваша программа, открываются в редакторах A4 Документ, A4 Таблица и A4 Презентация на сервере организации; правка возвращается новой версией. Сервер A4; подключение к 1С и Битрикс24.
• На компьютере — настольные редакторы. A4 Документ, A4 Таблица и A4 Презентация для Windows, macOS и Linux. Скачать.
• Из почты и учётных программ — A4 Office. Вложение или файл из 1С открывается в редакторе на компьютере и возвращается обратно. A4 Office на компьютере.
• Внутри вашего продукта. Те же редакторы, встроенные в ваше приложение, — для партнёров: мобильный SDK; напишите нам.

Скачать

Контрольные суммы

3132555dedd7c2e3268c8742e937be79c4336846cfff3a86ef11dd1a714577f9  a4office-2026.4.5.tgz
e12f83169e77b8f9ad919148a67df24bfb9a8464b7532fe9731ec0c2c2cc716b  a4office-native-darwin-arm64-2026.4.5.tgz
0759e15ba45ca7edc2ca257c76442161f3e059de7f87aa34302cce622b9b9493  a4office-native-darwin-x64-2026.4.5.tgz
9313fe5eb92f056c27bbfa5f04beab70c0a59e946fc0a12481d501d490edc901  a4office-native-linux-arm64-2026.4.5.tgz
7616cf7238cd0433f0bc55fac7268f3d5f8ef9578cdc7968e486c19e4c97f847  a4office-native-linux-x64-2026.4.5.tgz
150e351332c845f1704a428e844d2428ae9502dcfa05fe61a4c05320bfec0e4d  a4office-native-win32-x64-2026.4.5.tgz

Проверка после скачивания:

shasum -a 256 -c SHA256SUMS