// Copyright (c) 2023, the Dart project authors. Please see the AUTHORS file // for details. 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:matcher/expect.dart'; import 'package:test_api/hooks_testing.dart'; /// Asserts that [monitor] has completed and passed. /// /// If the test had any errors, they're surfaced nicely into the outer test. void expectTestPassed(TestCaseMonitor monitor) { // Since the test is expected to pass, we forward any current or future errors // to the running test, because they're definitely unexpected and it is most // useful for the error to point directly to the throw point. for (var error in monitor.errors) { Zone.current.handleUncaughtError(error.error, error.stackTrace); } monitor.onError.listen((error) { Zone.current.handleUncaughtError(error.error, error.stackTrace); }); expect(monitor.state, State.passed); } /// Asserts that [monitor] failed with a single [TestFailure] whose message /// matches [message]. void expectTestFailed(TestCaseMonitor monitor, Object? message) { expect(monitor.state, State.failed); expect(monitor.errors, [isAsyncError(isTestFailure(message))]); } /// Returns a matcher that matches a [AsyncError] with an `error` field matching /// [errorMatcher]. Matcher isAsyncError(Matcher errorMatcher) => isA().having((e) => e.error, 'error', errorMatcher); /// Returns a matcher that matches a [TestFailure] with the given [message]. /// /// [message] can be a string or a [Matcher]. Matcher isTestFailure(Object? message) => const TypeMatcher() .having((e) => e.message, 'message', message); /// Returns a matcher that matches a callback or Future that throws a /// [TestFailure] with the given [message]. /// /// [message] can be a string or a [Matcher]. Matcher throwsTestFailure(Object? message) => throwsA(isTestFailure(message));