Index: pkg/meta/CHANGELOG.md |
diff --git a/pkg/meta/CHANGELOG.md b/pkg/meta/CHANGELOG.md |
index b91da1c7795f71cba1db4c6f83eaaec0fa62ffae..51ed95fe5ff1f04f79435cbfc98f455a05328207 100644 |
--- a/pkg/meta/CHANGELOG.md |
+++ b/pkg/meta/CHANGELOG.md |
@@ -1,3 +1,26 @@ |
+## 1.1.0 |
+* Introduce `@alwaysThrows` to declare that a function always throws |
+ (SDK issue [17999](https://github.com/dart-lang/sdk/issues/17999)). This |
+ is first available in Dart SDK 1.25.0-dev.1.0. |
+ |
+ ```dart |
+ import 'package:meta/meta.dart'; |
+ |
+ // Without knowing that [failBigTime] always throws, it looks like this |
+ // function might return without returning a bool. |
+ bool fn(expected, actual) { |
+ if (expected != actual) |
+ failBigTime(expected, actual); |
+ else |
+ return True; |
+ } |
+ |
+ @alwaysThrows |
+ void failBigTime(expected, actual) { |
+ throw new StateError('Expected $expected, but was $actual.'); |
+ } |
+ ``` |
+ |
## 1.0.4 |
* Introduce `@virtual` to allow field overrides in strong mode |
(SDK issue [27384](https://github.com/dart-lang/sdk/issues/27384)). |