Error: expect(locator).toHaveClass(expected) failed
toHaveClass cu un string compară întregul atribut class, nu o singură clasă. Dacă elementul are class="nav-link activ", toHaveClass('activ') pică; folosește toContainClass('activ') sau un RegExp, toHaveClass(/activ/).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul arată Expected: "activ" și Received: "nav-link activ", iar diferența pare minoră: clasa căutată chiar e acolo. Capcana e că toHaveClass('activ') cere ca tot atributul class să fie exact activ. Cu un element care are mai multe clase, comparația exactă pică.
Ai trei variante corecte: toContainClass('activ') (Playwright 1.52+) verifică doar prezența clasei; toHaveClass(/(^|\s)activ(\s|$)/) face același lucru cu un RegExp; toHaveClass('nav-link activ') verifică lista completă, utilă doar când contează toate clasele. Dacă la Received apare un string gol, elementul nu are nicio clasă: aplicația nu a ajuns în starea așteptată (de exemplu, tab-ul nu s-a schimbat), sau locatorul a prins alt element.
De ce apare: cauzele frecvente
1O singură clasă comparată exact
await expect(page.getByRole('link', { name: 'Catalog' })).toHaveClass('activ');await expect(page.getByRole('link', { name: 'Catalog' })).toHaveClass(/activ/);Linkul are class="nav-link activ". Stringul cere egalitate cu tot atributul; RegExp-ul caută doar clasa.
2Ordinea claselor diferită
await expect(tab).toHaveClass('activ tab');await expect(tab).toHaveClass('tab activ');Comparația exactă ține cont de ordine și de spații. Dacă vrei să verifici lista completă, scrie-o exact ca în HTML.
3Starea nu s-a schimbat încă
await page.getByRole('link', { name: 'Coș' }).click();
await expect(page.getByRole('link', { name: 'Catalog' })).toHaveClass(/activ/);await page.getByRole('link', { name: 'Coș' }).click();
await expect(page.getByRole('link', { name: 'Coș' })).toHaveClass(/activ/);Clasa activ s-a mutat pe linkul pe care ai dat click. Received gol arată că elementul verificat nu mai are clasa.
Repară eroarea, direct în pagină
Testul tab-ul ales devine activ pică cu toHaveClass(expected) failed (Expected: "activ", Received: "tab activ"). Repară aserțiunea ca să verifice doar prezența clasei activ pe tab-ul „Livrare” (cu un RegExp), apoi afișează textul panoului vizibil.
import { test, expect } from '@playwright/test';
test('tab-ul ales devine activ', async ({ page }) => {
await page.goto('/');
await page.getByRole('button', { name: 'Livrare' }).click();
await expect(page.getByRole('button', { name: 'Livrare' })).toHaveClass('activ');
});Indiciu
Elementul are mai multe clase, iar un string se compară cu toate.
Reparația
import { test, expect } from '@playwright/test';
test('tab-ul ales devine activ', async ({ page }) => {
await page.goto('/');
await page.getByRole('button', { name: 'Livrare' }).click();
await expect(page.getByRole('button', { name: 'Livrare' })).toHaveClass(/(^|\s)activ(\s|$)/);
console.log(await page.locator('.panou:visible').textContent());
});De ce merge
toHaveClass('activ') compară tot atributul class, care e tab activ, deci a picat deși clasa căutată era acolo. RegExp-ul /(^|\s)activ(\s|$)/ caută clasa activ ca element separat al listei, fără să conteze celelalte clase sau ordinea lor.
Testul afișează apoi textul panoului care a devenit vizibil, ca dovadă că schimbarea tab-ului a avut efect, nu doar că s-a mutat o clasă CSS.
Alte forme ale mesajului
Error: Timed out 5000ms waiting for expect(locator).toHaveClass(expected)Error: expect(locator).not.toHaveClass(expected) failedError: expect(locator).toContainClass(expected) failed
Cum o eviți pe viitor
- Pentru „are clasa X” folosește
toContainClass('X')sautoHaveClass(/X/), nu un string. - Mai bine, verifică starea prin ce vede utilizatorul:
aria-current="page",aria-selected,toBeChecked. Clasele CSS se schimbă des la redesign. - Folosește string-ul exact doar când chiar contează lista completă de clase.
Întrebări frecvente
toHaveClass(/activ/) nu prinde și clasa inactiv?
Da, /activ/ se potrivește și cu inactiv. Dacă ai astfel de clase, folosește /(^|\s)activ(\s|$)/ sau toContainClass('activ'), care compară clase întregi.
Cum verific mai multe elemente odată?
Dă o listă: await expect(page.getByRole('tab')).toHaveClass([/activ/, '', '']). Fiecare valoare corespunde unui element, în ordine.
Erori înrudite
Error: expect(locator).toHaveAttribute(expected) failed Atributul elementului are altă valoare decât cea din test (sau lipsește). Valoarea dată ca text trebuie să fie identică; pentru o potrivire parțială folosește un RegExp, de exemplu toHaveAttribute('href', /catalog$/). 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).toBeVisible() failed Elementul nu a devenit vizibil în timpul aserțiunii (implicit 5 secunde): nu există, e ascuns sau apare mai târziu. Citește Received: <element(s) not found> înseamnă locator greșit, hidden înseamnă element ascuns; dacă aplicația e doar lentă, mărește timeout-ul doar pentru această aserțiune. Î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.
