...
Eroare Testare automată · Cod rulat în pagină: evaluate, $ și $eval

Error: page.$eval: Failed to find element matching selector "#product-price"

Pe scurt

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

Greșit
JavaScript
const pret = await page.$eval('#product-price', (el) => el.textContent);
Corect
JavaScript
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

Greșit
JavaScript
await page.goto('/#/produs/1');
const nume = await page.$eval('[data-testid="product-title"]', (el) => el.textContent);
Corect
JavaScript
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

Greșit
JavaScript
await page.$eval('[data-testid=product price]', (el) => el.textContent);
Corect
JavaScript
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ă tu

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.

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

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

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