Choose Variation

Javascript library for AB test bucketing. Lightweight, framework agnostic, no dependencies.

Installation

NPM: npm install --save choose-variation

Yarn: yarn add choose-variation

Usage

Basic Usage:

import { chooseVariation } from 'choose-variation';

const userId = '12345';
const testId = 'my-test';

const variation = chooseVariation(userId, testId);

if(variation === 0) {
  console.log('A Case');
}
else if(variation === 1) {
  console.log('B Case');
}

Uneven Weights:

// 80% get version A, 20% get version B
const variation = chooseVariation(userId, testId, [0.8, 0.2]);

More than 2 Variations:

// 3-way test
const variation = chooseVariation(userId, testId, [0.34, 0.33, 0.33]);

if(variation === 0) {
  console.log('A Case');
}
else if(variation === 1) {
  console.log('B Case');
}
else if(variation === 2) {
  console.log('C Case');
}

Sampling:

// 10% get version A, 10% get version B, the remaining 80% are excluded from the test
const variation = chooseVariation(userId, testId, [0.1,0.1]);

if(variation === -1) {
  console.log('Excluded from test');
}