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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mocha are un timeout implicit de 2000 ms pentru fiecare test și hook. Mesajul spune că limita a fost depășită și dă două sugestii generale: dacă testul folosește callback-ul done, verifică să fie apelat; dacă întoarce o promisiune (o funcție async), verifică să se termine.
În testele Selenium, cauza e aproape mereu că 2 secunde sunt prea puține: new Builder().build() pornește un browser (adesea 1–3 secunde), driver.get așteaptă încărcarea, iar driver.wait(..., 5000) poate aștepta mai mult decât limita testului, deci mocha îl oprește înaintea așteptării tale, cu un mesaj care nu spune nimic despre element. Reparația e un timeout realist pentru suită (this.timeout(30000) într-o funcție function, nu arrow function, sau timeout: 30000 în .mocharc). Dacă testul e un callback cu done care nu e apelat niciodată, timeout-ul ascunde altă greșeală.
De ce apare: cauzele frecvente
1Timeout-ul implicit al mocha e prea mic
describe('Catalog', function () {
it('încarcă produsele', async function () {
await driver.wait(until.elementLocated(By.css('[data-testid="product-card"]')), 10000);
});
});describe('Catalog', function () {
this.timeout(30000);
it('încarcă produsele', async function () {
await driver.wait(until.elementLocated(By.css('[data-testid="product-card"]')), 10000);
});
});Așteptarea de 10 s nu poate termina într-un test oprit după 2 s. Limita testului trebuie să fie mai mare decât așteptările din el.
2this.timeout într-o arrow function
describe('Catalog', () => {
this.timeout(30000);
});describe('Catalog', function () {
this.timeout(30000);
});Arrow function nu are this-ul mocha, deci setarea nu are efect (sau aruncă). Folosește function.
3done nu e apelat
it('salvează', function (done) {
salveaza().then(() => console.log('gata'));
});it('salvează', async function () {
await salveaza();
});Dacă ceri done, mocha așteaptă apelul lui. Cu async/await nu mai ai nevoie de done.
Repară eroarea, direct în pagină
Testul Selenium catalogul lent se încarcă pică cu Timeout of 2000ms exceeded: în acest mediu produsele vin după 6 secunde, iar testul le așteaptă corect cu driver.wait(..., 10000), dar mocha îl oprește după 2 secunde. Mărește limita suitei la 15000 ms cu this.timeout, ca testul să poată aștepta produsele; testul afișează apoi numărul de carduri.
const { Builder, By, until, Key } = require('selenium-webdriver');
const assert = require('node:assert');
describe('Catalog lent', function () {
let driver;
before(async function () {
driver = await new Builder().forBrowser('chrome').build();
});
after(async function () {
await driver.quit();
});
it('catalogul lent se încarcă', async function () {
await driver.get('http://localhost:3000/#/catalog');
const carduri = await driver.wait(until.elementsLocated(By.css('[data-testid="product-card"]')), 10000);
assert.strictEqual(carduri.length, 8);
});
});Indiciu
Limita mocha se setează în funcția describe.
Reparația
const { Builder, By, until, Key } = require('selenium-webdriver');
const assert = require('node:assert');
describe('Catalog lent', function () {
this.timeout(15000);
let driver;
before(async function () {
driver = await new Builder().forBrowser('chrome').build();
});
after(async function () {
await driver.quit();
});
it('catalogul lent se încarcă', async function () {
await driver.get('http://localhost:3000/#/catalog');
const carduri = await driver.wait(until.elementsLocated(By.css('[data-testid="product-card"]')), 10000);
assert.strictEqual(carduri.length, 8);
console.log(carduri.length);
});
});De ce merge
Mocha dă implicit fiecărui test 2 secunde. Catalogul are nevoie de 6 secunde ca să afișeze produsele, deci mocha a oprit testul înainte ca driver.wait să-și termine treaba.
this.timeout(15000) în describe (într-o funcție function, ca să aibă acces la this-ul mocha) dă fiecărui test și hook al suitei 15 secunde, mai mult decât așteptarea de 10 secunde din test. Acum until.elementsLocated primește produsele, iar testul afișează 8.
Alte forme ale mesajului
Error: Timeout of 2000ms exceeded. For async tests and hooks, ensure "done()" is called; if returning a Promise, ensure it resolves. (/proiect/tests/login.test.js)Error: Timeout of 10000ms exceeded. For async tests and hooks, ensure "done()" is called; if returning a Promise, ensure it resolves.1) "before all" hook in "Catalog": Error: Timeout of 2000ms exceeded.
Cum o eviți pe viitor
- Setează un timeout realist pentru toate testele de UI în
.mocharc.json("timeout": 30000). - Fă ca așteptările explicite (
driver.wait) să fie mai scurte decât timeout-ul testului, ca eroarea să fie cea despre element, nu cea generică. - Scrie testele cu
async/await, fărădone.
Întrebări frecvente
De ce pică uneori doar hook-ul before?
Pornirea browserului în before poate dura peste 2 secunde, mai ales în CI. Mocha raportează atunci "before all" hook și sare peste testele grupului.
Playwright Test are același lucru?
Are un timeout pe test, dar implicit de 30 de secunde, potrivit pentru teste de UI. Mesajul e Test timeout of 30000ms exceeded.
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. Test timeout of 30000ms exceeded. Testul a depășit timpul maxim (implicit 30 de secunde) pentru că a așteptat ceva ce nu s-a întâmplat: de obicei un element pe care locatorul nu îl găsește. Citește call log-ul de sub mesaj, vezi ce locator aștepta și corectează-l după rolul și textul real din pagină. NoSuchSessionError: invalid session id Testul folosește un driver a cărui sesiune a fost deja închisă cu driver.quit() (sau browserul s-a oprit). Cauza clasică: driverul e creat o dată în before, dar închis în afterEach, deci al doilea test pică. Pune quit() în același tip de hook ca crearea (before/after sau beforeEach/afterEach). Î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.
