# Elm-WebDriver

`WebDriver` is a remote control interface that enables introspection and control of user agents. It provides a platform- and language-neutral wire protocol as a way for out-of-process programs to remotely instruct the behavior of web browsers.

`elm-webdriver` is framework that allows write scripts for `WebDriver` with plain [Node.js](https://nodejs.org/) runner that just executes compiled elm

## Suported Drivers

  - [ChromeDriver](http://chromedriver.chromium.org/)
  - [GeckoDriver](https://github.com/mozilla/geckodriver)
  - [Selenium Standalone Server](https://www.seleniumhq.org/download/)
  - [Appium](http://appium.io/)

# Setup

## Quick Start
```elm
import Task
import WebDriver
import WebDriver.Runner exposing (TestRunner, run)

suite : WebDriver.Test
suite =
    describe "Web Page Navigate"
        [ test "star elm-webdriver" <|
            \{ url, element, attribute } ->
                url "https://github.com/justgook/elm-webdriver"
                    |> Task.andThen (\_ -> "h1" |> Selector.css |> element)
                    |> Task.andThen (.value >> attribute "innerText")
                    |> Task.andThen (.value >> Expect.equal "justgook/elm-webdriver")
        ]

main : TestRunner
main = run suite
```

## Running From CLI

  >Note: To be able run from node you need install `XMLHttpRequest` replacement (node don't have build in). Install `xhr2` and append it:

  `var XMLHttpRequest = require(\"xhr2\");`

compile Your tests

`elm-make Main.elm --output=bundle.js`

and run compiled code

`node -e 'var XMLHttpRequest = require(\"xhr2\"); require(\"./bundle.js\").Main.worker().ports.log.subscribe((a)=>process.stdout.write(a))'`