Skip to main content

BrowserStack Integration

The BrowserStack integration helps you execute your tests on BrowserStack Selenium Grid from your Katalon Studio instance. To integrate with BrowserStack, you need to execute your test scripts on a remote web server configured in desired capabilities. To learn more about setting up the remote server in desired capabilities, you can refer to this document: Set up remote server in desired capabilities.

This article demonstrates how to set up BrowserStack integration.

  1. Login to BrowserStack.

  2. On the left side of the BrowserStack account page, you can see your username and the Access Key value. These values are necessary for authentication between your Katalon Studio instance and the BrowserStack account.

    The syntax for the BrowserStack remote URL: http://username:accessKey@hub-cloud.browserstack.com/wd/hub.

    For example: http://abcdef121:affdfsr543xyz@hub-cloud.browserstack.com/wd/hub.

    Note this BrowserStack remote URL for later input.

  3. Navigate to the Browserstack capabilities generator page: Capabilities Generator.

  4. Select the operating system and the device/browser you wish to execute with. Here, we select iOS and iPhone 12 device. We also choose Java as the generator language. Browserstack Capabilities Generator will generate desired capabilities accordingly in Java.

    Select Browserstack capabilities

  5. In Katalon Studio, go to Project > Settings > Desired Capabilities > Remote. Input the following information:

    • Remote server URL: input the URL retrieved from step 2. For example: http://abcdef121:affdfsr543xyz@hub-cloud.browserstack.com/wd/hub

    • Remote server type: Choose Selenium/Appium. Here, we choose Appium. From Katalon Studio version 6.3.0 onwards, when choosing Appium server, you also need to select Android Driver/iOS Driver.

    • The capabilities generated from step 4.

    Add remote server capabilities

    Note:
    • For Appium remote web server, you need to add the platformName capabilities. You can learn more about Appium capabilities in this Appium document: Appium Desired Capabilities.
    • If you want to add Chrome driver capabilities, make sure to put those capabilities into the goog:chromeOptions property as a dictionary. For example: Add Chrome capabilities for remote server

  6. Click Apply and Close when you are done.

  7. To execute your tests with Browserstack Selenium Grid, click Remote in the dropdown list next to Run.

    Execute Browserstack remote server