Error: locator.fill: value: expected string, got number
Ai dat lui fill() un număr, iar fill acceptă doar text (string). Scrie valoarea între ghilimele, fill('3'), sau convertește-o cu String(cantitate) înainte s-o trimiți.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
fill(value) simulează tastarea unui text într-un câmp, iar Playwright validează tipul argumentului înainte să facă orice în pagină. Mesajul se citește așa: locator.fill e metoda care a picat, value e parametrul cu problema, iar expected string, got number spune că aștepta un string și a primit un număr.
Eroarea apare imediat, fără să aștepte vreun timeout, deci nu are legătură cu pagina: locatorul poate fi perfect. Apare des la câmpurile numerice (cantitate, vârstă, cod poștal) și la datele de test ținute ca numere într-un obiect sau într-un fișier JSON ({ qty: 3 }). Linia marcată cu > în raport este apelul fill cu problema; urmărește de unde vine valoarea: o constantă, un parametru al testului sau un câmp din datele de test. Același mesaj îl primești pentru undefined (got undefined), când proprietatea citită din date nu există.
De ce apare: cauzele frecvente
1Număr scris direct în fill
await page.getByTestId('cart-qty').fill(3);await page.getByTestId('cart-qty').fill('3');Chiar dacă câmpul e de tip number, browserul primește text tastat. fill cere mereu un string.
2Valoare numerică din datele de test
const date = { cantitate: 2 };
await page.getByLabel('Cantitate').fill(date.cantitate);const date = { cantitate: 2 };
await page.getByLabel('Cantitate').fill(String(date.cantitate));Datele ținute ca numere (util pentru calcule) trebuie convertite la text exact în momentul în care le tastezi.
3Proprietate inexistentă (got undefined)
const user = { email: 'ana@shoprapid.ro', parola: 'Parola123!' };
await page.getByLabel('Parolă').fill(user.password);const user = { email: 'ana@shoprapid.ro', parola: 'Parola123!' };
await page.getByLabel('Parolă').fill(user.parola);user.password nu există, deci valoarea e undefined și mesajul devine expected string, got undefined. Numele cheii trebuie să fie același ca în obiect.
Repară eroarea, direct în pagină
Testul cantitatea 3 actualizează totalul liniei pică imediat cu locator.fill: value: expected string, got number. În coș există deja un Laptop UltraBook 14 (3.499,00 lei). Repară apelul fill ca testul să seteze cantitatea 3 și să verifice că totalul liniei devine 10.497,00 lei; testul afișează apoi valoarea câmpului.
import { test, expect } from '@playwright/test';
test('cantitatea 3 actualizează totalul liniei', async ({ page }) => {
const cantitate = 3;
await page.goto('/#/cos');
await page.getByTestId('cart-qty').fill(cantitate);
await expect(page.getByTestId('line-total')).toHaveText('10.497,00 lei');
});Indiciu
fill primește textul pe care l-ar tasta un om.
Reparația
import { test, expect } from '@playwright/test';
test('cantitatea 3 actualizează totalul liniei', async ({ page }) => {
const cantitate = 3;
await page.goto('/#/cos');
await page.getByTestId('cart-qty').fill(String(cantitate));
await expect(page.getByTestId('line-total')).toHaveText('10.497,00 lei');
console.log(await page.getByTestId('cart-qty').inputValue());
});De ce merge
fill(cantitate) primea numărul 3, iar Playwright refuză orice valoare care nu e string, înainte să atingă pagina. Cu fill(String(cantitate)), câmpul primește textul 3, aplicația recalculează linia pe evenimentul input, iar aserțiunea toHaveText('10.497,00 lei') trece.
Constanta poate rămâne număr (e utilă pentru calcule); conversia se face doar în momentul tastării. inputValue() întoarce și el text, de aceea testul afișează 3 fără ghilimele.
Alte forme ale mesajului
Error: locator.fill: value: expected string, got undefinedError: page.fill: value: expected string, got numberError: locator.pressSequentially: text: expected string, got number
Cum o eviți pe viitor
- Ține în datele de test valorile care se tastează ca text (
'3','0722123456'), iar cele pentru calcule ca numere separat. - Când valoarea vine dintr-un calcul, convertește-o explicit:
fill(String(total)). - Pentru
undefined, verifică numele cheii în obiectul de date; o greșeală de tastare la cheie dă exact acest mesaj. - Un editor cu TypeScript sau JSDoc îți subliniază tipul greșit înainte să rulezi testul.
Întrebări frecvente
Câmpul e type=number. De ce nu primește un număr?
Pentru că fill imită tastatura: utilizatorul scrie caractere, nu numere. Browserul transformă apoi textul în valoarea câmpului. De aceea Playwright cere string pentru orice tip de input.
De ce eroarea apare imediat și nu după 30 de secunde?
Validarea argumentelor se face înainte de orice așteptare. Playwright nu caută elementul cu un argument invalid, deci nu există nimic de așteptat.
Erori înrudite
Error: locator.fill: Error: Element is not an <input>, <textarea> or [contenteditable] element Ai apelat fill() pe un element în care nu se poate scrie, de exemplu pe div-ul care înconjoară câmpul, pe un paragraf sau pe un buton. Găsește chiar câmpul de text: getByLabel('Email'), getByRole('textbox', { name }) sau getByPlaceholder(). Error: locator.fill: Error: Input of type "checkbox" cannot be filled Ai folosit fill() pe o căsuță de bifat (sau pe un radio, buton, input de fișier). fill() e doar pentru câmpuri de text. Pentru checkbox și radio folosește check() / uncheck() / setChecked(), pentru butoane click(), iar pentru fișiere setInputFiles(). Error: locator.fill: Error: Malformed value Câmpul e de tip date, time, month sau color, iar textul dat lui fill() nu e în formatul standard al browserului. La date scrie AAAA-LL-ZZ (fill('2026-03-15')), la time HH:MM, la color #rrggbb, indiferent cum afișează pagina valoarea. Î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.
