Matcher error: received value must be a function
toThrow a primit rezultatul funcției, nu funcția: ai scris expect(f(0)).toThrow() în loc de expect(() => f(0)).toThrow(). Dacă f aruncă, eroarea iese chiar din linia ta și pică testul; dacă nu aruncă, expect primește o valoare și dă Matcher error. Învelește apelul într-o funcție săgeată.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
toThrow trebuie să cheme el funcția, ca să poată prinde eroarea. De aceea primește o funcție: expect(() => cantitate(0)).toThrow('Cantitate invalidă'). Când scrii expect(cantitate(0)), JavaScript apelează cantitate(0) înainte de expect. Două situații:
- funcția aruncă: eroarea iese direct din linia testului, iar raportul arată
Error: Cantitate invalidă, ca și cum codul ar avea un bug, deși e exact comportamentul pe care voiai să-l verifici; - funcția nu aruncă:
expectprimește valoarea întoarsă (un număr,undefined), iartoThrowspuneMatcher error: received value must be a function, cuReceived has type: numberșiReceived has value: 5.
La funcțiile async, regula e alta: le dai promisiunea și folosești rejects: await expect(trimite()).rejects.toThrow().
De ce apare: cauzele frecvente
1Apelul direct în expect
expect(cantitate(0)).toThrow('Cantitate invalidă');expect(() => cantitate(0)).toThrow('Cantitate invalidă');Funcția săgeată amână apelul, iar toThrow îl face și prinde eroarea.
2Metodă de obiect cu argumente
expect(cos.adauga({ id: 99 })).toThrow();expect(() => cos.adauga({ id: 99 })).toThrow();Cu argumente, apelul trebuie învelit; altfel se execută înainte de expect.
3Funcție async verificată cu toThrow
expect(() => login('x', 'y')).toThrow();await expect(login('x', 'y')).rejects.toThrow();O funcție async nu aruncă sincron, ci întoarce o promisiune respinsă. rejects o așteaptă.
Repară eroarea, direct în pagină
Testul unitar cantitatea 0 e respinsă verifică faptul că cantitate(0) aruncă Cantitate invalidă, dar apelează funcția direct în expect, deci eroarea iese din test necontrolată (iar la o valoare validă ar da Matcher error: received value must be a function). Repară verificarea și afișează respinsă la final.
import { test, expect } from '@playwright/test';
function cantitate(n) {
if (n < 1) throw new Error('Cantitate invalidă');
return n;
}
test('cantitatea 0 e respinsă', () => {
expect(cantitate(0)).toThrow('Cantitate invalidă');
console.log('respinsă');
});Indiciu
toThrow trebuie să primească o funcție pe care s-o cheme el.
Reparația
import { test, expect } from '@playwright/test';
function cantitate(n) {
if (n < 1) throw new Error('Cantitate invalidă');
return n;
}
test('cantitatea 0 e respinsă', () => {
expect(() => cantitate(0)).toThrow('Cantitate invalidă');
console.log('respinsă');
});De ce merge
expect(cantitate(0)) execută cantitate(0) înainte de expect, deci eroarea aruncată oprea testul și nimeni nu o putea compara cu mesajul așteptat. expect(() => cantitate(0)) dă lui toThrow o funcție; el o cheamă, prinde eroarea, verifică mesajul Cantitate invalidă, iar testul continuă și afișează respinsă.
Alte forme ale mesajului
Error: expect(received).toThrow() Matcher error: received value must be a function Received has type: number Received has value: 5Error: expect(received).toThrow(expected) Matcher error: received value must be a functionMatcher error: received value must be a promise or a function returning a promise
Cum o eviți pe viitor
- Când verifici o eroare, scrie mereu
expect(() => ...): funcția săgeată e partea obligatorie. - Pentru funcții async, folosește
await expect(promisiune).rejects.toThrow(...). - Verifică și mesajul (
toThrow('Cantitate invalidă')), nu doar faptul că aruncă: altfel trece și la o eroare din alt motiv.
Întrebări frecvente
Pot da funcția fără săgeată?
Da, dacă nu are argumente: expect(fn).toThrow(). Cu argumente, ai nevoie de săgeată (sau fn.bind(null, 0)), ca să nu o apelezi tu.
De ce testul pică cu eroarea pe care voiam s-o verific?
Fiindcă funcția a fost apelată în afara lui toThrow, deci eroarea n-a fost prinsă de nimeni și a oprit testul.
Erori înrudite
Error: expect(received).toThrow(expected) Funcția nu a aruncat eroarea așteptată: fie nu a aruncat deloc (Received function did not throw), fie a aruncat cu alt mesaj decât cel din toThrow('...'). Compară mesajul așteptat cu cel real și verifică că funcția e dată ca () => f(x), nu apelată direct. Error: expect(received).rejects.toThrow() Promisiunea s-a rezolvat normal, deși testul aștepta să fie respinsă (Received promise resolved instead of rejected). Cel mai des: request.get / fetch nu respinge la 404 sau 500, întoarce un răspuns. Verifică statusul răspunsului sau cere failOnStatusCode: true. AssertionError [ERR_ASSERTION]: Missing expected rejection. assert.rejects aștepta ca promisiunea să fie respinsă (o eroare), dar ea s-a rezolvat normal. Des: fetch nu aruncă eroare la 401 / 404 / 500, întoarce un răspuns. Verifică response.ok în funcție și aruncă tu eroarea, sau testează direct statusul. Î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.
