Migrating to Device Farm desktop browser testing from Selenium Grid

To migrate Selenium test suites in an environment that use Selenium Grid and RemoteWebDriver), you must modify your test suite setup procedure. Using the AWS SDK, you request a signed command executor (hub) URL from the Device Farm desktop browser testing API. Then you pass that URL along with your requested capabilities to your RemoteWebDriver.

For more information about Selenium Grid, see the Selenium Grid documentation.

To migrate

1. Run your tests locally to observe and confirm your current test suite behavior.

2. To use the desktop browser testing feature, you must install and configure the AWS SDK for the language appropriate for your tests.

3. Use the console or CLI to create a project:

   Console

   1. Sign in to the Device Farm console at https://console.aws.amazon.com/devicefarm.

   2. In the navigation pane, choose Desktop Browser Testing, and then choose Projects.

   3. If you already have a project, under Desktop browser testing projects, choose the name of your project.

      Otherwise, to create a new project, choose New project. Then, on the Create Project page, do the following:

      1. Enter a Project name.

      2. (Optional) Enter a project Description.

      3. (Optional) Under Virtual Private Cloud (VPC) Settings, you can configure your project's VPC peering settings by choosing the VPC, its Subnets, and its Security Groups. For instructions on connecting Device Farm to a VPC, see Working with Amazon Virtual Private Cloud across Regions in the Device Farm Developer Guide.

      4. Choose Create.

   4. In the project details, note the project's Amazon Resource Name (ARN). It looks like this: arn:aws:devicefarm:us-west-2:111122223333:testgrid-project:123e4567-e89b-12d3-a456-426655440000.

      Note

      For instructions on updating your project configuration, see Configuring your project to use Amazon VPC endpoints.

   CLI

   The following creates a project:

   aws devicefarm create-test-grid-project --name "Peculiar Things"

   Note

   To update your project configuration, see Configuring your project to use Amazon VPC endpoints.

4. Modify your RemoteWebDriver initialization to use the WebDriver endpoint.

   Java

   Note

   This example uses JUnit 5 and the AWS SDK for Java 2.x. For more information about the AWS SDK for Java 2.x, see AWS SDK for Java 2.x API Reference. If you are using a different test framework, be aware that @Before and @After are called before and after each test, respectively.

   // Import the AWS SDK for Java 2.x Device Farm client:
   import software.amazon.awssdk.regions.Region;
   import software.amazon.awssdk.services.devicefarm.*;
   import software.amazon.awssdk.services.devicefarm.model.*;
   import java.net.URL;
   
   // in your tests ...
   public class MyTests {
     // ... When you set up your test suite
     private static RemoteWebDriver driver;
   
     @Before
     void setUp() {
       String myProjectARN = "arn:aws:devicefarm:us-west-2:111122223333:testgrid-project:123e4567-e89b-12d3-a456-426655440000";
       DeviceFarmClient client  = DeviceFarmClient.builder().region(Region.US_WEST_2).build();
       CreateTestGridUrlRequest request = CreateTestGridUrlRequest.builder()
         .expiresInSeconds(300)
         .projectArn(myProjectARN)
         .build();
       CreateTestGridUrlResponse response = client.createTestGridUrl(request);
       URL testGridUrl = new URL(response.url());
       // You can now pass this URL into RemoteWebDriver.
       WebDriver driver = new RemoteWebDriver(testGridUrl, DesiredCapabilities.firefox());
     }
     
     @After
     void tearDown() {
       // make sure to close your WebDriver:
       driver.quit();
     }
   
   }

   For more information, see Migrating a Java test suite to Device Farm.

   Python

   Important

   This example is written with the assumption you are using Python 3 with pytest. If you are using another testing framework, see the documentation.

   
   # Include boto3, the Python SDK's main package:
   import boto3, pytest
   
   # in your tests:
   # Set up the Device Farm client, get a driver URL:
   class myTestSuite:
     def setup_method(self, method):
       devicefarm_client = boto3.client("devicefarm", region_name="us-west-2")
       testgrid_url_response = devicefarm_client.create_test_grid_url(
         projectArn="arn:aws:devicefarm:us-west-2:111122223333:testgrid-project:123e4567-e89b-12d3-a456-426655440000",
         expiresInSeconds=300)
       self. driver = selenium.webdriver.Remote(testgrid_url_response["url"], selenium.webdriver.DesiredCapabilities.FIREFOX)
   
     # later, make sure to end your WebDriver session:
     def teardown_method(self, method):
       self.driver.quit()

   For more information, see Migrating Python tests to Device Farm desktop browser testing.

5. Make sure that the environment variables AWS_ACCESS_KEY and AWS_SECRET_KEY are configured in your testing environment.

6. Run your tests.