TypeError: Wait condition must be a promise-like object, function, or a Condition object
driver.wait() a primit ca prim argument ceva care nu e o condiție: un locator By.css(...), un boolean sau un element. Condiția se construiește cu until: driver.wait(until.elementLocated(By.css(...)), 5000), sau e o funcție care întoarce true când starea e gata.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
driver.wait(conditie, timeout) acceptă trei feluri de condiții: un obiect Condition (tot ce întoarce until.*), o funcție (chemată repetat până întoarce o valoare truthy) sau o promisiune. Orice altceva (un By, un true, un WebElement, un text) dă imediat Wait condition must be a promise-like object, function, or a Condition object.
Greșeala clasică e driver.wait(By.css('.card'), 5000): pare logic („așteaptă elementul”), dar By.css doar descrie căutarea; condiția corectă e until.elementLocated(By.css('.card')). Alte variante: driver.wait(await el.isDisplayed()) (dă un boolean deja calculat, care nu se mai reevaluează) sau driver.wait(el). Pentru stări fără o condiție gata făcută, scrii o funcție: driver.wait(async () => (await driver.findElements(...)).length === 8, 5000).
De ce apare: cauzele frecvente
1Locator în loc de condiție
await driver.wait(By.css('[data-testid="product-card"]'), 5000);await driver.wait(until.elementsLocated(By.css('[data-testid="product-card"]')), 5000);until.elementsLocated transformă locatorul într-o condiție pe care driver.wait o poate verifica repetat.
2Boolean calculat o singură dată
await driver.wait(await toast.isDisplayed(), 5000);await driver.wait(until.elementIsVisible(toast), 5000);Un boolean nu se mai schimbă. Condiția until verifică vizibilitatea la fiecare încercare.
3Condiție proprie
await driver.wait(carduri.length === 2, 5000);await driver.wait(async () => (await driver.findElements(By.css('[data-testid="product-card"]'))).length === 2, 5000);O funcție e chemată din nou la fiecare încercare și recitește lista.
Repară eroarea, direct în pagină
Testul Selenium catalogul are 8 produse dă lui driver.wait un locator în loc de condiție (în selenium-webdriver real: Wait condition must be a promise-like object, function, or a Condition object), deci nu așteaptă nimic și numără 0 carduri. Transformă locatorul într-o condiție until, apoi afișează numărul de carduri.
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('catalogul are 8 produse', async function () {
await driver.get('http://localhost:3000/#/catalog');
await driver.wait(By.css('[data-testid="product-card"]'), 5000);
const carduri = await driver.findElements(By.css('[data-testid="product-card"]'));
console.log(carduri.length);
assert.strictEqual(carduri.length, 8);
});
});Indiciu
By.css doar descrie căutarea; until o transformă în condiție.
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('catalogul are 8 produse', async function () {
await driver.get('http://localhost:3000/#/catalog');
await driver.wait(until.elementsLocated(By.css('[data-testid="product-card"]')), 5000);
const carduri = await driver.findElements(By.css('[data-testid="product-card"]'));
console.log(carduri.length);
assert.strictEqual(carduri.length, 8);
});
});De ce merge
driver.wait verifică repetat o condiție, iar By.css(...) nu e o condiție, ci doar descrierea unei căutări, așa că nu era nimic de așteptat. until.elementsLocated(By.css(...)) reîncearcă până găsește cel puțin un card; după aceea findElements întoarce toate cele 8 carduri afișate.
Alte forme ale mesajului
TypeError: Wait condition must be a promise-like object, function, or a Condition objectTypeError: Wait condition must be a promise-like object, function, or a Condition object at Driver.waitTypeError: Wait timeout must be a number
Cum o eviți pe viitor
- Primul argument al lui
driver.waitîncepe mereu cuuntil.sau e o funcție. - Nu pune
awaitîn interiorul argumentului (driver.wait(await ...)): calculezi valoarea o singură dată. - Pentru condiții repetate, scrie funcții ajutătoare (
asteaptaNumarCarduri(driver, 8)). - Pentru stări fără condiție gata făcută, scrie o funcție care întoarce
truecând starea e atinsă.
Întrebări frecvente
De ce în unele medii eroarea nu apare și testul pică mai târziu?
Dacă driver.wait nu așteaptă nimic, testul merge mai departe imediat, iar lista nu e încă încărcată: pică la linia următoare (zero elemente, NoSuchElementError). Cauza e tot condiția greșită.
Ce întoarce driver.wait?
Valoarea finală a condiției: until.elementLocated întoarce elementul, elementsLocated lista de elemente. Poți scrie const card = await driver.wait(until.elementLocated(...), 5000).
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. TypeError: Invalid locator findElement / findElements a primit un text simplu (de exemplu '#login') în loc de un locator By. Selenium nu ghicește tipul selectorului. Scrie driver.findElement(By.css('#login')), By.id('login'), By.xpath(...) etc. 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. Î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.
