Running suites on multiple browsers and devices

You can now configure a test suite to run across multiple web browsers and supported devices in one consolidated run. Instead of managing separate test runs for each browser and device, you can define all of your target browsers and devices within the configuration of the test suite. This simplifies cross-browser validation, saves time, and provides comprehensive report.

Before you begin

You must have completed the following tasks:
  • Ensured that you are assigned a Team Space Owner, Project Owner, or Member with a Tester role to create or edit a test resource.
  • Ensured that a suite is available in your project.
  • Added tests or other suites to the suite.

About this task

You can select the following browsers that are supported for cross-browser testing:
  • Chrome
  • Firefox
  • Edge
  • Safari
Also, you can select the following device profiles that are supported:
Device profile Default browser
Phone (Small) Edge
Phone (Medium) Chrome
Phone (Large) Edge
Phone (X-Large) Chrome
Tablet (Small) Edge
Tablet (Medium) Chrome
Tablet (Large) Edge
Tablet (X-Large) Chrome
When the suite runs, all the tests in the suite run sequentially for each selected browser or device.

Procedure

  1. Log in to Test Hub.
    The Projects page of the initial team space is displayed.
  2. Click My projects > project_name to open the project that contains the test assets.
    The Overview page of the project is displayed.
  3. Click Author > Test Editor.
    The Test Editor page and the test navigator panel are displayed.
  4. Double-click the .dts.yaml file in the list of Suites to open the suite.
    The tests or suites are displayed on the Suite Editor page.
  5. Click the Edit button, displayed on the Suite Editor page.

    The Edit button appears only when no active edit branch is selected.

    Alternatively, right-click the suite in the test navigator panel and select Edit.

    The Edit branch dialog is displayed if there is no edit branch active. Otherwise, go to step .
  6. Select your action to either select an existing Edit branch or create an Edit branch:
    • Perform the following steps to select an existing Edit branch:
      1. Select Use an existing edit branch.
      2. Select an Edit branch from the Select branch list if Edit branches already exist for your repository.
        Note:
        A warning message is displayed if the Edit branch, which you selected, is behind the source branch. To update the selected edit branch and maintain synchronization with the source branch, you can select the Update branch option when switching checkbox.
      3. Click Ok.
    • Perform the following steps to create the Edit branch:
      1. Select Create new edit branch.
      2. Enter a name for the Edit branch in the Branch Name field.
      3. Click Save.
  7. Click the Configure settings and data step 7.
    The Settings pane is displayed.
  8. Select the required browser and device profiles from the Profile drop-down list.
  9. Click Close to close the step details pane.
  10. Click Save to save the changes.
  11. Click the Run all icon icon, and then select the Run all > Run all on Default Cluster option.

    You can also select the Run all on Personal Agent option if the personal agent is in a ready state.

    The Results tab displays the progress of the test run. After the test run is complete, the tab displays the verdict and links to view the functional report, test log, and results page.

    Alternatively, you can select the Run with option to choose specific browsers. You can select one or multiple browsers. The suite runs only on the selected browser for that run.

  12. Click the Functional Report Functional report icon to open the report in a separate window.

    The functional report displays the results of the test run for each configured browser.

Results

You have run the test suite on multiple browsers and devices.