...
Eroare React · useEffect și încărcarea datelor

Unexpected reserved word 'await'.

Pe scurt

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

Greșit
JSX
useEffect(() => {
  const r = await fetch(url);
  setDate(await r.json());
}, []);
Corect
JSX
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

Greșit
JSX
function trimite(e) {
  e.preventDefault();
  await fetch("/api/comanda", { method: "POST" });
}
Corect
JSX
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

Greșit
JSX
async function incarcaToate(ids) {
  ids.forEach((id) => {
    await fetch("/api/p/" + id);
  });
}
Corect
JSX
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ă tu

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.

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

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 useEffect folosește mereu tiparul „funcție async interioară + apel”.
  • Când scrii await, uită-te imediat la funcția care îl conține: are async?
  • Pentru mai multe cereri în paralel folosește Promise.all, nu await în forEach.
  • Poți folosi și .then(...), care nu are nevoie de async.

Î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

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