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.
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
await page.goto('/#/catalog');
const buton = await page.$('[data-testid="add-to-cart"]');
await buton.click();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
const link = await page.$('#cart-link');
await link.click();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
await (await page.$$('.card'))[5].click();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ă 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.
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.
Reparația
import { test, expect } from '@playwright/test';
test('adaugă primul produs în coș', async ({ page }) => {
await page.goto('/#/catalog');
await page.getByTestId('add-to-cart').first().click();
await expect(page.getByTestId('cart-count')).toHaveText('1');
console.log(await page.getByTestId('cart-count').textContent());
});De ce merge
page.$ întoarce elementul doar dacă există în acel moment. Imediat după goto, catalogul afișa încă „Se încarcă produsele...”, deci rezultatul era null, iar .click() pe null a aruncat eroarea.
page.getByTestId('add-to-cart').first() e un locator: la click() așteaptă ca butonul să apară, să fie vizibil și activ. toHaveText('1') așteaptă apoi actualizarea coșului, care vine după cererea de adăugare.
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), nupage.$(...) === null. - Pluginul
eslint-plugin-playwrightare regulano-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
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ă. TimeoutError: page.waitForSelector: Timeout 30000ms exceeded. Selectorul CSS dat lui waitForSelector nu a găsit niciun element vizibil în timpul dat: selectorul e greșit (clasă, id sau atribut care nu există) sau elementul rămâne ascuns. Verifică selectorul în pagină și, mai bine, înlocuiește așteptarea cu o aserțiune pe un locator: expect(locator).toHaveCount() sau toBeVisible(). 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ă. Î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.
