jest-redux

jest-redux

Jest matchers for testing redux easier and more declaritive.

Table of Contents

• Getting start
  • Installation
  • Setup
  • Usage
• API Reference
  • toHandleActions(reducer, actionCreators)
  • toHaveInitialState(reducer, initialState)
  • toMatchActionCreatorsSnapshot(actionCreators)
• License

Getting start

Installation

yarn add --dev jest-redux

or

npm install --save-dev jest-redux

Setup

Via setupTestFrameworkScriptFile config

Add jest-redux to your Jest setupTestFrameworkScriptFile configuration

"jest": {
  "setupTestFrameworkScriptFile": "jest-redux"
}

Via setupTest script

Require jest-redux from setupTest script

// ./setupTest.js

require('jest-redux');

Then add this config

"jest": {
  "setupTestFrameworkScriptFile": "./setupTest.js"
}

Usage

Test your standart redux actions and reducers with one of the jest-redux matchers.

const initialState = { number: 0 };

function reducer(state = initialState, action) {
 switch(action.type) {
   case "ADD":
    return state.number + action.payload;
   default:
     return state;
 }
}


expect(reducer).toHaveInitialState(initialState); // Passes tests

API Reference

toHandleActions(reducer, actionCreators)

Checks reducer to handle given actionCreators.

Example

expect(reducer).toHandleActions(actions);

toHaveInitialState(reducer, initialState)

Checks reducer against given intitialState.

Example

expect(reducer).toHaveInitialState(initialState);

toMatchActionCreatorsSnapshot(actionCreators)

Checks given action creators to match with previous snapshot.

Example

expect(actionCreators).toMatchActionCreatorsSnapshot();

License

MIT