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

TypeError: Cannot read properties of null (reading 'click')

Pe scurt

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.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Mesajul e o eroare JavaScript: s-a încercat citirea metodei click dintr-o valoare null. În testele Playwright, valoarea vine aproape mereu din page.$(selector) sau elementHandle.$(...), API-ul vechi cu ElementHandle: întoarce elementul dacă există chiar în acel moment, altfel null, fără să aștepte.

De aceea codul merge pe pagini statice și pică pe cele care încarcă datele asincron: imediat după goto, lista de produse încă nu există. Alte cauze: selectorul e greșit, elementul e în alt document (după o navigare) sau ai scris await page.$('...').click(), unde click se aplică promisiunii. Locatorii (page.locator, getByRole, getByTestId) sunt „leneși”: caută elementul abia la acțiune și reîncearcă până apare. Documentația Playwright recomandă locatorii în locul lui page.$.

De ce apare: cauzele frecvente

1page.$ imediat după navigare

Greșit
JavaScript
await page.goto('/#/catalog');
const buton = await page.$('[data-testid="add-to-cart"]');
await buton.click();
Corect
JavaScript
await page.goto('/#/catalog');
await page.getByTestId('add-to-cart').first().click();

Produsele vin de la API după câteva sute de ms. page.$ nu așteaptă și întoarce null; locatorul așteaptă.

2Selector greșit

Greșit
JavaScript
const link = await page.$('#cart-link');
await link.click();
Corect
JavaScript
await page.getByTestId('cart-link').click();

Linkul are data-testid, nu id. page.$ întoarce null fără niciun mesaj despre selector; locatorul ar raporta clar ce a căutat.

3await în locul greșit

Greșit
JavaScript
await (await page.$$('.card'))[5].click();
Corect
JavaScript
await page.locator('.card').nth(5).click();

Dacă lista are mai puțin de 6 elemente, [5] e undefined. nth(5) pe locator așteaptă al șaselea element.

Repară tu

Repară eroarea, direct în pagină

Testul adaugă primul produs în coș pică cu TypeError: Cannot read properties of null (reading 'click'): page.$ caută butonul imediat după deschiderea catalogului, înainte să se încarce produsele. Repară testul cu un locator care așteaptă butonul (primul „Adaugă în coș”), verifică că numărul din coș (cart-count) devine 1 și afișează-l.

Codul care dă eroarea
JavaScript
import { test, expect } from '@playwright/test';

test('adaugă primul produs în coș', async ({ page }) => {
  await page.goto('/#/catalog');
  const buton = await page.$('[data-testid="add-to-cart"]');
  await buton.click();
  await expect(page.getByTestId('cart-count')).toHaveText('1');
});
Indiciu

Locatorii așteaptă elementul, page.$ nu.

Alte forme ale mesajului

  • TypeError: Cannot read properties of null (reading 'textContent')
  • TypeError: Cannot read properties of null (reading 'fill')
  • TypeError: Cannot read properties of undefined (reading 'click')
  • TypeError: Cannot read properties of null (reading 'getAttribute')

Cum o eviți pe viitor

  • Folosește locatori pentru toate acțiunile și aserțiunile; păstrează page.$ doar pentru cod vechi.
  • Dacă ai nevoie să verifici că un element lipsește, folosește await expect(locator).toHaveCount(0), nu page.$(...) === null.
  • Pluginul eslint-plugin-playwright are regula no-element-handle, care semnalează page.$.

Întrebări frecvente

De ce codul vechi cu page.$ mergea?

Probabil pe pagini care se încărcau complet înainte de goto sau cu pauze (waitForTimeout). Pe aplicații moderne, care încarcă datele după afișare, citirea imediată e o cursă.

Locatorul nu dă niciodată null?

Corect. Un locator e o descriere; dacă elementul nu apare, acțiunea așteaptă și apoi pică cu un mesaj clar (timeout + call log cu ce a căutat).

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.