...
Eroare JavaScript · Erori de sintaxă (SyntaxError)

SyntaxError: Illegal await-expression in formal parameters of async function

Pe scurt

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ă

Greșit
JavaScript
async function total(pret, tva = await citesteTva()) {
  return pret * (1 + tva);
}
Corect
JavaScript
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

Greșit
JavaScript
const incarca = async (cfg = await citesteConfig()) => cfg.url;
Corect
JavaScript
const incarca = async (cfg) => {
  cfg ??= await citesteConfig();
  return cfg.url;
};

Aceeași regulă la arrow functions: mută așteptarea în corp.

Repară tu

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.

Codul care dă eroarea
JavaScript
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)}`));
După reparație, programul afișează
Total: 119.00
Indiciu

Lasă parametrul tva fără valoare implicită și completează-l în corp cu ??= și await.

Alte forme ale mesajului

  • SyntaxError: await expression can't be used in parameter
  • SyntaxError: Yield expression not allowed in formal parameter
  • Uncaught 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 un if.
  • 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

← Toate erorile JavaScript

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ță 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.