Инициализация SDK
Начало сессии
Вызовите init(options?) после монтирования приложения на клиенте. Можно передать init({ webApp }), например при тестировании с подставным объектом.
import { init, isInitialized, launchParams } from '@mwa.js/sdk';
export function mount() {
const dispose = init();
console.log(isInitialized(), launchParams()?.platform);
return dispose;
}Вызов возвращает функцию очистки. Она удаляет зарегистрированные через SDK обработчики кнопки «Назад» и сбрасывает параметры запуска и состояние. Повторный init() закрывает предыдущую сессию. Ранее полученная функция очистки действует только на свою сессию.
SSR
Пакет можно импортировать на сервере. До клиентского init() значения launchParams() и viewport.size() равны undefined, а isInitialized() и backButton.isVisible() равны false. Из состояния формируйте исходный SSR-снимок, а инициализацию запускайте в клиентском эффекте или хуке монтирования.
Доступность и ошибки
supports(method) проверяет возможности активного Bridge. До init() проверка использует собственный Bridge. Успешная проверка метода сама по себе не открывает сессию SDK.
| Ошибка | Когда возникает |
|---|---|
MaxEnvironmentError, max_environment_unavailable | У Bridge отсутствует исходная строка запуска |
NotInitializedError, sdk_not_initialized | Вызвана операция SDK до init() или после очистки |
MethodUnavailableError, method_unavailable | Метод отсутствует либо ограничение версии или платформы исключает его вызов |
Ошибка Bridge с error.code | Вызов дошёл до Bridge и клиент завершил его ошибкой |
Перехватывайте ошибки SDK и отклонения Promise вокруг самого вызова. См. примеры SDK и совместимость Bridge.