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

TimeoutError: Waiting for element to be located By(css selector, #cautare) Wait timed out after 5000ms

Pe scurt

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

Greșit
JavaScript
await driver.wait(until.elementLocated(By.css('#cautare')), 5000);
Corect
JavaScript
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ă

Greșit
JavaScript
await driver.get('http://localhost:3000/#/cont');
await driver.wait(until.elementLocated(By.css('[data-testid="account-name"]')), 5000);
Corect
JavaScript
// 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

Greșit
JavaScript
await driver.wait(until.elementLocated(By.css('[data-testid="report-ready"]')), 2000);
Corect
JavaScript
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ă tu

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.

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

Alte forme ale mesajului

  • TimeoutError: Waiting for element to be located By(xpath, //button[text()='Login']) Wait timed out after 10000ms
  • TimeoutError: Waiting for at least one element to be located By(css selector, .card) Wait timed out after 5000ms
  • TimeoutError: 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

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