rohr v1.2.1

rohr.js - validation & transformation library

Rohr helps you to:

• Reliably extract data from complex hierarchies
• Validate JSON requests in your API server
• Freely mix synchronous and asynchronous transformations on your data
• Integrate APIs together
• Easily bring in legacy data

Installation

npm install rohr

Running the tests:

npm install
npm test

Basic example

Rohr is under active development and some of the documentation may be lacking or obsolete. See the test suite for up-to-date examples.

var rohr = require('rohr');

var input = {
    "foo": "42"
};

rohr(input)

.prop('foo').isString().castTo('integer').transform(function(val) {
    return val * 2;
})

.toPromise().then(function(object) {
    console.log(object);
});

Result:

{
    "foo": 84
}

Handling errors

Rohr does not stop when it encounters an error but instead logs it and continues processing the rest of the data. The list of errors can be obtained by calling .error(callback) where callback is of type function (errors) {}. Each error objects contains information about where the error occured as well as an error type. If using .toPromise(), any encountered errors during processing will cause the promise to be rejected. This behavior can be overriden by calling .toPromise(true) instead and using .error() to handle errors.

API