|
1 | 1 | # Changelog
|
2 | 2 |
|
3 |
| -## [Unreleased] - TBD |
| 3 | +## [0.28.0] (2024-06-14) |
| 4 | + |
| 5 | +### New |
| 6 | + |
| 7 | +* ValueStream: |
| 8 | + * Add `lastEventOrNull` getter to `ValueStream`, |
| 9 | + which returns the last emitted event (either data/value or error event), or `null`. |
| 10 | + * Add `isLastEventValue`, `isLastEventError` and `errorAndStackTraceOrNull` |
| 11 | + extension getters to `ValueStream`, to check the kind of the last emitted event is data/value or error. |
| 12 | + * Update documentation. |
| 13 | + |
| 14 | +* ReplayStream: |
| 15 | + * Add `errorAndStackTraces` to `ReplayStream`, which returns a list of emitted `ErrorAndStackTrace`s. |
| 16 | + |
| 17 | +* Rename `Notification` and `Kind` to better reflect their purpose, |
| 18 | + and to avoid confusion with [Flutter's Notification class](https://api.flutter.dev/flutter/widgets/Notification-class.html). |
| 19 | + * Rename `Notification` to `StreamNotification` |
| 20 | + * `Notification.onData` to `StreamNotification.data`. |
| 21 | + * `Notification.onDone` to `StreamNotification.done`. |
| 22 | + * `Notification.onError` to `StreamNotification.error`. |
| 23 | + * Rename `Kind` to `NotificationKind` |
| 24 | + * `Kind.onData` to `NotificationKind.data`. |
| 25 | + * `Kind.onError` to `NotificationKind.error`. |
| 26 | + * `Kind.onDone` to `NotificationKind.done`. |
| 27 | + * Introduce `DataNotification`, `ErrorNotification` and `DoneNotification` as the subclasses of `StreamNotification`. |
| 28 | + * Convert `isOnData`, `isOnError`, `isOnDone`, `requireData` to extension getters on `StreamNotification`, |
| 29 | + they are now named `isData`, `isError`, `isDone` and `requireDataValue`. |
| 30 | + * Add extensions on `StreamNotification`: `dataValueOrNull`, `requireErrorAndStackTrace`, `errorAndStackTraceOrNull` getters and `when` method. |
| 31 | + |
| 32 | +### Changed |
| 33 | + |
| 34 | +* Accept Dart SDK versions above 3.0. |
| 35 | +* `switchMap`: when cancelling the previous inner subscription, |
| 36 | + `switchMap` will pause the outer subscription and and wait for the inner subscription to be completely canceled. |
| 37 | + It will then resume the outer subscription, and listen to the next inner Stream. |
| 38 | + Any errors from canceling the previous inner subscription will now be forwarded to the resulting Stream. |
| 39 | + |
| 40 | +* **Breaking**: Rename `ForkJoinStream.combine2`..`combine9` to `ForkJoinStream.join2`..`join9`. |
| 41 | +* **Breaking**: `Rx.using`/`UsingStream` |
| 42 | + * Convert all _required positional_ parameters to _required named_ parameters. |
| 43 | + * The `disposer` is now called after the future returned from `StreamSubscription.cancel` completes. |
| 44 | + |
| 45 | +### Documentation |
| 46 | + |
| 47 | +* Update and fix documentation. |
| 48 | +* Fix README example (thanks to [@wurikiji](https://github.com/wurikiji)). |
| 49 | +* Update Flutter example (thanks to [@hoangchungk53qx1](https://github.com/hoangchungk53qx1)). |
| 50 | +* Replace deprecated "dart pub run" with "dart run" (thanks to [@tatsuyafujisaki](https://github.com/tatsuyafujisaki)). |
4 | 51 |
|
5 | 52 | ## [0.28.0-dev.2] (2024-03-30)
|
6 | 53 |
|
@@ -721,7 +768,8 @@ for example: combineThreeLatest becomes combineLatest3
|
721 | 768 |
|
722 | 769 | * As of this version, rxdart depends on SDK v1.21.0, to support the newly added generic method type syntax
|
723 | 770 |
|
724 |
| -[Unreleased]: https://github.com/ReactiveX/rxdart/compare/0.28.0-dev.2...HEAD |
| 771 | +[Unreleased]: https://github.com/ReactiveX/rxdart/compare/0.28.0...HEAD |
| 772 | +[0.28.0]: https://github.com/ReactiveX/rxdart/releases/tag/0.28.0 |
725 | 773 | [0.28.0-dev.2]: https://github.com/ReactiveX/rxdart/releases/tag/0.28.0-dev.2
|
726 | 774 | [0.28.0-dev.1]: https://github.com/ReactiveX/rxdart/releases/tag/0.28.0-dev.1
|
727 | 775 | [0.28.0-dev.0]: https://github.com/ReactiveX/rxdart/releases/tag/0.28.0-dev.0
|
0 commit comments