...
Eroare Testare automată · Structura testului: fixtures, hooks și importuri

SyntaxError: await is only valid in async functions and the top level bodies of modules

Pe scurt

Ai folosit await într-o funcție care nu e marcată async: de obicei callback-ul lui test, beforeEach sau o metodă din Page Object. Adaugă async în fața funcției: test('...', async ({ page }) => { ... }).

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

await poate apărea doar într-o funcție async (sau la nivelul de sus al unui modul ES). Eroarea e de sintaxă, deci apare la încărcarea fișierului, înainte să ruleze vreun test: Playwright afișează fișierul și linia cu await, iar niciun test din fișier nu rulează.

În testele Playwright, aproape fiecare linie are await, deci orice funcție care conține pași trebuie să fie async: callback-ul lui test, al hook-urilor (beforeEach, afterAll), funcțiile ajutătoare și metodele claselor Page Object. Capcanele frecvente: ai scris test('x', ({ page }) => {...}) fără async, ai pus un await într-un callback de forEach sau map (care e o funcție separată, ne-async), sau ai o funcție în interiorul alteia, iar doar cea exterioară e async. La forEach, nici adăugarea lui async nu rezolvă: forEach nu așteaptă promisiunile; folosește for...of.

De ce apare: cauzele frecvente

1Callback-ul testului fără async

Greșit
JavaScript
test('login', ({ page }) => {
  await page.goto('/#/login');
});
Corect
JavaScript
test('login', async ({ page }) => {
  await page.goto('/#/login');
});

Callback-ul e funcția care conține await, deci ea trebuie marcată async.

2await în forEach

Greșit
JavaScript
test('toate produsele', async ({ page }) => {
  ids.forEach((id) => {
    await page.goto(`/#/produs/${id}`);
  });
});
Corect
JavaScript
test('toate produsele', async ({ page }) => {
  for (const id of ids) {
    await page.goto(`/#/produs/${id}`);
  }
});

Callback-ul din forEach e o funcție separată, ne-async. for...of rămâne în funcția async și așteaptă fiecare pas.

3Metodă de Page Object fără async

Greșit
JavaScript
class LoginPage {
  open() {
    await this.page.goto('/#/login');
  }
}
Corect
JavaScript
class LoginPage {
  async open() {
    await this.page.goto('/#/login');
  }
}

Fiecare metodă cu await trebuie să fie async, iar în test o apelezi tot cu await.

Repară tu

Repară eroarea, direct în pagină

Fișierul de test nu se încarcă deloc: SyntaxError: await is only valid in async functions (în laborator: eroare de sintaxă la linia cu await). Repară funcția testului pagina principală are titlul corect ca să poată folosi await, apoi testul verifică titlul și afișează heading-ul principal.

Codul care dă eroarea
JavaScript
import { test, expect } from '@playwright/test';

test('pagina principală are titlul corect', ({ page }) => {
  await page.goto('/');
  await expect(page).toHaveTitle('ShopRapid – Magazin online');
});
Indiciu

Funcția care conține await trebuie marcată într-un anume fel.

Alte forme ale mesajului

  • SyntaxError: Unexpected reserved word
  • SyntaxError: await is only valid in async function
  • Cannot use keyword 'await' outside an async function
  • SyntaxError: Unexpected identifier 'page'

Cum o eviți pe viitor

  • Pornește fiecare test dintr-un șablon: test('...', async ({ page }) => { });.
  • Pentru bucle cu pași asincroni folosește for...of, nu forEach / map.
  • Activează în editor ESLint cu eslint-plugin-playwright; eroarea apare subliniată înainte să rulezi.
  • Când scrii o funcție ajutătoare nouă, marchează-o async din prima dacă va conține pași de test.

Întrebări frecvente

De ce mesajul spune și „top level bodies of modules”?

În modulele ES (fișiere cu import), Node permite await și la nivelul de sus. Playwright Test însă nu acceptă pași de test acolo: pașii stau în teste sau hook-uri, deci reparația rămâne async pe funcție.

Pe Node mai vechi apare „Unexpected reserved word”. E același lucru?

Da. Versiunile mai vechi raportează aceeași greșeală mai vag. Linia indicată e cea cu await; caută funcția care o conține.

Erori înrudite

← Toate erorile Testare automată

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ță Testare automată de la zero, cu exerciții la fiecare lecție

Curs Test Automation (Playwright și Selenium): lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 20 lecții sunt gratuite.