...
Eroare Testare automată · Acțiuni pe elemente: click, fill, check, selectOption, press

Error: locator.fill: value: expected string, got number

Pe scurt

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

Greșit
JavaScript
await page.getByTestId('cart-qty').fill(3);
Corect
JavaScript
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

Greșit
JavaScript
const date = { cantitate: 2 };
await page.getByLabel('Cantitate').fill(date.cantitate);
Corect
JavaScript
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)

Greșit
JavaScript
const user = { email: 'ana@shoprapid.ro', parola: 'Parola123!' };
await page.getByLabel('Parolă').fill(user.password);
Corect
JavaScript
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ă tu

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.

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

Alte forme ale mesajului

  • Error: locator.fill: value: expected string, got undefined
  • Error: page.fill: value: expected string, got number
  • Error: 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

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