DEV Community

Kas
Kas

Posted on

TestSprite: Быстрый старт — полный перевод документации на русский язык

#testing #russian #webdev #tutorial

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
Enter fullscreen mode Exit fullscreen mode

Или через yarn:

yarn global add @testsprite/cli
Enter fullscreen mode Exit fullscreen mode

Проверьте установку:

testsprite --version
# 2.4.1
Enter fullscreen mode Exit fullscreen mode

Шаг 4: Авторизуйтесь 

testsprite login
Enter fullscreen mode Exit fullscreen mode

Откроется браузер для OAuth-авторизации. После подтверждения в терминале появится:

Logged in as your@email.com
Active project: My Project (proj_abc123)
Enter fullscreen mode Exit fullscreen mode

Шаг 5: Напишите первый тест

Создайте файл tests/login.test.ts:

import { test } from '@testsprite/sdk';

test('пользователь может войти в систему', {
  description: "'Открываем страницу входа, вводим корректные данные, проверяем редирект на дашборд',"
  steps: [
    'Перейти на /login',
    'Ввести email test@example.com в поле Email',
    'Ввести пароль password123 в поле Password',
    'Нажать кнопку Войти',
    'Убедиться, что URL содержит /dashboard',
    'Проверить, что заголовок страницы содержит Добро пожаловать'
  ]
});
Enter fullscreen mode Exit fullscreen mode

Шаг 6: Запустите тест 

testsprite run tests/login.test.ts
Enter fullscreen mode Exit fullscreen mode

Вывод в терминале:

Запуск тестов на облачном браузере...
  пользователь может войти в систему (4.2s)
    6 скриншотов сохранено
    Отчёт: https://app.testsprite.com/reports/run_xyz789

Итог: 1 пройдено, 0 провалено, 0 пропущено
Enter fullscreen mode Exit fullscreen mode

Конфигурационный файл

Создайте 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',
});
Enter fullscreen mode Exit fullscreen mode

Параметр 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-продуктов это быстрый способ получить базовое тестовое покрытие за один день.

Top comments (0)