opentrials v1.1.0

OpenTrials

A Node adapter to interact with the OpenTrials.net API.

Differences from just calling the OpenTrials API directly:

• All keys are tidied into camelCase by default (see tidy())
• All dates are converted into JavaScript date objects
• Optionally populate detailed information about a trial (see populate() or tidy())

API

config

Config is stored in the config object. Values can be changed by setting them directly or by passing them into each function.

count(terms, settings, callback)

Return the number of matching OpenTrials by a query.

This function will return a single number of the matching trials.

var ot = require('opentrials');

ot.count('cancer', function(err, res) {
	// Err is any error that occured
	// Res is the number of found trials
});

get(trialId, settings, callback)

Retrieve a single trial by its OTID.

var ot = require('opentrials');

ot.get('4cd4011e-8caf-11e6-be70-0242ac12000f', function(err, res) {
	// Err is any error that occured
	// Res is the trial object
});

new()

Return a new OpenTrials API instance. By default this module acts as a singleton instance (all require('opentrials') calls effectively gets the same object return). If you wish to isolate requests use the new method to create a fresh object:

var ot = require('opentrials').new();

ot.get('4cd4011e-8caf-11e6-be70-0242ac12000f', function(err, res) {
	// Err is any error that occured
	// Res is the trial object
});

populate(obj)

Populate a trial object. This function will follow all keys listed in settings.tidy.populateKeys and fetch each URL, replacing the original object with the downloaded values.

var ot = require('opentrials').new();

ot.get('4cd4011e-8caf-11e6-be70-0242ac12000f', function(err, res) {
	// Err is any error that occured
	// Res is the trial object

	ot.populate(res, function(err, res) {
		// res is now fully populated
	});
});

If you are populating all responses anyway you can simply set settings.tidy.populate to true. It is disabled by default as the populate functionality can make a large number of API requests.

search(terms, settings, callback)

Search for multiple OpenTrials by a query.

This will return an array of all found trials split into pages. You can change the page offset by setting settings.page (or the number within a page with settings.pageLimit).

The search terms can be either a simple string or any valid Elastic Search string.

var ot = require('opentrials');

ot.search('cancer', function(err, res) {
	// Err is any error that occured
	// Res is the found trials
});

tidy(trialObject, settings, callback)

Tidy up a raw OT JSON response.

Behaviours include:

• Tidying up keys so they use camelCase rather than snake_case. Configure by setting opentrials.config.tidy.keys.
• Tidying up the raw string dates to JavaScript Date objects. Configure by setting opentrials.config.tidy.date*.
• If opentrials.config.tidy.populate is enabled it will also run any trial via populate() before returning.

This function is automatically invoked during get() calls.