The dallinger object
Any page that includes dallinger2.js script will have a dallinger object added to the window global namespace. This object defines a number of functions for interacting with Dallinger experiments.
Making requests to experiment routes
dallinger provides functions which can be used to asynchronously interact with any of the experiment routes described in Web API:
The dallinger object also provides functions that make requests to specific experiment routes:
Additionally, there is a helper method to handle error responses from experiment API calls (see Deferred objects below):
All of the above functions make use of jQuery.Deferred, and return Deferred objects. These Deferred objects provide the following methods to facilitate handling asynchronous responses once they’ve completed:
.done(callback): Provide a callback to handle data from a successful response
.fail(fail_callback): Provide a callback to handle error responses
.then(callback[, fail_callback, progress_callback]): Provide callbacks to handle successes, failures, and progress updates.
The fail_callback function will be passed a dallinger.AjaxRejection object which
includes detailed information about the error. Unexpected errors should be handled
by calling the
dallinger.error() method with the AjaxRejection object.
Experiment Initialization and Completion
In addition to the request functions above, there are a few functions that are used by the default experiment templates to setup and complete an experiment. If you are writing a highly customized experiment, you may need to use these explicitly:
Helper functions and properties
Finally, there are a few miscellaneous utility functions and properties which are useful when writing a custom experiment: