Skip to main content

A JavaScript library for Flask-Split.

Project description

Flask-Split-JS version 0.2.1

Flask-Split-JS offers utilities for using Flask-Split from the browser using JavaScript.


On top of the Flask-Split setup, you need to register the Flask-Split-JS blueprint to your application:

from flask import Flask
from flask.ext.split_js import split_js

app = Flask(__name__)

and add the JavaScript library to your template:

<script src="/path/to/jquery.js"></script>
<script src="{{ url_for('static/js/flask-split.min.js') }}"></script>

jQuery is required for the JavaScript library to work.

API Reference

FlaskSplit.ab_test(experiment_name, alternatives, callback)

A port of Flask-Split’s ab_test function. When the alternative has been decided, the callback function is called with the chosen alternative as its sole argument. In case an error occured with the request, the callback is called with undefined as its first argument and the jQuery response object as its second argument.

Invalid arguments cause errors to be thrown.

Name of the experiment. A string with a minimun length of 1.
A list with the alternatives. All alternatives must be strings with a minimum length of 1.
A function to be called on success or on failure. Should take two arguments: the chosen alternative and the error.

FlaskSplit.finished(experiment_name, reset=true)

A port of Flask-Split’s finished function.

Invalid arguments cause errors to be thrown.

Name of the experiment. A string with a minimum length of 1.
Whether or not the experiment should be reset for the user. Defaults to true.


A list of changes done in each version.


  • Fixed a ReferenceError in the JS that occured because module was not defined.
  • Added a missing var to the JS.


  • Fixed a bug with the functions not sending the data to the server in the correct format.
  • Changed FlaskSplit.ab_test to take the alternatives as a single list argument (i.e. ab_test('exp', 'a', 'b', callback) -> ab_test('exp', ['a', 'b'], callback)).
  • The callback to ab_test will now be called also when the request fails. In this case the first argument is undefined and the second argument is the jQuery response object.


Initial release.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
Flask-Split-JS-0.2.1.tar.gz (7.0 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page