Merge pull request #5 from dollarshaveclub/query-param

Query param

lib/index.js

@@ -4,6 +4,10 @@ import camelize from '../vendor/camelize';
 const supportsClasslist = "classList" in document.createElement("_");
 const storageKey = 'ab-tests';
 
+function getParameterByName(name, url) {
+    if (!url) { url = window.location.href; } name = name.replace(/[\[\]]/g, "\\$&"); var regex = new RegExp("[?&]" + name + "(=([^&#]*)|&|#|$)"), results = regex.exec(url); if (!results) return null; if (!results[2]) return ''; return decodeURIComponent(results[2].replace(/\+/g, " "));
+}
+
 class Test {
   constructor(name, data = {}, options = {}) {
     options = {
@@ -35,18 +39,6 @@ class Test {
 
     let bucket;
 
-    // Support Legacy Test Structure, deprecate soon
-    let legacyBucket = storage.local.getItem(`test-${name}`);
-    if (legacyBucket) {
-      console.warn('Migrating tests');
-      tests[name] = {
-        bucket: legacyBucket,
-        buckets: Object.keys(data)
-      };
-      storage.local.setItem(storageKey, JSON.stringify(tests));
-      storage.local.removeItem(`test-${name}`);
-    }
-
     // Retrieve Bucket from storage if possible
     if (options.persist && tests[name]) {
       bucket = tests[name].bucket;
@@ -64,8 +56,20 @@ class Test {
         weights.push( data[names[i]].weight );
       }
 
+      // Grab assignment via query param. Syntax:
+      // ?assign=test:bucket
+      const [assignTest, assignBucket]  = (getParameterByName('assign') || '').split(':');
+      const assignmentMatchesName = assignTest === name;
+      const isValidBucket = assignBucket in data;
+
+      // Use query param assignment if possible
+      if (assignmentMatchesName && isValidBucket) {
+        bucket = assignBucket
+
       // Select a random weighted bucket
-      bucket = Test.chooseWeightedItem(names, weights);
+      } else {
+        bucket = Test.chooseWeightedItem(names, weights);
+      }
 
       // Save
       tests[name] = {

package.json

@@ -1,6 +1,6 @@
 {
   "name": "ab-tester",
-  "version": "0.5.0",
+  "version": "1.0.0",
   "homepage": "https://github.com/dollarshaveclub/ab-tester.js",
   "main": "./index.js",
   "repository": {