windows-app

Automate Windows applications.

This module automatically tries to install Windows Application Driver when installed. You will need to enable developer mode yourself.

Install

npm install windows-app

Usage

const windowsApp = require("windows-app")
 
const {select, close} = await windowsApp("Microsoft.WindowsCalculator_8wekyb3d8bbwe!App") // Calculator app
 
await select.name_("One").click()
await select.name_("Plus").click()
await select.name_("Two").click()
await select.name_("Equals").click()
const result = Number((await select.accessibilityId("CalculatorResults").getText()).replace("Display is", ""))
 
console.log(`The result of 1 + 2 is ${result}`)
//=> "The result of 1 + 2 is 3"
 
await close()

API

windowsApp(appId, options?)

Launch the specified application and provide options to manipulate it.

Only one application can be launched at a time.

appId

Type: string

The path to an exe file or the id of a UWP.

options

Type: object

timeout

Type: integer | false
Default: 10000

The timeout for interactions with elements and application startup in milliseconds. Set to false to disable.

Return value

select(selector)

select.xPath(xPath)

select.class(class_)

select.id(id)

select.name_(name)

select.accessibilityId(accessibilityId)

Select an element in the launched application.

driver

The selenium-appium driver.

close()

Close the application and end all associated processes. Returns a promise that resolves when completed.

Tips

• Use Accessibility Insights to inspect applications in order to get element names.