Testing Mobile Web Applications Using Emulator - Tutorial

Applies to TestComplete 15.51, last modified on May 25, 2023

This tutorial will walk you through creating a cross-browser mobile web test. We will record a simple keyword test for a sample application, services.smartbear.com/samples/TestComplete15/smartstore/, and configure the test to run it in different mobile browsers. The test will search the online store for ball and verify that the first link in the search results points to the All-Court Basketball item.


To complete this tutorial, you need the following:

  • A license for the TestComplete Web module.

  • The Web Testing and Chrome Support plugins (they are part of the Web module).

  • Google Chrome 114, configured as described in the Preparing Chrome for Web Testing topic.

    If you have a TestComplete version earlier than 12.42, your version of the SmartBear Test Extension will be incompatible with newer versions of the Chrome web browser. To test web applications in Chrome 114, you will have to upgrade your TestComplete to some later version. We recommend using version 15.51.

    If you use a later version of Google Chrome, check whether a patch is available for it.

1. Recording a Mobile Web Test

We will start with recording a keyword test using the iPhone X emulator.

  1. If Chrome is running, close it.

  2. Select Test > Record > Record Keyword Test from the TestComplete main menu to start test recording.

  3. Expand the Recording toolbar and select Apple iPhone X from the drop-down list of mobile browser emulators:

    Mobile browser list on the Recording toolbar

    TestComplete will launch Chrome in the iPhone X emulation mode. In this mode, Chrome simulates the iPhone X browser’s user agent and screen resolution.

  4. Navigate to https://services.smartbear.com/samples/TestComplete15/smartstore/ in the Chrome address bar.

    You can see that Chrome displays the web page content with a limited width – the same width it would have if it were displayed in iPhone X browser.

    Emulated browser width
  5. Enter ball in the Search box and click .

  6. Create a property checkpoint for verifying the text of the first item in the search results:

    • Click Add Check on the Recording toolbar.

      Creating a checkpoint
    • TestComplete will open the Checkpoint wizard.

      Click Object property to create a property checkpoint.

    • Select the text All-Court Basketball on the web page using one of the options suggested in the wizard.

      Option Description

      Drag the target to an object

      Click and drag the target glyph to the object you want to select, and then release the mouse button.

      Point and press the shortcut (SHIFT+CTRL+A)

      Click , hover the mouse pointer over the object you want to select, and press SHIFT+CTRL+A.

      Selecting web page object to check

      Click Next.

    • Select the contentText property. If it is not in the list, click More Properties to view all the properties.

    • Click Next, and then Finish.

  7. Close the browser and stop the recording.

2. Viewing the Recorded Test

Take a look at the recorded test:

Recorded mobile web test

The test consists of operations (steps) - user actions, checkpoints, and various utility operations:

  • The first operation, Run Virtual Browser, launches the mobile browser emulator. The emulator will simulate iPhone X browser.

  • The browser.ToUrl operation opens the SmartStore web site in the emulator.

  • The pageServicesSmartbearComSamplesT2.Wait operation waits until the SmartStore main page is loaded.

  • The Click and SetText operations enter ball in the Search box. The ClickButton operation clicks the Search button.

  • Another Wait operation waits until the search results page is loaded.

  • The Property Checkpoint operation checks that the first item in the search results contains the expected text.

  • Finally, the BrowserWindow.Close operation closes the mobile browser emulator.

3. Running the Recorded Test

Before modifying the recorded test, run it to make sure it works as expected. To run the test, click Run on the toolbar of the keyword test editor. TestComplete will play back the test in the same mobile browser emulator – iPhone X – that we used for test recording.

The test has passed, so you can proceed.

The results of a passed mobile web test

If your test ran with errors, examine and fix the errors to make the test pass. You can also try recording the test anew using the same steps as before.

4. Making the Test Cross-Browser

Currently, the test runs in the iPhone X emulator – as it was recorded. Modify the test so that it runs in different mobile browser emulators, one after another.

  1. Add the Virtual Browser Loop operation at the beginning of the test.

    Adding the Virtual Browser Loop operation to a keyword test

    In the resulting dialog, specify the operation parameters:

  2. Delete the Run Virtual Browser and browser.ToUrl operations from the test. They are not needed anymore, because the Virtual Browser Loop operation launches mobile browser emulators and navigates to the URL.

  3. Select all the test operations that go after the Virtual Browser Loop operation and click to move them inside the loop. Now these operations will be executed on each loop iteration.

    Here is what the resulting test should look like:

    Cross-browser mobile web test
  4. Save the test by selecting File > Save from the TestComplete main menu.

Now run the resulting test.

TestComplete will repeat the test operations several times. Each time, the tested web site will be opened in a different mobile browser emulator.

The test log contains information about which mobile browser emulators were launched and the results of the test operations performed in each browser.

The results of a cross-browser mobile web test


Creating mobile web tests with TestComplete is really easy. You can record tests in the mobile browser emulator without having to write any code. You can use TestComplete to emulate various smartphone and tablet browsers and run tests in multiple browsers for device compatibility testing.

To learn more about mobile web testing with TestComplete, see the following topics:

See Also

Testing Mobile Web Applications Using Emulator - Overview
Creating Cross-Browser Mobile Web Tests Using Emulator
Creating Mobile Browser Profiles

Highlight search results