Selenium driver for WinForms applications

Any contributions are welcomed :)

This project is using

• Windows Automation
• Nancy as the webserver
• XPathParser for parsing XPath expressions (https://github.com/quamotion/XPathParser)
• Selenium.WebDriver.3.141.0 to get the internals of web driver (commands for Nancy endpoints for example)
• windowsphonedriver (https://github.com/forcedotcom/windowsphonedriver) for the basic infrastructure (commands & command handlers)

Why another driver when there already is https://github.com/Microsoft/WinAppDriver? The app I'm testing is quite large with number of elements and that driver was timing out after 60 seconds on some XPath queries (see this issue) and after putting everything together the query finished under 2 seconds.

Which Selenium commands are implemented?

• acceptAlert
• actions
• addCookie
• clearElement
• clickElement
• close
• deleteAllCookies
• deleteCookie
• describeElement
• dismissAlert
• elementEquals
• executeAsyncScript
• executeScript
• findChildElement
• findChildElements
• findElement
• findElements
• get
• getActiveElement
• getAlertText
• getCookies
• getCurrentUrl
• getCurrentWindowHandle
• getElementAttribute
• getElementLocation
• getElementLocationOnceScrolledIntoView
• getElementSize
• getElementTagName
• getElementText
• getElementValueOfCssProperty
• getOrientation
• getPageSource
• getSessionCapabilities
• getSessionList
• getTitle
• getWindowHandles
• getWindowPosition
• getWindowSize
• goBack
• goForward
• implicitlyWait
• isElementDisplayed
• isElementEnabled
• isElementSelected
• maximizeWindow
• mouseClick
• mouseDoubleClick
• mouseDown
• mouseMoveTo
• mouseUp
• newSession
• quit
• refresh
• screenshot
• sendKeysToActiveElement
• sendKeysToElement
• setAlertValue
• setOrientation
• setScriptTimeout
• setTimeout
• setWindowPosition
• setWindowSize
• status
• submitElement
• switchToFrame
• switchToWindow
• touchDoubleTap
• touchDown
• touchFlick
• touchLongPress
• touchMove
• touchScroll
• touchSingleTap
• touchUp
• uploadFile

XPath support:

• axes
  • Ancestor
  • AncestorOrSelf
  • Attribute
  • Child
  • Descendant
  • DescendantOrSelf
  • Following
  • FollowingSibling
  • Namespace
  • Parent
  • Preceding
  • PrecedingSibling
  • Self
  • Root
• predicates
  • position predicate //node[3]
  • attribute predicate //node[@attribute = 'X']
• operators
  • Or
  • And
  • Eq
  • Ne
  • Lt
  • Le
  • Gt
  • Ge
  • Plus
  • Minus
  • Multiply
  • Divide
  • Modulo
  • UnaryMinus
  • Union
• functions (https://developer.mozilla.org/en-US/docs/Web/XPath/Functions)
• boolean()
• ceiling()
• choose()
• concat()
• contains()
• count()
• current() XSLT-specific
• document() XSLT-specific
• element-available()
• false()
• floor()
• format-number() XSLT-specific
• function-available()
• generate-id() XSLT-specific
• id() (partially supported)
• key() XSLT-specific
• lang()
• last()
• local-name()
• name()
• namespace-uri()
• normalize-space()
• not()
• number()
• position()
• round()
• starts-with()
• string()
• string-length()
• substring()
• substring-after()
• substring-before()
• sum()
• system-property() XSLT-specific
• translate()
• true()
• unparsed-entity-url() XSLT-specific (not supported)

Add reference to Selenium.WebDriver (https://www.nuget.org/packages/Selenium.WebDriver/) and you are ready to go.

The driver is currently not able to start the system under test. You have to set process name in capapabilities. The IP address is currently hardwired to http://127.0.0.1:12345.

public static RemoteWebDriver CreateSession()
{
  DesiredCapabilities desktopCapabilities = new DesiredCapabilities();
  desktopCapabilities.SetCapability("processName", "<name of the process>");
  return new RemoteWebDriver(
    new CommandExec(new Uri("http://127.0.0.1:12345"), 
    TimeSpan.FromSeconds(60)), 
    desktopCapabilities);
}

Recommended element location is using XPath expression (though with a limited expression support)

var webBrowser = session.FindElement(By.XPath("//Pane[@AutomationId='webBrowser']"));

Windows in the Win application are not like windows in browser. The windows (ControlType.Window) can be nested inside the control tree, for example in a Tab element.

Window can be either located using XPath expression var window = session.FindElement(By.XPath("/Window/Pane/Window[@AutomationId='WindowName']")); or by switching to it session.SwitchTo().Window("WindowName");, in the first example you will get the element reference, in the other the internal context is switched to new window and elements cached during the following operations can be disposed when window is cloded session.Close().

Note that element wrappers like OpenQA.Selenium.Support.UI.SelectElement do not work because internally select and option elements are expected.