Error: page.$eval: Failed to find element matching selector "#product-price"
page.$eval nu a găsit niciun element pentru selectorul dat, în momentul apelului (nu așteaptă). Selectorul e greșit sau elementul încă nu e în pagină. Înlocuiește cu un locator: await page.getByTestId('product-price').textContent(), după o aserțiune care așteaptă.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
page.$eval(selector, fn) caută primul element care se potrivește cu selectorul CSS și rulează fn pe el, în browser. Dacă nu găsește nimic, aruncă Failed to find element matching selector "#product-price", cu selectorul exact între ghilimele. Spre deosebire de locatori, $eval nu reîncearcă: verifică o singură dată.
Două întrebări te duc la cauză. Selectorul e corect? Uită-te în DevTools: #product-price caută un id, dar elementul poate avea doar data-testid="product-price" sau o clasă. Elementul exista în momentul apelului? Pe paginile care încarcă datele asincron (pagina unui produs, contul, coșul), apelul imediat după goto ajunge înainte de date. În ambele cazuri, reparația modernă e aceeași: un locator (getByTestId, getByRole) plus o aserțiune web-first, care așteaptă și raportează clar ce a căutat. page.$$eval nu dă această eroare: pentru zero elemente primește o listă goală.
De ce apare: cauzele frecvente
1Selector cu id în loc de data-testid
const pret = await page.$eval('#product-price', (el) => el.textContent);const pret = await page.getByTestId('product-price').textContent();Elementul nu are id; are data-testid. getByTestId caută exact atributul de test.
2Apel înainte să se încarce datele
await page.goto('/#/produs/1');
const nume = await page.$eval('[data-testid="product-title"]', (el) => el.textContent);await page.goto('/#/produs/1');
await expect(page.getByTestId('product-title')).toHaveText('Laptop UltraBook 14');Pagina produsului cere datele de la API. Aserțiunea așteaptă; $eval citește o singură dată.
3Selector CSS scris greșit
await page.$eval('[data-testid=product price]', (el) => el.textContent);await page.$eval('[data-testid="product-price"]', (el) => el.textContent);Valorile cu spații sau cratime în selectorul de atribut trebuie puse între ghilimele și scrise exact.
Repară eroarea, direct în pagină
Testul prețul laptopului pe pagina produsului pică cu page.$eval: Failed to find element matching selector "#product-price". Pe pagina /#/produs/1, prețul are data-testid="product-price", fără id, iar datele vin de la API. Înlocuiește $eval cu un locator: verifică prețul 3.499,00 lei cu o aserțiune care așteaptă, apoi afișează-l.
import { test, expect } from '@playwright/test';
test('prețul laptopului pe pagina produsului', async ({ page }) => {
await page.goto('/#/produs/1');
const pret = await page.$eval('#product-price', (el) => el.textContent);
expect(pret).toBe('3.499,00 lei');
});Indiciu
Elementul are un atribut de test, nu un id.
Reparația
import { test, expect } from '@playwright/test';
test('prețul laptopului pe pagina produsului', async ({ page }) => {
await page.goto('/#/produs/1');
const pret = page.getByTestId('product-price');
await expect(pret).toHaveText('3.499,00 lei');
console.log(await pret.textContent());
});De ce merge
Selectorul #product-price căuta un element cu id="product-price", care nu există, iar $eval a raportat imediat că nu a găsit nimic. Chiar cu selectorul corect, $eval ar fi putut ajunge înainte de răspunsul API-ului.
page.getByTestId('product-price') caută după data-testid, iar toHaveText('3.499,00 lei') așteaptă până când prețul apare cu valoarea corectă. După aserțiune, textContent() citește sigur valoarea pentru afișare.
Alte forme ale mesajului
Error: page.$eval: Failed to find element matching selector ".total"Error: elementHandle.$eval: Failed to find element matching selector "span"Error: frame.$eval: Failed to find element matching selector "#id"
Cum o eviți pe viitor
- Folosește locatori și metodele lor (
textContent,getAttribute,inputValue,evaluate) în loc de$eval. - Verifică selectorul în consola browserului cu
document.querySelector('...')înainte să-l pui în test. - Pune o aserțiune care așteaptă (
toBeVisible,toHaveText) înainte de orice citire pe o pagină care se încarcă asincron.
Întrebări frecvente
Care e diferența dintre $eval și locator.evaluate?
locator.evaluate(fn) așteaptă elementul (ca orice acțiune pe locator) și verifică să fie unul singur (strict mode). $eval ia primul element existent sau pică imediat.
De ce $$eval nu dă eroarea?
$$eval lucrează pe toate elementele găsite; dacă nu găsește niciunul, funcția primește o listă goală. Deci nu pică, dar poate întoarce un rezultat gol fără să observi.
Erori înrudite
TypeError: Cannot read properties of null (reading 'click') page.$() (sau page.$$()[0]) nu a găsit elementul și a întors null, iar codul a apelat .click() pe null. page.$ nu așteaptă: dacă elementul apare după încărcare, primești null. Folosește locatori, page.getByTestId('...').click(), care așteaptă singuri elementul. Received: <element(s) not found> Aserțiunea nu a găsit niciun element pentru locatorul dat, deci selectorul e greșit sau elementul nu există pe pagina curentă. Verifică în pagină cum poate fi găsit elementul (rol, text, data-testid) și scrie locatorul după asta, nu după un id sau o clasă presupusă. Error: page.evaluate: ReferenceError: id is not defined Funcția dată lui page.evaluate rulează în browser, nu în test, deci nu vede variabilele testului. Transmite valoarea ca al doilea argument: page.evaluate((id) => ..., id). Î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.
