Как пишешь асинхронные тесты?

Как я пишу асинхронные тесты в контексте QA Automation

Асинхронные тесты — это фундаментальный инструмент для проверки систем, где операции выполняются не сразу, а с ожиданием событий, ответов от серверов или изменений состояния. Моя практика построена на сочетании принципов надежности, ясности и адаптации к конкретной технологической среде (JavaScript/TypeScript, Python, Java).

Ключевые принципы и подходы

1. Использование специализированных фреймворков и библиотек В зависимости от языка и экосистемы я применяю инструменты, которые предоставляют нативные или удобные средства для асинхронности.

• JavaScript/TypeScript (Playwright, WebDriverIO, Jest): Здесь асинхронность встроена в язык через Promise и async/await. Я всегда использую async/await для чистого и линейного написания тестов, избегая сложных цепочек .then().

// Пример асинхронного теста в Playwright/Node.js
test('Пользователь может добавить товар в корзину', async ({ page }) => {
  // Асинхронный переход и ожидание
  await page.goto('https://shop.example.com');
  await page.click('.product-card:first-child');
  
  // Ожидание конкретного состояния UI (асинхронное)
  await expect(page.locator('.cart-counter')).toHaveText('1');
  
  // Асинхронный запрос к API для проверки бэкенда
  const cartResponse = await page.request.get('/api/cart');
  expect(cartResponse.json().items.length).toBe(1);
});

• Python (asyncio с pytest-asyncio или aiohttp): Для асинхронных Python-приложений (например, на FastAPI) я использую pytest-asyncio и корректно оформляю тестовые функции.

import pytest
import aiohttp

@pytest.mark.asyncio
async def test_fetch_user_data():
    async with aiohttp.ClientSession() as session:
        # Асинхронный HTTP-запрос
        response = await session.get('https://api.example.com/users/1')
        assert response.status == 200
        data = await response.json()
        assert data['username'] == 'test_user'

• Java (CompletableFuture, Awaitility): В Java-проектах я часто комбинирую CompletableFuture для представления асинхронных результатов и библиотеку Awaitility для написания выразительных и читаемых ожиданий условий.

import static org.awaitility.Awaitility.await;

@Test
public void testOrderProcessingIsCompleted() {
    CompletableFuture<Order> futureOrder = orderService.processAsync(orderId);
    
    // Awaitility для асинхронного ожидания с условием и таймаутом
    await().atMost(10, SECONDS)
           .until(() -> futureOrder.isDone() && 
                        futureOrder.get().getStatus() == OrderStatus.COMPLETED);
}

2. Реализация стратегий ожидания (Waits) Это самый критичный аспект. Я избегаю жестких sleep() (например, Thread.sleep(5000)), потому что они неэффективны и нестабильны. Вместо этого я применяю:

• Явные ожидания (Explicit Waits): Ожидание конкретного условия (видимость элемента, наличие текста, завершение HTTP-запроса) с заданным таймаутом и частотой проверки (polling).
• Неявные ожидания (Implicit Waits): Используются реже и только там, где это оправдано фреймворком (например, в Selenium WebDriver для базовых операций), но всегда в сочетании с явными для важных проверок.

3. Обработка асинхронных исключений и таймаутов Асинхронные операции могут завершиться ошибкой или зависнуть. Я обязательно:

• Прописываю timeout для каждой критичной асинхронной проверки.
• Обрабатываю исключения (например, TimeoutException) не просто паданием теста, но и с добавлением контекстной информации для отладки: "Ожидание завершения транзакции превысило 30 секунд. Последнее состояние системы: ...".

4. Тестирование асинхронных API и callback-ов Для систем, основанных на событиях или callback-ах (например, WebSocket, message brokers), я применяю паттерны, такие как захват событий в коллектор или использование специальных тестовых клиентов.

// Пример теста WebSocket с использованием коллектора событий
test('WebSocket отправляет событие нового сообщения', async () => {
  const receivedEvents = [];
  const wsClient = new WebSocketClient();
  
  wsClient.on('new_message', (event) => receivedEvents.push(event));
  await wsClient.connect();
  
  // Симулируем действие, которое должно генерировать событие
  await api.sendMessage({ text: 'Hello' });
  
  // Асинхронно ожидаем, что коллектор получит событие
  await waitFor(() => receivedEvents.length > 0, { timeout: 5000 });
  expect(receivedEvents[0].text).toBe('Hello');
});

5. Параллелизм и управление состоянием Асинхронные тесты иногда требуют параллельного выполнения операций (например, проверка конкурентных запросов). Я тщательно изолирую такие тесты, чтобы они не влияли на общее состояние системы, и использую механизмы синхронизации (если необходимо), но стараюсь строить тесты как независимые последовательности.

Структура и лучшие практики

• Чистые хуки: beforeEach, afterEach тоже могут быть асинхронными. Я всегда корректно объявляю их как async и выполняю подготовку/очистку данных асинхронно (например, асинхронное очищение тестовой БД).
• Логирование и отчетность: В асинхронном потоке важно логировать ключевые шаги ("Начало ожидания ответа от платежного гateway", "Получен callback с статусом SUCCESS"), так как временной порядок в отчетах помогает анализировать сбои.
• Идемпотентность: Асинхронные тесты, особенно связанные с внешними системами, я делаю максимально идемпотентными — они могут быть повторены без побочных эффектов. Это часто требует асинхронной очистки перед или после теста.

В итоге, написание асинхронных тестов — это не просто технический навык, но и архитектурный подход, где важно понимать поток событий в системе, корректно выбирать точки и условия ожидания, а также использовать инструменты, которые делают код стабильным и понятным для всей команды.