with-immutable-props-to-js

A higher-order component for keeping Immutable objects outside your presentational components

Installation

yarn add with-immutable-props-to-js

or

npm install with-immutable-props-to-js

This library also lists react, react-dom, and immutable as peer dependencies, so make sure they are installed in your project as well.

Usage

import withImmutablePropsToJS from 'with-immutable-props-to-js'

If you're not using ECMAScript modules:

const withImmutablePropsToJS = require('with-immutable-props-to-js').default

Example:

import React from 'react'
import { connect } from 'react-redux'
import withImmutablePropsToJS from 'with-immutable-props-to-js'

const MyDumbComponent = props => {
   // ...
   // props.objectProp is turned into a plain JavaScript object
   // props.arrayProp is turn into a plain JavaScript array
}

MyDumbComponent.propTypes = {
   objectProp: PropTypes.object,
   arrayProp: PropTypes.array,
}

const mapStateToProps = state => ({
   objectProp: mySelectorThatReturnsImmutableMap(state),
   arrayProp: mySelectorThatReturnsImmutableList(state),
})

export default connect(mapStateToProps)(withImmutablePropsToJS(MyDumbComponent))

Motivation

You can read about the rationale for this higher-order component here.

Contributors

For information on how to contribute to this project, check out the contributing guide.

Thanks goes to these wonderful people (emoji key):

_{Michael Rose} 💻 📖 🚇	_{Brandon Baksh} 🚇	_{greenkeeper[bot]} 🚇	_{Jake Bolam} 📖 🚇	_{Sanchit Gera} 📖	_{Siavash Mahmoudian} 🚇	_monicamm95 🎨
_{Danilo Matamoros} 💻	_{Roman Mahotskyi} 🚇	_{Pablo Morra} 💻 ⚠️	_{dependabot[bot]} 🚇	_{jinwoo choi} 💻	_{Marc Cataford} 📖	_{Michael Chen} 💻