...
Eroare Testare automată · Selenium WebDriver și Mocha

StaleElementReferenceError: stale element reference: stale element not found

Pe scurt

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.

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

Ce înseamnă

Un WebElement din Selenium e o referință la un nod anume din DOM. Când aplicația re-desenează lista (căutare, filtrare, sortare, paginare) sau navighează, nodul vechi e șters și înlocuit cu unul nou, chiar dacă arată identic. Orice apel pe referința veche (getText, click) dă stale element reference: elementul nu mai e atașat la document. Versiunile mai vechi de ChromeDriver scriu element is not attached to the page document.

Eroarea e tipică pentru aplicațiile moderne (React, Vue), care înlocuiesc des elementele. Apare și intermitent: dacă re-randarea se întâmplă uneori înainte, alteori după citire, testul devine instabil. Reparația e să cauți elementele după acțiunea care schimbă pagina și după ce aștepți rezultatul. Pentru o așteptare explicită că lista veche a dispărut există until.stalenessOf(elementVechi). Playwright evită problema: locatorii caută elementul din nou la fiecare acțiune.

De ce apare: cauzele frecvente

1Lista citită înainte de căutare

Greșit
JavaScript
const nume = await driver.findElements(By.css('[data-testid="product-name"]'));
await cautare.sendKeys('telefon', Key.ENTER);
console.log(await nume[0].getText());
Corect
JavaScript
await cautare.sendKeys('telefon', Key.ENTER);
await driver.wait(until.stalenessOf(primulVechi), 5000);
const nume = await driver.findElements(By.css('[data-testid="product-name"]'));

Căutarea înlocuiește cardurile. Elementele găsite înainte nu mai există; caută-le din nou după schimbare.

2Element păstrat între pagini

Greșit
JavaScript
const cos = await driver.findElement(By.css('[data-testid="cart-link"]'));
await driver.navigate().refresh();
await cos.click();
Corect
JavaScript
await driver.navigate().refresh();
await driver.findElement(By.css('[data-testid="cart-link"]')).click();

După reîncărcare, tot documentul e nou. Referințele vechi nu mai trimit la nimic.

3Re-randare după fiecare acțiune într-o buclă

Greșit
JavaScript
const butoane = await driver.findElements(By.css('[data-testid="remove-item"]'));
for (const b of butoane) await b.click();
Corect
JavaScript
let butoane = await driver.findElements(By.css('[data-testid="remove-item"]'));
while (butoane.length) {
  await butoane[0].click();
  await driver.wait(until.stalenessOf(butoane[0]), 5000);
  butoane = await driver.findElements(By.css('[data-testid="remove-item"]'));
}

Fiecare „Elimină” redesenează tabelul. Caută lista din nou după fiecare click.

Repară tu

Repară eroarea, direct în pagină

Testul Selenium după căutare primul rezultat e un telefon pică cu StaleElementReferenceError: numele produselor sunt găsite înainte de căutare, iar căutarea redesenează lista. Repară testul: după căutarea telefon (cu Enter), așteaptă ca vechiul prim element să dispară (until.stalenessOf), apoi caută din nou numele și afișează-l pe primul.

Codul care dă eroarea
JavaScript
const { Builder, By, until, Key } = require('selenium-webdriver');
const assert = require('node:assert');

describe('Căutare', function () {
  let driver;

  before(async function () {
    driver = await new Builder().forBrowser('chrome').build();
  });

  after(async function () {
    await driver.quit();
  });

  it('după căutare primul rezultat e un telefon', async function () {
    await driver.get('http://localhost:3000/#/catalog');
    const cautare = await driver.wait(until.elementLocated(By.css('[data-testid="search-input"]')), 5000);
    const inainte = await driver.wait(until.elementsLocated(By.css('[data-testid="product-name"]')), 5000);
    await cautare.sendKeys('telefon', Key.ENTER);
    await driver.sleep(1000);
    const primul = await inainte[0].getText();
    assert.match(primul, /Telefon/);
  });
});
Indiciu

Elementele găsite înainte de căutare nu mai există după ea.

Alte forme ale mesajului

  • StaleElementReferenceError: stale element reference: element is not attached to the page document
  • StaleElementReferenceError: stale element reference: stale element not found in the current frame
  • org.openqa.selenium.StaleElementReferenceException: stale element reference

Cum o eviți pe viitor

  • Nu păstra WebElement-uri în variabile peste acțiuni care schimbă pagina; păstrează locatorii (By) și caută la nevoie.
  • După o acțiune care redesenează lista, așteaptă rezultatul (until.stalenessOf, until.elementTextIs pe un contor) înainte să citești.
  • În Page Object-uri, expune metode care caută elementele la fiecare apel, nu câmpuri cu elemente găsite în constructor.

Întrebări frecvente

De ce eroarea apare doar uneori?

Pentru că depinde de cine e mai rapid: aplicația care redesenează sau testul care citește. Când citirea ajunge înainte de re-randare, trece; când ajunge după, pică. E o cursă, deci testul e flaky.

Un try/catch cu reîncercare e o soluție?

Funcționează ca plasă de siguranță, dar ascunde cauza. Mai sigur e să aștepți explicit sfârșitul schimbării și să cauți elementele după ea.

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.