Search code examples
reactjseslint

What is React Component 'displayName' Used For?


I know that is it considered a good practice to name react component by adding a displayName property, but not sure I know why. In the React docs, it says:

The displayName string is used in debugging messages. JSX sets this value automatically; see JSX in Depth.

Why is this so important? What will happen if I don't add it? (So far I haven't had it and had no issues debugging.)

Are there any recommendations / good practices on how to name the components?


Solution

  • I have always set displayName to the same name as the variable I am assigning it to. This would have been used in development builds as it is removed through dead-code elimination on production builds and should not be relied on within your application.

    As for where it is used, that is mainly within react error messaging. This is why it is mentioned to be valuable for debugging. If no name can be derived the error messages default to say Component which is extremely difficult to debug, when you have any more than 1 component in your project.

    Here are a few error messages that reference displayName in the react source:

    Invalid Return

    Inline style error