redux-req-middleware
redux-req-middleware
is a Redux store middleware for fetching data using HTTP action request.
Table of contents
Installation
You can install redux-req-middleware
via npm. If you'll use it in a Isomorphic/Universal App i recommend you installing it as production dependency.
$ npm install redux-req-middleware --save
Usage
In this example we define the typicall Api call using fetch:
api.js
//Your api calls { return }
Then, in your Redux action creators you can add your Api call function usign the request param of the action:
; { return type: 'USERS_REQUEST' request: api ;}
Request Actions handled by redux-req-middleware will dispatch a new action with a '_SUCCESS' suffix if the request was successful or '_ERROR' suffix if it was unsuccessful. Both the sucess and the error data returned will be added to the payload of the new action dispatched.
Then, in your reducer you can catch the action "USERS_SUCCESS", return the regular Redux flow
{ ...}
redux-req-middleware also returns a promise with the resolved action, giving you the ability to chain actions:
store
Configuration
By default, redux-req-middleware uses the following suffixes for the three typicall HTTP states:
{ request: '_REQUEST', success: '_SUCCESS', error: '_ERROR' }
So if you your action type is "FOO" or "FOO_REQUEST" redux-req-middleware will dispatch a "FOO_SUCCESS" or "FOO_ERROR" action type.
You can use your own suffixes using an object configuration with the same object params described before. To use redux-req-middleware
you need to include it as a Redux Store Middleware using default suffixes configuration or custom suffixes configuration:
ConfigureStore.js
;; //default configurationconst ReduxReqMiddleware = ; //custom configurationconst ReduxReqMiddleware = ; const store =
Projects using redux-req-middleware
- [react-base](https://github.com/atSistemas/react-base/ (atSistemas React/Redux Isomorphic Platform)
License
MIT