bradparks / navalia__not-your-father-s-web-driver

Not your father's web driver

npm install --save navalia

View the documentation here

Automate and scale browser workflows with a sane API. Navalia exports a handy Navalia module that acts as browser-load balancer, as well as a Chrome module that you can use for an easier experience.

Usage

• Functional Testing

• Website Code Coverage

BETA WARNING This project heavily relies on bleeding-edge technology, as such the API and internals will likely change from time to time. I heavily recommend that you install Chrome Canary to capture the latest and greatest the browser has to offer.

Features

• Runs and controls multiple instances of particular browser (currently Chrome).
• Capture screenshots, pdfs, execute javascript, insert text, and more.
• Queue work automatically when all instances are busy.
• Uses a simple, easy to understand API.
• Work can easily span over multiple pages or complex interactions.
• Set timers and max-jobs limitations on browsers, forcing them to reboot for easier memory management.

Navalia Example

// Navalia manages browser instances
// and can jobs can be queued against it
const { Navalia } = require('Navalia');
const navalia = new Navalia();

navalia.register((chrome) => {
  return chrome.goto('http://www.google.com/')
    .then(() => chrome.pdf('/Users/jgriffith/Downloads/google.pdf'));
});

navalia.register((chrome) => {
  return chrome.goto('http://www.facebook.com/')
    .then(() => chrome.pdf('/Users/jgriffith/Downloads/facebook.pdf'));
});

Chrome Example

// Simple, easy to use Chrome wrapper
import { Chrome } from 'navalia';

const chrome = new Chrome();

async function screenshotHN() {
  await chrome.goto('https://news.ycombinator.com/');
  await chrome.click('a')
  await chrome.wait(500);
  await chrome.screenshot('/Users/jgriffith/Downloads/hn.png');
  return chrome.done();
}

screenshotHN();

More Examples

Looking for more? Check out the docs.

Roadmap

In no particular order, this is the vision of navalia going forward:

• Expanded browser API (pdf rendering, network watching, more).
• Bring more vendors onto the framework.
• Better typings around externals with no @type support.
• Parameterization on killing long-running jobs.
• Unit testing all features.
• Integration testing with the various vendors so our API's don't break when theirs do.
• Travis, coveralls, greenkeeper, and other handy-dandy tools to automate chore tasks.