JavaScript SDK: Mail: входящие письма
ctx.mail() доступен в сценарии обработки входящего письма. Содержимое письма и вложений читайте только для разрешённого запуска, не записывайте его в журнал.
Примеры — отдельные фрагменты тела async function run(ctx). Используйте await только для методов с Promise в сигнатуре.
Методы
available
ctx.mail().available() → Promise<boolean>
Есть ли в текущем прогоне проверенное письмо. В ручном и пробном запуске возвращается false.
const result = await ctx.mail().available();
current
ctx.mail().current() → Promise<object>
Тема, отправитель, текст, вложения и срок хранения текущего письма. Служебные заголовки и чужие адресаты не выдаются. Объём текста ограничен 1 MiB, признак text_truncated сообщает о сокращении.
const result = await ctx.mail().current();
text
ctx.mail().text() → Promise<string>
Получить текст письма без HTML.
const result = await ctx.mail().text();
attachments
ctx.mail().attachments() → Promise<Array<object>>
Список проверенных вложений: id, name, mime, size. Ссылки на загрузку требуют прав текущего пространства.
const result = await ctx.mail().attachments();
document
ctx.mail().document(id) → Promise<Document>
Извлечь текст, листы Excel, таблицы Word или страницы PDF из собственного вложения. Ссылки не открываются автоматически. Не более восьми разборов документов на прогон.
const result = await ctx.mail().document('attachment-id');
attachment
ctx.mail().attachment(id) → Promise<string>
Читает текстовое содержимое вложения частями и возвращает строку. Для Excel, PDF или Word используйте document(id), чтобы сохранить структуру.
const result = await ctx.mail().attachment('attachment-id');