Laravel Dusk with Selenium – Running Laravel Dusk Automation Scripts on LambdaTest Selenium Grid

Execute your automation test scripts with Selenium WebDriver instantly through LambdaTest which is a cloud-based, cross browser testing tool offering a Selenium grid consisting 2000+ browsers and browser versions running on real operating systems to pace up automation testing of your web-app or website. In this topic, you will learn how to automate your website testing using Selenium with Laravel Dusk on LambdaTest.

By the end of this topic, you will be able to:

Run a sample Selenium with Laravel Dusk on LambdaTest Automation.
Set up an environment for testing your locally hosted web pages.
Understand & configure Laravel Dusk desired capabilities for executing a Selenium test.
Explore advanced features of LambdaTest.

Prerequisites For Running Laravel Dusk and Selenium

Before you begin automation testing with Selenium and Laravel Dusk, be ready with the below essentials:

Make sure that you have the latest PHP build installed on your system. If you are using a Mac then PHP would be installed by default. For Linux you would need to enter the below command in terminal:

sudo apt-get install curl libcurl3 libcurl3-dev php

1

sudo apt-get install curl libcurl3 libcurl3-dev php

For Windows, you can download PHP from here. Also, refer to this documentation for ensuring the accessibility of PHP through Command Prompt(cmd).
Install Laravel Dusk using the below command with composer:

$ composer require laravel/dusk

1

$ composer require laravel/dusk

If you don’t have composer installed in your system then click here.

Once you have composer installed, you can leverage Composer to download and install Selenium dependencies. For that first create a composer.json file in your directory and add the following code to the json.

// composer.json

{
    "name": "laravel/laravel",
    "type": "project",
    "description": "The Laravel Framework.",
    "keywords": [
        "framework",
        "laravel"
    ],
    "license": "MIT",
    "require": {
        "php": "^7.1.3",
        "fideloper/proxy": "^4.0",
        "laravel/framework": "5.7.*",
        "laravel/tinker": "^1.0"
    },
    "require-dev": {
        "beyondcode/laravel-dump-server": "^1.0",
        "filp/whoops": "^2.0",
        "fzaninotto/faker": "^1.4",
        "laravel/dusk": "^4.0",
        "mockery/mockery": "^1.0",
        "nunomaduro/collision": "^2.0",
        "phpunit/phpunit": "^7.0"
    },
    "config": {
        "optimize-autoloader": true,
        "preferred-install": "dist",
        "sort-packages": true
    },
    "extra": {
        "laravel": {
            "dont-discover": []
        }
    },
    "autoload": {
        "psr-4": {
            "App\\": "app/",
            "Tests\\": "tests/"
        },
        "classmap": [
            "database/seeds",
            "database/factories",
            "tests/TestCase.php"
        ]
    },
    "autoload-dev": {
        "psr-4": {
            "Tests\\": "tests/"
        }
    },
    "minimum-stability": "dev",
    "prefer-stable": true,
    "scripts": {
        "post-autoload-dump": [
            "Illuminate\\Foundation\\ComposerScripts::postAutoloadDump",
            "@php artisan package:discover --ansi"
        ],
        "post-root-package-install": [
            "@php -r \"file_exists('.env') || copy('.env.example', '.env');\""
        ],
        "post-create-project-cmd": [
            "@php artisan key:generate --ansi"
        ]
    }
}

// composer.json

