Mini App Тестер

Mock
RU
Свойства
version
—
platform
—
colorScheme
—
isActive
—
isExpanded
—
isFullscreen
—
isOrientationLocked
—
isClosingConfirmation
—
isVerticalSwipes
—
viewportHeight
—
viewportStableH
—
headerColor
—
backgroundColor
—
bottomBarColor
—
initData
initDataUnsafe
Параметры темы
bg_color
text_color
hint_color
link_color
button_color
button_text_color
secondary_bg_color
header_bg_color
bottom_bar_bg_color
accent_text_color
section_bg_color
section_header_text_color
section_separator_color
subtitle_text_color
destructive_text_color
WebApp 18
ready()
expand()
close()
sendData()
switchInlineQuery()
setHeaderColor()
setBackgroundColor()
setBottomBarColor()
enableClosingConfirmation()
disableClosingConfirmation()
enableVerticalSwipes()
disableVerticalSwipes()
requestFullscreen()
exitFullscreen()
lockOrientation()
unlockOrientation()
openLink()
openTelegramLink()
isVersionAtLeast()
hideKeyboard()
Кнопки 4
MainButton
Клик по кнопке вызовет событие mainButtonClicked
SecondaryButton
BackButton
BackButton
Клик вызовет backButtonClicked
SettingsButton
SettingsButton
Клик вызовет settingsButtonClicked
Всплывающие окна 5
showAlert()
showConfirm()
showPopup()
showScanQrPopup()
readTextFromClipboard()
Haptic Feedback 3
impactOccurred()
notificationOccurred()
selectionChanged()
Cloud Storage 6
setItem()
getItem()
getKeys()
removeItem()
Device Storage 4
setItem()
getItem()
removeItem()
clear()
Secure Storage 5
setItem()
getItem()
restoreItem()
removeItem()
clear()
Сенсоры 3
Accelerometer
DeviceOrientation
Gyroscope
Биометрия 5
init()
requestAccess()
authenticate()
updateBiometricToken()
openSettings()
Локация 3
LocationManager.init()
LocationManager.getLocation()
LocationManager.openSettings()
Оплата & Истории 3
openInvoice()
shareMessage()
Разрешения & Авторизация 3
requestWriteAccess()
requestContact()
requestChat()
Эмодзи, Экран, Файл 5
Home Screen
addToHomeScreen()
checkHomeScreenStatus()
Emoji Status
File Download
Лог событий 0
Слушаем 45 событий
Нет событий. Используйте методы выше для генерации событий.

Mini App Tester — инструмент для тестирования Telegram Mini App онлайн. С ним можно вызвать методы Telegram WebApp API, посмотреть события и свойства клиента и проверить, как ведут себя кнопки, попапы и хранилища. В обычном браузере тестер работает в mock-режиме и эмулирует Telegram.WebApp, а внутри Telegram использует настоящий API клиента.

Как пользоваться

  1. Откройте тестер в браузере — в mock-режиме методы можно вызывать без телефона и без бота.
  2. Выберите группу методов: WebApp, кнопки, попапы, HapticFeedback, CloudStorage, DeviceStorage, SecureStorage, сенсоры, биометрия, геолокация, оплата и истории, разрешения, эмодзи-статус, полноэкранный режим и файлы. Нажмите «Выполнить» у нужного вызова.
  3. Следите за логом событий (более 45 типов) и живой панелью свойств: version, platform, colorScheme, initData, themeParams, safe areas.
  4. Чтобы проверить всё на реальном устройстве, укажите в @BotFather адрес https://telegram-bot-api.info/telegram-mini-app-tester.html как URL Mini App — через /newapp или кнопку меню бота — и откройте его из чата с ботом.

Что можно проверить

Типичный сценарий: в браузере отладить логику на моках, затем открыть тестер на iOS, Android и Desktop и сравнить, какие функции поддерживает каждый клиент.

Приватность

Токен бота тестеру не нужен, серверной части у него нет — страница целиком работает в браузере или в WebView Telegram. В mock-режиме данные хранилищ сохраняются в localStorage браузера. Внутри Telegram тестер выводит ваш настоящий initData; не публикуйте его на скриншотах: пока строка свежая, бэкенд Mini App, который проверяет подпись, примет её как подлинную.

Пошаговый план с туннелем для localhost, DevTools и проверкой подписи — в гайде тестирование Mini App. Пригодятся также как создать бота, как получить токен и что нового в Bot API 10.3. Кнопку меню с адресом Mini App можно настроить методом setChatMenuButton в Bot API Tester, а описание всех методов Bot API есть в справочнике и в Swagger-документации.

Частые вопросы

Как протестировать Telegram Mini App без Telegram?

Откройте Mini App Tester в обычном браузере: в mock-режиме он эмулирует Telegram.WebApp, так что методы, кнопки и попапы можно вызывать без телефона и без своего бота.

Как открыть тестер внутри Telegram?

В @BotFather укажите https://telegram-bot-api.info/telegram-mini-app-tester.html как URL Mini App — через /newapp или кнопку меню бота. Внутри Telegram тестер работает с настоящим API клиента.

Какие методы Telegram WebApp API можно проверить?

Базовые методы WebApp, кнопки, попапы, HapticFeedback, CloudStorage, DeviceStorage, SecureStorage, сенсоры, биометрию, геолокацию, оплату и истории, запросы разрешений, эмодзи-статус, полноэкранный режим и скачивание файлов.

Зачем смотреть initData в тестере?

Чтобы увидеть, какие поля реальный клиент передаёт приложению: user, auth_date, hash и другие. Это помогает отладить проверку initData на вашем сервере.

Нужен ли свой хостинг для тестирования мини апп в Телеграм?

Чтобы проверить сам WebApp API — нет: тестер уже размещён по HTTPS, его адрес можно сразу вставить в @BotFather. Свой хостинг или HTTPS-туннель понадобится, когда начнёте тестировать собственное приложение.