TypeError: page.getByTestId(...).textContent(...).trim is not a function
textContent() întoarce o promisiune, nu textul, iar o promisiune nu are trim, replace sau split. Pune await și paranteze: (await page.getByTestId('product-title').textContent()).trim(). Sau, mai bine, verifică textul direct cu await expect(locator).toHaveText(...).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Toate metodele locatorului care citesc ceva din pagină (textContent, innerText, inputValue, getAttribute, count) sunt asincrone: întorc un Promise, care se rezolvă abia după ce Playwright găsește elementul. Dacă apelezi direct o metodă de text pe rezultat, o apelezi pe promisiune, iar Promise nu are trim, deci primești TypeError: ... .textContent(...).trim is not a function.
La fel apar .replace is not a function, .split is not a function, .includes is not a function sau Cannot read properties of undefined (reading 'length'). Reparația are două părți: await și paranteze în jurul lui, fiindcă await loc.textContent().trim() aplică tot trim pe promisiune, înainte de await. Dacă scopul e doar o verificare, o aserțiune web-first (toHaveText, care normalizează spațiile) e mai scurtă și așteaptă singură.
De ce apare: cauzele frecvente
1Lipsește await
const titlu = page.getByTestId('product-title').textContent().trim();const titlu = (await page.getByTestId('product-title').textContent()).trim();await scoate textul din promisiune, iar parantezele fac ca trim să se aplice textului.
2await fără paranteze
const pret = await page.getByTestId('product-price').textContent().replace(' lei', '');const pret = (await page.getByTestId('product-price').textContent()).replace(' lei', '');Fără paranteze, replace se aplică promisiunii, înainte ca await să aștepte ceva.
3Citire doar pentru a verifica
const t = (await page.getByTestId('product-title').textContent()).trim();
expect(t).toBe('Laptop UltraBook 14');await expect(page.getByTestId('product-title')).toHaveText('Laptop UltraBook 14');toHaveText normalizează spațiile și reîncearcă, deci nu ai nevoie de trim.
Repară eroarea, direct în pagină
Testul titlul produsului fără spații pică cu TypeError: ... .textContent(...).trim is not a function. Testul citește titlul din pagina produsului 1 (product-title), îl curăță de spații și îl afișează cu majuscule. Repară citirea, apoi afișează LAPTOP ULTRABOOK 14.
import { test, expect } from '@playwright/test';
test('titlul produsului fără spații', async ({ page }) => {
await page.goto('/#/produs/1');
const titlu = page.getByTestId('product-title').textContent().trim();
console.log(titlu.toUpperCase());
});Indiciu
textContent() întoarce o promisiune.
Reparația
import { test, expect } from '@playwright/test';
test('titlul produsului fără spații', async ({ page }) => {
await page.goto('/#/produs/1');
const titlu = (await page.getByTestId('product-title').textContent()).trim();
console.log(titlu.toUpperCase());
});De ce merge
textContent() întoarce o promisiune; trim se aplica ei, nu textului. (await ...textContent()).trim() așteaptă întâi textul (Playwright găsește elementul și îl citește), iar apoi trim și toUpperCase lucrează pe un șir obișnuit. Parantezele sunt esențiale: await se aplică întregului apel, iar abia apoi metodele de text lucrează pe rezultat. Dacă vrei doar să verifici titlul, toHaveText e și mai simplu.
Alte forme ale mesajului
TypeError: page.getByTestId(...).textContent(...).replace is not a functionTypeError: page.locator(...).innerText(...).split is not a functionTypeError: page.getByLabel(...).inputValue(...).includes is not a functionTypeError: titlu.trim is not a function
Cum o eviți pe viitor
- Când un rezultat al Playwright trebuie prelucrat, scrie mereu
(await ...)cu paranteze. - Activează regula ESLint
@typescript-eslint/no-floating-promisessauplaywright/missing-playwright-await: prinde await-urile lipsă. - Pentru verificări, preferă aserțiunile pe locator în locul citirilor și comparațiilor manuale.
- Citește mesajele „X(...).metoda is not a function” ca pe un semn de await lipsă.
Întrebări frecvente
De ce mesajul nu spune clar „ai uitat await”?
Fiindcă vine din JavaScript: vede doar că obiectul (o promisiune) nu are metoda trim. Un mesaj „X(...).metoda is not a function” după o metodă Playwright înseamnă aproape mereu un await lipsă.
Pot scrie await la final: await loc.textContent().trim()?
Nu: ordinea e loc.textContent(), apoi .trim() pe promisiune (eroare), apoi await. Parantezele schimbă ordinea.
Erori înrudite
SyntaxError: await is only valid in async functions and the top level bodies of modules Ai folosit await într-o funcție care nu e marcată async: de obicei callback-ul lui test, beforeEach sau o metodă din Page Object. Adaugă async în fața funcției: test('...', async ({ page }) => { ... }). Error: expect(received).toBe(expected) // Object.is equality Valoarea comparată cu toBe nu e identică cu cea așteptată. În testele Playwright cauza tipică e un await lipsă (Received: Promise {}) sau o valoare citită prea devreme cu textContent()/count(). Folosește aserțiunile pe locator, care așteaptă: await expect(locator).toHaveText('1'). 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.
