+++ /dev/null
-Blackbox Driver
-===============
-
-The blackbox driver assumes no privileged access to the site. You can run the
-tests on a local or remote server, and all the actions will take place through
-the site's user interface. This driver was enabled as part of the installation
-instructions by lines 13 and 14, highlighted below.
-
-.. literalinclude:: _static/snippets/behat-bb.yml
- :language: yaml
- :linenos:
- :lines: 1-14
- :emphasize-lines: 13-14
-
-Region steps
-------------
-
-It may be really important that a block is in the correct region, or you may
-have a link or button that doesn't have a unique label. The blackbox driver
-allows you to create a map between a CSS selector and a user-readable region
-name so you can use steps like the following without having to write any custom
-PHP::
-
-
- I press "Search" in the "header" region
- I fill in "a value" for "a field" in the "content" region
- I fill in "a field" with "Stuff" in the "header" region
- I click "About us" in the "footer" region
-
-Example:
-++++++++
-
-A stock Drupal 7 installation has a footer area identified by the CSS Id
-"footer". By editing the behat.yml file and adding lines 15 and 16 below:
-
-.. literalinclude:: _static/snippets/behat-bb.yml
- :language: yaml
- :linenos:
- :emphasize-lines: 15-16
-
-You can use a step like the following without writing any custom PHP::
-
- When I click "About us" in the "footer" region.
-
-
-Using the blackbox driver configured with the regions of your site, you can
-access the following region-related steps:
-
-.. Note::
- These examples won't work unless you define the appropriate regions in
- your behat.yml file.
-
-.. literalinclude:: _static/snippets/blackbox.feature
- :language: gherkin
- :linenos:
- :lines: 1-61
-
-Message selectors
------------------
-
-The Drupal Extension makes use of three selectors for message. If your CSS
-values are different than the defaults (shown below), you'll need to update
-your behat.yml file:
-
-.. code-block:: yaml
- :linenos:
- :emphasize-lines: 2-5
-
- Drupal\DrupalExtension:
- selectors:
- message_selector: '.messages'
- error_message_selector: '.messages.messages-error'
- success_message_selector: '.messages.messages-status'
-
-Message-related steps include:
-
-.. literalinclude:: _static/snippets/blackbox.feature
- :language: gherkin
- :linenos:
- :lines: 63-81
-
-Override text strings
----------------------
-
-The Drupal Extension relies on default text for certain steps. If you have
-customized the label visible to users, you can change that text as follows:
-
-.. code-block:: yaml
-
- Drupal\DrupalExtension:
- text:
- log_out: "Sign out"
- log_in: "Sign in"
- password_field: "Enter your password"
- username_field: "Nickname"