Test on Internal Networks

BrowserStack enables you to run your Codeception automated tests on your internal development environments, on localhost, and from behind a corporate firewall. This feature is called “Local Testing”.

Local Testing establishes a secure connection between your machine and the BrowserStack cloud. Once you set up Local Testing, all URLs work out of the box, including HTTPS URLs and those behind a proxy or firewall.

Configuring your Codeception tests for Local Testing takes just four steps:

1. Install the BrowserStack Local Testing bindings:
   
   

    php composer.phar require browserstack/browserstack-local
   

2. Next, you need to update your Codeception config file, and set the browserstack.local capability to true:
   
   

    class_name: AcceptanceTester
   
    modules:
      enabled:
        - \BrowserStackWebDriver
      config:
        \BrowserStackWebDriver:
          host: 'hub-cloud.browserstack.com'
          port: 80
          browser: chrome
          url: 'http://bs-local.com:45691'
          capabilities:
            'browserstack.user': 'YOUR_USERNAME'
            'browserstack.key' : 'YOUR_ACCESS_KEY'
            'browserstack.local': true
   

3. Run a sample test case to check whether the Local test connection has been set up properly. You can use the following sample test case, which can be found in the repo under Codeception-BrowserStack/tests/acceptance/ directory:
   
   

   LocalCept.php

    <?php
      // @group local
      $I = new AcceptanceTester($scenario);
      $I->wantTo('Test BrowserStack Local Testing');
      $I->amOnPage('/check');
      $I->see('Up and running');
    ?>
   

4. You can now run your Codeception test using BrowserStack Local with the following command:
   
   

    composer local