jhedstrom/drupalextension
Stars: 208
Forks: 188
Pull Requests: 353
Issues: 300
Watchers: 25
Last Updated: 2023-08-18 00:38:13
An integration layer between Behat, Mink Extension, and Drupal.
License: GNU General Public License v2.0
Languages: PHP, HTML, Gherkin
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 5.x supports Drupal 9 and 10, utilizes Behat 3.2+ and runs on:
- PHP 7.4, 8.0, 8.1 with Drupal 9
- PHP 8.1 with Drupal 10.
Use it for testing your Drupal site.
If you're new to the Drupal Extension, we recommend starting with the Full documentation
Quick start
-
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='~5.0'
-
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:
Drupal\MinkExtension:
browserkit_http: ~
base_url: http://example.org/ # Replace with your site's URL
Drupal\DrupalExtension:
blackbox: ~-
In the projectdir, run
bin/behat --init
-
Find pre-defined steps to work with using:
bin/behat -di
-
Define your own steps in
projectdir\features\FeatureContext.php -
Start adding your feature files to the
featuresdirectory of your repository.
Credits
- Originally developed by Jonathan Hedstrom with great help from eliza411
- Maintainers
Additional resources
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
Release notes
See CHANGELOG.
Contributing
Features and bug fixes are welcome! First-time contributors can jump in with the issues tagged good first issue.
See CONTRIBUTING.md for more information.
OPEN ISSUES
See all- Documentation for version 3.0 mentions non existing class BehatContext by @corvus-ch
- Feature request: Add menu map support by @lhridley
- Error message is a little less useful by @eliza411
- Static caches and state need to be reset after every browser request by @pfrenssen
- REQUEST_TIME is stale during test runs by @mglaman
- Given (a/an) :entity entity/entities/item/items by @jonathanjfshaw
- Accessing drupal/module functions in @beforefeature possible? by @natgateway
- Unable to list definitions by @mortona42
- Assertion for multiple messages potentially getting it wrong by @jurgenhaas
- Approach for testing multi-lingual sites using the domain as the language selection method by @nicrodgers
- Allow verbose debugging of drush commands by @generalconsensus
- Compatibility with big_pipe by @Berdir
- Support creating and placing blocks by @acbramley
- Taxonomy terms added in wrong place in multilevel vocabularies by @kiwimind
- BDE 4.x: move all code in RawDrupalContext to services by @pfrenssen
- Random access denied errors to pages by @mickaelperrin
- Robust entity handling by @jonathanjfshaw
- Rework how SubContext classes are discovered and their callbacks are returned by @pfrenssen
- Testing Views by @jonathanjfshaw
- Testing non-English Drupal sites by @killes
- Introduce a site building context by @TravisCarden
- Handling unexpected Drupal errors and warnings by @jonathanjfshaw
- "When I attach the file" and Drupal temporary files by @jonathanjfshaw
- Given :name create(s) a/an :type (content ) with the title :title by @jonathanjfshaw
- Throw an error in parseEntityFields if field does not exist by @jonathanjfshaw
- Login/LoggedIn static "/user" paths for RawDrupalContext.php by @iojonep
- writing tests for drush updb --yes by @mfb
- DrupalContext::assertAuthenticatedByRole Firefox ONLY failing with mouseMoveTo Error by @hkorik
- DrupalContext::createNode() fails to create nodes for CT's without a moderation workflow enabled by @hkorik
- LoggedIn logic is not robust by @jonathanjfshaw
- Adding a custom field handler by @jludwig
- provide step or add static cache clearing to cron by @djdevin
- Drupal 8.4 by @nicrodgers
- Link Handling for Links without Titles by @avirgil
- Improve the performance of login by @jhedstrom
- Update Composer documentation to latest by @jhedstrom
- Test with Symfony 3 and Drupal 7 by @jhedstrom
- Ambiguous match when translating step "@Given I am at :path" to Spanish by @jose-carmona
- Is it possible to pass variables in Behat feature files? Variable whose value we do not know by @sswarupa2017
- Re-enable Drush Behat Endpoint testing by @jhedstrom
- No ability to generate random in Drupal\Driver\BlackboxDriver by @yehee
- Provide more verbose output when iWaitForAjaxToFinish() fails. by @marcoscano
- Drush tests are failing by @jhedstrom
- Cannot filter features by line number by @jhedstrom
- Require Drupal core for dev, simplify .travis.yml setup by @jhedstrom
- Remove all hook implementations from RawDrupalContext by @pfrenssen
- Allow to add extra entries to the text and selectors in behat.yml by @Sweetchuck
- Always bootstrap the API driver by @jonathanjfshaw
- Make `ConfigContext::setConfig()` protected by @pfrenssen
- ConfigContext needs to use the original config when backing up, not the overridden one by @upchuk
- Evaluate which versions of Drupal and PHP to support in 4.x by @pfrenssen
- Support for dropzone JS by @miiimooo
- Problems w/ cache when reverting changed config by @claudiu-cristea
- Establish best practice for putting Context classes in modules by @pfrenssen
- Remove subcontext code by @jhedstrom
- Creating sub/nested fields by @jacks0n
- Status Code & Selenium2Driver by @L0rD59
- iWaitForAjaxToFinish() fails by @brooke-heaton
- Update travis testing by @Berdir
- File uploads are failing with Javascript error by @ptmkenny
- Error when disabling subcontexts: "Drupal::$container is not initialized yet" by @pfrenssen
- Change on minkphp library broke iWaitForAjaxToFinish method by @horaciolopesqq
- Logging in after already having been logged in doesn't work (at least with Chrome Driver) by @bkosborne
- $this->session is not initialized by @Sweetchuck
- Getting php fatal error when running behat tests with drupal api driver enabled by @samiullah
- Expanding/clicking collapsed fieldsets by @RoSk0
- Add step: `Given I check box :locator in the :region( region)` (& uncheck) by @xurizaemon
- Logging in on sites with basic http auth impossible by @petarbasic
- Remove Adobe flash file by @chrisdudley
- Wait for ajax breaks tests by @golddragon007
- Fix Drupal 7 tests or remove by @jhedstrom
- Update from 4.1.0 to 4.2.1, getting error "Unable to create new service" by @ptmkenny
- Circular reference detected for Drupal::service('url_generator') by @ivangrozni
- Drop Drupal 7 support by @jhedstrom
- PHP 8.1 compatibility error: "$this" can no longer be used in a plain function or method since PHP 7.1 by @harikagujjula
- Guzzle 7 issue by @MatrixOfDeath
- New step for press button in row by @djdevin
- Error when tried to update to 5.0.0 alpha, conflicts with drupal/core-dev by @Eduardo-Morales-Alberti
- DrupalAuthenticationManager is confused about login state across scenario's by @Kingdutch
- Escaping in createNode() changed with PHP 8.1 by @sboden
- Creating a node with a certain URL alias by @brockfanning
- Disable automatic cleanup by @kasperg
- Fix failing D10 tests by @jhedstrom
- Write an upgrade guide to 5.x? by @eiriksm
RELEASES
See all- 4.2.1 by @jhedstrom
- 4.2.0 by @jhedstrom
- 4.1.0 by @jhedstrom
- 4.0.1 by @jhedstrom
- 4.0.0 by @jhedstrom
- 4.0.0 rc1 by @jhedstrom
- 4.0.0 beta 2 by @jhedstrom
- 4.0.0 Beta 1 by @jhedstrom
- 4.0.0 Alpha 4 by @jhedstrom
- 4.0.0 Alpha 3 by @jhedstrom
- 4.0.0 Alpha 2 by @jhedstrom
- 4.0.0 Alpha 1 by @jhedstrom
- 3.4.1 by @jhedstrom
- by @jhedstrom
- 3.3.1 by @jhedstrom
- 3.3.0 by @pfrenssen
- 3.2.3 by @pfrenssen
- 3.2.2 by @jhedstrom
- 3.2.1 by @jhedstrom
- 3.2.0 by @jhedstrom
- 3.1.5 by @jhedstrom
- 3.1.4 by @jhedstrom
- 3.1.3 by @jhedstrom
- 3.1.2 by @jhedstrom
- 3.0.13 by @jhedstrom
- 3.1.1 by @jhedstrom
- 3.1.0 by @jhedstrom
- 3.0.12 by @jhedstrom
- 3.0.11 by @jhedstrom
- 3.0.10 by @jhedstrom
- 3.0.9 by @jhedstrom
- 3.0.8 by @jhedstrom
- 3.0.7 by @jhedstrom
- 3.0.6 by @jhedstrom
- 3.0.5 by @jhedstrom
- 3.0.4 by @jhedstrom
- 5.0.0 RC1 by @jhedstrom
- 5.0.0 Alpha 1 by @jhedstrom