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

TypeError: page.getByRol is not a function

Pe scurt

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

Greșit
JavaScript
await page.getByRol('link', { name: 'Catalog' }).click();
Corect
JavaScript
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

Greșit
JavaScript
await expect(page).toHaveUrl('/#/catalog');
Corect
JavaScript
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

Greșit
JavaScript
const produse = page.getByTestId('product-card');
await produse.goto('/#/catalog');
Corect
JavaScript
await page.goto('/#/catalog');
const produse = page.getByTestId('product-card');

goto e o metodă a paginii, nu a locatorului.

Repară tu

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.

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

Alte forme ale mesajului

  • TypeError: expect(...).toHaveUrl is not a function
  • TypeError: page.getByLable is not a function
  • TypeError: locator.toBeVisible is not a function
  • TypeError: 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

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