https://github.com/lorenzo/elm-webdriver

A library for controlling a browser using Elm and selenium
https://github.com/lorenzo/elm-webdriver

elm elm-webdriver selenium standalone-server test-automation

Last synced: 3 months ago
JSON representation

A library for controlling a browser using Elm and selenium

• Host: GitHub
• URL: https://github.com/lorenzo/elm-webdriver
• Owner: lorenzo
• Archived: true
• Created: 2016-07-02T19:57:30.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2018-03-02T19:43:26.000Z (almost 7 years ago)
• Last Synced: 2024-09-25T22:46:56.845Z (3 months ago)
• Topics: elm, elm-webdriver, selenium, standalone-server, test-automation
• Language: Elm
• Size: 145 KB
• Stars: 59
• Watchers: 6
• Forks: 8
• Open Issues: 1
• Metadata Files:
  • Readme: Readme.md

Awesome Lists containing this project

README

        
# 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.

[![asciicast](https://asciinema.org/a/ubtn5N0GIhSu0HgcO6UPnA9DD.png)](https://asciinema.org/a/ubtn5N0GIhSu0HgcO6UPnA9DD)

## Quick Start

Since this package contains a `Native` module (some javascript), this cannot be published in

packages.elm-lang.org. Instead, you need to install it using npm. Do this at the root of your

Elm project, where the `elm-package.json` file is:

```sh

npm install elm-webdriver

```

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

[the templates folder](https://github.com/lorenzo/elm-webdriver/tree/master/templates) and

copy them to your `tests` folder in your project.

Edit `Main.elm` so it looks similar to the [example file](https://github.com/lorenzo/elm-webdriver/blob/master/example/Main.elm)

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](http://www.seleniumhq.org/download/)

and run it like this:

```sh

java -jar selenium-server-standalone.jar

```

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

```sh

cd webdriver-tests

../node_modules/.bin/elm-webdriver

```

You can also filter tests by name:

```sh

../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 https://github.com/mozilla/geckodriver. 

The latest version can be downloaded from https: //github.com/mozilla/geckodriver/releases                  

```

Make sure you have [the geckodriver](https://github.com/mozilla/geckodriver/releases) installed,

and tell Selenium where it is by setting the system property:

```sh

java -Dwebdriver.gecko.driver="" -jar selenium-server-standalone.jar

```

## API

Check the [API Docs](Api.md)