Warning: A component is changing an uncontrolled input to be controlled. This is likely caused by the value changing from undefined to a defined value, which should not happen. Decide between using a controlled or uncontrolled input element for the lifetime of the component.
Câmpul a pornit cu value={undefined} (necontrolat) și apoi a primit un text (controlat). Dă state-ului o valoare inițială: useState("") sau, pentru un formular, useState({ email: "", parola: "" }).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
React împarte câmpurile în două feluri: necontrolate (fără value, sau cu value={undefined}), unde browserul ține textul, și controlate (value cu un string), unde îl ține React. Un câmp trebuie să rămână de același fel toată viața lui.
Mesajul spune chiar cauza: valoarea s-a schimbat din undefined într-o valoare definită. Se întâmplă când state-ul pornește gol: useState() sau un obiect fără câmpul respectiv (useState({}) și value={form.email}). La prima randare value este undefined, deci câmpul e necontrolat; la prima tastă devine string, deci controlat.
Inversul are propriul mesaj („changing a controlled input to be uncontrolled”), de obicei când un setForm uită să păstreze celelalte câmpuri, iar unul devine undefined.
De ce apare: cauzele frecvente
1State pornit fără valoare
const [email, setEmail] = useState();
<input value={email} onChange={(e) => setEmail(e.target.value)} />const [email, setEmail] = useState("");
<input value={email} onChange={(e) => setEmail(e.target.value)} />Cu "" câmpul este controlat încă de la prima randare.
2Obiect de formular fără câmpuri
const [form, setForm] = useState({});
<input name="email" value={form.email} onChange={schimba} />const [form, setForm] = useState({ email: "", parola: "" });
<input name="email" value={form.email} onChange={schimba} />Fiecare câmp are de la început un string, nu undefined.
3Actualizare care pierde celelalte câmpuri
setForm({ [e.target.name]: e.target.value });setForm((f) => ({ ...f, [e.target.name]: e.target.value }));Fără spread, celelalte câmpuri dispar din obiect și devin undefined.
Repară eroarea, direct în pagină
Formularul de autentificare de mai jos pornește cu useState({}), iar la prima tastă consola arată „A component is changing an uncontrolled input to be controlled”. Dă state-ului valori inițiale pentru ambele câmpuri, ca, după ce scrii emailul „ana@exemplu.ro” în #email, paragraful #rezumat să afișeze „Email: ana@exemplu.ro”.
import { useState } from "react";
export default function App() {
const [form, setForm] = useState({});
function schimba(e) {
setForm((f) => ({ ...f, [e.target.name]: e.target.value }));
}
return (
<form>
<input id="email" name="email" value={form.email} onChange={schimba} />
<input id="parola" name="parola" type="password" value={form.parola} onChange={schimba} />
<p id="rezumat">Email: {form.email}</p>
</form>
);
}Indiciu
Fiecare câmp are nevoie de un string inițial.
Reparația
import { useState } from "react";
export default function App() {
const [form, setForm] = useState({ email: "", parola: "" });
function schimba(e) {
setForm((f) => ({ ...f, [e.target.name]: e.target.value }));
}
return (
<form>
<input id="email" name="email" value={form.email} onChange={schimba} />
<input id="parola" name="parola" type="password" value={form.parola} onChange={schimba} />
<p id="rezumat">Email: {form.email}</p>
</form>
);
}De ce merge
Cu useState({}), form.email și form.parola sunt undefined la prima randare, deci React consideră ambele câmpuri necontrolate. La prima tastă form.email devine un string și câmpul trece în modul controlat, iar React te avertizează că un câmp nu trebuie să-și schimbe modul.
Cu { email: "", parola: "" }, ambele câmpuri sunt controlate încă de la început și rămân așa: React ține mereu valoarea, iar handler-ul doar o actualizează.
Alte forme ale mesajului
Warning: A component is changing a controlled input to be uncontrolled. This is likely caused by the value changing from a defined to undefined, which should not happen.Warning: `value` prop on `input` should not be null. Consider using an empty string to clear the component or `undefined` for uncontrolled components.
Cum o eviți pe viitor
- Dă mereu valori inițiale state-ului unui formular:
""pentru text,falsepentru checkbox. - Când datele vin dintr-un API și pot avea câmpuri
null, foloseștevalue={date.telefon ?? ""}. - La actualizarea unui obiect de formular, păstrează restul câmpurilor cu
...f.
Întrebări frecvente
Formularul merge. Avertismentul contează?
Da: trecerea dintre cele două moduri poate pierde textul scris sau poziția cursorului și face comportamentul greu de prevăzut. Repararea e o singură valoare inițială.
Valoarea vine din API ca null. Ce fac?
value={null} produce un avertisment asemănător. Transformă la afișare: value={utilizator.telefon ?? ""}.
Erori înrudite
Warning: You provided a `value` prop to a form field without an `onChange` handler. This will render a read-only field. If the field should be mutable use `defaultValue`. Otherwise, set either `onChange` or `readOnly`. Câmpul are value legat de state, dar fără onChange, deci React îl blochează: orice scrii dispare. Adaugă onChange={(e) => setNume(e.target.value)} sau folosește defaultValue dacă nu ai nevoie de state. TypeError: Cannot read properties of undefined (reading 'map') Apelezi .map pe o variabilă care este undefined, de obicei pentru că datele nu s-au încărcat încă sau prop-ul nu a fost trimis. Pornește state-ul cu un tablou gol, useState([]), sau verifică variabila înainte de map. ReferenceError: e is not defined Folosești e.target.value într-un handler care nu primește parametrul e: onChange={() => setNume(e.target.value)}. Declară parametrul: onChange={(e) => setNume(e.target.value)}. Î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.
