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.
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
const nume = await driver.findElements(By.css('[data-testid="product-name"]'));
await cautare.sendKeys('telefon', Key.ENTER);
console.log(await nume[0].getText());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
const cos = await driver.findElement(By.css('[data-testid="cart-link"]'));
await driver.navigate().refresh();
await cos.click();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ă
const butoane = await driver.findElements(By.css('[data-testid="remove-item"]'));
for (const b of butoane) await b.click();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ă 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.
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.
Reparația
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.wait(until.stalenessOf(inainte[0]), 5000);
const dupa = await driver.wait(until.elementsLocated(By.css('[data-testid="product-name"]')), 5000);
const primul = await dupa[0].getText();
assert.match(primul, /Telefon/);
console.log(primul);
});
});De ce merge
Lista inainte conținea referințe la cardurile de dinainte de căutare. Căutarea telefon a înlocuit cardurile cu altele noi, deci inainte[0].getText() a încercat să citească un nod șters și a primit stale element reference.
driver.wait(until.stalenessOf(inainte[0]), 5000) așteaptă tocmai momentul în care nodul vechi dispare, adică lista a fost redesenată. Abia apoi findElements găsește noile nume, iar primul este Telefon Nova 12.
Alte forme ale mesajului
StaleElementReferenceError: stale element reference: element is not attached to the page documentStaleElementReferenceError: stale element reference: stale element not found in the current frameorg.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.elementTextIspe 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
NoSuchElementError: no such element: Unable to locate element: {"method":"css selector","selector":"[data-testid=\"product-card\"]"} driver.findElement nu a găsit elementul în momentul apelului: Selenium nu așteaptă implicit. Dacă elementul apare după încărcare, așteaptă-l cu driver.wait(until.elementLocated(By.css('...')), 5000); dacă nu apare niciodată, selectorul e greșit. 1 flaky Raportul spune „1 flaky” când un test a picat, apoi a trecut la reîncercare (retries). Cauza tipică: testul citește pagina după o pauză fixă (waitForTimeout) sau cu valori de moment (count(), textContent(), isVisible()). Înlocuiește-le cu aserțiuni care așteaptă: toHaveCount, toHaveText, toBeVisible. TimeoutError: Waiting until element text is
Wait timed out after 5000ms until.elementTextIs a așteptat ca textul elementului să fie exact cel dat, dar nu a ajuns niciodată la el. Comparația e exactă: „2” nu e „2 produse”. Folosește textul complet, until.elementTextContains pentru o parte din el, sau verifică dacă acțiunea care schimbă textul chiar a avut loc. Î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.
