What is difference between argThat and captureThat matchers in dart mockito?

Question

I've tried to find the difference here https://pub.dev/packages/mockito and using documentation to this matchers but didn't get it. Could someone provide example where I supposed to use captureThat rather than argThat?

Answer 1

The documentation for argThat states:

An argument matcher that matches an argument that matches matcher.

The documentation for captureThat states:

An argument matcher that matches an argument that matches matcher, and captures the argument for later access with captured.

Therefore the difference is that captureThat captures the matched argument for later examination whereas argThat does not.

See Capturing arguments for further assertions from the Mockito documentation for examples for how to use captured arguments.