screen-pill

library for creating page objects in javascript

inpsired by cheezy's ruby implementation

check out the cucumber demo

install

npm install screen-pill

usage

declare a function to encapsulate a web page

 
// google-search.js
 
const ScreenPill = require('screen-pill')
 
function GoogleSearch(driver) {
 
  this.setDriver(driver)
 
  this.directUrl('http://www.google.com')
 
  this.textField('terms', {name: 'q'})
  this.submit('google')
  this.submit('feelingLucky', {index: 1})
 
  this.query = async function(query) {
    await this.terms.waitUntilPresent()
    await this.terms.set(query)
    await this.google.waitUntilPresent()
    return this.google.click()
  }
 
  return this
}
 
module.exports = ScreenPill(GoogleSearch)
 

instantiate with driver and use methods

 
const webdriver = require('selenium-webdriver')
const driver = new webdriver.Builder().forBrowser('chrome').build()
const GoogleSearch = require('google-search')
 
let searchPage = new GoogleSearch(driver)
 
async function search() {
  await searchPage.visit()
  return searchPage.query('cats')
}
 
search()
 

documentation

see /test for examples using cucumber and chai

see wiki for api and usage

under active development (contributions welcome)

contributors

• sean gregory
• phil jordan

special thanks

• jesse keane