Error: elementHandle.click: Element is not attached to the DOM
Un ElementHandle obținut cu page.$ / page.$$ / waitForSelector indică un element care între timp a fost șters din pagină, de obicei la o re-randare (filtrare, încărcare de date). Un handle nu se recalculează. Folosește un locator (page.getByTestId(...)), care caută elementul din nou la fiecare acțiune.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
page.$('selector') întoarce un ElementHandle: o referință fixă la acel nod din DOM, găsit în momentul apelului. Dacă aplicația înlocuiește lista (React, Vue sau un simplu innerHTML la filtrare), nodul vechi e scos din document, iar handle-ul rămâne legat de el. La click, Playwright constată că nodul nu mai e în pagină și aruncă Element is not attached to the DOM.
Locatorii (page.locator, getByRole, getByTestId) nu au problema: sunt doar o descriere, iar Playwright caută elementul din nou la fiecare acțiune și așteaptă să fie atașat, vizibil și stabil. De aceea documentația recomandă locatorii, iar page.$ și ElementHandle sunt considerate API vechi. Echivalentul din Selenium e StaleElementReferenceError.
De ce apare: cauzele frecvente
1Handle păstrat peste o re-randare
const buton = await page.$('[data-testid="add-to-cart"]');
await page.getByLabel('Categorie').selectOption('Telefoane');
await buton.click();await page.getByLabel('Categorie').selectOption('Telefoane');
await page.getByTestId('add-to-cart').first().click();Filtrarea a înlocuit cardurile. Locatorul găsește butonul din lista nouă.
2Handle-uri din page.$$ folosite într-o buclă care schimbă pagina
for (const b of await page.$$('[data-testid="remove-item"]')) {
await b.click();
}const butoane = page.getByTestId('remove-item');
while (await butoane.count() > 0) {
await butoane.first().click();
}După primul click coșul se redesenează și restul handle-urilor devin vechi. Locatorul recitește lista la fiecare pas.
Repară eroarea, direct în pagină
Testul adaugă un telefon în coș ia butonul „Adaugă în coș” cu page.$ înainte de filtrare, iar filtrarea redesenează cardurile; în Playwright real click-ul pică cu Element is not attached to the DOM. Folosește un locator căutat după filtrare, pentru primul card. Testul afișează numărul din coș.
import { test, expect } from '@playwright/test';
test('adaugă un telefon în coș', async ({ page }) => {
await page.goto('/#/catalog');
await expect(page.getByTestId('product-card')).toHaveCount(8);
const buton = await page.$('[data-testid="add-to-cart"]');
await page.getByLabel('Categorie').selectOption('Telefoane');
await expect(page.getByTestId('product-card')).toHaveCount(2);
await buton.click();
await expect(page.getByTestId('cart-count')).toHaveText('1');
console.log(await page.getByTestId('cart-count').textContent());
});Indiciu
Un handle rămâne legat de nodul vechi; un locator caută din nou.
Reparația
import { test, expect } from '@playwright/test';
test('adaugă un telefon în coș', async ({ page }) => {
await page.goto('/#/catalog');
await expect(page.getByTestId('product-card')).toHaveCount(8);
await page.getByLabel('Categorie').selectOption('Telefoane');
await expect(page.getByTestId('product-card')).toHaveCount(2);
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.$ a reținut butonul din primul card al listei complete. Filtrarea după Telefoane a înlocuit cardurile, deci nodul reținut nu mai era în pagină. page.getByTestId('add-to-cart').first() e evaluat abia la click, pe lista nouă, deci apasă butonul primului telefon, iar coșul ajunge la 1.
Alte forme ale mesajului
Error: elementHandle.fill: Element is not attached to the DOMError: elementHandle.textContent: Element is not attached to the DOM- element was detached from the DOM, retryingError: elementHandle.click: Element is not attached to the DOM Call log: - attempting click action
Cum o eviți pe viitor
- Folosește locatori în loc de
page.$,page.$$șiElementHandle. - Nu salva elemente în variabile înaintea unei acțiuni care reîncarcă lista; salvează locatorul.
- Pentru a număra sau parcurge elemente, folosește
locator.count(),nth(i),all()după ce lista e stabilă (toHaveCount).
Întrebări frecvente
Când mai am nevoie de ElementHandle?
Rar: pentru API-uri vechi sau evaluateHandle. Pentru click, completare și verificări, locatorii fac tot ce trebuie și sunt mai stabili.
De ce testul merge uneori?
Dacă click-ul ajunge înainte ca lista să fie înlocuită, nodul vechi e încă în pagină. Depinde de viteză, deci testul e instabil.
Erori înrudite
StaleElementReferenceError: stale element reference: stale element not found Elementul găsit mai devreme a fost scos din pagină și înlocuit (după o căutare, un filtru, o re-randare), iar referința veche nu mai e validă. Caută elementul din nou după acțiunea care schimbă pagina, nu păstra WebElement-uri vechi. 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ă. 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. Î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.
