`'` can be escaped with `'`, `‘`, `'`, `’`.
Regula ESLint react/no-unescaped-entities nu acceptă caracterele ', ", > și } scrise direct în textul JSX. Înlocuiește-le cu entitatea HTML propusă (', ", >, }) sau pune textul într-o expresie: {"Rock'n'roll"}.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul vine de la ESLint, regula react/no-unescaped-entities (activă în plugin:react/recommended și în next lint, unde blochează chiar și build-ul). Ea verifică textul dintre taguri și se plânge de patru caractere: ', ", > și }.
De ce? Un apostrof sau o ghilimea uitată în text arată adesea ca un atribut care a „scăpat” din tag (de exemplu <a href="x"">), iar > și } sunt de obicei semnul unui tag sau al unei acolade închise greșit. Regula te obligă să spui clar că vrei caracterul în text.
Mesajul îți dă și variantele: pentru ' poți folosi ', ‘, ' sau ’ (apostroful tipografic ’). Pentru ": ", “, ", ”. Pentru >: >, iar pentru }: }. La fel de bine merge să pui textul într-un șir JavaScript între acolade.
De ce apare: cauzele frecvente
1Apostrof în text
<h2>Rock'n'roll pentru începători</h2><h2>Rock'n'roll pentru începători</h2>
// sau: <h2>{"Rock'n'roll pentru începători"}</h2>Entitatea ' sau șirul din acolade afișează același apostrof, iar regula vede că e intenționat.
2Ghilimele drepte în text
<p>Apasă pe "Comandă" ca să finalizezi.</p><p>Apasă pe „Comandă” ca să finalizezi.</p>
// sau: <p>Apasă pe "Comandă" ca să finalizezi.</p>Ghilimelele românești „” nu sunt verificate de regulă; ghilimelele drepte se scriu ca ".
3Semnul > într-o comparație afișată
<p>Livrare gratuită la comenzi > 200 lei</p><p>Livrare gratuită la comenzi > 200 lei</p>> se afișează ca >, dar nu mai poate fi confundat cu sfârșitul unui tag.
Repară eroarea, direct în pagină
Componenta de mai jos afișează corect lista de cursuri, dar ESLint o oprește cu „' can be escaped with ', ‘, ', ’.”. Repară textul din h2 fără să schimbi ce se vede: titlul trebuie să rămână „Rock'n'roll pentru începători”, cu apostrofuri drepte.
export default function App() {
return (
<section>
<h2>Rock'n'roll pentru începători</h2>
<p id="pret">Preț: 120 lei</p>
</section>
);
}Indiciu
Folosește ' sau pune tot textul într-un șir între acolade.
Reparația
export default function App() {
return (
<section>
<h2>Rock'n'roll pentru începători</h2>
<p id="pret">Preț: 120 lei</p>
</section>
);
}De ce merge
Pentru React, apostroful din text era corect, dar regula react/no-unescaped-entities cere ca ' să fie scris explicit, ca să nu fie confundat cu un atribut scăpat din tag.
' este entitatea HTML a apostrofului drept: JSX o transformă în caracterul ', așa că pagina arată la fel, iar ESLint vede că apostroful e intenționat. Varianta {"Rock'n'roll pentru începători"} are același efect.
Alte forme ale mesajului
`"` can be escaped with `"`, `“`, `"`, `”`.`>` can be escaped with `>`.`}` can be escaped with `}`.Error: `'` can be escaped with `'`, `‘`, `'`, `’`. react/no-unescaped-entities
Cum o eviți pe viitor
- În textele românești folosește ghilimelele „” și apostroful tipografic ’, care nu sunt verificate de regulă.
- Textele lungi sau venite din traduceri ține-le în variabile ori în fișiere separate și afișează-le cu
{text}. - Rulează
npm run lintînainte de build: în Next.js regula opreștenext build. - Nu dezactiva regula global; dacă vrei, configurează doar caracterele verificate (opțiunea
forbid).
Întrebări frecvente
Codul rulează corect în browser. Trebuie neapărat să repar?
Pentru React textul e valid, deci pagina arată bine. Dar în proiectele cu next lint sau cu ESLint în CI, eroarea blochează build-ul, așa că e mai simplu să folosești entitatea sau un șir în acolade.
Care variantă e cea mai bună?
Pentru text românesc, ghilimelele „” și apostroful ’ arată cel mai bine și nu cer nimic special. Pentru un apostrof drept, {"..."} e cel mai lizibil când textul are mai multe.
Erori înrudite
Comments inside children section of tag should be placed inside braces Ai scris un comentariu JavaScript (// sau /* */) direct între taguri JSX, iar React îl afișează ca text în pagină. Regula ESLint react/jsx-no-comment-textnodes te avertizează. În JSX, comentariile se scriu între acolade: {/* comentariu */}. SyntaxError: Unexpected token Între acoladele din JSX ai pus o instrucțiune (if, for, o declarație) sau un comentariu HTML. Acolo merg doar expresii: folosește condiție && <p>...</p>, operatorul ? : sau map. JSX value should be either an expression or a quoted JSX text. Valoarea unui atribut JSX nu este nici între ghilimele, nici între acolade, de exemplu value=nume. Pune variabilele între acolade (value={nume}) și textul fix între ghilimele (type="text"). Î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.
