Finding Objects on Web Pages in Hybrid Applications

TestComplete recognizes individual elements of web pages displayed in hybrid mobile applications and provides a number of search methods you can use. These methods are the same as those used to find web page elements in standard web browsers.

Keep in mind that the object hierarchy of hybrid mobile applications differs from that of web browsers. Namely, the Page object is obtained in a different way:

• When testing a web page in a browser, the path to the Page object looks like this:

  JavaScript, JScript

  Python

  VBScript

  DelphiScript

  C++Script, C#Script

  JavaScript, JScript

  // Using a mapped name
  page = Aliases.browser.pageExampleDomain;
  // Without name mapping
  page = Sys.Browser().Page("http://www.example.com");

  Python

  # Using a mapped name
  page = Aliases.browser.pageExampleDomain;
  # Without name mapping
  page = Sys.Browser().Page("http://www.example.com");

  VBScript

  ' Using a mapped name
  Set page = Aliases.browser.pageExampleDomain
  ' Without name mapping
  Set page = Sys.Browser().Page("http://www.example.com")

  DelphiScript

  // Using a mapped name
  page := Aliases.browser.pageExampleDomain;
  // Without name mapping
  page := Sys.Browser().Page('http://www.example.com');

  C++Script, C#Script

  // Using a mapped name
  page = Aliases["browser"]["pageExampleDomain"];
  // Without name mapping
  page = Sys["Browser"]()["Page"]("http://www.example.com");

• Whereas in hybrid mobile applications, the path looks like this:

  • For Android applications:

    JavaScript, JScript

    Python

    VBScript

    DelphiScript

    C++Script, C#Script

    JavaScript, JScript

    // Using a mapped name
    page = Aliases.Device.Process_hybridapp.RootLayout.Layout_webView1.pageExampleDomain;
    // Without name mapping
    page = Mobile.Device("Nexus 7").Process("com.example.hybridapp").RootLayout("").WebView("webView1").Page("http://example.com/");

    Python

    # Using a mapped name
    page = Aliases.Device.Process_hybridapp.RootLayout.Layout_webView1.pageExampleDomain;
    # Without name mapping
    page = Mobile.Device("Nexus 7").Process("com.example.hybridapp").RootLayout("").WebView("webView1").Page("http://example.com/");

    VBScript

    ' Using a mapped name
    Set page = Aliases.Device.Process_hybridapp.RootLayout.Layout_webView1.pageExampleDomain
    ' Without name mapping
    Set page = Mobile.Device("Nexus 7").Process("com.example.hybridapp").RootLayout("").WebView("webView1").Page("http://example.com/")

    DelphiScript

    // Using a mapped name
    page := Aliases.Device.Process_hybridapp.RootLayout.Layout_webView1.pageExampleDomain;
    // Without name mapping
    page := Mobile.Device('Nexus 7').Process('com.example.hybridapp').RootLayout('').WebView('webView1').Page('http://example.com/');

    C++Script, C#Script

    // Using a mapped name
    page = Aliases["Device"]["Process_hybridapp"]["RootLayout"]["Layout_webView1"]["pageExampleDomain"];
    // Without name mapping
    page = Mobile["Device"]("Nexus 7")["Process"]("com.example.hybridapp")["RootLayout"]("")["WebView"]("webView1")["Page"]("http://example.com/");

  • For iOS applications:

    JavaScript, JScript

    Python

    VBScript

    DelphiScript

    C++Script, C#Script

    JavaScript, JScript

    // Using a mapped name
    page = Aliases.Device.Process_hybridapp.Window0.WebView0.pageExampleDomain;
    // Without name mapping
    page = Mobile.Device("John Smith iPad").Process("SampleHybridApp").Window(0).WebView(0).Page("http://example.com/");

    Python

    # Using a mapped name
    page = Aliases.Device.Process_hybridapp.Window0.WebView0.pageExampleDomain;
    # Without name mapping
    page = Mobile.Device("John Smith iPad").Process("SampleHybridApp").Window(0).WebView(0).Page("http://example.com/");

    VBScript

    ' Using a mapped name
    Set page = Aliases.Device.Process_hybridapp.Window0.WebView0.pageExampleDomain
    ' Without name mapping
    Set page = Mobile.Device("John Smith iPad").Process("SampleHybridApp").Window(0).WebView(0).Page("http://example.com/")

    DelphiScript

    // Using a mapped name
    page := Aliases.Device.Process_hybridapp.Window0.WebView0.pageExampleDomain;
    // Without name mapping
    page := Mobile.Device('John Smith iPad').Process('SampleHybridApp').Window(0).WebView(0).Page('http://example.com/');

    C++Script, C#Script

    
    // Using a mapped name
    page = Aliases["Device"]["Process_hybridapp"]["window"]["0"]["pageExampleDomain"];
    // Without name mapping
    page = Mobile["Device"]("John Smith iPad")["Process"]("SampleHybridApp")["window"](0)["WebView"](0)["Page"]("http://example.com/");

The object hierarchy below the Page object (that is, the elements of the displayed web page) is identical for the web and hybrid mobile applications. See Addressing Objects in Hybrid Mobile Applications.

Taking into account these differences, you can search for web page elements using the same methods and techniques that you use for web browsers:

Notes on Working With FRAMEs

• For Android 4.1 or later: if a page is loaded from a local drive (not from the Web), then to access elements in its frames, you need to enable the Update WebView settings to allow access to frame elements setting. To view or change the setting, open the Open Applications | Hybrid mobile category of the project properties.

• TestComplete does not support using XPath expressions for searching web objects in nested frames.

See Also

Common Tasks for Hybrid Mobile Application Testing
Testing Hybrid Mobile Applications - Overview