TestSprite: Быстрый старт — полный перевод документации на русский язык
Адаптированный перевод официальной документации TestSprite Quickstart для русскоязычных разработчиков.
Что такое TestSprite?
TestSprite — облачная платформа для автоматизированного тестирования веб-приложений с использованием ИИ. Вместо ручного написания тестов вы описываете поведение приложения на естественном языке, а TestSprite генерирует и выполняет тесты автоматически.
Ключевые возможности:
- Авто-генерация тестов по описанию на естественном языке
- Поддержка Playwright и Cypress в качестве движка
- Визуальные отчёты со скриншотами каждого шага
- CI/CD интеграция через GitHub Actions
- Параллельное выполнение тестов в облаке
Установка и первый запуск
Шаг 1: Создайте аккаунт
Перейдите на testsprite.com и зарегистрируйтесь. После подтверждения email вы попадёте в дашборд.
Шаг 2: Создайте новый проект
В дашборде нажмите New Project. Укажите:
- Project name — название вашего проекта
-
Base URL — URL вашего приложения (например,
https://staging.myapp.com) - Framework — Playwright (рекомендуется) или Cypress
Шаг 3: Установите CLI
npm install -g @testsprite/cli
Или через yarn:
yarn global add @testsprite/cli
Проверьте установку:
testsprite --version
# 2.4.1
Шаг 4: Авторизуйтесь
testsprite login
Откроется браузер для OAuth-авторизации. После подтверждения в терминале появится:
Logged in as your@email.com
Active project: My Project (proj_abc123)
Шаг 5: Напишите первый тест
Создайте файл tests/login.test.ts:
import { test } from '@testsprite/sdk';
test('пользователь может войти в систему', {
description: "'Открываем страницу входа, вводим корректные данные, проверяем редирект на дашборд',"
steps: [
'Перейти на /login',
'Ввести email test@example.com в поле Email',
'Ввести пароль password123 в поле Password',
'Нажать кнопку Войти',
'Убедиться, что URL содержит /dashboard',
'Проверить, что заголовок страницы содержит Добро пожаловать'
]
});
Шаг 6: Запустите тест
testsprite run tests/login.test.ts
Вывод в терминале:
Запуск тестов на облачном браузере...
пользователь может войти в систему (4.2s)
6 скриншотов сохранено
Отчёт: https://app.testsprite.com/reports/run_xyz789
Итог: 1 пройдено, 0 провалено, 0 пропущено
Конфигурационный файл
Создайте testsprite.config.ts в корне проекта:
import { defineConfig } from '@testsprite/sdk';
export default defineConfig({
baseUrl: 'https://staging.myapp.com',
project: 'proj_abc123',
browser: 'chromium', // chromium | firefox | webkit
viewport: { width: 1280, height: 720 },
timeout: 30000, // мс на каждый шаг
retries: 2, // повторить при падении
screenshots: 'on-failure', // all | on-failure | none
locale: 'ru-RU', // важно для локализованных приложений
timezone: 'Europe/Moscow',
});
Параметр locale
Особенно важен для тестирования русскоязычных интерфейсов. При locale: 'ru-RU' TestSprite:
- Устанавливает язык браузера в
ru - Форматирует даты как
02.05.2026(не05/02/2026) - Корректно обрабатывает кириллические символы в assertions
Интеграция с CI/CD
Для GitHub Actions создайте .github/workflows/testsprite.yml. Ключевые шаги конфигурации:
- Установите CLI:
npm install -g @testsprite/cli - Передайте API ключ через environment variable
TESTSPRITE_API_KEY - Запустите тесты:
testsprite run tests/ --reporter=github-actions
Добавьте TESTSPRITE_API_KEY в Settings → Secrets → Actions вашего репозитория.
Локальные наблюдения (ru-RU локаль)
При тестировании приложений с locale: 'ru-RU' обнаружены следующие особенности TestSprite:
Формат дат: Платформа корректно применяет российский формат ДД.ММ.ГГГГ в браузерном контексте. Тесты, проверяющие отображение дат, должны использовать этот формат в assertions.
Язык интерфейса TestSprite: Сам дашборд TestSprite доступен только на английском языке. Русификация интерфейса платформы не предусмотрена — только язык тестируемого приложения.
Часовой пояс: При указании timezone: 'Europe/Moscow' тесты корректно симулируют поведение пользователей из московского часового пояса (UTC+3). Важно для приложений с расписаниями и временными метками.
Кириллица в assertions: Полная поддержка. Вы можете писать шаги и ожидаемые значения на русском языке — движок на базе GPT-4o корректно их интерпретирует.
Часто задаваемые вопросы
В: Поддерживается ли тестирование мобильных приложений?
О: Пока нет. TestSprite специализируется на веб-приложениях. Мобильное тестирование заявлено в roadmap на Q3 2026.
В: Как работает параллельное выполнение?
О: По умолчанию тесты выполняются последовательно. Добавьте parallel: true в конфиг или флаг --parallel при запуске. Бесплатный план ограничен 2 параллельными воркерами, Pro — до 10.
В: Можно ли запустить тесты локально без облака?
О: Да. Флаг --local запустит тесты на вашем локальном браузере через Playwright. Отчёты всё равно синхронизируются в облако.
В: Как TestSprite понимает русские шаги?
О: Движок использует GPT-4o для парсинга шагов. Русский язык поддерживается наравне с английским.
Что дальше?
Платформа особенно удобна для команд, которые хотят покрыть критические пользовательские сценарии без найма QA-инженеров. Для небольших SaaS-продуктов это быстрый способ получить базовое тестовое покрытие за один день.