Express middleware for Optimizely
npm install @optimizely/expressThis repository houses the Express.js integration for use with Optimizely Full Stack and Optimizely Rollouts.
Optimizely Full Stack is A/B testing and feature flag management for product development teams. Experiment in any application. Make every feature on your roadmap an opportunity to learn. Learn more at https://www.optimizely.com/platform/full-stack/, or see the documentation.
Optimizely Rollouts is free feature flags for development teams. Easily roll out and roll back features in any application without code deploys. Mitigate risk for every feature on your roadmap. Learn more at https://www.optimizely.com/rollouts/, or see the documentation.
npm install @optimizely/express --save
Using yarn:
yarn add @optimizely/express
Configuration
javascript
const optimizelyExpress = require('@optimizely/express');
const optimizely = optimizelyExpress.initialize({
sdkKey: 'CZsVVgn6j9ce6fNPt2ZEiB',
datafileOptions: {
autoUpdate: true,
updateInterval: 600000 // 10 minutes in milliseconds
},
});
`The
parameter indicates that your feature flags will get automatically updated from changes made in Optimizely's user interface. The updateInterval indicates how frequently the Optimizely Express SDK will poll for changes.Usage
$3
`
app.use(optimizely.middleware);
The above middleware adds the following object on the express request objectreq.optimizely:
req.optimizely = {
datafile: A representation of all of your feature flags and experiments as defined in Optimizely
client: The Optimizely SDK client instance which has methods for , activate, track, etc.
}
`Once the middleware is installed, you can use the standard Optimizely JavaScript SDK APIs like isFeatureEnabled
app.get('/', function(req, res, next) {
const isEnabled = req.optimizely.client.isFeatureEnabled('checkout_flow', '123');
res.render('index', {
title: 'Express: ' + (isEnabled ? 'feature on!' : 'feature off')
});
});
$3
If you would rather that your server not poll for changes made in Optimizely's configuration but rather get updated as quickly as possible when changes occur, you can use the following secure webhook implementation. Note, this requires following the documentation on setting up a secure webhook in the Optimizely UI.
app.use('/webhooks/optimizely', bodyParser.text({ type: '/' }), optimizely.webhookRequest);
Once you have successfully implemented the webhook, you can turn off the polling completely by setting the attribute to false above in the configuration step.Note: If you deploy your server to multiple different machines, this will not ensure that the two machines are in-sync with the latest configuration. If you would like to see support for cross-machine syncing via webhooks, please let us know by opening an issue on this repository.
$3
If you would like to see the latest configuration of your feature flags and experiments as defined in Optimizely's UI, you can see the datafile by installing this route on your server:
`
app.use('/optimizely/datafile', optimizely.datafileRoute);
Demo
See the full demo of usage, reproduced below:
const optimizelyExpressSdk = require('@optimizely/express');
const optimizely = optimizelyExpressSdk.initialize({
sdkKey: 'CZsVVgn6j9ce6fNPt2ZEiB',
datafileOptions: {
autoUpdate: true,
updateInterval: 600000 // 10 minutes in milliseconds
},
});app.use(optimizely.middleware);
app.use('/webhooks/optimizely', bodyParser.text({ type: '/' }), optimizely.webhookRequest);
app.use('/optimizely/datafile', optimizely.datafileRoute);
app.get('/', function(req, res, next) {
const isEnabled = req.optimizely.client.isFeatureEnabled('checkout_flow', '123');
res.render('index', {
title: 'Express: ' + (isEnabled ? 'feature on!' : 'feature off')
});
});
About
Please see CONTRIBUTING.
This repository includes code from the following open source projects:
body-parser
Copyright (c) 2014 Jonathan Ong
Copyright (c) 2014-2015 Douglas Christopher Wilson
License (MIT): https://github.com/expressjs/body-parser
cookie-parser
Copyright (c) 2014 TJ Holowaychuk
Copyright (c) 2015 Douglas Christopher Wilson
License (MIT): https://github.com/expressjs/cookie-parser
debug
Copyright (c) 2014 TJ Holowaychuk
License (MIT): https://github.com/visionmedia/debug
express
Copyright (c) 2009-2014 TJ Holowaychuk
Copyright (c) 2013-2014 Roman Shtylman
Copyright (c) 2014-2015 Douglas Christopher Wilson
License (MIT): https://github.com/expressjs/express
http-errors
Copyright (c) 2014 Jonathan Ong me@jongleberry.com
Copyright (c) 2016 Douglas Christopher Wilson doug@somethingdoug.com
License (MIT): https://github.com/jshttp/http-errors
jade
Copyright (c) 2009-2014 TJ Holowaychuk
License (MIT): https://github.com/dscape/jade
morgan
Copyright (c) 2014 Jonathan Ong
Copyright (c) 2014-2017 Douglas Christopher Wilson
License (MIT): https://github.com/expressjs/morgan
This software may be used with additional code that is separately downloaded by you. These components are subject to their own license terms, which you should review carefully.
request
Copyright (c) 2010-2012 Mikeal Rogers
License (Apache 2.0): https://github.com/request/request
request-promise
Copyright (c) 2017, Nicolai Kamenzky, Ty Abonil, and contributors
License (ISC): https://github.com/request/request-promise