Learn about our RFC process, Open RFC meetings & more.Join in the discussion! »

redux-saga-data

3.3.0 • Public • Published
redux-saga-data logo

A lib for fetching normalized data in a redux store through sagas.

CircleCI npm version

Basic Usage

You need to install a redux-saga setup with the watchDataActions and the data reducer:

import {
  applyMiddleware,
  combineReducers,
  createStore
} from 'redux'
import createSagaMiddleware from 'redux-saga'
import { all } from 'redux-saga/effects'
import { createDataReducer, watchDataActions } from 'redux-saga-data'
 
const sagaMiddleware = createSagaMiddleware()
const storeEnhancer = applyMiddleware(sagaMiddleware)
 
function* rootSaga() {
  yield all([
    watchDataActions({
      rootUrl: 'http://momarx.fr',
    }),
  ])
}
 
const rootReducer = combineReducers({
  data: createDataReducer({ users: [] }),
})
 
const store = createStore(rootReducer, storeEnhancer)
 
sagaMiddleware.run(rootSaga)

Then you can request data from your api that will be stored in the state.data

import React, { Fragment } from 'react'
import { requestData } from 'redux-redux-saga'
 
class Foos extends Component {
  constructor () {
    super()
    this.state = { error: null }
  }
 
  componentDidMount () {
    const { dispatch } = this.props
    dispatch(requestData({
      apiPath: '/foos',
      handleFail: () => this.setState({ error: action.error }),
      method:'GET'
    }))
  }
 
  render () {
    const { foos } = this.props
    const { error } = this.state
 
    if (error) {
      return error
    }
 
    return (
      <Fragment>
        {foos.map(foo => (
          <div key={foo.id}> {foo.text} </div>
        ))}
      </Fragment>
    )
  }
}
 
function mapStateToProps (state) {
  return {
    foos: state.data.foos
  }
}
 
export default connect(mapStateToProps)(Foo)

NOTE: We could also used a handleSuccess in the requestData api, in order to grab the action.data foos in that simple case:

constructor () {
  this.state = { error: null, foos: [] }
}
 
componentDidMount () {
  const { dispatch } = this.props
  dispatch(requestData({
    apiPath: '/foos',
    handleFail: () => this.setState({ error: action.error }),
    handleSuccess: () => this.setState({ foos: action.data }),
    method:'GET'
  }))
}
 
render () {
  const { error, foos } = this.setState
  ...
}

But if your rendered foos array should be coming from a memoizing merging (and potentially normalized) (and potentially selected from inter data filter conditions) state of foos, then syntax goes easier if you pick from the connected redux store lake of data.

Usage with config

See all the possible config for requestData in the fetch-normalize-data doc.

Install

npm i redux-saga-data

DownloadsWeekly Downloads

262

Version

3.3.0

License

MPL-2.0

Unpacked Size

54.8 kB

Total Files

19

Last publish

Collaborators

  • avatar
  • avatar
  • avatar
  • avatar
  • avatar
  • avatar