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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Fast Refresh este funcția din Vite (și din Next.js, Create React App) care actualizează componenta în browser imediat ce salvezi fișierul, păstrând starea: textul scris în formular, pagina deschisă, contorul. Ca să facă asta în siguranță, trebuie să știe că un fișier conține doar componente.
Dacă un fișier exportă și o componentă, și o valoare obișnuită (export const TVA = 0.19, export function formateazaPret(), export const TemaContext = createContext()), Fast Refresh nu poate înlocui doar componenta: alte fișiere folosesc și valoarea. Atunci reîncarcă modulul și pe cei care îl importă, iar starea se pierde la fiecare salvare.
Regula react-refresh/only-export-components (din eslint-plugin-react-refresh, inclusă în șablonul npm create vite@latest) te avertizează. Variantele mesajului spun și alte cazuri: componente anonime („Fast refresh can't handle anonymous components”) sau fișiere fără exporturi. Codul funcționează și așa; problema e doar experiența de dezvoltare.
De ce apare: cauzele frecvente
1Constantă exportată lângă componentă
// Pret.jsx
export const TVA = 0.19;
export default function Pret({ suma }) {
return <p>{suma * (1 + TVA)} lei</p>;
}// constante.js
export const TVA = 0.19;
// Pret.jsx
import { TVA } from "./constante";
export default function Pret({ suma }) {
return <p>{suma * (1 + TVA)} lei</p>;
}Fișierul componentei exportă acum doar componenta, iar constanta stă într-un fișier fără JSX.
2Context și provider în același fișier
// Tema.jsx
export const TemaContext = createContext("luminoasa");
export function TemaProvider({ children }) { /* ... */ }// temaContext.js
export const TemaContext = createContext("luminoasa");
// TemaProvider.jsx
import { TemaContext } from "./temaContext";
export function TemaProvider({ children }) { /* ... */ }Contextul e o valoare, nu o componentă; separat, providerul poate fi actualizat de Fast Refresh.
3Componentă exportată anonim
export default () => <footer>Contact</footer>;export default function Subsol() {
return <footer>Contact</footer>;
}Fast Refresh recunoaște componentele după nume (cu literă mare); o săgeată anonimă nu are nume.
Repară eroarea, direct în pagină
Fișierul App.jsx de mai jos exportă și componenta, și constanta TVA, iar ESLint spune „Fast refresh only works when a file only exports components”. Constanta există deja în constante.js. Scoate-o din App.jsx și importă TVA de acolo, ca #pret să afișeze în continuare „119 lei”.
export const TVA = 0.19;
export default function App() {
const suma = 100;
return <p id="pret">{Math.round(suma * (1 + TVA))} lei</p>;
}Indiciu
import { TVA } from "./constante";
Reparația
import { TVA } from "./constante";
export default function App() {
const suma = 100;
return <p id="pret">{Math.round(suma * (1 + TVA))} lei</p>;
}De ce merge
Un fișier care exportă și o componentă, și o constantă nu poate fi actualizat de Fast Refresh fără să reîncarce și fișierele care folosesc constanta, așa că starea se pierde la fiecare salvare.
Cu TVA în constante.js, App.jsx exportă doar componenta. Fast Refresh o poate înlocui pe loc, iar valoarea constantei vine din import, deci prețul rămâne 119 lei.
Alte forme ale mesajului
Fast refresh only works when a file only exports components. Use a new file to share constants or functions between components. react-refresh/only-export-componentsFast refresh only works when a file only exports components. Move your component(s) to a separate file.Fast refresh can't handle anonymous components. Add a name to your export.Fast refresh only works when a file has exports. Move your component(s) to a separate file.[vite] hmr invalidate /src/Pret.jsx Could not Fast Refresh. Learn more at https://github.com/vitejs/vite-plugin-react#consistent-components-exports
Cum o eviți pe viitor
- Un fișier
.jsxcu o componentă exportă doar componente (default sau cu nume). - Constantele, funcțiile de formatare și contextele mută-le în fișiere
.jsseparate. - Numește componentele exportate (
export default function Card()), nu le exporta anonim. - Dacă starea se pierde la fiecare salvare, caută în terminal „Could not Fast Refresh”.
Întrebări frecvente
Aplicația funcționează. Trebuie neapărat să repar?
Nu e o eroare a aplicației, ci a experienței de dezvoltare: la fiecare salvare se reîncarcă mai mult și se pierde starea. Separarea fișierelor e simplă și te scapă de asta.
Pot exporta mai multe componente din același fișier?
Da. Regula cere doar ca toate exporturile să fie componente. export function Card() și export function CardMic() în același fișier sunt în regulă.
Erori înrudite
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. Failed to resolve import "./componente/Card" from "src/App.jsx". Does the file exist? Vite nu găsește fișierul pe care îl imporți: calea relativă e greșită (alt folder, ./ lipsă, ../ în plus) sau numele diferă ca litere mari/mici. Verifică unde e fișierul față de cel care îl importă și scrie calea exact, de exemplu import Card from "./Card". Only one default export allowed per module. Un fișier are două sau mai multe export default. Fiecare fișier poate avea un singur export implicit: păstrează export default doar la componenta principală, iar pe celelalte exportă-le cu nume (export function Card) sau mută-le în fișiere separate. Î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.
