Component definition is missing display name
Regula ESLint react/display-name vede o componentă fără nume: de obicei o funcție-săgeată anonimă în forwardRef sau memo, ori un export default anonim. Dă-i un nume (forwardRef(function Camp(props, ref) {...})) sau setează Camp.displayName = "Camp", ca să apară corect în React DevTools și în mesajele de eroare.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
React afișează numele componentelor în React DevTools și în stiva avertismentelor (at Camp). Numele vine din numele funcției. Când componenta e o funcție anonimă, React nu are ce afișa și scrie Anonymous sau ForwardRef, iar căutarea unei probleme devine mult mai grea.
Regula react/display-name (din plugin:react/recommended) raportează componentele al căror nume nu poate fi dedus. Cazurile tipice:
forwardRef((props, ref) => ...)– săgeata din interior e anonimă;memo((props) => ...)sauexport default memo(() => ...);export default () => <div />;– export implicit fără nume;- componente create de o funcție (higher-order component) care întoarce o clasă sau funcție anonimă.
Reparația: dă funcției un nume (function Camp(props, ref)) sau setează explicit proprietatea displayName. Comportamentul aplicației nu se schimbă, doar diagnosticarea devine mai ușoară.
De ce apare: cauzele frecvente
1Săgeată anonimă în forwardRef
const Camp = forwardRef((props, ref) => (
<input ref={ref} {...props} />
));const Camp = forwardRef(function Camp(props, ref) {
return <input ref={ref} {...props} />;
});Funcția cu nume îi dă componentei numele Camp în DevTools și în avertismente.
2Export default anonim
export default () => {
return <footer>Contact</footer>;
};export default function Subsol() {
return <footer>Contact</footer>;
}O funcție declarată cu nume are numele deja la definire.
3Componentă creată de o funcție
function cuChenar(Componenta) {
return (props) => <div className="chenar"><Componenta {...props} /></div>;
}function cuChenar(Componenta) {
function CuChenar(props) {
return <div className="chenar"><Componenta {...props} /></div>;
}
CuChenar.displayName = "CuChenar(" + (Componenta.displayName || Componenta.name) + ")";
return CuChenar;
}displayName setat explicit arată în DevTools ce componentă a fost împachetată.
Repară eroarea, direct în pagină
Componenta Camp de mai jos e creată cu forwardRef dintr-o săgeată anonimă, iar ESLint spune „Component definition is missing display name”. Dă-i un nume, ca regula să treacă, iar după click pe #focus câmpul #email să primească focus.
import { useRef, forwardRef } from "react";
const Camp = forwardRef((props, ref) => (
<input ref={ref} {...props} />
));
export default function App() {
const emailRef = useRef(null);
return (
<div>
<Camp id="email" ref={emailRef} />
<button id="focus" onClick={() => emailRef.current.focus()}>Scrie emailul</button>
</div>
);
}Indiciu
forwardRef(function Camp(props, ref) { return ...; })
Reparația
import { useRef, forwardRef } from "react";
const Camp = forwardRef(function Camp(props, ref) {
return <input ref={ref} {...props} />;
});
export default function App() {
const emailRef = useRef(null);
return (
<div>
<Camp id="email" ref={emailRef} />
<button id="focus" onClick={() => emailRef.current.focus()}>Scrie emailul</button>
</div>
);
}De ce merge
Săgeata dată lui forwardRef era anonimă, așa că React nu putea afla numele componentei: în DevTools și în avertismente apărea doar ForwardRef. Regula react/display-name cere un nume clar.
function Camp(props, ref) are numele Camp, pe care React îl folosește peste tot. Ref-ul ajunge la input exact ca înainte, deci butonul pune focus pe câmp.
Alte forme ale mesajului
Component definition is missing display name react/display-nameerror Component definition is missing display name react/display-name
Cum o eviți pe viitor
- Scrie componentele ca funcții cu nume:
function Card() {}sauconst Card = () => {}(aici numele vine din variabilă). - În
forwardRefșimemo, pune o funcție cu nume în loc de săgeată anonimă. - La componentele create de funcții (HOC), setează
displayName. - Verifică din când în când arborele în React DevTools: orice
Anonymousmerită un nume.
Întrebări frecvente
Aplicația merge. De ce contează?
Contează la depanare: în DevTools și în stivele de erori vezi Anonymous sau ForwardRef în loc de Camp, iar într-o aplicație mare nu mai știi care e componenta cu probleme.
De ce const Card = () => ... nu dă eroarea, dar forwardRef(() => ...) da?
JavaScript dă automat numele variabilei unei săgeți atribuite direct (Card.name === "Card"). În forwardRef(() => ...), săgeata e un argument, nu o atribuire, deci rămâne fără nume.
Erori înrudite
Warning: Function components cannot be given refs. Attempts to access this ref will fail. Did you mean to use React.forwardRef()? Ai pus ref={...} pe o componentă funcție a ta, nu pe un element HTML. În React 18 ref nu ajunge în props, deci ref.current rămâne null. Învelește componenta în forwardRef și pune ref-ul primit pe elementul HTML din interior. Warning: forwardRef render functions accept exactly two parameters: props and ref. Did you forget to use the ref parameter? Funcția dată lui forwardRef are un singur parametru (props), deci ref-ul primit nu e folosit. Adaugă al doilea parametru, ref, și pune-l pe elementul HTML din componentă: forwardRef((props, ref) => <input ref={ref} {...props} />). Fast refresh only works when a file only exports components. Use a new file to share constants or functions between components. Regula ESLint react-refresh/only-export-components (din șablonul Vite) vede că fișierul exportă și componente, și altceva (o constantă, o funcție, un context). Așa, Fast Refresh nu mai poate păstra starea la salvare și reîncarcă tot. Mută constantele și funcțiile comune într-un fișier separat (utils.js, constante.js) și importă-le de acolo. Învață React de la zero, cu exerciții la fiecare lecție
Curs React: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
