Error: expect(locator).toBeInViewport() failed
Elementul nu se află în zona vizibilă a ferestrei: e ascuns, e mutat în afara ecranului (un meniu lateral închis, translateX(-100%)) sau e mai jos în pagină și nu s-a făcut scroll. Fă pasul care îl aduce pe ecran (deschide meniul, apasă linkul de ancoră) sau verifică toBeVisible dacă poziția nu contează.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
toBeInViewport() verifică dacă elementul se intersectează cu viewport-ul, adică dacă o parte din el chiar e pe ecran în acel moment (cu { ratio: 0.5 } ceri cel puțin jumătate). E diferit de toBeVisible(): un element vizibil poate fi în afara ecranului, iar unul ascuns nu e niciodată în viewport. Raportul arată Expected: in viewport și Received: outside viewport.
Cazuri tipice: un meniu lateral (drawer) închis prin transform: translateX(-100%) sau hidden; o secțiune la care ar trebui să ajungi cu un link de ancoră (#recenzii) sau cu „Înapoi sus”; un element într-un carusel, pe alt slide. Testul trebuie să facă acțiunea care aduce elementul pe ecran. Atenție: acțiunile Playwright (click, fill) fac singure scroll până la element, deci toBeInViewport are sens doar când chiar testezi poziția (ancore, scroll infinit, meniuri).
De ce apare: cauzele frecvente
1Meniul lateral nu a fost deschis
await expect(page.getByRole('navigation', { name: 'Meniu mobil' })).toBeInViewport();await page.getByRole('button', { name: 'Meniu' }).click();
await expect(page.getByRole('navigation', { name: 'Meniu mobil' })).toBeInViewport();Meniul închis stă în afara ecranului. Butonul „Meniu” îl aduce în viewport.
2Linkul de ancoră nu a fost apăsat
await expect(page.locator('#recenzii')).toBeInViewport();await page.getByRole('link', { name: 'Vezi recenziile' }).click();
await expect(page.locator('#recenzii')).toBeInViewport();Secțiunea e mai jos în pagină; linkul de ancoră face scroll până la ea.
3Poziția nu contează, doar vizibilitatea
await expect(page.getByTestId('footer-contact')).toBeInViewport();await expect(page.getByTestId('footer-contact')).toBeVisible();Dacă testul vrea doar să știe că elementul există și se vede, toBeVisible e verificarea corectă.
Repară eroarea, direct în pagină
Testul meniul mobil se deschide pică cu expect(locator).toBeInViewport() failed. Meniul lateral (role=navigation, aria-label="Meniu mobil") e închis la încărcarea paginii și se deschide cu butonul „Meniu”. Repară testul ca să deschidă meniul, să verifice că e pe ecran, apoi să afișeze câte linkuri are.
import { test, expect } from '@playwright/test';
test('meniul mobil se deschide', async ({ page }) => {
await page.goto('/');
const meniu = page.getByRole('navigation', { name: 'Meniu mobil' });
await expect(meniu).toBeInViewport();
console.log(await meniu.getByRole('link').count());
});Indiciu
Ce face utilizatorul ca să vadă meniul?
Reparația
import { test, expect } from '@playwright/test';
test('meniul mobil se deschide', async ({ page }) => {
await page.goto('/');
const meniu = page.getByRole('navigation', { name: 'Meniu mobil' });
await page.getByRole('button', { name: 'Meniu' }).click();
await expect(meniu).toBeInViewport();
console.log(await meniu.getByRole('link').count());
});De ce merge
Meniul lateral e închis când se încarcă pagina, deci nu e pe ecran, iar aserțiunea a primit outside viewport timp de 5 secunde. După click pe „Meniu”, scriptul îl deschide, iar toBeInViewport trece. În aplicațiile reale meniul e de obicei mutat în afara ecranului cu transform; aserțiunea arată exact asta, lucru pe care toBeVisible nu l-ar prinde.
Alte forme ale mesajului
Error: Timed out 5000ms waiting for expect(locator).toBeInViewport()Error: expect(locator).not.toBeInViewport() failedError: expect(locator).toBeInViewport() failed Expected: in viewport Received: outside viewport
Cum o eviți pe viitor
- Folosește
toBeInViewportdoar când poziția pe ecran e chiar comportamentul testat (ancore, meniuri, scroll). - Pentru restul,
toBeVisiblee suficient: acțiunile fac scroll automat. - Testează meniurile mobile cu un viewport mic (
test.use({ viewport: { width: 390, height: 844 } })), unde chiar se comportă diferit.
Întrebări frecvente
De ce toBeVisible trece, iar toBeInViewport pică?
Fiindcă un element poate fi vizibil (are dimensiune, nu e display:none) și totuși în afara ecranului, de exemplu mutat cu transform sau mai jos în pagină.
Trebuie să fac scroll înainte de click?
Nu. click, fill, hover fac scroll singure până la element. Scroll manual (scrollIntoViewIfNeeded) e nevoie doar înaintea verificărilor de poziție.
Erori înrudite
Error: expect(locator).toBeVisible() failed Elementul nu a devenit vizibil în timpul aserțiunii (implicit 5 secunde): nu există, e ascuns sau apare mai târziu. Citește Received: <element(s) not found> înseamnă locator greșit, hidden înseamnă element ascuns; dacă aplicația e doar lentă, mărește timeout-ul doar pentru această aserțiune. Error: expect(locator).toBeHidden() failed Elementul a rămas vizibil toate cele 5 secunde de așteptare: indicatorul de încărcare nu a dispărut la timp, fereastra nu s-a închis sau locatorul găsește alt element vizibil. Verifică ce îl ascunde și, dacă e doar lent, mărește timeout-ul doar pentru acea aserțiune. element is not visible Locatorul a găsit elementul, dar acesta e ascuns (hidden, display: none, într-un meniu închis), iar Playwright nu apasă elemente pe care utilizatorul nu le vede. Fă întâi pasul care îl afișează (hover pe meniu, click pe un tab, deschiderea unui dialog) sau corectează locatorul, dacă a găsit o copie ascunsă. Î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.
