desktop

Nexial supports the automation of desktop application both in terms of performing actions by simulating keystrokes and mouse events. It uses Winium as the underlying automation engine. As such, Nexial currently does not support the automation of Java Swing applications or non-Windows applications.

To see a quick demo on Desktop Automation and to see Nexial in Action, check out the Nexial Desktop Automation on Notepad video.

If you are new to desktop automation via Nexial, please first familiarize yourself with the Basic Concept and Configuration.

Available Commands

• assertAttribute(locator,attribute,expected)
• assertChecked(name)
• assertDisabled(name)
• assertElementNotPresent(name)
• assertElementPresent(name)
• assertEnabled(name)
• assertHierCells(matchBy,column,expected,nestedOnly)
• assertHierRow(matchBy,expected)
• assertListCount(count)
• assertLocatorNotPresent(locator)
• assertLocatorPresent(locator)
• assertMenuEnabled(menu)
• assertModalDialogNotPresent()
• assertModalDialogPresent()
• assertModalDialogTitle(title)
• assertModalDialogTitleByLocator(locator,title)
• assertNotChecked(name)
• assertSelected(name,text)
• assertTableCell(row,column,contains)
• assertTableColumnContains(column,contains)
• assertTableContains(contains)
• assertTableRowContains(row,contains)
• assertText(name,expected)
• assertWindowTitleContains(contains)
• check(name)
• checkByLocator(locator)
• clear(locator)
• clearCombo(name)
• clearModalDialog(var,button)
• clearTextArea(name)
• clearTextBox(name)
• clickButton(name)
• clickByLocator(locator)
• clickCheckBox(name)
• clickElementOffset(name,xOffset,yOffset)
• clickExplorerBar(group,item)
• clickFirstMatchRow(nameValues)
• clickFirstMatchedList(contains)
• clickIcon(label)
• clickList(row)
• clickMenu(menu)
• clickMenuByLocator(locator,menu)
• clickOffset(locator,xOffset,yOffset)
• clickRadio(name)
• clickScreen(button,modifiers,x,y)
• clickTab(group,name)
• clickTableCell(row,column)
• clickTableRow(row)
• clickTextPane(name,criteria)
• clickTextPaneRow(var,index)
• closeApplication()
• collapseHierTable()
• contextMenu(name,menu,xOffset,yOffset)
• contextMenuByLocator(locator,menu,xOffset,yOffset)
• doubleClick(name)
• doubleClickByLocator(locator)
• editCurrentRow(nameValues)
• editHierCells(var,matchBy,nameValues)
• editTableCells(row,nameValues)
• focusFirstTableRow
• focusLastTableRow
• hideExplorerBar()
• login(form,username,password)
• maximize()
• minimize()
• mouseWheel(amount,modifiers,x,y)
• resize(width,height)
• rightClickElementOffset(name,xOffset,yOffset)
• rightClickOffset(locator,xOffset,yOffset)
• saveAllTableRows(var,csv)
• saveAttributeByLocator(var,locator,attribute)
• saveComboOptions(var,name)
• saveComboOptionsByLocator(var,locator)
• saveElementCount(var,name)
• saveFirstListData(var,contains)
• saveFirstMatchedListIndex(var,contains)
• saveHierCells(var,matchBy,column,nestedOnly)
• saveHierRow(var,matchBy)
• saveListData(var,contains)
• saveLocatorCount(var,locator)
• saveModalDialogText(var)
• saveModalDialogTextByLocator(var,locator)
• saveProcessId(var,locator)
• saveRowCount(var)
• saveTableRows(var,contains,csv)
• saveTableRowsRange(var,beginRow,endRow,csv)
• saveText(var,name)
• saveTextByLocator(var,locator)
• saveTextPane(var,name,criteria)
• saveWindowTitle(var)
• screenshot(name,file)
• screenshotByLocator(locator,file)
• selectCombo(name,text)
• sendKeysToTextBox(name,text1,text2,text3,text4)
• showExplorerBar()
• toggleExplorerBar()
• typeAppendTextArea(name,text1,text2,text3,text4)
• typeAppendTextBox(name,text1,text2,text3,text4)
• typeByLocator(locator,text)
• typeKeys(os,keystrokes)
• typeTextArea(name,text1,text2,text3,text4)
• typeTextBox(name,text1,text2,text3,text4)
• uncheck(name)
• uncheckByLocator(locator)
• useApp(appId)
• useForm(formName)
• useHierTable(var,name)
• useList(var,name)
• useTable(var,name)
• useTableRow(var,row)
• waitFor(name,maxWaitMs)
• waitForLocator(locator,maxWaitMs)