Skip to main content

Windows Record Utility in Katalon Studio

important
  • Starting from Katalon Studio 10.4.0, Windows Desktop app testing is officially available. We are using a new custom driver based on the FlaUI library, which supports spy, record, and execution of test cases—no separate installation required.
  • For full details on feature availability and version support, see the Katalon Studio Release Notes: Version 10.x.

Katalon Studio provides the Windows record utility that allows you to record and playback actions performed in a Windows desktop application. With this utility, you can quickly create a test case, and later manually enhance the test.

This article introduces you to the components of the Windows record utility in Katalon Studio.

Requirements​

  • WinAppDriver is running on the test machine. To learn how to set up and run WinAppDriver, see: Set up WinAppDriver.

The Windows record utility​

note

In Katalon Studio 11.1.0 and later, if Windows Recorder cannot start because Katalon Studio fails to check whether the local FlaUI server has started, manually start the FlaUI driver and set Desktop Driver URL as a workaround. See Unable to start Windows Recorder due to FlaUI status check failure.

To open the utility, from the main toolbar, click on Record Windows Action.

Spy Windows Objects icon

The Windows Action Recorder dialog is displayed as below:

Windows Action Recorder dialog

Configurations​

In the CONFIGURATIONS section, you can specify:

  • Configuration: the WinAppDriver URL and desired capabilities.

  • Application File: the absolute path to the Windows executable file (*.exe) of the testing machine. For Windows users, click on the Browse... button to locate the application file.

Recorded actions​

After you interact with the application under test (AUT) using the built-in actions, the recorded actions are displayed in the Recorded Actions tab.

Recorded Actions tab

Captured objects​

During a recording session, the captured Windows objects are displayed in the Captured Objects tab. You can view and edit the object name, locator and properties.

Captured Objects tab

You can modify the locator of an object in Object Properties and click Highlight to verify if the new locator correctly identifies the associated object.

note

Starting from version 10.4.3, Katalon Studio supports more locators for Windows objects. View supported locators at Windows Test Objects - Locator Strategies

Screen View​

The Screen View shows the application screenshots taken when you press the Start button to record or the Refresh Screen button to recapture the application images. The size of a captured screenshot is the same as the displayed application window on the testing machine.

Screen view

Screen Objects​

The Screen Objects section shows a tree of all Windows objects you can interact with. To update this tree view, you can press the Refresh Screen button.

The selected object is highlighted with a green border on the Screen View.

Object highlighted in the Screen View

Possible Actions​

The Possible Actions provides the built-in Windows actions that you can use to interact with the AUT.

Possible actions

There are two types of Windows actions:

  • Object action: an action that you can perform on a specific Windows object. This type of action requires you to first select the target object on the Screen Objects, e.g., performing the Click action on a menu item.

  • Application action: an action for interacting with the application, e.g., the Close Application action.

Export Option​

When you finish the recording session, there are three options to export the recorded actions to a test case:

  • Export to new test case (selected by default).
  • Append to test case.
  • Overwrite test case.

Export actions dialog

Was this page helpful?

Table of Contents