Skip to main content
ExodeMiniApp — основной класс клиента. Один экземпляр на приложение. Все методы типизированы и возвращают Promise.

Создание экземпляра

Параметры конфигурации

string
required
Идентификатор мини-приложения. Передаётся в handshake для валидации на стороне хоста.
string
Origin хост-окна. По умолчанию *. В проде рекомендуется указывать конкретный origin Exode для безопасности.
number
Таймаут handshake и всех команд (мс). По умолчанию 10000.
Клиент должен исполняться внутри iframe. Попытка init() в top-level окне выбросит ошибку ExodeMiniApp must be used inside an iframe.

Инициализация

Метод выполняет handshake с хостом и возвращает MiniAppContext. Повторный вызов init() выбросит ошибку.
Если handshake не успел завершиться за timeout мс — Promise отклоняется. Проверьте, что iframe открыт внутри Exode и targetOrigin корректен.

Навигация (app.route)

UI-команды (app.ui)

События (app.on)

Подписка на события хоста. Возвращает функцию отписки.
Полный список событий и их payload’ов — в разделе Контекст и типы.

Получение текущего контекста

init() возвращает контекст один раз. Для последующего доступа используйте getContext() — он всегда актуален, так как bridge автоматически применяет события context:updated.

Уничтожение

Закрывает bridge, отключает слушатели postMessage, очищает обработчики событий. Вызывайте при размонтировании приложения.

Полный пример


Обновлено: 2026-07-02 23:44 UTC