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: 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
test('login', ({ page }) => {
await page.goto('/#/login');
});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
test('toate produsele', async ({ page }) => {
ids.forEach((id) => {
await page.goto(`/#/produs/${id}`);
});
});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
class LoginPage {
open() {
await this.page.goto('/#/login');
}
}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ă 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.
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.
Reparația
import { test, expect } from '@playwright/test';
test('pagina principală are titlul corect', async ({ page }) => {
await page.goto('/');
await expect(page).toHaveTitle('ShopRapid – Magazin online');
console.log(await page.getByRole('heading', { level: 1 }).textContent());
});De ce merge
Callback-ul testului era o funcție obișnuită, iar await e permis doar în funcții async. Eroarea e de sintaxă, deci fișierul nu s-a încărcat și niciun test nu a rulat.
Cu async ({ page }) => { ... }, fiecare await așteaptă pasul de dinainte: navigarea, apoi aserțiunea despre titlu, apoi citirea heading-ului.
Alte forme ale mesajului
SyntaxError: Unexpected reserved wordSyntaxError: await is only valid in async functionCannot use keyword 'await' outside an async functionSyntaxError: 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, nuforEach/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
asyncdin 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
ReferenceError: page is not defined Folosești variabila page într-un test (sau hook) care nu a cerut-o. page e un fixture: îl primești scriindu-l între acolade în parametrii funcției, async ({ page }) => { ... }. La fel pentru request, context sau browser. Error: Playwright Test did not expect test() to be called here. Ai apelat test() în interiorul altui test sau al unui hook. Testele se declară doar la nivelul fișierului sau în test.describe(); pentru pași comuni folosește test.beforeEach, iar pentru grupare test.describe. Mesajul mai apare când două versiuni de @playwright/test sunt instalate în proiect. TypeError: page.goto is not a function Variabila page nu e pagina Playwright: ai scris async (page) => în loc de async ({ page }) =>, deci page e obiectul cu toate fixture-urile. Pune acoladele în jurul lui page (destructurare) în test, beforeEach și fixture-uri. Î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.
