Primul locator pe o pagină simplă
Ca să verifici sau să folosești un element (un titlu, un buton, un câmp), trebuie mai întâi să-l găsești. Pentru asta Playwright folosește locatori. Începem pe o pagină foarte mică, ca să vezi clar cum funcționează, apoi revenim la ShopRapid.
Pagina din această lecție
În lecțiile 8–11 laboratorul nu afișează ShopRapid, ci o pagină mică scrisă special pentru exercițiu. Codul ei HTML este acesta:
<title>Salut</title> <h1>Salut, lume!</h1> <p>Aceasta este prima pagină pe care o testăm.</p> <p>Mai jos vor apărea butoane și formulare.</p>
Pagina se deschide tot cu page.goto('/'). Titlul ei (din <title>) este „Salut”.
Pe pagina din lecție, scrie testul titlul se vede: deschide pagina cu page.goto('/'), verifică cu getByText și toBeVisible că textul Salut, lume! se vede, apoi afișează textul elementului cu console.log(await page.getByText('Salut, lume!').textContent()).
- Deschide pagina cu page.goto('/').
- Verifică cu toBeVisible() locatorul page.getByText('Salut, lume!').
- Afișează textul elementului cu textContent().
Soluția exercițiului
import { test, expect } from '@playwright/test';
test('titlul se vede', async ({ page }) => {
await page.goto('/');
await expect(page.getByText('Salut, lume!')).toBeVisible();
console.log(await page.getByText('Salut, lume!').textContent());
}); Vrei să afli mai mult?Ce este un locator · getByText și toBeVisible · Citești textul unui element · Greșeli frecvente · Rezumat
Ce este un locator
Un locator este o „rețetă” prin care Playwright găsește un element: de exemplu „elementul care conține textul *Salut, lume!*”. Locatorul nu caută elementul în momentul în care îl creezi, ci de fiecare dată când îl folosești (într-o verificare sau o acțiune).
const titlu = page.getByText('Salut, lume!'); // doar rețeta, nicio căutare încă
await expect(titlu).toBeVisible(); // acum se caută elementul
Paginile moderne se schimbă continuu: apar mesaje, se încarcă liste. Pentru că locatorul caută din nou la fiecare folosire, găsește mereu varianta actuală a elementului.
getByText și toBeVisible
page.getByText('text') găsește elementul care conține textul dat. toBeVisible() verifică faptul că elementul există și se vede pe pagină.
import { test, expect } from '@playwright/test';
test('paragraful se vede', async ({ page }) => {
await page.goto('/');
await expect(page.getByText('Aceasta este prima pagină pe care o testăm.')).toBeVisible();
await expect(page).toHaveTitle('Salut');
});
Running 1 test using 1 worker ✓ 1 exemplu.spec.js › paragraful se vede 1 passed
Dacă textul nu există pe pagină, toBeVisible reîncearcă 5 secunde, apoi testul pică cu mesajul element(s) not found (niciun element găsit).
Citești textul unui element
Un locator nu servește doar la verificări. await locator.textContent() întoarce textul elementului, pe care îl poți afișa sau folosi mai departe:
import { test, expect } from '@playwright/test';
test('citesc paragraful', async ({ page }) => {
await page.goto('/');
const paragraf = page.getByText('Mai jos vor apărea');
console.log(await paragraf.textContent());
});
Running 1 test using 1 worker Mai jos vor apărea butoane și formulare. ✓ 1 exemplu.spec.js › citesc paragraful 1 passed
Observă: am căutat doar o parte din text („Mai jos vor apărea”), dar textContent() a întors tot textul paragrafului. getByText caută implicit un subșir, fără să țină cont de literele mari și mici.
Greșeli frecvente
- Uiți await la textContent(): în loc de text, se afișează Promise { <pending> }.
- Scrii textul cu altă punctuație („Salut lume”): virgula lipsă face ca textul să nu mai fie găsit.
- Un text prea scurt (de exemplu „Salut”) se potrivește cu mai multe elemente; vei vedea în lecțiile următoare cum rezolvi asta.
Rezumat
- Un locator este o rețetă de găsire a unui element, folosită din nou la fiecare acțiune sau verificare.
- page.getByText('...') găsește un element după text (subșir, fără majuscule).
- await expect(locator).toBeVisible() verifică faptul că elementul se vede.
- await locator.textContent() citește textul elementului.
