A front-end A/B testing library
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
build
lib
test
.gitignore
.jscsrc
.jshintrc
.travis.yml
LICENSE
README.md
gulpfile.js
karma.conf.js
package.json

README.md

abo

Abo is a micro front-end A/B testing library.

Dependency Status Build Status npm version

Installation

npm install --save abo

How it works?

The first time a user visits a page he gets an experiment assigned. The experiment's ID is stored in the user's cookies. He will not get other experiments assigned until the one he's on is active.

How is the traffic allocated between experiments? By default, the traffic is divided equally between all experiments. If some experiment has to have more or less traffic, it can be specified through the traffic parameter. The value of traffic has to be between 0 and 1. 0 is no traffic at all. 1 is 100% of the traffic.

How to target specific devices/pages/users with an experiment? An experiment will only be assigned to a user if its assignment condition is satisfied. The assignment condition is a function passed to the ac property that returns a boolean. So if an experiment is changing the homepage for mobile devices, the AC of the experiment can look like this:

function() {
  return location.href.indexOf('/homepage/') !== -1 &&
    matchMedia('(max-width: 749px)').matches;
}

Usage example

abo([{
  id: '423',
  name: 'Blue buttons on Homepage',
  /* Assignment Condition */
  ac: function() {
    return location.href.indexOf('/homepage/') !== -1;
  },
  traffic: 0.1, // 10% of the traffic will be assigned to this variation if the Assignemt condition was satisfied
  setup: function() {
    $('button').css({
      'background-color': 'blue'
    });
  }
}, {
  id: '132',
  name: 'New page title',
  setup: function() {
    $('title').html('New page title');
  }
}]);

Project generation

Don't know how to bootstrap your A/B testing project with Abo? No problems, just use Yeoman generator for Abo.

License

The MIT License (MIT)