README.md

Writing the tests

• The files for testing (images, documents, videos etc.) should be stored in resources folder.
• To see all, available in your system, steps execute the bin/behat -dl.
• Some examples can be found here.

Work with copy of DB on the fly

If your steps makes an irreversible changes in database and you want to be sure that works with clean, initial database, then TqExtension can give such possibility for you.

Note, database will be copied before feature started and will be restored after completion. This means that changes, made by scenarios in feature, will be available until next feature started. This gives a possibility to operate changes per scenarios in one feature.

Also you able to adjust settings for every feature. By default you WILL NOT WORK WITH A COPY OF DB and, to enable this, you MUST ADD @cloneDB tag to FEATURE DEFINITION. Its important: not to scenario definition, to feature.

And even you want to work with specific connection (key in $databases array from settings.php) - it's possible. Just add it name after the @cloneDB tag, separated by : (e.g. @cloneDB:default).

All this sounds great, but there are drawbacks. You will lost execution time before and after every feature. The value of this time depends on your hardware and size of database. So try to not use large databases for testing.

Table of contents

• TqContext
• DrushContext
• EmailContext
• FormContext
• RedirectContext
• UserContext
• WysiwygContext

TqContext

Given I switch to opened window

Given I switch back to main window

Given I switch to CKFinder window

Given I switch to an iframe "mediaBrowser"

When I switch back from an iframe

Given I should use the "1280x800" screen resolution

## In role of element selector can be:
## - CSS selector;
## - Inaccurate text;
## - Region name from "behat.yml";
When I (press|click|double click|right click) on ".link"

## This method must be used instead of 'I wait for AJAX to finish'!
Then I wait until AJAX is finished

## Region can be found by CSS selector or name from "region_map" parameter of "behat.yml".
Then I work with elements in "header" region

## That step helps to exit from element visibility scope that was defined by
## executing of previous step.
Then I checkout to whole page

Then I wait 60 seconds

## In selector role can be: inaccurate text or label, CSS or region name.
And scroll to "Meta tags" element

Then check that "TypeError: cell[0] is undefined" JS error( not) appears in "misc/tabledrag.js" file

Then I should see the "#table_cell" element with "colspan" attribute having "3" value

DrushContext

Given I login with one time link( (1))
Then drush uli( admin)

EmailContext

## At least one field should be specified.
Then I check that email for "[email protected]" contains:
  | subject | New email letter   |
  | body    | The body of letter |

Then I click on link "Test" in email( that was sent on "[email protected]")

Then I check that email for "[email protected]" was sent

## To use this step you should correctly configure your Behat.
Then I login with credentials that was sent on "[email protected]"

FormContext

Given I typed "Joe" in the "name" field and choose 2 option from autocomplete variants

## - The selector of form field can be inaccurate label, ID or name of the HTML element.
## - The selector of user entity field can be machine name or label of the field.
Then I fill in "field_company[und][0]" with value of field "user_company" of current user

Given I (un)check the boxes:
  | Consumer Products  |
  | ICT                |
  | Financial Services |

## - The button can be found by ID, name, label or CSS selector.
## - The label of radio button can be specified inaccurately.
## - If element has more than one label and one of them is hidden, then
##   will used only visible, if exist.
## - If trying to get the field by label, then it must have the "for" attribute
##   and element with ID, specified in that attribute, must exist.
## - The @javascript tag is necessary when "customized" is used!
Given I check the( customized) "Show" radio button

## This method must be used instead of 'I fill in "field" with "value"'!
## Drupal tokens available.
Then I fill "last_name" with "Bondarenko"

## This method must be used instead of 'I fill in the following:'!
Then I fill the following:
  | first_name | Sergii    |
  | last_name | Bondarenko |

And attach file "600x400.jpg" to "Logotype"

## - This method works with "Clientside Simple Hierarchical Select",
##   "Simple Hierarchical Select" and "Hierarchical Select" modules.
## - The label of field or wrapper ID can be used as selector.
Then I select the following in "Categories" hierarchical select:
  | EN                  |
  | Financial Services  |

Then should see the thumbnail

And pick "Kiyv" from "City"

And pick the following:
  | Entity Reference                     | Type of new field    |
  | Inline entity form - Multiple values | Widget for new field |

Then I choose "October 13, 2017" in "Date" datepicker

Then I check that "Date" datepicker contains "October 13, 2017" date

Then I check that "October 13, 2017" is available for "Date" datepicker$

And check that "Users" field has( not) "admin" value

And check that "User" is( not) selected in "Apply to" select

And check that "Order discount" is( not) checked

RedirectContext

## Waits for only one redirect and goes to the next step.
Then I should be redirected

## Waits as long as URL of the page will not be the same as specified.
## - The URL can be relative or absolute.
## - By default, the waiting timeout is set to 30 seconds, but you can change
##   this in "behat.yml".
Then I should be redirected on "https://example.com"

And user should( not) have an access to the following pages:
  | admin/people/create |
  | node/add/article    |
  | user/1/edit         |

## This step should be used instead of "I am at" if page should be checked for accessibility
## before visiting.
And I am on the "admin/config" page( and HTTP code is "200")
## Also, an alias can be used:
And (I )visit the "admin/config" page( and HTTP code is "200")

UserContext

## - This method must be used instead of 'I am logged in as a user with the "administrator" role'!
## - Multiple roles can be listed by comma: 'And logged in as a user with "administrator, editor" roles'.
Given I am logged in as a user with "administrator" role

## - Taxonomy Term Reference supported. You must specify name of term and
##   correct value will be saved.
## - The machine name or label of a field can be used as selector.
Given I am logged in as a user with "administrator" role and filled fields:
  | Full name | Sergii Bondarenko   |
  | Position  | Web Developer       |
  | Company   | FFW                 |

## Fill login form with existing credentials.
Then I am logged in with credentials:
  | username | BR0kEN |
  | password | p4sswd |

## This step must be used instead of "I am an anonymous user" because it has more
## strict checking for authenticated user.
Given I am unauthorized user

WysiwygContext

## If this step was used, then you no need to specify selector for next steps
## from this context while working with only one editor.
Given I work with "Presentation" WYSIWYG editor

Then I fill "<strong>Text</strong>" in "Presentation" WYSIWYG editor

Then I type "additional text" in "Presentation" WYSIWYG editor

Then I should see "Text" in "Presentation" WYSIWYG editor

Then I should not see "vulnerability" in "Presentation" WYSIWYG editor

Then I fill in following WYSIWYG editors
  | Editor locator | Value |

MessageContext

And (I )should see no errors( on the page)

# The <TYPE> could be ommited or one of the following:
# - error
# - warning
# - success
And (I )should( not) see the (<TYPE> )message "An error occured."

# Similar to previous, but with placeholders replacing.
And (I )should( not) see the (<TYPE> )message "!name field is required."
  | !name | E-mail address  |

# Similar to previous, but placeholder should be formatted in another way.
And (I )should( not) see the following (<TYPE> )messages:
  | !name field is required.  | !name => E-mail address |