parse-prop-types
Version:
Parses React prop-types into a readable object
89 lines (63 loc) • 2.52 kB
Markdown
# parse-prop-types
[](https://github.com/diegohaz/nod)
[](https://npmjs.org/package/parse-prop-types)
[](https://travis-ci.org/diegohaz/parse-prop-types) [](https://codecov.io/gh/diegohaz/parse-prop-types/branch/master)
Parses React `prop-types` into a readable object at runtime.
## Install
$ npm install --save parse-prop-types
## Usage
```jsx
import React from 'react'
import PropTypes from 'prop-types'
import parsePropTypes from 'parse-prop-types'
const MyComponent = ({ name, show }) => (
show ? <div>{name}</div> : null
)
MyComponent.propTypes = {
name: PropTypes.string,
show: PropTypes.oneOfType([PropTypes.bool, propTypes.string]).isRequired,
}
MyComponent.defaultProps = {
name: 'Haz',
}
parsePropTypes(MyComponent)
```
The returned object is compatible with [`react-docgen`](https://github.com/reactjs/react-docgen):
```js
{
name: {
type: {
name: 'string',
},
required: false,
defaultValue: {
value: 'Haz',
},
},
show: {
type: {
name: 'oneOfType',
value: [
{ name: 'bool' },
{ name: 'string' },
],
},
required: true,
},
}
```
## Why not [`react-docgen`](https://github.com/reactjs/react-docgen)?
[`react-docgen`](https://github.com/reactjs/react-docgen) reads file contents in order to find prop types definitions. It has some limitations, such as not allowing computed prop types and, in several situations, not being able to parse file contents correctly.
`parse-prop-types`, on the other hand, doesn't deal with file contents. Instead, it parses prop types at runtime by receiving the component object itself.
## API
<!-- Generated by documentation.js. Update this documentation by updating the source code. -->
#### Table of Contents
- [parsePropTypes](#parseproptypes)
### parsePropTypes
**Parameters**
- `$0` **any**
- `$0.propTypes` (optional, default `{}`)
- `$0.defaultProps` (optional, default `{}`)
Returns **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)**
## License
MIT © [Diego Haz](https://github.com/diegohaz)