https://github.com/jeromemacias/nodium

Pure nodejs selenium webdriver functional helpers
https://github.com/jeromemacias/nodium

nodejs selenium selenium-node selenium-webdriver

Last synced: 3 months ago
JSON representation

Pure nodejs selenium webdriver functional helpers

• Host: GitHub
• URL: https://github.com/jeromemacias/nodium
• Owner: jeromemacias
• License: mit
• Created: 2016-05-30T19:53:22.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2019-01-31T10:25:56.000Z (about 6 years ago)
• Last Synced: 2024-10-11T18:40:49.514Z (4 months ago)
• Topics: nodejs, selenium, selenium-node, selenium-webdriver
• Language: JavaScript
• Homepage:
• Size: 208 KB
• Stars: 2
• Watchers: 2
• Forks: 2
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Nodium

[![NPM Version](https://badge.fury.io/js/nodium.svg?style=flat)](https://npmjs.org/package/nodium)

[![Build Status](https://travis-ci.org/jeromemacias/nodium.svg?branch=master)](https://travis-ci.org/jeromemacias/nodium) [![Circle CI](https://circleci.com/gh/jeromemacias/nodium/tree/master.svg?style=shield)](https://circleci.com/gh/jeromemacias/nodium/tree/master) [![BrowserStack Status](https://www.browserstack.com/automate/badge.svg?badge_key=Yi9pYVJBUjFURW9xT0dDQXlIVzMwZ0pNY3U0R3pudmRvNEpGSHNDQklSND0tLTg2MlRxWWJOaGRRV1hERmhjbWJDNkE9PQ==--fe633534b39f0c29b8abcc78f51a7005085ea98b%)](https://www.browserstack.com/automate/public-build/Yi9pYVJBUjFURW9xT0dDQXlIVzMwZ0pNY3U0R3pudmRvNEpGSHNDQklSND0tLTg2MlRxWWJOaGRRV1hERmhjbWJDNkE9PQ==--fe633534b39f0c29b8abcc78f51a7005085ea98b%)

 [![Sauce Test Status](https://saucelabs.com/buildstatus/jeromemacias-nodium)](https://saucelabs.com/u/jeromemacias-nodium)

Nodium is a collection of useful and pure functions around Selenium Webdriver.

Functions can be imported as ES5 or ES6 (stage2) from package.

You are free to use the test runner of your choice.

## Motivation

There is a lot of frameworks on top of Selenium Webdriver.

I wanted to provide a simple wrapper around webdriver to avoid:

- custom and/or complex configuration file

- force usage and/or configuration of a test runner

- writing long documentation to be able to use a tool which is already documented

- global variables and / or context

So we will now be able to:

- use Selenium Webdriver quickly, with your own tools and habits (ES6, BDD, ...)

- choose the way you configure browsers and options used by your testsuite (env var, function parameters, code...)

Hope you will enjoy this toolbox!

## Installation

`npm i nodium`

## Usage

Available helpers:

- driver/

    - index: load the corresponding webdriver depends on defined environment variables (local firefox by default)

    - utils: helpers to play with your loaded pages dom

    - local: load the corresponding local webdriver depends on your owner parameters

    - browserstack: load a configured BrowserStack webdriver depends on your owner parameters

    - saucelabs: load a configured SauceLabs webdriver depends on your owner parameters

- hook/

    - browserstack: update BrowserStack status at the end of your test suite

    - saucelabs: update SaucLabs status at the end of your test suite

    - jsonServer: start jsonServer before running your test

    - pm2: start and stop pm2 processes

## Todo

- write documentation (by now, you can read the code directly)

- add more hook helpers