[Dúvida] Função do `.toHaveBeenCalledWith()`

Oi, Felipe! Tudo bem?

Isso mesmo, a função .toHaveBeenCalledWith() do Jest é utilizada para validar se uma função espiada (spy) foi chamada com os parâmetros específicos que esperamos, ela não valida o retorno da função.

Vamos esclarecer com um exemplo prático:

const myFunction = jest.fn();

myFunction('param1', 'param2');

// Verifica se 'myFunction' foi chamada com os parâmetros 'param1' e 'param2'
expect(myFunction).toHaveBeenCalledWith('param1', 'param2');

Neste exemplo, estamos verificando se myFunction foi chamada com os parâmetros 'param1' e 'param2'. O Jest não está validando o retorno de myFunction, apenas os parâmetros com os quais ela foi chamada.

Portanto, de acordo com a explicação da aula, de fato o .toHaveBeenCalledWith() valida se os parâmetros informados para a função que está sendo espionada possuem aquele valor.

Espero ter ajudado!

Um forte abraço e bons estudos!