When testing mobile applications, you may need to delay the test execution until an application object is in a specific state. For example, your test may need to wait until a control in the application is enabled before simulating user actions against it.
If your tested application is Open, TestComplete adds a number of custom properties and methods to objects that can help you determine an object’s state.
To delay your test execution until an object has a specific property value, use the WaitProperty method. TestComplete adds this method to all the tested objects. The method delays the test execution until the specified property of the object (it can be either a native property or a property added by TestComplete) takes the specified value or until the timeout elapses.
The code below demonstrates how to delay the test execution until a button in the tested mobile application is enabled:
JavaScript, JScript
function Test()
{
Mobile.SetCurrent("MyDevice");
ImageRepository.launcher.DemoApp.Touch();
// ...
var btn = Mobile.Device("MyDevice").Process("smartbear.example.demoapp").Layout("NO_ID").Button("btnClick");
if (btn.WaitProperty("Enabled", true, 10000))
{
// The button is enabled
// ...
}
else
{
// The button is disabled
// ...
}
}
Python
def Test():
Mobile.SetCurrent("MyDevice");
ImageRepository.launcher.DemoApp.Touch();
# ...
btn = Mobile.Device("MyDevice").Process("smartbear.example.demoapp").Layout("NO_ID").Button("btnClick");
if (btn.WaitProperty("Enabled", True, 10000)):
# The button is enabled
# ...
else:
# The button is disabled
# ...
VBScript
Sub Test
Mobile.SetCurrent("MyDevice")
ImageRepository.launcher.DemoApp.Touch
' ...
Set btn = Mobile.Device("MyDevice").Process("smartbear.example.demoapp").Layout("NO_ID").Button("btnClick")
If btn.WaitProperty("Enabled", true, 10000) Then
' The button is enabled
' ...
Else
' The button is disabled
' ...
End If
End Sub
DelphiScript
procedure Test();
var btn;
begin
Mobile.SetCurrent('MyDevice');
ImageRepository.launcher.DemoApp.Touch();
// ...
btn := Mobile.Device('MyDevice').Process('smartbear.example.demoapp').Layout('NO_ID').Button('btnClick');
if btn.WaitProperty('Enabled', true, 10000) then
begin
// The button is enabled
// ...
end
else
begin
// The button is disabled
// ...
end;
end;
C++Script, C#Script
function Test()
{
Mobile["SetCurrent"]("MyDevice");
ImageRepository["launcher"]["DemoApp"]["Touch"]();
// ...
var btn = Mobile["Device"]("MyDevice")["Process"]("smartbear.example.demoapp")["Layout"]("NO_ID")["Button"]("btnClick");
if (btn["WaitProperty"]("Enabled", true, 10000))
{
// The button is enabled
// ...
}
else
{
// The button is disabled
// ...
}
}
See Also
Checking Object State
Testing Android Open Applications
Testing Android Applications