drupal-behat-test

Drupal Behat Test

What It Is

Behat is a BDD (Behavior-Driven Development) framework that uses natural language (Gherkin) to define test scenarios. The Drupal Extension provides predefined steps for interacting with Drupal: create users, nodes, terms, navigate, fill forms, etc.

When to Use

• The project already uses Behat (has behat.yml)
• Acceptance tests that the client can read are needed
• Complete E2E flows (registration, purchase, content publishing)
• Behavior tests in natural language
• When the QA team does not know PHP but needs to write/read tests

When NOT to Use

• Tests for services or internal logic -> Kernel test
• Simple form tests -> Functional test
• If the project does not have Behat and there is no reason to add it -> Playwright
• Visual regression -> Playwright

Setup -- Dependencies

ssh web composer require --dev drupal/drupal-extension behat/mink-selenium2-driver behat/mink-browserkit-driver

For Drupal 10/11, use drupal/drupal-extension:^5.

Configuration -- behat.yml

WARNING — BEFORE copying: drupal_root: 'web' is a placeholder. Check the real docroot with grep "^docroot:" .ddev/config.yaml and set drupal_root to that value ($DDEV_DOCROOT).

default:
  suites:
    default:
      contexts:
        - Drupal\DrupalExtension\Context\DrupalContext
        - Drupal\DrupalExtension\Context\MinkContext
        - Drupal\DrupalExtension\Context\MessageContext
        - Drupal\DrupalExtension\Context\DrushContext
        - FeatureContext
  extensions:
    Drupal\MinkExtension:
      # browserkit_http is the headless driver (goutte is deprecated in Mink Extension)
      browserkit_http: ~
      selenium2:
        wd_host: 'http://127.0.0.1:4444/wd/hub'
        capabilities:
          browser: chrome
          extra_capabilities:
            # goog:chromeOptions works on Drupal 10 and 11 (mandatory on 11)
            goog:chromeOptions:
              args:
                - '--disable-gpu'
                - '--headless'
                - '--no-sandbox'
      # Always HTTP in DDEV (self-signed certs break HTTPS)
      base_url: 'http://localhost'
      ajax_timeout: 10
    Drupal\DrupalExtension:
      api_driver: 'drupal'
      drupal:
        drupal_root: 'web'
      region_map:
        content: '.region-content'
        header: '.region-header'
        sidebar_first: '.region-sidebar-first'
      selectors:
        message_selector: '.messages'
        error_message_selector: '.messages--error'
        success_message_selector: '.messages--status'
        warning_message_selector: '.messages--warning'