...
Eroare Testare automată · Aserțiuni pe valori și teste unitare: toMatch, toThrow, toBeCloseTo

Matcher error: received value must be a function

Pe scurt

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ă: expect primește valoarea întoarsă (un număr, undefined), iar toThrow spune Matcher error: received value must be a function, cu Received has type: number și Received 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

Greșit
JavaScript
expect(cantitate(0)).toThrow('Cantitate invalidă');
Corect
JavaScript
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

Greșit
JavaScript
expect(cos.adauga({ id: 99 })).toThrow();
Corect
JavaScript
expect(() => cos.adauga({ id: 99 })).toThrow();

Cu argumente, apelul trebuie învelit; altfel se execută înainte de expect.

3Funcție async verificată cu toThrow

Greșit
JavaScript
expect(() => login('x', 'y')).toThrow();
Corect
JavaScript
await expect(login('x', 'y')).rejects.toThrow();

O funcție async nu aruncă sincron, ci întoarce o promisiune respinsă. rejects o așteaptă.

Repară tu

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.

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

Alte forme ale mesajului

  • Error: expect(received).toThrow() Matcher error: received value must be a function Received has type: number Received has value: 5
  • Error: expect(received).toThrow(expected) Matcher error: received value must be a function
  • Matcher 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

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