What are you looking for?

Be careful with console.log when using React.StrictMode

I would even argue that it undermines the concept of StrictMode.
By
  • Blog
  • >
  • Be careful with console.log when using React.StrictMode

At Camunda, we have a mentoring program where junior and senior engineers come together to share their knowledge and experience to become better engineers. Very often, we  look at what we are currently working on and discuss potential solutions and problems that we encounter.

In one of these mentoring sessions, we came across some very interesting behavior involving console.log and React.Strict mode. After a bit of digging we came up with this minimal example: 

let i = 0;

function App() {
  i++;
  console.log("render count:", i);
  return i;
}

ReactDOM.render(
  <React.StrictMode>
    <App />
  </React.StrictMode>,
  document.getElementById("root")
);

My mentee looked at this code and said “Okay, we are rendering the App component, this increases the i counter, prints it to the console and returns it. So the result is “render count: 1” in the browser log and 1 is rendered on screen.”

I knew of the intricacies of React.Strict mode and that it would cause the render function to be called twice. The idea is that this will help developers identify unintended side-effects in methods that should be side-effect free. You can read more about that here.

After working through it, we came up with an updated theory of what should happen: “React intentionally calls the render function twice, so i will be increased twice. We will see two entries in the browser console “render count: 1” and then “render count: 2” and the screen will render 2.”

But this is still not what was happening. If you run this code, there is only one console log saying “render count: 1”, but the screen shows 2. You can see this for yourself.

What is going on?

The only place where the value of i is increased, is directly followed by a console.log statement, so if i was set to 2, it should show up in the console.

It turns out that React is hijacking console.log and replaces it with a function that does nothing on the second render pass. Here is the code that does that, this is the Pull Request that introduced this behavior and here is an open Pull Request to add an opt-out option to the dev tools.

In our example the render function is indeed executed twice, which leads to i being 2 when it is rendered on screen, but only the first console.log call actually logs to the console, so it looks like the render function is only called once and i is only set to 1.

The Outcome

After discovering this issue, we brought it up in one of Camunda’s frontend engineering meetings to make all teams aware of this very specific behavior. We discussed that developers not familiar with StrictMode will try to use console.log debugging, to figure out why their functions are executed twice. If the logs for the second pass don’t show up in the console, developers might falsely assume that the function is only executed once.

I would even argue that it undermines the concept of StrictMode. Printing to the console is a side-effect that StrictMode is supposed to expose. Intentionally obscuring it not only makes debugging harder, it prevents developers finding rogue log statements in render phase lifecycle methods that could cause problems in production once concurrent mode lands.

But now that we are aware of this issue, we can avoid this particular pitfall and know how to deal with it should it come up when building new features or fixing issues.


Sebastian Stamm is a Principal Software Engineer at Camunda. You can follow his work on Twitter, Dev.to and https://stamm-software.com/.

Camunda Developer Community

Join Camunda’s global community of developers sharing code, advice, and meaningful experiences

Try All Features of Camunda

Related Content

Transition from simple deployments to a fully integrated production setup smoothly.
We're excited to announce the November 2024 alpha release of Camunda. Check out what's new.
We want to extend a huge welcome to our latest cohort of Camunda Champions. Learn about the latest group of leaders and what being a Champion means to them.