Laravel BrowserStack

A package to run Laravel Dusk tests on BrowserStack.

Installation

You can install the package via composer:

composer require --dev chinleung/laravel-browserstack

Make sure to add your credentials to the .env:

BROWSERSTACK_USERNAME=<username>
BROWSERSTACK_ACCESS_KEY=<access-key>

Configuration

You can customize the capabilities and other configuration for BrowserStack by publishing the config file:

php artisan vendor:publish --provider="ChinLeung\BrowserStack\BrowserStackServiceProvider" --tag="config"

Quick Usage

Simply add the RunsOnBrowserStack trait to the test class you want to run on BrowserStack.

abstract class DuskTestCase extends BaseTestCase
{
    use CreatesApplication, RunsOnBrowserStack;
}

Then you can run your tests:

BROWSERSTACK_BROWSER=WINDOWS_10_CHROME php artisan dusk

The browser slug should match the following pattern:

(OS)_(OS_VERSION)_(BROWSER)_(BROWSER_VERSION)

If no browser version has been provided, the tests will be run on the latest version of the browser available in BrowserStack.

Browsers

You can find below the list of available slugs for the browser option.

Windows

• WINDOWS_10_IE
• WINDOWS_10_EDGE
• WINDOWS_10_CHROME
• WINDOWS_10_FIREFOX
• WINDOWS_8.1_IE
• WINDOWS_8.1_EDGE
• WINDOWS_8.1_CHROME
• WINDOWS_8.1_FIREFOX
• WINDOWS_8_IE
• WINDOWS_8_EDGE
• WINDOWS_8_CHROME
• WINDOWS_8_FIREFOX
• WINDOWS_7_IE
• WINDOWS_7_EDGE
• WINDOWS_7_CHROME
• WINDOWS_7_FIREFOX
• WINDOWS_XP_IE
• WINDOWS_XP_CHROME
• WINDOWS_XP_FIREFOX
• WINDOWS_XP_OPERA

OS X

• MACOS_MONTEREY_SAFARI
• MACOS_MONTEREY_CHROME
• MACOS_MONTEREY_FIREFOX
• MACOS_MONTEREY_EDGE
• MACOS_BIG_SUR_SAFARI
• MACOS_BIG_SUR_CHROME
• MACOS_BIG_SUR_FIREFOX
• MACOS_BIG_SUR_EDGE
• MACOS_CATALINA_SAFARI
• MACOS_CATALINA_CHROME
• MACOS_CATALINA_FIREFOX
• MACOS_CATALINA_EDGE
• MACOS_MOJAVE_SAFARI
• MACOS_MOJAVE_CHROME
• MACOS_MOJAVE_FIREFOX
• MACOS_MOJAVE_OPERA
• MACOS_HIGH_SIERRA_SAFARI
• MACOS_HIGH_SIERRA_CHROME
• MACOS_HIGH_SIERRA_FIREFOX
• MACOS_HIGH_SIERRA_OPERA
• MACOS_SIERRA_SAFARI
• MACOS_SIERRA_CHROME
• MACOS_SIERRA_FIREFOX
• MACOS_SIERRA_OPERA
• MACOS_EL_CAPITAN_SAFARI
• MACOS_EL_CAPITAN_CHROME
• MACOS_EL_CAPITAN_FIREFOX
• MACOS_EL_CAPITAN_OPERA
• MACOS_YOSEMITE_SAFARI
• MACOS_YOSEMITE_CHROME
• MACOS_YOSEMITE_FIREFOX
• MACOS_YOSEMITE_OPERA
• MACOS_MOUNTAIN_LION_SAFARI
• MACOS_MOUNTAIN_LION_CHROME
• MACOS_MOUNTAIN_LION_FIREFOX
• MACOS_MOUNTAIN_LION_OPERA
• MACOS_LION_SAFARI
• MACOS_LION_CHROME
• MACOS_LION_FIREFOX
• MACOS_LION_OPERA
• MACOS_SNOW_LEOPARD_SAFARI
• MACOS_SNOW_LEOPARD_CHROME
• MACOS_SNOW_LEOPARD_FIREFOX
• MACOS_SNOW_LEOPARD_OPERA

ANDROID

• ANDROID_SAMSUNG_GALAXY_S9_PLUS
• ANDROID_SAMSUNG_GALAXY_S8_PLUS
• ANDROID_SAMSUNG_GALAXY_S10E
• ANDROID_SAMSUNG_GALAXY_S10_PLUS
• ANDROID_SAMSUNG_GALAXY_S10
• ANDROID_SAMSUNG_GALAXY_NOTE_10_PLUS
• ANDROID_SAMSUNG_GALAXY_NOTE_10
• ANDROID_SAMSUNG_GALAXY_A10
• ANDROID_SAMSUNG_GALAXY_NOTE_9
• ANDROID_SAMSUNG_GALAXY_S9_PLUS
• ANDROID_SAMSUNG_GALAXY_S9
• ANDROID_SAMSUNG_GALAXY_NOTE_8
• ANDROID_SAMSUNG_GALAXY_A8
• ANDROID_SAMSUNG_GALAXY_S8
• ANDROID_SAMSUNG_GALAXY_S7
• ANDROID_SAMSUNG_GALAXY_NOTE_4
• ANDROID_SAMSUNG_GALAXY_S6
• ANDROID_GOOGLE_PIXEL_4_XL
• ANDROID_GOOGLE_PIXEL_4
• ANDROID_GOOGLE_PIXEL_3
• ANDROID_GOOGLE_PIXEL_3_XL
• ANDROID_GOOGLE_PIXEL_3A
• ANDROID_GOOGLE_PIXEL_3A_XL
• ANDROID_GOOGLE_PIXEL_2
• ANDROID_GOOGLE_PIXEL
• ANDROID_GOOGLE_NEXUS_6
• ANDROID_GOOGLE_NEXUS_5
• ANDROID_MOTOROLA_MOTO_G7_PLAY
• ANDROID_MOTOROLA_MOTO_X_2ND_GEN
• ANDROID_ONEPLUS_7
• ANDROID_ONEPLUS_6T

IOS

• IOS_IPHONE_XS
• IOS_IPHONE_11_PRO_MAX
• IOS_IPHONE_11_PRO
• IOS_IPHONE_11
• IOS_IPHONE_XS
• IOS_IPHONE_XS_MAX
• IOS_IPHONE_XR
• IOS_IPHONE_X
• IOS_IPHONE_8
• IOS_IPHONE_8_PLUS
• IOS_IPHONE_7
• IOS_IPHONE_7_PLUS
• IOS_IPHONE_6S
• IOS_IPHONE_6_PLUS
• IOS_IPHONE_6
• IOS_IPHONE_SE
• IOS_IPAD_PRO_12.9_2018
• IOS_IPAD_7TH
• IOS_IPAD_PRO_11_2018
• IOS_IPAD_MINI_2019
• IOS_IPAD_AIR_2019
• IOS_IPAD_PRO_9.7_2016
• IOS_IPAD_PRO_12.9_2017
• IOS_IPAD_MINI_4
• IOS_IPAD_6TH
• IOS_IPAD_5TH

The list of possible combinations of OS, Browsers and Browser Versions are available here: https://www.browserstack.com/automate/capabilities

Security

If you discover any security related issues, please email [email protected] instead of using the issue tracker.

Credits

• Chin Leung
• All Contributors

License

The MIT License (MIT). Please see License File for more information.