Error: expect(page).toHaveScreenshot(expected) failed
Captura de ecran făcută acum diferă de imaginea de referință salvată: mesajul spune câți pixeli diferă. Cauze tipice: conținut care se schimbă (date, prețuri, animații), captura făcută înainte să se încarce pagina, alt sistem de operare sau alte fonturi în CI. Folosește aserțiuni pe text pentru conținut și screenshot-uri doar pentru aspect.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
toHaveScreenshot() face o captură și o compară pixel cu pixel cu imaginea din folderul exemplu.spec.js-snapshots/. Raportul spune 2431 pixels (ratio 0.01 of all image pixels) are different și salvează trei fișiere în test-results: -expected.png, -actual.png și -diff.png (diferențele colorate). Deschide diff-ul înainte de orice altceva.
Cauzele frecvente: conținut dinamic (ora, un preț din API, un banner rotativ), animații prinse la jumătate, captura făcută în timp ce lista încă se încarcă, sau imaginea de referință generată pe alt sistem (fonturile și anti-aliasing-ul diferă între macOS, Windows și Linux; de aceea numele fișierului conține -chromium-linux). La prima rulare nu există referința: testul pică cu A snapshot doesn't exist ..., writing actual. și o creează. Actualizezi intenționat referințele cu npx playwright test --update-snapshots.
De ce apare: cauzele frecvente
1Captură înainte de încărcarea datelor
await page.goto('/#/catalog');
await expect(page).toHaveScreenshot('catalog.png');await page.goto('/#/catalog');
await expect(page.getByTestId('product-card')).toHaveCount(8);
await expect(page).toHaveScreenshot('catalog.png');Captura prindea indicatorul de încărcare. Așteptarea listei face imaginea stabilă.
2Conținut dinamic în captură
await expect(page).toHaveScreenshot('cont.png');await expect(page).toHaveScreenshot('cont.png', {
mask: [page.getByTestId('order-list')],
});Comenzile diferă de la o rulare la alta. mask acoperă zona cu un dreptunghi, deci nu mai contează.
3Referință generată pe alt sistem
// referința făcută pe macOS, testele rulează în CI pe Linux// generezi referințele în același container ca CI-ul
npx playwright test --update-snapshotsFonturile se randează diferit pe fiecare sistem, deci pixelii diferă chiar dacă pagina e aceeași.
4Screenshot folosit pentru a verifica un text
await expect(page).toHaveScreenshot('telefoane.png');await expect(page.getByTestId('product-card')).toHaveCount(2);
await expect(page.getByTestId('results-count')).toHaveText('2 produse');Pentru conținut, o aserțiune pe text spune exact ce e greșit și nu pică din cauza fonturilor.
Repară eroarea, direct în pagină
Testul filtrul Telefoane arată 2 produse verifică filtrul cu toHaveScreenshot, care în CI pică des cu toHaveScreenshot(expected) failed (în laborator comparația vizuală e doar simulată). Înlocuiește captura cu aserțiuni pe conținut: 2 carduri product-card și textul results-count, pe care îl afișezi.
import { test, expect } from '@playwright/test';
test('filtrul Telefoane arată 2 produse', async ({ page }) => {
await page.goto('/#/catalog');
await page.getByLabel('Categorie').selectOption('Telefoane');
await expect(page).toHaveScreenshot('telefoane.png');
});Indiciu
Pentru un număr de produse, o aserțiune pe text e mai precisă decât o imagine.
Reparația
import { test, expect } from '@playwright/test';
test('filtrul Telefoane arată 2 produse', async ({ page }) => {
await page.goto('/#/catalog');
await page.getByLabel('Categorie').selectOption('Telefoane');
await expect(page.getByTestId('product-card')).toHaveCount(2);
await expect(page.getByTestId('results-count')).toHaveText('2 produse');
console.log(await page.getByTestId('results-count').textContent());
});De ce merge
Captura compară pixeli, deci pică din cauza fonturilor, a încărcării sau a oricărei schimbări vizuale, chiar dacă filtrul funcționează. toHaveCount(2) și toHaveText('2 produse') verifică exact ce promite titlul testului, reîncearcă până se termină filtrarea și, dacă pică, spun clar ce valoare a apărut.
Alte forme ale mesajului
Error: expect(page).toHaveScreenshot(expected) failed 2431 pixels (ratio 0.01 of all image pixels) are different.Error: expect(locator).toHaveScreenshot(expected) failedError: A snapshot doesn't exist at tests/exemplu.spec.js-snapshots/catalog-chromium-linux.png, writing actual.Expected an image 1280px by 720px, received 1280px by 2105px.
Cum o eviți pe viitor
- Așteaptă cu
expectstarea finală a paginii înainte de captură. - Ascunde zonele dinamice cu
maskși oprește animațiile (animations: 'disabled', implicit în toHaveScreenshot). - Generează referințele în același mediu ca CI-ul (de obicei imaginea Docker oficială Playwright).
- Folosește screenshot-uri pentru aspect (layout, culori) și aserțiuni pe text sau număr pentru conținut.
Întrebări frecvente
Pot accepta câțiva pixeli diferiți?
Da: toHaveScreenshot({ maxDiffPixels: 100 }) sau maxDiffPixelRatio: 0.01. Folosește toleranța pentru zgomotul de randare, nu ca să ascunzi o schimbare reală.
Cum actualizez referința după o schimbare de design voită?
Rulează npx playwright test --update-snapshots, verifică imaginile noi și pune-le în commit împreună cu schimbarea de design.
De ce în laboratorul cursului captura trece mereu?
Laboratorul rulează în browserul tău, fără un motor de randare comparabil între rulări, deci comparația vizuală e doar simulată. Logica de mai sus o aplici pe proiectele reale.
Erori înrudite
Error: expect(locator).toHaveText(expected) failed Textul elementului nu a devenit egal cu cel așteptat în 5 secunde. Compară rândurile Expected și Received: toHaveText cere tot textul elementului (cu spațiile normalizate), deci pentru o bucată din text folosește toContainText sau o expresie regulată. 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. 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. Î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.
