Тестер Mini App

Mock
Властивості
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()
Тактильний відгук 3
impactOccurred()
notificationOccurred()
selectionChanged()
Хмарне сховище 6
setItem()
getItem()
getKeys()
removeItem()
Сховище пристрою 4
setItem()
getItem()
removeItem()
clear()
Захищене сховище 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.5. Кнопку меню з адресою 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-тунель знадобиться, коли почнете тестувати свій застосунок.