asserted

A simple assertion interface for validation.

Usage no npm install needed!

<script type="module">
  import asserted from 'https://cdn.skypack.dev/asserted';
</script>

README

asserted Build Status NPM version Dependency Status

A simple assertion interface for validation.

A simple extensible interface for validation assertions shipped with the minimum assertions necessary for robust validations.

Installation

Install using npm:

npm install asserted

Install using bower:

bower install asserted

Using browser script tag and global (UMD wrapper):

// Available via window.asserted
<script src="dist/asserted.js"></script>

API Reference

class: Assert ⏏

Members

new Assert(value, [message])

Create a new assertion with given value.

Check Assert#satisfied and if false a failure message will be available via Assert#message.

Params

  • value Mixed
  • [message] String - override default message. %v is replaced with value

Returns: Assert

Assert.extend(message, fn)

Extend Assert with given message and assertion fn.

Params

  • message String - %v is replaced with asserted value
  • fn function - assertion function returns boolean

Returns: Assert

Assert.Type(type, [message])

Create assertion that value is type of given type.

Params

  • type String
  • [message] String

Returns: Assert

Assert.Instance(constructor, [message])

Create assertion that value is instance of given constructor.

Params

  • constructor function
  • [message] String

Returns: Assert

Assert.Equals(value, [message])

Create assertion that value is equal to given value.

Params

  • value Mixed
  • [message] String

Returns: Assert

Assert.Enum(set, [message])

Create assertion that value is in given set.

Params

  • set Array
  • [message] String

Returns: Assert

Assert.Set(assert, [message])

Create assertion that value array members satisfy the given assert.

Params

  • assert Assert
  • [message] String

Returns: Assert

Assert.Range(range, [message])

Create assertion that number value is within given range.

Params

  • range Object
    • min Number
    • max Number
  • [message] String

Returns: Assert

Assert.Length(length, [message])

Create assertion that string or array value has given length.

Params

  • length Object | Number
    • [min] Number
    • [max] Number
  • [message] String

Returns: Assert

Assert.RegExp(regex, [message])

Create assertion that value matches given regex.

Params

  • regex RegExp
  • [message] String

Returns: Assert

Contributing

Please submit all issues and pull requests to the alexmingoia/asserted repository!

Tests

Run tests using npm test or gulp test.

Code coverage

Generate code coverage using gulp coverage and open coverage.html in your web browser.

Support

If you have any problem or suggestion please open an issue here.