NetworkSuite.WaitForState Method

Applies to TestComplete 15.65, last modified on July 17, 2024
The Network Suite functionality is deprecated. We don’t recommend using it for distributed testing. Consider using a CI/CD system for managing distributed tests. See Migrating Distributed Tests to CI/CD Systems for details. In case you need to run web tests on multiple environments in parallel, you can also try using your project’s Execution Plan.


The WaitForState method delays script execution until the network suite in the current project reaches the specified state, unless a specified time limit is reached first.


NetworkSuite.WaitForState(State, WaitTime)

State [in]    Required    Integer    
WaitTime [in]    Optional    Integer Default value: 0   
Result Boolean

Applies To

The method is applied to the following object:


The method has the following parameters:


Specifies the network suite’s state to be waited for. Read the Network Suite States topic to learn about available network suite states.


Sets the time limit in milliseconds. 0 means indefinite time limit.

Result Value

True if the expected state is reached, and False otherwise.


Use the NetworkSuite.State property in order to simply check the state of the Network Suite in the current project.


The following script halts the network suite’s execution if it does not stop on its own for a specified period.

JavaScript, JScript

if (! NetworkSuite.WaitForState(ns_Idle, 600000))


if not NetworkSuite.WaitForState(ns_Idle, 600000):


If Not NetworkSuite.WaitForState(ns_Idle, 600000) Then
End If


if not NetworkSuite.WaitForState(ns_Idle, 600000) then

C++Script, C#Script

if (! NetworkSuite["WaitForState"](ns_Idle, 600000))

See Also

Distributed Testing
OnNetSuiteStateChange Event
WaitForNetVarChange Method
State Property

Highlight search results