...
Eroare Testare automată · Locatori: strict mode și selectori greșiți

TypeError: page.getByRole(...).first.click is not a function

Pe scurt

first, last și nth sunt metode, nu proprietăți: lipsesc parantezele. Scrie page.getByRole(...).first().click(). Fără paranteze, first e chiar funcția, iar o funcție nu are metoda click.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Mesajul vine din JavaScript, nu din Playwright: page.getByRole(...).first e o referință la metoda first, iar .click pe o funcție dă undefined. Apelul undefined() produce TypeError: ... .first.click is not a function. Partea (...) din mesaj e felul în care Node scurtează apelurile din lanț.

La fel se întâmplă cu .last.click, .nth.fill sau cu orice metodă a locatorului scrisă fără paranteze (.first.textContent). Unele biblioteci de testare au proprietăți cu nume asemănătoare, de aici confuzia. Cadrul de cod din raport arată exact linia; caută în ea un nume de metodă urmat de punct în loc de (. Eroarea e imediată și nu are legătură cu pagina: locatorul nici n-a fost folosit.

De ce apare: cauzele frecvente

1first fără paranteze

Greșit
JavaScript
await page.getByRole('button', { name: 'Adaugă în coș' }).first.click();
Corect
JavaScript
await page.getByRole('button', { name: 'Adaugă în coș' }).first().click();

first() întoarce un locator nou, care are click. first fără paranteze e funcția însăși.

2nth fără argument

Greșit
JavaScript
await page.getByTestId('product-card').nth.click();
Corect
JavaScript
await page.getByTestId('product-card').nth(2).click();

nth(index) primește poziția (de la 0). Fără apel, nu există locator pe care să dai click.

3last folosit ca proprietate în aserțiune

Greșit
JavaScript
await expect(page.getByTestId('order-row').last).toHaveText(/1001/);
Corect
JavaScript
await expect(page.getByTestId('order-row').last()).toHaveText(/1001/);

expect primește o funcție în loc de locator și nu poate face aserțiunea. Cu paranteze primește locatorul.

Repară tu

Repară eroarea, direct în pagină

Testul adaugă primul laptop pică cu TypeError: page.getByRole(...).first.click is not a function. Repară apelul ca testul să apese primul buton „Adaugă în coș” din catalog, să verifice că numărul din coș (cart-count) devine 1 și să afișeze notificarea.

Codul care dă eroarea
JavaScript
import { test, expect } from '@playwright/test';

test('adaugă primul laptop', async ({ page }) => {
  await page.goto('/#/catalog');
  await page.getByRole('button', { name: 'Adaugă în coș' }).first.click();
  await expect(page.getByTestId('cart-count')).toHaveText('1');
  console.log(await page.getByRole('status').textContent());
});
Indiciu

first este o metodă.

Alte forme ale mesajului

  • TypeError: page.getByTestId(...).last.click is not a function
  • TypeError: page.locator(...).nth.fill is not a function
  • TypeError: page.getByRole(...).first.textContent is not a function
  • Error: toHaveText can be only used with Locator object

Cum o eviți pe viitor

  • Ține minte regula: în Playwright, tot ce face ceva pe un locator e metodă (first(), last(), nth(i), filter({...})).
  • Folosește un editor cu tipuri (VS Code cu @playwright/test): first fără paranteze apare subliniat.
  • Rulează des testul cu --ui: eroarea apare la prima rulare.

Întrebări frecvente

De ce mesajul conține „(...)”?

Node scurtează argumentele apelurilor din lanț, ca mesajul să rămână citibil. page.getByRole(...) înseamnă apelul tău cu toate argumentele.

E aceeași problemă ca „is not a function” la getByRol?

Asemănătoare, dar acolo numele metodei e scris greșit. Aici numele e corect, lipsesc doar parantezele.

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.