Что делает Given?

Роль Given в методологии BDD

Given — это первая и фундаментальная часть структуры сценария в методологии Behavior-Driven Development (BDD), написанного на языке Gherkin. Конструкция Given отвечает за описание начального контекста системы, то есть предварительных условий, которые должны быть выполнены до начала выполнения тестируемого действия.

Проще говоря, Given отвечает на вопрос: "При каких условиях?" Он устанавливает "сцену" для теста, переводя систему или тестовое окружение в четко определенное, воспроизводимое состояние, из которого начинается основное действие.

Ключевые цели и задачи Given

• Установка контекста: Описание состояния мира до начала основного действия. Это может быть наличие пользователя, созданных данных, состояния интерфейса или конфигурации системы.
• Обеспечение воспроизводимости: Гарантия того, что каждый запуск теста начинается с идентичных условий, что критически важно для надежности тестов.
• Изоляция теста: Помогает минимизировать зависимости между тестами, так как каждый сценарий явно описывает необходимые ему начальные данные.

Принципы написания эффективных Given

1. Независимость: Каждый сценарий должен быть самодостаточным. Given должен подготовить все необходимое, не полагаясь на результаты других сценариев.
2. Конкретность и ясность: Условия должны быть описаны четко, без двусмысленностей, чтобы их мог понять как разработчик, так и бизнес-аналитик.
3. Реалистичность: Контекст должен отражать реальные бизнес-предпосылки, а не технические детали, насколько это возможно.
4. Связь с When и Then: Given логически ведет к действию (When), которое, в свою очередь, приводит к проверяемому результату (Then).

Примеры использования Given в Gherkin

Рассмотрим на примере тестирования функции входа в систему.

Сценарий: Успешный вход зарегистрированного пользователя
  Дано у меня есть зарегистрированный пользователь с email "user@example.com" и паролем "Qwerty123"
  И я нахожусь на странице входа в систему
  Когда я ввожу "user@example.com" в поле "Email"
  И я ввожу "Qwerty123" в поле "Пароль"
  И я нажимаю кнопку "Войти"
  Тогда я должен быть перенаправлен на главную страницу
  И я должен увидеть приветствие "Добро пожаловать, user@example.com!"

В этом сценарии блок Given выполняет две ключевые задачи:

1. Гарантирует существование тестового пользователя в системе (подготовка данных).
2. Устанавливает начальное состояние пользовательского интерфейса (открыта страница логина).

Техническая реализация Given (на примере Python + Behave)

На уровне шагов (step definitions) код для Given отвечает за подготовку тестового окружения. Это может включать операции с базой данных, API-вызовы, навигацию в браузере или настройку мок-объектов.

# Файр steps/login_steps.py
from behave import given, when, then
from my_app.models import User
from selenium.webdriver.common.by import By

@given('у меня есть зарегистрированный пользователь с email "{email}" и паролем "{password}"')
def step_create_user(context, email, password):
    """Шаг Given: Создает пользователя в тестовой базе данных."""
    # Очистка возможных старых данных для изоляции
    User.objects.filter(email=email).delete()
    # Создание нового пользователя
    context.test_user = User.objects.create_user(
        username=email,
        email=email,
        password=password
    )
    # Сохраняем credentials для последующих шагов
    context.user_email = email
    context.user_password = password

@given('я нахожусь на странице входа в систему')
def step_navigate_to_login(context):
    """Шаг Given: Открывает страницу логина в браузере."""
    context.browser.get(context.base_url + '/login')
    # Неявная проверка: убедимся, что мы на правильной странице
    assert "Логин" in context.browser.title

Распространенные ошибки и лучшие практики

• Плохо: Given 100 пользователей в системе (неясный, нефункциональный контекст).

• Хорошо: Given в системе есть пользователи с ролями "Администратор", "Менеджер" и "Гость" (конкретный, бизнес-ориентированный контекст).

• Плохо: Использовать Given для описания действий (Когда я создаю пользователя...). Это смешивает ответственность.

• Хорошо: Использовать Given для констатации факта (Дано в системе существует пользователь...), даже если за кулисами шаг его создает.

• Лучшая практика: Для сложной подготовки данных (например, каталога товаров) выносить шаги в бэкграунды (Background) или использовать фикстуры (fixtures), чтобы избежать дублирования кода в сценариях.

Таким образом, Given — это краеугольный камень хорошо структурированного BDD-теста. Его корректное использование напрямую влияет на понятность, поддерживаемость и надежность автоматизированных сценариев, обеспечивая общий язык для всех участников проекта — от заказчика до инженера.