descap

descap generates Selenium-friendly "desired capabilities" objects from human-friendly strings. It support browser name shorthands (like ie), version numbers and ranges (48..52), and other arbitrary parameters via query strings.

API

descap(str)

Parse the string into an array of desired capabilities objects, according to the [expected format]. Because strings may describe two or more configurations, the descap() function always an array, even when only one capabilitiy is created. You can reliably parse a single spec with descap.parse.

descap.parse(str)

Parse a string into a single desired capabilities object, according to the expected format.

Expected Format

The format of expected strings is:

Format | Returns | Examples :----- | :---------- | :------- name | [{browserName: browser}] | chrome, firefox, ie name@version | [{browserName: browser, version: version}] | chrome@52, firefox@40, ie@11 [email protected] | An array with as many entries as there are numbers between start and end (inclusive) | [email protected], [email protected] name[...]?options | An array in which each object has additional properties defined in the querystring | chrome@40?platform=Windows+7, firefox@40@platform=OS X 10.11 spec;spec | An array of parsed specs, with one or more for each spec | chrome;firefox@40 ie@11,10;firefox@40?platform=Windows+7

var descap = require('descap');
var assert = require('assert');

assert.deepEqual(descap('ie8'), [
  {
    browserName: 'Internet Explorer',
    version: 8
  }
]);

assert.deepEqual(descap('[email protected]'), [
  {
    browserName: 'chrome'
    version: 52
  },
  {
    browserName: 'chrome'
    version: 53
  },
  {
    browserName: 'chrome'
    version: 54
  }
]);

assert.deep