{

"name": "laravel/laravel",

"type": "project",

"description": "The Laravel Framework.",

"keywords": [

"framework",

"laravel"

"license": "MIT",

"require": {

"php": "^7.1.3",

"fideloper/proxy": "^4.0",

"laravel/framework": "5.7.*",

"laravel/tinker": "^1.0"

"require-dev": {

"beyondcode/laravel-dump-server": "^1.0",

"filp/whoops": "^2.0",

"fzaninotto/faker": "^1.4",

"laravel/dusk": "^4.0",

"mockery/mockery": "^1.0",

"nunomaduro/collision": "^2.0",

"phpunit/phpunit": "^7.0"

"config": {

"optimize-autoloader": true,

"preferred-install": "dist",

"sort-packages": true

"extra": {

"laravel": {

"dont-discover": []

}

"autoload": {

"psr-4": {

"App\\": "app/",

"Tests\\": "tests/"

"classmap": [

"database/seeds",

"database/factories",

"tests/TestCase.php"

]

"autoload-dev": {

"psr-4": {

"Tests\\": "tests/"

}

"minimum-stability": "dev",

"prefer-stable": true,

"scripts": {

"post-autoload-dump": [

"Illuminate\\Foundation\\ComposerScripts::postAutoloadDump",

"@php artisan package:discover --ansi"

"post-root-package-install": [

"@php -r \"file_exists('.env') || copy('.env.example', '.env');\""

"post-create-project-cmd": [

"@php artisan key:generate --ansi"

]

}

Setting up project dependencies.

composer install composer dump-autoload

1
2

composer install
composer dump-autoload
Check out our GitHub repository for finding all the code references that will be discussed in this topic.

Getting Started With Laravel Dusk and LambdaTest

First, let us create .env from the example file:

cp .env.example .env

1	cp .env.example .env

APP_NAME=Laravel
APP_ENV=local
APP_KEY=
APP_DEBUG=true
APP_URL=http://localhost
 
LT_USERNAME="your username" 
LT_ACCESS_KEY="your access key"
 
LOG_CHANNEL=stack
 
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=homestead
DB_USERNAME=homestead
DB_PASSWORD=secret
 
BROADCAST_DRIVER=log
CACHE_DRIVER=file
QUEUE_CONNECTION=sync
SESSION_DRIVER=file
SESSION_LIFETIME=120
 
REDIS_HOST=127.0.0.1
REDIS_PASSWORD=null
REDIS_PORT=6379
 
MAIL_DRIVER=smtp
MAIL_HOST=smtp.mailtrap.io
MAIL_PORT=2525
MAIL_USERNAME=null
MAIL_PASSWORD=null
MAIL_ENCRYPTION=null
 
PUSHER_APP_ID=
PUSHER_APP_KEY=
PUSHER_APP_SECRET=
PUSHER_APP_CLUSTER=mt1
 
MIX_PUSHER_APP_KEY="${PUSHER_APP_KEY}"
MIX_PUSHER_APP_CLUSTER="${PUSHER_APP_CLUSTER}"

APP_NAME=Laravel

APP_ENV=local

APP_KEY=

APP_DEBUG=true

APP_URL=http://localhost

LT_USERNAME="your username"

LT_ACCESS_KEY="your access key"

LOG_CHANNEL=stack

DB_CONNECTION=mysql

DB_HOST=127.0.0.1

DB_PORT=3306

DB_DATABASE=homestead

DB_USERNAME=homestead

DB_PASSWORD=secret

BROADCAST_DRIVER=log

CACHE_DRIVER=file

QUEUE_CONNECTION=sync

SESSION_DRIVER=file

SESSION_LIFETIME=120

REDIS_HOST=127.0.0.1

REDIS_PASSWORD=null

REDIS_PORT=6379

MAIL_DRIVER=smtp

MAIL_HOST=smtp.mailtrap.io

MAIL_PORT=2525

MAIL_USERNAME=null

MAIL_PASSWORD=null

MAIL_ENCRYPTION=null

PUSHER_APP_ID=

PUSHER_APP_KEY=

PUSHER_APP_SECRET=

PUSHER_APP_CLUSTER=mt1

MIX_PUSHER_APP_KEY="${PUSHER_APP_KEY}"

MIX_PUSHER_APP_CLUSTER="${PUSHER_APP_CLUSTER}"

Now we need to replace, LT_USERNAME with your LambdaTest username & LT_ACCESS_KEY with your access key. You can acquire both using LambdaTest Dashboard.

After that, you need to update platform configuration in driver method of tests/DuskTestCase.php, to specify the target where tests should run. (List of supported OS platfrom, Browser, resolutions can be found at LambdaTest Capability Generator)Sample configuration.

//php-laravel-dusk-todo-master\tests\DuskTestCase.php


return RemoteWebDriver::create($url,
        DesiredCapabilities::chrome()
            ->setCapability("platform", "win10")
            ->setCapability("browserName", "chrome")
            ->setCapability("version", "71.0")
            ->setCapability("resolution", "1024x768")
            ->setCapability("build", "LaravelDusk Build")
            ->setCapability("name", "LaravelDusk Test")
            ->setCapability("network", true)
            ->setCapability("video", true)
            ->setCapability("visual", true)
            ->setCapability("console", true)
            ->setCapability("tunnel", false)
    );

//php-laravel-dusk-todo-master\tests\DuskTestCase.php

return RemoteWebDriver::create($url,

DesiredCapabilities::chrome()

->setCapability("platform", "win10")

->setCapability("browserName", "chrome")

->setCapability("version", "71.0")

->setCapability("resolution", "1024x768")

->setCapability("build", "LaravelDusk Build")

->setCapability("name", "LaravelDusk Test")

->setCapability("network", true)

->setCapability("video", true)

->setCapability("visual", true)

->setCapability("console", true)

->setCapability("tunnel", false)

);

Running Tests On Locally Hosted Web Pages or Web Apps

With Lambda Tunnel, you can perform tests on your locally hosted web pages or web apps by a SSH(Secure Shell) connection. All you need to do is specify the tunnel value to true in your desired capabilities. You will find the capabilities in the driver method of tests/DuskTestCase.php

php-laravel-dusk-todo-master\tests\DuskTestCase.php

return RemoteWebDriver::create($url,
            DesiredCapabilities::chrome()
                ->setCapability("platform", "win10")
                ->setCapability("browserName", "chrome")
                ->setCapability("version", "71.0")
                ->setCapability("resolution", "1024x768")
                ->setCapability("build", "LaravelDusk Build")
                ->setCapability("name", "LaravelDusk Test")
                ->setCapability("network", true)
                ->setCapability("video", true)
                ->setCapability("visual", true)
                ->setCapability("console", true)
                ->setCapability("tunnel", true) // running tests on locally hosted web pages
        );

return RemoteWebDriver::create($url,

DesiredCapabilities::chrome()

->setCapability("platform", "win10")

->setCapability("browserName", "chrome")

->setCapability("version", "71.0")

->setCapability("resolution", "1024x768")

->setCapability("build", "LaravelDusk Build")

->setCapability("name", "LaravelDusk Test")

->setCapability("network", true)

->setCapability("video", true)

->setCapability("visual", true)

->setCapability("console", true)

->setCapability("tunnel", true) // running tests on locally hosted web pages

);

Follow our documentation on Lambda Tunnel to know it all. OS specific instructions to download and setup tunnel binary can be found at the following links.

Documentation For Windows User

Documentation For Mac User

Documentation For Linux User

Download the binary file of:

Let us have a look at an example which will validate your LambdaTest credentials for authentication purpose. Later, the code will select the basic capabilities such as OS, browser, browser version and so on. This code is also available on our Laravel Dusk GitHub Repository for you to clone and play around.

<?php
 
namespace Tests\Browser;
 
use Tests\DuskTestCase;
use Laravel\Dusk\Browser;
use Illuminate\Foundation\Testing\DatabaseMigrations;
 
class TodoTest extends DuskTestCase
{
    /**
     * A Dusk test example.
     *
     * @return void
     */
    public function testExample()
    {
        $this->browse(function (Browser $browser) {
            $browser->visit('https://lambdatest.github.io/sample-todo-app/')
                    ->assertTitleContains('Sample page - lambdatest.com')
                    ->check("li1")
                    ->check("li3")
                    ->type("#sampletodotext", "Let's add new to do item")
                    ->press('#addbutton');
            sleep(10);
        });
 
    }
}

<?php

namespace Tests\Browser;

use Tests\DuskTestCase;

use Laravel\Dusk\Browser;

use Illuminate\Foundation\Testing\DatabaseMigrations;

class TodoTest extends DuskTestCase

{

/**

* A Dusk test example.

* @return void

public function testExample()

{

$this->browse(function (Browser $browser) {

$browser->visit('https://lambdatest.github.io/sample-todo-app/')

->assertTitleContains('Sample page - lambdatest.com')

->check("li1")

->check("li3")

->type("#sampletodotext", "Let's add new to do item")

->press('#addbutton');

sleep(10);

});

}

Execute The Test

You would need to execute the below command in your terminal/cmd:

php artisan dusk

1	php artisan dusk