README.md

redux-chaos

Dead Simple Chaos/Property Testing with Redux

This randomly chooses an action from an array 100,000 times and dispatches it to a store with a hook on each repetition.

##Setup

npm i --save-dev redux-chaos

import { chaos } from 'redux-chaos'

###chaos (Store: ReduxStore, Actions: Array<Object | Function> | Object, Each: ?Function)

Store: any redux store

Actions: your object of actions or an array of your actions

If you have an actions file, you can simply use import * as actions from './actions' for the actions.

Each: (prevState: any, nextState: any, action: Object | Function): void

Each is executed every iteration and given the parameters above, self explanatory.

##Example

import { chaos } from 'redux-chaos'

function counter(state = {count: 0, other: ''}, action) {
  switch (action.type) {
    case 'INCREMENT_COUNTER':
      return {
				count: state.count + 1,
				other: state.other
			}
    case 'DECREMENT_COUNTER':
      return {
				count: state.count - 1,
				other: state.other
			}
		case 'AYYY': 
			return {
				count: state.count,
				other: state.other.length >= 50 ? state.other : state.other + 'lo'
			}
    default:
      return state
  }
}

const mockStore = createStore(counter)

function eachTime (prevState, nextState, action) {
	if(action.type === 'INCREMENT_COUNTER')
		expect(nextState.count).to.be.above(prevState.count)
	if(action.type === 'DECREMENT_COUNTER')
		expect(nextState.count).to.be.below(prevState.count)
		
	expect(nextState.other).to.have.length.below(51)
}

describe('Redux', () => {
	it('things', () => {
		chaos(mockStore, [
			{type: 'INCREMENT_COUNTER'}, 
			{type: 'DECREMENT_COUNTER'}, 
			{type: 'AYYY'}], 
			eachTime)
	})
})

Very simple.