Error: expect(locator).toBeFocused() failed
Focusul nu e pe elementul verificat: e pe alt câmp sau pe nimic. De obicei testul apasă Tab fără să fi pus focusul întâi pe câmpul de pornire, ori pagina nu mută focusul cum crezi. Pune focusul explicit (click, focus()) înainte de navigarea cu tastatura.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
toBeFocused() verifică dacă elementul este document.activeElement, adică cel care primește tastele. Raportul arată Expected: focused și Received: inactive.
Cele mai multe eșecuri vin din testele de tastatură. Când pagina se încarcă, focusul e pe body; primul Tab merge pe primul element focusabil din pagină (adesea un link din meniu), nu pe câmpul la care te gândești. Alte cauze: aplicația nu are autofocus sau nu mută focusul după o acțiune (de exemplu, după deschiderea unei ferestre), un alt element îl „fură” (un toast, un dialog), sau elementul nu e focusabil deloc (un div fără tabindex). Pentru accesibilitate, focusul contează: dacă cerința spune că un câmp trebuie să primească focusul și nu îl primește, ai găsit un bug real.
De ce apare: cauzele frecvente
1Tab apăsat fără punct de pornire
await page.keyboard.press('Tab');
await expect(page.getByLabel('Parolă')).toBeFocused();await page.getByLabel('Email').focus();
await page.keyboard.press('Tab');
await expect(page.getByLabel('Parolă')).toBeFocused();Fără focus inițial, Tab pornește de la începutul paginii. Pune întâi focusul pe câmpul de dinainte.
2Aplicația nu pune autofocus
await page.goto('/#/login');
await expect(page.getByLabel('Email')).toBeFocused();await page.goto('/#/login');
await page.getByLabel('Email').click();
await expect(page.getByLabel('Email')).toBeFocused();Dacă cerința nu spune că emailul primește focus la încărcare, testul nu trebuie să presupună asta.
3Elementul nu e focusabil
await page.locator('.card').focus();
await expect(page.locator('.card')).toBeFocused();await page.locator('.card').getByRole('link').focus();
await expect(page.locator('.card').getByRole('link')).toBeFocused();Un div fără tabindex nu poate primi focus. Linkurile, butoanele și câmpurile pot.
Repară eroarea, direct în pagină
Testul Tab mută focusul pe parolă pică cu toBeFocused() failed. Pagina are câmpurile „Email” și „Parolă”. Repară testul: pune întâi focusul pe „Email”, apasă Tab, verifică focusul pe „Parolă”, apoi scrie Parola123! cu tastatura și afișează lungimea valorii câmpului.
import { test, expect } from '@playwright/test';
test('Tab mută focusul pe parolă', async ({ page }) => {
await page.goto('/');
await page.keyboard.press('Tab');
await expect(page.getByLabel('Parolă')).toBeFocused();
});Indiciu
Primul Tab de pe o pagină proaspătă pornește de la început.
Reparația
import { test, expect } from '@playwright/test';
test('Tab mută focusul pe parolă', async ({ page }) => {
await page.goto('/');
await page.getByLabel('Email').focus();
await page.keyboard.press('Tab');
await expect(page.getByLabel('Parolă')).toBeFocused();
await page.keyboard.type('Parola123!');
console.log((await page.getByLabel('Parolă').inputValue()).length);
});De ce merge
Fără un focus inițial, primul Tab muta focusul pe primul element focusabil, adică pe „Email”, nu pe „Parolă”, deci aserțiunea a picat. Cu getByLabel('Email').focus() înainte, Tab trece la următorul câmp, „Parolă”, iar toBeFocused() trece.
keyboard.type scrie apoi în câmpul care are focusul, ceea ce dovedește că focusul chiar era acolo; lungimea valorii (10) confirmă textul tastat fără să-l afișeze.
Alte forme ale mesajului
Error: Timed out 5000ms waiting for expect(locator).toBeFocused()Error: expect(locator).not.toBeFocused() failedError: expect(locator).toBeFocused() failed Expected: focused Received: inactive
Cum o eviți pe viitor
- În testele de tastatură, pornește mereu de la un element cu focus pus explicit.
- Verifică focusul după fiecare
Tabimportant, nu doar la final: vezi exact unde s-a abătut. - Scrie cerința de focus în enunțul testului (ce câmp primește focus și când), ca să știi dacă e bug sau presupunere greșită.
Întrebări frecvente
Unde e focusul dacă nu e pe elementul meu?
Afișează-l: console.log(await page.evaluate(() => document.activeElement.outerHTML)). Vezi imediat dacă e pe body sau pe alt câmp.
click() pune focus?
Da, pe câmpuri, butoane și linkuri. focus() face același lucru fără click, deci fără să declanșeze handler-ele de click.
Erori înrudite
Error: locator.press: Unknown key: "Ctrl" Numele tastei din press() nu e unul pe care Playwright îl cunoaște. Tastele se scriu ca în standardul KeyboardEvent.key: Control (nu Ctrl), Enter, Escape (nu Esc), ArrowDown, Backspace; combinațiile cu +, de ex. Control+A sau ControlOrMeta+A ca să meargă și pe Mac. Error: expect(locator).toHaveValue(expected) failed Valoarea câmpului nu e cea așteptată. toHaveValue compară toată valoarea din input, textarea sau select, deci o parte din ea nu ajunge; scrie valoarea completă sau folosește o expresie regulată (de ex. /Ana/). Verifică și dacă ai ales câmpul corect. element is not visible Locatorul a găsit elementul, dar acesta e ascuns (hidden, display: none, într-un meniu închis), iar Playwright nu apasă elemente pe care utilizatorul nu le vede. Fă întâi pasul care îl afișează (hover pe meniu, click pe un tab, deschiderea unui dialog) sau corectează locatorul, dacă a găsit o copie ascunsă. Î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.
