pkgs/matcher/test/utils_new.dart

// 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<AsyncError>().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<TestFailure>()
    .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));