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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
TypeError: X is not a function e o eroare JavaScript, nu una specifică Playwright: ai apelat page.getByRol(...), dar obiectul page nu are nicio proprietate cu numele ăsta, deci valoarea e undefined, iar undefined nu poate fi apelat ca funcție.
Mesajul îți spune exact ce nume ai scris (page.getByRol), iar linia marcată în raport e locul apelului. Testul pică imediat, fără să aștepte nimic.
Același mesaj apare pentru aserțiuni: expect(...).toHaveUrl is not a function (corect: toHaveURL), toBeVisable, toHaveTitel. Alteori metoda există, dar pe alt obiect: page.fill() merge, însă page.getByLabel('Email').type() e o metodă scoasă din API-urile noi, iar expect(page).toHaveText() nu are sens, pentru că toHaveText e pentru locatori.
De ce apare: cauzele frecvente
1Greșeală de scriere în numele metodei
await page.getByRol('link', { name: 'Catalog' }).click();await page.getByRole('link', { name: 'Catalog', exact: true }).click();Metoda se numește getByRole. Cu getByRol, page nu are o astfel de funcție.
2Litere mari greșite în aserțiune
await expect(page).toHaveUrl('/#/catalog');await expect(page).toHaveURL('/#/catalog');JavaScript face diferența între litere mari și mici: toHaveURL e scris cu URL majuscule.
3Metoda e apelată pe obiectul greșit
const produse = page.getByTestId('product-card');
await produse.goto('/#/catalog');await page.goto('/#/catalog');
const produse = page.getByTestId('product-card');goto e o metodă a paginii, nu a locatorului.
Repară eroarea, direct în pagină
Testul meniul duce la catalog pică imediat cu TypeError: page.getByRol is not a function. Repară apelul ca testul să apese linkul Catalog din meniul principal al ShopRapid și să verifice titlul paginii, Catalog | ShopRapid.
import { test, expect } from '@playwright/test';
test('meniul duce la catalog', async ({ page }) => {
await page.goto('/');
await page.getByRol('link', { name: 'Catalog' }).click();
await expect(page).toHaveTitle('Catalog | ShopRapid');
});Indiciu
Citește numele metodei din mesaj literă cu literă.
Reparația
import { test, expect } from '@playwright/test';
test('meniul duce la catalog', async ({ page }) => {
await page.goto('/');
await page.getByRole('link', { name: 'Catalog', exact: true }).click();
await expect(page).toHaveTitle('Catalog | ShopRapid');
});De ce merge
page.getByRol nu există, deci valoarea e undefined, iar apelul ei aruncă TypeError. Metoda corectă e page.getByRole('link', { name: 'Catalog' }).
exact: true e util aici: pe pagina principală există și linkul „Vezi catalogul”, iar fără exact numele „Catalog” s-ar potrivi cu amândouă (strict mode violation). După click, toHaveTitle așteaptă titlul paginii de catalog.
Alte forme ale mesajului
TypeError: expect(...).toHaveUrl is not a functionTypeError: page.getByLable is not a functionTypeError: locator.toBeVisible is not a functionTypeError: page.getByTestID is not a function
Cum o eviți pe viitor
Scrie testele într-un editor care cunoaște tipurile Playwright (VS Code cu extensia Playwright Test): autocomplete-ul îți propune numele corecte și subliniază metodele inexistente. Ține minte câteva convenții: getBy... pentru locatori, toHave... / toBe... pentru aserțiuni, iar URL, ID și JSON apar cu majuscule (toHaveURL, getByTestId). La un is not a function, citește exact numele din mesaj, literă cu literă.
Întrebări frecvente
De ce nu am primit eroarea la scriere, ci abia la rulare?
JavaScript nu verifică numele metodelor înainte de rulare. Cu TypeScript sau cu verificarea tipurilor din VS Code (// @ts-check), greșeala e subliniată din editor.
Am scris corect, dar tot primesc eroarea. Ce verific?
Verifică pe ce obiect apelezi metoda: toHaveText merge pe expect(locator), nu pe expect(page), iar metodele unui locator nu există pe rezultatul lui await locator.textContent(), care e doar un text.
Erori înrudite
ReferenceError: page is not defined Folosești variabila page într-un test (sau hook) care nu a cerut-o. page e un fixture: îl primești scriindu-l între acolade în parametrii funcției, async ({ page }) => { ... }. La fel pentru request, context sau browser. Test timeout of 30000ms exceeded. Testul a depășit timpul maxim (implicit 30 de secunde) pentru că a așteptat ceva ce nu s-a întâmplat: de obicei un element pe care locatorul nu îl găsește. Citește call log-ul de sub mesaj, vezi ce locator aștepta și corectează-l după rolul și textul real din pagină. 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. Î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.
