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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
driver.wait(until.elementTextIs(el, text), ms) citește textul vizibil al elementului (getText()) la intervale scurte și se oprește când e identic cu valoarea dată. Dacă până la final nu e, primești Waiting until element text is și Wait timed out after 5000ms. Mesajul nu arată nici textul așteptat, nici pe cel primit, deci trebuie să-l citești tu.
Cauze frecvente: textul real conține mai mult (unitatea, o etichetă: „2 produse”, „Total: 148,00 lei”); diferențe de majuscule sau diacritice; acțiunea care ar trebui să schimbe textul nu a avut efect (căutarea nu s-a trimis, butonul era dezactivat); sau elementul ales e altul decât crezi. until.elementTextContains verifică doar o parte, iar until.elementTextMatches acceptă un RegExp. Dacă elementul e înlocuit în timpul așteptării (re-randare), poți primi în schimb StaleElementReferenceError.
De ce apare: cauzele frecvente
1Doar o parte din text
await driver.wait(until.elementTextIs(numar, '2'), 5000);await driver.wait(until.elementTextIs(numar, '2 produse'), 5000);elementTextIs compară tot textul. Elementul afișează „2 produse”, nu doar cifra.
2Ai nevoie de potrivire parțială
await driver.wait(until.elementTextIs(total, '3.848,00 lei'), 5000);await driver.wait(until.elementTextContains(total, '3.848,00 lei'), 5000);Textul complet e „Total: 3.848,00 lei”. elementTextContains acceptă o parte din el.
3Acțiunea nu a schimbat textul
await cautare.sendKeys('laptop');
await driver.wait(until.elementTextIs(numar, '2 produse'), 1000);await cautare.sendKeys('laptop', Key.ENTER);
await driver.wait(until.elementTextIs(numar, '2 produse'), 5000);Fără Enter, căutarea pornește abia după o pauză (debounce). Trimite căutarea explicit și lasă destul timp.
Repară eroarea, direct în pagină
Testul Selenium căutarea „laptop” găsește 2 produse pică cu TimeoutError: Waiting until element text is: elementul results-count afișează textul complet 2 produse, iar testul așteaptă doar 2. Repară așteptarea ca să folosească textul complet, apoi afișează-l.
const { Builder, By, until, Key } = require('selenium-webdriver');
const assert = require('node:assert');
describe('Căutare', function () {
this.timeout(10000);
let driver;
before(async function () {
driver = await new Builder().forBrowser('chrome').build();
});
after(async function () {
await driver.quit();
});
it('căutarea „laptop” găsește 2 produse', async function () {
await driver.get('http://localhost:3000/#/catalog');
const cautare = await driver.wait(until.elementLocated(By.css('[data-testid="search-input"]')), 5000);
await cautare.sendKeys('laptop', Key.ENTER);
const numar = await driver.findElement(By.css('[data-testid="results-count"]'));
await driver.wait(until.elementTextIs(numar, '2'), 5000);
});
});Indiciu
elementTextIs compară tot textul elementului.
Reparația
const { Builder, By, until, Key } = require('selenium-webdriver');
const assert = require('node:assert');
describe('Căutare', function () {
this.timeout(10000);
let driver;
before(async function () {
driver = await new Builder().forBrowser('chrome').build();
});
after(async function () {
await driver.quit();
});
it('căutarea „laptop” găsește 2 produse', async function () {
await driver.get('http://localhost:3000/#/catalog');
const cautare = await driver.wait(until.elementLocated(By.css('[data-testid="search-input"]')), 5000);
await cautare.sendKeys('laptop', Key.ENTER);
const numar = await driver.findElement(By.css('[data-testid="results-count"]'));
await driver.wait(until.elementTextIs(numar, '2 produse'), 5000);
console.log(await numar.getText());
});
});De ce merge
until.elementTextIs(numar, '2') aștepta ca textul să fie exact 2, dar elementul afișează 2 produse. Comparația exactă nu a reușit niciodată, deci după 5 secunde așteptarea a expirat.
Cu textul complet, '2 produse', condiția devine adevărată imediat după ce căutarea (trimisă cu Enter) filtrează lista. Pentru o potrivire parțială s-ar fi putut folosi until.elementTextContains(numar, '2 produse') sau un RegExp cu elementTextMatches.
Alte forme ale mesajului
TimeoutError: Waiting until element text contains Wait timed out after 5000msTimeoutError: Waiting until element text matches Wait timed out after 5000msTimeoutError: Waiting for element to become visible Wait timed out after 5000ms
Cum o eviți pe viitor
- Copiază textul exact din pagină (cu unitate și etichetă) când folosești
elementTextIs. - Pentru valori care conțin și alt text, folosește
elementTextContainssauelementTextMatches. - Când așteptarea expiră, afișează
await el.getText()în test: vezi imediat diferența.
Întrebări frecvente
De ce mesajul nu arată textul primit?
Condițiile din until au o descriere fixă. Ca să vezi textul, citește-l după eșec sau scrie o condiție proprie: driver.wait(async () => (await el.getText()) === '2 produse', 5000, 'textul nu a devenit 2 produse').
Al treilea argument al lui driver.wait la ce folosește?
E mesajul afișat la expirare, în locul celui generic. Un mesaj clar („numărul de rezultate după căutare”) face raportul mult mai ușor de citit.
Erori înrudite
TimeoutError: Waiting for element to be located By(css selector, #cautare)
Wait timed out after 5000ms driver.wait(until.elementLocated(...)) a așteptat tot timpul dat și elementul nu a apărut. Așteptarea e corectă, dar selectorul nu se potrivește cu nimic în pagină (alt id, alt atribut, altă pagină). Corectează locatorul după HTML-ul real; mărește timpul doar dacă elementul chiar apare târziu. AssertionError [ERR_ASSERTION]: Expected values to be strictly equal: assert.strictEqual a primit două valori diferite (cu ===). Sub mesaj vezi ambele: de obicei un text comparat cu un număr ('1' !== 1), spații sau majuscule diferite, ori textul complet față de o parte din el. Transformă valoarea citită (Number, trim) sau corectează valoarea așteptată. Error: expect(locator).toHaveText(expected) failed Textul elementului nu a devenit egal cu cel așteptat în 5 secunde. Compară rândurile Expected și Received: toHaveText cere tot textul elementului (cu spațiile normalizate), deci pentru o bucată din text folosește toContainText sau o expresie regulată. Î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.
