Error: Resolution method is overspecified. Specify a callback *or* return a Promise; not both.
Testul Mocha e o funcție async (care întoarce o promisiune) și, în plus, primește parametrul done. Mocha nu știe după care să se ia, așa că refuză testul. La codul cu await, scoate done din parametri și din corp.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mocha are două feluri de a afla că un test asincron s-a terminat: apelul funcției done primite ca parametru (stilul vechi, cu callback-uri) sau promisiunea întoarsă de test (stilul cu async/await). O funcție async function (done) le are pe amândouă: întoarce mereu o promisiune și cere și done. Mocha consideră asta o greșeală și pică testul cu Resolution method is overspecified, chiar dacă restul codului e corect.
Apare des când transformi un test vechi cu callback-uri în async și uiți parametrul, sau când copiezi un hook (before(async function (done) {...})). Regula e simplă: cu async, fără done; cu done, fără async și fără return de promisiune. Mesajul apare la test sau la hook-ul respectiv, cu titlul lui în raport.
De ce apare: cauzele frecvente
1async și done împreună
it('cuponul e valid', async function (done) {
await driver.get(url);
done();
});it('cuponul e valid', async function () {
await driver.get(url);
});Promisiunea funcției async spune deja când s-a terminat testul.
2Hook cu done și return
before(function (done) {
return new Builder().forBrowser('chrome').build().then((d) => { driver = d; done(); });
});before(async function () {
driver = await new Builder().forBrowser('chrome').build();
});Întorcea și promisiunea, și chema done. Varianta async e mai scurtă și are un singur mecanism.
Repară eroarea, direct în pagină
Testul Mocha cuponul REDUCERE10 e acceptat e scris ca async function (done), iar Mocha real îl refuză cu Resolution method is overspecified. Rescrie-l doar cu async/await, fără done. Testul aplică cuponul în coș și afișează mesajul din coupon-message.
const { Builder, By, until, Key } = require('selenium-webdriver');
const assert = require('node:assert');
describe('Cupon', function () {
this.timeout(10000);
let driver;
before(async function () {
driver = await new Builder().forBrowser('chrome').build();
});
after(async function () {
await driver.quit();
});
it('cuponul REDUCERE10 e acceptat', async function (done) {
await driver.get('http://localhost:3000/#/cos');
await driver.wait(until.elementLocated(By.css('[data-testid="coupon-input"]')), 5000);
await driver.findElement(By.css('[data-testid="coupon-input"]')).sendKeys('REDUCERE10');
await driver.findElement(By.css('[data-testid="apply-coupon"]')).click();
const mesaj = await driver.wait(until.elementLocated(By.css('[data-testid="coupon-message"].sr-ok')), 5000);
console.log(await mesaj.getText());
done();
});
});Indiciu
O funcție async întoarce deja o promisiune.
Reparația
const { Builder, By, until, Key } = require('selenium-webdriver');
const assert = require('node:assert');
describe('Cupon', function () {
this.timeout(10000);
let driver;
before(async function () {
driver = await new Builder().forBrowser('chrome').build();
});
after(async function () {
await driver.quit();
});
it('cuponul REDUCERE10 e acceptat', async function () {
await driver.get('http://localhost:3000/#/cos');
await driver.wait(until.elementLocated(By.css('[data-testid="coupon-input"]')), 5000);
await driver.findElement(By.css('[data-testid="coupon-input"]')).sendKeys('REDUCERE10');
await driver.findElement(By.css('[data-testid="apply-coupon"]')).click();
const mesaj = await driver.wait(until.elementLocated(By.css('[data-testid="coupon-message"].sr-ok')), 5000);
console.log(await mesaj.getText());
});
});De ce merge
Mocha află că testul s-a terminat fie din done, fie din promisiunea întoarsă; o funcție async întoarce mereu o promisiune, deci cu done în plus avea două mecanisme și refuza testul. Fără done, Mocha așteaptă promisiunea, adică toți pașii cu await, iar mesajul cuponului e verificat la final.
Alte forme ale mesajului
Error: Resolution method is overspecified. Specify a callback *or* return a Promise; not both. at Context.<anonymous> (tests/cupon.test.js:18:3)1) "before all" hook in "Cupon": Error: Resolution method is overspecified.
Cum o eviți pe viitor
- Scrie testele și hook-urile noi doar cu
async/await, fărădone. - Când modernizezi un test vechi, șterge parametrul
doneși toate apelurile lui. - Regula ESLint
mocha/no-async-and-done(dineslint-plugin-mocha) semnalează exact combinația asta. - La review, caută
function (done)în testele care conținawait.
Întrebări frecvente
Mai are rost done?
Doar pentru cod bazat pe evenimente sau callback-uri care nu întorc promisiuni. Cu selenium-webdriver, toate comenzile întorc promisiuni, deci async/await e suficient.
Și dacă uit done într-un test cu callback?
Mocha așteaptă până la timeout și pică cu Timeout of 2000ms exceeded. For async tests and hooks, ensure "done()" is called.
Erori înrudite
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. Error: done() called multiple times in test <Catalog afișează 8 produse> of file /proiect/tests/catalog.test.js Funcția done a unui test (sau hook) Mocha a fost apelată de două ori: o dată la finalul codului sincron și încă o dată în callback-ul unei promisiuni, ori în then și în catch. Un test se termină o singură dată. Renunță la done și scrie testul cu async / await. TypeError: this.timeout is not a function Ai scris describe sau it cu funcție săgeată (() => {}), iar în săgeți this nu e contextul Mocha, deci nu are metoda timeout. Folosește function () { this.timeout(10000); ... } în describe / it / hook-urile unde ai nevoie de this. Î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.
