Timeout 5000ms exceeded while waiting on the predicate
expect.poll a apelat funcția ta din nou și din nou timp de 5 secunde, dar valoarea întoarsă nu a trecut niciodată aserțiunea. Verifică întâi că funcția chiar întoarce valoarea (un return lipsă dă mereu undefined), apoi că operația nu durează mai mult decât timeout-ul.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
expect.poll(fn).toBe(x) apelează fn la intervale scurte și verifică rezultatul, până trece sau până expiră timpul (implicit 5 secunde). Când expiră, raportul arată ultima eroare a aserțiunii (de exemplu expect(received).toBe(expected) cu Expected: "Gata", Received: undefined) și, în call log, rândul Timeout 5000ms exceeded while waiting on the predicate.
Ce e la Received îți spune cauza. undefined aproape mereu înseamnă că funcția nu întoarce nimic: o funcție cu acolade async () => { await ... } fără return. O valoare reală, dar alta, înseamnă că starea chiar nu s-a schimbat sau că s-ar schimba mai târziu decât timeout-ul: atunci mărești timeout în al doilea argument al lui poll. Pentru texte și stări de elemente, aserțiunile pe locatori (toHaveText) sunt mai simple; poll e pentru valori din cod sau din API (un status, un număr din JSON).
De ce apare: cauzele frecvente
1Funcția nu întoarce valoarea
await expect.poll(async () => {
await page.getByTestId('export-status').textContent();
}).toBe('Gata');await expect.poll(async () => {
return await page.getByTestId('export-status').textContent();
}).toBe('Gata');Fără return, funcția întoarce undefined la fiecare apel, deci aserțiunea nu poate trece niciodată.
2Operația durează mai mult decât timeout-ul
await expect.poll(async () => (await request.get('/api/export/7')).status()).toBe(200);await expect.poll(async () => (await request.get('/api/export/7')).status(), {
timeout: 20000,
}).toBe(200);Dacă exportul e gata după 12 secunde, 5 secunde nu ajung. Timeout-ul se dă în al doilea argument al lui poll.
3Valoarea are alt tip sau alt format
await expect.poll(() => page.getByTestId('cart-count').textContent()).toBe(2);await expect.poll(async () => Number(await page.getByTestId('cart-count').textContent())).toBe(2);textContent întoarce text („2”), iar toBe compară strict cu numărul 2.
Repară eroarea, direct în pagină
Testul exportul ajunge la starea Gata pică după 5 secunde: expect.poll primește mereu undefined. Pagina scrie starea exportului în data-testid="export-status" și ajunge la Gata după aproximativ 2 secunde. Repară funcția dată lui poll ca să întoarcă textul stării, apoi afișează textul final.
import { test, expect } from '@playwright/test';
test('exportul ajunge la starea Gata', async ({ page }) => {
await page.goto('/');
await page.getByRole('button', { name: 'Exportă comenzile' }).click();
await expect.poll(async () => {
await page.getByTestId('export-status').textContent();
}).toBe('Gata');
});Indiciu
O funcție cu acolade întoarce ceva doar cu return.
Reparația
import { test, expect } from '@playwright/test';
test('exportul ajunge la starea Gata', async ({ page }) => {
await page.goto('/');
await page.getByRole('button', { name: 'Exportă comenzile' }).click();
await expect.poll(async () => {
return await page.getByTestId('export-status').textContent();
}).toBe('Gata');
console.log(await page.getByTestId('export-status').textContent());
});De ce merge
Funcția din expect.poll citea textul, dar nu îl întorcea: o funcție cu acolade fără return întoarce undefined. poll a primit undefined la fiecare încercare, iar după 5 secunde a raportat eșecul.
Cu return, fiecare apel întoarce starea curentă: În lucru... la început, Gata după 2 secunde, moment în care aserțiunea trece. Pentru un text dintr-un element, la fel de bine ar merge await expect(page.getByTestId('export-status')).toHaveText('Gata').
Alte forme ale mesajului
Error: expect(received).toBe(expected) // Object.is equality Call Log: - Timeout 5000ms exceeded while waiting on the predicateTimeout 10000ms exceeded while waiting on the predicateError: expect.poll.toBe() failed
Cum o eviți pe viitor
- Scrie funcțiile pentru
pollca expresii scurte (() => valoare) sau verifică că aureturn. - Afișează o dată valoarea întoarsă (
console.log(await fn())) când scrii testul. - Pentru elemente din pagină, preferă
await expect(locator).toHaveText(...);polle pentru valori din API sau din cod. - Pune
timeoutdoar pe pașii care chiar durează, cu un comentariu despre motiv.
Întrebări frecvente
Cât de des apelează poll funcția?
Implicit la 100, 250, 500 și apoi la 1000 ms. Poți schimba cu intervals: [1000] în al doilea argument, util când apelezi un API pe care nu vrei să-l încarci.
Care e diferența față de toPass()?
expect.poll repetă o funcție care întoarce o valoare și verifică valoarea. expect(async () => { ... }).toPass() repetă un bloc întreg cu mai multe aserțiuni, până trec toate.
Erori înrudite
Error: expect(received).toBe(expected) // Object.is equality Valoarea comparată cu toBe nu e identică cu cea așteptată. În testele Playwright cauza tipică e un await lipsă (Received: Promise {}) sau o valoare citită prea devreme cu textContent()/count(). Folosește aserțiunile pe locator, care așteaptă: await expect(locator).toHaveText('1'). 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ă. Error: expect(received).toBeTruthy() Valoarea verificată e falsă (false, 0, "", null sau undefined). În testele UI apare des la expect(await locator.isVisible()).toBeTruthy(): isVisible() citește o singură dată, înainte ca elementul să apară. Înlocuiește cu await expect(locator).toBeVisible(), care așteaptă. Î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.
