History

Raphael Amorim b3e27b2640 react-rt-renderer, react-cs-renderer, react-call-return: Convert vars to let/const (#11721 ) * react-call-return: convert var to let/const * react-cs-renderer: convert var to let/const * react-rt-renderer: convert var to let/const		2017-11-30 21:40:12 +00:00
..
npm	Add react-call-return package (#11364 )	2017-10-25 22:23:55 +03:00
src	react-rt-renderer, react-cs-renderer, react-call-return: Convert vars to let/const (#11721 )	2017-11-30 21:40:12 +00:00
README.md	Add a link to RCR explanation	2017-11-03 00:47:54 +00:00
index.js	Add react-call-return package (#11364 )	2017-10-25 22:23:55 +03:00
package.json	Updating package versions for release 16.2.0	2017-11-28 13:26:36 -08:00

README.md

react-call-return

This is an experimental package for multi-pass rendering in React.

Its API is not as stable as that of React, React Native, or React DOM, and does not follow the common versioning scheme.

Use it at your own risk.

No, Really, It Is Unstable

This is an experiment.

We will replace this with a different API in the future.
It can break between patch versions of React.

We also know that it has bugs.

Don't rely on this for anything except experiments.
Even in experiments, make sure to lock the versions so that an update doesn't break your app.

Don't publish third party components relying on this unless you clearly mark them as experimental too.
They will break.

Have fun! Let us know if you find interesting use cases for it.

API

See the test case in src/__tests__/ReactCallReturn.js for an example.

What and Why

The API is not very intuitive right now, but this is a good overview of why it might be useful in some cases. We are very open to better API ideas for this concept.