NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev · #41 most downloaded on pub.dev
Support for specifying test expectations via an extensible Matcher class. Also includes a number of built-in Matcher implementations for common cases.
Last release 5 months ago
27 Apr 2026
Ships fairly regularly
a new release about every 4 months
Nearly every release is documented
notes for 45 of 46 stable releases
Nothing withdrawn
no release was ever pulled
13 years old
51 releases · first in 2014
Allow exceptions from operator == to bubble up and fail the test instead of treating them as unequal objects.
operator == to bubble up and fail the test instead ofoperator == to bubble up and fail the test instead of
treating them as unequal objects.Improve speed of pretty printing for large collections.
One column per quarter.
Add isSorted and related matchers for iterables.
isSorted and related matchers for iterables.NaN to be equal to itself in equals.dynamic values.Move to dart-lang/test monorepo.
dart-lang/test monorepo.Expand bounds on test_api dependency to allow the next breaking release which will remove the cyclic dependency on this package.
test_api dependency to allow the next breaking release
which will remove the cyclic dependency on this package.Support latest version of package:test_api.
package:test_api.Add package:matcher/expect.dart library. Copies the implementation of expect and the asynchronous matchers from package:test.
package:matcher/expect.dart library. Copies the implementation of
expect and the asynchronous matchers from package:test.Deprecate isCyclicInitializationError and NullThrownError. These errors will be removed from the SDK. Update them to catch more general errors.
containsOnce matcher.isCyclicInitializationError and NullThrownError. These errors
will be removed from the SDK. Update them to catch more general errors.Make isCastError no longer depend on the deprecated CastError type.
isCastError no longer depend on the deprecated CastError type.TypeMatcher.having with useResult.Add a best practices section to readme.
repository field.Change many argument types from dynamic to Object?.
dynamic to Object?.stringContainsInOrder to account for repetitions and empty strings.
Stable release for null safety.
Update SDK constraints to >=2.12.0-0 <3.0.0 based on beta release guidelines.
>=2.12.0-0 <3.0.0 based on beta release
guidelines.Allow prerelease versions of the 2.12 sdk.
Allow 2.10 stable and 2.11.0 dev SDK versions.
Apis have been updated to express intent of the existing code and how it handled nulls.
Improve mismatch descriptions for deep matches. Previously, if the user tried to do a deep match where the expectation included a complex matcher (suc
Add a mismatch description to TypeMatcher.
TypeMatcher.Update minimum Dart SDK to 2.2.0.
2.2.0.isA as a replacement for instanceOf.Add isA() to create TypeMatcher instances in a more fluent way.
isA() to create TypeMatcher instances in a more fluent way.greaterThan now compares with the >
operator rather not < and not =. This could cause tests which relied on
this bug to start failing.- Add isCastError.
Made the name constructor parameter optional and marked it deprecated. It's redundant to the type parameter.
Many improvements to TypeMatcher
Can now be used directly as const TypeMatcher<MyType>().
Added a type parameter to specify the target Type.
name constructor parameter optional and marked it deprecated.
It's redundant to the type parameter.Migrated all isType matchers to TypeMatcher.
Added a having function that allows chained validations of specific
features of the target type.
/// Validates that the object is a [RangeError] with a message containing
/// the string 'details' and `start` and `end` properties that are `null`.
final _rangeMatcher = isRangeError
.having((e) => e.message, 'message', contains('details'))
.having((e) => e.start, 'start', isNull)
.having((e) => e.end, 'end', isNull);
Deprecated the isInstanceOf class. Use TypeMatcher instead.
Improved the output of Matcher instances that fail due to type errors.
Set max SDK version to <3.0.0, and adjusted other dependencies.
Fixed unorderedMatches in cases where the matchers may match more than one element and order of the elements doesn't line up with the order of the mat
Fixed unorderedMatches in cases where the matchers may match more than one
element and order of the elements doesn't line up with the order of the
matchers.
Add containsAll matcher for Iterables. This Matcher checks that all values/matchers in an expected iterable are satisfied by an element in the value without allowing the same value to satisfy multiple matchers.
Updated SDK version to 2.0.0-dev.17.0
Add containsAllInOrder matcher for Iterables
Produce a better error message when a CustomMatcher's feature throws.
CustomMatcher's feature throws.Fixed small documentation issues.
Fixed small documentation issues.
Fixed small issue in StringEqualsMatcher.
Update to support future Dart language changes.
Make predicate and pairwiseCompare generic methods to allow typed functions to be passed to them as arguments.
Make predicate and pairwiseCompare generic methods to allow typed
functions to be passed to them as arguments.
Make internal implementations take better advantage of type promotion to avoid dynamic call overhead.
Fixed SDK constraint to allow edge builds.
Removed the name parameter for isInstanceOf. This was previously deprecated, and is no longer necessary since all language implementations now support…
Moved a number of members to the
unittest package.
TestFailure, ErrorFormatter, expect, fail, and 'wrapAsync'.completes, completion, throws, and throwsA Matchers.Throws class.throws...Error Matchers.Removed FailureHandler, DefaultFailureHandler,
configureExpectFailureHandler, and getOrCreateExpectFailureHandler.
Now that expect is in the unittest package, these are no longer needed.
Removed the name parameter for isInstanceOf. This was previously
deprecated, and is no longer necessary since all language implementations now
support converting the type parameter to a string directly.
Fix test files to use test instead of unittest pkg.
test instead of unittest pkg.* Fix all strong-mode warnings.
Nothing published for this version
Remove the type checks in the isEmpty and isNotEmpty matchers and simply access the isEmpty respectively isNotEmpty fields. This allows them to work w
isEmpty and isNotEmpty matchers and simply
access the isEmpty respectively isNotEmpty fields. This allows them to
work with custom collections. See Issue
21792 and Issue
21562Correctly match and print Strings containing characters that must be represented as escape sequences.
Strings containing characters that must be
represented as escape sequences.Improve the formatting of strings that contain unprintable ASCII characters.
Fix the examples for equalsIgnoringWhitespace.
equalsIgnoringWhitespace.Deprecate the name parameter to isInstanceOf. All language implementations now support converting the type parameter to a string directly.
isInstanceOf. All language implementations
now support converting the type parameter to a string directly.* Fix all strong-mode warnings.
Fix a bug introduced in 0.11.4+5 in which operator matchers broke when taking lists of matchers.
Add a prints matcher that matches output a callback emits via print.
prints matcher that matches output a callback emits via print.* Add an isNotEmpty matcher.
isNotEmpty matcher.Added isNaN and isNotNaN matchers.
isNaN and isNotNaN matchers.* Removed deprecated matchers.
Compare sets order-independently when using equals().
equals().Get the tests passing when run on dart2js in minified mode.
Nothing published for this version
Matchers related to bad language use have been removed. These represent code structure that should rarely or never be validated in tests.
Matchers related to bad language use have been removed. These represent code structure that should rarely or never be validated in tests.
isAbstractClassInstantiationErrorthrowsAbstractClassInstantiationErrorisFallThroughErrorthrowsFallThroughErrorAdded types to a number of method arguments.
The structure of the library and test code has been updated.
Added types to a number of constants.
Removed @deprecated annotation on matchers due to Issue 19173
@deprecated annotation on matchers due to
Issue 19173Your coding agent can read these notes before it upgrades. Set up the MCP server →