Why calling react setState method doesn’t mutate the state immediately?

Why calling react setState method doesn’t mutate the state immediately?

I’m reading Forms section of reactjs documentation and just tried this code to demonstrate onChange usage (JSBIN).
var React= require(‘react’);

var ControlledForm= React.createClass({
getInitialState: function() {
return {
value: “initial value”

handleChange: function(event) {
this.setState({value: event.target.value});


render: function() {
return (



When I update the value in the browser, the second console.log inside the handleChange callback prints the same value as the first console.log, Why I can’t see the result of this.setState({value: event.target.value}) in the scope of handleChange callback?


Solution 1:

From React’s documentation:

setState() does not immediately mutate this.state but creates a
pending state transition. Accessing this.state after calling this
method can potentially return the existing value. There is no
guarantee of synchronous operation of calls to setState and calls may
be batched for performance gains.

If you want a function to be executed after the state change occurs, pass it in as a callback.

this.setState({value: event.target.value}, function () {

Solution 2:

As mentioned in the React documentation, there is no guarantee of setState being fired synchronously, so your console.log may return the state prior to it updating.

Related:  Finding all indexes of a specified character within a string

Michael Parker mentions passing a callback within the setState. Another way to handle the logic after state change is via the componentDidUpdate lifecycle method, which is the method recommended in React docs.

Generally we recommend using componentDidUpdate() for such logic instead.

This is particularly useful when there may be successive setStates fired, and you would like to fire the same function after every state change. Rather than adding a callback to each setState, you could place the function inside of the componentDidUpdate, with specific logic inside if necessary.

// example
componentDidUpdate(prevProps, prevState) {
  if (this.state.value > prevState.value) {

Solution 3:

You could try using ES7 async/await. For instance using your example:

handleChange: async function(event) {
    await this.setState({value: event.target.value});

Solution 4:

Watch out the react lifecycle methods!

I worked for several hours to find out that getDerivedStateFromProps will be called after every setState().


Solution 5:

async-await syntax works perfectly for something like the following…

changeStateFunction = () => {
  // Some Worker..

  this.setState((prevState) => ({
  year: funcHandleYear(),
  month: funcHandleMonth()

goNextMonth = async () => {
  await this.changeStateFunction();
  const history = createBrowserHistory();

goPrevMonth = async () => {
  await this.changeStateFunction();
  const history = createBrowserHistory();

Solution 6:

Simply putting – this.setState({data: value}) is asynchronous in
nature that means it moves out of the Call Stack and only comes back
to the Call Stack unless it is resolved.

Please read about Event Loop to have a clear picture about Asynchronous nature in JS and why it takes time to update –


Hence –

    console.log(this.state.data); // will give undefined or unupdated value

as it takes time to update.
To achieve the above process –

    this.setState({data:value},function () {