日本語版はこちら

This plugin enables to use Laravel Dusk test framework in OctoberCMS projects.

Installation options are;

• OctoberCMS UI (not yet available now)
• Composer
• Manual git clone

Execute below at the root of your project:

composer require --dev pikanji/dusktests-plugin
php artisan dusk:install

Although composer is still required to install dependencies, you can install this plugin without adding it to your composer.json. In the plugins directory of your project, create pikanji directory and simply execute git clone in it.

cd plugins
mkdir pikanji
cd pikanji
git clone [email protected]:pikanji/oc-dusktests-plugin.git dusktests

Execute below at the root of your project.

composer update
php artisan dusk:install

Dusk comes with example test (tests/Browser/ExampleTest.php). You can test setup by running this test.

ExampleTest.php checks if a string "Laravel" is found in the loaded web page. Assuming that your are using fresh copy of demo theme, change "Laravel" to "October CMS" in ExampleTest.php to let the test pass.

public function testBasicExample()
{
    $this->browse(function (Browser $browser) {
        $browser->visit('/')
                ->assertSee('October CMS');
    });
}

Assuming you are running your web server on your local machine for testing and Chrome browser is installed, execute below at the root of your project. If you are running web server on Docker container see here in addition to this instruction.

php artisan dusk

Test could be very slow. Leave it for a couple minutes to see if it has progress.

Screenshots are stored in tests/Browser/screenshots by default. There might be some configuration to change it.

If you get timeout error, you can try extending timeout like below in tests/DuskTestCase.php. In my case, 1 minute was not enough. So, I made it 3 minutes.

return RemoteWebDriver::create(
    'http://192.168.1.115:4444/wd/hub', DesiredCapabilities::chrome()->setCapability(
        ChromeOptions::CAPABILITY, $options
    ), 180*1000, 180*1000
);

See here in addition to this instruction.