Behat Drupal Extension

The Drupal Extension is an integration layer between Behat, Mink Extension, and Drupal. It provides step definitions for common testing scenarios specific to Drupal sites.

The Drupal Extension 3 supports Drupal 6, 7 and 8, and utilizes Behat 3.

Use it for testing your Drupal site.

If you're new to the Drupal Extension, we recommend starting with the Full documentation

Quick start

1. Install using Composer:

   mkdir projectdir
   cd projectdir
   curl -sS https://getcomposer.org/installer | php
   COMPOSER_BIN_DIR=bin php composer.phar require drupal/drupal-extension='~3.0'

2. In the projectdir, create a file called behat.yml. Below is the minimal configuration. Many more options are covered in the Full documentation

default:
  suites:
    default:
      contexts:
        - Drupal\DrupalExtension\Context\DrupalContext
  extensions:
    Behat\MinkExtension:
      goutte: ~
      base_url: http://example.org/  # Replace with your site's URL
    Drupal\DrupalExtension:
      blackbox: ~

1. In the projectdir, run

   bin/behat --init

2. Find pre-defined steps to work with using:

   bin/behat -di

3. Define your own steps in projectdir\features\FeatureContext.php

4. Start adding your feature files to the features directory of your repository.

Additional resources

• Behat Drupal Extension documentation
• Behat documentation
• Mink documentation
• Drupal Behat group

Examples and code snippets

• Complex node creation, with field collections and entity references
• Achievements module support
• Drupal form element visibility
• Track down PHP notices
• Support for sites using basic HTTP authentication