diff --git a/lib/src/error_matchers.dart b/lib/src/error_matchers.dart
index 5116975..65321ad 100644
--- a/lib/src/error_matchers.dart
+++ b/lib/src/error_matchers.dart
@@ -8,6 +8,9 @@
 const isArgumentError = TypeMatcher<ArgumentError>();
 
 /// A matcher for [CastError].
+@Deprecated('CastError has been deprecated in favor of TypeError. '
+    'Use `isA<TypeError>()` or, if you need compatibility with older SDKs, '
+    'use `isA<CastError>()` and ignore the deprecation.')
 const isCastError = TypeMatcher<CastError>();
 
 /// A matcher for [ConcurrentModificationError].
diff --git a/test/type_matcher_test.dart b/test/type_matcher_test.dart
index 24c4401..f71b890 100644
--- a/test/type_matcher_test.dart
+++ b/test/type_matcher_test.dart
@@ -11,6 +11,7 @@
   _test(isMap, {}, name: 'Map');
   _test(isList, [], name: 'List');
   _test(isArgumentError, ArgumentError());
+  // ignore: deprecated_member_use, deprecated_member_use_from_same_package
   _test(isCastError, CastError());
   _test<Exception>(isException, const FormatException());
   _test(isFormatException, const FormatException());