optimizely

Runs optimizely experiments in node using either jsdom (slow & stable) or cheerio+node-vm (young blood)

Showing:

Popularity

Downloads/wk

14

GitHub Stars

17

Maintenance

Last Commit

6yrs ago

Contributors

1

Package

Dependencies

3

Size (min+gzip)

345.1KB

License

MIT

Type Definitions

Tree-Shakeable

No?

Categories

Readme

Optimizely Build Status

Runs optimizely experiments in node using either jsdom (node-0.10 only, full-featured, resource-hungry) or cheerio+node-vm (0.10 and 0.12, simple, lightweight)

Install

npm install optimizely --save

Usage

  1. Load processing environment
// jsdom
var optimizely = require('optimizely')('jsdom');

// node vm
var optimizely = require('optimizely')('node_vm');

  1. Attach Optimizely code library
optimizely.setOptimizely(optimizelyCode);
  1. Process html page
// req - http request
// callback – return path out of this middleware

var originalHtml = getFinalHtmlBeforeResponse();

optimizely(req, originalHtml, function(err, modifiedHtml, extras)
{
  // only pass error if html isn't returned
  if (err && !html)
  {
    return callback(err);
  }

  // extras.images – array of image-src;
  // extras.cookies – cookie object;

  // return modified html
  callback(null, html);  
});

Notes

jQuery

In jsdom processor trimmed version of jQuery is used, which is provided by optimizely itself and bundled with the module. In turn node_vm processor is relying on augmented cheerio module.

Cookies

Module oven is used for cookie handling and it's cookie jar instance is returned in callback. Method extras.cookies.getCookieHeader() could be used to get cookie header formated string and extras.cookies.getCookies() to get list of cookie objects.

Images

Along with creating new cookies, optimizely adds images to track performed experiments, to make it slim and less opinionated, list of images passed to callback (extras.images) instead of modifying html in place.

TODO

  • More tests
  • Autoload of optimizely code

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100