Repository files navigation

Windows Application Driver (WinAppDriver) is a service to support Selenium-like UI Test Automation on Windows Applications. This service supports testingUniversal Windows Platform (UWP),Windows Forms (WinForms),Windows Presentation Foundation (WPF), andClassic Windows (Win32) apps onWindows 10 PCs.

1. Download Windows Application Driver installer fromhttps://github.com/Microsoft/WinAppDriver/releases
2. Run the installer on a Windows 10 machine where your application under test is installed and will be tested
3. EnableDeveloper Mode in Windows settings
4. RunWinAppDriver.exe from the installation directory (E.g.C:\Program Files (x86)\Windows Application Driver)

Windows Application Driver will then be running on the test machine listening to requests on the default IP address and port (127.0.0.1:4723). You can then run any of ourTests orSamples.WinAppDriver.exe can be configured to listen to a different IP address and port as follows:

WinAppDriver.exe 4727WinAppDriver.exe 10.0.0.10 4725WinAppDriver.exe 10.0.0.10 4723/wd/hub

Note: You must runWinAppDriver.exe asadministrator to listen to a different IP address and port.

Now that you've successfully installed WinAppDriver, you can get started withauthoring your first automation script!

Seehere for a list of supported APIs by WinAppDriver. API support may differ from Appium and other counterparts.

Additional documentation on WinAppDriver and related topics can be found under/Docs/, such as the following:

• Frequently Asked Questions
  • General Development & Best Practices
  • Using with Appium
• Running WinAppDriver in CI (with Azure Pipelines)
• Using UI Recorder
• Authoring Test Scripts
• Using the Selenium Grid
• Running On a Remote Machine

This repository includes the following content:

• Samples - used to showcase various commands and operations such as opening applications, finding elements, clicking elements, typing keystrokes, reading texts, etc; and can be run against built-in Windows 10 applications such asAlarms & Clock,Calculator, andNotepad.
• Tests - used to verify the functionality ofWindows Application Driver itself. The tests cover each API endpoints extensively and also against all basic UI control scenario, and demonstrate how to invoke certain command in C#. In addition, they show how to interact with some more complex UI elements such asDatePicker,SplitViewPane,Slider, etc.
• UI Recorder - standalone tool that aims to provide users a simpler way of creating automaton scripts by recording UI events performed by the user and generating XPath queries and C# code on the fly. Read more about it on ourWiki.
• Docs - subdirectory hosting WinAppDriver related documentation.

Add your feature request inissues or 👍 (+1) existing issues labeled asEnhancement