brianclogan/dusk-recordings

Record your dusk tests even when headless.

dev-main 2023-01-04 21:24 UTC

This package is auto-updated.

Last update: 2024-11-05 01:36:27 UTC


README

This packge is forked from Sander van Kasteel's Laravel Dusk Screenrecordings.

This update brings it to the current versions of Laravel, and is being worked on to include Firefox and Edge support.

Usage

Warning: Currently only Chrome is supported

Requires PHP 8.0+

Requires Laravel 8 (or higher)

  1. First install the pacakge
composer require --dev brianclogan/dusk-recordings
  1. Publish the configuration
php artisan recordings:publish
  1. Modify your tests/DuskTestcase.php to have screen recordings work.

Example implmentation

    protected function driver()
    {
        $options = (new ChromeOptions)
            ->setExperimentalOption("prefs", [
                "download.default_directory" => $this->downloadDir
            ])
        ->addArguments(collect([
            '--window-size=1920,1080',
        ])->unless($this->hasHeadlessDisabled(), function ($items) {
            return $items->merge([
                '--disable-gpu',
                '--headless',
            ]);
        })->merge(
            $this->getChromeArgs()
        )->all());

        return RemoteWebDriver::create(
            $_ENV['DUSK_DRIVER_URL'] ?? 'http://localhost:9515',
            DesiredCapabilities::chrome()->setCapability(
                ChromeOptions::CAPABILITY, $options
            )
        );
    }

The most important parts are the

$this->getChromeArgs()

and the

->setExperimentalOption("prefs", [
    "download.default_directory" => $this->downloadDir
])

Firstly, we need to get a specific set of arguments, so that Chrome will allow us to record from an non-HTTPS source and automatically select the source from which to record from.

Lastly, we need to set download.default_directory to a known directory, so we know from which directory we need to move our recordings from.

  1. Add the WithScreenRecordings to your tests/DuskTestCase.php, so we will actually record and store the recordings.
use Brianclogan\DuskRecordings\WithDuskRecordings;

abstract class DuskTestCase extends BaseTestCase
{
    use CreatesApplication,
        WithDuskRecordings;
        
    // Rest of your DuskTestCase
}
  1. Run php artisan dusk to see it in action 🥳 🚀

How it works

This package works by loading a browser plugin, which in turns creates a new (pinned) tab in the browser, then it initializes the recording and then executes the test as usual.

Once the tests are finished, based on the configuration it will 'download' the recording from the tab created by the browser extension.

TODO

  • Add Firefox support
  • Fix --auto-select-desktop-capture-source argument under Linux
  • Ideal case scenario: enable window recording (instead of the full desktop).