SyntaxError: Illegal await-expression in formal parameters of async function
Ai folosit await în valoarea implicită a unui parametru: async function f(tva = await citesteTva()). Parametrii sunt evaluați înainte de corpul funcției, unde await nu e permis. Mută await în corp: tva ??= await citesteTva().
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Valorile implicite ale parametrilor (function f(a = 1)) se calculează la apel, înainte să înceapă corpul funcției. Chiar dacă funcția e async, zona parametrilor nu e considerată parte din corpul asincron, așa că await acolo e interzis: Illegal await-expression in formal parameters of async function. Regula similară pentru generatoare dă Yield expression not allowed in formal parameter.
Apare când vrei o valoare implicită care vine dintr-o sursă asincronă: o setare citită din API, cursul valutar, TVA-ul curent.
Soluția e să lași parametrul fără valoare implicită (sau cu undefined) și să completezi valoarea în prima linie a corpului: tva ??= await citesteTva();. Operatorul ??= atribuie doar dacă valoarea e null sau undefined, deci un argument dat explicit e păstrat.
De ce apare: cauzele frecvente
1Valoare implicită asincronă
async function total(pret, tva = await citesteTva()) {
return pret * (1 + tva);
}async function total(pret, tva) {
tva ??= await citesteTva();
return pret * (1 + tva);
}În corpul funcției async, await e permis. ??= folosește valoarea primită dacă există.
2Arrow function async cu await în parametri
const incarca = async (cfg = await citesteConfig()) => cfg.url;const incarca = async (cfg) => {
cfg ??= await citesteConfig();
return cfg.url;
};Aceeași regulă la arrow functions: mută așteptarea în corp.
Repară eroarea, direct în pagină
Funcția calculeaza ia TVA-ul implicit dintr-o funcție asincronă, dar codul dă SyntaxError: Illegal await-expression in formal parameters of async function. Repară funcția (fără să schimbi preiaTva) ca programul să afișeze Total: 119.00.
const preiaTva = async () => 0.19;
async function calculeaza(pret, tva = await preiaTva()) {
return pret * (1 + tva);
}
calculeaza(100).then((total) => console.log(`Total: ${total.toFixed(2)}`));Total: 119.00
Indiciu
Lasă parametrul tva fără valoare implicită și completează-l în corp cu ??= și await.
Reparația
const preiaTva = async () => 0.19;
async function calculeaza(pret, tva) {
tva ??= await preiaTva();
return pret * (1 + tva);
}
calculeaza(100).then((total) => console.log(`Total: ${total.toFixed(2)}`));De ce merge
Parametrii se evaluează înainte de corpul funcției, iar acolo await nu e permis. În corp, tva ??= await preiaTva() așteaptă valoarea doar când apelantul n-a trimis TVA, deci calculeaza(100) folosește 0.19 și întoarce 119. Dacă apelantul trimite al doilea argument, de exemplu calculeaza(100, 0.09), funcția nu mai așteaptă nimic și folosește valoarea primită.
Alte forme ale mesajului
SyntaxError: await expression can't be used in parameterSyntaxError: Yield expression not allowed in formal parameterUncaught SyntaxError: Illegal await-expression in formal parameters of async function
Cum o eviți pe viitor
- Păstrează valorile implicite din parametri simple și sincrone (constante, calcule rapide).
- Datele care vin asincron se încarcă în corpul funcției, cu
??=sau cu unif. - Dacă valoarea se folosește des, încarc-o o dată și trimite-o ca argument.
Întrebări frecvente
De ce nu e permis, dacă funcția e oricum async?
Specificația tratează lista de parametri separat de corp, iar până la intrarea în corp funcția nu poate suspenda execuția. De aceea await e permis doar în corp.
Pot pune o promisiune ca valoare implicită?
Poți scrie tva = citesteTva() (fără await), dar atunci tva e o promisiune. În corp ar trebui să scrii await tva, ceea ce funcționează, dar e mai greu de urmărit.
Erori înrudite
SyntaxError: await is only valid in async functions and the top level bodies of modules Ai folosit `await` într-o funcție care nu e marcată `async` (des: într-un callback de `forEach` sau `map`) sau la nivelul de sus al unui script care nu e modul. Adaugă `async` funcției care conține `await`, sau pune codul într-o funcție `async function main() { ... }` și apeleaz-o. Uncaught (in promise) Error: Request failed O promisiune a fost respinsă (o funcție `async` a aruncat o eroare sau o cerere a eșuat), iar nimeni nu a prins eroarea cu `try...catch` sau `.catch()`. Pune `await` în interiorul unui `try...catch`, sau adaugă `.catch()` la apelul funcției `async`. SyntaxError: Rest parameter may not have a default initializer Ai pus o valoare implicită unui parametru rest, de exemplu ...numere = []. Nu e nevoie și nu e permis: un parametru rest e mereu un tablou, gol dacă nu primește argumente. Șterge partea = [...] și, dacă vrei valori implicite, tratează tabloul gol în corpul funcției. Învață JavaScript de la zero, cu exerciții la fiecare lecție
Curs JavaScript: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
