MonkeyTalk Modifiers

MonkeyTalk Modifiers:

Modifiers are optional in command, you can use it when you needed.

Modifiers can be written as %name=value. Where the % prefix identifies it as a Modifier. There are various types of modifiers are available in MaonkeyTalk.

• %timeout
• %thinktime
• %retrydelay
• %ignore

1. %timeout Modifier:

%timeout Modifier is used for how long in ms to continue retrying a command before timing out.Written as %timeout=TIME_IN_MILLISECONDS.

Use of %timeout Modifier:

Button LOGIN Verify LOGIN %timeout=3000

2. %thinktime Modifier:

%thinktime Modifier is used for how long in ms to wait before executing the command for the first time.You can use this modifier to simulate human reaction time.

Written as %thinktime=TIME_IN_MILLISECONDS.

Use of %thinktime Modifier:

Button LOGOUT tap %thinktime =3000

3. %retrydelay :

%retrydelay is used for how long in ms to delay between retry attempts.

Written as %retrydelay=TIME_IN_MILLISECONDS.

Use of % retrydelay Modifier:

Button LOGOUT tap %retrydelay

4. %ignore Modifier:

%ignore modifier” can skip commands. It can also skip tests and setup/teardown on individual tests within the suite.

Use of %ignore Modifier:

Suppose you want to ignore the command then add the “%ignore=true” as argument at the end of the command.

For example: Label * Verify “Welcome, test!”  %ignore=true

If you want to ignore a Test in a test suite then use

Test Script.mt Run %ignore=true

You can use same for SetUp and TearDown.

A Simple Script which having all these modifiers is given below:

In MonkeyTalk Form:

Input username tap

Input username EnterText test

Input password EnterText test

Button LOGIN Verify LOGIN %timeout=3000

Button LOGIN tap %thinktime=2000

Label * Verify “Welcome, test!” %thinktime=3000

Button LOGOUT Verify LOGOUT %thinktime=3000

Button LOGOUT tap %retrydelay

Result:

17:37:31.168: Connection set to Android Emulator or Tethered Device

17:37:42.725: Started Script Playback

17:37:42.733: Input username tap

17:37:43.455: Input username EnterText test

17:37:44.159: Input password EnterText test

17:37:44.956: Button LOGIN Verify LOGIN %timeout=3000

17:37:45.666: Button LOGIN tap %thinktime=2000

17:37:47.918: Label * Verify “Welcome, test!” %thinktime=3000

17:37:52.226: Button LOGOUT Verify LOGOUT %thinktime=3000

17:37:55.367: Button LOGOUT tap %retrydelay

17:37:56.133: Completed Script Playback – OK

You can also view tabular form of this Script in below given screenshot:

</

MonkeyTalk Command

MonkeyTalk Command:

MonkeyTalk Commands are very easy to understand. Even non programmer can easily  understands the MonkeyTalk commands.

MonkeyTalk commands are newline terminated and have the following syntax:
ComponentType  MonkeyId  Action  Argumets  Modifiers

These all are parts of MonkeyTalk commands. ComponentType.Action is known as the command name. MonkeyTalk command are terminated by new line.

Description of each part of MonkeyTalk command:

ComponentType:

This part ofMonkeyTalk command is required field i.e. mandatory field. In this part you have to mention the type of component on which we want to perform action. For example Button, Slider, Spinner etc. Component types are not case sensitive.

MonkeyId:

• This part ofMonkeyTalk command is also a required field i.e. mandatory field. An identifier that is used to distinguish between components of the same type being displayed simultaneously.
• Monkeytalk ids are case sensitive.
• MonkeyId can be specified as asterisk (*), which finds the first matching component.
• MonkeyId’s can also be specified as a 1-based (not zero-based) index of the form #N.

Action:

This part ofMonkeyTalk command is also a required field i.e. mandatory field. In this field you have to mention the action to be performed. Examples Tap, Select, Drag, Swipe, EnterText. Actions are not case sensitive.

Arguments:

This part ofMonkeyTalk command is not a required field. It is required according to ComponentType and Action .Arguments are separated by space. If an Argument is required but not specified,it takes on a default value.

Modifiers:

It is an optional field. There are three system-defined modifiers:

• %timeout – how long in ms to continue retrying a command before timing out
• %thinktime – how long in ms to wait before executing the command for the first time
• %retrydelay – how long in ms to delay between retry attempts

IMPORTANT POINTS (points to be remembered)

• MonkeyIds and Args are case-sensitive, but CommandTypes and Actions are not.
• All tokens are space-separated.
• Values with embedded blanks must be enclosed in quotes.

Example:

Tap on a button with label login:

In MonkeyTalk i.e. in .mt form

Button LOGIN tap %thinktime=3000

In javascript form i.e. in .js

this.app.button(“LOGIN”).tap({thinktime:”3000″});

Where button is componenttype, login is monkeyid and Tap is action and thinktime is modifier.