...
Eroare Testare automată · Aserțiuni expect care pică

Error: expect(page).toHaveScreenshot(expected) failed

Pe scurt

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

Greșit
JavaScript
await page.goto('/#/catalog');
await expect(page).toHaveScreenshot('catalog.png');
Corect
JavaScript
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ă

Greșit
JavaScript
await expect(page).toHaveScreenshot('cont.png');
Corect
JavaScript
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

Greșit
JavaScript
// referința făcută pe macOS, testele rulează în CI pe Linux
Corect
JavaScript
// generezi referințele în același container ca CI-ul
npx playwright test --update-snapshots

Fonturile se randează diferit pe fiecare sistem, deci pixelii diferă chiar dacă pagina e aceeași.

4Screenshot folosit pentru a verifica un text

Greșit
JavaScript
await expect(page).toHaveScreenshot('telefoane.png');
Corect
JavaScript
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ă tu

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.

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

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) failed
  • Error: 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 expect starea 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

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