Beginner's guide on how to use TESTAR

Initial pop-up window to select TESTAR settings

The first time we launch TESTAR, the tool does not know which protocol and settings use by default.
This pop-up window will appear to select a default protocol.

generic protocols are used for Windows Desktop applications (Windows OS-dependent).
webdriver protocols are used for Web applications (OS independent).

We recommend selecting desktop_generic if you are going to try TESTAR for the first time.
Don't worry if you already selected another protocol, you can change it in the General settings panel of the GUI.

Starting up TESTAR for Windows Desktop applications

Setting to connect with Windows Notepad

• Select desktop_generic protocol
• Go to General settings panel
• Select COMMAND_LINE SUT connector -> To launch the System Under Test using a command line
• Indicate SUT path C:\windows\system32\notepad.exe -> TESTAR will execute by cmd and connect to notepad.exe process
• Number of Sequences: 1 -> TESTAR will execute Notepad 1 time
• Sequence actions: 5 -> TESTAR will execute 5 actions (click, type, drag, etc...)

SPY Windows Notepad

Spy mode will execute the SUT to allow the user to inspect which widgets and actions are detected by TESTAR.
Click next button to start the Spy mode:

TESTAR will launch Notepad:

• Green dots over widgets are click actions that TESTAR is able to execute
• Grey dots over widgets indicate that those widgets are filtered, then TESTAR will not execute a click action
• Blue texts are type actions

Move the mouse over the widgets to inspect the properties that TESTAR is able to detect.
Use Shift + Up keyboard command to show more or fewer properties. Close Notepad or use Shift + Down keyboard command to stop TESTAR Spy mode

Generate tests with Windows Notepad

Generate mode will launch the SUT and automatically execute actions to explore and test the system.
Click next button to start the Generate mode:

You can execute more sequences or actions by changing:

• Number of Sequences: 1
• Sequence actions: 5

The output results of TESTAR are saved in testar\bin\output\2022-0X-YY_HHhMMmSSs_notepad folder.
HTMLreports contains visual information about the executed actions and SUT states.