// 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 'package:flutter/foundation.dart'; import 'package:flutter/services.dart'; import 'package:flutter/widgets.dart'; import 'package:flutter_test/flutter_test.dart'; class MemoryPressureObserver with WidgetsBindingObserver { bool sawMemoryPressure = false; @override void didHaveMemoryPressure() { sawMemoryPressure = true; } } class AppLifecycleStateObserver with WidgetsBindingObserver { late AppLifecycleState lifecycleState; @override void didChangeAppLifecycleState(AppLifecycleState state) { lifecycleState = state; } } class PushRouteObserver with WidgetsBindingObserver { late String pushedRoute; @override Future<bool> didPushRoute(String route) async { pushedRoute = route; return true; } } class PushRouteInformationObserver with WidgetsBindingObserver { late RouteInformation pushedRouteInformation; @override Future<bool> didPushRouteInformation(RouteInformation routeInformation) async { pushedRouteInformation = routeInformation; return true; } } void main() { setUp(() { WidgetsFlutterBinding.ensureInitialized(); }); Future<void> setAppLifeCycleState(AppLifecycleState state) async { final ByteData? message = const StringCodec().encodeMessage(state.toString()); await ServicesBinding.instance.defaultBinaryMessenger .handlePlatformMessage('flutter/lifecycle', message, (_) {}); } testWidgets('didHaveMemoryPressure callback', (WidgetTester tester) async { final MemoryPressureObserver observer = MemoryPressureObserver(); WidgetsBinding.instance.addObserver(observer); final ByteData message = const JSONMessageCodec().encodeMessage(<String, dynamic>{'type': 'memoryPressure'})!; await ServicesBinding.instance.defaultBinaryMessenger.handlePlatformMessage('flutter/system', message, (_) { }); expect(observer.sawMemoryPressure, true); WidgetsBinding.instance.removeObserver(observer); }); testWidgets('handleLifecycleStateChanged callback', (WidgetTester tester) async { final AppLifecycleStateObserver observer = AppLifecycleStateObserver(); WidgetsBinding.instance.addObserver(observer); setAppLifeCycleState(AppLifecycleState.paused); expect(observer.lifecycleState, AppLifecycleState.paused); setAppLifeCycleState(AppLifecycleState.resumed); expect(observer.lifecycleState, AppLifecycleState.resumed); setAppLifeCycleState(AppLifecycleState.inactive); expect(observer.lifecycleState, AppLifecycleState.inactive); setAppLifeCycleState(AppLifecycleState.detached); expect(observer.lifecycleState, AppLifecycleState.detached); setAppLifeCycleState(AppLifecycleState.resumed); }); testWidgets('didPushRoute callback', (WidgetTester tester) async { final PushRouteObserver observer = PushRouteObserver(); WidgetsBinding.instance.addObserver(observer); const String testRouteName = 'testRouteName'; final ByteData message = const JSONMethodCodec().encodeMethodCall(const MethodCall('pushRoute', testRouteName)); await ServicesBinding.instance.defaultBinaryMessenger.handlePlatformMessage('flutter/navigation', message, (_) { }); expect(observer.pushedRoute, testRouteName); WidgetsBinding.instance.removeObserver(observer); }); testWidgets('didPushRouteInformation calls didPushRoute by default', (WidgetTester tester) async { final PushRouteObserver observer = PushRouteObserver(); WidgetsBinding.instance.addObserver(observer); const Map<String, dynamic> testRouteInformation = <String, dynamic>{ 'location': 'testRouteName', 'state': 'state', 'restorationData': <dynamic, dynamic>{'test': 'config'}, }; final ByteData message = const JSONMethodCodec().encodeMethodCall( const MethodCall('pushRouteInformation', testRouteInformation), ); await ServicesBinding.instance.defaultBinaryMessenger .handlePlatformMessage('flutter/navigation', message, (_) {}); expect(observer.pushedRoute, 'testRouteName'); WidgetsBinding.instance.removeObserver(observer); }); testWidgets('didPushRouteInformation callback', (WidgetTester tester) async { final PushRouteInformationObserver observer = PushRouteInformationObserver(); WidgetsBinding.instance.addObserver(observer); const Map<String, dynamic> testRouteInformation = <String, dynamic>{ 'location': 'testRouteName', 'state': 'state', }; final ByteData message = const JSONMethodCodec().encodeMethodCall( const MethodCall('pushRouteInformation', testRouteInformation), ); await ServicesBinding.instance.defaultBinaryMessenger.handlePlatformMessage('flutter/navigation', message, (_) { }); expect(observer.pushedRouteInformation.location, 'testRouteName'); expect(observer.pushedRouteInformation.state, 'state'); WidgetsBinding.instance.removeObserver(observer); }); testWidgets('didPushRouteInformation callback with null state', (WidgetTester tester) async { final PushRouteInformationObserver observer = PushRouteInformationObserver(); WidgetsBinding.instance.addObserver(observer); const Map<String, dynamic> testRouteInformation = <String, dynamic>{ 'location': 'testRouteName', 'state': null, }; final ByteData message = const JSONMethodCodec().encodeMethodCall( const MethodCall('pushRouteInformation', testRouteInformation), ); await ServicesBinding.instance.defaultBinaryMessenger.handlePlatformMessage('flutter/navigation', message, (_) { }); expect(observer.pushedRouteInformation.location, 'testRouteName'); expect(observer.pushedRouteInformation.state, null); WidgetsBinding.instance.removeObserver(observer); }); testWidgets('Application lifecycle affects frame scheduling', (WidgetTester tester) async { expect(tester.binding.hasScheduledFrame, isFalse); setAppLifeCycleState(AppLifecycleState.paused); expect(tester.binding.hasScheduledFrame, isFalse); setAppLifeCycleState(AppLifecycleState.resumed); expect(tester.binding.hasScheduledFrame, isTrue); await tester.pump(); expect(tester.binding.hasScheduledFrame, isFalse); setAppLifeCycleState(AppLifecycleState.inactive); expect(tester.binding.hasScheduledFrame, isFalse); setAppLifeCycleState(AppLifecycleState.detached); expect(tester.binding.hasScheduledFrame, isFalse); setAppLifeCycleState(AppLifecycleState.inactive); expect(tester.binding.hasScheduledFrame, isTrue); await tester.pump(); expect(tester.binding.hasScheduledFrame, isFalse); setAppLifeCycleState(AppLifecycleState.paused); expect(tester.binding.hasScheduledFrame, isFalse); tester.binding.scheduleFrame(); expect(tester.binding.hasScheduledFrame, isFalse); tester.binding.scheduleForcedFrame(); expect(tester.binding.hasScheduledFrame, isTrue); await tester.pump(); int frameCount = 0; tester.binding.addPostFrameCallback((Duration duration) { frameCount += 1; }); expect(tester.binding.hasScheduledFrame, isFalse); await tester.pump(const Duration(milliseconds: 1)); expect(tester.binding.hasScheduledFrame, isFalse); expect(frameCount, 0); tester.binding.scheduleWarmUpFrame(); // this actually tests flutter_test's implementation expect(tester.binding.hasScheduledFrame, isFalse); expect(frameCount, 1); // Get the tester back to a resumed state for subsequent tests. setAppLifeCycleState(AppLifecycleState.resumed); expect(tester.binding.hasScheduledFrame, isTrue); await tester.pump(); }); testWidgets('scheduleFrameCallback error control test', (WidgetTester tester) async { late FlutterError error; try { tester.binding.scheduleFrameCallback((Duration _) { }, rescheduling: true); } on FlutterError catch (e) { error = e; } expect(error, isNotNull); expect(error.diagnostics.length, 3); expect(error.diagnostics.last.level, DiagnosticLevel.hint); expect( error.diagnostics.last.toStringDeep(), equalsIgnoringHashCodes( 'If this is the initial registration of the callback, or if the\n' 'callback is asynchronous, then do not use the "rescheduling"\n' 'argument.\n', ), ); expect( error.toStringDeep(), 'FlutterError\n' ' scheduleFrameCallback called with rescheduling true, but no\n' ' callback is in scope.\n' ' The "rescheduling" argument should only be set to true if the\n' ' callback is being reregistered from within the callback itself,\n' ' and only then if the callback itself is entirely synchronous.\n' ' If this is the initial registration of the callback, or if the\n' ' callback is asynchronous, then do not use the "rescheduling"\n' ' argument.\n', ); }); testWidgets('defaultStackFilter elides framework Element mounting stacks', (WidgetTester tester) async { final FlutterExceptionHandler? oldHandler = FlutterError.onError; late FlutterErrorDetails errorDetails; FlutterError.onError = (FlutterErrorDetails details) { errorDetails = details; }; await tester.pumpWidget(Directionality( textDirection: TextDirection.ltr, child: TestStatefulWidget( child: Builder( builder: (BuildContext context) { return Opacity( opacity: .5, child: Builder( builder: (BuildContext context) { assert(false); return const Text(''); }, ), ); }, ), ), )); FlutterError.onError = oldHandler; expect(errorDetails.exception, isAssertionError); const String toMatch = '... Normal element mounting ('; expect(toMatch.allMatches(errorDetails.toString()).length, 1); }, skip: kIsWeb); // https://github.com/flutter/flutter/issues/87875 } class TestStatefulWidget extends StatefulWidget { const TestStatefulWidget({required this.child, Key? key}) : super(key: key); final Widget child; @override State<StatefulWidget> createState() => TestStatefulWidgetState(); } class TestStatefulWidgetState extends State<TestStatefulWidget> { @override Widget build(BuildContext context) { return widget.child; } }