An assertion framework.
Proudly made with ♥ in Valencia, Spain, EU.
Install
npm install justo-assert
Use
require("justo-assert");
var x = 1;
x.must.be.equal(1); //ok
x.must.be.equal(2); //AssertionError
Assertions
must.be.equal(), must.be.eq(), must.not.be.equal() and must.not.be.eq()
Check whether a value is equal to another:
x.must.be.equal(123);
x.must.be.eq(123);
x.must.not.be.equal(123);
x.must.not.be.eq(123);
must.match(), must.not.match(), must.be.like() and must.not.be.like()
Check whether a value matches a regular expression:
name.must.match(/^Anna/);
name.must.not.match(/^Anna/);
name.must.be.like(/^Anna/);
name.must.not.be.like(/^Anna/);
must.be.same() and must.not.be.same()
Check whether if a value is strictly another:
user1.must.be.same(user2);
user1.must.not.be.same(user2);
must.be.similarTo() and must.not.be.similarTo()
Check whether an array is similar to another:
[1, 2, 3].must.be.similarTo([2, 1, 3]); //true
[1, 2, 3].must.be.similarTo([1, 2, 4]); //false
must.be.between() and must.not.be.between()
Check whether a value is whitin a range:
x.must.be.between(1, 10);
x.must.not.be.between(1, 10);
must.be.lessThan(), must.be.lt(), must.not.be.lessThan(), must.not.be.lt()
Check whether a value is less than another:
x.must.be.lessThan(y);
x.must.be.lt(y);
x.must.not.be.lessThan(y);
x.must.not.be.lt(y);
must.be.greaterThan(), must.be.gt(), must.not.be.greaterThan() and must.not.be.gt()
Check whether a value is not less than another:
x.must.be.greaterThan(y);
x.must.be.gt(y);
x.must.not.be.greaterThan(y);
x.must.not.be.gt(y);
must.contain() and must.not.contain()
Check whether a value contains another:
str.must.contain("a");
arr.must.contain("a");
str.must.not.contain("a");
arr.must.not.contain("a");
must.be.in(), must.not.be.in(), must.be.insideOf() and must.not.be.insideOf()
Check whether a value is in a string or array:
substr.must.be.in(str);
item.must.be.in(arr);
substr.must.be.insideOf(str);
item.must.be.insideOf(arr);
substr.must.not.be.insideOf(str);
item.must.not.be.insideOf(arr);
substr.must.not.be.in(str);
item.must.not.be.in(arr);
Note. The in word is a reserved word in ES2015.
must.have() and must.not.have()
Check whether a value has a property set:
user.must.have("username")
user.must.have(["username", "password"]);
user.must.have({username: "usr", password: "pwd"});
user.must.not.have("username");
user.must.not.have(["username", "password"]);
user.must.not.have({username: "usr", password: "pwd"});
must.haveAny()
Check whether a value have, at least, a specified property:
user.must.haveAny(["username", "password"]);
user.must.haveAny({username: "usr", password: "pwd"});
must.all.have() and must.not.all.have()
Check whether all items of a list have a property or set of properties:
array.must.all.have(["username", "password"]);
array.must.all.have({state: "LOCKED"});
array.must.not.all.have(["posts"]);
array.must.not.all.have({posts: []});
must.be.instanceOf() and must.not.be.instanceOf()
Check whether the type of a value is the specified one:
x.must.be.instanceOf("Address");
x.must.be.instanceOf(Address);
x.must.not.be.instanceOf("Address");
x.must.not.be.instanceOf(Address);
must.raise() must.not.raise()
Check whether a function call throws an error:
fn.must.raise();
fn.must.raise(Error);
fn.must.raise(Error, ["arg1"]);
fn.must.raise(Error, ["arg1", "arg2"]);
fn.must.raise("Error message");
fn.must.raise("Error message", ["arg1"]);
fn.must.raise("Error message", ["arg1", "arg2"]);
fn.must.raise(/error message pattern/);
fn.must.raise(/error message pattern/, ["arg1"]);
fn.must.raise(/error message pattern/, ["arg1", "arg2"]);
fn.must.not.raise();
fn.must.not.raise(Error);
fn.must.not.raise(Error, ["arg1"]);
fn.must.not.raise(Error, ["arg1", "arg2"]);
fn.must.not.raise("Error message");
fn.must.not.raise("Error message", ["arg1"]);
fn.must.not.raise("Error message", ["arg1", "arg2"]);
fn.must.not.raise(/error message pattern/);
fn.must.not.raise(/error message pattern/, ["arg1"]);
fn.must.not.raise(/error message pattern/, ["arg1", "arg2"]);