ReferenceError: describe is not defined
Fișierul de test Playwright folosește describe, it sau beforeEach ca în Jest / Mocha, dar Playwright Test nu le definește global. Folosește test.describe, test și test.beforeEach, importate din @playwright/test.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Jest și Mocha pun în scope-ul global funcțiile describe, it, beforeEach, afterAll. Playwright Test nu face asta: tot ce ai nevoie vine din import { test, expect } from '@playwright/test', iar grupurile și hook-urile sunt metode ale lui test: test.describe, test.beforeEach, test.afterAll, iar testul însuși e test(...), nu it(...).
Eroarea apare la încărcarea fișierului (nu rulează niciun test) și e foarte frecventă la cei care vin din Cypress, Jest sau Mocha, ori când copiezi un exemplu scris pentru alt framework. Raportul indică linia primului describe / it. Dacă vezi it is not defined sau beforeEach is not defined, cauza e aceeași. Invers, într-un proiect Mocha (de ex. cu Selenium), describe și it există global și nu trebuie importate.
De ce apare: cauzele frecvente
1Sintaxa Jest / Mocha în Playwright
describe('Catalog', () => {
it('arată produsele', async ({ page }) => {});
});test.describe('Catalog', () => {
test('arată produsele', async ({ page }) => {});
});În Playwright grupul e test.describe, iar testul e test.
2Hook-uri fără prefixul test.
beforeEach(async ({ page }) => {
await page.goto('/#/catalog');
});test.beforeEach(async ({ page }) => {
await page.goto('/#/catalog');
});Hook-urile sunt metode ale lui test, primite prin import.
3Import lipsă
test('x', async ({ page }) => {});import { test, expect } from '@playwright/test';
test('x', async ({ page }) => {});Fără import, nici test, nici expect nu există.
Repară eroarea, direct în pagină
Fișierul de mai jos e scris în stilul Jest / Mocha (describe, beforeEach, it), iar Playwright îl refuză cu describe is not defined. Rescrie-l cu API-ul Playwright Test (test.describe, test.beforeEach, test), fără să schimbi verificările. Testul afișează numele primului produs.
import { test, expect } from '@playwright/test';
describe('Catalog', () => {
beforeEach(async ({ page }) => {
await page.goto('/#/catalog');
});
it('primul produs e laptopul', async ({ page }) => {
const nume = page.getByTestId('product-name').first();
await expect(nume).toHaveText('Laptop UltraBook 14');
console.log(await nume.textContent());
});
});Indiciu
Grupurile și hook-urile sunt metode ale lui test.
Reparația
import { test, expect } from '@playwright/test';
test.describe('Catalog', () => {
test.beforeEach(async ({ page }) => {
await page.goto('/#/catalog');
});
test('primul produs e laptopul', async ({ page }) => {
const nume = page.getByTestId('product-name').first();
await expect(nume).toHaveText('Laptop UltraBook 14');
console.log(await nume.textContent());
});
});De ce merge
Playwright Test nu definește global describe, it și beforeEach; tot ce oferă vine prin test, importat din @playwright/test. Cu test.describe, test.beforeEach și test(...), fișierul se încarcă, hook-ul deschide catalogul și testul citește numele primului card. Verificările rămân aceleași; se schimbă doar felul în care sunt declarate grupul, hook-ul și testul.
Alte forme ale mesajului
ReferenceError: it is not definedReferenceError: beforeEach is not definedReferenceError: test is not definedTypeError: describe is not a function
Cum o eviți pe viitor
- Începe fiecare fișier de test cu
import { test, expect } from '@playwright/test';. - Când copiezi un exemplu, verifică pentru ce framework e scris (Jest, Mocha, Cypress, Playwright).
- Folosește un șablon de fișier de test în editor, cu importul și un
test.describegol. eslint-plugin-playwrightsemnalează rapid sintaxa greșită.
Întrebări frecvente
Pot face describe și it globale în Playwright?
Tehnic poți scrie const describe = test.describe; const it = test;, dar e mai clar să folosești API-ul Playwright, ca oricine citește testul să știe ce framework e.
În Selenium cu Mocha trebuie să import describe?
Nu: Mocha le definește global când rulezi npx mocha. Eroarea describe is not defined apare acolo doar dacă rulezi fișierul direct cu node test.js.
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. Error: No tests found Playwright nu a găsit niciun test de rulat: fișierul nu se potrivește cu testMatch (trebuie .spec.js / .test.js), e în afara testDir, filtrul --grep nu prinde nimic sau testele sunt generate dintr-o listă goală. Verifică numele și locul fișierului, apoi lista de date din care creezi testele. Î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.
