...
Eroare React · Pornirea aplicației, importuri și configurare

Fast refresh only works when a file only exports components. Use a new file to share constants or functions between components.

Pe scurt

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ă

Greșit
JSX
// Pret.jsx
export const TVA = 0.19;
export default function Pret({ suma }) {
  return <p>{suma * (1 + TVA)} lei</p>;
}
Corect
JSX
// 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

Greșit
JSX
// Tema.jsx
export const TemaContext = createContext("luminoasa");
export function TemaProvider({ children }) { /* ... */ }
Corect
JSX
// 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

Greșit
JSX
export default () => <footer>Contact</footer>;
Corect
JSX
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ă tu

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”.

Codul care dă eroarea
JSX
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";

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-components
  • Fast 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 .jsx cu o componentă exportă doar componente (default sau cu nume).
  • Constantele, funcțiile de formatare și contextele mută-le în fișiere .js separate.
  • 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

← Toate erorile React

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.