chartinger/around-hook-extension

Around hook support for behat v3

@AroundScenario hook extension

Around hook support for Behat 3, _(*1)

This project aims to mimic the Cucumber around feature in Behat 3.x, _(*2)

Example

Given you want to run the same Scenario with multiple screen resolutions it could look like this:, _(*3)

...
  /**
   * @AroundScenario
   */
  public function runWithMultipleWindowSizes(AroundScenarioScope $scope)
  {
    $this->width = 1920;
    $scope->callBlock(" [1920]");
    $this->width = 800;
    $scope->callBlock(" [800]");
  }

  /**
   * @BeforeScenario
   */
  public function resizeWindow()
  {
    $this->getSession()->resizeWindow($this->width, $this->height);
  }
...

Where in the optional parameter of callBlock() you can define a suffix to the scenario title, _(*4)

Example output of Behat could be:, _(*5)

...
  Scenario: Simpler Test [1920]
    Given I am on "http://somehomepage"
    When I do something
    Then i should see "Hello World"

  Scenario: Simpler Test [800]
    Given I am on "http://somehomepage"
    When I do something
    Then i should see "Hello World"

...

Installation

In your composer.json add, _(*6)

{
    "require": {
        ...
        "chartinger/around-hook-extension": "*@dev"
    }
}

and update your dependencies, _(*7)

Usage

To activate this extension add this to your behat.yml, _(*8)

default:
  extensions:
    chartinger\Behat\AroundHookExtension\AroundHookExtension: ~

You can now use the @AroundScenario annotation in your Behat Context, _(*9)

  use chartinger\Behat\AroundHookExtension\AroundScenarioScope;

  ...

  /**
   * @AroundScenario
   */
  public function aroundScenario(AroundScenarioScope $scope)
  {
    $scope->callBlock();
  }