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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul are trei bucăți utile: Waiting for element to be located (condiția until.elementLocated), locatorul căutat, scris de Selenium ca By(css selector, #cautare), și Wait timed out after 5000ms (cât a așteptat). Spre deosebire de NoSuchElementError, aici ai pus deja o așteptare, deci problema nu mai e momentul căutării.
Dacă după 5 secunde elementul tot nu există, de cele mai multe ori locatorul e greșit: By.css('#cautare') când câmpul are data-testid="search-input", o clasă schimbată la un redesign, un text diferit într-un XPath. Alte cauze: testul e pe altă pagină decât crezi (o redirecționare la login, o eroare 404), elementul e într-un iframe sau chiar apare mai târziu (un raport lent), caz în care mărești timpul. Verifică await driver.getCurrentUrl() și HTML-ul paginii în momentul eșecului.
De ce apare: cauzele frecvente
1Locator după un id inexistent
await driver.wait(until.elementLocated(By.css('#cautare')), 5000);await driver.wait(until.elementLocated(By.css('[data-testid="search-input"]')), 5000);Câmpul de căutare nu are (sau nu mai are) id-ul cautare. Locatorul trebuie să corespundă atributelor reale din HTML.
2Ești pe altă pagină
await driver.get('http://localhost:3000/#/cont');
await driver.wait(until.elementLocated(By.css('[data-testid="account-name"]')), 5000);// autentifică-te întâi, apoi:
await driver.get('http://localhost:3000/#/cont');
await driver.wait(until.elementLocated(By.css('[data-testid="account-name"]')), 5000);Fără sesiune, /cont redirecționează la login, unde elementul nu există niciodată.
3Element într-adevăr lent
await driver.wait(until.elementLocated(By.css('[data-testid="report-ready"]')), 2000);await driver.wait(until.elementLocated(By.css('[data-testid="report-ready"]')), 15000);Dacă operația chiar durează, timpul de așteptare trebuie să o acopere (iar timeout-ul testului mocha, la fel).
Repară eroarea, direct în pagină
Testul Selenium caută telefoanele pică cu TimeoutError: Waiting for element to be located By(css selector, #cautare): testul folosește un id vechi, pe care câmpul de căutare nu îl mai are. Câmpul are acum data-testid="search-input", atributul stabil pentru teste. Repară locatorul, apoi testul caută telefon (cu Enter), așteaptă rezultatul și afișează textul din results-count.
const { Builder, By, until, Key } = require('selenium-webdriver');
const assert = require('node:assert');
describe('Catalog', function () {
this.timeout(10000);
let driver;
before(async function () {
driver = await new Builder().forBrowser('chrome').build();
});
after(async function () {
await driver.quit();
});
it('caută telefoanele', async function () {
await driver.get('http://localhost:3000/#/catalog');
const cautare = await driver.wait(until.elementLocated(By.css('#cautare')), 5000);
await cautare.sendKeys('telefon', Key.ENTER);
});
});Indiciu
Locatorul trebuie să folosească atributul real al câmpului.
Reparația
const { Builder, By, until, Key } = require('selenium-webdriver');
const assert = require('node:assert');
describe('Catalog', function () {
this.timeout(10000);
let driver;
before(async function () {
driver = await new Builder().forBrowser('chrome').build();
});
after(async function () {
await driver.quit();
});
it('caută telefoanele', 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('telefon', 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
By.css('#cautare') căuta un element cu id="cautare", care nu există în catalog, deci așteptarea a expirat după 5 secunde. By.css('[data-testid="search-input"]') corespunde atributului real.
După sendKeys('telefon', Key.ENTER), catalogul filtrează produsele; until.elementTextIs așteaptă ca results-count să ajungă la 2 produse, deci citirea textului se face după actualizare, nu înainte.
Alte forme ale mesajului
TimeoutError: Waiting for element to be located By(xpath, //button[text()='Login']) Wait timed out after 10000msTimeoutError: Waiting for at least one element to be located By(css selector, .card) Wait timed out after 5000msTimeoutError: Waiting for element to be located By(css selector, #email)
Cum o eviți pe viitor
- Copiază selectorii din DevTools și verifică-i cu
document.querySelectorîn consolă. - Ține locatorii unei pagini într-un Page Object, ca o schimbare de HTML să se repare într-un singur loc.
- Când o așteptare expiră, afișează URL-ul curent: arată imediat o redirecționare neașteptată.
Întrebări frecvente
Cât timp ar trebui să dau lui driver.wait?
Atât cât durează în mod normal operația, plus o marjă (de obicei 5–10 secunde). Atenție și la timeout-ul mocha (implicit 2000 ms): testul întreg trebuie să aibă mai mult timp decât așteptarea din el, altfel mocha îl oprește primul.
E același lucru cu NoSuchElementError?
Cauzele se suprapun, dar aici ai așteptat deja. Dacă elementul nu apare nici după așteptare, nu mai e o problemă de moment, ci de selector sau de pagină.
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. Error: Timeout of 2000ms exceeded. For async tests and hooks, ensure "done()" is called; if returning a Promise, ensure it resolves. Mocha oprește orice test sau hook care durează peste 2 secunde (implicit), iar testele Selenium durează aproape mereu mai mult: pornirea browserului, încărcarea paginii, așteptările. Mărește limita cu this.timeout(30000) în describe sau --timeout 30000 în configurația mocha. TimeoutError: page.waitForSelector: Timeout 30000ms exceeded. Selectorul CSS dat lui waitForSelector nu a găsit niciun element vizibil în timpul dat: selectorul e greșit (clasă, id sau atribut care nu există) sau elementul rămâne ascuns. Verifică selectorul în pagină și, mai bine, înlocuiește așteptarea cu o aserțiune pe un locator: expect(locator).toHaveCount() sau toBeVisible(). Î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.
