Smoke Testing

Smoke testing — автоматическая проверка развёрнутого приложения в headless-браузере перед активацией. Помогает выявить критические ошибки до того, как пользователи увидят приложение.

Как работает

1. Сборка завершена

   После успешной сборки создаётся deployment в статусе READY_TO_DEPLOY

2. Deployment активирован

   Файлы деплоя развёрнуты и доступны по URL

3. Smoke test запускается

   Headless браузер (Playwright) открывает страницу и проверяет на ошибки

4. Результат

   • Passed — deployment становится LIVE
   • Failed — deployment получает статус FAILED с описанием ошибок

Что проверяется

Проверка	Описание
HTTP статус	Страница должна вернуть код 2xx или 3xx
Консольные ошибки	console.error в JavaScript коде
Сетевые ошибки	Неудачные запросы ресурсов (скрипты, стили, изображения)
White Screen	Пустое тело страницы (белый экран смерти)
Crash страницы	Критический сбой страницы в браузере

Настройка

Включение/отключение

Smoke testing отключён по умолчанию. Вы можете включить его для проекта:

1. Откройте настройки проекта

   Перейдите в проект → Settings → Build & Deployment

2. Найдите секцию Smoke Test

3. Выключите переключатель

Осторожно

При отключении smoke testing деплои активируются сразу после развёртывания файлов. Ошибки не будут обнаружены автоматически.

Режимы проверки

Smoke test поддерживает три режима строгости:

Режим	Описание	Когда использовать
Строгий	Любая ошибка приводит к неудаче	Production-критичные приложения
Обычный	Игнорируются CORS ошибки аналитики и сторонних SDK	Большинство проектов (по умолчанию)
Мягкий	Только HTTP 4xx/5xx и белый экран = неудача	Telegram Mini Apps, проекты со сторонними SDK

Строгий режим (STRICT)

Максимально строгая проверка. Любая ошибка в консоли или сети приводит к неудаче теста.

Рекомендуется для:

• Production-критичных приложений
• Проектов с высокими требованиями к качеству
• Приложений без сторонних зависимостей

Обычный режим (NORMAL)

Игнорирует известные безопасные ошибки:

• CORS ошибки от аналитики (Яндекс Метрика, Google Analytics)
• Ошибки Telegram Mini Apps SDK при запуске вне Telegram
• Ошибки сторонних tracking-систем

Рекомендуется для:

• Большинства веб-приложений
• Проектов с аналитикой
• SPA с социальными виджетами

Мягкий режим (LENIENT)

Тест проваливается только при критических ошибках:

• HTTP статусы 4xx и 5xx
• Белый экран (пустое тело страницы)
• Crash страницы

Все остальные ошибки в консоли игнорируются.

Рекомендуется для:

• Telegram Mini Apps
• Приложений со сторонними SDK
• Проектов с известными некритичными ошибками

Выбор режима

1. Откройте настройки проекта

   Перейдите в проект → Settings → Build & Deployment

2. Найдите секцию Smoke Test

3. Убедитесь что smoke test включён

4. Выберите режим в выпадающем списке

Preview Protection

При включённой Preview Protection smoke testing автоматически использует внутренний bypass токен для доступа к защищённым деплоям.

Заметка

Вам не нужно настраивать bypass secrets для smoke testing — это происходит автоматически.

Скриншоты

После каждого smoke test создаётся скриншот страницы. Вы можете просмотреть его на странице deployment.

Скриншот помогает:

• Визуально проверить корректность отображения
• Диагностировать проблемы при неудачном тесте
• Документировать состояние деплоя

Retry логика

При неудаче smoke test автоматически повторяется:

• Инфраструктурные ошибки (проблемы с браузером) — до 5 повторов немедленно
• Ошибки теста (проблемы со страницей) — до 3 повторов

Если все попытки исчерпаны, deployment получает статус FAILED.

Troubleshooting

Smoke test падает из-за CORS ошибок аналитики

Решение: Переключите режим на Обычный или Мягкий.

CORS ошибки от аналитики (Яндекс Метрика, Google Analytics) — нормальное явление и не влияют на работоспособность приложения.

Telegram Mini App не проходит smoke test

Решение: Используйте Мягкий режим.

Telegram SDK выдаёт ошибки при запуске вне среды Telegram — это ожидаемое поведение.

White screen of death

Если smoke test находит пустую страницу:

1. Проверьте логи сборки на ошибки
2. Убедитесь что entry point корректный
3. Проверьте что все зависимости установлены
4. Попробуйте локально собрать и запустить проект

HTTP 404 или 500

1. Проверьте настройки output directory
2. Убедитесь что фреймворк правильно определён
3. Проверьте логи сборки

Тест проходит, но сайт не работает

Smoke test проверяет только начальную загрузку страницы. Для комплексного тестирования используйте:

• E2E тесты (Playwright, Cypress)
• Интеграционные тесты
• Мониторинг (Uptime checks)

Отключение smoke testing

В некоторых случаях может потребоваться полностью отключить smoke testing:

• Статические сайты без JavaScript
• Быстрые итерации в разработке
• Проекты с нестандартной архитектурой

Осторожно

При отключении smoke testing вы теряете автоматическую проверку на критические ошибки. Убедитесь что у вас есть альтернативные способы тестирования.

См. также

• Деплои — обзор деплоев
• Preview Protection — защита preview деплоев
• Логи — просмотр логов сборки и деплоя