1 flaky
Raportul spune „1 flaky” când un test a picat, apoi a trecut la reîncercare (retries). Cauza tipică: testul citește pagina după o pauză fixă (waitForTimeout) sau cu valori de moment (count(), textContent(), isVisible()). Înlocuiește-le cu aserțiuni care așteaptă: toHaveCount, toHaveText, toBeVisible.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Cu retries setat (de obicei în CI), Playwright reia un test care pică. Dacă la a doua încercare trece, testul nu e raportat nici ca trecut, nici ca picat, ci flaky: în sumar apare 1 flaky și numele testului. E un semnal că rezultatul depinde de noroc: de viteza calculatorului, a rețelei sau de ordinea în care rulează testele.
Cele mai frecvente cauze:
- pauze fixe:
waitForTimeout(200)ajunge pe un calculator rapid, nu și pe unul încărcat din CI; - valori de moment:
count(),textContent(),isVisible()citesc pagina o singură dată, fără să aștepte; - date comune: două teste modifică același cont sau același coș;
- ordine: un test se bazează pe starea lăsată de altul.
Trace-ul încercării picate (trace: 'on-first-retry') îți arată exact ce era pe pagină în clipa eșecului.
De ce apare: cauzele frecvente
1Pauză fixă în loc de așteptarea unei stări
await page.getByLabel('Categorie').selectOption('Laptopuri');
await page.waitForTimeout(200);
expect(await page.getByTestId('product-card').count()).toBe(2);await page.getByLabel('Categorie').selectOption('Laptopuri');
await expect(page.getByTestId('product-card')).toHaveCount(2);Aserțiunea reîncearcă până se actualizează lista, indiferent cât durează.
2isVisible() folosit ca așteptare
if (await page.getByText('Se încarcă').isVisible()) {
await page.waitForTimeout(1000);
}await expect(page.getByTestId('loading')).toBeHidden();isVisible() răspunde imediat; toBeHidden() așteaptă dispariția indicatorului.
3Teste care împart același cont
test('comandă nouă', async ({ page }) => {
// contul comun are acum 1 sau 2 comenzi, după ordinea testelor
await expect(page.getByTestId('order-row')).toHaveCount(2);
});test('comandă nouă', async ({ page, request }) => {
const cont = await creeazaContNou(request);
// ... contul nou are exact comanda creată aici
});Fiecare test își pregătește propriile date, deci nu depinde de alte teste.
Repară eroarea, direct în pagină
Testul filtrare după categorie a ieșit flaky în CI: alege categoria Laptopuri din catalog, așteaptă 200 ms și numără cardurile cu count(). Aplicația filtrează după o cerere la server, care uneori durează mai mult decât pauza. Rescrie verificarea fără pauze fixe și fără count(): testul trebuie să aștepte cele 2 carduri și textul 2 produse din results-count.
import { test, expect } from '@playwright/test';
test('filtrare după categorie', async ({ page }) => {
await page.goto('/#/catalog');
await page.getByLabel('Categorie').selectOption('Laptopuri');
await page.waitForTimeout(200);
const numar = await page.getByTestId('product-card').count();
expect(numar).toBe(2);
});Indiciu
Înlocuiește pauza și citirea de moment cu aserțiuni care reîncearcă.
Reparația
import { test, expect } from '@playwright/test';
test('filtrare după categorie', async ({ page }) => {
await page.goto('/#/catalog');
await page.getByLabel('Categorie').selectOption('Laptopuri');
await expect(page.getByTestId('product-card')).toHaveCount(2);
await expect(page.getByTestId('results-count')).toHaveText('2 produse');
});De ce merge
Testul presupunea că filtrarea se termină în 200 ms. Când serverul răspundea mai repede, count() vedea 2 carduri; când răspundea mai încet, vedea lista veche sau goală, iar testul pica. Așa apare un test flaky.
await expect(...).toHaveCount(2) reîncearcă până când lista are 2 carduri (sau până la timeout), deci nu mai depinde de viteză. Verificarea lui results-count confirmă că și textul aplicației s-a actualizat. Testul e la fel de rapid ca înainte când aplicația e rapidă și nu mai pică atunci când e lentă.
Alte forme ale mesajului
1 flaky exemplu.spec.js:3:5 › filtrare după categorieRetry #12 flaky
Cum o eviți pe viitor
- Nu folosi
waitForTimeoutîn teste; așteaptă stări cu aserțiuni web-first. - Pentru elemente din pagină, nu citi valori cu
count()/textContent()urmate detoBe; foloseștetoHaveCount/toHaveText. - Fiecare test își creează datele (cont, coș) și nu depinde de ordinea rulării.
- Activează
trace: 'on-first-retry'și investighează fiecare test flaky;retriesdoar ascunde problema. - Rulează local cu
--repeat-each=10ca să scoți la iveală instabilitatea.
Întrebări frecvente
E în regulă să las retries ca testele să treacă?
retries e o plasă de siguranță în CI, nu o reparație. Un test flaky poate ascunde un bug real (de exemplu o cursă în aplicație) și face ca eșecurile reale să fie ignorate. Tratează fiecare „flaky” ca pe un test de reparat.
Cum reproduc local un test flaky?
Rulează-l de mai multe ori: npx playwright test filtrare --repeat-each=20, eventual cu --workers=4 ca să încarci calculatorul. Deschide apoi trace-ul unei rulări picate.
Erori înrudite
Error: expect(received).toBe(expected) // Object.is equality Valoarea comparată cu toBe nu e identică cu cea așteptată. În testele Playwright cauza tipică e un await lipsă (Received: Promise {}) sau o valoare citită prea devreme cu textContent()/count(). Folosește aserțiunile pe locator, care așteaptă: await expect(locator).toHaveText('1'). Error: expect(locator).toHaveCount(expected) failed Locatorul a găsit alt număr de elemente decât ai cerut. Ori locatorul e prea larg (prinde și alte elemente cu același text) sau prea îngust, ori aplicația chiar afișează alt număr. Compară Expected cu Received și numără elementele care te interesează, de exemplu cardurile de produs după data-testid. TimeoutError: page.waitForResponse: Timeout 30000ms exceeded while waiting for event "response" Testul a început să aștepte răspunsul serverului după ce cererea se terminase deja, sau tiparul URL nu se potrivește cu nicio cerere. Pornește page.waitForResponse() înainte de click (fără await), fă acțiunea, apoi await pe promisiune, și verifică URL-ul exact al cererii. Î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.
