1. Docs
  2. Reference
  3. Step reference
  4. Desktop actions

Desktop actions

Desktop projects test Windows and macOS applications through an agent on the machine where the app runs. This page lists every desktop action type and the value each one needs.

3 min read Updated CustomersAdmins

In short

On this page you can

  • Click, double-click, right-click and hover controls of a desktop app.
  • Type text, type key by key for password fields, and press shortcuts such as Ctrl+S.
  • Check that a control is visible, exists, is enabled or is checked.
  • Read a control’s text or attribute into a variable.
  • Launch or close the app, switch or maximize windows, take screenshots.

How to use it

  1. Start the SmartTest agent on the machine that has the app.
  2. Capture controls with the Desktop Recorder, or pick saved actions with Action.
  3. Add locator-free steps such as Press Enter or Wait 2 Seconds with Global.
  4. Fill each step’s value: text, key, option, variable name or window title.
  5. Save and run a Dry Run on the agent.

How desktop steps are created#

The types below exist only in DESKTOP projects. Shared step types (Assertion, Python, API, Database, Mail, Kafka, Global parameter, Wait (seconds), AI, JMeter, k6) work here too. JavaScript and Network are not available in desktop projects.

Mouse#

ActionDoesValue
ClickClicks a desktop control.—
Double ClickDouble-clicks a control.—
Right ClickRight-clicks a control (opens the context menu).—
HoverMoves the mouse over a control.—

Input and keys#

ActionDoesValue
Type TextTypes text into a control.The text
ClearClears the value of a control.—
Clear & TypeClears the control, then types.The text
Type Key by KeyTypes with the real keyboard, one key at a time. Use it for password fields and fields that reject pasted or bulk input.The text
Press KeyPresses a key or a combination.Enter, Tab, Esc, Ctrl+S, Alt+F4
SelectSelects an option in a combo box or list.The option

Scrolling and waits#

ActionDoesValue
ScrollScrolls with the mouse wheel.Direction: up, down, left, right
Scroll To ElementScrolls until the control is visible.—
Wait For ElementWaits until the control exists.—
Wait For VisibleWaits until the control is visible.—
WaitWaits for the given number of seconds.Seconds

The shared Wait (seconds) step does the same as Wait and is the one to use in new steps.

Assertions#

ActionPasses whenValue
Assert VisibleThe control is visible.—
Assert Not VisibleThe control is not visible.—
Assert ExistsThe control exists.—
Assert Not ExistsThe control does not exist.—
Assert EnabledThe control is enabled.—
Assert CheckedThe checkbox or toggle is checked.—
Assert TextThe control’s text equals the expected value.The expected text

The Desktop Recorder offers the most used types. Wait For Element, Assert Exists, Assert Not Exists, Assert Text and Store Variable are not in its menu because other types cover them (Wait For Visible, Assert Visible, Assert Not Visible, Get Text plus an Assertion), but existing steps of these types keep running.

Read values#

ActionDoesYou fill
Get TextReads the control’s text into a variable.The variable name
Get AttributeReads a control attribute into a variable.The variable name and the attribute
Store VariableStores a value in a variable.The variable name and the value

Later steps read the value as {{tc:name}} or pick it with Insert step variable. These steps accept the per-step Timeout (1–300 seconds).

App and window#

ActionDoesValue
Launch AppLaunches the application under test (from the project’s desktop settings).—
Close AppCloses the application under test.—
Switch WindowSwitches to the window whose title contains the value.Part of the window title
Maximize WindowMaximizes the current window.—
ScreenshotTakes a screenshot for the report.—

Global desktop actions#

Global opens Global Desktop Actions: “Ready-made desktop steps that need no element (keys, wait, app/window)”. Click Add to step list on a row.

Global actionType and value
Press Enter, Press Tab, Press EscapePress Key: Enter, Tab, Esc
Save (Ctrl+S)Press Key: Ctrl+S
Wait 2 SecondsWait: 2
Scroll Down, Scroll UpScroll: down, up
Launch App, Close AppLaunch App, Close App
Maximize WindowMaximize Window
Take ScreenshotScreenshot

At run time#

If something goes wrong#

Didn’t find your answer?Write to support with your project name and what you see on screen.

info@smartestqa.ai
© 2026 Selenity Technology · SmartestQAsmartestqa.aiThis page as MarkdownChecked against smarttest-fe predev 2a8c79cc, smarttest-be 633c2a03, smarttest-testsuite 017fcec