Chapters

23 Chapters | 1:59:49 |

01

From Install to JS Testing

7:27
02

BDD Features

5:56
03

Scenarios

4:24
04

Behat

6:08
05

Behat Hooks Background

6:49
06

Mink

3:30
07

Finding Elements by CSS and Name

6:48
08

Behat Loves Mink (Free Definitions from MinkExtension)

2:56
09

Scenario Outline

2:10
10

Mink Session inside FeatureContext

6:00
11

Context Organization and Behat Suites

4:03
12

Building a Login Scenario

3:57
13

Controlling the Database

4:24
14

The SymfonyExtension & Clearing Data Between Scenarios

5:13
15

Practice: Find Elements, Login with 1 Step and Debug

6:51
16

When *I* do Something: Handling the Current User

4:10
17

Practicing BDD: Plan, then Build

8:09
18

Master JavaScript with Waits & Debugging

6:16
19

Debugging and Taking Screenshots with JavaScript

3:33
20

Gherkin Tables: Given I have the following:

4:37
21

Finding inside HTML Tables

2:20
22

Clicking a Row in a Table (i.e. Complex Selectors)

8:55
23

Tagging Scenarios in order to Load Fixtures

5:16

> Testing > BDD, Behat, Mink and other Wonderful Things

Buy Access to Course

08.

Behat Loves Mink (Free Definitions from MinkExtension)

Autoplay

Keep on Learning!

If you liked what you've learned so far, dive in! Subscribe to get
access to this tutorial plus video, code and script downloads.

Start your All-Access Pass

Buy just this tutorial for $12.00

Previous Chapter

Next Chapter

Behat parses scenarios and Mink is really good at browsing the web. If we combine their powers, we could start having steps that look a lot like what we have in search.feature.

            Copy Code

                            Show All Lines

                        11 lines
            |
            features/search.feature
        
                Show Lines

                                                    // ... lines 1 - 5
                            
              Scenario: Search for a word that exists
        
                Given I am on "/"
        
                When I fill in "searchTerm" with "Samsung"
        
                And I press "search_submit"
        
                Then I should see "Samsung Galaxy S II"

For the Background step, we now know we could create a matching definition in FeatureContext and easily use Mink's session object to actually go to that URL. But earlier when we ran this scenario, it worked... so there must already be something tie'ing Behat and Mink together.

Let's see what's happening.

Free Behat Steps

First, in FeatureContext I had you extend MinkContext. Remove that now:

            Copy Code

                            Show All Lines

                        86 lines
            |
            features/bootstrap/FeatureContext.php
        
                Show Lines

                                                    // ... lines 1 - 12
                            
            class FeatureContext implements Context, SnippetAcceptingContext
        
                Show Lines

                                                    // ... lines 14 - 86

When we run Behat, it needs to know all of the step definition language that's available. You can see that list by passing a -dl to the Behat command:

vendor/bin/behat -dl

This shows the four ls definitions we built. So, Behat opens the FeatureContext class, parses out all of the @Given, @When and @Then annotations, and prints a final list here for our enjoyment.

When we add more step definitions, this list grows. And if we use something that isn't here yet, Behat very politely prints out the function for us in the terminal.

In behat.yml we added this MinkExtension configuration:

            Copy Code

                            Show All Lines

                        12 lines
            |
            behat.yml
        
            default:
        
                Show Lines

                                                    // ... lines 2 - 6
                            
                extensions:
        
                    Behat\MinkExtension:
        
                Show Lines

                                                    // ... lines 9 - 12

This library ties Behat and Mink together and gives us two cool things. First, it lets us access the Mink Session object inside of FeatureContext. We'll see that soon.

For the second thing, add a new config called suites: and a key under that called default: with a contexts: key. We'll talk about suites later. Under contexts, pass FeatureContext and Behat\MinkExtension\Context\MinkContext:

            Copy Code

                            Show All Lines

                        12 lines
            |
            behat.yml
        
            default:
        
                suites:
        
                    default:
        
                        contexts:
        
                            - FeatureContext
        
                            - Behat\MinkExtension\Context\MinkContext
        
                Show Lines

                                                    // ... lines 7 - 12

Now, Behat will look inside FeatureContext and MinkContext for those definition annotations.

Let's see what that gives us: run behat with the -dl option again:

vendor/bin/behat -dl

Boom! Now we see a huge list! These include definitions for all common web actions, like When I go to or When I fill in "field" with "value". This includes the stuff we're using inside of search.feature:

            Copy Code

                            Show All Lines

                        11 lines
            |
            features/search.feature
        
                Show Lines

                                                    // ... lines 1 - 5
                            
              Scenario: Search for a word that exists
        
                Given I am on "/"
        
                When I fill in "searchTerm" with "Samsung"
        
                And I press "search_submit"
        
                Then I should see "Samsung Galaxy S II"

So that's why that scenario already worked.

