Install and use React DevTools

Kent C. Dodds
InstructorKent C. Dodds
Share this video with your friends

Social Share Links

Send Tweet

It’s dangerous to go alone. Here take this: React DevTools. The React Developer Tools extension is extremely useful in developing and debugging React applications. In this lesson we’ll get it installed and play around with some of the features. Definitely take some time to play around with the DevTools on your own. You’ll be using these a lot.

Instructor: [0:00] Here, I can fill out a Pokémon name like Pikachu. I submit. I get some Pikachu data. If I make a typo here, then I'm not going to get anything back. It might be useful for me to get an understanding of what's going on behind the scenes in the state of the components that I'm rendering to this page so that I can debug the problems that are happening in my components.

[0:22] What I'm going to do is I'm going to Google React DevTools. That'll come up with the Chrome Web Store for React DevTools. There's also React DevTools supported for other browsers. I'm using Chrome, so I'm going to add this to Chrome. Click on "Add Extension." Then React Developer Tools has been added to Chrome. I can use that by clicking on that icon.

[0:47] When I come back to my app, I'll go ahead and refresh here. We'll see that Chrome extension icon for React DevTools has turned red. That's indicating to us that React is on this page and we're using the development build of React.

[1:01] When we use the production build of React, then this will look a little differently. We can see that by going to twitter.com because Twitter is built using React. Here, this page is using the production build of React. If we close this and now I open up my DevTools, I can go inspect here, or I can go here to More Tools and Developer Tools.

[1:26] That'll open up the Developer Tools here. If I click here and look at components, then this is going to show me the components that are driving this page. I can see that we have an app component and we have a Pokémon info component.

[1:42] Under the app component, I can see all of the hooks that are being used for this app component to work. We have some state here that is an empty string. As I type in here and click submit, now we see that that state is what I typed. We can even change that value here. We can click undo if we want to undo that change, or we can hit enter to commit that value.

[2:05] Now that value has been committed. You will see that we get null is printed because there is no Pokémon by the name of value. If we change this to Mew and hit enter, then we're going to retrieve Mew's information. On the Pokémon info side, we can see the Pokémon name is coming in via props. We can actually change this prop to Mewtwo. Change that prop there.

[2:28] Then we can also see the hooks that are being used by the Pokémon info component. We have state is resolved. We also have some more state for the Pokémon information itself and some more state. This is for our error state. We can see this hook also has an effect.

[2:45] There are a lot of options that we have here. We can click on this. That will show me the source code for this particular component. If we go back to our components here and click on this button, then that will log this component's information to the console.

[2:59] We can click that to expand it. We'll see the props, the hooks, and the root DOM node that's being rendered by this component. We'll come back here again. If you want to, you can actually drag this over, since we're going to be using this a lot. I'm going to move that over there.

[3:14] We also have this button to inspect the matching DOM element. That'll take us straight to our elements tab here with that element highlighted. Then this is for Suspense. If you're using any React Suspense components, you can test those out here by suspending the selected component. We also have some options here for the theme and the way that this is displayed.

[3:37] Then we also have some view options for our components tab, where we can filter out different types of components or ever filter them out by their name. If we wanted to get rid of that app, then we could type that in. Now our app is no longer being shown. I do want to show that, so I'll remove that. Now our app is being shown.

[3:59] We also have a profiler tab that will help us debug performance issues in our app. We can enable record while each component is rendering. We can also hide commits below a certain threshold. If a commit is really fast -- maybe it only takes five milliseconds to update the DOM -- then we can enable that.

[4:16] Now I can go to my profiler. I'll drag that over here as well. We can hit this button to start profiling where we are, or we can hit this button to reload and start profiling when the page loads. We'll click on that. Then we can click stop. We'll see that there's no data matching the current filter criteria.

[4:35] Let's go ahead and we'll uncheck this button. Now we can see that there was a commit. It just happened really fast. That commit was for the initial render of our component. We have our app and our Pokémon info. It says that this was rendered because it's the first time that it was rendered.

[4:51] Now let's go ahead and do another recording. We'll say Mew. We'll submit that and then hit stop. We'll see a couple of commits here. For this one, it re-rendered because hooks changed and props changed.

[5:05] For this one, it re-rendered because hooks changed. On this commit, it re-rendered because hooks changed again, so the data came back from the Pokémon request. Then this re-rendered because we updated our state.

[5:19] The React DevTools gives us this components and this profiler tab in our Developer Tools to give us a lot of insight into what our components are doing while we're developing them. Then we also have this indicator up here to tell us when we're using the development build of React versus the production build so we can make sure that our production application uses the production build.

[5:40] One last pro tip I want to show you is if you open up the console while you have the components tab open -- you can do that by hitting the escape key -- then we have our console here. You can type $r. That will give you the hooks, the props, and the type for the component that you have currently selected.

[5:58] We can click on the app. We can do $r again. Now we'll see the hooks, the props, and the type for that component that we have selected. This is actually very similar to the elements tab, where you can do a $.

[6:09] That will give you the DOM node that you have currently selected in the elements tab. In the components tab, you have a $r. That will give you information on the component that you have currently selected.

[6:22] I strongly advise that you install the React DevTools and play around with them so you become familiar with their capabilities and make you more productive developing React applications.