galahad/dusk-browserstack

Easily run Laravel Dusk tests on BrowserStack.

2.0.0 2020-05-04 13:29 UTC

Requires

• php: >=7.0
• browserstack/browserstack-local: ~1.1.0
• illuminate/support: ~5.5|^6.0
• php-webdriver/webdriver: ~1.0

Requires (Dev)

• phpunit/phpunit: ^6.0

MIT

• Chris Morrell

• testing
• webdriver
• laravel
• BrowserStack
• dusk

README

Installation

First, install the composer package:

composer require galahad/dusk-browserstack

Usage

Update your DuskTestCase:

<?php

namespace Tests;

use Galahad\BrowserStack\SupportsBrowserStack;

abstract class DuskTestCase extends BaseTestCase
{
	// Add this:
	use SupportsBrowserStack;
	
	public static function prepare()
	{
		// This is no longer needed:
		// static::startChromeDriver();
	}
	
	protected function driver()
	{
		// Set up the browser stack driver as needed
		return $this->createBrowserStackDriver(/* $config */);
	}
}

Options

Set these in the driver() call or in the services.browserstack config. The key option can be omitted if you have a BROWSERSTACK_ACCESS_KEY environmental variable set.

• username: [required] your BrowserStack username
• key: [required] your BrowserStack API key
• local_config: array of options to pass to BrowserStackLocal
• capabilities: array of default capabilities to request (defaults to Chrome on any available platform)

Advanced

It's possible to call setBrowserStackLocalConfig or setBrowserStackCapabilities within your tests, and each new call to driver() will use the updated settings. You can use this to run different tests on different browsers/platforms/etc.

Changelog

1.1.0

• Silently skips running BrowserStack Local if something is listening on port 45691

1.0.2

• Better default BrowserStack logfile

1.0.1

• Loads configuration from services.browserstack by default for less boilerplate.

1.0.0

• First release