Arguments
The argument types used in the Target and Value fields of the commands.
| Argument | Description |
|---|---|
| alert text | text to check |
| answer | The answer to give in response to the prompt pop-up |
| array variable name | The name of a variable containing a JavaScript array |
| attribute locator | An element locator followed by an @ sign and then the name of the attribute, e.g. “foo@bar” |
| conditional expression | JavaScript expression that returns a boolean result for use in control flow commands |
| coord string | Specifies the x,y position (e.g., - 10,20) of the mouse event relative to the element found from a locator |
| expected value | The result you expect a variable to contain (e.g., true, false, or some other value) |
| expression | The value you’d like to store |
| form locator | An element locator for the form you want to submit |
| free text value | The functions in the free text value to execute in order. |
| iterator variable name | The name of the variable used when iterating over a collection in a looping control flow command (e.g., for each) |
| json | A string representation of a JavaScript object |
| key sequence | A sequence of keys to type, can be used to send key strokes (e.g. ${KEY_ENTER}) |
| locator | An element locator |
| locator of drag destination object | The locator of an element whose location (e.g., the center-most pixel within it) will be the point where locator of object to be dragged is dropped |
| locator of object to be dragged | The locator of element to be dragged |
| loop limit | Maximum number of times a looping control flow command can execute to protect against infinite loops |
| message | The message to print |
| option | An option locator, typically just an option label (e.g. “John Smith”) |
| region | Specify a rectangle with coordinates and lengths (e.g., “x: 257, y: 300, width: 462, height: 280”) |
| resolution | Specify a window resolution using WidthxHeight. (e.g., 1280x800) |
| script | The JavaScript snippet to run |
| select locator | An element locator identifying a drop-down menu |
| test case | Test case name from the project |
| text | An exact string match. |
| text | The text to verify |
| times | The number of attempts a times control flow loop will execute the commands within its block |
| transaction name | The name of the transaction (e.g.: addItemToBasket). |
| transaction value | The value assigned to that transaction. It is made up of the major threshold value, the critical threshold value, the description of the transaction (e.g. 1.2, 1.5, “add item to basket”). |
| url | The URL to open (may be relative or absolute) |
| value | The value to type |
| variable name | The name of a variable (without brackets). Used to either store an expression’s result in or reference for a check (e.g., with ‘assert’ or ‘verify’) |
| variable name | The name of a variable (without brackets). Used to either store an expression’s result in or reference for a check (e.g., with ‘assert’ or ‘verify’) |
| wait time | The amount of time to wait (in milliseconds) |
| window handle | A handle representing a specific page (tab, or window) |
| xpath | The xpath expression to evaluate |
Variables
Commands such as store, store text or execute script save a value in a variable named by their Value field. Use it in any later field as ${name}, for example ${myVar} === "a" in a condition.
See also
- Commands — every command and the arguments it takes
- Control flow — conditional expressions and loops