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

ReferenceError: describe is not defined

Pe scurt

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

Greșit
JavaScript
describe('Catalog', () => {
  it('arată produsele', async ({ page }) => {});
});
Corect
JavaScript
test.describe('Catalog', () => {
  test('arată produsele', async ({ page }) => {});
});

În Playwright grupul e test.describe, iar testul e test.

2Hook-uri fără prefixul test.

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

Hook-urile sunt metode ale lui test, primite prin import.

3Import lipsă

Greșit
JavaScript
test('x', async ({ page }) => {});
Corect
JavaScript
import { test, expect } from '@playwright/test';

test('x', async ({ page }) => {});

Fără import, nici test, nici expect nu există.

Repară tu

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.

Codul care dă eroarea
JavaScript
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.

Alte forme ale mesajului

  • ReferenceError: it is not defined
  • ReferenceError: beforeEach is not defined
  • ReferenceError: test is not defined
  • TypeError: 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.describe gol.
  • eslint-plugin-playwright semnalează 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

← 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.