Useractions NPM

UserActions

Library, that helps simulate user actions for write fast functional tests fro browsers

Getting started

Npm

npm install useractions --save-dev

Add tests to webpage

For add tests to your webpage, just add it right in simple script. Look to the example

But if you want add lib and tests without change your webpage files, you can use userscripts (tampermonkey / greasemonkey extensions)

Run tests

Look to the example

Action methods

interact methods:

get methods:

core methods:

Methods API

click method

var click = userActions.click;
click('button#submit', optionalCallback);

event method

var event = userActions.event;
event({
  type: 'click',
  target: 'button#submit'
}, optionalCallback);

changeValue method

var changeValue = userActions.changeValue;
changeValue('input#login', 'John Doe', optionalCallback);

focusOn method

var focusOn = userActions.focusOn;
focusOn('input#password', optionalCallback);

blur method

var blur = userActions.blur;
blur('input#age', optionalCallback);

pickInSelect method

var pickInSelect = userActions.pickInSelect;

// You can pass option value
pickInSelect('select#car', 'mercedez', optionalCallback);

// You can pass option innerHTML
pickInSelect('select#car', 'Mercedez Benz', optionalCallback);

// Or a number of selected value
pickInSelect('select#car', 2, optionalCallback);

directClick method

var directClick = userActions.directClick;

// this method calls .click() method of element directly (without events)
click('#myCheckbox', optionalCallback);

getText method

var getText = userActions.getText;
getText('div#selectedCar', function(err, text) {
  if (err) throw err;

  // work with text
});

getValue method

var getValue = userActions.getValue;
getValue('input#surname', function(err, value) {
  if (err) throw err;

  // work with value
});

findElement method

var findElement = userActions.findElement;

// You can use with default timeout waiting for element presense
findElement('div#main', function(err, element) {
  if (err) throw err;

  // work with element
});

// Or you can specify need timeout
findElement('div#main', 3000, function(err, element) {
  if (err) throw err;

  // work with element
});

waitState method

var waitState = userActions.waitState;

waitState(function() {
  // this is predicate, it must return boolean value
  var loadedCarsInList = document.querySelectorAll('ul#cars>li').length;
  return loadedCarsInList === 12;
}, function(err) {
  // this is callback, it will called if predicate returns true, until timeout done
  if (err) throw err;

  // work with successfully loaded car list
}, 5000, 1000); // optional timeout and optional refresh time (wait 5 seconds and check predicate every second)

Configure timeouts

setDefaultRefreshTime method

// every waitState method or findElement process will try every second
userActions.setDefaultRefreshTime(1000);

setDefaultTimeout method

// every waitState method or findElement process will failed after 6 seconds
userActions.setDefaultTimeout(6000);

Promisified methods

All action methods has promisified version, in example getText:

var getText = userActions.promised.getText;

getText('div#carDescription')
.then(function(text) { /* work with text =) */ })
.catch(function(err) { /* handle error =( */ };

Already found element

All action methods (promisified too) you can use with already found element. It is comfortable for promise chaining:

var promiseActions = userActions.promised;
var findElement = promiseActions.findElement;
var click = promiseActions.click;

findElement('#buttonForClick')
.then(button => click(button));