Parentheses

Relevant for: GUI actions, scripted GUI components, and function libraries

When programming in VBScript, it is important that you follow the rules for using or not using parentheses () in your statements. You must use parentheses around method arguments if you are calling a method that returns a value and you are using the return value.

For example, use parentheses around method arguments if you are returning a value to a variable, if you are using the method in an If statement, or if you are using the Call keyword to call an action or function. When working with actions, you also need to add parentheses around the name of a checkpoint if you want to retrieve its return value.

Tip: If you receive an Expected end of statement error message when running a step, it may indicate that you need to add parentheses around the arguments of the step's method.

Example: Following are several examples showing when to use or not use parentheses.

The following example requires parentheses around the method arguments for the ChildItem method because it returns a value to a variable:

Set WebEditObj = Browser("Mercury Tours").Page("Method of Payment").WebTable("FirstName").ChildItem (8, 2, "WebEdit", 0)
WebEditObj.Set "Example"

The following example requires parentheses around the method arguments because Call is being used:

Call RunAction("BookFlight", oneIteration)

or

Call MyFunction("Hello World")
...
...

The following example requires parentheses around the WaitProperty method arguments because the method is used in an If statement:

If Browser("index").Page("index").Link("All kinds of").WaitProperty("attribute/readyState", "complete", 4) 
Then 
	Browser("index").Page("index").Link("All kinds of").Click
End If

The following example requires parentheses around the Check method arguments, since it returns the value of the checkpoint:

a = Browser("MyBrowser").Page("MyPage").Check (CheckPoint("MyProperty"))

The following example does not require parentheses around the Click method arguments because it does not return a value:

Browser("Mercury Tours").Page("Method of Payment").WebTable("FirstName").Click 3,4