Если Mini App всё-таки открывается, но долго держит экран загрузки, измерьте время до первого полезного действия по этапам. Начните с одного собственного тестового сценария и сохраните сетевую трассу без токенов и данных пользователя. Уменьшать все картинки подряд рано: задержку может создавать последовательное ожидание API.
Сравнивайте первый запуск и повторное открытие отдельно. Зафиксируйте модель устройства, версию Telegram, сеть и версию сборки. Быстрый повтор на Wi-Fi не доказывает, что новый пользователь в мобильной сети увидит тот же результат. При каждом замере выполняйте одинаковое действие, например открывайте каталог и выбирайте тестовую категорию.
Секундомер для разных границ
| Граница | Что отмечать | Какое решение принять |
|---|---|---|
| Документ получен | Ожидание HTML и редиректы | Исследовать сервер или маршрут |
| Код начал работу | Загрузка и выполнение стартового кода | Уменьшить стартовый набор |
| Интерфейс показан | Появление основных элементов | Отделить обязательные данные |
| Действие доступно | Обработчик готов, ответ понятен | Не выдавать декоративный экран за готовность |
Не складывайте длительности параллельных запросов как последовательные. Смотрите, какой запрос действительно задерживает следующий этап. Если получение профиля, каталога и рекомендаций связано цепочкой, обоснуйте каждую зависимость. Рекомендации часто можно получить позже; разрешения пользователя нельзя обходить ради ускорения.
Что сообщает ready, а что остаётся вашей задачей
Telegram.WebApp.ready() сообщает Telegram, что Mini App готова к отображению. Официальная документация советует вызывать его после загрузки основных элементов; без вызова placeholder скрывается после полной загрузки страницы. Этот метод не ускоряет API и не подтверждает готовность бизнес-операции. Документация проверена 11 октября 2026 года.
// Пример границ в коде приложения
// Метки связывайте с реальными событиями своего UI.
performance.mark('shell-visible');
Telegram.WebApp.ready();
// После подключения обработчиков и нужных данных:
performance.mark('first-action-available');Фрагмент предполагает, что SDK Telegram уже доступен и приложение действительно отрисовало основной интерфейс. Нельзя вставить вызов в начало файла и объявить поломанный экран готовым. Покажите состояние ожидания внутри страницы, заблокируйте ещё недоступные действия и предусмотрите повтор запроса. Для запуска вне Telegram требуется отдельная ветка приложения.
Условная трасса: лишняя зависимость
Представим тестовый сценарий без чисел: после HTML загружается стартовый JavaScript, затем профиль, затем каталог, затем рекомендации, и только после этого появляется кнопка выбора. Это учебный пример, не измерение чужого проекта. Если рекомендации не определяют доступность товаров, перенесите их после показа каталога и снова снимите трассу.
web.dev предлагает разбирать LCP по ожиданию документа, задержке начала ресурса, его загрузке и задержке отрисовки. LCP характеризует появление крупного содержимого; для Mini App дополнительно нужна своя отметка доступности действия. Приложение может быстро показать баннер и ещё долго не реагировать на выбор товара.
Публичные статические ресурсы и персональный ответ имеют разные правила кеширования. Не делайте общий кеш профиля ради красивого графика. Если меняете стартовый bundle или порядок запросов, сохраните прежнюю сборку и возможность вернуть маршрут. Проверяйте совместимость старого клиента с API во время постепенного обновления.
Повторное измерение с отказом зависимости
- Открыть Mini App заново в тех же условиях и записать все четыре границы.
- Повторить сценарий на другом согласованном классе устройств.
- На стенде задержать необязательный API: основное действие остаётся доступным.
- Отказать обязательному API: интерфейс показывает ошибку и безопасный повтор.
- Проверить, что повтор клика не создаёт две операции.
Для разбора скорости принесите обезличенную трассу, список зависимостей стартового экрана и точное определение первого полезного действия. Тогда решение можно связать с потерянным этапом и подтвердить новым измерением. Если ускорился только экран ожидания, а пользователь всё ещё не может выбрать товар, работу нельзя считать законченной.