Http-assert-value NPM

http-assert of typed values

Install

npm install http-assert-value --save

Usage

const assert = require('http-assert-value');

// Common assert interface
assert(+0 === -0, 'Zeros are not equal', 500, 'ZNE', {
    leftOperand: +0,
    reghtOperand: -0,
    operation: '==='
});                                        // Ok

// Assert typed values
assert.identity('green-mile');             // Ok
assert.float('3.14');                      // Ok
assert.positiveInt('12');                  // Ok
assert.text('The Green Mile');             // Ok

// Assert by JSON schema
// @see: http://json-schema.org/
assert.bySchema('1', { type: 'integer' }); // Ok

// All methods have duplicates with `try...`
assert.text(undefined);                    // Error
assert.tryText(undefined);                 // Ok

try {
    assert.text('DROP DATABASE BOOKS;');
} catch (error) {
    error.message;    // 'Text is invalid'
    error.statusCode; // 400
    error.options;    // { value: 'DROP DATABASE BOOKS;', internalCode: '400_TVI' }
}

API

assert(value, message, code, shortMessage, options={})

Assert value with http-specific error data

value Any - asserting value
message String - error text
code Number - error http-code
shortMessage String - three-letter error code
[options] Object - error additional information

assert.identity(value, field = 'Identity')

Assert slug or unique identity value

value String|Array<String> - asserting value
[field] String - name of the parameter containing value

assert.float(value, field = 'Float')

Assert float value

value String|Array<String> - asserting value
[field] String - name of the parameter containing value

assert.positiveInt(value, field = 'Positive integer')

Assert positive integer value

value String|Array<String> - asserting value
[field] String - name of the parameter containing value

assert.text(value, field = 'Text')

Assert text, like search request

value String|Array<String> - asserting value
[field] String - name of the parameter containing value

assert.bySchema(value, schema, options = {})

Assert object by schema

value Any|Array<Any> - asserting value
schema Object - json-schema
[options] Object - ajv constructor options

assert.oneOf(value, expected = [], comparator)

Assert value, that it is in array

value Any - asserting value
[expected] Array - array which contains expected values
[comparator] Function - function which compare values from array with asserting value. By default used comparator to compare primitive ((lhs, rhs) => lhs === rhs)