redux-ledger
Tiny redux middleware to run integration tests with thunks!
Install
npm install --save-dev redux-ledger
Usage
Add ledger
middleware to your Redux store. Simulate events and dispatch
just as you would before. It will intercept and record all actions. Once you
are ready, use ledger.resolve()
to wait for any pending
thunks to complete, then run your assertions.
Note - For accurate results place ledger
as the first middleware in the store.
Recording Actions
Every action in the store can be recorded by adding the middleware to the store.
;;; const doA = type: "action_a" payload ;const doB = type: "action_b" payload ; // For the purposes of a demo these are defined inline ...const doAsyncA = { return Promise;}; // ... but let's pretend they are some long running requests, mocked or notconst doAsyncB = { return Promise;}; ;
Complex Example
redux-ledger
shines when you want to unit test an entire component connected to
a store.
;;;;;// Component to test; ;
API
createLedger()
- Factory
You'll want a new ledger for each new store, as ledgers should
be scoped to a single store. Returns a ledger
middleware instance.
ledger
- Instance
The middleware function. Has additional methods on the function object:
// Will wait for any pending promise from actions to finish.// Resolves with the array of actions dispatchedledger; // Will return all actions recorded so farledger; // [ { type: 'a', ...}, {type: 'b', ...} ] // Will clear any previously recorded actionsledger;