Tutorial

React Devtools: A Brief Introduction

Published on May 21, 2018
author

Patrick Moriarty

React Devtools: A Brief Introduction

React Developer Tools (Devtools for short) is a browser extension for Chrome and Firefox that provides an extra set of React-specific inspection widgets to assist you with development. By installing React Devtools, you’ll get two main features: a view of the component tree and the current state and props of each component you select.

Let’s get debugging!

Getting Started

To install React Devtools, visit the extension page for your browser of choice — Chrome or Firefox — and find the install button.

The images in this tutorial are captured from Chrome, but the Firefox version has no notable differences. If you use a different browser, or perhaps need to inspect a React Native app, React Devtools is available as a standalone application. You can read more about that here.

After installation, the extension requires no further setup. If you find yourself unable to access the toolkit, try reopening your browser or verifying that Devtools can access the React instance on the page by clicking the React logo next to your address bar:

React Devtools button

Inspecting Your App

The quickest way to open React Devtools is to right click your page and select inspect.

On your browser’s inspection window, select the React tab, and you should be presented with a view of your app’s component hierarchy:

React devtools component hierarchy

If you’ve used Chrome or Firefox’s developer tools, this view should look a little familiar to you. The view of our app’s component tree is similar to the plain HTML tree you’d see on the Elements tab, but there are some improvements:

  • Our React elements are displayed next to plain HTML elements and are selectable.
  • Selected React elements have a real-time view of the instance’s state and props (as seen on the right). This is great for debugging!
  • The tabs at the bottom represent the path from the top of the tree to our selected element. In this case, MyComponent is a child of div, which is a child of App.

Extra Features

Inline element selection

Much like the plain-HTML element select feature in Chrome and Firefox, React Devtools has a feature to select React components on the page. Click the bullseye button, then select an element on the page:

Inline select

You’ll notice we can’t select MyComponent directly, but we can get pretty close by using the selection tool.

In cases where your component tree is tall or complex, the search feature comes to the rescue.

Search

Console debugging

One often-overlooked feature in React Devtools is the ability to access selected elements in the JavaScript console. Notice the $r next to selected elements in the component tree — this is the name of the variable we can use to access the instance:

Console access

Final Thoughts

The same thing that makes debugging React applications a struggle for some also makes it a breeze for others. In most cases, debugging reactively simply means closely inspecting your app’s state or view.

Mastering the features in React Devtools is a highly effective way to do both of these tasks at once.

Thanks for learning with the DigitalOcean Community. Check out our offerings for compute, storage, networking, and managed databases.

Learn more about our products

About the authors
Default avatar
Patrick Moriarty

author

While we believe that this content benefits our community, we have not yet thoroughly reviewed it. If you have any suggestions for improvements, please let us know by clicking the “report an issue“ button at the bottom of the tutorial.

Still looking for an answer?

Ask a questionSearch for more help

Was this helpful?
 
Leave a comment


This textbox defaults to using Markdown to format your answer.

You can type !ref in this text area to quickly search our full set of tutorials, documentation & marketplace offerings and insert the link!

Try DigitalOcean for free

Click below to sign up and get $200 of credit to try our products over 60 days!

Sign up

Join the Tech Talk
Success! Thank you! Please check your email for further details.

Please complete your information!

Featured on Community

Get our biweekly newsletter

Sign up for Infrastructure as a Newsletter.

Hollie's Hub for Good

Working on improving health and education, reducing inequality, and spurring economic growth? We'd like to help.

Become a contributor

Get paid to write technical tutorials and select a tech-focused charity to receive a matching donation.

Welcome to the developer cloud

DigitalOcean makes it simple to launch in the cloud and scale up as you grow — whether you're running one virtual machine or ten thousand.

Learn more