Перейти к содержимому

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

Начало сессии ​

Вызовите init(options?) после монтирования приложения на клиенте. Можно передать init({ webApp }), например при тестировании с подставным объектом.

ts
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.