Unexpected reserved word 'await'.
Ai folosit await într-o funcție care nu e async, de obicei direct în callback-ul din useEffect sau într-un handler. Scrie o funcție async în interiorul efectului și apeleaz-o (const incarca = async () => {...}; incarca();), sau marchează handler-ul cu async.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
await poate fi folosit doar într-o funcție marcată cu async. În afara ei, await este un cuvânt rezervat, iar compilatorul se oprește când îl întâlnește.
În React apare aproape mereu în useEffect: scrii useEffect(() => { const r = await fetch(...) }, []), iar funcția-săgeată din efect nu e async. Prima idee e să pui async direct pe ea, dar useEffect(async () => ...) dă alt avertisment: efectul ar întoarce o promisiune în loc de o funcție de curățare.
Tiparul corect: definești o funcție async în interiorul efectului și o apelezi imediat. În handler-ele de evenimente (onClick, onSubmit) poți pune direct async pe funcție. Linia și coloana din mesaj arată exact await-ul problematic.
De ce apare: cauzele frecvente
1await direct în useEffect
useEffect(() => {
const r = await fetch(url);
setDate(await r.json());
}, []);useEffect(() => {
async function incarca() {
const r = await fetch(url);
setDate(await r.json());
}
incarca();
}, []);Funcția interioară este async, iar efectul rămâne o funcție obișnuită care nu întoarce o promisiune.
2Handler fără async
function trimite(e) {
e.preventDefault();
await fetch("/api/comanda", { method: "POST" });
}async function trimite(e) {
e.preventDefault();
await fetch("/api/comanda", { method: "POST" });
}Handler-ele de evenimente pot fi async; React doar le apelează și nu folosește ce întorc.
3await într-un callback din map sau forEach
async function incarcaToate(ids) {
ids.forEach((id) => {
await fetch("/api/p/" + id);
});
}async function incarcaToate(ids) {
await Promise.all(ids.map((id) => fetch("/api/p/" + id)));
}async de pe funcția exterioară nu se aplică și callback-ului; Promise.all așteaptă toate cererile corect.
Repară eroarea, direct în pagină
Componenta de mai jos încarcă lista de utilizatori, dar nu compilează: dă eroarea „Unexpected reserved word 'await'”. Repar-o ca, după încărcare, să apară câte un li pentru fiecare utilizator primit (Ana și Mihai), păstrând await pentru cerere.
import { useState, useEffect } from "react";
export default function App() {
const [useri, setUseri] = useState([]);
useEffect(() => {
const r = await fetch("https://api.exemplu.ro/useri");
const date = await r.json();
setUseri(date);
}, []);
return (
<ul>
{useri.map((u) => <li key={u.id}>{u.nume}</li>)}
</ul>
);
}Indiciu
Definește o funcție async în interiorul efectului și apeleaz-o.
Reparația
import { useState, useEffect } from "react";
export default function App() {
const [useri, setUseri] = useState([]);
useEffect(() => {
async function incarca() {
const r = await fetch("https://api.exemplu.ro/useri");
const date = await r.json();
setUseri(date);
}
incarca();
}, []);
return (
<ul>
{useri.map((u) => <li key={u.id}>{u.nume}</li>)}
</ul>
);
}De ce merge
await este permis doar într-o funcție async. Funcția-săgeată dată lui useEffect nu era async, așa că Babel a oprit compilarea la primul await.
Funcția incarca din interiorul efectului este async, deci poate aștepta cererea și conversia JSON. Efectul doar o apelează și nu întoarce nimic, exact cum cere React. Când datele sosesc, setUseri produce o randare nouă cu lista.
Alte forme ale mesajului
SyntaxError: Unexpected reserved word 'await'. (7:16)SyntaxError: await is only valid in async functions and the top level bodies of modules'await' expressions are only allowed within async functions and at the top levels of modules.
Cum o eviți pe viitor
- În
useEffectfolosește mereu tiparul „funcție async interioară + apel”. - Când scrii
await, uită-te imediat la funcția care îl conține: areasync? - Pentru mai multe cereri în paralel folosește
Promise.all, nuawaitînforEach. - Poți folosi și
.then(...), care nu are nevoie deasync.
Întrebări frecvente
De ce nu pot scrie useEffect(async () => ...)?
O funcție async întoarce mereu o promisiune, iar useEffect așteaptă ca efectul să întoarcă nimic sau o funcție de curățare. React te avertizează, iar curățarea nu ar mai funcționa.
Ce e „top level await” din mesajul browserului?
În modulele JavaScript moderne poți folosi await direct în afara funcțiilor, la nivelul fișierului. Într-o componentă însă ești mereu într-o funcție, deci ai nevoie de async.
Erori înrudite
Warning: useEffect must not return anything besides a function, which is used for clean-up. Ai scris useEffect(async () => ...): o funcție async întoarce o promisiune, iar efectul are voie să întoarcă doar o funcție de curățare. Definește funcția async în interiorul efectului și apeleaz-o. TypeError: Failed to fetch Cererea fetch nu a primit niciun răspuns: serverul nu rulează, adresa e greșită (alt port, http/https) sau browserul a blocat-o (CORS). Verifică adresa în tab-ul Network și prinde eroarea cu .catch ca să afișezi un mesaj. Objects are not valid as a React child (found: object with keys {nume, email}). If you meant to render a collection of children, use an array instead. Ai pus un obiect întreg între acolade în JSX, iar React nu știe să-l afișeze. Afișează o proprietate a lui ({utilizator.nume}), transformă-l în text sau, la un tablou de obiecte, folosește map. Î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.
