Introduction ​

Testbench Dusk is built on top of Testbench to provide support running browser-based tests for your Laravel packages using Laravel Dusk.

Installing ​

You can install Testbench using the following command:

composer require --dev "orchestra/testbench-dusk"

Next, you can run the following command to scaffold your package with the recommended setup:

vendor/bin/testbench workbench:install

Version Compatibility ​

Configuration ​

Please refer to Configuration documentation for further details.

Getting Started ​

To use Testbench Dusk Component, all you need to do is extend Orchestra\Testbench\Dusk\TestCase instead of PHPUnit\Framework\TestCase. The fixture app booted by Orchestra\Testbench\Dusk\TestCase is predefined to follow the base application skeleton of Laravel.

class DuskTestCase extends \Orchestra\Testbench\Dusk\TestCase
{
    //
}

PHPUnit Configuration ​

Browser tests can take a while to run, so you could also separate your test suite in your phpunit.xml file by providing different test suites, allowing you to run your Browser tests on demand.

<testsuites>
    <testsuite name="Browser">
        <directory suffix="Test.php">./tests/Browser</directory>
    </testsuite>
    <testsuite name="Feature">
        <directory suffix="Test.php">./tests/Feature</directory>
    </testsuite>
    <testsuite name="Unit">
        <directory suffix="Test.php">./tests/Unit</directory>
    </testsuite>
</testsuites>

Run only your browser tests by running PHPUnit with the --testsuite=Browser option.

vendor/bin/phpunit --testsuite=Browser

Autoloading using testbench.yaml ​

Testbench will use the configuration values defined in testbench.yaml and use its value when the TestCase class uses Orchestra\Testbench\Concerns\WithWorkbench trait:

use Orchestra\Testbench\Concerns\WithWorkbench;

class DuskTestCase extends \Orchestra\Testbench\Dusk\TestCase 
{
    use WithWorkbench;
}

Package Service Providers ​

Using WithWorkbench will make TestCase uses providers configuration value from testbench.yaml:

providers:
  - Laravel\Sanctum\SanctumServiceProvider
  - Workbench\App\Providers\WorkbenchServiceProvider

Using Custom Laravel Skeleton ​

Using WithWorkbench will make TestCase uses laravel configuration value from testbench.yaml:

laravel: ./skeleton

Further reading ​

Before going through the rest of this documentation, please take some time to read the following documentation:

• Package Development for Laravel
• Orchestra Testbench Documentation
• Laravel Dusk Documentation