// Copyright 2014 The Flutter Authors. All rights reserved. // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. import 'dart:async'; import 'package:flutter/widgets.dart'; import 'package:flutter_test/flutter_test.dart'; void main() { Widget snapshotText(BuildContext context, AsyncSnapshot snapshot) { return Text(snapshot.toString(), textDirection: TextDirection.ltr); } group('AsyncSnapshot', () { test('requiring data succeeds if data is present', () { expect( const AsyncSnapshot.withData(ConnectionState.done, 'hello').requireData, 'hello', ); }); test('requiring data fails if there is an error', () { expect( () => const AsyncSnapshot.withError(ConnectionState.done, 'error').requireData, throwsA(equals('error')), ); }); test('requiring data fails if snapshot has neither data nor error', () { expect( () => const AsyncSnapshot.nothing().requireData, throwsStateError, ); }); }); group('Async smoke tests', () { testWidgets('FutureBuilder', (WidgetTester tester) async { await tester.pumpWidget(FutureBuilder( future: Future.value('hello'), builder: snapshotText, )); await eventFiring(tester); }); testWidgets('StreamBuilder', (WidgetTester tester) async { await tester.pumpWidget(StreamBuilder( stream: Stream.fromIterable(['hello', 'world']), builder: snapshotText, )); await eventFiring(tester); }); testWidgets('StreamFold', (WidgetTester tester) async { await tester.pumpWidget(StringCollector( stream: Stream.fromIterable(['hello', 'world']) )); await eventFiring(tester); }); }); group('FutureBuilder', () { testWidgets('gracefully handles transition from null future', (WidgetTester tester) async { final GlobalKey key = GlobalKey(); await tester.pumpWidget(FutureBuilder( key: key, future: null, builder: snapshotText, )); expect(find.text('AsyncSnapshot(ConnectionState.none, null, null)'), findsOneWidget); final Completer completer = Completer(); await tester.pumpWidget(FutureBuilder( key: key, future: completer.future, builder: snapshotText, )); expect(find.text('AsyncSnapshot(ConnectionState.waiting, null, null)'), findsOneWidget); }); testWidgets('gracefully handles transition to null future', (WidgetTester tester) async { final GlobalKey key = GlobalKey(); final Completer completer = Completer(); await tester.pumpWidget(FutureBuilder( key: key, future: completer.future, builder: snapshotText, )); expect(find.text('AsyncSnapshot(ConnectionState.waiting, null, null)'), findsOneWidget); await tester.pumpWidget(FutureBuilder( key: key, future: null, builder: snapshotText, )); expect(find.text('AsyncSnapshot(ConnectionState.none, null, null)'), findsOneWidget); completer.complete('hello'); await eventFiring(tester); expect(find.text('AsyncSnapshot(ConnectionState.none, null, null)'), findsOneWidget); }); testWidgets('gracefully handles transition to other future', (WidgetTester tester) async { final GlobalKey key = GlobalKey(); final Completer completerA = Completer(); final Completer completerB = Completer(); await tester.pumpWidget(FutureBuilder( key: key, future: completerA.future, builder: snapshotText, )); expect(find.text('AsyncSnapshot(ConnectionState.waiting, null, null)'), findsOneWidget); await tester.pumpWidget(FutureBuilder( key: key, future: completerB.future, builder: snapshotText, )); expect(find.text('AsyncSnapshot(ConnectionState.waiting, null, null)'), findsOneWidget); completerB.complete('B'); completerA.complete('A'); await eventFiring(tester); expect(find.text('AsyncSnapshot(ConnectionState.done, B, null)'), findsOneWidget); }); testWidgets('tracks life-cycle of Future to success', (WidgetTester tester) async { final Completer completer = Completer(); await tester.pumpWidget(FutureBuilder( future: completer.future, builder: snapshotText, )); expect(find.text('AsyncSnapshot(ConnectionState.waiting, null, null)'), findsOneWidget); completer.complete('hello'); await eventFiring(tester); expect(find.text('AsyncSnapshot(ConnectionState.done, hello, null)'), findsOneWidget); }); testWidgets('tracks life-cycle of Future to error', (WidgetTester tester) async { final Completer completer = Completer(); await tester.pumpWidget(FutureBuilder( future: completer.future, builder: snapshotText, )); expect(find.text('AsyncSnapshot(ConnectionState.waiting, null, null)'), findsOneWidget); completer.completeError('bad'); await eventFiring(tester); expect(find.text('AsyncSnapshot(ConnectionState.done, null, bad)'), findsOneWidget); }); testWidgets('runs the builder using given initial data', (WidgetTester tester) async { final GlobalKey key = GlobalKey(); await tester.pumpWidget(FutureBuilder( key: key, future: null, builder: snapshotText, initialData: 'I', )); expect(find.text('AsyncSnapshot(ConnectionState.none, I, null)'), findsOneWidget); }); testWidgets('ignores initialData when reconfiguring', (WidgetTester tester) async { final GlobalKey key = GlobalKey(); await tester.pumpWidget(FutureBuilder( key: key, future: null, builder: snapshotText, initialData: 'I', )); expect(find.text('AsyncSnapshot(ConnectionState.none, I, null)'), findsOneWidget); final Completer completer = Completer(); await tester.pumpWidget(FutureBuilder( key: key, future: completer.future, builder: snapshotText, initialData: 'Ignored', )); expect(find.text('AsyncSnapshot(ConnectionState.waiting, I, null)'), findsOneWidget); }); }); group('StreamBuilder', () { testWidgets('gracefully handles transition from null stream', (WidgetTester tester) async { final GlobalKey key = GlobalKey(); await tester.pumpWidget(StreamBuilder( key: key, stream: null, builder: snapshotText, )); expect(find.text('AsyncSnapshot(ConnectionState.none, null, null)'), findsOneWidget); final StreamController controller = StreamController(); await tester.pumpWidget(StreamBuilder( key: key, stream: controller.stream, builder: snapshotText, )); expect(find.text('AsyncSnapshot(ConnectionState.waiting, null, null)'), findsOneWidget); }); testWidgets('gracefully handles transition to null stream', (WidgetTester tester) async { final GlobalKey key = GlobalKey(); final StreamController controller = StreamController(); await tester.pumpWidget(StreamBuilder( key: key, stream: controller.stream, builder: snapshotText, )); expect(find.text('AsyncSnapshot(ConnectionState.waiting, null, null)'), findsOneWidget); await tester.pumpWidget(StreamBuilder( key: key, stream: null, builder: snapshotText, )); expect(find.text('AsyncSnapshot(ConnectionState.none, null, null)'), findsOneWidget); }); testWidgets('gracefully handles transition to other stream', (WidgetTester tester) async { final GlobalKey key = GlobalKey(); final StreamController controllerA = StreamController(); final StreamController controllerB = StreamController(); await tester.pumpWidget(StreamBuilder( key: key, stream: controllerA.stream, builder: snapshotText, )); expect(find.text('AsyncSnapshot(ConnectionState.waiting, null, null)'), findsOneWidget); await tester.pumpWidget(StreamBuilder( key: key, stream: controllerB.stream, builder: snapshotText, )); controllerB.add('B'); controllerA.add('A'); await eventFiring(tester); expect(find.text('AsyncSnapshot(ConnectionState.active, B, null)'), findsOneWidget); }); testWidgets('tracks events and errors of stream until completion', (WidgetTester tester) async { final GlobalKey key = GlobalKey(); final StreamController controller = StreamController(); await tester.pumpWidget(StreamBuilder( key: key, stream: controller.stream, builder: snapshotText, )); expect(find.text('AsyncSnapshot(ConnectionState.waiting, null, null)'), findsOneWidget); controller.add('1'); controller.add('2'); await eventFiring(tester); expect(find.text('AsyncSnapshot(ConnectionState.active, 2, null)'), findsOneWidget); controller.add('3'); controller.addError('bad'); await eventFiring(tester); expect(find.text('AsyncSnapshot(ConnectionState.active, null, bad)'), findsOneWidget); controller.add('4'); controller.close(); await eventFiring(tester); expect(find.text('AsyncSnapshot(ConnectionState.done, 4, null)'), findsOneWidget); }); testWidgets('runs the builder using given initial data', (WidgetTester tester) async { final StreamController controller = StreamController(); await tester.pumpWidget(StreamBuilder( stream: controller.stream, builder: snapshotText, initialData: 'I', )); expect(find.text('AsyncSnapshot(ConnectionState.waiting, I, null)'), findsOneWidget); }); testWidgets('ignores initialData when reconfiguring', (WidgetTester tester) async { final GlobalKey key = GlobalKey(); await tester.pumpWidget(StreamBuilder( key: key, stream: null, builder: snapshotText, initialData: 'I', )); expect(find.text('AsyncSnapshot(ConnectionState.none, I, null)'), findsOneWidget); final StreamController controller = StreamController(); await tester.pumpWidget(StreamBuilder( key: key, stream: controller.stream, builder: snapshotText, initialData: 'Ignored', )); expect(find.text('AsyncSnapshot(ConnectionState.waiting, I, null)'), findsOneWidget); }); }); group('FutureBuilder and StreamBuilder behave identically on Stream from Future', () { testWidgets('when completing with data', (WidgetTester tester) async { final Completer completer = Completer(); await tester.pumpWidget(Column(children: [ FutureBuilder(future: completer.future, builder: snapshotText), StreamBuilder(stream: completer.future.asStream(), builder: snapshotText), ])); expect(find.text('AsyncSnapshot(ConnectionState.waiting, null, null)'), findsNWidgets(2)); completer.complete('hello'); await eventFiring(tester); expect(find.text('AsyncSnapshot(ConnectionState.done, hello, null)'), findsNWidgets(2)); }); testWidgets('when completing with error', (WidgetTester tester) async { final Completer completer = Completer(); await tester.pumpWidget(Column(children: [ FutureBuilder(future: completer.future, builder: snapshotText), StreamBuilder(stream: completer.future.asStream(), builder: snapshotText), ])); expect(find.text('AsyncSnapshot(ConnectionState.waiting, null, null)'), findsNWidgets(2)); completer.completeError('bad'); await eventFiring(tester); expect(find.text('AsyncSnapshot(ConnectionState.done, null, bad)'), findsNWidgets(2)); }); testWidgets('when Future is null', (WidgetTester tester) async { await tester.pumpWidget(Column(children: [ FutureBuilder(future: null, builder: snapshotText), StreamBuilder(stream: null, builder: snapshotText), ])); expect(find.text('AsyncSnapshot(ConnectionState.none, null, null)'), findsNWidgets(2)); }); testWidgets('when initialData is used with null Future and Stream', (WidgetTester tester) async { await tester.pumpWidget(Column(children: [ FutureBuilder(future: null, builder: snapshotText, initialData: 'I'), StreamBuilder(stream: null, builder: snapshotText, initialData: 'I'), ])); expect(find.text('AsyncSnapshot(ConnectionState.none, I, null)'), findsNWidgets(2)); }); testWidgets('when using initialData and completing with data', (WidgetTester tester) async { final Completer completer = Completer(); await tester.pumpWidget(Column(children: [ FutureBuilder(future: completer.future, builder: snapshotText, initialData: 'I'), StreamBuilder(stream: completer.future.asStream(), builder: snapshotText, initialData: 'I'), ])); expect(find.text('AsyncSnapshot(ConnectionState.waiting, I, null)'), findsNWidgets(2)); completer.complete('hello'); await eventFiring(tester); expect(find.text('AsyncSnapshot(ConnectionState.done, hello, null)'), findsNWidgets(2)); }); }); group('StreamBuilderBase', () { testWidgets('gracefully handles transition from null stream', (WidgetTester tester) async { final GlobalKey key = GlobalKey(); await tester.pumpWidget(StringCollector(key: key, stream: null)); expect(find.text(''), findsOneWidget); final StreamController controller = StreamController(); await tester.pumpWidget(StringCollector(key: key, stream: controller.stream)); expect(find.text('conn'), findsOneWidget); }); testWidgets('gracefully handles transition to null stream', (WidgetTester tester) async { final GlobalKey key = GlobalKey(); final StreamController controller = StreamController(); await tester.pumpWidget(StringCollector(key: key, stream: controller.stream)); expect(find.text('conn'), findsOneWidget); await tester.pumpWidget(StringCollector(key: key, stream: null)); expect(find.text('conn, disc'), findsOneWidget); }); testWidgets('gracefully handles transition to other stream', (WidgetTester tester) async { final GlobalKey key = GlobalKey(); final StreamController controllerA = StreamController(); final StreamController controllerB = StreamController(); await tester.pumpWidget(StringCollector(key: key, stream: controllerA.stream)); await tester.pumpWidget(StringCollector(key: key, stream: controllerB.stream)); controllerA.add('A'); controllerB.add('B'); await eventFiring(tester); expect(find.text('conn, disc, conn, data:B'), findsOneWidget); }); testWidgets('tracks events and errors until completion', (WidgetTester tester) async { final GlobalKey key = GlobalKey(); final StreamController controller = StreamController(); await tester.pumpWidget(StringCollector(key: key, stream: controller.stream)); controller.add('1'); controller.addError('bad'); controller.add('2'); controller.close(); await eventFiring(tester); expect(find.text('conn, data:1, error:bad, data:2, done'), findsOneWidget); }); }); } Future eventFiring(WidgetTester tester) async { await tester.pump(Duration.zero); } class StringCollector extends StreamBuilderBase> { const StringCollector({ Key key, Stream stream }) : super(key: key, stream: stream); @override List initial() => []; @override List afterConnected(List current) => current..add('conn'); @override List afterData(List current, String data) => current..add('data:$data'); @override List afterError(List current, dynamic error) => current..add('error:$error'); @override List afterDone(List current) => current..add('done'); @override List afterDisconnected(List current) => current..add('disc'); @override Widget build(BuildContext context, List currentSummary) => Text(currentSummary.join(', '), textDirection: TextDirection.ltr); }