Skip to content
This repository has been archived by the owner. It is now read-only.
A library for controlling a browser using Elm and selenium
Elm JavaScript
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Elm Webdriver

Remote control a browser with selenium, in Elm!

This can be used as a testing suite or you can utilize the exposed API for adapting it to your own use case.


Quick Start

Since this package contains a Native module (some javascript), this cannot be published in Instead, you need to install it using npm. Do this at the root of your Elm project, where the elm-package.json file is:

npm install elm-webdriver

You are now ready to copy some skeleton tests into your project folder. The the files from the templates folder and copy them to your tests folder in your project.

Edit Main.elm so it looks similar to the example file

If you need to use modules from your project, make sure you also add all the dependencies from the main elm-package.json into webdriver-tests/elm-package.json. Remember to keep those in sync.

Install selenium webdriver

To run tests locally you need the Selenium standalone server.
Download the .jar file from the official Selenium page and run it like this:

java -jar selenium-server-standalone.jar

You are now ready to run your tests. In another terminal, while the standalone server is still running:

cd webdriver-tests

You can also filter tests by name:

../node_modules/.bin/elm-webdriver --filter "Some Test Name"

If the Selenium server complains:

WARN - Exception: The path to the driver executable must be set by the webdriver.gecko.driver system property; 
for more information, see 
The latest version can be downloaded from https: //                  

Make sure you have the geckodriver installed, and tell Selenium where it is by setting the system property:

java -Dwebdriver.gecko.driver="<path-to-geckodriver>" -jar selenium-server-standalone.jar


Check the API Docs

You can’t perform that action at this time.