Chai-Kekka

A Chai plugin for Kekka

Installation and Usage

Node: npm install --save-dev chai-kekka to get up and running.

1const chai = require("chai")
2const chaiKekka = require("chai-kekka")
3 
4chai.use(chaiKekka)

Documentation

Test value is a Type Result

The result property can be used to check that the tested value is an instance of the Result class.

1expect(Success('Some String')).to.be.a.result
2expect(Failure(new Error('Failure...'))).to.be.a.result

Test value is a Result Success

The success property can be used to check that the tested value is an instance of the Result class of type Success.

1// Positive
2expect(Success('Success String')).to.be.a.success // OK
3expect(Failure(new Error('Failure...'))).to.be.a.success // FAIL
4expect('Not a result').to.be.a.success // FAIL
5
6// Negative
7expect(Success('Success String')).not.to.be.a.success // FAIL
8expect(Failure(new Error('Failure...'))).not.to.be.a.success // OK
9expect('Not a result').not.to.be.a.success // FAIL with 'expected 'Not a result' to be an instance of Result'

Test value is a Result Failure

The failure property can be used to check that the tested value is an instance of the Result class of type Failure.

1// Positive
2expect(Success('Success String')).to.be.a.failure // FAIL
3expect(Failure(new Error('Failure...'))).to.be.a.failure // OK
4expect('Not a result').to.be.a.failure // FAIL
5
6// Negative
7expect(Success('Success String')).not.to.be.a.failure // OK
8expect(Failure(new Error('Failure...'))).not.to.be.a.failure // FAIL
9expect('Not a result').not.to.be.a.failure // FAIL with 'expected 'Not a result' to be an instance of Result'

Test associated value of a Result Object

There are two ways to test the associated value of a Result object:

• the methods successWrapping and failureWrapping
• the property associatedValue

successWrapping and failureWrapping

1const error = new Error('Failure message')
2expect(Failure(error)).to.be.a.failureWrapping(error) // OK
3expect(Failure(error)).to.be.a.successWrapping(error) // FAIL - not a Success
4expect(Failure(error)).to.be.a.failureWrapping('some other value') // FAIL
5
6expect(Success('Success String')).to.be.a.successWrapping('Success String') // OK
7expect(Success('Success String')).to.be.a.failureWrapping('Success String') // Fail - not a Failure
8
9// equality modifiers can be used, such as deep, on successWrapping and failureWrapping
10expect(Success({ a: '423' })).to.be.a.deep.successWrapping({ a: '423' }) 

associatedValue

The associatedValue property can be used after a result, success or failure property. It changes the target of any assertions that follow in the chain to be on the result associated value.

1expect(Success('Success String')).to.be.a.success
2  .with.associatedValue.that.equals('Success String') // OK
3expect(Success({ a: '423' })).to.be.a.success
4  .with.associatedValue.that.deep.equals({ a: '423' }) // OK - equality modifiers accepted
5expect(Success({ a: '423' })).to.be.a.failure
6  .with.associatedValue.that.deep.equals({ a: '423' }) // FAIL - not a failure
7expect(Success({ a: '423' })).to.be.a.result
8  .with.associatedValue.that.deep.equals({ a: '423' }) // OK
9expect(Success('Success String')).to.have.associatedValue.that.equals('Success String') // FAILS 
10// associatedValue must be after either a result, success or failure assertion property