Let's take a look at where these come from. I'll use shift+shift and search for MinkContext:

            Copy Code

                            Show All Lines

                        487 lines
            |
            vendor/behat/mink-extension/src/Behat/MinkExtension/Context/MinkContext.php
        
                Show Lines

                                                    // ... lines 1 - 21
                            
            class MinkContext extends RawMinkContext implements TranslatableContext
        
            {
        
                /**
        
                Show Lines

                                                    // ... lines 25 - 26
                            
                 * @Given /^(?:|I )am on (?:|the )homepage$/
        
                 * @When /^(?:|I )go to (?:|the )homepage$/
        
                 */
        
                public function iAmOnHomepage()
        
                {
        
                    $this->visitPath('/');
        
                }
        
                Show Lines

                                                    // ... lines 34 - 75
                            
                /**
        
                Show Lines

                                                    // ... lines 77 - 78
                            
                 * @When /^(?:|I )press "(?P<button>(?:[^"]|\\")*)"$/
        
                 */
        
                public function pressButton($button)
        
                {
        
                    $button = $this->fixStepArgument($button);
        
                    $this->getSession()->getPage()->pressButton($button);
        
                }
        
                Show Lines

                                                    // ... lines 86 - 485
                            
            }

This looks just like our FeatureContext, but has a bunch of goodies already filled in.

So, why did I use this exact language inside of my scenario originally? Because, I'm lazy, and I knew if I followed the language here, I'd get all this functionality for free. And I'm from the midwest in the US: we love free things.

I'll take off the @javascript line:

11 lines | features/search.feature

Show Lines	// ... lines 1 - 4

	Scenario: Search for a word that exists
Show Lines	// ... lines 7 - 11

Since we don't need JavaScript, and now we should be able to run our search feature. Perfect!

6 Comments

Sort By

AJ 6 years ago

Hi. I removed extends MinkContext and added Behat\MinkExtension\Context\MinkContext but when I ran my script again I get a undefined method FeatureContext::getSession() could you help explain why?

| Reply |

AJ AJ 6 years ago

ah! never mind ... i needed RawMinkContext! that way i can use $this->getMink()->getSession();

| Reply |

weaverryan SFCASTS AJ 6 years ago

Nice work! RawMinkContext is the real important guy - it extends MinkContext, which just gives you the free definitions.

Cheers!

| Reply |

Dejan 6 years ago

Hello, there's a mistake that you are showing the FeatureContext.php file in the script instead of behat.yml when configuring the default suite :)

| Reply |

weaverryan SFCASTS Dejan 6 years ago

Ah, you're right! Thanks for pointing that out. I created an issue and we should fix it soon :). https://github.com/knpunive...

Thanks!

| Reply |

Victor SFCASTS Dejan 6 years ago

Thank you for this issue! Already fixed in 640dfc0 and published.

| Reply |

This tutorial uses a very old version of Symfony. The fundamentals of Behat are still valid, but integration with Symfony will be different.

Symfony 2 Behat 3

What PHP libraries does this tutorial use?

// composer.json
{
    "require": {
        "php": ">=5.4.0, <7.3.0",
        "symfony/symfony": "^2.7", // v2.7.4
        "twig/twig": "^1.22", // v1.22.1
        "sensio/framework-extra-bundle": "^3.0", // v3.0.16
        "doctrine/doctrine-bundle": "^1.5", // v1.5.1
        "doctrine/orm": "^2.5", // v2.5.1
        "doctrine/doctrine-fixtures-bundle": "^2.2", // v2.2.1
        "behat/symfony2-extension": "^2.0" // v2.0.0
    },
    "require-dev": {
        "behat/mink-extension": "^2.0", // v2.0.1
        "behat/mink-goutte-driver": "^1.1", // v1.1.0
        "behat/mink-selenium2-driver": "^1.2", // v1.2.0
        "phpunit/phpunit": "^4.8" // 4.8.18
    }
}

Previous Chapter

Next Chapter

Behat Loves Mink (Free Definitions from MinkExtension)

Share this awesome video!

Keep on Learning!

Free Behat Steps

6 Comments

Delete comment?

What PHP libraries does this tutorial use?

Show Lines	// ... lines 1 - 5
	Scenario: Search for a word that exists
	Given I am on "/"
	When I fill in "searchTerm" with "Samsung"
	And I press "search_submit"
	Then I should see "Samsung Galaxy S II"

Show Lines	// ... lines 1 - 12
	class FeatureContext implements Context, SnippetAcceptingContext
Show Lines	// ... lines 14 - 86

	default:
Show Lines	// ... lines 2 - 6
	extensions:
	Behat\MinkExtension:
Show Lines	// ... lines 9 - 12

	default:
	suites:
	default:
	contexts:
	- FeatureContext
	- Behat\MinkExtension\Context\MinkContext
Show Lines	// ... lines 7 - 12

Show Lines	// ... lines 1 - 21
	class MinkContext extends RawMinkContext implements TranslatableContext
	{
	/**
Show Lines	// ... lines 25 - 26
	* @Given /^(?:\|I )am on (?:\|the )homepage$/
	* @When /^(?:\|I )go to (?:\|the )homepage$/
	*/
	public function iAmOnHomepage()
	{
	$this->visitPath('/');
	}
Show Lines	// ... lines 34 - 75
	/**
Show Lines	// ... lines 77 - 78
	* @When /^(?:\|I )press "(?P<button>(?:[^"]\|\\")*)"$/
	*/
	public function pressButton($button)
	{
	$button = $this->fixStepArgument($button);
	$this->getSession()->getPage()->pressButton($button);
	}
Show Lines	// ... lines 86 - 485
	}