...
Eroare Testare automată · Aserțiuni expect care pică

Error: expect(locator).toBeInViewport() failed

Pe scurt

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

Greșit
JavaScript
await expect(page.getByRole('navigation', { name: 'Meniu mobil' })).toBeInViewport();
Corect
JavaScript
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

Greșit
JavaScript
await expect(page.locator('#recenzii')).toBeInViewport();
Corect
JavaScript
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

Greșit
JavaScript
await expect(page.getByTestId('footer-contact')).toBeInViewport();
Corect
JavaScript
await expect(page.getByTestId('footer-contact')).toBeVisible();

Dacă testul vrea doar să știe că elementul există și se vede, toBeVisible e verificarea corectă.

Repară tu

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.

Codul care dă eroarea
JavaScript
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?

Alte forme ale mesajului

  • Error: Timed out 5000ms waiting for expect(locator).toBeInViewport()
  • Error: expect(locator).not.toBeInViewport() failed
  • Error: expect(locator).toBeInViewport() failed Expected: in viewport Received: outside viewport

Cum o eviți pe viitor

  • Folosește toBeInViewport doar când poziția pe ecran e chiar comportamentul testat (ancore, meniuri, scroll).
  • Pentru restul, toBeVisible e 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

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