Skip to main content

Selenium With Behat

Run Behat tests on the TestMu AI cloud grid. This guide covers setup, running a sample test, configuring capabilities, and testing locally hosted pages.

Sample repo

All the code used in this guide is available in the sample repository.

Prerequisites​

Complete the following steps before you begin automation testing with Selenium and Behat.

  1. Install the latest PHP on your system. Use the following commands in the terminal:

    • MacOS: Previous versions of MacOS have PHP installed by default. For the latest MacOS versions starting with Monterey, download and install PHP manually:
    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
    brew install php

  2. Download composer in the project directory (Linux/MacOS, Windows).

    Note: To use the composer command directly, it either should have been downloaded in the project directory or should be accessible globally which can be done by the command below:

    mv composer.phar /usr/local/bin/composer

Step 1: Clone the Sample Project​

Clone the repository and install dependencies.

git clone https://github.com/LambdaTest/behat-selenium-sample
cd behat-selenium-sample

Install the composer dependencies:

composer install

Set up Behat automation for your OS using composer:

php composer.phar require behat/behat

Step 2: Set Your Credentials​

Configure your credentials to connect to the TestMu AI Selenium Grid.

Set TestMu AI Username and Access Key in environment variables.

export LT_USERNAME="undefined"
export LT_ACCESS_KEY="undefined"

Step 3: Configure Your Test Capabilities​

Define browser, version, and OS settings for your test run.

In the test script, update your test capabilities to validate your TestMu AI credentials and select OS, browser, browser version, and other settings.

default:
   paths:
       features: '../features/single'
       bootstrap:  '../features/bootstrap'
   context:
       parameters:
           lambdatest:
               server: "hub.lambdatest.com"
               user: "YOUR_LAMBDATEST_USERNAME"
               key: "YOUR_LAMBDATEST_ACCESS_KEY"
 
               capabilities:
                   build: "behat-selenium-sample"
                   name: "single-behat-test"
                   video: true
                   visual: true
                   network: true
                   console: true
 
 
               environments:
                   -
                       browserName: chrome
                       version: 71.0
                       platform: Win10
Capabilities Generator

Use the TestMu AI Capabilities Generator to auto-generate the capabilities class for your test requirements.

Step 4: Run the Test​

Execute the Behat test from the command line.

composer single

To run parallel tests:

composer parallel

Step 5: View Your Results​

Check the test output on the console and the TestMu AI dashboard.

Visit the TestMu AI Automation Dashboard to view your test results. The dashboard provides:

  • Text logs for each test step
  • Screenshots captured during execution
  • Video recordings of the full test session

Run Behat Tests Using Agent Skills​

Use AI coding assistants to generate and run Behat tests with the TestMu AI Agent Skill.

The behat-skill is part of TestMu AI Agent Skills - structured packages that teach AI coding assistants how to write production-grade test automation.

Install the skill:

git clone https://github.com/LambdaTest/agent-skills.git
cp -r agent-skills/behat-skill .claude/skills/

# For Cursor / Copilot
cp -r agent-skills/behat-skill .cursor/skills/
tip

Install all available framework skills at once by cloning the repository directly into your tool's skills directory (e.g., .claude/skills/, .cursor/skills/).

Last updated on

Test across 3000+ combinations of browsers, real devices & OS.

Book Demo

Help and Support

Related Articles