TypeScript SDK: Documents: открытие файлов
ctx.documents() читает разрешённые файлы. Получение файла асинхронно; методы уже полученного Document работают локально.
Примеры — отдельные фрагменты тела async function run(ctx: Akmelo.Context): Promise<void>. Используйте await только для методов с Promise в сигнатуре.
Методы
fromUrl
ctx.documents().fromUrl(url, name) → Promise<Document>
Скачать файл до 10 MiB через сетевые настройки текущего источника. Действуют ограничения адресов, перенаправлений, robots.txt, частоты запросов и прокси. Имя определяется из URL; для адреса без расширения передайте его вторым аргументом.
const result = await ctx.documents().fromUrl(ctx.param('file_url', 'https://example.com/report.csv'), 'report.csv');
fromBytes
ctx.documents().fromBytes(content, name) → Promise<Document>
Разобрать уже полученные байты до 8 MiB. Имя помогает определить текстовые и старые Office-форматы; содержимое также проверяется по сигнатуре.
const result = await ctx.documents().fromBytes('sku,price\nA-1,1250', 'report.csv');
coordinates
ctx.documents().coordinates() → SheetCoordinates
Утилиты адресации Excel, без загрузки документа и сетевого вызова.
const result = ctx.documents().coordinates();