TypeError: page.getByRole(...).first.click is not a function
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
await page.getByRole('button', { name: 'Adaugă în coș' }).first.click();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
await page.getByTestId('product-card').nth.click();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
await expect(page.getByTestId('order-row').last).toHaveText(/1001/);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ă 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.
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ă.
Reparația
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());
});De ce merge
first fără paranteze era referința la metodă, nu un locator, iar o funcție nu are click. Cu first() primești un locator nou care țintește primul buton din cele 8 și pe care se poate da click.
Restul testului așteaptă numărul din antet (toHaveText('1')) și notificarea, care apar după răspunsul serverului.
Alte forme ale mesajului
TypeError: page.getByTestId(...).last.click is not a functionTypeError: page.locator(...).nth.fill is not a functionTypeError: page.getByRole(...).first.textContent is not a functionError: 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):firstfă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
TypeError: page.getByRol is not a function Ai apelat o metodă care nu există, de obicei din cauza unei greșeli de scriere: getByRol în loc de getByRole, getByLable, toHaveUrl. Corectează numele exact al metodei; literele mari contează, iar editorul cu autocomplete (VS Code) te ajută să le alegi corect. Error: locator.click: Error: strict mode violation: getByRole('button', { name: 'Adaugă în coș' }) resolved to 8 elements Locatorul pe care faci click găsește mai multe elemente, iar Playwright refuză să ghicească pe care să-l apese. Fă locatorul unic: restrânge căutarea la containerul potrivit (cardul produsului, cu filter({ hasText })), folosește un nume accesibil unic sau un data-testid. TypeError: page.getByTestId(...).all is not a function or its return value is not iterable locator.all() întoarce o promisiune, iar for...of nu poate parcurge o promisiune. Scrie for (const card of await page.getByTestId('product-card').all()). Și așteaptă întâi lista să se încarce, fiindcă all() nu 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.
