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

Error: elementHandle.click: Element is not attached to the DOM

Pe scurt

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

Greșit
JavaScript
const buton = await page.$('[data-testid="add-to-cart"]');
await page.getByLabel('Categorie').selectOption('Telefoane');
await buton.click();
Corect
JavaScript
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

Greșit
JavaScript
for (const b of await page.$$('[data-testid="remove-item"]')) {
  await b.click();
}
Corect
JavaScript
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ă tu

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

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

Alte forme ale mesajului

  • Error: elementHandle.fill: Element is not attached to the DOM
  • Error: elementHandle.textContent: Element is not attached to the DOM
  • - element was detached from the DOM, retrying
  • Error: 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.$$ și ElementHandle.
  • 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

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