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

TypeError: Wait condition must be a promise-like object, function, or a Condition object

Pe scurt

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

Greșit
JavaScript
await driver.wait(By.css('[data-testid="product-card"]'), 5000);
Corect
JavaScript
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ă

Greșit
JavaScript
await driver.wait(await toast.isDisplayed(), 5000);
Corect
JavaScript
await driver.wait(until.elementIsVisible(toast), 5000);

Un boolean nu se mai schimbă. Condiția until verifică vizibilitatea la fiecare încercare.

3Condiție proprie

Greșit
JavaScript
await driver.wait(carduri.length === 2, 5000);
Corect
JavaScript
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ă tu

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.

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('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.

Alte forme ale mesajului

  • TypeError: Wait condition must be a promise-like object, function, or a Condition object
  • TypeError: Wait condition must be a promise-like object, function, or a Condition object at Driver.wait
  • TypeError: Wait timeout must be a number

Cum o eviți pe viitor

  • Primul argument al lui driver.wait începe mereu cu until. 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 true câ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

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