Merge package:test_descriptor into the test monorepo
diff --git a/.gitattributes b/.gitattributes
new file mode 100644
index 0000000..f189cdd
--- /dev/null
+++ b/.gitattributes
@@ -0,0 +1,2 @@
+.github/workflows/dart.yml linguist-generated=true
+tool/ci.sh linguist-generated=true
diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS
new file mode 100644
index 0000000..a53d62f
--- /dev/null
+++ b/.github/CODEOWNERS
@@ -0,0 +1 @@
+/pkgs/ @dart-lang/core-package-admins
diff --git a/.github/ISSUE_TEMPLATE/01_test_runner_bug.md b/.github/ISSUE_TEMPLATE/01_test_runner_bug.md
new file mode 100644
index 0000000..e49d277
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/01_test_runner_bug.md
@@ -0,0 +1,14 @@
+---
+name: I found a bug in the test runner
+about: >-
+ Report a bug in running tests, integration with a specific platform, or
+ any behavior of 'package:test'.
+title: ''
+labels: bug
+---
+Describe the bug in detail.
+Include the specific command you ran and any relevant details about the
+environment, including operating system, Dart SDK version, and the version of
+`package:test` you are using.
+Whenever possible, include a full reproduction example that we can run to
+observe the problem.
diff --git a/.github/ISSUE_TEMPLATE/02_test_runner_feature.md b/.github/ISSUE_TEMPLATE/02_test_runner_feature.md
new file mode 100644
index 0000000..56170ba
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/02_test_runner_feature.md
@@ -0,0 +1,10 @@
+---
+name: I'd like a new feature in the test runner
+about: >-
+ Propose a feature for 'package:test' that would make testing easier or more
+ powerful.
+title: ''
+labels: enhancement
+---
+Describe the feature and include specific description of the use case, or use
+cases, you have in mind.
diff --git a/.github/ISSUE_TEMPLATE/03_checks_feedback.md b/.github/ISSUE_TEMPLATE/03_checks_feedback.md
new file mode 100644
index 0000000..5eb0039
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/03_checks_feedback.md
@@ -0,0 +1,8 @@
+---
+name: I have feedback for the package:checks preview
+about: Suggest a change, new feature, or bug, for 'package:checks'.
+title: ''
+labels: package:checks
+---
+Add any feedback about `package:checks`.
+Include a description of a specific use case for any feature requests.
diff --git a/.github/ISSUE_TEMPLATE/fake_async.md b/.github/ISSUE_TEMPLATE/fake_async.md
new file mode 100644
index 0000000..c26edd2
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/fake_async.md
@@ -0,0 +1,5 @@
+---
+name: "package:fake_async"
+about: "Create a bug or file a feature request against package:fake_async."
+labels: "package:fake_async"
+---
\ No newline at end of file
diff --git a/.github/ISSUE_TEMPLATE/matcher.md b/.github/ISSUE_TEMPLATE/matcher.md
new file mode 100644
index 0000000..f41464d
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/matcher.md
@@ -0,0 +1,5 @@
+---
+name: "package:matcher"
+about: "Create a bug or file a feature request against package:matcher."
+labels: "package:matcher"
+---
\ No newline at end of file
diff --git a/.github/dependabot.yml b/.github/dependabot.yml
new file mode 100644
index 0000000..8aa9b97
--- /dev/null
+++ b/.github/dependabot.yml
@@ -0,0 +1,33 @@
+# Dependabot configuration file.
+# See https://docs.github.com/en/code-security/dependabot/dependabot-version-updates
+
+version: 2
+
+updates:
+ - package-ecosystem: github-actions
+ directory: /
+ schedule:
+ interval: monthly
+ labels:
+ - autosubmit
+ groups:
+ github-actions:
+ patterns:
+ - "*"
+
+ # Check daily for major version dependency updates for packages which depend
+ # on package:analyzer.
+ - package-ecosystem: "pub"
+ directory: "pkgs/test"
+ schedule:
+ interval: "daily"
+ versioning-strategy: increase-if-necessary
+ reviewers:
+ - "natebosch"
+ - package-ecosystem: "pub"
+ directory: "pkgs/test_core"
+ schedule:
+ interval: "daily"
+ versioning-strategy: increase-if-necessary
+ reviewers:
+ - "natebosch"
diff --git a/.github/workflows/dart.yml b/.github/workflows/dart.yml
new file mode 100644
index 0000000..9a3cd79
--- /dev/null
+++ b/.github/workflows/dart.yml
@@ -0,0 +1,1903 @@
+# Created with package:mono_repo v6.6.2
+name: Dart CI
+on:
+ push:
+ branches:
+ - main
+ - master
+ pull_request:
+ schedule:
+ - cron: "0 0 * * 0"
+defaults:
+ run:
+ shell: bash
+env:
+ PUB_ENVIRONMENT: bot.github
+permissions: read-all
+
+jobs:
+ job_001:
+ name: mono_repo self validate
+ runs-on: ubuntu-latest
+ steps:
+ - name: Cache Pub hosted dependencies
+ uses: actions/cache@6849a6489940f00c2f30c0fb92c6274307ccb58a
+ with:
+ path: "~/.pub-cache/hosted"
+ key: "os:ubuntu-latest;pub-cache-hosted;sdk:stable"
+ restore-keys: |
+ os:ubuntu-latest;pub-cache-hosted
+ os:ubuntu-latest
+ - name: Setup Dart SDK
+ uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
+ with:
+ sdk: stable
+ - id: checkout
+ name: Checkout repository
+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+ - name: mono_repo self validate
+ run: dart pub global activate mono_repo 6.6.2
+ - name: mono_repo self validate
+ run: dart pub global run mono_repo generate --validate
+ job_002:
+ name: "analyze_and_format; linux; Dart 3.3.0; PKG: pkgs/fake_async; `dart analyze`"
+ runs-on: ubuntu-latest
+ steps:
+ - name: Cache Pub hosted dependencies
+ uses: actions/cache@6849a6489940f00c2f30c0fb92c6274307ccb58a
+ with:
+ path: "~/.pub-cache/hosted"
+ key: "os:ubuntu-latest;pub-cache-hosted;sdk:3.3.0;packages:pkgs/fake_async;commands:analyze_1"
+ restore-keys: |
+ os:ubuntu-latest;pub-cache-hosted;sdk:3.3.0;packages:pkgs/fake_async
+ os:ubuntu-latest;pub-cache-hosted;sdk:3.3.0
+ os:ubuntu-latest;pub-cache-hosted
+ os:ubuntu-latest
+ - name: Setup Dart SDK
+ uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
+ with:
+ sdk: "3.3.0"
+ - id: checkout
+ name: Checkout repository
+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+ - id: pkgs_fake_async_pub_upgrade
+ name: pkgs/fake_async; dart pub upgrade
+ run: dart pub upgrade
+ if: "always() && steps.checkout.conclusion == 'success'"
+ working-directory: pkgs/fake_async
+ - name: pkgs/fake_async; dart analyze
+ run: dart analyze
+ if: "always() && steps.pkgs_fake_async_pub_upgrade.conclusion == 'success'"
+ working-directory: pkgs/fake_async
+ job_003:
+ name: "analyze_and_format; linux; Dart 3.4.0; PKG: pkgs/matcher; `dart analyze`"
+ runs-on: ubuntu-latest
+ steps:
+ - name: Cache Pub hosted dependencies
+ uses: actions/cache@6849a6489940f00c2f30c0fb92c6274307ccb58a
+ with:
+ path: "~/.pub-cache/hosted"
+ key: "os:ubuntu-latest;pub-cache-hosted;sdk:3.4.0;packages:pkgs/matcher;commands:analyze_1"
+ restore-keys: |
+ os:ubuntu-latest;pub-cache-hosted;sdk:3.4.0;packages:pkgs/matcher
+ os:ubuntu-latest;pub-cache-hosted;sdk:3.4.0
+ os:ubuntu-latest;pub-cache-hosted
+ os:ubuntu-latest
+ - name: Setup Dart SDK
+ uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
+ with:
+ sdk: "3.4.0"
+ - id: checkout
+ name: Checkout repository
+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+ - id: pkgs_matcher_pub_upgrade
+ name: pkgs/matcher; dart pub upgrade
+ run: dart pub upgrade
+ if: "always() && steps.checkout.conclusion == 'success'"
+ working-directory: pkgs/matcher
+ - name: pkgs/matcher; dart analyze
+ run: dart analyze
+ if: "always() && steps.pkgs_matcher_pub_upgrade.conclusion == 'success'"
+ working-directory: pkgs/matcher
+ job_004:
+ name: "analyze_and_format; linux; Dart 3.5.0; PKGS: integration_tests/regression, integration_tests/wasm; `dart format --output=none --set-exit-if-changed .`, `dart analyze --fatal-infos`"
+ runs-on: ubuntu-latest
+ steps:
+ - name: Cache Pub hosted dependencies
+ uses: actions/cache@6849a6489940f00c2f30c0fb92c6274307ccb58a
+ with:
+ path: "~/.pub-cache/hosted"
+ key: "os:ubuntu-latest;pub-cache-hosted;sdk:3.5.0;packages:integration_tests/regression-integration_tests/wasm;commands:format-analyze_0"
+ restore-keys: |
+ os:ubuntu-latest;pub-cache-hosted;sdk:3.5.0;packages:integration_tests/regression-integration_tests/wasm
+ os:ubuntu-latest;pub-cache-hosted;sdk:3.5.0
+ os:ubuntu-latest;pub-cache-hosted
+ os:ubuntu-latest
+ - name: Setup Dart SDK
+ uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
+ with:
+ sdk: "3.5.0"
+ - id: checkout
+ name: Checkout repository
+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+ - id: integration_tests_regression_pub_upgrade
+ name: integration_tests/regression; dart pub upgrade
+ run: dart pub upgrade
+ if: "always() && steps.checkout.conclusion == 'success'"
+ working-directory: integration_tests/regression
+ - name: "integration_tests/regression; dart format --output=none --set-exit-if-changed ."
+ run: "dart format --output=none --set-exit-if-changed ."
+ if: "always() && steps.integration_tests_regression_pub_upgrade.conclusion == 'success'"
+ working-directory: integration_tests/regression
+ - name: "integration_tests/regression; dart analyze --fatal-infos"
+ run: dart analyze --fatal-infos
+ if: "always() && steps.integration_tests_regression_pub_upgrade.conclusion == 'success'"
+ working-directory: integration_tests/regression
+ - id: integration_tests_wasm_pub_upgrade
+ name: integration_tests/wasm; dart pub upgrade
+ run: dart pub upgrade
+ if: "always() && steps.checkout.conclusion == 'success'"
+ working-directory: integration_tests/wasm
+ - name: "integration_tests/wasm; dart format --output=none --set-exit-if-changed ."
+ run: "dart format --output=none --set-exit-if-changed ."
+ if: "always() && steps.integration_tests_wasm_pub_upgrade.conclusion == 'success'"
+ working-directory: integration_tests/wasm
+ - name: "integration_tests/wasm; dart analyze --fatal-infos"
+ run: dart analyze --fatal-infos
+ if: "always() && steps.integration_tests_wasm_pub_upgrade.conclusion == 'success'"
+ working-directory: integration_tests/wasm
+ job_005:
+ name: "analyze_and_format; linux; Dart 3.5.0; PKGS: pkgs/checks, pkgs/test_core; `dart analyze`"
+ runs-on: ubuntu-latest
+ steps:
+ - name: Cache Pub hosted dependencies
+ uses: actions/cache@6849a6489940f00c2f30c0fb92c6274307ccb58a
+ with:
+ path: "~/.pub-cache/hosted"
+ key: "os:ubuntu-latest;pub-cache-hosted;sdk:3.5.0;packages:pkgs/checks-pkgs/test_core;commands:analyze_1"
+ restore-keys: |
+ os:ubuntu-latest;pub-cache-hosted;sdk:3.5.0;packages:pkgs/checks-pkgs/test_core
+ os:ubuntu-latest;pub-cache-hosted;sdk:3.5.0
+ os:ubuntu-latest;pub-cache-hosted
+ os:ubuntu-latest
+ - name: Setup Dart SDK
+ uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
+ with:
+ sdk: "3.5.0"
+ - id: checkout
+ name: Checkout repository
+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+ - id: pkgs_checks_pub_upgrade
+ name: pkgs/checks; dart pub upgrade
+ run: dart pub upgrade
+ if: "always() && steps.checkout.conclusion == 'success'"
+ working-directory: pkgs/checks
+ - name: pkgs/checks; dart analyze
+ run: dart analyze
+ if: "always() && steps.pkgs_checks_pub_upgrade.conclusion == 'success'"
+ working-directory: pkgs/checks
+ - id: pkgs_test_core_pub_upgrade
+ name: pkgs/test_core; dart pub upgrade
+ run: dart pub upgrade
+ if: "always() && steps.checkout.conclusion == 'success'"
+ working-directory: pkgs/test_core
+ - name: pkgs/test_core; dart analyze
+ run: dart analyze
+ if: "always() && steps.pkgs_test_core_pub_upgrade.conclusion == 'success'"
+ working-directory: pkgs/test_core
+ job_006:
+ name: "analyze_and_format; linux; Dart dev; PKGS: integration_tests/regression, integration_tests/spawn_hybrid, integration_tests/wasm, pkgs/checks, pkgs/fake_async, pkgs/matcher, pkgs/test, pkgs/test_api, pkgs/test_core; `dart format --output=none --set-exit-if-changed .`, `dart analyze --fatal-infos`"
+ runs-on: ubuntu-latest
+ steps:
+ - name: Cache Pub hosted dependencies
+ uses: actions/cache@6849a6489940f00c2f30c0fb92c6274307ccb58a
+ with:
+ path: "~/.pub-cache/hosted"
+ key: "os:ubuntu-latest;pub-cache-hosted;sdk:dev;packages:integration_tests/regression-integration_tests/spawn_hybrid-integration_tests/wasm-pkgs/checks-pkgs/fake_async-pkgs/matcher-pkgs/test-pkgs/test_api-pkgs/test_core;commands:format-analyze_0"
+ restore-keys: |
+ os:ubuntu-latest;pub-cache-hosted;sdk:dev;packages:integration_tests/regression-integration_tests/spawn_hybrid-integration_tests/wasm-pkgs/checks-pkgs/fake_async-pkgs/matcher-pkgs/test-pkgs/test_api-pkgs/test_core
+ os:ubuntu-latest;pub-cache-hosted;sdk:dev
+ os:ubuntu-latest;pub-cache-hosted
+ os:ubuntu-latest
+ - name: Setup Dart SDK
+ uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
+ with:
+ sdk: dev
+ - id: checkout
+ name: Checkout repository
+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+ - id: integration_tests_regression_pub_upgrade
+ name: integration_tests/regression; dart pub upgrade
+ run: dart pub upgrade
+ if: "always() && steps.checkout.conclusion == 'success'"
+ working-directory: integration_tests/regression
+ - name: "integration_tests/regression; dart format --output=none --set-exit-if-changed ."
+ run: "dart format --output=none --set-exit-if-changed ."
+ if: "always() && steps.integration_tests_regression_pub_upgrade.conclusion == 'success'"
+ working-directory: integration_tests/regression
+ - name: "integration_tests/regression; dart analyze --fatal-infos"
+ run: dart analyze --fatal-infos
+ if: "always() && steps.integration_tests_regression_pub_upgrade.conclusion == 'success'"
+ working-directory: integration_tests/regression
+ - id: integration_tests_spawn_hybrid_pub_upgrade
+ name: integration_tests/spawn_hybrid; dart pub upgrade
+ run: dart pub upgrade
+ if: "always() && steps.checkout.conclusion == 'success'"
+ working-directory: integration_tests/spawn_hybrid
+ - name: "integration_tests/spawn_hybrid; dart format --output=none --set-exit-if-changed ."
+ run: "dart format --output=none --set-exit-if-changed ."
+ if: "always() && steps.integration_tests_spawn_hybrid_pub_upgrade.conclusion == 'success'"
+ working-directory: integration_tests/spawn_hybrid
+ - name: "integration_tests/spawn_hybrid; dart analyze --fatal-infos"
+ run: dart analyze --fatal-infos
+ if: "always() && steps.integration_tests_spawn_hybrid_pub_upgrade.conclusion == 'success'"
+ working-directory: integration_tests/spawn_hybrid
+ - id: integration_tests_wasm_pub_upgrade
+ name: integration_tests/wasm; dart pub upgrade
+ run: dart pub upgrade
+ if: "always() && steps.checkout.conclusion == 'success'"
+ working-directory: integration_tests/wasm
+ - name: "integration_tests/wasm; dart format --output=none --set-exit-if-changed ."
+ run: "dart format --output=none --set-exit-if-changed ."
+ if: "always() && steps.integration_tests_wasm_pub_upgrade.conclusion == 'success'"
+ working-directory: integration_tests/wasm
+ - name: "integration_tests/wasm; dart analyze --fatal-infos"
+ run: dart analyze --fatal-infos
+ if: "always() && steps.integration_tests_wasm_pub_upgrade.conclusion == 'success'"
+ working-directory: integration_tests/wasm
+ - id: pkgs_checks_pub_upgrade
+ name: pkgs/checks; dart pub upgrade
+ run: dart pub upgrade
+ if: "always() && steps.checkout.conclusion == 'success'"
+ working-directory: pkgs/checks
+ - name: "pkgs/checks; dart format --output=none --set-exit-if-changed ."
+ run: "dart format --output=none --set-exit-if-changed ."
+ if: "always() && steps.pkgs_checks_pub_upgrade.conclusion == 'success'"
+ working-directory: pkgs/checks
+ - name: "pkgs/checks; dart analyze --fatal-infos"
+ run: dart analyze --fatal-infos
+ if: "always() && steps.pkgs_checks_pub_upgrade.conclusion == 'success'"
+ working-directory: pkgs/checks
+ - id: pkgs_fake_async_pub_upgrade
+ name: pkgs/fake_async; dart pub upgrade
+ run: dart pub upgrade
+ if: "always() && steps.checkout.conclusion == 'success'"
+ working-directory: pkgs/fake_async
+ - name: "pkgs/fake_async; dart format --output=none --set-exit-if-changed ."
+ run: "dart format --output=none --set-exit-if-changed ."
+ if: "always() && steps.pkgs_fake_async_pub_upgrade.conclusion == 'success'"
+ working-directory: pkgs/fake_async
+ - name: "pkgs/fake_async; dart analyze --fatal-infos"
+ run: dart analyze --fatal-infos
+ if: "always() && steps.pkgs_fake_async_pub_upgrade.conclusion == 'success'"
+ working-directory: pkgs/fake_async
+ - id: pkgs_matcher_pub_upgrade
+ name: pkgs/matcher; dart pub upgrade
+ run: dart pub upgrade
+ if: "always() && steps.checkout.conclusion == 'success'"
+ working-directory: pkgs/matcher
+ - name: "pkgs/matcher; dart format --output=none --set-exit-if-changed ."
+ run: "dart format --output=none --set-exit-if-changed ."
+ if: "always() && steps.pkgs_matcher_pub_upgrade.conclusion == 'success'"
+ working-directory: pkgs/matcher
+ - name: "pkgs/matcher; dart analyze --fatal-infos"
+ run: dart analyze --fatal-infos
+ if: "always() && steps.pkgs_matcher_pub_upgrade.conclusion == 'success'"
+ working-directory: pkgs/matcher
+ - id: pkgs_test_pub_upgrade
+ name: pkgs/test; dart pub upgrade
+ run: dart pub upgrade
+ if: "always() && steps.checkout.conclusion == 'success'"
+ working-directory: pkgs/test
+ - name: "pkgs/test; dart format --output=none --set-exit-if-changed ."
+ run: "dart format --output=none --set-exit-if-changed ."
+ if: "always() && steps.pkgs_test_pub_upgrade.conclusion == 'success'"
+ working-directory: pkgs/test
+ - name: "pkgs/test; dart analyze --fatal-infos"
+ run: dart analyze --fatal-infos
+ if: "always() && steps.pkgs_test_pub_upgrade.conclusion == 'success'"
+ working-directory: pkgs/test
+ - id: pkgs_test_api_pub_upgrade
+ name: pkgs/test_api; dart pub upgrade
+ run: dart pub upgrade
+ if: "always() && steps.checkout.conclusion == 'success'"
+ working-directory: pkgs/test_api
+ - name: "pkgs/test_api; dart format --output=none --set-exit-if-changed ."
+ run: "dart format --output=none --set-exit-if-changed ."
+ if: "always() && steps.pkgs_test_api_pub_upgrade.conclusion == 'success'"
+ working-directory: pkgs/test_api
+ - name: "pkgs/test_api; dart analyze --fatal-infos"
+ run: dart analyze --fatal-infos
+ if: "always() && steps.pkgs_test_api_pub_upgrade.conclusion == 'success'"
+ working-directory: pkgs/test_api
+ - id: pkgs_test_core_pub_upgrade
+ name: pkgs/test_core; dart pub upgrade
+ run: dart pub upgrade
+ if: "always() && steps.checkout.conclusion == 'success'"
+ working-directory: pkgs/test_core
+ - name: "pkgs/test_core; dart format --output=none --set-exit-if-changed ."
+ run: "dart format --output=none --set-exit-if-changed ."
+ if: "always() && steps.pkgs_test_core_pub_upgrade.conclusion == 'success'"
+ working-directory: pkgs/test_core
+ - name: "pkgs/test_core; dart analyze --fatal-infos"
+ run: dart analyze --fatal-infos
+ if: "always() && steps.pkgs_test_core_pub_upgrade.conclusion == 'success'"
+ working-directory: pkgs/test_core
+ job_007:
+ name: "analyze_and_format; windows; Dart 3.5.0; PKG: integration_tests/wasm; `dart format --output=none --set-exit-if-changed .`, `dart analyze --fatal-infos`"
+ runs-on: windows-latest
+ steps:
+ - name: Setup Dart SDK
+ uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
+ with:
+ sdk: "3.5.0"
+ - id: checkout
+ name: Checkout repository
+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+ - id: integration_tests_wasm_pub_upgrade
+ name: integration_tests/wasm; dart pub upgrade
+ run: dart pub upgrade
+ if: "always() && steps.checkout.conclusion == 'success'"
+ working-directory: integration_tests/wasm
+ - name: "integration_tests/wasm; dart format --output=none --set-exit-if-changed ."
+ run: "dart format --output=none --set-exit-if-changed ."
+ if: "always() && steps.integration_tests_wasm_pub_upgrade.conclusion == 'success'"
+ working-directory: integration_tests/wasm
+ - name: "integration_tests/wasm; dart analyze --fatal-infos"
+ run: dart analyze --fatal-infos
+ if: "always() && steps.integration_tests_wasm_pub_upgrade.conclusion == 'success'"
+ working-directory: integration_tests/wasm
+ job_008:
+ name: "analyze_and_format; windows; Dart dev; PKG: integration_tests/wasm; `dart format --output=none --set-exit-if-changed .`, `dart analyze --fatal-infos`"
+ runs-on: windows-latest
+ steps:
+ - name: Setup Dart SDK
+ uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
+ with:
+ sdk: dev
+ - id: checkout
+ name: Checkout repository
+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+ - id: integration_tests_wasm_pub_upgrade
+ name: integration_tests/wasm; dart pub upgrade
+ run: dart pub upgrade
+ if: "always() && steps.checkout.conclusion == 'success'"
+ working-directory: integration_tests/wasm
+ - name: "integration_tests/wasm; dart format --output=none --set-exit-if-changed ."
+ run: "dart format --output=none --set-exit-if-changed ."
+ if: "always() && steps.integration_tests_wasm_pub_upgrade.conclusion == 'success'"
+ working-directory: integration_tests/wasm
+ - name: "integration_tests/wasm; dart analyze --fatal-infos"
+ run: dart analyze --fatal-infos
+ if: "always() && steps.integration_tests_wasm_pub_upgrade.conclusion == 'success'"
+ working-directory: integration_tests/wasm
+ job_009:
+ name: "unit_test; linux; Dart 3.3.0; PKG: pkgs/fake_async; `dart test`"
+ runs-on: ubuntu-latest
+ steps:
+ - name: Cache Pub hosted dependencies
+ uses: actions/cache@6849a6489940f00c2f30c0fb92c6274307ccb58a
+ with:
+ path: "~/.pub-cache/hosted"
+ key: "os:ubuntu-latest;pub-cache-hosted;sdk:3.3.0;packages:pkgs/fake_async;commands:command_00"
+ restore-keys: |
+ os:ubuntu-latest;pub-cache-hosted;sdk:3.3.0;packages:pkgs/fake_async
+ os:ubuntu-latest;pub-cache-hosted;sdk:3.3.0
+ os:ubuntu-latest;pub-cache-hosted
+ os:ubuntu-latest
+ - name: Setup Dart SDK
+ uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
+ with:
+ sdk: "3.3.0"
+ - id: checkout
+ name: Checkout repository
+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+ - id: pkgs_fake_async_pub_upgrade
+ name: pkgs/fake_async; dart pub upgrade
+ run: dart pub upgrade
+ if: "always() && steps.checkout.conclusion == 'success'"
+ working-directory: pkgs/fake_async
+ - name: pkgs/fake_async; dart test
+ run: dart test
+ if: "always() && steps.pkgs_fake_async_pub_upgrade.conclusion == 'success'"
+ working-directory: pkgs/fake_async
+ needs:
+ - job_001
+ - job_002
+ - job_003
+ - job_004
+ - job_005
+ - job_006
+ - job_007
+ - job_008
+ job_010:
+ name: "unit_test; linux; Dart 3.4.0; PKG: pkgs/matcher; `dart test`"
+ runs-on: ubuntu-latest
+ steps:
+ - name: Cache Pub hosted dependencies
+ uses: actions/cache@6849a6489940f00c2f30c0fb92c6274307ccb58a
+ with:
+ path: "~/.pub-cache/hosted"
+ key: "os:ubuntu-latest;pub-cache-hosted;sdk:3.4.0;packages:pkgs/matcher;commands:command_00"
+ restore-keys: |
+ os:ubuntu-latest;pub-cache-hosted;sdk:3.4.0;packages:pkgs/matcher
+ os:ubuntu-latest;pub-cache-hosted;sdk:3.4.0
+ os:ubuntu-latest;pub-cache-hosted
+ os:ubuntu-latest
+ - name: Setup Dart SDK
+ uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
+ with:
+ sdk: "3.4.0"
+ - id: checkout
+ name: Checkout repository
+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+ - id: pkgs_matcher_pub_upgrade
+ name: pkgs/matcher; dart pub upgrade
+ run: dart pub upgrade
+ if: "always() && steps.checkout.conclusion == 'success'"
+ working-directory: pkgs/matcher
+ - name: pkgs/matcher; dart test
+ run: dart test
+ if: "always() && steps.pkgs_matcher_pub_upgrade.conclusion == 'success'"
+ working-directory: pkgs/matcher
+ needs:
+ - job_001
+ - job_002
+ - job_003
+ - job_004
+ - job_005
+ - job_006
+ - job_007
+ - job_008
+ job_011:
+ name: "unit_test; linux; Dart 3.5.0; PKG: integration_tests/regression; `dart test`"
+ runs-on: ubuntu-latest
+ steps:
+ - name: Cache Pub hosted dependencies
+ uses: actions/cache@6849a6489940f00c2f30c0fb92c6274307ccb58a
+ with:
+ path: "~/.pub-cache/hosted"
+ key: "os:ubuntu-latest;pub-cache-hosted;sdk:3.5.0;packages:integration_tests/regression;commands:command_00"
+ restore-keys: |
+ os:ubuntu-latest;pub-cache-hosted;sdk:3.5.0;packages:integration_tests/regression
+ os:ubuntu-latest;pub-cache-hosted;sdk:3.5.0
+ os:ubuntu-latest;pub-cache-hosted
+ os:ubuntu-latest
+ - name: Setup Dart SDK
+ uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
+ with:
+ sdk: "3.5.0"
+ - id: checkout
+ name: Checkout repository
+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+ - id: integration_tests_regression_pub_upgrade
+ name: integration_tests/regression; dart pub upgrade
+ run: dart pub upgrade
+ if: "always() && steps.checkout.conclusion == 'success'"
+ working-directory: integration_tests/regression
+ - name: integration_tests/regression; dart test
+ run: dart test
+ if: "always() && steps.integration_tests_regression_pub_upgrade.conclusion == 'success'"
+ working-directory: integration_tests/regression
+ needs:
+ - job_001
+ - job_002
+ - job_003
+ - job_004
+ - job_005
+ - job_006
+ - job_007
+ - job_008
+ job_012:
+ name: "unit_test; linux; Dart 3.5.0; PKG: pkgs/checks; `dart test`"
+ runs-on: ubuntu-latest
+ steps:
+ - name: Cache Pub hosted dependencies
+ uses: actions/cache@6849a6489940f00c2f30c0fb92c6274307ccb58a
+ with:
+ path: "~/.pub-cache/hosted"
+ key: "os:ubuntu-latest;pub-cache-hosted;sdk:3.5.0;packages:pkgs/checks;commands:command_00"
+ restore-keys: |
+ os:ubuntu-latest;pub-cache-hosted;sdk:3.5.0;packages:pkgs/checks
+ os:ubuntu-latest;pub-cache-hosted;sdk:3.5.0
+ os:ubuntu-latest;pub-cache-hosted
+ os:ubuntu-latest
+ - name: Setup Dart SDK
+ uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
+ with:
+ sdk: "3.5.0"
+ - id: checkout
+ name: Checkout repository
+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+ - id: pkgs_checks_pub_upgrade
+ name: pkgs/checks; dart pub upgrade
+ run: dart pub upgrade
+ if: "always() && steps.checkout.conclusion == 'success'"
+ working-directory: pkgs/checks
+ - name: pkgs/checks; dart test
+ run: dart test
+ if: "always() && steps.pkgs_checks_pub_upgrade.conclusion == 'success'"
+ working-directory: pkgs/checks
+ needs:
+ - job_001
+ - job_002
+ - job_003
+ - job_004
+ - job_005
+ - job_006
+ - job_007
+ - job_008
+ job_013:
+ name: "unit_test; linux; Dart 3.5.0; PKG: pkgs/test_core; `dart test`"
+ runs-on: ubuntu-latest
+ steps:
+ - name: Cache Pub hosted dependencies
+ uses: actions/cache@6849a6489940f00c2f30c0fb92c6274307ccb58a
+ with:
+ path: "~/.pub-cache/hosted"
+ key: "os:ubuntu-latest;pub-cache-hosted;sdk:3.5.0;packages:pkgs/test_core;commands:command_00"
+ restore-keys: |
+ os:ubuntu-latest;pub-cache-hosted;sdk:3.5.0;packages:pkgs/test_core
+ os:ubuntu-latest;pub-cache-hosted;sdk:3.5.0
+ os:ubuntu-latest;pub-cache-hosted
+ os:ubuntu-latest
+ - name: Setup Dart SDK
+ uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
+ with:
+ sdk: "3.5.0"
+ - id: checkout
+ name: Checkout repository
+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+ - id: pkgs_test_core_pub_upgrade
+ name: pkgs/test_core; dart pub upgrade
+ run: dart pub upgrade
+ if: "always() && steps.checkout.conclusion == 'success'"
+ working-directory: pkgs/test_core
+ - name: pkgs/test_core; dart test
+ run: dart test
+ if: "always() && steps.pkgs_test_core_pub_upgrade.conclusion == 'success'"
+ working-directory: pkgs/test_core
+ needs:
+ - job_001
+ - job_002
+ - job_003
+ - job_004
+ - job_005
+ - job_006
+ - job_007
+ - job_008
+ job_014:
+ name: "unit_test; linux; Dart 3.5.0; PKG: integration_tests/spawn_hybrid; `dart test -p chrome,vm,node`"
+ runs-on: ubuntu-latest
+ steps:
+ - name: Cache Pub hosted dependencies
+ uses: actions/cache@6849a6489940f00c2f30c0fb92c6274307ccb58a
+ with:
+ path: "~/.pub-cache/hosted"
+ key: "os:ubuntu-latest;pub-cache-hosted;sdk:3.5.0;packages:integration_tests/spawn_hybrid;commands:test_1"
+ restore-keys: |
+ os:ubuntu-latest;pub-cache-hosted;sdk:3.5.0;packages:integration_tests/spawn_hybrid
+ os:ubuntu-latest;pub-cache-hosted;sdk:3.5.0
+ os:ubuntu-latest;pub-cache-hosted
+ os:ubuntu-latest
+ - name: Setup Dart SDK
+ uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
+ with:
+ sdk: "3.5.0"
+ - id: checkout
+ name: Checkout repository
+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+ - id: integration_tests_spawn_hybrid_pub_upgrade
+ name: integration_tests/spawn_hybrid; dart pub upgrade
+ run: dart pub upgrade
+ if: "always() && steps.checkout.conclusion == 'success'"
+ working-directory: integration_tests/spawn_hybrid
+ - name: "integration_tests/spawn_hybrid; dart test -p chrome,vm,node"
+ run: "dart test -p chrome,vm,node"
+ if: "always() && steps.integration_tests_spawn_hybrid_pub_upgrade.conclusion == 'success'"
+ working-directory: integration_tests/spawn_hybrid
+ needs:
+ - job_001
+ - job_002
+ - job_003
+ - job_004
+ - job_005
+ - job_006
+ - job_007
+ - job_008
+ job_015:
+ name: "unit_test; linux; Dart 3.5.0; PKG: integration_tests/wasm; `dart test --timeout=60s`"
+ runs-on: ubuntu-latest
+ steps:
+ - name: Cache Pub hosted dependencies
+ uses: actions/cache@6849a6489940f00c2f30c0fb92c6274307ccb58a
+ with:
+ path: "~/.pub-cache/hosted"
+ key: "os:ubuntu-latest;pub-cache-hosted;sdk:3.5.0;packages:integration_tests/wasm;commands:test_2"
+ restore-keys: |
+ os:ubuntu-latest;pub-cache-hosted;sdk:3.5.0;packages:integration_tests/wasm
+ os:ubuntu-latest;pub-cache-hosted;sdk:3.5.0
+ os:ubuntu-latest;pub-cache-hosted
+ os:ubuntu-latest
+ - name: Setup Dart SDK
+ uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
+ with:
+ sdk: "3.5.0"
+ - id: checkout
+ name: Checkout repository
+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+ - id: integration_tests_wasm_pub_upgrade
+ name: integration_tests/wasm; dart pub upgrade
+ run: dart pub upgrade
+ if: "always() && steps.checkout.conclusion == 'success'"
+ working-directory: integration_tests/wasm
+ - name: "integration_tests/wasm; dart test --timeout=60s"
+ run: "dart test --timeout=60s"
+ if: "always() && steps.integration_tests_wasm_pub_upgrade.conclusion == 'success'"
+ working-directory: integration_tests/wasm
+ needs:
+ - job_001
+ - job_002
+ - job_003
+ - job_004
+ - job_005
+ - job_006
+ - job_007
+ - job_008
+ job_016:
+ name: "unit_test; linux; Dart 3.5.0; PKG: pkgs/test; `xvfb-run -s \"-screen 0 1024x768x24\" dart test --preset travis --total-shards 5 --shard-index 0`"
+ runs-on: ubuntu-latest
+ steps:
+ - name: Cache Pub hosted dependencies
+ uses: actions/cache@6849a6489940f00c2f30c0fb92c6274307ccb58a
+ with:
+ path: "~/.pub-cache/hosted"
+ key: "os:ubuntu-latest;pub-cache-hosted;sdk:3.5.0;packages:pkgs/test;commands:command_01"
+ restore-keys: |
+ os:ubuntu-latest;pub-cache-hosted;sdk:3.5.0;packages:pkgs/test
+ os:ubuntu-latest;pub-cache-hosted;sdk:3.5.0
+ os:ubuntu-latest;pub-cache-hosted
+ os:ubuntu-latest
+ - name: Setup Dart SDK
+ uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
+ with:
+ sdk: "3.5.0"
+ - id: checkout
+ name: Checkout repository
+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+ - id: pkgs_test_pub_upgrade
+ name: pkgs/test; dart pub upgrade
+ run: dart pub upgrade
+ if: "always() && steps.checkout.conclusion == 'success'"
+ working-directory: pkgs/test
+ - name: "pkgs/test; xvfb-run -s \"-screen 0 1024x768x24\" dart test --preset travis --total-shards 5 --shard-index 0"
+ run: "xvfb-run -s \"-screen 0 1024x768x24\" dart test --preset travis --total-shards 5 --shard-index 0"
+ if: "always() && steps.pkgs_test_pub_upgrade.conclusion == 'success'"
+ working-directory: pkgs/test
+ needs:
+ - job_001
+ - job_002
+ - job_003
+ - job_004
+ - job_005
+ - job_006
+ - job_007
+ - job_008
+ job_017:
+ name: "unit_test; linux; Dart 3.5.0; PKG: pkgs/test; `xvfb-run -s \"-screen 0 1024x768x24\" dart test --preset travis --total-shards 5 --shard-index 1`"
+ runs-on: ubuntu-latest
+ steps:
+ - name: Cache Pub hosted dependencies
+ uses: actions/cache@6849a6489940f00c2f30c0fb92c6274307ccb58a
+ with:
+ path: "~/.pub-cache/hosted"
+ key: "os:ubuntu-latest;pub-cache-hosted;sdk:3.5.0;packages:pkgs/test;commands:command_02"
+ restore-keys: |
+ os:ubuntu-latest;pub-cache-hosted;sdk:3.5.0;packages:pkgs/test
+ os:ubuntu-latest;pub-cache-hosted;sdk:3.5.0
+ os:ubuntu-latest;pub-cache-hosted
+ os:ubuntu-latest
+ - name: Setup Dart SDK
+ uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
+ with:
+ sdk: "3.5.0"
+ - id: checkout
+ name: Checkout repository
+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+ - id: pkgs_test_pub_upgrade
+ name: pkgs/test; dart pub upgrade
+ run: dart pub upgrade
+ if: "always() && steps.checkout.conclusion == 'success'"
+ working-directory: pkgs/test
+ - name: "pkgs/test; xvfb-run -s \"-screen 0 1024x768x24\" dart test --preset travis --total-shards 5 --shard-index 1"
+ run: "xvfb-run -s \"-screen 0 1024x768x24\" dart test --preset travis --total-shards 5 --shard-index 1"
+ if: "always() && steps.pkgs_test_pub_upgrade.conclusion == 'success'"
+ working-directory: pkgs/test
+ needs:
+ - job_001
+ - job_002
+ - job_003
+ - job_004
+ - job_005
+ - job_006
+ - job_007
+ - job_008
+ job_018:
+ name: "unit_test; linux; Dart 3.5.0; PKG: pkgs/test; `xvfb-run -s \"-screen 0 1024x768x24\" dart test --preset travis --total-shards 5 --shard-index 2`"
+ runs-on: ubuntu-latest
+ steps:
+ - name: Cache Pub hosted dependencies
+ uses: actions/cache@6849a6489940f00c2f30c0fb92c6274307ccb58a
+ with:
+ path: "~/.pub-cache/hosted"
+ key: "os:ubuntu-latest;pub-cache-hosted;sdk:3.5.0;packages:pkgs/test;commands:command_03"
+ restore-keys: |
+ os:ubuntu-latest;pub-cache-hosted;sdk:3.5.0;packages:pkgs/test
+ os:ubuntu-latest;pub-cache-hosted;sdk:3.5.0
+ os:ubuntu-latest;pub-cache-hosted
+ os:ubuntu-latest
+ - name: Setup Dart SDK
+ uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
+ with:
+ sdk: "3.5.0"
+ - id: checkout
+ name: Checkout repository
+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+ - id: pkgs_test_pub_upgrade
+ name: pkgs/test; dart pub upgrade
+ run: dart pub upgrade
+ if: "always() && steps.checkout.conclusion == 'success'"
+ working-directory: pkgs/test
+ - name: "pkgs/test; xvfb-run -s \"-screen 0 1024x768x24\" dart test --preset travis --total-shards 5 --shard-index 2"
+ run: "xvfb-run -s \"-screen 0 1024x768x24\" dart test --preset travis --total-shards 5 --shard-index 2"
+ if: "always() && steps.pkgs_test_pub_upgrade.conclusion == 'success'"
+ working-directory: pkgs/test
+ needs:
+ - job_001
+ - job_002
+ - job_003
+ - job_004
+ - job_005
+ - job_006
+ - job_007
+ - job_008
+ job_019:
+ name: "unit_test; linux; Dart 3.5.0; PKG: pkgs/test; `xvfb-run -s \"-screen 0 1024x768x24\" dart test --preset travis --total-shards 5 --shard-index 3`"
+ runs-on: ubuntu-latest
+ steps:
+ - name: Cache Pub hosted dependencies
+ uses: actions/cache@6849a6489940f00c2f30c0fb92c6274307ccb58a
+ with:
+ path: "~/.pub-cache/hosted"
+ key: "os:ubuntu-latest;pub-cache-hosted;sdk:3.5.0;packages:pkgs/test;commands:command_04"
+ restore-keys: |
+ os:ubuntu-latest;pub-cache-hosted;sdk:3.5.0;packages:pkgs/test
+ os:ubuntu-latest;pub-cache-hosted;sdk:3.5.0
+ os:ubuntu-latest;pub-cache-hosted
+ os:ubuntu-latest
+ - name: Setup Dart SDK
+ uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
+ with:
+ sdk: "3.5.0"
+ - id: checkout
+ name: Checkout repository
+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+ - id: pkgs_test_pub_upgrade
+ name: pkgs/test; dart pub upgrade
+ run: dart pub upgrade
+ if: "always() && steps.checkout.conclusion == 'success'"
+ working-directory: pkgs/test
+ - name: "pkgs/test; xvfb-run -s \"-screen 0 1024x768x24\" dart test --preset travis --total-shards 5 --shard-index 3"
+ run: "xvfb-run -s \"-screen 0 1024x768x24\" dart test --preset travis --total-shards 5 --shard-index 3"
+ if: "always() && steps.pkgs_test_pub_upgrade.conclusion == 'success'"
+ working-directory: pkgs/test
+ needs:
+ - job_001
+ - job_002
+ - job_003
+ - job_004
+ - job_005
+ - job_006
+ - job_007
+ - job_008
+ job_020:
+ name: "unit_test; linux; Dart 3.5.0; PKG: pkgs/test; `xvfb-run -s \"-screen 0 1024x768x24\" dart test --preset travis --total-shards 5 --shard-index 4`"
+ runs-on: ubuntu-latest
+ steps:
+ - name: Cache Pub hosted dependencies
+ uses: actions/cache@6849a6489940f00c2f30c0fb92c6274307ccb58a
+ with:
+ path: "~/.pub-cache/hosted"
+ key: "os:ubuntu-latest;pub-cache-hosted;sdk:3.5.0;packages:pkgs/test;commands:command_05"
+ restore-keys: |
+ os:ubuntu-latest;pub-cache-hosted;sdk:3.5.0;packages:pkgs/test
+ os:ubuntu-latest;pub-cache-hosted;sdk:3.5.0
+ os:ubuntu-latest;pub-cache-hosted
+ os:ubuntu-latest
+ - name: Setup Dart SDK
+ uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
+ with:
+ sdk: "3.5.0"
+ - id: checkout
+ name: Checkout repository
+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+ - id: pkgs_test_pub_upgrade
+ name: pkgs/test; dart pub upgrade
+ run: dart pub upgrade
+ if: "always() && steps.checkout.conclusion == 'success'"
+ working-directory: pkgs/test
+ - name: "pkgs/test; xvfb-run -s \"-screen 0 1024x768x24\" dart test --preset travis --total-shards 5 --shard-index 4"
+ run: "xvfb-run -s \"-screen 0 1024x768x24\" dart test --preset travis --total-shards 5 --shard-index 4"
+ if: "always() && steps.pkgs_test_pub_upgrade.conclusion == 'success'"
+ working-directory: pkgs/test
+ needs:
+ - job_001
+ - job_002
+ - job_003
+ - job_004
+ - job_005
+ - job_006
+ - job_007
+ - job_008
+ job_021:
+ name: "unit_test; linux; Dart 3.5.0; PKG: pkgs/test_api; `dart test --preset travis -x browser`"
+ runs-on: ubuntu-latest
+ steps:
+ - name: Cache Pub hosted dependencies
+ uses: actions/cache@6849a6489940f00c2f30c0fb92c6274307ccb58a
+ with:
+ path: "~/.pub-cache/hosted"
+ key: "os:ubuntu-latest;pub-cache-hosted;sdk:3.5.0;packages:pkgs/test_api;commands:command_11"
+ restore-keys: |
+ os:ubuntu-latest;pub-cache-hosted;sdk:3.5.0;packages:pkgs/test_api
+ os:ubuntu-latest;pub-cache-hosted;sdk:3.5.0
+ os:ubuntu-latest;pub-cache-hosted
+ os:ubuntu-latest
+ - name: Setup Dart SDK
+ uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
+ with:
+ sdk: "3.5.0"
+ - id: checkout
+ name: Checkout repository
+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+ - id: pkgs_test_api_pub_upgrade
+ name: pkgs/test_api; dart pub upgrade
+ run: dart pub upgrade
+ if: "always() && steps.checkout.conclusion == 'success'"
+ working-directory: pkgs/test_api
+ - name: "pkgs/test_api; dart test --preset travis -x browser"
+ run: dart test --preset travis -x browser
+ if: "always() && steps.pkgs_test_api_pub_upgrade.conclusion == 'success'"
+ working-directory: pkgs/test_api
+ needs:
+ - job_001
+ - job_002
+ - job_003
+ - job_004
+ - job_005
+ - job_006
+ - job_007
+ - job_008
+ job_022:
+ name: "unit_test; linux; Dart dev; PKG: integration_tests/regression; `dart test`"
+ runs-on: ubuntu-latest
+ steps:
+ - name: Cache Pub hosted dependencies
+ uses: actions/cache@6849a6489940f00c2f30c0fb92c6274307ccb58a
+ with:
+ path: "~/.pub-cache/hosted"
+ key: "os:ubuntu-latest;pub-cache-hosted;sdk:dev;packages:integration_tests/regression;commands:command_00"
+ restore-keys: |
+ os:ubuntu-latest;pub-cache-hosted;sdk:dev;packages:integration_tests/regression
+ os:ubuntu-latest;pub-cache-hosted;sdk:dev
+ os:ubuntu-latest;pub-cache-hosted
+ os:ubuntu-latest
+ - name: Setup Dart SDK
+ uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
+ with:
+ sdk: dev
+ - id: checkout
+ name: Checkout repository
+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+ - id: integration_tests_regression_pub_upgrade
+ name: integration_tests/regression; dart pub upgrade
+ run: dart pub upgrade
+ if: "always() && steps.checkout.conclusion == 'success'"
+ working-directory: integration_tests/regression
+ - name: integration_tests/regression; dart test
+ run: dart test
+ if: "always() && steps.integration_tests_regression_pub_upgrade.conclusion == 'success'"
+ working-directory: integration_tests/regression
+ needs:
+ - job_001
+ - job_002
+ - job_003
+ - job_004
+ - job_005
+ - job_006
+ - job_007
+ - job_008
+ job_023:
+ name: "unit_test; linux; Dart dev; PKG: pkgs/checks; `dart test`"
+ runs-on: ubuntu-latest
+ steps:
+ - name: Cache Pub hosted dependencies
+ uses: actions/cache@6849a6489940f00c2f30c0fb92c6274307ccb58a
+ with:
+ path: "~/.pub-cache/hosted"
+ key: "os:ubuntu-latest;pub-cache-hosted;sdk:dev;packages:pkgs/checks;commands:command_00"
+ restore-keys: |
+ os:ubuntu-latest;pub-cache-hosted;sdk:dev;packages:pkgs/checks
+ os:ubuntu-latest;pub-cache-hosted;sdk:dev
+ os:ubuntu-latest;pub-cache-hosted
+ os:ubuntu-latest
+ - name: Setup Dart SDK
+ uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
+ with:
+ sdk: dev
+ - id: checkout
+ name: Checkout repository
+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+ - id: pkgs_checks_pub_upgrade
+ name: pkgs/checks; dart pub upgrade
+ run: dart pub upgrade
+ if: "always() && steps.checkout.conclusion == 'success'"
+ working-directory: pkgs/checks
+ - name: pkgs/checks; dart test
+ run: dart test
+ if: "always() && steps.pkgs_checks_pub_upgrade.conclusion == 'success'"
+ working-directory: pkgs/checks
+ needs:
+ - job_001
+ - job_002
+ - job_003
+ - job_004
+ - job_005
+ - job_006
+ - job_007
+ - job_008
+ job_024:
+ name: "unit_test; linux; Dart dev; PKG: pkgs/fake_async; `dart test`"
+ runs-on: ubuntu-latest
+ steps:
+ - name: Cache Pub hosted dependencies
+ uses: actions/cache@6849a6489940f00c2f30c0fb92c6274307ccb58a
+ with:
+ path: "~/.pub-cache/hosted"
+ key: "os:ubuntu-latest;pub-cache-hosted;sdk:dev;packages:pkgs/fake_async;commands:command_00"
+ restore-keys: |
+ os:ubuntu-latest;pub-cache-hosted;sdk:dev;packages:pkgs/fake_async
+ os:ubuntu-latest;pub-cache-hosted;sdk:dev
+ os:ubuntu-latest;pub-cache-hosted
+ os:ubuntu-latest
+ - name: Setup Dart SDK
+ uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
+ with:
+ sdk: dev
+ - id: checkout
+ name: Checkout repository
+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+ - id: pkgs_fake_async_pub_upgrade
+ name: pkgs/fake_async; dart pub upgrade
+ run: dart pub upgrade
+ if: "always() && steps.checkout.conclusion == 'success'"
+ working-directory: pkgs/fake_async
+ - name: pkgs/fake_async; dart test
+ run: dart test
+ if: "always() && steps.pkgs_fake_async_pub_upgrade.conclusion == 'success'"
+ working-directory: pkgs/fake_async
+ needs:
+ - job_001
+ - job_002
+ - job_003
+ - job_004
+ - job_005
+ - job_006
+ - job_007
+ - job_008
+ job_025:
+ name: "unit_test; linux; Dart dev; PKG: pkgs/matcher; `dart test`"
+ runs-on: ubuntu-latest
+ steps:
+ - name: Cache Pub hosted dependencies
+ uses: actions/cache@6849a6489940f00c2f30c0fb92c6274307ccb58a
+ with:
+ path: "~/.pub-cache/hosted"
+ key: "os:ubuntu-latest;pub-cache-hosted;sdk:dev;packages:pkgs/matcher;commands:command_00"
+ restore-keys: |
+ os:ubuntu-latest;pub-cache-hosted;sdk:dev;packages:pkgs/matcher
+ os:ubuntu-latest;pub-cache-hosted;sdk:dev
+ os:ubuntu-latest;pub-cache-hosted
+ os:ubuntu-latest
+ - name: Setup Dart SDK
+ uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
+ with:
+ sdk: dev
+ - id: checkout
+ name: Checkout repository
+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+ - id: pkgs_matcher_pub_upgrade
+ name: pkgs/matcher; dart pub upgrade
+ run: dart pub upgrade
+ if: "always() && steps.checkout.conclusion == 'success'"
+ working-directory: pkgs/matcher
+ - name: pkgs/matcher; dart test
+ run: dart test
+ if: "always() && steps.pkgs_matcher_pub_upgrade.conclusion == 'success'"
+ working-directory: pkgs/matcher
+ needs:
+ - job_001
+ - job_002
+ - job_003
+ - job_004
+ - job_005
+ - job_006
+ - job_007
+ - job_008
+ job_026:
+ name: "unit_test; linux; Dart dev; PKG: pkgs/test_core; `dart test`"
+ runs-on: ubuntu-latest
+ steps:
+ - name: Cache Pub hosted dependencies
+ uses: actions/cache@6849a6489940f00c2f30c0fb92c6274307ccb58a
+ with:
+ path: "~/.pub-cache/hosted"
+ key: "os:ubuntu-latest;pub-cache-hosted;sdk:dev;packages:pkgs/test_core;commands:command_00"
+ restore-keys: |
+ os:ubuntu-latest;pub-cache-hosted;sdk:dev;packages:pkgs/test_core
+ os:ubuntu-latest;pub-cache-hosted;sdk:dev
+ os:ubuntu-latest;pub-cache-hosted
+ os:ubuntu-latest
+ - name: Setup Dart SDK
+ uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
+ with:
+ sdk: dev
+ - id: checkout
+ name: Checkout repository
+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+ - id: pkgs_test_core_pub_upgrade
+ name: pkgs/test_core; dart pub upgrade
+ run: dart pub upgrade
+ if: "always() && steps.checkout.conclusion == 'success'"
+ working-directory: pkgs/test_core
+ - name: pkgs/test_core; dart test
+ run: dart test
+ if: "always() && steps.pkgs_test_core_pub_upgrade.conclusion == 'success'"
+ working-directory: pkgs/test_core
+ needs:
+ - job_001
+ - job_002
+ - job_003
+ - job_004
+ - job_005
+ - job_006
+ - job_007
+ - job_008
+ job_027:
+ name: "unit_test; linux; Dart dev; PKG: integration_tests/spawn_hybrid; `dart test -p chrome,vm,node`"
+ runs-on: ubuntu-latest
+ steps:
+ - name: Cache Pub hosted dependencies
+ uses: actions/cache@6849a6489940f00c2f30c0fb92c6274307ccb58a
+ with:
+ path: "~/.pub-cache/hosted"
+ key: "os:ubuntu-latest;pub-cache-hosted;sdk:dev;packages:integration_tests/spawn_hybrid;commands:test_1"
+ restore-keys: |
+ os:ubuntu-latest;pub-cache-hosted;sdk:dev;packages:integration_tests/spawn_hybrid
+ os:ubuntu-latest;pub-cache-hosted;sdk:dev
+ os:ubuntu-latest;pub-cache-hosted
+ os:ubuntu-latest
+ - name: Setup Dart SDK
+ uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
+ with:
+ sdk: dev
+ - id: checkout
+ name: Checkout repository
+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+ - id: integration_tests_spawn_hybrid_pub_upgrade
+ name: integration_tests/spawn_hybrid; dart pub upgrade
+ run: dart pub upgrade
+ if: "always() && steps.checkout.conclusion == 'success'"
+ working-directory: integration_tests/spawn_hybrid
+ - name: "integration_tests/spawn_hybrid; dart test -p chrome,vm,node"
+ run: "dart test -p chrome,vm,node"
+ if: "always() && steps.integration_tests_spawn_hybrid_pub_upgrade.conclusion == 'success'"
+ working-directory: integration_tests/spawn_hybrid
+ needs:
+ - job_001
+ - job_002
+ - job_003
+ - job_004
+ - job_005
+ - job_006
+ - job_007
+ - job_008
+ job_028:
+ name: "unit_test; linux; Dart dev; PKG: integration_tests/wasm; `dart test --timeout=60s`"
+ runs-on: ubuntu-latest
+ steps:
+ - name: Cache Pub hosted dependencies
+ uses: actions/cache@6849a6489940f00c2f30c0fb92c6274307ccb58a
+ with:
+ path: "~/.pub-cache/hosted"
+ key: "os:ubuntu-latest;pub-cache-hosted;sdk:dev;packages:integration_tests/wasm;commands:test_2"
+ restore-keys: |
+ os:ubuntu-latest;pub-cache-hosted;sdk:dev;packages:integration_tests/wasm
+ os:ubuntu-latest;pub-cache-hosted;sdk:dev
+ os:ubuntu-latest;pub-cache-hosted
+ os:ubuntu-latest
+ - name: Setup Dart SDK
+ uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
+ with:
+ sdk: dev
+ - id: checkout
+ name: Checkout repository
+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+ - id: integration_tests_wasm_pub_upgrade
+ name: integration_tests/wasm; dart pub upgrade
+ run: dart pub upgrade
+ if: "always() && steps.checkout.conclusion == 'success'"
+ working-directory: integration_tests/wasm
+ - name: "integration_tests/wasm; dart test --timeout=60s"
+ run: "dart test --timeout=60s"
+ if: "always() && steps.integration_tests_wasm_pub_upgrade.conclusion == 'success'"
+ working-directory: integration_tests/wasm
+ needs:
+ - job_001
+ - job_002
+ - job_003
+ - job_004
+ - job_005
+ - job_006
+ - job_007
+ - job_008
+ job_029:
+ name: "unit_test; linux; Dart dev; PKG: pkgs/test; `xvfb-run -s \"-screen 0 1024x768x24\" dart test --preset travis --total-shards 5 --shard-index 0`"
+ runs-on: ubuntu-latest
+ steps:
+ - name: Cache Pub hosted dependencies
+ uses: actions/cache@6849a6489940f00c2f30c0fb92c6274307ccb58a
+ with:
+ path: "~/.pub-cache/hosted"
+ key: "os:ubuntu-latest;pub-cache-hosted;sdk:dev;packages:pkgs/test;commands:command_01"
+ restore-keys: |
+ os:ubuntu-latest;pub-cache-hosted;sdk:dev;packages:pkgs/test
+ os:ubuntu-latest;pub-cache-hosted;sdk:dev
+ os:ubuntu-latest;pub-cache-hosted
+ os:ubuntu-latest
+ - name: Setup Dart SDK
+ uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
+ with:
+ sdk: dev
+ - id: checkout
+ name: Checkout repository
+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+ - id: pkgs_test_pub_upgrade
+ name: pkgs/test; dart pub upgrade
+ run: dart pub upgrade
+ if: "always() && steps.checkout.conclusion == 'success'"
+ working-directory: pkgs/test
+ - name: "pkgs/test; xvfb-run -s \"-screen 0 1024x768x24\" dart test --preset travis --total-shards 5 --shard-index 0"
+ run: "xvfb-run -s \"-screen 0 1024x768x24\" dart test --preset travis --total-shards 5 --shard-index 0"
+ if: "always() && steps.pkgs_test_pub_upgrade.conclusion == 'success'"
+ working-directory: pkgs/test
+ needs:
+ - job_001
+ - job_002
+ - job_003
+ - job_004
+ - job_005
+ - job_006
+ - job_007
+ - job_008
+ job_030:
+ name: "unit_test; linux; Dart dev; PKG: pkgs/test; `xvfb-run -s \"-screen 0 1024x768x24\" dart test --preset travis --total-shards 5 --shard-index 1`"
+ runs-on: ubuntu-latest
+ steps:
+ - name: Cache Pub hosted dependencies
+ uses: actions/cache@6849a6489940f00c2f30c0fb92c6274307ccb58a
+ with:
+ path: "~/.pub-cache/hosted"
+ key: "os:ubuntu-latest;pub-cache-hosted;sdk:dev;packages:pkgs/test;commands:command_02"
+ restore-keys: |
+ os:ubuntu-latest;pub-cache-hosted;sdk:dev;packages:pkgs/test
+ os:ubuntu-latest;pub-cache-hosted;sdk:dev
+ os:ubuntu-latest;pub-cache-hosted
+ os:ubuntu-latest
+ - name: Setup Dart SDK
+ uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
+ with:
+ sdk: dev
+ - id: checkout
+ name: Checkout repository
+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+ - id: pkgs_test_pub_upgrade
+ name: pkgs/test; dart pub upgrade
+ run: dart pub upgrade
+ if: "always() && steps.checkout.conclusion == 'success'"
+ working-directory: pkgs/test
+ - name: "pkgs/test; xvfb-run -s \"-screen 0 1024x768x24\" dart test --preset travis --total-shards 5 --shard-index 1"
+ run: "xvfb-run -s \"-screen 0 1024x768x24\" dart test --preset travis --total-shards 5 --shard-index 1"
+ if: "always() && steps.pkgs_test_pub_upgrade.conclusion == 'success'"
+ working-directory: pkgs/test
+ needs:
+ - job_001
+ - job_002
+ - job_003
+ - job_004
+ - job_005
+ - job_006
+ - job_007
+ - job_008
+ job_031:
+ name: "unit_test; linux; Dart dev; PKG: pkgs/test; `xvfb-run -s \"-screen 0 1024x768x24\" dart test --preset travis --total-shards 5 --shard-index 2`"
+ runs-on: ubuntu-latest
+ steps:
+ - name: Cache Pub hosted dependencies
+ uses: actions/cache@6849a6489940f00c2f30c0fb92c6274307ccb58a
+ with:
+ path: "~/.pub-cache/hosted"
+ key: "os:ubuntu-latest;pub-cache-hosted;sdk:dev;packages:pkgs/test;commands:command_03"
+ restore-keys: |
+ os:ubuntu-latest;pub-cache-hosted;sdk:dev;packages:pkgs/test
+ os:ubuntu-latest;pub-cache-hosted;sdk:dev
+ os:ubuntu-latest;pub-cache-hosted
+ os:ubuntu-latest
+ - name: Setup Dart SDK
+ uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
+ with:
+ sdk: dev
+ - id: checkout
+ name: Checkout repository
+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+ - id: pkgs_test_pub_upgrade
+ name: pkgs/test; dart pub upgrade
+ run: dart pub upgrade
+ if: "always() && steps.checkout.conclusion == 'success'"
+ working-directory: pkgs/test
+ - name: "pkgs/test; xvfb-run -s \"-screen 0 1024x768x24\" dart test --preset travis --total-shards 5 --shard-index 2"
+ run: "xvfb-run -s \"-screen 0 1024x768x24\" dart test --preset travis --total-shards 5 --shard-index 2"
+ if: "always() && steps.pkgs_test_pub_upgrade.conclusion == 'success'"
+ working-directory: pkgs/test
+ needs:
+ - job_001
+ - job_002
+ - job_003
+ - job_004
+ - job_005
+ - job_006
+ - job_007
+ - job_008
+ job_032:
+ name: "unit_test; linux; Dart dev; PKG: pkgs/test; `xvfb-run -s \"-screen 0 1024x768x24\" dart test --preset travis --total-shards 5 --shard-index 3`"
+ runs-on: ubuntu-latest
+ steps:
+ - name: Cache Pub hosted dependencies
+ uses: actions/cache@6849a6489940f00c2f30c0fb92c6274307ccb58a
+ with:
+ path: "~/.pub-cache/hosted"
+ key: "os:ubuntu-latest;pub-cache-hosted;sdk:dev;packages:pkgs/test;commands:command_04"
+ restore-keys: |
+ os:ubuntu-latest;pub-cache-hosted;sdk:dev;packages:pkgs/test
+ os:ubuntu-latest;pub-cache-hosted;sdk:dev
+ os:ubuntu-latest;pub-cache-hosted
+ os:ubuntu-latest
+ - name: Setup Dart SDK
+ uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
+ with:
+ sdk: dev
+ - id: checkout
+ name: Checkout repository
+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+ - id: pkgs_test_pub_upgrade
+ name: pkgs/test; dart pub upgrade
+ run: dart pub upgrade
+ if: "always() && steps.checkout.conclusion == 'success'"
+ working-directory: pkgs/test
+ - name: "pkgs/test; xvfb-run -s \"-screen 0 1024x768x24\" dart test --preset travis --total-shards 5 --shard-index 3"
+ run: "xvfb-run -s \"-screen 0 1024x768x24\" dart test --preset travis --total-shards 5 --shard-index 3"
+ if: "always() && steps.pkgs_test_pub_upgrade.conclusion == 'success'"
+ working-directory: pkgs/test
+ needs:
+ - job_001
+ - job_002
+ - job_003
+ - job_004
+ - job_005
+ - job_006
+ - job_007
+ - job_008
+ job_033:
+ name: "unit_test; linux; Dart dev; PKG: pkgs/test; `xvfb-run -s \"-screen 0 1024x768x24\" dart test --preset travis --total-shards 5 --shard-index 4`"
+ runs-on: ubuntu-latest
+ steps:
+ - name: Cache Pub hosted dependencies
+ uses: actions/cache@6849a6489940f00c2f30c0fb92c6274307ccb58a
+ with:
+ path: "~/.pub-cache/hosted"
+ key: "os:ubuntu-latest;pub-cache-hosted;sdk:dev;packages:pkgs/test;commands:command_05"
+ restore-keys: |
+ os:ubuntu-latest;pub-cache-hosted;sdk:dev;packages:pkgs/test
+ os:ubuntu-latest;pub-cache-hosted;sdk:dev
+ os:ubuntu-latest;pub-cache-hosted
+ os:ubuntu-latest
+ - name: Setup Dart SDK
+ uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
+ with:
+ sdk: dev
+ - id: checkout
+ name: Checkout repository
+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+ - id: pkgs_test_pub_upgrade
+ name: pkgs/test; dart pub upgrade
+ run: dart pub upgrade
+ if: "always() && steps.checkout.conclusion == 'success'"
+ working-directory: pkgs/test
+ - name: "pkgs/test; xvfb-run -s \"-screen 0 1024x768x24\" dart test --preset travis --total-shards 5 --shard-index 4"
+ run: "xvfb-run -s \"-screen 0 1024x768x24\" dart test --preset travis --total-shards 5 --shard-index 4"
+ if: "always() && steps.pkgs_test_pub_upgrade.conclusion == 'success'"
+ working-directory: pkgs/test
+ needs:
+ - job_001
+ - job_002
+ - job_003
+ - job_004
+ - job_005
+ - job_006
+ - job_007
+ - job_008
+ job_034:
+ name: "unit_test; linux; Dart dev; PKG: pkgs/test_api; `dart test --preset travis -x browser`"
+ runs-on: ubuntu-latest
+ steps:
+ - name: Cache Pub hosted dependencies
+ uses: actions/cache@6849a6489940f00c2f30c0fb92c6274307ccb58a
+ with:
+ path: "~/.pub-cache/hosted"
+ key: "os:ubuntu-latest;pub-cache-hosted;sdk:dev;packages:pkgs/test_api;commands:command_11"
+ restore-keys: |
+ os:ubuntu-latest;pub-cache-hosted;sdk:dev;packages:pkgs/test_api
+ os:ubuntu-latest;pub-cache-hosted;sdk:dev
+ os:ubuntu-latest;pub-cache-hosted
+ os:ubuntu-latest
+ - name: Setup Dart SDK
+ uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
+ with:
+ sdk: dev
+ - id: checkout
+ name: Checkout repository
+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+ - id: pkgs_test_api_pub_upgrade
+ name: pkgs/test_api; dart pub upgrade
+ run: dart pub upgrade
+ if: "always() && steps.checkout.conclusion == 'success'"
+ working-directory: pkgs/test_api
+ - name: "pkgs/test_api; dart test --preset travis -x browser"
+ run: dart test --preset travis -x browser
+ if: "always() && steps.pkgs_test_api_pub_upgrade.conclusion == 'success'"
+ working-directory: pkgs/test_api
+ needs:
+ - job_001
+ - job_002
+ - job_003
+ - job_004
+ - job_005
+ - job_006
+ - job_007
+ - job_008
+ job_035:
+ name: "unit_test; osx; Dart 3.5.0; PKG: pkgs/test; `dart test --preset travis --total-shards 5 --shard-index 0`"
+ runs-on: macos-latest
+ steps:
+ - name: Cache Pub hosted dependencies
+ uses: actions/cache@6849a6489940f00c2f30c0fb92c6274307ccb58a
+ with:
+ path: "~/.pub-cache/hosted"
+ key: "os:macos-latest;pub-cache-hosted;sdk:3.5.0;packages:pkgs/test;commands:command_06"
+ restore-keys: |
+ os:macos-latest;pub-cache-hosted;sdk:3.5.0;packages:pkgs/test
+ os:macos-latest;pub-cache-hosted;sdk:3.5.0
+ os:macos-latest;pub-cache-hosted
+ os:macos-latest
+ - name: Setup Dart SDK
+ uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
+ with:
+ sdk: "3.5.0"
+ - id: checkout
+ name: Checkout repository
+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+ - id: pkgs_test_pub_upgrade
+ name: pkgs/test; dart pub upgrade
+ run: dart pub upgrade
+ if: "always() && steps.checkout.conclusion == 'success'"
+ working-directory: pkgs/test
+ - name: "pkgs/test; dart test --preset travis --total-shards 5 --shard-index 0"
+ run: dart test --preset travis --total-shards 5 --shard-index 0
+ if: "always() && steps.pkgs_test_pub_upgrade.conclusion == 'success'"
+ working-directory: pkgs/test
+ needs:
+ - job_001
+ - job_002
+ - job_003
+ - job_004
+ - job_005
+ - job_006
+ - job_007
+ - job_008
+ job_036:
+ name: "unit_test; osx; Dart 3.5.0; PKG: pkgs/test; `dart test --preset travis --total-shards 5 --shard-index 1`"
+ runs-on: macos-latest
+ steps:
+ - name: Cache Pub hosted dependencies
+ uses: actions/cache@6849a6489940f00c2f30c0fb92c6274307ccb58a
+ with:
+ path: "~/.pub-cache/hosted"
+ key: "os:macos-latest;pub-cache-hosted;sdk:3.5.0;packages:pkgs/test;commands:command_07"
+ restore-keys: |
+ os:macos-latest;pub-cache-hosted;sdk:3.5.0;packages:pkgs/test
+ os:macos-latest;pub-cache-hosted;sdk:3.5.0
+ os:macos-latest;pub-cache-hosted
+ os:macos-latest
+ - name: Setup Dart SDK
+ uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
+ with:
+ sdk: "3.5.0"
+ - id: checkout
+ name: Checkout repository
+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+ - id: pkgs_test_pub_upgrade
+ name: pkgs/test; dart pub upgrade
+ run: dart pub upgrade
+ if: "always() && steps.checkout.conclusion == 'success'"
+ working-directory: pkgs/test
+ - name: "pkgs/test; dart test --preset travis --total-shards 5 --shard-index 1"
+ run: dart test --preset travis --total-shards 5 --shard-index 1
+ if: "always() && steps.pkgs_test_pub_upgrade.conclusion == 'success'"
+ working-directory: pkgs/test
+ needs:
+ - job_001
+ - job_002
+ - job_003
+ - job_004
+ - job_005
+ - job_006
+ - job_007
+ - job_008
+ job_037:
+ name: "unit_test; osx; Dart 3.5.0; PKG: pkgs/test; `dart test --preset travis --total-shards 5 --shard-index 2`"
+ runs-on: macos-latest
+ steps:
+ - name: Cache Pub hosted dependencies
+ uses: actions/cache@6849a6489940f00c2f30c0fb92c6274307ccb58a
+ with:
+ path: "~/.pub-cache/hosted"
+ key: "os:macos-latest;pub-cache-hosted;sdk:3.5.0;packages:pkgs/test;commands:command_08"
+ restore-keys: |
+ os:macos-latest;pub-cache-hosted;sdk:3.5.0;packages:pkgs/test
+ os:macos-latest;pub-cache-hosted;sdk:3.5.0
+ os:macos-latest;pub-cache-hosted
+ os:macos-latest
+ - name: Setup Dart SDK
+ uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
+ with:
+ sdk: "3.5.0"
+ - id: checkout
+ name: Checkout repository
+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+ - id: pkgs_test_pub_upgrade
+ name: pkgs/test; dart pub upgrade
+ run: dart pub upgrade
+ if: "always() && steps.checkout.conclusion == 'success'"
+ working-directory: pkgs/test
+ - name: "pkgs/test; dart test --preset travis --total-shards 5 --shard-index 2"
+ run: dart test --preset travis --total-shards 5 --shard-index 2
+ if: "always() && steps.pkgs_test_pub_upgrade.conclusion == 'success'"
+ working-directory: pkgs/test
+ needs:
+ - job_001
+ - job_002
+ - job_003
+ - job_004
+ - job_005
+ - job_006
+ - job_007
+ - job_008
+ job_038:
+ name: "unit_test; osx; Dart 3.5.0; PKG: pkgs/test; `dart test --preset travis --total-shards 5 --shard-index 3`"
+ runs-on: macos-latest
+ steps:
+ - name: Cache Pub hosted dependencies
+ uses: actions/cache@6849a6489940f00c2f30c0fb92c6274307ccb58a
+ with:
+ path: "~/.pub-cache/hosted"
+ key: "os:macos-latest;pub-cache-hosted;sdk:3.5.0;packages:pkgs/test;commands:command_09"
+ restore-keys: |
+ os:macos-latest;pub-cache-hosted;sdk:3.5.0;packages:pkgs/test
+ os:macos-latest;pub-cache-hosted;sdk:3.5.0
+ os:macos-latest;pub-cache-hosted
+ os:macos-latest
+ - name: Setup Dart SDK
+ uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
+ with:
+ sdk: "3.5.0"
+ - id: checkout
+ name: Checkout repository
+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+ - id: pkgs_test_pub_upgrade
+ name: pkgs/test; dart pub upgrade
+ run: dart pub upgrade
+ if: "always() && steps.checkout.conclusion == 'success'"
+ working-directory: pkgs/test
+ - name: "pkgs/test; dart test --preset travis --total-shards 5 --shard-index 3"
+ run: dart test --preset travis --total-shards 5 --shard-index 3
+ if: "always() && steps.pkgs_test_pub_upgrade.conclusion == 'success'"
+ working-directory: pkgs/test
+ needs:
+ - job_001
+ - job_002
+ - job_003
+ - job_004
+ - job_005
+ - job_006
+ - job_007
+ - job_008
+ job_039:
+ name: "unit_test; osx; Dart 3.5.0; PKG: pkgs/test; `dart test --preset travis --total-shards 5 --shard-index 4`"
+ runs-on: macos-latest
+ steps:
+ - name: Cache Pub hosted dependencies
+ uses: actions/cache@6849a6489940f00c2f30c0fb92c6274307ccb58a
+ with:
+ path: "~/.pub-cache/hosted"
+ key: "os:macos-latest;pub-cache-hosted;sdk:3.5.0;packages:pkgs/test;commands:command_10"
+ restore-keys: |
+ os:macos-latest;pub-cache-hosted;sdk:3.5.0;packages:pkgs/test
+ os:macos-latest;pub-cache-hosted;sdk:3.5.0
+ os:macos-latest;pub-cache-hosted
+ os:macos-latest
+ - name: Setup Dart SDK
+ uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
+ with:
+ sdk: "3.5.0"
+ - id: checkout
+ name: Checkout repository
+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+ - id: pkgs_test_pub_upgrade
+ name: pkgs/test; dart pub upgrade
+ run: dart pub upgrade
+ if: "always() && steps.checkout.conclusion == 'success'"
+ working-directory: pkgs/test
+ - name: "pkgs/test; dart test --preset travis --total-shards 5 --shard-index 4"
+ run: dart test --preset travis --total-shards 5 --shard-index 4
+ if: "always() && steps.pkgs_test_pub_upgrade.conclusion == 'success'"
+ working-directory: pkgs/test
+ needs:
+ - job_001
+ - job_002
+ - job_003
+ - job_004
+ - job_005
+ - job_006
+ - job_007
+ - job_008
+ job_040:
+ name: "unit_test; windows; Dart 3.5.0; PKG: integration_tests/spawn_hybrid; `dart test -p chrome,vm,node`"
+ runs-on: windows-latest
+ steps:
+ - name: Setup Dart SDK
+ uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
+ with:
+ sdk: "3.5.0"
+ - id: checkout
+ name: Checkout repository
+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+ - id: integration_tests_spawn_hybrid_pub_upgrade
+ name: integration_tests/spawn_hybrid; dart pub upgrade
+ run: dart pub upgrade
+ if: "always() && steps.checkout.conclusion == 'success'"
+ working-directory: integration_tests/spawn_hybrid
+ - name: "integration_tests/spawn_hybrid; dart test -p chrome,vm,node"
+ run: "dart test -p chrome,vm,node"
+ if: "always() && steps.integration_tests_spawn_hybrid_pub_upgrade.conclusion == 'success'"
+ working-directory: integration_tests/spawn_hybrid
+ needs:
+ - job_001
+ - job_002
+ - job_003
+ - job_004
+ - job_005
+ - job_006
+ - job_007
+ - job_008
+ job_041:
+ name: "unit_test; windows; Dart 3.5.0; PKG: integration_tests/wasm; `dart test --timeout=60s`"
+ runs-on: windows-latest
+ steps:
+ - name: Setup Dart SDK
+ uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
+ with:
+ sdk: "3.5.0"
+ - id: checkout
+ name: Checkout repository
+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+ - id: integration_tests_wasm_pub_upgrade
+ name: integration_tests/wasm; dart pub upgrade
+ run: dart pub upgrade
+ if: "always() && steps.checkout.conclusion == 'success'"
+ working-directory: integration_tests/wasm
+ - name: "integration_tests/wasm; dart test --timeout=60s"
+ run: "dart test --timeout=60s"
+ if: "always() && steps.integration_tests_wasm_pub_upgrade.conclusion == 'success'"
+ working-directory: integration_tests/wasm
+ needs:
+ - job_001
+ - job_002
+ - job_003
+ - job_004
+ - job_005
+ - job_006
+ - job_007
+ - job_008
+ job_042:
+ name: "unit_test; windows; Dart 3.5.0; PKG: pkgs/test; `dart test --preset travis --total-shards 5 --shard-index 0`"
+ runs-on: windows-latest
+ steps:
+ - name: Setup Dart SDK
+ uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
+ with:
+ sdk: "3.5.0"
+ - id: checkout
+ name: Checkout repository
+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+ - id: pkgs_test_pub_upgrade
+ name: pkgs/test; dart pub upgrade
+ run: dart pub upgrade
+ if: "always() && steps.checkout.conclusion == 'success'"
+ working-directory: pkgs/test
+ - name: "pkgs/test; dart test --preset travis --total-shards 5 --shard-index 0"
+ run: dart test --preset travis --total-shards 5 --shard-index 0
+ if: "always() && steps.pkgs_test_pub_upgrade.conclusion == 'success'"
+ working-directory: pkgs/test
+ needs:
+ - job_001
+ - job_002
+ - job_003
+ - job_004
+ - job_005
+ - job_006
+ - job_007
+ - job_008
+ job_043:
+ name: "unit_test; windows; Dart 3.5.0; PKG: pkgs/test; `dart test --preset travis --total-shards 5 --shard-index 1`"
+ runs-on: windows-latest
+ steps:
+ - name: Setup Dart SDK
+ uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
+ with:
+ sdk: "3.5.0"
+ - id: checkout
+ name: Checkout repository
+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+ - id: pkgs_test_pub_upgrade
+ name: pkgs/test; dart pub upgrade
+ run: dart pub upgrade
+ if: "always() && steps.checkout.conclusion == 'success'"
+ working-directory: pkgs/test
+ - name: "pkgs/test; dart test --preset travis --total-shards 5 --shard-index 1"
+ run: dart test --preset travis --total-shards 5 --shard-index 1
+ if: "always() && steps.pkgs_test_pub_upgrade.conclusion == 'success'"
+ working-directory: pkgs/test
+ needs:
+ - job_001
+ - job_002
+ - job_003
+ - job_004
+ - job_005
+ - job_006
+ - job_007
+ - job_008
+ job_044:
+ name: "unit_test; windows; Dart 3.5.0; PKG: pkgs/test; `dart test --preset travis --total-shards 5 --shard-index 2`"
+ runs-on: windows-latest
+ steps:
+ - name: Setup Dart SDK
+ uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
+ with:
+ sdk: "3.5.0"
+ - id: checkout
+ name: Checkout repository
+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+ - id: pkgs_test_pub_upgrade
+ name: pkgs/test; dart pub upgrade
+ run: dart pub upgrade
+ if: "always() && steps.checkout.conclusion == 'success'"
+ working-directory: pkgs/test
+ - name: "pkgs/test; dart test --preset travis --total-shards 5 --shard-index 2"
+ run: dart test --preset travis --total-shards 5 --shard-index 2
+ if: "always() && steps.pkgs_test_pub_upgrade.conclusion == 'success'"
+ working-directory: pkgs/test
+ needs:
+ - job_001
+ - job_002
+ - job_003
+ - job_004
+ - job_005
+ - job_006
+ - job_007
+ - job_008
+ job_045:
+ name: "unit_test; windows; Dart 3.5.0; PKG: pkgs/test; `dart test --preset travis --total-shards 5 --shard-index 3`"
+ runs-on: windows-latest
+ steps:
+ - name: Setup Dart SDK
+ uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
+ with:
+ sdk: "3.5.0"
+ - id: checkout
+ name: Checkout repository
+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+ - id: pkgs_test_pub_upgrade
+ name: pkgs/test; dart pub upgrade
+ run: dart pub upgrade
+ if: "always() && steps.checkout.conclusion == 'success'"
+ working-directory: pkgs/test
+ - name: "pkgs/test; dart test --preset travis --total-shards 5 --shard-index 3"
+ run: dart test --preset travis --total-shards 5 --shard-index 3
+ if: "always() && steps.pkgs_test_pub_upgrade.conclusion == 'success'"
+ working-directory: pkgs/test
+ needs:
+ - job_001
+ - job_002
+ - job_003
+ - job_004
+ - job_005
+ - job_006
+ - job_007
+ - job_008
+ job_046:
+ name: "unit_test; windows; Dart 3.5.0; PKG: pkgs/test; `dart test --preset travis --total-shards 5 --shard-index 4`"
+ runs-on: windows-latest
+ steps:
+ - name: Setup Dart SDK
+ uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
+ with:
+ sdk: "3.5.0"
+ - id: checkout
+ name: Checkout repository
+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+ - id: pkgs_test_pub_upgrade
+ name: pkgs/test; dart pub upgrade
+ run: dart pub upgrade
+ if: "always() && steps.checkout.conclusion == 'success'"
+ working-directory: pkgs/test
+ - name: "pkgs/test; dart test --preset travis --total-shards 5 --shard-index 4"
+ run: dart test --preset travis --total-shards 5 --shard-index 4
+ if: "always() && steps.pkgs_test_pub_upgrade.conclusion == 'success'"
+ working-directory: pkgs/test
+ needs:
+ - job_001
+ - job_002
+ - job_003
+ - job_004
+ - job_005
+ - job_006
+ - job_007
+ - job_008
+ job_047:
+ name: "unit_test; windows; Dart dev; PKG: integration_tests/spawn_hybrid; `dart test -p chrome,vm,node`"
+ runs-on: windows-latest
+ steps:
+ - name: Setup Dart SDK
+ uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
+ with:
+ sdk: dev
+ - id: checkout
+ name: Checkout repository
+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+ - id: integration_tests_spawn_hybrid_pub_upgrade
+ name: integration_tests/spawn_hybrid; dart pub upgrade
+ run: dart pub upgrade
+ if: "always() && steps.checkout.conclusion == 'success'"
+ working-directory: integration_tests/spawn_hybrid
+ - name: "integration_tests/spawn_hybrid; dart test -p chrome,vm,node"
+ run: "dart test -p chrome,vm,node"
+ if: "always() && steps.integration_tests_spawn_hybrid_pub_upgrade.conclusion == 'success'"
+ working-directory: integration_tests/spawn_hybrid
+ needs:
+ - job_001
+ - job_002
+ - job_003
+ - job_004
+ - job_005
+ - job_006
+ - job_007
+ - job_008
+ job_048:
+ name: "unit_test; windows; Dart dev; PKG: integration_tests/wasm; `dart test --timeout=60s`"
+ runs-on: windows-latest
+ steps:
+ - name: Setup Dart SDK
+ uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
+ with:
+ sdk: dev
+ - id: checkout
+ name: Checkout repository
+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+ - id: integration_tests_wasm_pub_upgrade
+ name: integration_tests/wasm; dart pub upgrade
+ run: dart pub upgrade
+ if: "always() && steps.checkout.conclusion == 'success'"
+ working-directory: integration_tests/wasm
+ - name: "integration_tests/wasm; dart test --timeout=60s"
+ run: "dart test --timeout=60s"
+ if: "always() && steps.integration_tests_wasm_pub_upgrade.conclusion == 'success'"
+ working-directory: integration_tests/wasm
+ needs:
+ - job_001
+ - job_002
+ - job_003
+ - job_004
+ - job_005
+ - job_006
+ - job_007
+ - job_008
+ job_049:
+ name: Notify failure
+ runs-on: ubuntu-latest
+ if: "(github.event_name == 'push' || github.event_name == 'schedule') && failure()"
+ steps:
+ - run: |
+ curl -H "Content-Type: application/json" -X POST -d \
+ "{'text':'Build failed! ${GITHUB_SERVER_URL}/${GITHUB_REPOSITORY}/actions/runs/${GITHUB_RUN_ID}'}" \
+ "${CHAT_WEBHOOK_URL}"
+ env:
+ CHAT_WEBHOOK_URL: "${{ secrets.BUILD_AND_TEST_TEAM_CHAT_WEBHOOK_URL }}"
+ needs:
+ - job_001
+ - job_002
+ - job_003
+ - job_004
+ - job_005
+ - job_006
+ - job_007
+ - job_008
+ - job_009
+ - job_010
+ - job_011
+ - job_012
+ - job_013
+ - job_014
+ - job_015
+ - job_016
+ - job_017
+ - job_018
+ - job_019
+ - job_020
+ - job_021
+ - job_022
+ - job_023
+ - job_024
+ - job_025
+ - job_026
+ - job_027
+ - job_028
+ - job_029
+ - job_030
+ - job_031
+ - job_032
+ - job_033
+ - job_034
+ - job_035
+ - job_036
+ - job_037
+ - job_038
+ - job_039
+ - job_040
+ - job_041
+ - job_042
+ - job_043
+ - job_044
+ - job_045
+ - job_046
+ - job_047
+ - job_048
diff --git a/.github/workflows/health.yaml b/.github/workflows/health.yaml
new file mode 100644
index 0000000..1656c16
--- /dev/null
+++ b/.github/workflows/health.yaml
@@ -0,0 +1,12 @@
+name: Health
+on:
+ pull_request:
+ branches: [ main, master ]
+ types: [opened, synchronize, reopened, labeled, unlabeled]
+jobs:
+ health:
+ uses: dart-lang/ecosystem/.github/workflows/health.yaml@main
+ with:
+ checks: "version,changelog,do-not-submit"
+ permissions:
+ pull-requests: write
diff --git a/.github/workflows/no-response.yml b/.github/workflows/no-response.yml
new file mode 100644
index 0000000..1a6f2ec
--- /dev/null
+++ b/.github/workflows/no-response.yml
@@ -0,0 +1,35 @@
+# A workflow to close issues where the author hasn't responded to a request for
+# more information; see https://github.com/actions/stale.
+
+name: No Response
+
+# Run as a daily cron.
+on:
+ schedule:
+ # Every day at 8am
+ - cron: '0 8 * * *'
+
+# All permissions not specified are set to 'none'.
+permissions:
+ issues: write
+ pull-requests: write
+
+jobs:
+ no-response:
+ runs-on: ubuntu-latest
+ if: ${{ github.repository_owner == 'dart-lang' }}
+ steps:
+ - uses: actions/stale@28ca1036281a5e5922ead5184a1bbf96e5fc984e
+ with:
+ days-before-stale: -1
+ days-before-close: 14
+ stale-issue-label: "needs-info"
+ close-issue-message: >
+ Without additional information we're not able to resolve this issue.
+ Feel free to add more info or respond to any questions above and we
+ can reopen the case. Thanks for your contribution!
+ stale-pr-label: "needs-info"
+ close-pr-message: >
+ Without additional information we're not able to resolve this PR.
+ Feel free to add more info or respond to any questions above.
+ Thanks for your contribution!
diff --git a/.github/workflows/post_summaries.yaml b/.github/workflows/post_summaries.yaml
new file mode 100644
index 0000000..9be7d5d
--- /dev/null
+++ b/.github/workflows/post_summaries.yaml
@@ -0,0 +1,18 @@
+name: Comment on the pull request
+
+on:
+ # Trigger this workflow after the Health workflow completes. This workflow
+ # will have permissions to do things like create comments on the PR, even if
+ # the original workflow couldn't.
+ workflow_run:
+ workflows:
+ - Health
+ - Publish
+ types:
+ - completed
+
+jobs:
+ upload:
+ uses: dart-lang/ecosystem/.github/workflows/post_summaries.yaml@main
+ permissions:
+ pull-requests: write
diff --git a/.github/workflows/publish.yaml b/.github/workflows/publish.yaml
new file mode 100644
index 0000000..7d6442c
--- /dev/null
+++ b/.github/workflows/publish.yaml
@@ -0,0 +1,17 @@
+# A CI configuration to auto-publish pub packages.
+
+name: Publish
+
+on:
+ pull_request:
+ branches: [ master ]
+ types: [opened, synchronize, reopened, labeled, unlabeled]
+ push:
+ tags: [ '[A-z]+-v[0-9]+.[0-9]+.[0-9]+*' ]
+
+jobs:
+ publish:
+ if: ${{ github.repository_owner == 'dart-lang' }}
+ uses: dart-lang/ecosystem/.github/workflows/publish.yaml@main
+ with:
+ write-comments: false
diff --git a/.github/workflows/scorecards-analysis.yml b/.github/workflows/scorecards-analysis.yml
new file mode 100644
index 0000000..3c5c10a
--- /dev/null
+++ b/.github/workflows/scorecards-analysis.yml
@@ -0,0 +1,55 @@
+name: Scorecards supply-chain security
+on:
+ # Only the default branch is supported.
+ branch_protection_rule:
+ push:
+ branches: [ master ]
+
+# Declare default permissions as read only.
+permissions: read-all
+
+jobs:
+ analysis:
+ name: Scorecards analysis
+ runs-on: ubuntu-latest
+ permissions:
+ # Needed to upload the results to code-scanning dashboard.
+ security-events: write
+ actions: read
+ contents: read
+ # Needed to access OIDC token.
+ id-token: write
+
+ steps:
+ - name: "Checkout code"
+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+ with:
+ persist-credentials: false
+
+ - name: "Run analysis"
+ uses: ossf/scorecard-action@62b2cac7ed8198b15735ed49ab1e5cf35480ba46
+ with:
+ results_file: results.sarif
+ results_format: sarif
+ # Read-only PAT token. To create it,
+ # follow the steps in https://github.com/ossf/scorecard-action#pat-token-creation.
+ repo_token: ${{ secrets.SCORECARD_READ_TOKEN }}
+ # Publish the results to enable scorecard badges. For more details, see
+ # https://github.com/ossf/scorecard-action#publishing-results.
+ # For private repositories, `publish_results` will automatically be set to `false`,
+ # regardless of the value entered here.
+ publish_results: true
+
+ # Upload the results as artifacts (optional).
+ - name: "Upload artifact"
+ uses: actions/upload-artifact@b4b15b8c7c6ac21ea08fcf65892d2ee8f75cf882
+ with:
+ name: SARIF file
+ path: results.sarif
+ retention-days: 5
+
+ # Upload the results to GitHub's code scanning dashboard.
+ - name: "Upload to code-scanning"
+ uses: github/codeql-action/upload-sarif@f09c1c0a94de965c15400f5634aa42fac8fb8f88 # v3.27.5
+ with:
+ sarif_file: results.sarif
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..56c3800
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,13 @@
+# Don’t commit the following directories created by pub.
+.buildlog
+.dart_tool/
+.pub/
+build/
+packages
+
+# Include when developing application packages.
+pubspec.lock
+.packages
+
+# Ignore common coverage directory
+coverage/
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
new file mode 100644
index 0000000..90003c0
--- /dev/null
+++ b/CONTRIBUTING.md
@@ -0,0 +1,74 @@
+Want to contribute? Great! First, read this page (including the small print at
+the end).
+
+### Before you contribute
+
+Before we can use your code, you must sign the
+[Google Individual Contributor License Agreement][CLA] (CLA), which you can do
+online. The CLA is necessary mainly because you own the copyright to your
+changes, even after your contribution becomes part of our codebase, so we need
+your permission to use and distribute your code. We also need to be sure of
+various other things—for instance that you'll tell us if you know that your code
+infringes on other people's patents. You don't have to sign the CLA until after
+you've submitted your code for review and a member has approved it, but you must
+do it before we can put your code into our codebase.
+
+Before you start working on a larger contribution, you should get in touch with
+us first through the issue tracker with your idea so that we can help out and
+possibly guide you. Coordinating up front makes it much easier to avoid
+frustration later on.
+
+[CLA]: https://cla.developers.google.com/about/google-individual
+
+### Code reviews
+
+All submissions, including submissions by project members, require review. We
+recommend [forking the repository][fork], making changes in your fork, and
+[sending us a pull request][pr] so we can review the changes and merge them into
+this repository.
+
+[fork]: https://help.github.com/articles/about-forks/
+[pr]: https://help.github.com/articles/creating-a-pull-request/
+
+Functional changes will require tests to be added or changed. The tests live in
+the `test/` directory for each package, and are run with `dart test`. If you
+need to create new tests, use the existing tests as a guideline for what they
+should look like.
+
+You can run all additional presubmit checks locally if you wish, by using the
+`mono_repo` tool. From the root of the repository, run
+`pub global run mono_repo presubmit`.
+
+### Versioning
+
+You will also need to potentially update the pubspec.yaml and/or CHANGELOG.md of
+any package you are updating. If the current version is not a `-dev` version
+then you should update it and add a new header to the changelog. If you have no
+publicly facing change to list, it is OK for there to be no changes listed.
+
+We follow pretty strict semantic versioning, feel free to ask on the PR if you
+are unsure about what version number you should choose (or do your best, and a
+code reviewers will bring it up if it is incorrect).
+
+### File headers
+
+All files in the project must start with the following header.
+
+ // 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.
+
+### Publishing
+
+Publishing is done by package owners creating a tag of the form
+`<package>-v<version>`, either manually or through the github release ui
+(preferred). The pubspec and changelog must already be updated to the desired
+release version in the master branch for this process to work.
+
+### The small print
+
+Contributions made by corporations are covered by a different agreement than the
+one above, the
+[Software Grant and Corporate Contributor License Agreement][CCLA].
+
+[CCLA]: https://developers.google.com/open-source/cla/corporate
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..25b50aa
--- /dev/null
+++ b/README.md
@@ -0,0 +1,24 @@
+[](https://github.com/dart-lang/test/actions/workflows/dart.yml)
+[](https://deps.dev/project/github/dart-lang%2Ftest)
+
+## What's here?
+
+Welcome! [package:test](pkgs/test/) is the standard testing library for Dart and
+Flutter. If you have questions about Dart testing, please see the docs for
+[package:test](pkgs/test/). `package:test_api` and `package:test_core`
+are implementation details and generally not user-facing.
+
+[package:checks](pkgs/checks/) is a relatively new library for expressing test
+expectations. It's a more modern version of `package:matcher` and features a
+literate API.
+
+## Packages
+
+| Package | Description | Version |
+|---|---|---|
+| [checks](pkgs/checks/) | A framework for checking values against expectations and building custom expectations. | [](https://pub.dev/packages/checks) |
+| [fake_async](pkgs/fake_async/) | Fake asynchronous events such as timers and microtasks for deterministic testing. | [](https://pub.dev/packages/fake_async) |
+| [matcher](pkgs/matcher/) | Support for specifying test expectations via an extensible Matcher class. | [](https://pub.dev/packages/matcher) |
+| [test](pkgs/test/) | A full featured library for writing and running Dart tests across platforms. | [](https://pub.dev/packages/test) |
+| [test_api](pkgs/test_api/) | | [](https://pub.dev/packages/test_api) |
+| [test_core](pkgs/test_core/) | | [](https://pub.dev/packages/test_core) |
diff --git a/analysis_options.yaml b/analysis_options.yaml
new file mode 100644
index 0000000..f6b2dc1
--- /dev/null
+++ b/analysis_options.yaml
@@ -0,0 +1,22 @@
+include: package:dart_flutter_team_lints/analysis_options.yaml
+
+
+analyzer:
+ language:
+ strict-casts: true
+ errors:
+ # There are a number of deprecated members used through this package
+ deprecated_member_use_from_same_package: ignore
+
+ # Ignoring a number of lints from dart_flutter_team_lints – for now
+ avoid_catching_errors: ignore
+ avoid_dynamic_calls: ignore
+ comment_references: ignore
+ lines_longer_than_80_chars: ignore
+ only_throw_errors: ignore
+ unawaited_futures: ignore
+ unsafe_html: ignore
+
+linter:
+ rules:
+ - avoid_private_typedef_functions
diff --git a/integration_tests/regression/dart_test.yaml b/integration_tests/regression/dart_test.yaml
new file mode 100644
index 0000000..07fd2f5
--- /dev/null
+++ b/integration_tests/regression/dart_test.yaml
@@ -0,0 +1,13 @@
+paths:
+- lib/issue_2142/test.dart
+
+platforms:
+- chrome
+- vm
+
+compilers:
+- dart2js
+- dart2wasm
+- exe
+- kernel
+- source
diff --git a/integration_tests/regression/lib/issue_2142/import.dart b/integration_tests/regression/lib/issue_2142/import.dart
new file mode 100644
index 0000000..987fbb1
--- /dev/null
+++ b/integration_tests/regression/lib/issue_2142/import.dart
@@ -0,0 +1,8 @@
+// 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.
+
+// ignore: prefer_relative_imports
+import 'package:regression_tests/issue_2142/test.dart';
+
+Thing newThing() => Thing();
diff --git a/integration_tests/regression/lib/issue_2142/test.dart b/integration_tests/regression/lib/issue_2142/test.dart
new file mode 100644
index 0000000..06afc5a
--- /dev/null
+++ b/integration_tests/regression/lib/issue_2142/test.dart
@@ -0,0 +1,14 @@
+// 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 'package:test/test.dart';
+import 'import.dart';
+
+void main() {
+ test('aThing is a Thing', () {
+ expect(newThing(), isA<Thing>());
+ });
+}
+
+class Thing {}
diff --git a/integration_tests/regression/mono_pkg.yaml b/integration_tests/regression/mono_pkg.yaml
new file mode 100644
index 0000000..4a60bc1
--- /dev/null
+++ b/integration_tests/regression/mono_pkg.yaml
@@ -0,0 +1,16 @@
+# See https://pub.dev/packages/mono_repo
+
+sdk:
+- dev
+- pubspec
+
+os:
+- linux
+
+stages:
+- analyze_and_format:
+ - group:
+ - format
+ - analyze: --fatal-infos
+- unit_test:
+ - test
diff --git a/integration_tests/regression/pubspec.yaml b/integration_tests/regression/pubspec.yaml
new file mode 100644
index 0000000..6987181
--- /dev/null
+++ b/integration_tests/regression/pubspec.yaml
@@ -0,0 +1,7 @@
+name: regression_tests
+publish_to: none
+environment:
+ sdk: ^3.5.0
+resolution: workspace
+dependencies:
+ test: any
diff --git a/integration_tests/spawn_hybrid/lib/emits_numbers.dart b/integration_tests/spawn_hybrid/lib/emits_numbers.dart
new file mode 100644
index 0000000..6429a85
--- /dev/null
+++ b/integration_tests/spawn_hybrid/lib/emits_numbers.dart
@@ -0,0 +1,13 @@
+// Copyright (c) 2022, 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 'package:stream_channel/stream_channel.dart';
+
+void hybridMain(StreamChannel channel) {
+ channel.sink
+ ..add(1)
+ ..add(2)
+ ..add(3)
+ ..close();
+}
diff --git a/integration_tests/spawn_hybrid/mono_pkg.yaml b/integration_tests/spawn_hybrid/mono_pkg.yaml
new file mode 100644
index 0000000..7d75b61
--- /dev/null
+++ b/integration_tests/spawn_hybrid/mono_pkg.yaml
@@ -0,0 +1,18 @@
+# See https://pub.dev/packages/mono_repo
+
+sdk:
+- dev
+- pubspec
+
+stages:
+- analyze_and_format:
+ - group:
+ - format
+ - analyze: --fatal-infos
+ sdk:
+ - dev
+- unit_test:
+ - test: -p chrome,vm,node
+ os:
+ - linux
+ - windows
diff --git a/integration_tests/spawn_hybrid/other_package/lib/emits_numbers.dart b/integration_tests/spawn_hybrid/other_package/lib/emits_numbers.dart
new file mode 100644
index 0000000..6429a85
--- /dev/null
+++ b/integration_tests/spawn_hybrid/other_package/lib/emits_numbers.dart
@@ -0,0 +1,13 @@
+// Copyright (c) 2022, 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 'package:stream_channel/stream_channel.dart';
+
+void hybridMain(StreamChannel channel) {
+ channel.sink
+ ..add(1)
+ ..add(2)
+ ..add(3)
+ ..close();
+}
diff --git a/integration_tests/spawn_hybrid/other_package/pubspec.yaml b/integration_tests/spawn_hybrid/other_package/pubspec.yaml
new file mode 100644
index 0000000..b7d026f
--- /dev/null
+++ b/integration_tests/spawn_hybrid/other_package/pubspec.yaml
@@ -0,0 +1,6 @@
+name: other_package
+publish_to: none
+environment:
+ sdk: '>=2.12.0 <3.0.0'
+dependencies:
+ stream_channel: ^2.1.0
diff --git a/integration_tests/spawn_hybrid/pubspec.yaml b/integration_tests/spawn_hybrid/pubspec.yaml
new file mode 100644
index 0000000..de9e5e9
--- /dev/null
+++ b/integration_tests/spawn_hybrid/pubspec.yaml
@@ -0,0 +1,13 @@
+name: spawn_hybrid
+publish_to: none
+environment:
+ sdk: ^3.5.0
+resolution: workspace
+dependencies:
+ async: ^2.9.0
+ path: ^1.8.2
+ stream_channel: ^2.1.0
+dev_dependencies:
+ other_package:
+ path: other_package/
+ test: any
diff --git a/integration_tests/spawn_hybrid/test/hybrid_test.dart b/integration_tests/spawn_hybrid/test/hybrid_test.dart
new file mode 100644
index 0000000..1493e23
--- /dev/null
+++ b/integration_tests/spawn_hybrid/test/hybrid_test.dart
@@ -0,0 +1,357 @@
+// Copyright (c) 2022, 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:async/async.dart';
+import 'package:path/path.dart' as p;
+import 'package:stream_channel/stream_channel.dart';
+import 'package:test/test.dart';
+
+void main() {
+ group('spawnHybridUri():', () {
+ test('loads a file in a separate isolate connected via StreamChannel',
+ () async {
+ expect(spawnHybridUri('util/emits_numbers.dart').stream.toList(),
+ completion(equals([1, 2, 3])));
+ });
+
+ test('resolves root-relative URIs relative to the package root', () async {
+ expect(spawnHybridUri('/test/util/emits_numbers.dart').stream.toList(),
+ completion(equals([1, 2, 3])));
+ });
+
+ test('supports Uri objects', () async {
+ expect(
+ spawnHybridUri(Uri.parse('util/emits_numbers.dart')).stream.toList(),
+ completion(equals([1, 2, 3])));
+ });
+
+ test('supports package: uris referencing the root package', () async {
+ expect(
+ spawnHybridUri(Uri.parse('package:spawn_hybrid/emits_numbers.dart'))
+ .stream
+ .toList(),
+ completion(equals([1, 2, 3])));
+ });
+
+ test('supports package: uris referencing dependency packages', () async {
+ expect(
+ spawnHybridUri(Uri.parse('package:other_package/emits_numbers.dart'))
+ .stream
+ .toList(),
+ completion(equals([1, 2, 3])));
+ });
+
+ test('rejects non-String, non-Uri objects', () {
+ expect(() => spawnHybridUri(123), throwsArgumentError);
+ });
+
+ test('passes a message to the hybrid isolate', () async {
+ expect(
+ spawnHybridUri('util/echos_message.dart', message: 123).stream.first,
+ completion(equals(123)));
+ expect(
+ spawnHybridUri('util/echos_message.dart', message: 'wow')
+ .stream
+ .first,
+ completion(equals('wow')));
+ });
+
+ test('emits an error from the stream channel if the isolate fails to load',
+ () {
+ expect(spawnHybridUri('non existent file').stream.first,
+ throwsA(isA<Exception>()));
+ });
+ });
+
+ group('spawnHybridCode()', () {
+ test('loads the code in a separate isolate connected via StreamChannel',
+ () {
+ expect(spawnHybridCode('''
+ import "package:stream_channel/stream_channel.dart";
+
+ void hybridMain(StreamChannel channel) {
+ channel.sink..add(1)..add(2)..add(3)..close();
+ }
+ ''').stream.toList(), completion(equals([1, 2, 3])));
+ });
+
+ test('allows a first parameter with type StreamChannel<Object?>', () {
+ expect(spawnHybridCode('''
+ import "package:stream_channel/stream_channel.dart";
+
+ void hybridMain(StreamChannel<Object?> channel) {
+ channel.sink..add(1)..add(2)..add(null)..close();
+ }
+ ''').stream.toList(), completion(equals([1, 2, null])));
+ });
+
+ test('gives a good error when the StreamChannel type is not supported', () {
+ expect(
+ spawnHybridCode('''
+ import "package:stream_channel/stream_channel.dart";
+
+ void hybridMain(StreamChannel<Object> channel) {
+ channel.sink..add(1)..add(2)..add(3)..close();
+ }
+ ''').stream,
+ emitsError(isA<Exception>().having(
+ (e) => e.toString(),
+ 'toString',
+ contains(
+ 'The first parameter to the top-level hybridMain() must be a '
+ 'StreamChannel<dynamic> or StreamChannel<Object?>. More specific '
+ 'types such as StreamChannel<Object> are not supported.'))));
+ });
+
+ test('can use dart:io even when run from a browser', () async {
+ var path = p.join('test', 'hybrid_test.dart');
+ expect(spawnHybridCode("""
+ import 'dart:io';
+
+ import 'package:stream_channel/stream_channel.dart';
+
+ void hybridMain(StreamChannel channel) {
+ channel.sink
+ ..add(File(r"$path").readAsStringSync())
+ ..close();
+ }
+ """).stream.first, completion(contains('hybrid emits numbers')));
+ }, testOn: 'browser');
+
+ test('forwards data from the test to the hybrid isolate', () async {
+ var channel = spawnHybridCode('''
+ import "package:stream_channel/stream_channel.dart";
+
+ void hybridMain(StreamChannel channel) {
+ channel.stream.listen((num) {
+ channel.sink.add(num + 1);
+ });
+ }
+ ''');
+ channel.sink
+ ..add(1)
+ ..add(2)
+ ..add(3);
+ expect(channel.stream.take(3).toList(), completion(equals([2, 3, 4])));
+ });
+
+ test('passes an initial message to the hybrid isolate', () {
+ var code = '''
+ import "package:stream_channel/stream_channel.dart";
+
+ void hybridMain(StreamChannel channel, Object message) {
+ channel.sink..add(message)..close();
+ }
+ ''';
+
+ expect(spawnHybridCode(code, message: [1, 2, 3]).stream.first,
+ completion(equals([1, 2, 3])));
+ expect(spawnHybridCode(code, message: {'a': 'b'}).stream.first,
+ completion(equals({'a': 'b'})));
+ });
+
+ test('allows the hybrid isolate to send errors across the stream channel',
+ () {
+ var channel = spawnHybridCode('''
+ import "package:stack_trace/stack_trace.dart";
+ import "package:stream_channel/stream_channel.dart";
+
+ void hybridMain(StreamChannel channel) {
+ channel.sink.addError("oh no!", Trace.current());
+ }
+ ''');
+
+ channel.stream.listen(null, onError: expectAsync2((error, stackTrace) {
+ expect(error.toString(), equals('oh no!'));
+ expect(stackTrace.toString(), contains('hybridMain'));
+ }));
+ });
+
+ test('sends an unhandled synchronous error across the stream channel', () {
+ var channel = spawnHybridCode('''
+ import "package:stream_channel/stream_channel.dart";
+
+ void hybridMain(StreamChannel channel) {
+ throw "oh no!";
+ }
+ ''');
+
+ channel.stream.listen(null, onError: expectAsync2((error, stackTrace) {
+ expect(error.toString(), equals('oh no!'));
+ expect(stackTrace.toString(), contains('hybridMain'));
+ }));
+ });
+
+ test('sends an unhandled asynchronous error across the stream channel', () {
+ var channel = spawnHybridCode('''
+ import 'dart:async';
+
+ import "package:stream_channel/stream_channel.dart";
+
+ void hybridMain(StreamChannel channel) {
+ scheduleMicrotask(() {
+ throw "oh no!";
+ });
+ }
+ ''');
+
+ channel.stream.listen(null, onError: expectAsync2((error, stackTrace) {
+ expect(error.toString(), equals('oh no!'));
+ expect(stackTrace.toString(), contains('hybridMain'));
+ }));
+ });
+
+ test('deserializes TestFailures as TestFailures', () {
+ var channel = spawnHybridCode('''
+ import "package:stream_channel/stream_channel.dart";
+
+ import "package:test/test.dart";
+
+ void hybridMain(StreamChannel channel) {
+ throw TestFailure("oh no!");
+ }
+ ''');
+
+ expect(channel.stream.first, throwsA(isA<TestFailure>()));
+ });
+
+ test('gracefully handles an unserializable message in the VM', () {
+ var channel = spawnHybridCode('''
+ import "package:stream_channel/stream_channel.dart";
+
+ void hybridMain(StreamChannel channel) {}
+ ''');
+
+ expect(() => channel.sink.add(<Object>[].iterator), throwsArgumentError);
+ });
+
+ test('gracefully handles an unserializable message in the browser',
+ () async {
+ var channel = spawnHybridCode('''
+ import 'package:stream_channel/stream_channel.dart';
+
+ void hybridMain(StreamChannel channel) {}
+ ''');
+
+ expect(() => channel.sink.add(<Object>[].iterator), throwsArgumentError);
+ }, testOn: 'browser');
+
+ test('gracefully handles an unserializable message in the hybrid isolate',
+ () {
+ var channel = spawnHybridCode('''
+ import "package:stream_channel/stream_channel.dart";
+
+ void hybridMain(StreamChannel channel) {
+ channel.sink.add([].iterator);
+ }
+ ''');
+
+ channel.stream.listen(null, onError: expectAsync1((error) {
+ expect(error.toString(), contains("can't be JSON-encoded."));
+ }));
+ });
+
+ test('forwards prints from the hybrid isolate', () {
+ expect(() async {
+ var channel = spawnHybridCode('''
+ import "package:stream_channel/stream_channel.dart";
+
+ void hybridMain(StreamChannel channel) {
+ print("hi!");
+ channel.sink.add(null);
+ }
+ ''');
+ await channel.stream.first;
+ }, prints('hi!\n'));
+ });
+
+ // This takes special handling, since the code is packed into a data: URI
+ // that's imported, URIs don't escape $ by default, and $ isn't allowed in
+ // imports.
+ test('supports a dollar character in the hybrid code', () {
+ expect(spawnHybridCode(r'''
+ import "package:stream_channel/stream_channel.dart";
+
+ void hybridMain(StreamChannel channel) {
+ var value = "bar";
+ channel.sink.add("foo${value}baz");
+ }
+ ''').stream.first, completion('foobarbaz'));
+ });
+
+ test('closes the channel when the hybrid isolate exits', () {
+ var channel = spawnHybridCode('''
+ import "dart:isolate";
+
+ hybridMain(_) {
+ Isolate.current.kill();
+ }
+ ''');
+
+ expect(channel.stream.toList(), completion(isEmpty));
+ });
+
+ group('closes the channel when the test finishes by default', () {
+ late StreamChannel channel;
+
+ test('test 1', () {
+ channel = spawnHybridCode('''
+ import 'package:stream_channel/stream_channel.dart';
+
+ void hybridMain(StreamChannel channel) {}
+ ''');
+ });
+
+ test('test 2', () async {
+ var isDone = false;
+ channel.stream.listen(null, onDone: () => isDone = true);
+ await pumpEventQueue();
+ expect(isDone, isTrue);
+ });
+ });
+
+ group('persists across multiple tests with stayAlive: true', () {
+ late StreamQueue queue;
+ late StreamSink sink;
+ setUpAll(() {
+ var channel = spawnHybridCode('''
+ import "package:stream_channel/stream_channel.dart";
+
+ void hybridMain(StreamChannel channel) {
+ channel.stream.listen((message) {
+ channel.sink.add(message);
+ });
+ }
+ ''', stayAlive: true);
+ queue = StreamQueue(channel.stream);
+ sink = channel.sink;
+ });
+
+ test('echoes a number', () {
+ expect(queue.next, completion(equals(123)));
+ sink.add(123);
+ });
+
+ test('echoes a string', () {
+ expect(queue.next, completion(equals('wow')));
+ sink.add('wow');
+ });
+ });
+
+ test('opts in to null safety by default', () async {
+ expect(spawnHybridCode('''
+ import "package:stream_channel/stream_channel.dart";
+
+ // Use some null safety syntax
+ int? x;
+
+ void hybridMain(StreamChannel channel) {
+ channel.sink..add(1)..add(2)..add(3)..close();
+ }
+ ''').stream.toList(), completion(equals([1, 2, 3])));
+ });
+ });
+}
diff --git a/integration_tests/spawn_hybrid/test/hybrid_test_io.dart b/integration_tests/spawn_hybrid/test/hybrid_test_io.dart
new file mode 100644
index 0000000..0e454db
--- /dev/null
+++ b/integration_tests/spawn_hybrid/test/hybrid_test_io.dart
@@ -0,0 +1,47 @@
+// Copyright (c) 2022, 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.
+
+@TestOn('vm')
+library;
+
+import 'dart:io';
+
+import 'package:path/path.dart' as p;
+import 'package:test/test.dart';
+
+void main() {
+ test('kills the isolate when the test closes the channel', () async {
+ var channel = spawnHybridCode('''
+ import "dart:async";
+ import "dart:io";
+
+ import "package:shelf/shelf.dart" as shelf;
+ import "package:shelf/shelf_io.dart" as io;
+ import "package:stream_channel/stream_channel.dart";
+
+ hybridMain(StreamChannel channel) async {
+ var server = await ServerSocket.bind("localhost", 0);
+ server.listen(null);
+ channel.sink.add(server.port);
+ }
+ ''');
+
+ // Expect that the socket disconnects at some point (presumably when the
+ // isolate closes).
+ var port = await channel.stream.first as int;
+ var socket = await Socket.connect('localhost', port);
+ expect(socket.listen(null).asFuture<void>(), completes);
+
+ await channel.sink.close();
+ });
+
+ test('spawnHybridUri(): supports absolute file: URIs', () async {
+ expect(
+ spawnHybridUri(p.toUri(p.absolute(
+ p.relative(p.join('test', 'util', 'emits_numbers.dart')))))
+ .stream
+ .toList(),
+ completion(equals([1, 2, 3])));
+ });
+}
diff --git a/integration_tests/spawn_hybrid/test/subdir/hybrid_test.dart b/integration_tests/spawn_hybrid/test/subdir/hybrid_test.dart
new file mode 100644
index 0000000..088375c
--- /dev/null
+++ b/integration_tests/spawn_hybrid/test/subdir/hybrid_test.dart
@@ -0,0 +1,20 @@
+// Copyright (c) 2022, 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.
+
+@TestOn('vm')
+library;
+
+import 'package:test/test.dart';
+
+void main() {
+ group('spawnHybridUri():', () {
+ test('loads uris relative to the test file', () async {
+ expect(
+ spawnHybridUri(Uri.parse('../util/emits_numbers.dart'))
+ .stream
+ .toList(),
+ completion(equals([1, 2, 3])));
+ });
+ });
+}
diff --git a/integration_tests/spawn_hybrid/test/util/echos_message.dart b/integration_tests/spawn_hybrid/test/util/echos_message.dart
new file mode 100644
index 0000000..271b44f
--- /dev/null
+++ b/integration_tests/spawn_hybrid/test/util/echos_message.dart
@@ -0,0 +1,11 @@
+// Copyright (c) 2022, 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 'package:stream_channel/stream_channel.dart';
+
+void hybridMain(StreamChannel channel, Object message) {
+ channel.sink
+ ..add(message)
+ ..close();
+}
diff --git a/integration_tests/spawn_hybrid/test/util/emits_numbers.dart b/integration_tests/spawn_hybrid/test/util/emits_numbers.dart
new file mode 100644
index 0000000..6429a85
--- /dev/null
+++ b/integration_tests/spawn_hybrid/test/util/emits_numbers.dart
@@ -0,0 +1,13 @@
+// Copyright (c) 2022, 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 'package:stream_channel/stream_channel.dart';
+
+void hybridMain(StreamChannel channel) {
+ channel.sink
+ ..add(1)
+ ..add(2)
+ ..add(3)
+ ..close();
+}
diff --git a/integration_tests/wasm/dart_test.yaml b/integration_tests/wasm/dart_test.yaml
new file mode 100644
index 0000000..14308c4
--- /dev/null
+++ b/integration_tests/wasm/dart_test.yaml
@@ -0,0 +1,5 @@
+platforms: [chrome, firefox]
+# Node doesn't work because the version available in the current Ubuntu GitHub runners is too
+# old to support WASM+GC, which would be required to run Dart tests.
+#platforms: [chrome, firefox, node]
+compilers: [dart2wasm]
diff --git a/integration_tests/wasm/mono_pkg.yaml b/integration_tests/wasm/mono_pkg.yaml
new file mode 100644
index 0000000..a8f3410
--- /dev/null
+++ b/integration_tests/wasm/mono_pkg.yaml
@@ -0,0 +1,18 @@
+# See https://pub.dev/packages/mono_repo
+
+sdk:
+- pubspec
+- dev
+
+os:
+- linux
+- windows
+
+stages:
+- analyze_and_format:
+ - group:
+ - format
+ - analyze: --fatal-infos
+- unit_test:
+ # The config here is a regression test for https://github.com/dart-lang/test/issues/2006
+ - test: --timeout=60s
diff --git a/integration_tests/wasm/pubspec.yaml b/integration_tests/wasm/pubspec.yaml
new file mode 100644
index 0000000..370d844
--- /dev/null
+++ b/integration_tests/wasm/pubspec.yaml
@@ -0,0 +1,7 @@
+name: wasm_tests
+publish_to: none
+environment:
+ sdk: ^3.5.0
+resolution: workspace
+dev_dependencies:
+ test: any
diff --git a/integration_tests/wasm/test/hello_world_test.dart b/integration_tests/wasm/test/hello_world_test.dart
new file mode 100644
index 0000000..9ddd511
--- /dev/null
+++ b/integration_tests/wasm/test/hello_world_test.dart
@@ -0,0 +1,24 @@
+// Copyright (c) 2022, 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.
+
+@TestOn('wasm')
+// This retry is a regression test for https://github.com/dart-lang/test/issues/2006
+@Retry(2)
+library;
+
+import 'package:test/test.dart';
+
+void main() {
+ test('1 == 1', () {
+ expect(1, equals(1));
+ });
+
+ test('asserts are enabled', () {
+ expect(shouldFail, throwsA(isA<AssertionError>()));
+ });
+}
+
+void shouldFail() {
+ assert(1 == 2);
+}
diff --git a/mono_repo.yaml b/mono_repo.yaml
new file mode 100644
index 0000000..1131355
--- /dev/null
+++ b/mono_repo.yaml
@@ -0,0 +1,21 @@
+# See with https://github.com/dart-lang/mono_repo for details on this file
+self_validate: analyze_and_format
+
+github:
+ # Setting just `cron` keeps the defaults for `push` and `pull_request`
+ cron: '0 0 * * 0' # “At 00:00 (UTC) on Sunday.”
+ on_completion:
+ - name: "Notify failure"
+ runs-on: ubuntu-latest
+ # Run only if other jobs have failed and this is a push or scheduled build.
+ if: (github.event_name == 'push' || github.event_name == 'schedule') && failure()
+ steps:
+ - run: >
+ curl -H "Content-Type: application/json" -X POST -d \
+ "{'text':'Build failed! ${GITHUB_SERVER_URL}/${GITHUB_REPOSITORY}/actions/runs/${GITHUB_RUN_ID}'}" \
+ "${CHAT_WEBHOOK_URL}"
+ env:
+ CHAT_WEBHOOK_URL: ${{ secrets.BUILD_AND_TEST_TEAM_CHAT_WEBHOOK_URL }}
+
+merge_stages:
+- analyze_and_format
diff --git a/pkgs/checks/CHANGELOG.md b/pkgs/checks/CHANGELOG.md
new file mode 100644
index 0000000..6588352
--- /dev/null
+++ b/pkgs/checks/CHANGELOG.md
@@ -0,0 +1,54 @@
+## 0.3.1-wip
+
+- Directly compare keys across actual and expected `Map` instances when
+ checking deep collection equality and all the keys can be directly compared
+ for equality. This maintains the path into a nested collection for typical
+ cases of checking for equality against a purely value collection.
+- Always wrap Condition descriptions in angle brackets.
+- Add `containsMatchingInOrder` and `containsEqualInOrder` to replace the
+ combined functionality in `containsInOrder`.
+- Replace `pairwiseComparesTo` with `pairwiseMatches`.
+- Increase SDK constraint to ^3.5.0.
+
+## 0.3.0
+
+- **Breaking Changes**
+ - Remove the `Condition` class and the `it()` utility. Replace calls to
+ `(it()..someExpectation())` with `((it) => it.someExpectation())`.
+- Add class modifiers to restrict extension of implementation classes.
+
+## 0.2.2
+
+- Return the first failure from `softCheck` and `softCheckAsync` as
+ documented, instead of the last failure when there are multiple failures.
+- Add example `because` usage and mention the "reason" name in the migration
+ guide.
+- Add `ComparableChecks` with comparison expectations for subject types that
+ implement `Comparable`.
+
+## 0.2.1
+
+- Add a link to file issues with feedback in the README.
+
+## 0.2.0
+
+- **Breaking Changes**
+ - `checkThat` renamed to `check`.
+ - `nest` and `nestAsync` take `Iterable<String> Function()` arguments for
+ `label` instead of `String`.
+ - Async expectation extensions `completes`, `throws`, `emits`, and
+ `emitsError` no longer return a `Future<Subject>`. Instead they take an
+ optional `Condition` argument which can check expectations that would
+ have been checked on the returned subject.
+ - `nestAsync` no longer returns a `Subject`, callers must pass the
+ followup `Condition` to the nullable argument.
+ - Remove the `which` extension on `Future<Subject>`.
+ - `matches` renamed to `matchesPattern` and now accepts a `Pattern`
+ argument, instead of limiting to `RegExp`.
+- Added an example.
+- Include a stack trace in the failure description for unexpected errors from
+ Futures or Streams.
+
+## 0.1.0
+
+- Initial release.
diff --git a/pkgs/checks/LICENSE b/pkgs/checks/LICENSE
new file mode 100644
index 0000000..000cd7b
--- /dev/null
+++ b/pkgs/checks/LICENSE
@@ -0,0 +1,27 @@
+Copyright 2014, the Dart project authors.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+ * Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ * Redistributions in binary form must reproduce the above
+ copyright notice, this list of conditions and the following
+ disclaimer in the documentation and/or other materials provided
+ with the distribution.
+ * Neither the name of Google LLC nor the names of its
+ contributors may be used to endorse or promote products derived
+ from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
diff --git a/pkgs/checks/README.md b/pkgs/checks/README.md
new file mode 100644
index 0000000..5415f11
--- /dev/null
+++ b/pkgs/checks/README.md
@@ -0,0 +1,220 @@
+[](https://pub.dev/packages/checks)
+[](https://pub.dev/packages/checks/publisher)
+
+`package:checks` is a library for expressing test expectations and it features
+a literate API.
+
+## package:checks preview
+
+`package:checks` is in preview; to provide feedback on the API, please file
+[an issue][] with questions, suggestions, feature requests, or general
+feedback.
+
+For documentation about migrating from `package:matcher` to `checks`, see the
+[migration guide][].
+
+[an issue]:https://github.com/dart-lang/test/issues/new?labels=package%3Achecks&template=03_checks_feedback.md
+[migration guide]:https://github.com/dart-lang/test/blob/master/pkgs/checks/doc/migrating_from_matcher.md
+
+## Quickstart
+
+1. Add a `dev_dependency` on `checks: ^0.2.0`.
+
+1. Add an import for `package:checks/checks.dart`.
+
+1. Use `checks` in your test code:
+
+```dart
+void main() {
+ test('sample test', () {
+ // test code here
+ ...
+
+ check(actual).equals(expected);
+ check(someList).isNotEmpty();
+ check(someObject).isA<Map>();
+ check(someString)..startsWith('a')..endsWith('z')..contains('lmno');
+ });
+}
+```
+
+## Checking expectations with `checks`
+
+Expectations start with `check`. This utility returns a `Subject`, and
+expectations can be checked against the subject. Expectations are defined as
+extension methods, and different expectations will be available for subjects
+with different value types.
+
+```dart
+check(someValue).equals(expectedValue);
+check(someList).deepEquals(expectedList);
+check(someString).contains('expected pattern');
+```
+
+If a failure may not have enough context about the actual or expected values
+from the expectation calls alone, add a "Reason" in the failure message by
+passing a `because:` argument to `check()`.
+
+```dart
+check(
+ because: 'log lines must start with the severity',
+ logLines,
+).every((l) => l
+ ..anyOf([
+ (l) => l.startsWith('ERROR'),
+ (l) => l.startsWith('WARNING'),
+ (l) => l.startsWith('INFO'),
+ ]));
+```
+
+
+### Composing expectations
+
+
+Multiple expectations can be checked against the same value using cascade
+syntax. When multiple expectations are checked against a single value, a failure
+will included descriptions of the expectations that already passed.
+
+```dart
+check(someString)
+ ..startsWith('a')
+ ..endsWith('z')
+ ..contains('lmno');
+```
+
+Some nested checks may be not be possible to write with cascade syntax.
+There is a `which` utility for this use case which takes a `Condition`.
+
+```dart
+check(someString)
+ ..startsWith('a')
+ // A cascade would not be possible on `length`
+ ..length.which((l) => l
+ ..isGreatherThan(10)
+ ..isLessThan(100));
+```
+
+
+Some expectations return a `Subject` for another value derived from the original
+value, such as the `length` extension.
+
+```dart
+check(someString).length.equals(expectedLength);
+```
+
+Fields or derived values can be extracted from objects for checking further
+properties with the `has` utility.
+
+```dart
+check(someValue)
+ .has((value) => value.property, 'property')
+ .equals(expectedPropertyValue);
+```
+
+### Passing a set of expectations as an argument
+
+Some expectations take arguments which are themselves expectations to apply to
+other values. These expectations take `Condition` arguments which have the
+signature void Function(Subject)`. The conditions check expectations when they
+are called with a `Subject` argument.
+
+```dart
+check(someList).any((e) => e.isGreaterThan(0));
+```
+
+### Checking asynchronous expectations
+
+Expectation extension methods checking asynchronous behavior return a `Future`.
+The future should typically be awaited within the test body, however
+asynchronous expectations will also ensure that the test is not considered
+complete before the expectation is complete.
+Expectations with no concrete end conditions, such as an expectation that a
+future never completes, cannot be awaited and may cause a failure after the test
+has already appeared to complete.
+
+Asynchronous expectations do not return a `Subject`. When an expectation
+extracts a derived value further expectations can be checked by passing a
+`Condition`.
+
+```dart
+await check(someFuture).completes((r) => r.isGreaterThan(0));
+```
+
+Subjects for `Stream` instances must first be wrapped into a `StreamQueue` to
+allow multiple expectations to test against the stream from the same state.
+The `withQueue` extension can be used when a given stream instance only needs to
+be checked once, or if it is a broadcast stream, but if single subscription
+stream needs to have multiple expectations checked separately it should be
+wrapped with a `StreamQueue`.
+
+```dart
+await check(someStream).withQueue.inOrder([
+ (s) => s.emits((e) => e.equals(1)),
+ (s) => s.emits((e) => e.equals(2)),
+ (s) => s.emits((e) => e.equals(3)),
+ (s) => s.isDone(),
+]);
+
+var someQueue = StreamQueue(someOtherStream);
+await check(someQueue).emits((e) => e.equals(1));
+// do something
+await check(someQueue).emits((e) => e.equals(2));
+// do something
+```
+
+
+## Writing custom expectations
+
+Expectations are written as extensions on `Subject` with specific generics. The
+library `package:checks/context.dart` gives access to a `context` getter on
+`Subject` which offers capabilities for defining expectations on the subject's
+value.
+
+The `Context` allows checking an expectation with `expect`, `expectAsync` and
+`expectUnawaited`, or extracting a derived value for performing other checks
+with `nest` and `nestAsync`. Failures are reported by returning a `Rejection`,
+or an `Extracted.rejection`, extensions should avoid throwing exceptions.
+
+Descriptions of the clause checked by an expectations are passed through a
+separate callback from the predicate which checks the value. Nesting calls are
+made with a label directly. When there are no failures the clause callbacks are
+not called. When a condition callback is described, the clause callbacks are
+called, but the predicate callbacks are not called. Conditions can be checked
+against values without throwing an exception using `softCheck` or
+`softCheckAsync`.
+
+```dart
+extension CustomChecks on Subject<CustomType> {
+ void someExpectation() {
+ context.expect(() => ['meets this expectation'], (actual) {
+ if (_expectationIsMet(actual)) return null;
+ return Rejection(which: ['does not meet this expectation']);
+ });
+ }
+
+ Subject<Foo> get someDerivedValue =>
+ context.nest(() => ['has someDerivedValue'], (actual) {
+ if (_cannotReadDerivedValue(actual)) {
+ return Extracted.rejection(which: ['cannot read someDerivedValue']);
+ }
+ return Extracted.value(_readDerivedValue(actual));
+ });
+
+ // for field reads that will not get rejected, use `has`
+ Subject<Bar> get someField => has((a) => a.someField, 'someField');
+}
+```
+
+Extensions may also compose existing expectations under a single name. When
+such expectations fail, the test output will refer to the individual
+expectations that were called.
+
+```dart
+extension ComposedChecks on Subject<Iterable> {
+ void hasLengthInRange(int min, int max) {
+ length
+ ..isGreaterThan(min)
+ ..isLessThan(max);
+ }
+}
+```
diff --git a/pkgs/checks/doc/migrating_from_matcher.md b/pkgs/checks/doc/migrating_from_matcher.md
new file mode 100644
index 0000000..b358e63
--- /dev/null
+++ b/pkgs/checks/doc/migrating_from_matcher.md
@@ -0,0 +1,203 @@
+## Migrating from package:matcher
+
+`package:checks` is currently in preview. Once this package reaches a stable
+version, it will be the recommended package by the Dart team to use for most
+tests.
+
+[`package:matcher`][matcher] is the legacy package with an API exported from
+`package:test/test.dart` and `package:test/expect.dart`.
+
+**Do I have to migrate all at once?** No. `package:matcher` will be compatible
+with `package:checks`, and old tests can continue to use matchers. Test cases
+within the same file can use a mix of `expect` and `check`.
+
+**_Should_ I migrate all at once?** Probably not, it depends on your tolerance
+for having tests use a mix of APIs. As you add new tests, or need to make
+updates to existing tests, using `checks` will make testing easier. Tests which
+are stable and passing will not get significant benefits from a migration.
+
+**Do I need to migrate at all?** No. When `package:test`stops exporting
+these members it will be possible to add a dependency on `package:matcher` and
+continue to use them. `package:matcher` will continue to be available.
+
+**Why is the Dart team adding a second framework?** The `matcher` package has a
+design which is fundamentally incompatible with using static types to validate
+correct use. With an entirely new design, the static types in `checks` give
+confidence that the expectation is appropriate for the value, and can narrow
+autocomplete choices in the IDE for a better editing experience. The clean break
+from the legacy implementation and API also gives an opportunity to make small
+behavior and signature changes to align with modern Dart idioms.
+
+**Should I start using checks right away?** There is still a
+high potential for minor or major breaking changes during the preview window.
+Once this package is stable, yes! The experience of using `checks` improves on
+`matcher`. See some of the [improvements to look forward to in checks
+below](#improvements-you-can-expect).
+
+[matcher]: https://pub.dev/packages/matcher
+
+## Trying Checks as a Preview
+
+1. Add a `dev_dependency` on `checks: ^0.2.0`.
+
+1. Replace the existing `package:test/test.dart` import with
+ `package:test/scaffolding.dart`.
+
+1. Add an import to `package:checks/checks.dart`.
+
+1. For an incremental migration within the test, add an import to
+ `package:test/expect.dart`. Remove it to surface errors in tests that still
+ need to be migrated, or keep it in so the tests work without being fully
+ migrated.
+
+1. Migrate the test cases.
+
+## Migrating from Matchers
+
+Replace calls to `expect` or `expectLater` with a call to `check` passing the
+first argument.
+When a direct replacement is available, change the second argument from calling
+a function returning a Matcher, to calling the relevant extension method on the
+`Subject`.
+
+Whenever you see a bare non-matcher value argument for `expected`, assume it
+should use the `equals` expectation, although take care when the subject is a
+collection.
+See below, `.equals` may not always be the correct replacement in
+`package:checks`.
+
+```dart
+expect(actual, expected);
+check(actual).equals(expected);
+// or maybe
+check(actualCollection).deepEquals(expected);
+
+await expectLater(actual, completes());
+await check(actual).completes();
+```
+
+If you use the `reason` argument to `expect`, rename it to `because`.
+
+```dart
+expect(actual, expectation(), reason: 'some explanation');
+check(because: 'some explanation', actual).expectation();
+```
+
+### Differences in behavior from matcher
+
+- The `equals` Matcher performed a deep equality check on collections.
+ `.equals()` expectation will only correspond to [operator ==] so some tests
+ may need to replace `.equals()` with `.deepEquals()`.
+- Streams must be explicitly wrapped into a `StreamQueue` before they can be
+ tested for behavior. Use `check(actualStream).withQueue`.
+- `emitsAnyOf` is `Subject<StreamQueue>.anyOf`. `emitsInOrder` is `inOrder`.
+ The arguments are `FutureOr<void> Function(Subject<StreamQueue>)` and match
+ a behavior of the entire stream. In `matcher` the elements to expect could
+ have been a bare value to check for equality, a matcher for the emitted
+ value, or a matcher for the entire queue which would match multiple values.
+ Use `(s) => s.emits((e) => e.interestingCheck())` to check the emitted
+ elements.
+- In `package:matcher` the [`matches` Matcher][matches] converted a `String`
+ argument into a `Regex`, so `matches(r'\d')` would match the value `'1'`.
+ This was potentially confusing, because even though `String` is a subtype of
+ `Pattern`, it wasn't used as a pattern directly.
+ With `matchesPattern` a `String` argument is used as a `Pattern` and
+ comparison uses [`String.allMatches`][allMatches].
+ For backwards compatibility change `matches(regexString)` to
+ `matchesPattern(RegExp(regexString))`.
+- The `TypeMatcher.having` API is replace by the more general`.has`. While
+ `.having` could only be called on a `TypeMatcher` using `.isA`, `.has` works
+ on any `Subject`. `CoreChecks.has` takes 1 fewer arguments - instead of
+ taking the last argument, a `matcher` to apply to the field, it returns a
+ `Subject` for the field.
+
+[matches]:https://pub.dev/documentation/matcher/latest/matcher/Matcher/matches.html
+[allMatches]:https://api.dart.dev/stable/2.19.1/dart-core/Pattern/allMatches.html
+
+### Matchers with replacements under a different name
+
+- `anyElement` -> `Subject<Iterable>.any`
+- `everyElement` -> `Subject<Iterable>.every`
+- `completion(Matcher)` -> `completes(conditionCallback)`
+- `containsPair(key, value)` -> Use `Subject<Map>[key].equals(value)`
+- `hasLength(expected)` -> `length.equals(expected)`
+- `isNot(Matcher)` -> `not(conditionCallback)`
+- `pairwiseCompare` -> `pairwiseMatches`
+- `same` -> `identicalTo`
+- `stringContainsInOrder` -> `Subject<String>.containsInOrder`
+- `containsAllInOrder(iterable)` ->
+ `Subject<Iterable>.containsMatchingInOrder(iterable)` to compare with
+ conditions other than equals,
+ `Subject<Iterable>.containsEqualInOrder(iterable)` to compare each index
+ with the equality operator (`==`).
+
+### Members from `package:test/expect.dart` without a direct replacement
+
+- `checks` does not ship with any type checking matchers for specific types.
+ Instead of, for example, `isArgumentError` use `isA<ArgumentError>`, and
+ similary `throws<ArgumentError>` over `throwsArgumentError`.
+- `anything`. When a condition callback is needed that should accept any
+ value, pass `(_) {}`.
+- Specific numeric comparison - `isNegative`, `isPositive`, `isZero` and their
+ inverses. Use `isLessThan`, `isGreaterThan`, `isLessOrEqual`, and
+ `isGreaterOrEqual` with appropriate numeric arguments.
+- Numeric range comparison, `inClosedOpenRange`, `inExclusiveRange`,
+ `inInclusiveRange`, `inOpenClosedRange`. Use cascades to chain a check for
+ both ends of the range onto the same subject.
+- `containsOnce`: TODO add missing expectation
+- `emitsInAnyOrder`: TODO add missing expectation
+- `expectAsync` and `expectAsyncUntil`. Continue to import
+ `package:test/expect.dart` for these APIs.
+- `isIn`: TODO add missing expectation
+- `orderedEquals`: Use `deepEquals`. If the equality needs to specifically
+ *not* be deep equality (this is unusual, nested collections are unlikely to
+ have a meaningful equality), force using `operator ==` at the first level
+ with `.deepEquals(expected.map((e) => (Subject<Object?> s) => s.equals(e)))`;
+- `prints`: TODO add missing expectation? Is this one worth replacing?
+- `predicate`: TODO add missing expectation
+
+## Improvements you can expect
+
+Expectations are statically restricted to those which are appropriate for the
+type. So while the following is statically allowed with `matcher` but always
+fails at runtime, the expectation cannot be written at all with `checks`.
+
+```dart
+expect(1, contains(1)); // No static error, always fails
+check(1).contains(1); // Static error. The method 'contains' isn't defined
+```
+
+These static restrictions also improve the relevance of IDE autocomplete
+suggestions. While editing with the cursor at `_`, the suggestions provided
+in the `matcher` example can include _any_ top level element including matchers
+appropriate for other types of value, type names, and top level definitions from
+other packages. With the cursor following a `.` in the `checks` example the
+suggestions will only be expectations or utilities appropriate for the value
+type.
+
+```dart
+expect(actual, _ // many unrelated suggestions
+check(actual)._ // specific suggestions
+```
+
+Asynchronous matchers in `matcher` are a subtype of synchronous matchers, but do
+not satisfy the same behavior contract. Some APIs which use a matcher could not
+validate whether it would satisfy the behavior it needs, and it could result in
+a false success, false failure, or misleading errors. APIs which correctly use
+asynchronous matchers need to do a type check and change their interaction based
+on the runtime type. Asynchronous expectations in `checks` are refused at
+runtime when a synchronous answer is required. The error will help solve the
+specific misuse, instead of resulting in a confusing error, or worse a missed
+failure. The reason for the poor compatibility in `matcher` is due to some
+history of implementation - asynchronous matchers were written in `test`
+alongside `expect`, and synchronous matchers have no dependency on the
+asynchronous implementation.
+
+Asynchronous expectations always return a `Future`, and with the
+[`unawaited_futures` lint][unawaited lint] should more safely ensure that
+asynchronous expectation work is completed within the test body. With `matcher`
+it was up to the author to correctly use `await expecLater` for asynchronous
+cases, and `expect` for synchronous cases, and if `expect` was used with an
+asynchronous matcher the expectation could fail at any point.
+
+[unawaited lint]: https://dart.dev/lints/unawaited_futures
diff --git a/pkgs/checks/example/example.dart b/pkgs/checks/example/example.dart
new file mode 100644
index 0000000..88bec0b
--- /dev/null
+++ b/pkgs/checks/example/example.dart
@@ -0,0 +1,26 @@
+// 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 'package:checks/checks.dart';
+import 'package:test/scaffolding.dart';
+
+void main() {
+ test('sample test', () {
+ final someValue = 5;
+ check(someValue).equals(5);
+
+ final someList = [1, 2, 3, 4, 5];
+ check(someList).deepEquals([1, 2, 3, 4, 5]);
+
+ final someString = 'abcdefghijklmnopqrstuvwxyz';
+
+ check(
+ because: 'it should contain the beginning, middle and end',
+ someString,
+ )
+ ..startsWith('a')
+ ..endsWith('z')
+ ..contains('lmno');
+ });
+}
diff --git a/pkgs/checks/lib/checks.dart b/pkgs/checks/lib/checks.dart
new file mode 100644
index 0000000..db8b18e
--- /dev/null
+++ b/pkgs/checks/lib/checks.dart
@@ -0,0 +1,15 @@
+// Copyright (c) 2022, 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.
+
+export 'src/checks.dart'
+ show AsyncCondition, Condition, SkipExtension, Subject, check;
+export 'src/extensions/async.dart'
+ show FutureChecks, StreamChecks, WithQueueExtension;
+export 'src/extensions/core.dart'
+ show BoolChecks, ComparableChecks, CoreChecks, NullableChecks;
+export 'src/extensions/function.dart' show FunctionChecks;
+export 'src/extensions/iterable.dart' show IterableChecks;
+export 'src/extensions/map.dart' show MapChecks;
+export 'src/extensions/math.dart' show NumChecks;
+export 'src/extensions/string.dart' show StringChecks;
diff --git a/pkgs/checks/lib/context.dart b/pkgs/checks/lib/context.dart
new file mode 100644
index 0000000..cebba71
--- /dev/null
+++ b/pkgs/checks/lib/context.dart
@@ -0,0 +1,21 @@
+// Copyright (c) 2022, 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.
+
+export 'src/checks.dart'
+ show
+ AsyncCondition,
+ CheckFailure,
+ Condition,
+ Context,
+ ContextExtension,
+ Extracted,
+ FailureDetail,
+ Rejection,
+ Subject,
+ describe,
+ describeAsync,
+ softCheck,
+ softCheckAsync;
+export 'src/describe.dart'
+ show escape, indent, literal, postfixLast, prefixFirst;
diff --git a/pkgs/checks/lib/src/checks.dart b/pkgs/checks/lib/src/checks.dart
new file mode 100644
index 0000000..e1e4bcb
--- /dev/null
+++ b/pkgs/checks/lib/src/checks.dart
@@ -0,0 +1,1009 @@
+// Copyright (c) 2022, 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:meta/meta.dart' as meta;
+import 'package:test_api/hooks.dart';
+
+import 'describe.dart';
+import 'extensions/async.dart';
+import 'extensions/core.dart';
+import 'extensions/iterable.dart';
+
+/// A target for checking expectations against a value in a test.
+///
+/// A subject my have a real value, in which case the expectations can be
+/// validated or rejected; or it may be a placeholder, in which case
+/// expectations describe what would be checked but cannot be rejected.
+///
+/// Expectation methods are defined in extensions `on Subject`, specialized on
+/// the generic [T].
+/// Expectation extension methods can use the [ContextExtension] to interact
+/// with the [Context] for this subject.
+///
+/// Create a subject that throws an exception for missed expectations with the
+/// [check] function.
+final class Subject<T> {
+ final Context<T> _context;
+ Subject._(this._context);
+}
+
+/// A callback that synchronously checks expectations against a subject.
+///
+/// Asynchronous expectations should not be used within a `Condition` callback.
+typedef Condition<T> = void Function(Subject<T>);
+
+/// A callback that asynchronously checks expectations against a subject.
+///
+/// Any expectations may be used within an `AsyncCondition` callback.
+typedef AsyncCondition<T> = FutureOr<void> Function(Subject<T>);
+
+extension SkipExtension<T> on Subject<T> {
+ /// Mark the currently running test as skipped and return a [Subject] that
+ /// will ignore all expectations.
+ ///
+ /// Any expectations against the return value will not be checked and will not
+ /// be included in the "Expected" or "Actual" string representations of a
+ /// failure.
+ ///
+ /// ```dart
+ /// check(actual)
+ /// ..stillChecked()
+ /// ..skip('reason the expectation is temporarily not met').notChecked();
+ /// ```
+ ///
+ /// If `skip` is used in a callback passed to `softCheck` or `describe` it
+ /// will still mark the test as skipped, even though failing the expectation
+ /// would not have otherwise caused the test to fail.
+ Subject<T> skip(String message) {
+ TestHandle.current.markSkipped(message);
+ return Subject._(_SkippedContext());
+ }
+}
+
+/// Creates a [Subject] that can be used to validate expectations against
+/// [value], with an exception upon a failed expectation.
+///
+/// Expectations that are not satisfied throw a [TestFailure] to interrupt the
+/// currently running test and mark it as failed.
+///
+/// If [because] is passed it will be included as a "Reason:" line in failure
+/// messages.
+///
+/// ```dart
+/// check(actual).equals(expected);
+/// ```
+@meta.useResult
+Subject<T> check<T>(T value, {String? because}) => Subject._(_TestContext._root(
+ value: _Present(value),
+ // TODO - switch between "a" and "an"
+ label: 'a $T',
+ fail: (f) {
+ final which = f.rejection.which;
+ throw TestFailure([
+ ...prefixFirst('Expected: ', f.detail.expected),
+ ...prefixFirst('Actual: ', f.detail.actual),
+ ...indent(
+ prefixFirst('Actual: ', f.rejection.actual), f.detail.depth),
+ if (which != null && which.isNotEmpty)
+ ...indent(prefixFirst('Which: ', which), f.detail.depth),
+ if (because != null) 'Reason: $because',
+ ].join('\n'));
+ },
+ allowAsync: true,
+ allowUnawaited: true,
+ ));
+
+/// Checks whether [value] satisfies all expectations invoked in [condition],
+/// without throwing an exception.
+///
+/// Returns `null` if all expectations are satisfied, otherwise returns the
+/// [CheckFailure] for the first expectation that fails.
+///
+/// Asynchronous expectations are not allowed in [condition] and will cause a
+/// runtime error if they are used.
+CheckFailure? softCheck<T>(T value, Condition<T> condition) {
+ CheckFailure? failure;
+ final subject = Subject<T>._(_TestContext._root(
+ value: _Present(value),
+ fail: (f) {
+ failure ??= f;
+ },
+ allowAsync: false,
+ allowUnawaited: false,
+ ));
+ condition(subject);
+ return failure;
+}
+
+/// Checks whether [value] satisfies all expectations invoked in [condition],
+/// without throwing an exception.
+///
+/// The future will complete to `null` if all expectations are satisfied,
+/// otherwise it will complete to the [CheckFailure] for the first expectation
+/// that fails.
+///
+/// In contrast to [softCheck], asynchronous expectations are allowed in
+/// [condition].
+Future<CheckFailure?> softCheckAsync<T>(
+ T value, AsyncCondition<T> condition) async {
+ CheckFailure? failure;
+ final subject = Subject<T>._(_TestContext._root(
+ value: _Present(value),
+ fail: (f) {
+ failure ??= f;
+ },
+ allowAsync: true,
+ allowUnawaited: false,
+ ));
+ await condition(subject);
+ return failure;
+}
+
+/// Creates a description of the expectations checked by [condition].
+///
+/// The strings are individual lines of a description.
+/// The description of an expectation may be one or more adjacent lines.
+///
+/// Matches the "Expected: " lines in the output of a failure message if a value
+/// did not meet the last expectation in [condition], without the first labeled
+/// line.
+///
+/// Asynchronous expectations are not allowed in [condition], for async
+/// conditions use [describeAsync].
+Iterable<String> describe<T>(Condition<T> condition) {
+ final context = _TestContext<T>._root(
+ value: _Absent(),
+ fail: (_) {
+ throw UnimplementedError();
+ },
+ allowAsync: false,
+ allowUnawaited: true,
+ );
+ condition(Subject._(context));
+ return context.detail(context).expected.skip(1);
+}
+
+/// Creates a description of the expectations checked by [condition].
+///
+/// The strings are individual lines of a description.
+/// The description of an expectation may be one or more adjacent lines.
+///
+/// Matches the "Expected: " lines in the output of a failure message if a value
+/// did not meet the last expectation in [condition], without the first labeled
+/// line.
+///
+/// In contrast to [describe], asynchronous expectations are allowed in
+/// [condition].
+Future<Iterable<String>> describeAsync<T>(AsyncCondition<T> condition) async {
+ final context = _TestContext<T>._root(
+ value: _Absent(),
+ fail: (_) {
+ throw UnimplementedError();
+ },
+ allowAsync: true,
+ allowUnawaited: true,
+ );
+ await condition(Subject._(context));
+ return context.detail(context).expected.skip(1);
+}
+
+extension ContextExtension<T> on Subject<T> {
+ /// The expectations and nesting context for this subject.
+ Context<T> get context => _context;
+}
+
+/// The context for a [Subject] that allows asserting expectations and creating
+/// nested subjects.
+///
+/// A [Subject] is the target for checking expectations in a test.
+/// Every subject has a [Context] which holds the "actual" value, tracks how the
+/// value was obtained, and can check expectations about the value.
+///
+/// The user focused APIs called within tests are expectation extension methods
+/// written in an extension `on Subject`, typically specialized to a specific
+/// generic.
+///
+/// Expectation extension methods will make a call to one of the APIs on the
+/// subject's [Context], and can perform one of two types of operations:
+///
+/// - Expect something of the current value (such as [CoreChecks.equals] or
+/// [IterableChecks.contains]) by calling [expect], [expectAsync], or
+/// [expectUnawaited].
+/// - Expect that a new subject can be extracted from the current value (such
+/// as [CoreChecks.has] or [FutureChecks.completes]) by calling [nest] or
+/// [nestAsync].
+///
+///
+/// Whichever type of operation, an expectation extension method provides two
+/// callbacks.
+/// The first callback is an `Iterable<String> Function()` returning a
+/// description of the expectation.
+/// The second callback always takes the actual value as an argument, and the
+/// specific signature varies by operation.
+///
+///
+/// In expectation extension methods calling [expect], [expectAsync], or
+/// [expectUnawaited], the `predicate` callback can report a [Rejection] if the
+/// value fails to satisfy the expectation.
+/// The description will be passed in a "clause" callback.
+/// {@template clause_description}
+/// The clause callback returns a description of what is checked which stands
+/// on its own.
+/// For instance the `is equal to <1>` in:
+///
+/// ```
+/// Expected: a int that:
+/// is equal to <1>
+/// ```
+/// {@endtemplate}
+///
+///
+/// In expectation extension methods calling [nest] or [nestAsync], the
+/// `extract` callback can return a [Extracted.rejection] if the value fails to
+/// satisfy an expectation which disallows extracting the value, or an
+/// [Extracted.value] to become the value in a nested subject.
+/// The description will be passed in a "label" callback.
+/// {@template label_description}
+/// The label callback returns a description of the extracted subject as it
+/// relates to the original subject.
+/// For instance the `completes to a value` in:
+///
+/// ```
+/// Expected a Future<int> that:
+/// completes to a value that:
+/// is equal to <1>
+/// ```
+///
+/// A label should also be sensible when it is read as a clause.
+/// If no further expectations are checked on the extracted subject, or if the
+/// extraction is rejected, the "that:" is omitted in the output.
+///
+/// ```
+/// Expected a Future<int> that:
+/// completes to a value
+/// ```
+/// {@endtemplate}
+///
+///
+/// A rejection carries two descriptions, one description of the "actual" value
+/// that was tested, and an optional "which" with further details about how the
+/// result different from the expectation.
+/// If the "actual" argument is omitted it will be filled with a representation
+/// of the value passed to the expectation callback formatted with [literal].
+/// If an expectation extension method is written on a type of subject without a
+/// useful `toString()`, the rejection can provide a string representation to
+/// use instead.
+/// The "which" argument may be omitted if the reason is very obvious based on
+/// the clause and "actual" description, but most expectations should include a
+/// "which".
+///
+/// The behavior of a context following a rejection depends on the source of the
+/// [Subject].
+///
+/// When an expectation is rejected for a [check] subject, an exception is
+/// thrown to interrupt the test, so no further checks should happen. The
+/// failure message will include:
+/// - An "Expected" section with descriptions of all the expectations that
+/// were checked, including the ones that passed, and the last one that
+/// failed.
+/// - An "Actual" section, which may be the description directly from the
+/// [Rejection] if the failure was on the root subject, or may start with a
+/// partial version of the "Expected" description up to the label for the
+/// nesting subject that saw a failure, then the "actual" from the rejection.
+/// - A "Which" description from the rejection, if it was included.
+///
+/// For example, if a failure happens on the root subject, the "actual" is taken
+/// directly from the rejection.
+///
+/// ```
+/// Expected: a Future<int> that:
+/// completes to a value
+/// Actual: a future that completes as an error
+/// Which: threw <UnimplementedError> at:
+/// <stack trace>
+/// ```
+///
+/// But if the failure happens on a nested subject, the actual starts with a
+/// description of the nesting or non-nesting expectations that succeeded, up
+/// to nesting point of the failure, then the "actual" and "which" from the
+/// rejection are indented to that level of nesting.
+///
+/// ```
+/// Expected: a Future<int> that:
+/// completes to a value that:
+/// equals <1>
+/// Actual: a Future<int> that:
+/// completes to a value that:
+/// Actual: <0>
+/// Which: are not equal
+/// ```
+///
+/// ```dart
+/// extension CustomChecks on Subject<CustomType> {
+/// void someExpectation() {
+/// context.expect(() => ['meets this expectation'], (actual) {
+/// if (_expectationIsMet(actual)) return null;
+/// return Rejection(which: ['does not meet this expectation']);
+/// });
+/// }
+///
+/// Subject<Foo> get someDerivedValue =>
+/// context.nest('has someDerivedValue', (actual) {
+/// if (_cannotReadDerivedValue(actual)) {
+/// return Extracted.rejection(which: ['cannot read someDerivedValue']);
+/// }
+/// return Extracted.value(_readDerivedValue(actual));
+/// });
+///
+/// // for field reads that will not get rejected, use `has`
+/// Subject<Bar> get someField => has((a) => a.someField, 'someField');
+/// }
+/// ```
+///
+/// When an expectation is rejected for a subject within a call to [softCheck]
+/// or [softCheckAsync] a [CheckFailure] will be returned with the rejection, as
+/// well as a [FailureDetail] which could be used to format the same failure
+/// message thrown by the [check] subject.
+///
+/// {@template callbacks_may_be_unused}
+/// The description of an expectation may never be shown to the user, so the
+/// callback may never be invoked.
+/// If all the conditions on a subject succeed, or if the failure detail for a
+/// failed [softCheck] is never read, the descriptions will be unused.
+/// String formatting for the descriptions should be performed in the callback,
+/// not ahead of time.
+///
+///
+/// The context for a subject may hold a real "actual" value to test against, or
+/// it may have a placeholder within a call to [describe].
+/// A context with a placeholder value will not invoke the callback to check
+/// expectations.
+///
+/// If both callbacks are invoked, the description callback will always be
+/// called strictly after the expectation callback is called.
+///
+/// Callbacks passed to a context should not throw.
+/// {@endtemplate}
+///
+///
+/// Some contexts disallow certain interactions.
+/// {@template async_limitations}
+/// Calls to [expectAsync] or [nestAsync] must not be performed by a condition
+/// callback passed to [softCheck] or [describe].
+/// Use [softCheckAsync] or [describeAsync] for any condition which checks async
+/// expectations.
+/// {@endtemplate}
+/// {@template unawaited_limitations}
+/// Calls to [expectUnawaited] may not be performed by a condition callback
+/// passed to [softCheck] or [softCheckAsync].
+/// {@endtemplate}
+///
+/// Expectation extension methods can access the context for the subject with
+/// the [ContextExtension].
+///
+/// {@template description_lines}
+/// Description callbacks return an `Iterable<String>` where each element is a
+/// line in the output. Individual elements should not contain newlines.
+/// Utilities such as [prefixFirst], [postfixLast], and [literal] may be useful
+/// to format values which are potentially multiline.
+/// {@endtemplate}
+abstract final class Context<T> {
+ /// Expect that [predicate] will not return a [Rejection] for the checked
+ /// value.
+ ///
+ /// {@macro clause_description}
+ ///
+ /// {@macro description_lines}
+ ///
+ /// {@macro callbacks_may_be_unused}
+ ///
+ /// ```dart
+ /// void someExpectation() {
+ /// context.expect(() => ['meets this expectation'], (actual) {
+ /// if (_expectationIsMet(actual)) return null;
+ /// return Rejection(which: ['does not meet this expectation']);
+ /// });
+ /// }
+ /// ```
+ void expect(
+ Iterable<String> Function() clause, Rejection? Function(T) predicate);
+
+ /// Expect that [predicate] will not result in a [Rejection] for the checked
+ /// value.
+ ///
+ /// {@macro clause_description}
+ ///
+ /// {@macro description_lines}
+ ///
+ /// {@macro callbacks_may_be_unused}
+ ///
+ /// {@macro async_limitations}
+ ///
+ /// ```dart
+ /// extension CustomChecks on Subject<CustomType> {
+ /// Future<void> someAsyncExpectation() async {
+ /// await context.expectAsync(() => ['meets this async expectation'],
+ /// (actual) async {
+ /// if (await _expectationIsMet(actual)) return null;
+ /// return Rejection(which: ['does not meet this async expectation']);
+ /// });
+ /// }
+ /// }
+ /// ```
+ Future<void> expectAsync(Iterable<String> Function() clause,
+ FutureOr<Rejection?> Function(T) predicate);
+
+ /// Expect that [predicate] will not invoke the passed callback with a
+ /// [Rejection] at any point.
+ ///
+ /// In contrast to [expectAsync], a rejection is reported through a
+ /// callback instead of through a returned Future. The callback may be invoked
+ /// at any point that the failure surfaces.
+ ///
+ /// This may be useful for a condition checking that some event _never_
+ /// happens. If there is no specific point where it is know to be safe to stop
+ /// listening for the event, there is no way to complete a returned future and
+ /// consider the check "complete".
+ ///
+ /// {@macro clause_description}
+ ///
+ /// {@macro description_lines}
+ ///
+ /// {@macro callbacks_may_be_unused}
+ ///
+ /// {@macro unawaited_limitations}
+ /// The only useful effect of a late rejection is to throw a [TestFailure]
+ /// when used with a [check] subject. Most conditions should prefer to use
+ /// [expect] or [expectAsync].
+ ///
+ /// ```dart
+ /// void someUnawaitableExpectation() async {
+ /// await context.expectUnawaited(
+ /// () => ['meets this unawaitable expectation'], (actual, reject) {
+ /// final failureSignal = _completeIfFailed(actual);
+ /// unawaited(failureSignal.then((_) {
+ /// reject(Reject(
+ /// which: ['unexpectedly failed this unawaited expectation']));
+ /// }));
+ /// });
+ /// }
+ /// ```
+ void expectUnawaited(Iterable<String> Function() clause,
+ void Function(T, void Function(Rejection)) predicate);
+
+ /// Extract a property from the value for further checking.
+ ///
+ /// If the property cannot be extracted, [extract] should return an
+ /// [Extracted.rejection] describing the problem. Otherwise it should return
+ /// an [Extracted.value].
+ ///
+ /// Subsequent expectations can be checked for the extracted value on the
+ /// returned [Subject].
+ ///
+ /// {@macro label_description}
+ ///
+ /// If [atSameLevel] is true then the returned [Extracted.value] should hold
+ /// the same instance as the passed value, or an object which is is equivalent
+ /// but has a type that is more convenient to test.
+ /// In this case expectations applied to the returned [Subject] will behave as
+ /// if they were applied to the subject for this context.
+ /// The [label] will be used as if it were a "clause" argument passed to
+ /// [expect].
+ /// If the label returns an empty iterable, the clause will be omitted.
+ /// The label should only be left empty if the value extraction cannot be
+ /// rejected.
+ ///
+ /// {@macro description_lines}
+ ///
+ /// {@macro callbacks_may_be_unused}
+ ///
+ /// ```dart
+ /// Subject<Foo> get someDerivedValue =>
+ /// context.nest(() => ['has someDerivedValue'], (actual) {
+ /// if (_cannotReadDerivedValue(actual)) {
+ /// return Extracted.rejection(
+ /// which: ['cannot read someDerivedValue']);
+ /// }
+ /// return Extracted.value(_readDerivedValue(actual));
+ /// });
+ /// ```
+ Subject<R> nest<R>(
+ Iterable<String> Function() label, Extracted<R> Function(T) extract,
+ {bool atSameLevel = false});
+
+ /// Extract an asynchronous property from the value for further checking.
+ ///
+ /// If the property cannot be extracted, [extract] should return an
+ /// [Extracted.rejection] describing the problem. Otherwise it should return
+ /// an [Extracted.value].
+ ///
+ /// In contrast to [nest], subsequent expectations need to be passed in
+ /// [nestedCondition] which will be applied to the subject for the extracted
+ /// value.
+ ///
+ /// {@macro label_description}
+ ///
+ /// {@macro description_lines}
+ ///
+ /// {@macro callbacks_may_be_unused}
+ ///
+ /// {@macro async_limitations}
+ ///
+ /// ```dart
+ /// Future<void> someAsyncResult(
+ /// [AsyncCondition<Result> resultCondition]) async {
+ /// await context.nestAsync(() => ['has someAsyncResult'], (actual) async {
+ /// if (await _asyncOperationFailed(actual)) {
+ /// return Extracted.rejection(which: ['cannot read someAsyncResult']);
+ /// }
+ /// return Extracted.value(await _readAsyncResult(actual));
+ /// }, resultCondition);
+ /// }
+ /// ```
+ Future<void> nestAsync<R>(
+ Iterable<String> Function() label,
+ FutureOr<Extracted<R>> Function(T) extract,
+ AsyncCondition<R>? nestedCondition);
+}
+
+/// A property extracted from a value being checked, or a rejection.
+final class Extracted<T> {
+ final Rejection? _rejection;
+ final T? _value;
+
+ /// Creates a rejected extraction to indicate a failure trying to read the
+ /// value.
+ ///
+ /// When a nesting is rejected with an omitted or empty [actual] argument, it
+ /// will be filled in with the [literal] representation of the value.
+ Extracted.rejection(
+ {Iterable<String> actual = const [], Iterable<String>? which})
+ : _rejection = Rejection(actual: actual, which: which),
+ _value = null;
+ Extracted.value(T this._value) : _rejection = null;
+
+ Extracted._(Rejection this._rejection) : _value = null;
+
+ Extracted<R> _map<R>(R Function(T) transform) {
+ final rejection = _rejection;
+ if (rejection != null) return Extracted._(rejection);
+ return Extracted.value(transform(_value as T));
+ }
+
+ Extracted<T> _fillActual(Object? actual) => _rejection == null ||
+ _rejection.actual.isNotEmpty
+ ? this
+ : Extracted.rejection(actual: literal(actual), which: _rejection.which);
+}
+
+abstract interface class _Optional<T> {
+ R? apply<R extends FutureOr<Rejection?>>(R Function(T) callback);
+ Future<Extracted<_Optional<R>>> mapAsync<R>(
+ FutureOr<Extracted<R>> Function(T) transform);
+ Extracted<_Optional<R>> map<R>(Extracted<R> Function(T) transform);
+}
+
+class _Present<T> implements _Optional<T> {
+ final T value;
+ _Present(this.value);
+
+ @override
+ R? apply<R extends FutureOr<Rejection?>>(R Function(T) c) => c(value);
+
+ @override
+ Future<Extracted<_Present<R>>> mapAsync<R>(
+ FutureOr<Extracted<R>> Function(T) transform) async {
+ final transformed = await transform(value);
+ return transformed._map(_Present.new);
+ }
+
+ @override
+ Extracted<_Present<R>> map<R>(Extracted<R> Function(T) transform) =>
+ transform(value)._map(_Present.new);
+}
+
+class _Absent<T> implements _Optional<T> {
+ @override
+ R? apply<R extends FutureOr<Rejection?>>(R Function(T) c) => null;
+
+ @override
+ Future<Extracted<_Absent<R>>> mapAsync<R>(
+ FutureOr<Extracted<R>> Function(T) transform) async =>
+ Extracted.value(_Absent<R>());
+
+ @override
+ Extracted<_Absent<R>> map<R>(FutureOr<Extracted<R>> Function(T) transform) =>
+ Extracted.value(_Absent<R>());
+}
+
+final class _TestContext<T> implements Context<T>, _ClauseDescription {
+ final _Optional<T> _value;
+
+ /// A reference to find the root context which this context is nested under.
+ ///
+ /// null only for the root context.
+ final _TestContext<dynamic>? _parent;
+
+ final List<_ClauseDescription> _clauses;
+ final List<_TestContext> _aliases;
+
+ final void Function(CheckFailure) _fail;
+
+ final bool _allowAsync;
+ final bool _allowUnawaited;
+
+ /// A callback that returns a label for this context.
+ ///
+ /// If this context is the root the label should return a phrase like
+ /// "a List" in
+ ///
+ /// ```
+ /// Expected: a List that:
+ /// ```
+ ///
+ /// If this context is nested under another context the lable should return a
+ /// phrase like "completes to a value" in
+ ///
+ ///
+ /// ```
+ /// Expected: a Future<int> that:
+ /// completes to a value that:
+ /// ```
+ ///
+ /// In cases where a nested context does not have any expectations checked on
+ /// it, the "that:" will be will be omitted.
+ final Iterable<String> Function() _label;
+
+ static Iterable<String> _emptyLabel() => const [];
+
+ /// Create a context appropriate for a subject which is not nested under any
+ /// other subject.
+ _TestContext._root({
+ required _Optional<T> value,
+ required void Function(CheckFailure) fail,
+ required bool allowAsync,
+ required bool allowUnawaited,
+ String? label,
+ }) : _value = value,
+ _label = (() => [label ?? '']),
+ _fail = fail,
+ _allowAsync = allowAsync,
+ _allowUnawaited = allowUnawaited,
+ _parent = null,
+ _clauses = [],
+ _aliases = [];
+
+ _TestContext._alias(_TestContext original, this._value)
+ : _parent = original,
+ _clauses = original._clauses,
+ _aliases = original._aliases,
+ _fail = original._fail,
+ _allowAsync = original._allowAsync,
+ _allowUnawaited = original._allowUnawaited,
+ // Never read from an aliased context because they are never present in
+ // `_clauses`.
+ _label = _emptyLabel;
+
+ /// Create a context nested under [parent].
+ ///
+ /// The [_label] callback should not return an empty iterable.
+ _TestContext._child(this._value, this._label, _TestContext<dynamic> parent)
+ : _parent = parent,
+ _fail = parent._fail,
+ _allowAsync = parent._allowAsync,
+ _allowUnawaited = parent._allowUnawaited,
+ _clauses = [],
+ _aliases = [];
+
+ @override
+ void expect(
+ Iterable<String> Function() clause, Rejection? Function(T) predicate) {
+ _clauses.add(_ExpectationClause(clause));
+ final rejection =
+ _value.apply((actual) => predicate(actual)?._fillActual(actual));
+ if (rejection != null) {
+ _fail(_failure(rejection));
+ }
+ }
+
+ @override
+ Future<void> expectAsync(Iterable<String> Function() clause,
+ FutureOr<Rejection?> Function(T) predicate) async {
+ if (!_allowAsync) {
+ throw StateError(
+ 'Async expectations cannot be used on a synchronous subject');
+ }
+ _clauses.add(_ExpectationClause(clause));
+ final outstandingWork = TestHandle.current.markPending();
+ try {
+ final rejection = await _value.apply(
+ (actual) async => (await predicate(actual))?._fillActual(actual));
+ if (rejection == null) return;
+ _fail(_failure(rejection));
+ } finally {
+ outstandingWork.complete();
+ }
+ }
+
+ @override
+ void expectUnawaited(Iterable<String> Function() clause,
+ void Function(T actual, void Function(Rejection) reject) predicate) {
+ if (!_allowUnawaited) {
+ throw StateError('Late expectations cannot be used for soft checks');
+ }
+ _clauses.add(_ExpectationClause(clause));
+ _value.apply((actual) {
+ predicate(actual, (r) => _fail(_failure(r._fillActual(actual))));
+ });
+ }
+
+ @override
+ Subject<R> nest<R>(
+ Iterable<String> Function() label, Extracted<R> Function(T) extract,
+ {bool atSameLevel = false}) {
+ final result = _value.map((actual) => extract(actual)._fillActual(actual));
+ final rejection = result._rejection;
+ if (rejection != null) {
+ _clauses.add(_ExpectationClause(label));
+ _fail(_failure(rejection));
+ }
+ final value = result._value ?? _Absent<R>();
+ final _TestContext<R> context;
+ if (atSameLevel) {
+ context = _TestContext._alias(this, value);
+ _aliases.add(context);
+ _clauses.add(_ExpectationClause(label));
+ } else {
+ context = _TestContext._child(value, label, this);
+ _clauses.add(context);
+ }
+ return Subject._(context);
+ }
+
+ @override
+ Future<void> nestAsync<R>(
+ Iterable<String> Function() label,
+ FutureOr<Extracted<R>> Function(T) extract,
+ AsyncCondition<R>? nestedCondition) async {
+ if (!_allowAsync) {
+ throw StateError(
+ 'Async expectations cannot be used on a synchronous subject');
+ }
+ final outstandingWork = TestHandle.current.markPending();
+ try {
+ final result = await _value.mapAsync(
+ (actual) async => (await extract(actual))._fillActual(actual));
+ final rejection = result._rejection;
+ if (rejection != null) {
+ _clauses.add(_ExpectationClause(label));
+ _fail(_failure(rejection));
+ }
+ final value = result._value ?? _Absent<R>();
+ final context = _TestContext<R>._child(value, label, this);
+ _clauses.add(context);
+ await nestedCondition?.call(Subject<R>._(context));
+ } finally {
+ outstandingWork.complete();
+ }
+ }
+
+ CheckFailure _failure(Rejection rejection) =>
+ CheckFailure(rejection, () => _root.detail(this));
+
+ _TestContext get _root {
+ _TestContext<dynamic> current = this;
+ while (current._parent != null) {
+ current = current._parent;
+ }
+ return current;
+ }
+
+ @override
+ FailureDetail detail(_TestContext failingContext) {
+ final thisContextFailed =
+ identical(failingContext, this) || _aliases.contains(failingContext);
+ var foundDepth = thisContextFailed ? 0 : -1;
+ var foundOverlap = thisContextFailed ? 0 : -1;
+ var successfulOverlap = 0;
+ final expected = <String>[];
+ if (_clauses.isEmpty) {
+ expected.addAll(_label());
+ } else {
+ expected.addAll(postfixLast(' that:', _label()));
+ for (var clause in _clauses) {
+ final details = clause.detail(failingContext);
+ expected.addAll(indent(details.expected));
+ if (details.depth >= 0) {
+ assert(foundDepth == -1);
+ assert(foundOverlap == -1);
+ foundDepth = details.depth + 1;
+ foundOverlap = details._actualOverlap + successfulOverlap + 1;
+ } else {
+ if (foundDepth == -1) {
+ successfulOverlap += details.expected.length;
+ }
+ }
+ }
+ }
+ return FailureDetail(expected, foundOverlap, foundDepth);
+ }
+}
+
+/// A context which never runs expectations and can never fail.
+final class _SkippedContext<T> implements Context<T> {
+ @override
+ void expect(
+ Iterable<String> Function() clause, Rejection? Function(T) predicate) {
+ // no-op
+ }
+
+ @override
+ Future<void> expectAsync(Iterable<String> Function() clause,
+ FutureOr<Rejection?> Function(T) predicate) async {
+ // no-op
+ }
+
+ @override
+ void expectUnawaited(Iterable<String> Function() clause,
+ void Function(T actual, void Function(Rejection) reject) predicate) {
+ // no-op
+ }
+
+ @override
+ Subject<R> nest<R>(
+ Iterable<String> Function() label, Extracted<R> Function(T p1) extract,
+ {bool atSameLevel = false}) {
+ return Subject._(_SkippedContext());
+ }
+
+ @override
+ Future<void> nestAsync<R>(
+ Iterable<String> Function() label,
+ FutureOr<Extracted<R>> Function(T p1) extract,
+ AsyncCondition<R>? nestedCondition) async {
+ // no-op
+ }
+}
+
+abstract interface class _ClauseDescription {
+ FailureDetail detail(_TestContext failingContext);
+}
+
+class _ExpectationClause implements _ClauseDescription {
+ final Iterable<String> Function() _expected;
+ _ExpectationClause(this._expected);
+ @override
+ FailureDetail detail(_TestContext failingContext) =>
+ FailureDetail(_expected(), -1, -1);
+}
+
+/// The result an expectation that failed for a subject..
+final class CheckFailure {
+ /// The specific rejected value within the overall subject that caused the
+ /// failure.
+ ///
+ /// The [Rejection.actual] may be a property derived from the value at the
+ /// root of the subject, for instance a field or an element in a collection.
+ final Rejection rejection;
+
+ /// The context within the overall subject where an expectation resulted in
+ /// the [rejection].
+ late final FailureDetail detail = _readDetail();
+
+ final FailureDetail Function() _readDetail;
+
+ CheckFailure(this.rejection, this._readDetail);
+}
+
+/// The context for a failed expectation.
+///
+/// A subject may have some number of succeeding expectations, and the failure may
+/// be for an expectation against a property derived from the value at the root
+/// of the subject. For example, in `check([]).length.equals(1)` the
+/// specific value that gets rejected is `0` from the length of the list, and
+/// the subject that sees the rejection is nested with the label "has length".
+final class FailureDetail {
+ /// A description of all the conditions the subject was expected to satisfy.
+ ///
+ /// Each subject has a label. At the root the label is typically "a
+ /// <Type>" and nested subjects get a label based on the condition
+ /// which extracted a property for further checks. Each level of nesting is
+ /// described as "<label> that:" followed by an indented list of the
+ /// expectations for that property.
+ ///
+ /// For example:
+ ///
+ /// a List that:
+ /// has length that:
+ /// equals <3>
+ final Iterable<String> expected;
+
+ /// A description of the conditions the checked value satisfied.
+ ///
+ /// Matches the format of [expected], except it will be cut off after the
+ /// label for the subject that had a failing expectation. For example, if the
+ /// equality check for the length of a list fails:
+ ///
+ /// a List that:
+ /// has length that:
+ ///
+ /// If the subject with a failing expectation is the root, returns an empty
+ /// list. Instead the "Actual: " value from the rejection can be used without
+ /// indentation.
+ Iterable<String> get actual =>
+ _actualOverlap > 0 ? expected.take(_actualOverlap + 1) : const [];
+
+ /// The number of lines from [expected] which describe conditions that were
+ /// successful.
+ ///
+ /// A failed expectation on a derived property may have some number of
+ /// expectations that were checked and satisfied starting from the root
+ /// subject. This field indicates how many lines of expectations were
+ /// successful.
+ final int _actualOverlap;
+
+ /// The number of times the failing subject was nested from the root subject.
+ ///
+ /// Indicates how far the "Actual: " and "Which: " lines from the [Rejection]
+ /// should be indented so that they are at the same level of indentation as
+ /// the label for the subject where the expectation failed.
+ ///
+ /// For example, if a `List` is expected to and have a certain length
+ /// [expected] may be:
+ ///
+ /// a List that:
+ /// has length that:
+ /// equals <3>
+ ///
+ /// If the actual value had an incorrect length, the [depth] will be `1` to
+ /// indicate that the failure occurred checking one of the expectations
+ /// against the `has length` label.
+ final int depth;
+
+ FailureDetail(this.expected, this._actualOverlap, this.depth);
+}
+
+/// A description of a value that failed an expectation.
+final class Rejection {
+ /// A description of the actual value as it relates to the expectation.
+ ///
+ /// This may use [literal] to show a String representation of the value, or it
+ /// may be a description of a specific aspect of the value. For instance an
+ /// expectation that a Future completes to a value may describe the actual as
+ /// "A Future that completes to an error".
+ ///
+ /// When a value is rejected with no [actual] argument, it will be filled in
+ /// with the [literal] representation of the value.
+ ///
+ /// Lines should be split to separate elements, and individual strings should
+ /// not contain newlines.
+ ///
+ /// This is printed following an "Actual: " label in the output of a failure
+ /// message. All lines in the message will be indented to the level of the
+ /// expectation in the description, and printed following the descriptions of
+ /// any expectations that have already passed.
+ final Iterable<String> actual;
+
+ /// A description of the way that [actual] failed to meet the expectation.
+ ///
+ /// An expectation can provide extra detail, or focus attention on a specific
+ /// part of the value. For instance when comparing multiple elements in a
+ /// collection, the rejection may describe that the value "has an unequal
+ /// value at index 3".
+ ///
+ /// Lines should be separate values in the iterable, if any element contains a
+ /// newline it may cause problems with indentation in the output.
+ ///
+ /// When provided, this is printed following a "Which: " label at the end of
+ /// the output for the failure message.
+ final Iterable<String>? which;
+
+ Rejection _fillActual(Object? value) => actual.isNotEmpty
+ ? this
+ : Rejection(actual: literal(value), which: which);
+
+ Rejection({this.actual = const [], this.which});
+}
diff --git a/pkgs/checks/lib/src/collection_equality.dart b/pkgs/checks/lib/src/collection_equality.dart
new file mode 100644
index 0000000..da6064a
--- /dev/null
+++ b/pkgs/checks/lib/src/collection_equality.dart
@@ -0,0 +1,431 @@
+// 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:collection';
+
+import '../context.dart';
+
+/// Returns a descriptive `which` for a rejection if the elements of [actual]
+/// are unequal to the elements of [expected].
+///
+/// {@template deep_collection_equals}
+/// Elements, keys, or values within [expected] which are a collections are
+/// deeply compared for equality with a collection in the same position within
+/// [actual]. Elements which are collection types are not compared with the
+/// native identity based equality or custom equality operator overrides.
+///
+/// Elements, keys, or values within [expected] which are [Condition] callbacks
+/// are run against the value in the same position within [actual].
+/// Condition callbacks must take a `Subject<Object?>` or `Subject<dynamic>` and
+/// may not use a more specific generic.
+/// Use `(Subject<Object?> s) => s.isA<Type>()` to check expectations for
+/// specific element types.
+/// Note also that the argument type `Subject<Object?>` cannot be inferred and
+/// must be explicit in the function definition.
+///
+/// Elements and values within [expected] which are any other type are compared
+/// using `operator ==` equality.
+///
+/// Deep equality checks for [Map] instances depend on the structure of the
+/// expected map.
+/// If all keys of the expectation are non-collection and non-condition values
+/// the keys are compared through the map instances with [Map.containsKey].
+///
+/// If any key in the expectation is a `Condition` or a collection type the map
+/// will be compared as a [Set] of entries where both the key and value must
+/// match.
+///
+/// Comparing sets or maps with complex keys has a runtime which is polynomial
+/// on the the size of those collections.
+/// These comparisons do not use [Set.contains] or [Map.containsKey],
+/// and there will not be runtime benefits from hashing.
+/// Custom collection behavior of `contains` is ignored.
+/// For example, it is not possible to distinguish between a `Set` and a
+/// `Set.identity`.
+///
+/// Collections may be nested to a maximum depth of 1000. Recursive collections
+/// are not allowed.
+/// {@endtemplate}
+Iterable<String>? deepCollectionEquals(Object actual, Object expected) {
+ try {
+ return _deepCollectionEquals(actual, expected, 0);
+ } on _ExceededDepthError {
+ return ['exceeds the depth limit of $_maxDepth'];
+ }
+}
+
+const _maxDepth = 1000;
+
+class _ExceededDepthError extends Error {}
+
+Iterable<String>? _deepCollectionEquals(
+ Object actual, Object expected, int depth) {
+ assert(actual is Iterable || actual is Map);
+ assert(expected is Iterable || expected is Map);
+
+ final queue = Queue.of([_Search(_Path.root(), actual, expected, depth)]);
+ while (queue.isNotEmpty) {
+ final toCheck = queue.removeFirst();
+ final currentActual = toCheck.actual;
+ final currentExpected = toCheck.expected;
+ final path = toCheck.path;
+ final currentDepth = toCheck.depth;
+ Iterable<String>? rejectionWhich;
+ if (currentExpected is Set) {
+ rejectionWhich = _findSetDifference(
+ currentActual, currentExpected, path, currentDepth);
+ } else if (currentExpected is Iterable) {
+ rejectionWhich = _findIterableDifference(
+ currentActual, currentExpected, path, queue, currentDepth);
+ } else {
+ currentExpected as Map;
+ rejectionWhich = _findMapDifference(
+ currentActual, currentExpected, path, queue, currentDepth);
+ }
+ if (rejectionWhich != null) return rejectionWhich;
+ }
+ return null;
+}
+
+List<String>? _findIterableDifference(Object? actual,
+ Iterable<Object?> expected, _Path path, Queue<_Search> queue, int depth) {
+ if (actual is! Iterable) {
+ return ['${path}is not an Iterable'];
+ }
+ var actualIterator = actual.iterator;
+ var expectedIterator = expected.iterator;
+ for (var index = 0;; index++) {
+ var actualNext = actualIterator.moveNext();
+ var expectedNext = expectedIterator.moveNext();
+ if (!expectedNext && !actualNext) break;
+ if (!expectedNext) {
+ return [
+ '${path}has more elements than expected',
+ 'expected an iterable with $index element(s)'
+ ];
+ }
+ if (!actualNext) {
+ return [
+ '${path}has too few elements',
+ 'expected an iterable with at least ${index + 1} element(s)'
+ ];
+ }
+ final difference = _compareValue(actualIterator.current,
+ expectedIterator.current, path, index, queue, depth);
+ if (difference != null) return difference;
+ }
+ return null;
+}
+
+List<String>? _compareValue(Object? actualValue, Object? expectedValue,
+ _Path path, Object? pathAppend, Queue<_Search> queue, int depth) {
+ if (expectedValue is Iterable || expectedValue is Map) {
+ if (depth + 1 > _maxDepth) throw _ExceededDepthError();
+ queue.addLast(_Search(
+ path.append(pathAppend), actualValue, expectedValue, depth + 1));
+ } else if (expectedValue is Condition) {
+ final failure = softCheck(actualValue, expectedValue);
+ if (failure != null) {
+ final which = failure.rejection.which;
+ return [
+ 'has an element ${path.append(pathAppend)}that:',
+ ...indent(failure.detail.actual.skip(1)),
+ ...indent(prefixFirst('Actual: ', failure.rejection.actual),
+ failure.detail.depth + 1),
+ if (which != null)
+ ...indent(prefixFirst('which ', which), failure.detail.depth + 1)
+ ];
+ }
+ } else {
+ if (actualValue != expectedValue) {
+ return [
+ ...prefixFirst('${path.append(pathAppend)}is ', literal(actualValue)),
+ ...prefixFirst('which does not equal ', literal(expectedValue))
+ ];
+ }
+ }
+ return null;
+}
+
+bool _elementMatches(Object? actual, Object? expected, int depth) {
+ if (expected == null) return actual == null;
+ if (expected is Iterable || expected is Map) {
+ if (++depth > _maxDepth) throw _ExceededDepthError();
+ return actual != null &&
+ _deepCollectionEquals(actual, expected, depth) == null;
+ }
+ if (expected is Condition) {
+ return softCheck(actual, expected) == null;
+ }
+ return expected == actual;
+}
+
+Iterable<String>? _findSetDifference(
+ Object? actual, Set<Object?> expected, _Path path, int depth) {
+ if (actual is! Set) {
+ return ['${path}is not a Set'];
+ }
+ return unorderedCompare(
+ actual,
+ expected,
+ (actual, expected) => _elementMatches(actual, expected, depth),
+ (expected, _, count) => [
+ ...prefixFirst('${path}has no element to match ', literal(expected)),
+ if (count > 1) 'or ${count - 1} other elements',
+ ],
+ (actual, _, count) => [
+ ...prefixFirst('${path}has an unexpected element ', literal(actual)),
+ if (count > 1) 'and ${count - 1} other unexpected elements',
+ ],
+ );
+}
+
+Iterable<String>? _findMapDifference(
+ Object? actual,
+ Map<Object?, Object?> expected,
+ _Path path,
+ Queue<_Search> queue,
+ int depth) {
+ if (actual is! Map) {
+ return ['${path}is not a Map'];
+ }
+ if (expected.keys
+ .any((key) => key is Condition || key is Iterable || key is Map)) {
+ return _findAmbiguousMapDifference(actual, expected, path, depth);
+ } else {
+ return _findUnambiguousMapDifference(actual, expected, path, queue, depth);
+ }
+}
+
+Iterable<String> _describeEntry(MapEntry<Object?, Object?> entry) {
+ final key = literal(entry.key);
+ final value = literal(entry.value);
+ return [
+ ...key.take(key.length - 1),
+ '${key.last}: ${value.first}',
+ ...value.skip(1)
+ ];
+}
+
+/// Returns a description of a difference found between [actual] and [expected]
+/// when [expected] has only direct key values and there is a 1:1 mapping
+/// between an expected value and a checked value in the map.
+Iterable<String>? _findUnambiguousMapDifference(
+ Map<Object?, Object?> actual,
+ Map<Object?, Object?> expected,
+ _Path path,
+ Queue<_Search> queue,
+ int depth) {
+ for (final entry in expected.entries) {
+ assert(entry.key is! Condition);
+ assert(entry.key is! Iterable);
+ assert(entry.key is! Map);
+ if (!actual.containsKey(entry.key)) {
+ return prefixFirst(
+ '${path}has no key matching expected entry ', _describeEntry(entry));
+ }
+ final difference = _compareValue(
+ actual[entry.key], entry.value, path, entry.key, queue, depth);
+ if (difference != null) return difference;
+ }
+ for (final entry in actual.entries) {
+ if (!expected.containsKey(entry.key)) {
+ return prefixFirst(
+ '${path}has an unexpected key for entry ', _describeEntry(entry));
+ }
+ }
+ return null;
+}
+
+Iterable<String>? _findAmbiguousMapDifference(Map<Object?, Object?> actual,
+ Map<Object?, Object?> expected, _Path path, int depth) =>
+ unorderedCompare(
+ actual.entries,
+ expected.entries,
+ (actual, expected) =>
+ _elementMatches(actual.key, expected.key, depth) &&
+ _elementMatches(actual.value, expected.value, depth),
+ (expectedEntry, _, count) => [
+ ...prefixFirst(
+ '${path}has no entry to match ', _describeEntry(expectedEntry)),
+ if (count > 1) 'or ${count - 1} other entries',
+ ],
+ (actualEntry, _, count) => [
+ ...prefixFirst(
+ '${path}has unexpected entry ', _describeEntry(actualEntry)),
+ if (count > 1) 'and ${count - 1} other unexpected entries',
+ ],
+ );
+
+class _Path {
+ final _Path? parent;
+ final Object? index;
+ _Path._(this.parent, this.index);
+ _Path.root()
+ : parent = null,
+ index = '';
+ _Path append(Object? index) => _Path._(this, index);
+
+ @override
+ String toString() {
+ if (parent == null && index == '') return '';
+ final stack = Queue.of([this]);
+ var current = parent;
+ while (current?.parent != null) {
+ stack.addLast(current!);
+ current = current.parent;
+ }
+ final result = StringBuffer('at ');
+ while (stack.isNotEmpty) {
+ result.write('[');
+ result.write(literal(stack.removeLast().index).join(r'\n'));
+ result.write(']');
+ }
+ result.write(' ');
+ return result.toString();
+ }
+}
+
+class _Search {
+ final _Path path;
+ final Object? actual;
+ final Object? expected;
+ final int depth;
+ _Search(this.path, this.actual, this.expected, this.depth);
+}
+
+/// Returns the `which` for a Rejection if there is no pairing between the
+/// elements of [actual] and [expected] using [elementsEqual].
+///
+/// If there are unmatched expected elements - either actual was too short, or
+/// has mismatched elements - returns a rejection reason from calling
+/// [unmatchedExpected] with an expected value that could not be paired, it's
+/// index, and the count of unmatched elements.
+///
+/// Otherwise, if there are unmatched actual elements - actual was too long -
+/// returns a rejection reason from calling [unmatchedActual] with an actual
+/// value that could not be paired, it's index, and the count of unmatched
+/// elements.
+///
+/// Runtime is at least `O(|actual||expected|)`, and for collections with many
+/// elements which compare as equal the runtime can reach
+/// `O((|actual| + |expected|)^2.5)`.
+Iterable<String>? unorderedCompare<T, E>(
+ Iterable<T> actual,
+ Iterable<E> expected,
+ bool Function(T, E) elementsEqual,
+ Iterable<String> Function(E, int index, int count) unmatchedExpected,
+ Iterable<String> Function(T, int index, int count) unmatchedActual) {
+ final indexedExpected = expected.toList();
+ final indexedActual = actual.toList();
+ final adjacency = <List<int>>[];
+ for (var i = 0; i < indexedExpected.length; i++) {
+ final expectedElement = indexedExpected[i];
+ final pairs = [
+ for (var j = 0; j < indexedActual.length; j++)
+ if (elementsEqual(indexedActual[j], expectedElement)) j
+ ];
+ adjacency.add(pairs);
+ }
+ final unpaired = _findUnpaired(adjacency, indexedActual.length);
+ if (unpaired.first.isNotEmpty) {
+ final firstUnmatched = indexedExpected[unpaired.first.first];
+ return unmatchedExpected(
+ firstUnmatched, unpaired.first.first, unpaired.first.length);
+ }
+ if (unpaired.last.isNotEmpty) {
+ final firstUnmatched = indexedActual[unpaired.last.first];
+ return unmatchedActual(
+ firstUnmatched, unpaired.last.first, unpaired.last.length);
+ }
+ return null;
+}
+
+/// Returns the indices which are unmatched in an optimal pairing in the
+/// bipartite graph represented by [adjacency].
+///
+/// Vertices are represented as integers. The two sets of vertices (`U` and `V`)
+/// in the biparte graph are represented as:
+/// - `U` - the indices of [adjacency].
+/// - `V` - values smaller than [rightVertexCount].
+///
+/// An edge from `U[n]` to `V[m]` is represented by the value `m` being present
+/// in the list at index `n`.
+/// The largest value within any list in [adjacency] must be smaller than
+/// [rightVertexCount].
+///
+/// Returns a List with two values, the unpaired values of `U` and `V` in the
+/// maximum-caridnality matching betweeen them.
+///
+/// If there is a perfect pairing, the returned lists will both be empty.
+///
+/// Uses the Hopcroft–Karp algorithm based on pseudocode from
+/// https://en.wikipedia.org/wiki/Hopcroft%E2%80%93Karp_algorithm
+List<List<int>> _findUnpaired(List<List<int>> adjacency, int rightVertexCount) {
+ final leftLength = adjacency.length;
+ final rightLength = rightVertexCount;
+ // The last index represents a "dummy vertex"
+ final distances = List<num>.filled(leftLength + 1, double.infinity);
+ // Initially everything is paired with the "dummy vertex" of the opposite set
+ final leftPairs = List.filled(leftLength, rightLength);
+ final rightPairs = List.filled(rightLength, leftLength);
+
+ bool bfs() {
+ final queue = Queue<int>();
+ for (var leftIndex = 0; leftIndex < leftLength; leftIndex++) {
+ if (leftPairs[leftIndex] == rightLength) {
+ distances[leftIndex] = 0;
+ queue.add(leftIndex);
+ } else {
+ distances[leftIndex] = double.infinity;
+ }
+ }
+ distances.last = double.infinity;
+ while (queue.isNotEmpty) {
+ final current = queue.removeFirst();
+ if (distances[current] < distances[leftLength]) {
+ for (final rightIndex in adjacency[current]) {
+ if (distances[rightPairs[rightIndex]].isInfinite) {
+ distances[rightPairs[rightIndex]] = distances[current] + 1;
+ queue.addLast(rightPairs[rightIndex]);
+ }
+ }
+ }
+ }
+ return !distances.last.isInfinite;
+ }
+
+ bool dfs(int leftIndex) {
+ if (leftIndex == leftLength) return true;
+ for (final rightIndex in adjacency[leftIndex]) {
+ if (distances[rightPairs[rightIndex]] == distances[leftIndex] + 1) {
+ if (dfs(rightPairs[rightIndex])) {
+ leftPairs[leftIndex] = rightIndex;
+ rightPairs[rightIndex] = leftIndex;
+ return true;
+ }
+ }
+ }
+ distances[leftIndex] = double.infinity;
+ return false;
+ }
+
+ while (bfs()) {
+ for (var leftIndex = 0; leftIndex < leftLength; leftIndex++) {
+ if (leftPairs[leftIndex] == rightLength) {
+ dfs(leftIndex);
+ }
+ }
+ }
+ return [
+ [
+ for (int i = 0; i < leftLength; i++)
+ if (leftPairs[i] == rightLength) i
+ ],
+ [
+ for (int i = 0; i < rightLength; i++)
+ if (rightPairs[i] == leftLength) i
+ ]
+ ];
+}
diff --git a/pkgs/checks/lib/src/describe.dart b/pkgs/checks/lib/src/describe.dart
new file mode 100644
index 0000000..f05a164
--- /dev/null
+++ b/pkgs/checks/lib/src/describe.dart
@@ -0,0 +1,163 @@
+// Copyright (c) 2022, 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:convert';
+
+import 'checks.dart' show Condition, describe;
+
+/// Returns a pretty-printed representation of [object].
+///
+/// When possible, lines will be kept under [_maxLineLength]. This isn't
+/// guaranteed, since individual objects may have string representations that
+/// are too long, but most lines will be less than [_maxLineLength] long.
+///
+/// [Iterable]s and [Map]s will only print their first [_maxItems] elements or
+/// key/value pairs, respectively.
+Iterable<String> literal(Object? object) => _prettyPrint(object, 0, {}, true);
+
+const _maxLineLength = 80;
+const _maxItems = 25;
+
+Iterable<String> _prettyPrint(
+ Object? object, int indentSize, Set<Object?> seen, bool isTopLevel) {
+ if (seen.contains(object)) return ['(recursive)'];
+ seen = seen.union({object});
+ Iterable<String> prettyPrintNested(Object? child) =>
+ _prettyPrint(child, indentSize + 2, seen, false);
+
+ if (object is Iterable) {
+ String open, close;
+ if (object is List) {
+ open = '[';
+ close = ']';
+ } else if (object is Set) {
+ open = '{';
+ close = '}';
+ } else {
+ open = '(';
+ close = ')';
+ }
+ final elements = object.map(prettyPrintNested).toList();
+ return _prettyPrintCollection(
+ open, close, elements, _maxLineLength - indentSize);
+ } else if (object is Map) {
+ final entries = object.entries.map((entry) {
+ final key = prettyPrintNested(entry.key);
+ final value = prettyPrintNested(entry.value);
+ return [
+ ...key.take(key.length - 1),
+ '${key.last}: ${value.first}',
+ ...value.skip(1)
+ ];
+ }).toList();
+ return _prettyPrintCollection(
+ '{', '}', entries, _maxLineLength - indentSize);
+ } else if (object is String) {
+ if (object.isEmpty) return ["''"];
+ final escaped = const LineSplitter()
+ .convert(object)
+ .map(escape)
+ .map((line) => line.replaceAll("'", r"\'"))
+ .toList();
+ return prefixFirst("'", postfixLast("'", escaped));
+ } else if (object is Condition<Never>) {
+ return ['<A value that:', ...postfixLast('>', describe(object))];
+ } else {
+ final value = const LineSplitter().convert(object.toString());
+ return isTopLevel ? prefixFirst('<', postfixLast('>', value)) : value;
+ }
+}
+
+Iterable<String> _prettyPrintCollection(
+ String open, String close, List<Iterable<String>> elements, int maxLength) {
+ if (elements.length > _maxItems) {
+ elements.replaceRange(_maxItems - 1, elements.length, [
+ ['...']
+ ]);
+ }
+ if (elements.every((e) => e.length == 1)) {
+ final singleLine = '$open${elements.map((e) => e.single).join(', ')}$close';
+ if (singleLine.length <= maxLength) {
+ return [singleLine];
+ }
+ }
+ if (elements.length == 1) {
+ return prefixFirst(open, postfixLast(close, elements.single));
+ }
+ return [
+ ...prefixFirst(open, postfixLast(',', elements.first)),
+ for (var element in elements.skip(1).take(elements.length - 2))
+ ...postfixLast(',', element),
+ ...postfixLast(close, elements.last),
+ ];
+}
+
+Iterable<String> indent(Iterable<String> lines, [int depth = 1]) {
+ final indent = ' ' * depth;
+ return lines.map((line) => '$indent$line');
+}
+
+/// Prepends [prefix] to the first line of [lines].
+///
+/// If [lines] is empty, the result will be as well. The prefix will not be
+/// returned for an empty input.
+Iterable<String> prefixFirst(String prefix, Iterable<String> lines) sync* {
+ var isFirst = true;
+ for (var line in lines) {
+ if (isFirst) {
+ yield '$prefix$line';
+ isFirst = false;
+ } else {
+ yield line;
+ }
+ }
+}
+
+/// Append [postfix] to the last line of [lines].
+///
+/// If [lines] is empty, the result will be as well. The postfix will not be
+/// returned for an empty input.
+Iterable<String> postfixLast(String postfix, Iterable<String> lines) sync* {
+ var iterator = lines.iterator;
+ var hasNext = iterator.moveNext();
+ while (hasNext) {
+ final line = iterator.current;
+ hasNext = iterator.moveNext();
+ yield hasNext ? line : '$line$postfix';
+ }
+}
+
+/// Returns [output] with all whitespace characters represented as their escape
+/// sequences.
+///
+/// Backslash characters are escaped as `\\`
+String escape(String output) {
+ output = output.replaceAll('\\', r'\\');
+ return output.replaceAllMapped(_escapeRegExp, (match) {
+ var mapped = _escapeMap[match[0]];
+ if (mapped != null) return mapped;
+ return _hexLiteral(match[0]!);
+ });
+}
+
+/// A [RegExp] that matches whitespace characters that should be escaped.
+final _escapeRegExp = RegExp(
+ '[\\x00-\\x07\\x0E-\\x1F${_escapeMap.keys.map(_hexLiteral).join()}]');
+
+/// A [Map] between whitespace characters and their escape sequences.
+const _escapeMap = {
+ '\n': r'\n',
+ '\r': r'\r',
+ '\f': r'\f',
+ '\b': r'\b',
+ '\t': r'\t',
+ '\v': r'\v',
+ '\x7F': r'\x7F', // delete
+};
+
+/// Given single-character string, return the hex-escaped equivalent.
+String _hexLiteral(String input) {
+ var rune = input.runes.single;
+ return r'\x' + rune.toRadixString(16).toUpperCase().padLeft(2, '0');
+}
diff --git a/pkgs/checks/lib/src/extensions/async.dart b/pkgs/checks/lib/src/extensions/async.dart
new file mode 100644
index 0000000..9d9e85a
--- /dev/null
+++ b/pkgs/checks/lib/src/extensions/async.dart
@@ -0,0 +1,476 @@
+// Copyright (c) 2022, 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 'dart:convert';
+
+import 'package:async/async.dart';
+
+import '../../context.dart';
+
+extension FutureChecks<T> on Subject<Future<T>> {
+ /// Expects that the `Future` completes to a value without throwing.
+ ///
+ /// Fails if the future completes as an error.
+ ///
+ /// Pass [completionCondition] to check expectations on the completion result.
+ ///
+ /// The returned future will complete when the subject future has completed,
+ /// and [completionCondition] has optionally been checked.
+ Future<void> completes([AsyncCondition<T>? completionCondition]) async {
+ await context.nestAsync<T>(() => ['completes to a value'], (actual) async {
+ try {
+ return Extracted.value(await actual);
+ } catch (e, st) {
+ return Extracted.rejection(actual: [
+ 'a future that completes as an error'
+ ], which: [
+ ...prefixFirst('threw ', postfixLast(' at:', literal(e))),
+ ...const LineSplitter().convert(st.toString())
+ ]);
+ }
+ }, completionCondition);
+ }
+
+ /// Expects that the `Future` never completes as a value or an error.
+ ///
+ /// Immediately returns and does not cause the test to remain running if it
+ /// ends.
+ /// If the future completes at any time, raises a test failure. This may
+ /// happen after the test has already appeared to succeed.
+ ///
+ /// Not compatible with [softCheck] or [softCheckAsync] since there is no
+ /// concrete end point where this condition has definitely succeeded.
+ void doesNotComplete() {
+ context.expectUnawaited(() => ['does not complete'], (actual, reject) {
+ unawaited(actual.then((r) {
+ reject(Rejection(
+ actual: prefixFirst('a future that completed to ', literal(r))));
+ }, onError: (Object e, StackTrace st) {
+ reject(Rejection(actual: [
+ 'a future that completed as an error:'
+ ], which: [
+ ...prefixFirst('threw ', literal(e)),
+ ...const LineSplitter().convert(st.toString())
+ ]));
+ }));
+ });
+ }
+
+ /// Expects that the `Future` completes as an error.
+ ///
+ /// Fails if the future completes to a value.
+ ///
+ /// Pass [errorCondition] to check expectations on the error thrown by the
+ /// future.
+ ///
+ /// The returned future will complete when the subject future has completed,
+ /// and [errorCondition] has optionally been checked.
+ Future<void> throws<E extends Object>(
+ [AsyncCondition<E>? errorCondition]) async {
+ await context.nestAsync<E>(
+ () => ['completes to an error${E == Object ? '' : ' of type $E'}'],
+ (actual) async {
+ try {
+ return Extracted.rejection(
+ actual: prefixFirst('completed to ', literal(await actual)),
+ which: ['did not throw']);
+ } on E catch (e) {
+ return Extracted.value(e);
+ } catch (e, st) {
+ return Extracted.rejection(
+ actual: prefixFirst('completed to error ', literal(e)),
+ which: [
+ 'threw an exception that is not a $E at:',
+ ...const LineSplitter().convert(st.toString())
+ ]);
+ }
+ }, errorCondition);
+ }
+}
+
+/// Expectations on a [StreamQueue].
+///
+/// Streams should be wrapped in user test code so that any reuse of the same
+/// Stream, and the full stream lifecycle, is explicit.
+extension StreamChecks<T> on Subject<StreamQueue<T>> {
+ /// Calls [Context.expectAsync] and wraps [predicate] with a transaction.
+ ///
+ /// The transaction is committed if the check passes, or rejected if it fails.
+ Future<void> _expectAsync(Iterable<String> Function() clause,
+ FutureOr<Rejection?> Function(StreamQueue<T>) predicate) =>
+ context.expectAsync(clause, (actual) async {
+ final transaction = actual.startTransaction();
+ final copy = transaction.newQueue();
+ final result = await predicate(copy);
+ if (result == null) {
+ transaction.commit(copy);
+ } else {
+ transaction.reject();
+ }
+ return result;
+ });
+
+ /// Expect that the `Stream` emits a value without first emitting an error.
+ ///
+ /// Fails if the stream emits an error instead of a value, or closes without
+ /// emitting a value.
+ ///
+ /// If an error is emitted the queue will be left in its original state, the
+ /// error will not be consumed.
+ /// If an event is emitted, it will be consumed from the queue.
+ ///
+ /// Pass [emittedCondition] to check expectations on the value emitted by the
+ /// stream.
+ ///
+ /// The returned future will complete when the stream has emitted, errored, or
+ /// ended, and the [emittedCondition] has optionally been checked.
+ Future<void> emits([AsyncCondition<T>? emittedCondition]) async {
+ await context.nestAsync<T>(() => ['emits a value'], (actual) async {
+ if (!await actual.hasNext) {
+ return Extracted.rejection(
+ actual: ['a stream'],
+ which: ['closed without emitting enough values']);
+ }
+ try {
+ await actual.peek;
+ return Extracted.value(await actual.next);
+ } catch (e, st) {
+ return Extracted.rejection(
+ actual: prefixFirst('a stream with error ', literal(e)),
+ which: [
+ 'emitted an error instead of a value at:',
+ ...const LineSplitter().convert(st.toString())
+ ]);
+ }
+ }, emittedCondition);
+ }
+
+ /// Expects that the stream emits an error of type [E].
+ ///
+ /// Fails if the stream emits any value.
+ /// Fails if the stream emits an error with an incorrect type.
+ /// Fails if the stream closes without emitting an error.
+ ///
+ /// If an event is emitted the queue will be left in its original state, the
+ /// event will not be consumed.
+ /// If an error is emitted, it will be consumed from the queue.
+ ///
+ /// Pass [errorCondition] to check expectations on the error emitted by the
+ /// stream.
+ ///
+ /// The returned future will complete when the stream has emitted, errored, or
+ /// ended, and the [errorCondition] has optionally been checked.
+ Future<void> emitsError<E extends Object>(
+ [AsyncCondition<E>? errorCondition]) async {
+ await context.nestAsync<E>(
+ () => ['emits an error${E == Object ? '' : ' of type $E'}'],
+ (actual) async {
+ if (!await actual.hasNext) {
+ return Extracted.rejection(
+ actual: ['a stream'],
+ which: ['closed without emitting an expected error']);
+ }
+ try {
+ final value = await actual.peek;
+ return Extracted.rejection(
+ actual: prefixFirst('a stream emitting value ', literal(value)),
+ which: ['closed without emitting an error']);
+ } on E catch (e) {
+ await actual.next.then<void>((_) {}, onError: (_) {});
+ return Extracted.value(e);
+ } catch (e, st) {
+ return Extracted.rejection(
+ actual: prefixFirst('a stream with error ', literal(e)),
+ which: [
+ 'emitted an error which is not $E at:',
+ ...const LineSplitter().convert(st.toString())
+ ]);
+ }
+ }, errorCondition);
+ }
+
+ /// Expects that the `Stream` emits any number of events before emitting an
+ /// event that satisfies [condition].
+ ///
+ /// Returns a `Future` that completes after the stream has emitted an event
+ /// that satisfies [condition].
+ ///
+ /// Fails if the stream emits an error or closes before emitting a matching
+ /// event.
+ ///
+ /// If this expectation fails, the source queue will be left in its original
+ /// state.
+ /// If this expectation succeeds, consumes the matching event and all prior
+ /// events.
+ Future<void> emitsThrough(AsyncCondition<T> condition) async {
+ await _expectAsync(
+ () => [
+ 'emits any values then emits a value that:',
+ ...describe(condition)
+ ], (actual) async {
+ var count = 0;
+ while (await actual.hasNext) {
+ if (softCheck(await actual.next, condition) == null) {
+ return null;
+ }
+ count++;
+ }
+ return Rejection(
+ actual: ['a stream'],
+ which: ['ended after emitting $count elements with none matching']);
+ });
+ }
+
+ /// Expects that the stream satisfies each condition in [conditions] serially.
+ ///
+ /// Waits for each condition to be satisfied or rejected before checking the
+ /// next. Subsequent conditions will not see any events consumed by earlier
+ /// conditions.
+ ///
+ /// ```dart
+ /// await check(someStream).withQueue.inOrder([
+ /// (s) => s.emits((e) => e.equals(0)),
+ /// (s) => s.emits((e) => e.equals(1)),
+ /// ]);
+ /// ```
+ ///
+ /// If this expectation fails, the source queue will be left in its original
+ /// state.
+ /// If this expectation succeeds, consumes as many events from the source
+ /// stream as are consumed by all the conditions.
+ Future<void> inOrder(
+ Iterable<AsyncCondition<StreamQueue<T>>> conditions) async {
+ conditions = conditions.toList();
+ final descriptions = <String>[];
+ await _expectAsync(
+ () => descriptions.isEmpty
+ ? ['satisfies ${conditions.length} conditions in order']
+ : descriptions, (actual) async {
+ var satisfiedCount = 0;
+ for (var condition in conditions) {
+ descriptions.addAll(await describeAsync(condition));
+ final failure = await softCheckAsync(actual, condition);
+ if (failure != null) {
+ final which = failure.rejection.which;
+ return Rejection(actual: [
+ 'a stream'
+ ], which: [
+ if (satisfiedCount > 0) 'satisfied $satisfiedCount conditions then',
+ 'failed to satisfy the condition at index $satisfiedCount',
+ if (failure.detail.depth > 0) ...[
+ 'because it:',
+ ...indent(
+ failure.detail.actual.skip(1), failure.detail.depth - 1),
+ ...indent(prefixFirst('Actual: ', failure.rejection.actual),
+ failure.detail.depth),
+ if (which != null)
+ ...indent(prefixFirst('Which: ', which), failure.detail.depth),
+ ] else ...[
+ if (which != null) ...prefixFirst('because it ', which),
+ ],
+ ]);
+ }
+ satisfiedCount++;
+ }
+ return null;
+ });
+ }
+
+ /// Expects that the stream statisfies at least one condition from
+ /// [conditions].
+ ///
+ /// If this expectation fails, the source queue will be left in its original
+ /// state.
+ /// If this expectation succeeds, consumes the same events from the source
+ /// queue as the satisfied condition. If multiple conditions are satisfied,
+ /// chooses the condition which consumed the most events.
+ Future<void> anyOf(
+ Iterable<AsyncCondition<StreamQueue<T>>> conditions) async {
+ conditions = conditions.toList();
+ if (conditions.isEmpty) {
+ throw ArgumentError('conditions may not be empty');
+ }
+ final descriptions = <Iterable<String>>[];
+ await context.expectAsync(
+ () => descriptions.isEmpty
+ ? ['satisfies any of ${conditions.length} conditions']
+ : [
+ 'satisfies one of:',
+ for (var i = 0; i < descriptions.length; i++) ...[
+ ...descriptions[i],
+ if (i < descriptions.length - 1) 'or,'
+ ]
+ ], (actual) async {
+ final transaction = actual.startTransaction();
+ StreamQueue<T>? longestAccepted;
+ final descriptionFuture = Future.wait(conditions.map(describeAsync));
+ final failures = await Future.wait(conditions.map((condition) async {
+ final copy = transaction.newQueue();
+ final failure = await softCheckAsync(copy, condition);
+ if (failure == null &&
+ (longestAccepted == null ||
+ copy.eventsDispatched > longestAccepted!.eventsDispatched)) {
+ longestAccepted = copy;
+ }
+ return failure;
+ }));
+ descriptions.addAll(await descriptionFuture);
+ if (longestAccepted != null) {
+ transaction.commit(longestAccepted!);
+ return null;
+ }
+ transaction.reject();
+ Iterable<String> failureDetails(int index, CheckFailure? failure) {
+ final actual = failure!.rejection.actual;
+ final which = failure.rejection.which;
+ final detail = failure.detail;
+ final failed = 'failed the condition at index $index';
+ if (detail.depth > 0) {
+ return [
+ '$failed because it:',
+ ...indent(detail.actual.skip(1), detail.depth - 1),
+ ...indent(prefixFirst('Actual: ', actual), detail.depth),
+ if (which != null)
+ ...indent(prefixFirst('Which: ', which), detail.depth),
+ ];
+ } else {
+ return [
+ if (which == null)
+ failed
+ else ...[
+ '$failed because it:',
+ ...indent(which),
+ ],
+ ];
+ }
+ }
+
+ return Rejection(actual: [
+ 'a stream'
+ ], which: [
+ 'failed to satisfy any condition',
+ for (var i = 0; i < failures.length; i++)
+ ...failureDetails(i, failures[i]),
+ ]);
+ });
+ }
+
+ /// Expects that the stream closes without emitting any event that satisfies
+ /// [condition].
+ ///
+ /// Returns a `Future` that completes after the stream has closed.
+ ///
+ /// Fails if the stream emits any even that satisfies [condition].
+ ///
+ /// If this expectation fails, the source queue will be left in its original
+ /// state.
+ /// If this expectation succeeds, consumes all the events that did not satisfy
+ /// [condition] until the end of the stream.
+ Future<void> neverEmits(AsyncCondition<T> condition) async {
+ await _expectAsync(
+ () => ['never emits a value that:', ...describe(condition)],
+ (actual) async {
+ var count = 0;
+ await for (var emitted in actual.rest) {
+ if (softCheck(emitted, condition) == null) {
+ return Rejection(actual: [
+ 'a stream'
+ ], which: [
+ ...prefixFirst('emitted ', literal(emitted)),
+ if (count > 0) 'following $count other items'
+ ]);
+ }
+ count++;
+ }
+ return null;
+ });
+ }
+
+ /// Optionally consumes an event that matches [condition] from the stream.
+ ///
+ /// This expectation never fails.
+ ///
+ /// If a non-matching event is emitted, no events are consumed.
+ /// If a matching event is emitted, that event is consumed.
+ Future<void> mayEmit(AsyncCondition<T> condition) async {
+ await context
+ .expectAsync(() => ['may emit a value that:', ...describe(condition)],
+ (actual) async {
+ if (!await actual.hasNext) return null;
+ try {
+ final value = await actual.peek;
+ if (softCheck(value, condition) == null) {
+ await actual.next;
+ }
+ } catch (_) {
+ // Ignore an emitted error - it does not match he event.
+ }
+ return null;
+ });
+ }
+
+ /// Optionally consumes events that match [condition] from the stream.
+ ///
+ /// This expectation never fails.
+ ///
+ /// Consumes matching events until one of the following happens:
+ /// - A non-matching event is emitted.
+ /// - An error is emitted.
+ /// - The stream closes.
+ Future<void> mayEmitMultiple(AsyncCondition<T> condition) async {
+ await context
+ .expectAsync(() => ['may emit a value that:', ...describe(condition)],
+ (actual) async {
+ while (await actual.hasNext) {
+ try {
+ final value = await actual.peek;
+ if (softCheck(value, condition) == null) {
+ await actual.next;
+ } else {
+ return null;
+ }
+ } catch (_) {
+ return null;
+ }
+ }
+ return null;
+ });
+ }
+
+ /// Expects that the stream closes without emitting any events or errors.
+ ///
+ /// If this expectation fails, the source queue will be left in its original
+ /// state, the event or error that caused it to fail will not be consumed.
+ Future<void> isDone() async {
+ await _expectAsync(() => ['is done'], (actual) async {
+ if (!await actual.hasNext) return null;
+ try {
+ return Rejection(
+ actual: ['a stream'],
+ which: prefixFirst(
+ 'emitted an unexpected value: ', literal(await actual.next)));
+ } catch (e, st) {
+ return Rejection(actual: [
+ 'a stream'
+ ], which: [
+ ...prefixFirst('emitted an unexpected error: ', literal(e)),
+ ...const LineSplitter().convert(st.toString())
+ ]);
+ }
+ });
+ }
+}
+
+extension WithQueueExtension<T> on Subject<Stream<T>> {
+ /// Wrap the stream in a [StreamQueue] to allow using checks from
+ /// [StreamChecks].
+ ///
+ /// Stream expectations operate on a queue, instead of directly on the stream,
+ /// so that they can support conditional expectations and check multiple
+ /// possibilities from the same point in the stream.
+ Subject<StreamQueue<T>> get withQueue =>
+ context.nest(() => [], (actual) => Extracted.value(StreamQueue(actual)),
+ atSameLevel: true);
+}
diff --git a/pkgs/checks/lib/src/extensions/core.dart b/pkgs/checks/lib/src/extensions/core.dart
new file mode 100644
index 0000000..957e175
--- /dev/null
+++ b/pkgs/checks/lib/src/extensions/core.dart
@@ -0,0 +1,184 @@
+// Copyright (c) 2022, 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:convert';
+
+import 'package:meta/meta.dart' as meta;
+
+import '../../context.dart';
+
+extension CoreChecks<T> on Subject<T> {
+ /// Extracts a property of the value for further expectations.
+ ///
+ /// Sets up a clause that the value "has [name] that:" followed by any
+ /// expectations applied to the returned [Subject].
+ @meta.useResult
+ Subject<R> has<R>(R Function(T) extract, String name) {
+ return context.nest(() => ['has $name'], (value) {
+ try {
+ return Extracted.value(extract(value));
+ } catch (e, st) {
+ return Extracted.rejection(which: [
+ ...prefixFirst('threw while trying to read $name: ', literal(e)),
+ ...const LineSplitter().convert(st.toString())
+ ]);
+ }
+ });
+ }
+
+ /// Applies the expectations invoked in [condition] to this subject.
+ ///
+ /// Use this method when it would otherwise not be possible to check multiple
+ /// expectations for this subject due to cascade notation already being used
+ /// in a way that would conflict.
+ ///
+ /// ```
+ /// check(something)
+ /// ..has((s) => s.foo, 'foo').equals(expectedFoo)
+ /// ..has((s) => s.bar, 'bar').which((b) => b
+ /// ..isLessThan(10)
+ /// ..isGreaterThan(0));
+ /// ```
+ void which(Condition<T> condition) => condition(this);
+
+ /// Check that the expectations invoked in [condition] are not satisfied by
+ /// this value.
+ ///
+ /// Asynchronous expectations are not allowed in [condition].
+ void not(Condition<T> condition) {
+ context.expect(
+ () => ['is not a value that:', ...indent(describe(condition))],
+ (actual) {
+ if (softCheck(actual, condition) != null) return null;
+ return Rejection(
+ which: ['is a value that: ', ...indent(describe(condition))],
+ );
+ },
+ );
+ }
+
+ /// Expects that the value satisfies the expectations invoked in at least one
+ /// condition from [conditions].
+ ///
+ /// Asynchronous expectations are not allowed in [conditions].
+ void anyOf(Iterable<Condition<T>> conditions) {
+ context.expect(
+ () => prefixFirst('matches any condition in ', literal(conditions)),
+ (actual) {
+ for (final condition in conditions) {
+ if (softCheck(actual, condition) == null) return null;
+ }
+ return Rejection(which: ['did not match any condition']);
+ });
+ }
+
+ /// Expects that the value is assignable to type [T].
+ ///
+ /// If the value is a [T], returns a [Subject] for further expectations.
+ Subject<R> isA<R>() {
+ return context.nest<R>(() => ['is a $R'], (actual) {
+ if (actual is! R) {
+ return Extracted.rejection(which: ['Is a ${actual.runtimeType}']);
+ }
+ return Extracted.value(actual);
+ }, atSameLevel: true);
+ }
+
+ /// Expects that the value is equal to [other] according to [operator ==].
+ void equals(T other) {
+ context.expect(() => prefixFirst('equals ', literal(other)), (actual) {
+ if (actual == other) return null;
+ return Rejection(which: ['are not equal']);
+ });
+ }
+
+ /// Expects that the value is [identical] to [other].
+ void identicalTo(T other) {
+ context.expect(() => prefixFirst('is identical to ', literal(other)),
+ (actual) {
+ if (identical(actual, other)) return null;
+ return Rejection(which: ['is not identical']);
+ });
+ }
+}
+
+extension BoolChecks on Subject<bool> {
+ void isTrue() {
+ context.expect(
+ () => ['is true'],
+ (actual) => actual
+ ? null // force coverage
+ : Rejection(),
+ );
+ }
+
+ void isFalse() {
+ context.expect(
+ () => ['is false'],
+ (actual) => !actual
+ ? null // force coverage
+ : Rejection(),
+ );
+ }
+}
+
+extension NullableChecks<T> on Subject<T?> {
+ Subject<T> isNotNull() {
+ return context.nest<T>(() => ['is not null'], (actual) {
+ if (actual == null) return Extracted.rejection();
+ return Extracted.value(actual);
+ }, atSameLevel: true);
+ }
+
+ void isNull() {
+ context.expect(() => const ['is null'], (actual) {
+ if (actual != null) return Rejection();
+ return null;
+ });
+ }
+}
+
+extension ComparableChecks<T> on Subject<Comparable<T>> {
+ /// Expects that this value is greater than [other].
+ void isGreaterThan(T other) {
+ context.expect(() => prefixFirst('is greater than ', literal(other)),
+ (actual) {
+ if (actual.compareTo(other) > 0) return null;
+ return Rejection(
+ which: prefixFirst('is not greater than ', literal(other)));
+ });
+ }
+
+ /// Expects that this value is greater than or equal to [other].
+ void isGreaterOrEqual(T other) {
+ context.expect(
+ () => prefixFirst('is greater than or equal to ', literal(other)),
+ (actual) {
+ if (actual.compareTo(other) >= 0) return null;
+ return Rejection(
+ which:
+ prefixFirst('is not greater than or equal to ', literal(other)));
+ });
+ }
+
+ /// Expects that this value is less than [other].
+ void isLessThan(T other) {
+ context.expect(() => prefixFirst('is less than ', literal(other)),
+ (actual) {
+ if (actual.compareTo(other) < 0) return null;
+ return Rejection(which: prefixFirst('is not less than ', literal(other)));
+ });
+ }
+
+ /// Expects that this value is less than or equal to [other].
+ void isLessOrEqual(T other) {
+ context
+ .expect(() => prefixFirst('is less than or equal to ', literal(other)),
+ (actual) {
+ if (actual.compareTo(other) <= 0) return null;
+ return Rejection(
+ which: prefixFirst('is not less than or equal to ', literal(other)));
+ });
+ }
+}
diff --git a/pkgs/checks/lib/src/extensions/function.dart b/pkgs/checks/lib/src/extensions/function.dart
new file mode 100644
index 0000000..300941c
--- /dev/null
+++ b/pkgs/checks/lib/src/extensions/function.dart
@@ -0,0 +1,56 @@
+// Copyright (c) 2022, 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 '../../context.dart';
+
+extension FunctionChecks<T> on Subject<T Function()> {
+ /// Expects that a function throws synchronously when it is called.
+ ///
+ /// If the function synchronously throws a value of type [E], return a
+ /// [Subject] to check further expectations on the error.
+ ///
+ /// If the function does not throw synchronously, or if it throws an error
+ /// that is not of type [E], this expectation will fail.
+ ///
+ /// If this function is async and returns a [Future], this expectation will
+ /// fail. Instead invoke the function and check the expectation on the
+ /// returned [Future].
+ Subject<E> throws<E>() {
+ return context.nest<E>(() => ['throws an error of type $E'], (actual) {
+ try {
+ final result = actual();
+ return Extracted.rejection(
+ actual: prefixFirst('a function that returned ', literal(result)),
+ which: ['did not throw'],
+ );
+ } catch (e) {
+ if (e is E) return Extracted.value(e as E);
+ return Extracted.rejection(
+ actual: prefixFirst('a function that threw error ', literal(e)),
+ which: ['did not throw an $E']);
+ }
+ });
+ }
+
+ /// Expects that the function returns without throwing.
+ ///
+ /// If the function runs without exception, return a [Subject] to check
+ /// further expecations on the returned value.
+ ///
+ /// If the function throws synchronously, this expectation will fail.
+ Subject<T> returnsNormally() {
+ return context.nest<T>(() => ['returns a value'], (actual) {
+ try {
+ return Extracted.value(actual());
+ } catch (e, st) {
+ return Extracted.rejection(actual: [
+ 'a function that throws'
+ ], which: [
+ ...prefixFirst('threw ', literal(e)),
+ ...st.toString().split('\n')
+ ]);
+ }
+ });
+ }
+}
diff --git a/pkgs/checks/lib/src/extensions/iterable.dart b/pkgs/checks/lib/src/extensions/iterable.dart
new file mode 100644
index 0000000..ecfa9c0
--- /dev/null
+++ b/pkgs/checks/lib/src/extensions/iterable.dart
@@ -0,0 +1,372 @@
+// Copyright (c) 2022, 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 '../../context.dart';
+
+import '../collection_equality.dart';
+import 'core.dart';
+
+extension IterableChecks<T> on Subject<Iterable<T>> {
+ Subject<int> get length => has((l) => l.length, 'length');
+
+ Subject<T> get first => context.nest(() => ['has first element'], (actual) {
+ final iterator = actual.iterator;
+ if (!iterator.moveNext()) {
+ return Extracted.rejection(which: ['has no elements']);
+ }
+ return Extracted.value(iterator.current);
+ });
+
+ Subject<T> get last => context.nest(() => ['has last element'], (actual) {
+ final iterator = actual.iterator;
+ if (!iterator.moveNext()) {
+ return Extracted.rejection(which: ['has no elements']);
+ }
+ var current = iterator.current;
+ while (iterator.moveNext()) {
+ current = iterator.current;
+ }
+ return Extracted.value(current);
+ });
+
+ Subject<T> get single => context.nest(() => ['has single element'], (actual) {
+ final iterator = actual.iterator;
+ if (!iterator.moveNext()) {
+ return Extracted.rejection(which: ['has no elements']);
+ }
+ final value = iterator.current;
+ if (iterator.moveNext()) {
+ return Extracted.rejection(which: ['has more than one element']);
+ }
+ return Extracted.value(value);
+ });
+
+ void isEmpty() {
+ context.expect(() => const ['is empty'], (actual) {
+ if (actual.isEmpty) return null;
+ return Rejection(which: ['is not empty']);
+ });
+ }
+
+ void isNotEmpty() {
+ context.expect(() => const ['is not empty'], (actual) {
+ if (actual.isNotEmpty) return null;
+ return Rejection(which: ['is empty']);
+ });
+ }
+
+ /// Expects that the iterable contains [element] according to
+ /// [Iterable.contains].
+ void contains(T element) {
+ context.expect(() {
+ return prefixFirst('contains ', literal(element));
+ }, (actual) {
+ if (actual.isEmpty) return Rejection(actual: ['an empty iterable']);
+ if (actual.contains(element)) return null;
+ return Rejection(
+ which: prefixFirst('does not contain ', literal(element)));
+ });
+ }
+
+ /// Expects that the iterable contains a value matching each expected value
+ /// from [elements] in the given order, with any extra elements between
+ /// them.
+ ///
+ /// For example, the following will succeed:
+ ///
+ /// ```dart
+ /// check([1, 0, 2, 0, 3]).containsInOrder([1, 2, 3]);
+ /// ```
+ ///
+ /// Values in [elements] may be a `T`, a `Condition<T>`, or a
+ /// `Condition<Object?>`. If an expectation is a condition callback it will be
+ /// checked against the actual values, and any other expectations, including
+ /// those that are not a `T` or a condition callback, will be compared with
+ /// the equality operator.
+ ///
+ /// ```dart
+ /// check([1, 0, 2, 0, 3])
+ /// .containsInOrder([1, (Subject<int> v) => v.isGreaterThan(1), 3]);
+ /// ```
+ @Deprecated('Use `containsEqualInOrder` for expectations with values compared'
+ ' with `==` or `containsMatchingInOrder` for other expectations')
+ void containsInOrder(Iterable<Object?> elements) {
+ context.expect(() => prefixFirst('contains, in order: ', literal(elements)),
+ (actual) {
+ final expected = elements.toList();
+ if (expected.isEmpty) {
+ throw ArgumentError('expected may not be empty');
+ }
+ var expectedIndex = 0;
+ for (final element in actual) {
+ final currentExpected = expected[expectedIndex];
+ final matches = currentExpected is Condition<T>
+ ? softCheck(element, currentExpected) == null
+ : currentExpected is Condition<dynamic>
+ ? softCheck(element, currentExpected) == null
+ : currentExpected == element;
+ if (matches && ++expectedIndex >= expected.length) return null;
+ }
+ return Rejection(which: [
+ ...prefixFirst(
+ 'did not have an element matching the expectation at index '
+ '$expectedIndex ',
+ literal(expected[expectedIndex])),
+ ]);
+ });
+ }
+
+ /// Expects that the iterable contains a value matching each condition in
+ /// [conditions] in the given order, with any extra elements between them.
+ ///
+ /// For example, the following will succeed:
+ ///
+ /// ```dart
+ /// check([1, 10, 2, 10, 3]).containsMatchingInOrder([
+ /// (it) => it.isLessThan(2),
+ /// (it) => it.isLessThan(3),
+ /// (it) => it.isLessThan(4),
+ /// ]);
+ /// ```
+ void containsMatchingInOrder(Iterable<Condition<T>> conditions) {
+ context
+ .expect(() => prefixFirst('contains, in order: ', literal(conditions)),
+ (actual) {
+ final expected = conditions.toList();
+ if (expected.isEmpty) {
+ throw ArgumentError('expected may not be empty');
+ }
+ var expectedIndex = 0;
+ for (final element in actual) {
+ final currentExpected = expected[expectedIndex];
+ final matches = softCheck(element, currentExpected) == null;
+ if (matches && ++expectedIndex >= expected.length) return null;
+ }
+ return Rejection(which: [
+ ...prefixFirst(
+ 'did not have an element matching the expectation at index '
+ '$expectedIndex ',
+ literal(expected[expectedIndex])),
+ ]);
+ });
+ }
+
+ /// Expects that the iterable contains a value equals to each expected value
+ /// from [elements] in the given order, with any extra elements between
+ /// them.
+ ///
+ /// For example, the following will succeed:
+ ///
+ /// ```dart
+ /// check([1, 0, 2, 0, 3]).containsInOrder([1, 2, 3]);
+ /// ```
+ ///
+ /// Values, will be compared with the equality operator.
+ void containsEqualInOrder(Iterable<T> elements) {
+ context.expect(() => prefixFirst('contains, in order: ', literal(elements)),
+ (actual) {
+ final expected = elements.toList();
+ if (expected.isEmpty) {
+ throw ArgumentError('expected may not be empty');
+ }
+ var expectedIndex = 0;
+ for (final element in actual) {
+ final currentExpected = expected[expectedIndex];
+ final matches = currentExpected == element;
+ if (matches && ++expectedIndex >= expected.length) return null;
+ }
+ return Rejection(which: [
+ ...prefixFirst(
+ 'did not have an element equal to the expectation at index '
+ '$expectedIndex ',
+ literal(expected[expectedIndex])),
+ ]);
+ });
+ }
+
+ /// Expects that the iterable contains at least on element such that
+ /// [elementCondition] is satisfied.
+ void any(Condition<T> elementCondition) {
+ context.expect(() {
+ final conditionDescription = describe(elementCondition);
+ assert(conditionDescription.isNotEmpty);
+ return [
+ 'contains a value that:',
+ ...conditionDescription,
+ ];
+ }, (actual) {
+ if (actual.isEmpty) return Rejection(actual: ['an empty iterable']);
+ for (var e in actual) {
+ if (softCheck(e, elementCondition) == null) return null;
+ }
+ return Rejection(which: ['Contains no matching element']);
+ });
+ }
+
+ /// Expects there are no elements in the iterable which fail to satisfy
+ /// [elementCondition].
+ ///
+ /// Empty iterables will pass always pass this expectation.
+ void every(Condition<T> elementCondition) {
+ context.expect(() {
+ final conditionDescription = describe(elementCondition);
+ assert(conditionDescription.isNotEmpty);
+ return [
+ 'only has values that:',
+ ...conditionDescription,
+ ];
+ }, (actual) {
+ final iterator = actual.iterator;
+ for (var i = 0; iterator.moveNext(); i++) {
+ final element = iterator.current;
+ final failure = softCheck(element, elementCondition);
+ if (failure == null) continue;
+ final which = failure.rejection.which;
+ return Rejection(which: [
+ 'has an element at index $i that:',
+ ...indent(failure.detail.actual.skip(1)),
+ ...indent(prefixFirst('Actual: ', failure.rejection.actual),
+ failure.detail.depth + 1),
+ if (which != null && which.isNotEmpty)
+ ...indent(prefixFirst('Which: ', which), failure.detail.depth + 1),
+ ]);
+ }
+ return null;
+ });
+ }
+
+ /// Expects that the iterable contains elements that are deeply equal to the
+ /// elements of [expected].
+ ///
+ /// {@macro deep_collection_equals}
+ void deepEquals(Iterable<Object?> expected) => context
+ .expect(() => prefixFirst('is deeply equal to ', literal(expected)),
+ (actual) {
+ final which = deepCollectionEquals(actual, expected);
+ if (which == null) return null;
+ return Rejection(which: which);
+ });
+
+ /// Expects that the iterable contains elements which equal those of
+ /// [expected] in any order.
+ ///
+ /// Should not be used for very large collections, runtime is O(n^2.5) in the
+ /// worst case where the iterables contain many equal elements, and O(n^2) in
+ /// more typical cases.
+ void unorderedEquals(Iterable<T> expected) {
+ context.expect(() => prefixFirst('unordered equals ', literal(expected)),
+ (actual) {
+ final which = unorderedCompare(
+ actual,
+ expected,
+ (actual, expected) => expected == actual,
+ (expected, index, count) => [
+ ...prefixFirst(
+ 'has no element equal to the expected element at index '
+ '$index: ',
+ literal(expected)),
+ if (count > 1) 'or ${count - 1} other elements',
+ ],
+ (actual, index, count) => [
+ ...prefixFirst(
+ 'has an unexpected element at index $index: ', literal(actual)),
+ if (count > 1) 'and ${count - 1} other unexpected elements',
+ ],
+ );
+ if (which == null) return null;
+ return Rejection(which: which);
+ });
+ }
+
+ /// Expects that the iterable contains elements which match all conditions of
+ /// [expected] in any order.
+ ///
+ /// Should not be used for very large collections, runtime is O(n^2.5) in the
+ /// worst case where conditions match many elements, and O(n^2) in more
+ /// typical cases.
+ void unorderedMatches(Iterable<Condition<T>> expected) {
+ context.expect(() => prefixFirst('unordered matches ', literal(expected)),
+ (actual) {
+ final which = unorderedCompare(
+ actual,
+ expected,
+ (actual, expected) => softCheck(actual, expected) == null,
+ (expected, index, count) => [
+ 'has no element matching the condition at index $index:',
+ ...describe(expected),
+ if (count > 1) 'or ${count - 1} other conditions',
+ ],
+ (actual, index, count) => [
+ ...prefixFirst(
+ 'has an unmatched element at index $index: ', literal(actual)),
+ if (count > 1) 'and ${count - 1} other unmatched elements',
+ ],
+ );
+ if (which == null) return null;
+ return Rejection(which: which);
+ });
+ }
+
+ /// Expects that the iterable contains elements that correspond by the
+ /// [elementCondition] exactly to each element in [expected].
+ ///
+ /// Fails if the iterable has a different length than [expected].
+ ///
+ /// For each element in the iterable, calls [elementCondition] with the
+ /// corresponding element from [expected] to get the specific condition for
+ /// that index.
+ ///
+ /// [description] is used in the Expected clause. It should be a predicate
+ /// without the object, for example with the description 'is less than' the
+ /// full expectation will be: "pairwise is less than $expected"
+ @Deprecated('Use `pairwiseMatches`')
+ void pairwiseComparesTo<S>(List<S> expected,
+ Condition<T> Function(S) elementCondition, String description) =>
+ pairwiseMatches(expected, elementCondition, description);
+
+ /// Expects that the iterable contains elements that correspond by the
+ /// [elementCondition] exactly to each element in [expected].
+ ///
+ /// Fails if the iterable has a different length than [expected].
+ ///
+ /// For each element in the iterable, calls [elementCondition] with the
+ /// corresponding element from [expected] to get the specific condition for
+ /// that index.
+ ///
+ /// [description] is used in the Expected clause. It should be a predicate
+ /// without the object, for example with the description 'is less than' the
+ /// full expectation will be: "pairwise is less than $expected"
+ void pairwiseMatches<S>(List<S> expected,
+ Condition<T> Function(S) elementCondition, String description) {
+ context.expect(() {
+ return prefixFirst('pairwise $description ', literal(expected));
+ }, (actual) {
+ final iterator = actual.iterator;
+ for (var i = 0; i < expected.length; i++) {
+ final expectedValue = expected[i];
+ if (!iterator.moveNext()) {
+ return Rejection(which: [
+ 'has too few elements, there is no element to match at index $i'
+ ]);
+ }
+ final actualValue = iterator.current;
+ final failure = softCheck(actualValue, elementCondition(expectedValue));
+ if (failure == null) continue;
+ final innerDescription = describe<T>(elementCondition(expectedValue));
+ final which = failure.rejection.which;
+ return Rejection(which: [
+ 'does not have an element at index $i that:',
+ ...innerDescription,
+ ...prefixFirst(
+ 'Actual element at index $i: ', failure.rejection.actual),
+ if (which != null) ...prefixFirst('Which: ', which),
+ ]);
+ }
+ if (!iterator.moveNext()) return null;
+ return Rejection(which: [
+ 'has too many elements, expected exactly ${expected.length}'
+ ]);
+ });
+ }
+}
diff --git a/pkgs/checks/lib/src/extensions/map.dart b/pkgs/checks/lib/src/extensions/map.dart
new file mode 100644
index 0000000..4fc0fdf
--- /dev/null
+++ b/pkgs/checks/lib/src/extensions/map.dart
@@ -0,0 +1,109 @@
+// Copyright (c) 2022, 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 '../../context.dart';
+
+import '../collection_equality.dart';
+import 'core.dart';
+
+extension MapChecks<K, V> on Subject<Map<K, V>> {
+ Subject<Iterable<MapEntry<K, V>>> get entries =>
+ has((m) => m.entries, 'entries');
+ Subject<Iterable<K>> get keys => has((m) => m.keys, 'keys');
+ Subject<Iterable<V>> get values => has((m) => m.values, 'values');
+ Subject<int> get length => has((m) => m.length, 'length');
+ Subject<V> operator [](K key) {
+ return context.nest(
+ () => prefixFirst('contains a value for ', literal(key)), (actual) {
+ if (!actual.containsKey(key)) {
+ return Extracted.rejection(
+ which: prefixFirst('does not contain the key ', literal(key)));
+ }
+ return Extracted.value(actual[key] as V);
+ });
+ }
+
+ void isEmpty() {
+ context.expect(() => const ['is empty'], (actual) {
+ if (actual.isEmpty) return null;
+ return Rejection(which: ['is not empty']);
+ });
+ }
+
+ void isNotEmpty() {
+ context.expect(() => const ['is not empty'], (actual) {
+ if (actual.isNotEmpty) return null;
+ return Rejection(which: ['is not empty']);
+ });
+ }
+
+ /// Expects that the map contains [key] according to [Map.containsKey].
+ void containsKey(K key) {
+ context.expect(() => prefixFirst('contains key ', literal(key)), (actual) {
+ if (actual.containsKey(key)) return null;
+ return Rejection(
+ which: prefixFirst('does not contain key ', literal(key)));
+ });
+ }
+
+ /// Expects that the map contains some key such that [keyCondition] is
+ /// satisfied.
+ void containsKeyThat(Condition<K> keyCondition) {
+ context.expect(() {
+ final conditionDescription = describe(keyCondition);
+ assert(conditionDescription.isNotEmpty);
+ return [
+ 'contains a key that:',
+ ...conditionDescription,
+ ];
+ }, (actual) {
+ if (actual.isEmpty) return Rejection(actual: ['an empty map']);
+ for (var k in actual.keys) {
+ if (softCheck(k, keyCondition) == null) return null;
+ }
+ return Rejection(which: ['Contains no matching key']);
+ });
+ }
+
+ /// Expects that the map contains [value] according to [Map.containsValue].
+ void containsValue(V value) {
+ context.expect(() => prefixFirst('contains value ', literal(value)),
+ (actual) {
+ if (actual.containsValue(value)) return null;
+ return Rejection(
+ which: prefixFirst('does not contain value ', literal(value)));
+ });
+ }
+
+ /// Expects that the map contains some value such that [valueCondition] is
+ /// satisfied.
+ void containsValueThat(Condition<V> valueCondition) {
+ context.expect(() {
+ final conditionDescription = describe(valueCondition);
+ assert(conditionDescription.isNotEmpty);
+ return [
+ 'contains a value that:',
+ ...conditionDescription,
+ ];
+ }, (actual) {
+ if (actual.isEmpty) return Rejection(actual: ['an empty map']);
+ for (var v in actual.values) {
+ if (softCheck(v, valueCondition) == null) return null;
+ }
+ return Rejection(which: ['Contains no matching value']);
+ });
+ }
+
+ /// Expects that the map contains entries that are deeply equal to the entries
+ /// of [expected].
+ ///
+ /// {@macro deep_collection_equals}
+ void deepEquals(Map<Object?, Object?> expected) => context
+ .expect(() => prefixFirst('is deeply equal to ', literal(expected)),
+ (actual) {
+ final which = deepCollectionEquals(actual, expected);
+ if (which == null) return null;
+ return Rejection(which: which);
+ });
+}
diff --git a/pkgs/checks/lib/src/extensions/math.dart b/pkgs/checks/lib/src/extensions/math.dart
new file mode 100644
index 0000000..302f1db
--- /dev/null
+++ b/pkgs/checks/lib/src/extensions/math.dart
@@ -0,0 +1,88 @@
+// Copyright (c) 2022, 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 '../../context.dart';
+
+extension NumChecks on Subject<num> {
+ /// Expects that [num.isNaN] is true.
+ void isNaN() {
+ context.expect(() => ['is not a number (NaN)'], (actual) {
+ if (actual.isNaN) return null;
+ return Rejection(which: ['is a number']);
+ });
+ }
+
+ /// Expects that [num.isNaN] is false.
+ void isNotNaN() {
+ context.expect(() => ['is a number (not NaN)'], (actual) {
+ if (!actual.isNaN) return null;
+ return Rejection(which: ['is not a number (NaN)']);
+ });
+ }
+
+ /// Expects that [num.isNegative] is true.
+ void isNegative() {
+ context.expect(() => ['is negative'], (actual) {
+ if (actual.isNegative) return null;
+ return Rejection(which: ['is not negative']);
+ });
+ }
+
+ /// Expects that [num.isNegative] is false.
+ void isNotNegative() {
+ context.expect(() => ['is not negative'], (actual) {
+ if (!actual.isNegative) return null;
+ return Rejection(which: ['is negative']);
+ });
+ }
+
+ /// Expects that [num.isFinite] is true.
+ void isFinite() {
+ context.expect(() => ['is finite'], (actual) {
+ if (actual.isFinite) return null;
+ return Rejection(which: ['is not finite']);
+ });
+ }
+
+ /// Expects that [num.isFinite] is false.
+ ///
+ /// Satisfied by [double.nan], [double.infinity] and
+ /// [double.negativeInfinity].
+ void isNotFinite() {
+ context.expect(() => ['is not finite'], (actual) {
+ if (!actual.isFinite) return null;
+ return Rejection(which: ['is finite']);
+ });
+ }
+
+ /// Expects that [num.isInfinite] is true.
+ ///
+ /// Satisfied by [double.infinity] and [double.negativeInfinity].
+ void isInfinite() {
+ context.expect(() => ['is infinite'], (actual) {
+ if (actual.isInfinite) return null;
+ return Rejection(which: ['is not infinite']);
+ });
+ }
+
+ /// Expects that [num.isInfinite] is false.
+ ///
+ /// Satisfied by [double.nan] and finite numbers.
+ void isNotInfinite() {
+ context.expect(() => ['is not infinite'], (actual) {
+ if (!actual.isInfinite) return null;
+ return Rejection(which: ['is infinite']);
+ });
+ }
+
+ /// Expects that the difference between this number and [other] is less than
+ /// or equal to [delta].
+ void isCloseTo(num other, num delta) {
+ context.expect(() => ['is within <$delta> of <$other>'], (actual) {
+ final difference = (other - actual).abs();
+ if (difference <= delta) return null;
+ return Rejection(which: ['differs by <$difference>']);
+ });
+ }
+}
diff --git a/pkgs/checks/lib/src/extensions/string.dart b/pkgs/checks/lib/src/extensions/string.dart
new file mode 100644
index 0000000..84b20f6
--- /dev/null
+++ b/pkgs/checks/lib/src/extensions/string.dart
@@ -0,0 +1,229 @@
+// Copyright (c) 2022, 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:math' as math;
+
+import '../../context.dart';
+
+import 'core.dart';
+
+extension StringChecks on Subject<String> {
+ /// Expects that the value contains [pattern] according to [String.contains];
+ void contains(Pattern pattern) {
+ context.expect(() => prefixFirst('contains ', literal(pattern)), (actual) {
+ if (actual.contains(pattern)) return null;
+ return Rejection(
+ which: prefixFirst('Does not contain ', literal(pattern)),
+ );
+ });
+ }
+
+ Subject<int> get length => has((m) => m.length, 'length');
+
+ void isEmpty() {
+ context.expect(() => const ['is empty'], (actual) {
+ if (actual.isEmpty) return null;
+ return Rejection(which: ['is not empty']);
+ });
+ }
+
+ void isNotEmpty() {
+ context.expect(() => const ['is not empty'], (actual) {
+ if (actual.isNotEmpty) return null;
+ return Rejection(which: ['is empty']);
+ });
+ }
+
+ void startsWith(Pattern other) {
+ context.expect(
+ () => prefixFirst('starts with ', literal(other)),
+ (actual) {
+ if (actual.startsWith(other)) return null;
+ return Rejection(
+ which: prefixFirst('does not start with ', literal(other)),
+ );
+ },
+ );
+ }
+
+ void endsWith(String other) {
+ context.expect(
+ () => prefixFirst('ends with ', literal(other)),
+ (actual) {
+ if (actual.endsWith(other)) return null;
+ return Rejection(
+ which: prefixFirst('does not end with ', literal(other)),
+ );
+ },
+ );
+ }
+
+ /// Expects that the string matches the pattern [expected].
+ ///
+ /// Fails if [expected] returns an empty result from calling `allMatches` with
+ /// the value.
+ ///
+ /// ```
+ /// check(actual).matchesPattern('abc');
+ /// check(actual).matchesPattern(RegExp(r'\d'));
+ /// ```
+ void matchesPattern(Pattern expected) {
+ context.expect(() => prefixFirst('matches ', literal(expected)), (actual) {
+ if (expected.allMatches(actual).isNotEmpty) return null;
+ return Rejection(
+ which: prefixFirst('does not match ', literal(expected)));
+ });
+ }
+
+ /// Expects that the `String` contains each of the sub strings in expected
+ /// in the given order, with any content between them.
+ ///
+ /// For example, the following will succeed:
+ ///
+ /// check('abcdefg').containsInOrder(['a','e']);
+ void containsInOrder(Iterable<String> expected) {
+ context.expect(() => prefixFirst('contains, in order: ', literal(expected)),
+ (actual) {
+ var fromIndex = 0;
+ for (var s in expected) {
+ var index = actual.indexOf(s, fromIndex);
+ if (index < 0) {
+ return Rejection(which: [
+ ...prefixFirst(
+ 'does not have a match for the substring ', literal(s)),
+ if (fromIndex != 0)
+ 'following the other matches up to character $fromIndex'
+ ]);
+ }
+ fromIndex = index + s.length;
+ }
+ return null;
+ });
+ }
+
+ /// Expects that the `String` contains exactly the same code units as
+ /// [expected].
+ void equals(String expected) {
+ context.expect(() => prefixFirst('equals ', literal(expected)),
+ (actual) => _findDifference(actual, expected));
+ }
+
+ /// Expects that the `String` contains the same characters as [expected] if
+ /// both were lower case.
+ void equalsIgnoringCase(String expected) {
+ context.expect(
+ () => prefixFirst('equals ignoring case ', literal(expected)),
+ (actual) => _findDifference(
+ actual.toLowerCase(), expected.toLowerCase(), actual, expected));
+ }
+
+ /// Expects that the `String` contains the same content as [expected],
+ /// ignoring differences in whitsepace.
+ ///
+ /// All runs of whitespace characters are collapsed to a single space, and
+ /// leading and traiilng whitespace are removed before comparison.
+ ///
+ /// For example the following will succeed:
+ ///
+ /// check(' hello world ').equalsIgnoringWhitespace('hello world');
+ ///
+ /// While the following will fail:
+ ///
+ /// check('helloworld').equalsIgnoringWhitespace('hello world');
+ /// check('he llo world').equalsIgnoringWhitespace('hello world');
+ void equalsIgnoringWhitespace(String expected) {
+ context.expect(
+ () => prefixFirst('equals ignoring whitespace ', literal(expected)),
+ (actual) {
+ final collapsedActual = _collapseWhitespace(actual);
+ final collapsedExpected = _collapseWhitespace(expected);
+ return _findDifference(collapsedActual, collapsedExpected,
+ collapsedActual, collapsedExpected);
+ });
+ }
+}
+
+Rejection? _findDifference(String actual, String expected,
+ [String? actualDisplay, String? expectedDisplay]) {
+ if (actual == expected) return null;
+ final escapedActual = escape(actual);
+ final escapedExpected = escape(expected);
+ final escapedActualDisplay =
+ actualDisplay != null ? escape(actualDisplay) : escapedActual;
+ final escapedExpectedDisplay =
+ expectedDisplay != null ? escape(expectedDisplay) : escapedExpected;
+ final minLength = math.min(escapedActual.length, escapedExpected.length);
+ var i = 0;
+ for (; i < minLength; i++) {
+ if (escapedActual.codeUnitAt(i) != escapedExpected.codeUnitAt(i)) {
+ break;
+ }
+ }
+ if (i == minLength) {
+ if (escapedExpected.length < escapedActual.length) {
+ if (expected.isEmpty) {
+ return Rejection(which: ['is not the empty string']);
+ }
+ return Rejection(which: [
+ 'is too long with unexpected trailing characters:',
+ _trailing(escapedActualDisplay, i)
+ ]);
+ } else {
+ if (actual.isEmpty) {
+ return Rejection(actual: [
+ 'an empty string'
+ ], which: [
+ 'is missing all expected characters:',
+ _trailing(escapedExpectedDisplay, 0)
+ ]);
+ }
+ return Rejection(which: [
+ 'is too short with missing trailing characters:',
+ _trailing(escapedExpectedDisplay, i)
+ ]);
+ }
+ } else {
+ final indentation = ' ' * (i > 10 ? 14 : i);
+ return Rejection(which: [
+ 'differs at offset $i:',
+ '${_leading(escapedExpectedDisplay, i)}'
+ '${_trailing(escapedExpectedDisplay, i)}',
+ '${_leading(escapedActualDisplay, i)}'
+ '${_trailing(escapedActualDisplay, i)}',
+ '$indentation^'
+ ]);
+ }
+}
+
+/// The truncated beginning of [s] up to the [end] character.
+String _leading(String s, int end) =>
+ (end > 10) ? '... ${s.substring(end - 10, end)}' : s.substring(0, end);
+
+/// The truncated remainder of [s] starting at the [start] character.
+String _trailing(String s, int start) => (start + 10 > s.length)
+ ? s.substring(start)
+ : '${s.substring(start, start + 10)} ...';
+
+/// Utility function to collapse whitespace runs to single spaces
+/// and strip leading/trailing whitespace.
+String _collapseWhitespace(String string) {
+ var result = StringBuffer();
+ var skipSpace = true;
+ for (var i = 0; i < string.length; i++) {
+ var character = string[i];
+ if (_isWhitespace(character)) {
+ if (!skipSpace) {
+ result.write(' ');
+ skipSpace = true;
+ }
+ } else {
+ result.write(character);
+ skipSpace = false;
+ }
+ }
+ return result.toString().trim();
+}
+
+bool _isWhitespace(String ch) =>
+ ch == ' ' || ch == '\n' || ch == '\r' || ch == '\t';
diff --git a/pkgs/checks/mono_pkg.yaml b/pkgs/checks/mono_pkg.yaml
new file mode 100644
index 0000000..b447edb
--- /dev/null
+++ b/pkgs/checks/mono_pkg.yaml
@@ -0,0 +1,15 @@
+# See https://pub.dev/packages/mono_repo
+
+stages:
+- analyze_and_format:
+ - group:
+ - format
+ - analyze: --fatal-infos
+ sdk: dev
+ - group:
+ - analyze
+ sdk: pubspec
+- unit_test:
+ - group:
+ - command: dart test
+ sdk: [dev, pubspec]
diff --git a/pkgs/checks/pubspec.yaml b/pkgs/checks/pubspec.yaml
new file mode 100644
index 0000000..8c59ba4
--- /dev/null
+++ b/pkgs/checks/pubspec.yaml
@@ -0,0 +1,18 @@
+name: checks
+version: 0.3.1-wip
+description: >-
+ A framework for checking values against expectations and building custom
+ expectations.
+repository: https://github.com/dart-lang/test/tree/master/pkgs/checks
+resolution: workspace
+
+environment:
+ sdk: ^3.5.0
+
+dependencies:
+ async: ^2.8.0
+ meta: ^1.9.0
+ test_api: ">=0.5.0 <0.8.0"
+
+dev_dependencies:
+ test: ^1.21.3
diff --git a/pkgs/checks/test/context_test.dart b/pkgs/checks/test/context_test.dart
new file mode 100644
index 0000000..820ff88
--- /dev/null
+++ b/pkgs/checks/test/context_test.dart
@@ -0,0 +1,172 @@
+// 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 'dart:convert';
+
+import 'package:async/async.dart' hide Result;
+import 'package:checks/checks.dart';
+import 'package:checks/context.dart';
+import 'package:test/scaffolding.dart';
+import 'package:test_api/hooks.dart';
+import 'package:test_api/hooks_testing.dart';
+
+void main() {
+ group('Context', () {
+ test('expectAsync holds test open', () async {
+ late void Function() callback;
+ final monitor = TestCaseMonitor.start(() {
+ check(null).context.expectAsync(() => [''], (actual) async {
+ final completer = Completer<void>();
+ callback = completer.complete;
+ await completer.future;
+ return null;
+ });
+ });
+ await pumpEventQueue();
+ check(monitor).state.equals(State.running);
+ callback();
+ await monitor.onDone;
+ check(monitor).didPass();
+ });
+
+ test('expectAsync does not hold test open past exception', () async {
+ late void Function() callback;
+ final monitor = TestCaseMonitor.start(() {
+ check(null).context.expectAsync(() => [''], (actual) async {
+ final completer = Completer<void>();
+ callback = completer.complete;
+ await completer.future;
+ throw 'oh no!';
+ });
+ });
+ await pumpEventQueue();
+ check(monitor).state.equals(State.running);
+ callback();
+ await monitor.onDone;
+ check(monitor)
+ ..state.equals(State.failed)
+ ..errors.single.has((e) => e.error, 'error').equals('oh no!');
+ });
+
+ test('nestAsync holds test open', () async {
+ late void Function() callback;
+ final monitor = TestCaseMonitor.start(() {
+ check(null).context.nestAsync(() => [''], (actual) async {
+ final completer = Completer<void>();
+ callback = completer.complete;
+ await completer.future;
+ return Extracted.value(null);
+ }, null);
+ });
+ await pumpEventQueue();
+ check(monitor).state.equals(State.running);
+ callback();
+ await monitor.onDone;
+ check(monitor).didPass();
+ });
+
+ test('nestAsync holds test open past async condition', () async {
+ late void Function() callback;
+ final monitor = TestCaseMonitor.start(() {
+ check(null).context.nestAsync(() => [''], (actual) async {
+ return Extracted.value(null);
+ }, (it) async {
+ final completer = Completer<void>();
+ callback = completer.complete;
+ await completer.future;
+ });
+ });
+ await pumpEventQueue();
+ check(monitor).state.equals(State.running);
+ callback();
+ await monitor.onDone;
+ check(monitor).didPass();
+ });
+
+ test('nestAsync does not hold test open past exception', () async {
+ late void Function() callback;
+ final monitor = TestCaseMonitor.start(() {
+ check(null).context.nestAsync<Object?>(() => [''], (actual) async {
+ final completer = Completer<void>();
+ callback = completer.complete;
+ await completer.future;
+ throw 'oh no!';
+ }, null);
+ });
+ await pumpEventQueue();
+ check(monitor).state.equals(State.running);
+ callback();
+ await monitor.onDone;
+ check(monitor)
+ ..state.equals(State.failed)
+ ..errors.single.has((e) => e.error, 'error').equals('oh no!');
+ });
+
+ test('expectUnawaited can fail the test after it completes', () async {
+ late void Function() callback;
+ final monitor = await TestCaseMonitor.run(() {
+ check(null).context.expectUnawaited(() => [''], (actual, reject) {
+ final completer = Completer<void>()
+ ..future.then((_) {
+ reject(Rejection(which: ['foo']));
+ });
+ callback = completer.complete;
+ });
+ });
+ check(monitor).state.equals(State.passed);
+ callback();
+ await pumpEventQueue();
+ check(monitor)
+ ..state.equals(State.failed)
+ ..errors.unorderedMatches([
+ (it) => it
+ .has((e) => e.error, 'error')
+ .isA<TestFailure>()
+ .has((f) => f.message, 'message')
+ .isNotNull()
+ .endsWith('Which: foo'),
+ (it) => it
+ .has((e) => e.error, 'error')
+ .isA<String>()
+ .startsWith('This test failed after it had already completed.')
+ ]);
+ });
+ });
+
+ group('SkipExtension', () {
+ test('marks the test as skipped', () async {
+ final monitor = await TestCaseMonitor.run(() {
+ check(null).skip('skip').isNotNull();
+ });
+ check(monitor).state.equals(State.skipped);
+ });
+ });
+}
+
+extension _MonitorChecks on Subject<TestCaseMonitor> {
+ Subject<State> get state => has((m) => m.state, 'state');
+ Subject<Iterable<AsyncError>> get errors => has((m) => m.errors, 'errors');
+ Subject<StreamQueue<AsyncError>> get onError =>
+ has((m) => m.onError, 'onError').withQueue;
+
+ /// Expects that the monitored test is completed as success with no errors.
+ ///
+ /// Sets up an unawaited expectation that the test does not emit errors in the
+ /// future in addition to checking there have been no errors yet.
+ void didPass() {
+ errors.isEmpty();
+ state.equals(State.passed);
+ onError.context.expectUnawaited(() => ['emits no further errors'],
+ (actual, reject) async {
+ await for (var error in actual.rest) {
+ reject(Rejection(which: [
+ ...prefixFirst('threw late error', literal(error.error)),
+ ...const LineSplitter().convert(
+ TestHandle.current.formatStackTrace(error.stackTrace).toString())
+ ]));
+ }
+ });
+ }
+}
diff --git a/pkgs/checks/test/describe_test.dart b/pkgs/checks/test/describe_test.dart
new file mode 100644
index 0000000..d117a7b
--- /dev/null
+++ b/pkgs/checks/test/describe_test.dart
@@ -0,0 +1,24 @@
+// 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 'package:checks/checks.dart';
+import 'package:checks/context.dart';
+import 'package:test/scaffolding.dart';
+
+void main() {
+ group('describe', () {
+ test('succeeds for empty conditions', () {
+ check(describe((_) {})).isEmpty();
+ });
+ test('includes condition clauses', () {
+ check(describe((it) => it.equals(1))).deepEquals([' equals <1>']);
+ });
+ test('includes nested clauses', () {
+ check(describe<String>((it) => it.length.equals(1))).deepEquals([
+ ' has length that:',
+ ' equals <1>',
+ ]);
+ });
+ });
+}
diff --git a/pkgs/checks/test/extensions/async_test.dart b/pkgs/checks/test/extensions/async_test.dart
new file mode 100644
index 0000000..5bfe550
--- /dev/null
+++ b/pkgs/checks/test/extensions/async_test.dart
@@ -0,0 +1,531 @@
+// Copyright (c) 2022, 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:async/async.dart';
+import 'package:checks/checks.dart';
+import 'package:checks/context.dart';
+import 'package:test/scaffolding.dart';
+import 'package:test_api/hooks.dart';
+
+import '../test_shared.dart';
+
+void main() {
+ group('FutureChecks', () {
+ group('completes', () {
+ test('succeeds for a future that completes to a value', () async {
+ await check(_futureSuccess()).completes((it) => it.equals(42));
+ });
+ test('rejects futures which complete as errors', () async {
+ await check(_futureFail()).isRejectedByAsync(
+ (it) => it.completes((it) => it.equals(1)),
+ actual: ['a future that completes as an error'],
+ which: ['threw <UnimplementedError> at:', 'fake trace'],
+ );
+ });
+ test('can be described', () async {
+ await check((Subject<Future> it) => it.completes())
+ .hasAsyncDescriptionWhich(
+ (it) => it.deepEquals([' completes to a value']));
+ await check((Subject<Future> it) => it.completes((it) => it.equals(42)))
+ .hasAsyncDescriptionWhich((it) => it.deepEquals([
+ ' completes to a value that:',
+ ' equals <42>',
+ ]));
+ });
+ });
+
+ group('throws', () {
+ test(
+ 'succeeds for a future that compeletes to an error of the expected type',
+ () async {
+ await check(_futureFail()).throws<UnimplementedError>(
+ (it) => it.has((p0) => p0.message, 'message').isNull());
+ });
+ test('fails for futures that complete to a value', () async {
+ await check(_futureSuccess()).isRejectedByAsync(
+ (it) => it.throws(),
+ actual: ['completed to <42>'],
+ which: ['did not throw'],
+ );
+ });
+ test('failes for futures that complete to an error of the wrong type',
+ () async {
+ await check(_futureFail()).isRejectedByAsync(
+ (it) => it.throws<StateError>(),
+ actual: ['completed to error <UnimplementedError>'],
+ which: [
+ 'threw an exception that is not a StateError at:',
+ 'fake trace'
+ ],
+ );
+ });
+ test('can be described', () async {
+ await check((Subject<Future<void>> it) => it.throws())
+ .hasAsyncDescriptionWhich(
+ (it) => it.deepEquals([' completes to an error']));
+ await check((Subject<Future<void>> it) => it.throws<StateError>())
+ .hasAsyncDescriptionWhich((it) =>
+ it.deepEquals([' completes to an error of type StateError']));
+ });
+ });
+
+ group('doesNotComplete', () {
+ test('succeeds for a Future that never completes', () async {
+ check(Completer<void>().future).doesNotComplete();
+ });
+ test('fails for a Future that completes as a value', () async {
+ Object? testFailure;
+ runZonedGuarded(() {
+ final completer = Completer<String>();
+ check(completer.future).doesNotComplete();
+ completer.complete('value');
+ }, (e, st) {
+ testFailure = e;
+ });
+ await pumpEventQueue();
+ check(testFailure)
+ .isA<TestFailure>()
+ .has((f) => f.message, 'message')
+ .isNotNull()
+ .equals('''
+Expected: a Future<String> that:
+ does not complete
+Actual: a future that completed to 'value\'''');
+ });
+ test('fails for a Future that completes as an error', () async {
+ Object? testFailure;
+ runZonedGuarded(() {
+ final completer = Completer<String>();
+ check(completer.future).doesNotComplete();
+ completer.completeError('error', StackTrace.fromString('fake trace'));
+ }, (e, st) {
+ testFailure = e;
+ });
+ await pumpEventQueue();
+ check(testFailure)
+ .isA<TestFailure>()
+ .has((f) => f.message, 'message')
+ .isNotNull()
+ .equals('''
+Expected: a Future<String> that:
+ does not complete
+Actual: a future that completed as an error:
+Which: threw 'error'
+fake trace''');
+ });
+ test('can be described', () async {
+ await check((Subject<Future<void>> it) => it.doesNotComplete())
+ .hasAsyncDescriptionWhich(
+ (it) => it.deepEquals([' does not complete']));
+ });
+ });
+ });
+
+ group('StreamChecks', () {
+ group('emits', () {
+ test('succeeds for a stream that emits a value', () async {
+ await check(_countingStream(5)).emits((it) => it.equals(0));
+ });
+ test('fails for a stream that closes without emitting', () async {
+ await check(_countingStream(0)).isRejectedByAsync(
+ (it) => it.emits(),
+ actual: ['a stream'],
+ which: ['closed without emitting enough values'],
+ );
+ });
+ test('fails for a stream that emits an error', () async {
+ await check(_countingStream(1, errorAt: 0)).isRejectedByAsync(
+ (it) => it.emits(),
+ actual: ['a stream with error <UnimplementedError: Error at 1>'],
+ which: ['emitted an error instead of a value at:', 'fake trace'],
+ );
+ });
+ test('can be described', () async {
+ await check((Subject<StreamQueue<void>> it) => it.emits())
+ .hasAsyncDescriptionWhich(
+ (it) => it.deepEquals([' emits a value']));
+ await check((Subject<StreamQueue<int>> it) =>
+ it.emits((it) => it.equals(42)))
+ .hasAsyncDescriptionWhich((it) => it.deepEquals([
+ ' emits a value that:',
+ ' equals <42>',
+ ]));
+ });
+ test('does not consume error', () async {
+ final queue = _countingStream(1, errorAt: 0);
+ await softCheckAsync<StreamQueue<int>>(queue, (it) => it.emits());
+ await check(queue).emitsError();
+ });
+ });
+
+ group('emitsError', () {
+ test('succeeds for a stream that emits an error', () async {
+ await check(_countingStream(1, errorAt: 0))
+ .emitsError<UnimplementedError>();
+ });
+ test('fails for a stream that closes without emitting an error',
+ () async {
+ await check(_countingStream(0)).isRejectedByAsync(
+ (it) => it.emitsError(),
+ actual: ['a stream'],
+ which: ['closed without emitting an expected error'],
+ );
+ });
+ test('fails for a stream that emits value', () async {
+ await check(_countingStream(1)).isRejectedByAsync(
+ (it) => it.emitsError(),
+ actual: ['a stream emitting value <0>'],
+ which: ['closed without emitting an error'],
+ );
+ });
+ test('fails for a stream that emits an error of the incorrect type',
+ () async {
+ await check(_countingStream(1, errorAt: 0)).isRejectedByAsync(
+ (it) => it.emitsError<StateError>(),
+ actual: ['a stream with error <UnimplementedError: Error at 1>'],
+ which: ['emitted an error which is not StateError at:', 'fake trace'],
+ );
+ });
+ test('can be described', () async {
+ await check((Subject<StreamQueue<void>> it) => it.emitsError())
+ .hasAsyncDescriptionWhich(
+ (it) => it.deepEquals([' emits an error']));
+ await check(
+ (Subject<StreamQueue<void>> it) => it.emitsError<StateError>())
+ .hasAsyncDescriptionWhich(
+ (it) => it.deepEquals([' emits an error of type StateError']));
+ await check((Subject<StreamQueue<void>> it) => it
+ ..emitsError<StateError>(
+ (it) => it.has((e) => e.message, 'message').equals('foo')))
+ .hasAsyncDescriptionWhich((it) => it.deepEquals([
+ ' emits an error of type StateError that:',
+ ' has message that:',
+ ' equals \'foo\''
+ ]));
+ });
+ test('uses a transaction', () async {
+ final queue = _countingStream(1);
+ await softCheckAsync<StreamQueue<int>>(queue, (it) => it.emitsError());
+ await check(queue).emits((it) => it.equals(0));
+ });
+ });
+
+ group('emitsThrough', () {
+ test('succeeds for a stream that eventuall emits a matching value',
+ () async {
+ await check(_countingStream(5)).emitsThrough((it) => it.equals(4));
+ });
+ test('fails for a stream that closes without emitting a matching value',
+ () async {
+ await check(_countingStream(4)).isRejectedByAsync(
+ (it) => it.emitsThrough((it) => it.equals(5)),
+ actual: ['a stream'],
+ which: ['ended after emitting 4 elements with none matching'],
+ );
+ });
+ test('can be described', () async {
+ await check((Subject<StreamQueue<int>> it) =>
+ it.emitsThrough((it) => it.equals(42)))
+ .hasAsyncDescriptionWhich((it) => it.deepEquals([
+ ' emits any values then emits a value that:',
+ ' equals <42>'
+ ]));
+ });
+ test('uses a transaction', () async {
+ final queue = _countingStream(1);
+ await softCheckAsync(
+ queue,
+ (Subject<StreamQueue<int>> it) =>
+ it.emitsThrough((it) => it.equals(42)));
+ await check(queue).emits((it) => it.equals(0));
+ });
+ test('consumes events', () async {
+ final queue = _countingStream(3);
+ await check(queue).emitsThrough((it) => it.equals(1));
+ await check(queue).emits((it) => it.equals(2));
+ });
+ });
+
+ group('emitsInOrder', () {
+ test('succeeds for happy case', () async {
+ await check(_countingStream(2)).inOrder([
+ (it) => it.emits((it) => it.equals(0)),
+ (it) => it.emits((it) => it.equals(1)),
+ (it) => it.isDone(),
+ ]);
+ });
+ test('reports which condition failed', () async {
+ await check(_countingStream(1)).isRejectedByAsync(
+ (it) => it.inOrder([(it) => it.emits(), (it) => it.emits()]),
+ actual: ['a stream'],
+ which: [
+ 'satisfied 1 conditions then',
+ 'failed to satisfy the condition at index 1',
+ 'because it closed without emitting enough values'
+ ],
+ );
+ });
+ test('nestes the report for deep failures', () async {
+ await check(_countingStream(2)).isRejectedByAsync(
+ (it) => it.inOrder(
+ [(it) => it.emits(), (it) => it.emits((it) => it.equals(2))]),
+ actual: ['a stream'],
+ which: [
+ 'satisfied 1 conditions then',
+ 'failed to satisfy the condition at index 1',
+ 'because it:',
+ ' emits a value that:',
+ ' Actual: <1>',
+ ' Which: are not equal',
+ ],
+ );
+ });
+ test('gets described with the number of conditions', () async {
+ await check(
+ (Subject<StreamQueue<int>> it) => it.inOrder([(_) {}, (_) {}]))
+ .hasAsyncDescriptionWhich(
+ (it) => it.deepEquals([' satisfies 2 conditions in order']));
+ });
+ test('uses a transaction', () async {
+ final queue = _countingStream(3);
+ await softCheckAsync<StreamQueue<int>>(
+ queue,
+ (it) => it.inOrder([
+ (it) => it.emits((it) => it.equals(0)),
+ (it) => it.emits((it) => it.equals(1)),
+ (it) => it.emits((it) => it.equals(42)),
+ ]));
+ await check(queue).inOrder([
+ (it) => it.emits((it) => it.equals(0)),
+ (it) => it.emits((it) => it.equals(1)),
+ (it) => it.emits((it) => it.equals(2)),
+ (it) => it.isDone(),
+ ]);
+ });
+ test('consumes events', () async {
+ final queue = _countingStream(3);
+ await check(queue).inOrder([(it) => it.emits(), (it) => it.emits()]);
+ await check(queue).emits((it) => it.equals(2));
+ });
+ });
+
+ group('neverEmits', () {
+ test(
+ 'succeeds for a stream that closes without emitting a matching value',
+ () async {
+ await check(_countingStream(5)).neverEmits((it) => it.equals(5));
+ });
+ test('fails for a stream that emits a matching value', () async {
+ await check(_countingStream(6)).isRejectedByAsync(
+ (it) => it.neverEmits((it) => it.equals(5)),
+ actual: ['a stream'],
+ which: ['emitted <5>', 'following 5 other items'],
+ );
+ });
+ test('can be described', () async {
+ await check((Subject<StreamQueue<int>> it) =>
+ it.neverEmits((it) => it.equals(42)))
+ .hasAsyncDescriptionWhich((it) => it.deepEquals([
+ ' never emits a value that:',
+ ' equals <42>',
+ ]));
+ });
+ test('uses a transaction', () async {
+ final queue = _countingStream(2);
+ await softCheckAsync<StreamQueue<int>>(
+ queue, (it) => it.neverEmits((it) => it.equals(1)));
+ await check(queue).inOrder([
+ (it) => it.emits((it) => it.equals(0)),
+ (it) => it.emits((it) => it.equals(1)),
+ (it) => it.isDone(),
+ ]);
+ });
+ });
+
+ group('mayEmit', () {
+ test('succeeds for a stream that emits a matching value', () async {
+ await check(_countingStream(1)).mayEmit((it) => it.equals(0));
+ });
+ test('succeeds for a stream that emits an error', () async {
+ await check(_countingStream(1, errorAt: 0))
+ .mayEmit((it) => it.equals(0));
+ });
+ test('succeeds for a stream that closes', () async {
+ await check(_countingStream(0)).mayEmit((it) => it.equals(42));
+ });
+ test('consumes a matching event', () async {
+ final queue = _countingStream(2);
+ await softCheckAsync<StreamQueue<int>>(
+ queue, (it) => it.mayEmit((it) => it.equals(0)));
+ await check(queue).emits((it) => it.equals(1));
+ });
+ test('does not consume a non-matching event', () async {
+ final queue = _countingStream(2);
+ await softCheckAsync<StreamQueue<int>>(
+ queue, (it) => it.mayEmit((it) => it.equals(1)));
+ await check(queue).emits((it) => it.equals(0));
+ });
+ test('does not consume an error', () async {
+ final queue = _countingStream(1, errorAt: 0);
+ await softCheckAsync<StreamQueue<int>>(
+ queue, (it) => it.mayEmit((it) => it.equals(0)));
+ await check(queue).emitsError<UnimplementedError>(
+ (it) => it.has((e) => e.message, 'message').equals('Error at 1'));
+ });
+ });
+
+ group('mayEmitMultiple', () {
+ test('succeeds for a stream that emits a matching value', () async {
+ await check(_countingStream(1)).mayEmitMultiple((it) => it.equals(0));
+ });
+ test('succeeds for a stream that emits an error', () async {
+ await check(_countingStream(1, errorAt: 0))
+ .mayEmitMultiple((it) => it.equals(0));
+ });
+ test('succeeds for a stream that closes', () async {
+ await check(_countingStream(0)).mayEmitMultiple((it) => it.equals(42));
+ });
+ test('consumes matching events', () async {
+ final queue = _countingStream(3);
+ await softCheckAsync<StreamQueue<int>>(
+ queue, (it) => it.mayEmitMultiple((it) => it.isLessThan(2)));
+ await check(queue).emits((it) => it.equals(2));
+ });
+ test('consumes no events if no events match', () async {
+ final queue = _countingStream(2);
+ await softCheckAsync<StreamQueue<int>>(
+ queue, (it) => it.mayEmitMultiple((it) => it.isLessThan(0)));
+ await check(queue).emits((it) => it.equals(0));
+ });
+ test('does not consume an error', () async {
+ final queue = _countingStream(1, errorAt: 0);
+ await softCheckAsync<StreamQueue<int>>(
+ queue, (it) => it.mayEmitMultiple((it) => it.equals(0)));
+ await check(queue).emitsError<UnimplementedError>(
+ (it) => it.has((e) => e.message, 'message').equals('Error at 1'));
+ });
+ });
+
+ group('isDone', () {
+ test('succeeds for an empty stream', () async {
+ await check(_countingStream(0)).isDone();
+ });
+ test('fails for a stream that emits a value', () async {
+ await check(_countingStream(1)).isRejectedByAsync((it) => it.isDone(),
+ actual: ['a stream'], which: ['emitted an unexpected value: <0>']);
+ });
+ test('fails for a stream that emits an error', () async {
+ final controller = StreamController<void>();
+ controller.addError('sad', StackTrace.fromString('fake trace'));
+ await check(StreamQueue(controller.stream)).isRejectedByAsync(
+ (it) => it.isDone(),
+ actual: ['a stream'],
+ which: ['emitted an unexpected error: \'sad\'', 'fake trace']);
+ });
+ test('uses a transaction', () async {
+ final queue = _countingStream(1);
+ await softCheckAsync<StreamQueue<int>>(queue, (it) => it.isDone());
+ await check(queue).emits((it) => it.equals(0));
+ });
+ test('can be described', () async {
+ await check((Subject<StreamQueue<int>> it) => it.isDone())
+ .hasAsyncDescriptionWhich((it) => it.deepEquals([' is done']));
+ });
+ });
+
+ group('emitsAnyOf', () {
+ test('succeeds for a stream that matches one condition', () async {
+ await check(_countingStream(1)).anyOf([
+ (it) => it.emits((it) => it.equals(42)),
+ (it) => it.emits((it) => it.equals(0))
+ ]);
+ });
+ test('fails for a stream that matches no conditions', () async {
+ await check(_countingStream(0)).isRejectedByAsync(
+ (it) => it.anyOf([
+ (it) => it.emits(),
+ (it) => it.emitsThrough((it) => it.equals(1)),
+ ]),
+ actual: [
+ 'a stream'
+ ],
+ which: [
+ 'failed to satisfy any condition',
+ 'failed the condition at index 0 because it:',
+ ' closed without emitting enough values',
+ 'failed the condition at index 1 because it:',
+ ' ended after emitting 0 elements with none matching',
+ ]);
+ });
+ test('includes nested details for nested failures', () async {
+ await check(_countingStream(1)).isRejectedByAsync(
+ (it) => it.anyOf([
+ (it) => it.emits((it) => it.equals(42)),
+ (it) => it.emitsThrough((it) => it.equals(10)),
+ ]),
+ actual: [
+ 'a stream'
+ ],
+ which: [
+ 'failed to satisfy any condition',
+ 'failed the condition at index 0 because it:',
+ ' emits a value that:',
+ ' Actual: <0>',
+ ' Which: are not equal',
+ 'failed the condition at index 1 because it:',
+ ' ended after emitting 1 elements with none matching',
+ ]);
+ });
+ test('gets described with the number of conditions', () async {
+ await check((Subject<StreamQueue<int>> it) =>
+ it..anyOf([(it) => it.emits(), (it) => it.emits()]))
+ .hasAsyncDescriptionWhich(
+ (it) => it.deepEquals([' satisfies any of 2 conditions']));
+ });
+ test('uses a transaction', () async {
+ final queue = _countingStream(1);
+ await softCheckAsync<StreamQueue<int>>(
+ queue,
+ (it) => it.anyOf([
+ (it) => it.emits((it) => it.equals(10)),
+ (it) => it.emitsThrough((it) => it.equals(42)),
+ ]));
+ await check(queue).emits((it) => it.equals(0));
+ });
+ test('consumes events', () async {
+ final queue = _countingStream(3);
+ await check(queue).anyOf([
+ (it) => it.emits((it) => it.equals(1)),
+ (it) => it.emitsThrough((it) => it.equals(1))
+ ]);
+ await check(queue).emits((it) => it.equals(2));
+ });
+ });
+ });
+
+ group('StreamQueueWrap', () {
+ test('can wrap streams in a queue', () async {
+ await check(Stream.value(1)).withQueue.emits();
+ });
+ });
+}
+
+Future<int> _futureSuccess() => Future.microtask(() => 42);
+
+Future<int> _futureFail() =>
+ Future.error(UnimplementedError(), StackTrace.fromString('fake trace'));
+
+StreamQueue<int> _countingStream(int count, {int? errorAt}) => StreamQueue(
+ Stream.fromIterable(
+ Iterable<int>.generate(count, (index) {
+ if (index == errorAt) {
+ Error.throwWithStackTrace(UnimplementedError('Error at $count'),
+ StackTrace.fromString('fake trace'));
+ }
+ return index;
+ }),
+ ),
+ );
diff --git a/pkgs/checks/test/extensions/collection_equality_test.dart b/pkgs/checks/test/extensions/collection_equality_test.dart
new file mode 100644
index 0000000..28a10dd
--- /dev/null
+++ b/pkgs/checks/test/extensions/collection_equality_test.dart
@@ -0,0 +1,197 @@
+// 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 'package:checks/checks.dart';
+import 'package:checks/src/collection_equality.dart';
+import 'package:test/scaffolding.dart';
+
+void main() {
+ group('deepCollectionEquals', () {
+ test('allows nested collections with equal elements', () {
+ check(deepCollectionEquals([
+ 'a',
+ {'b': 1},
+ {'c', 'd'},
+ [
+ ['e']
+ ],
+ ], [
+ 'a',
+ {'b': 1},
+ {'c', 'd'},
+ [
+ ['e']
+ ],
+ ])).isNull();
+ });
+
+ test('allows collections inside sets', () {
+ check(deepCollectionEquals({
+ {'a': 1}
+ }, {
+ {'a': 1}
+ })).isNull();
+ });
+
+ test('allows collections as Map keys', () {
+ check(deepCollectionEquals([
+ {
+ {'a': 1}: {'b': 2}
+ }
+ ], [
+ {
+ {'a': 1}: {'b': 2}
+ }
+ ])).isNull();
+ });
+
+ test('allows conditions in place of elements in lists', () {
+ check(deepCollectionEquals([
+ 'a',
+ 'b'
+ ], [
+ (Subject<dynamic> it) => it.isA<String>().which((it) => it
+ ..startsWith('a')
+ ..length.isLessThan(2)),
+ (Subject<dynamic> it) => it.isA<String>().startsWith('b')
+ ])).isNull();
+ });
+
+ test('allows conditions in place of values in maps', () {
+ check(deepCollectionEquals([
+ {'a': 'b'}
+ ], [
+ {'a': (Subject<dynamic> it) => it.isA<String>().startsWith('b')}
+ ])).isNull();
+ });
+
+ test('allows conditions in place of elements in sets', () {
+ check(deepCollectionEquals({
+ 'b',
+ 'a'
+ }, {
+ 'a',
+ (Subject<dynamic> it) => it.isA<String>().startsWith('b')
+ })).isNull();
+ });
+
+ test('allows conditions in place of keys in maps', () {
+ check(deepCollectionEquals({
+ 'a': 'b'
+ }, {
+ (Subject<dynamic> it) => it.isA<String>().startsWith('a'): 'b'
+ })).isNull();
+ });
+
+ test('reports non-Set elements', () {
+ check(deepCollectionEquals([
+ ['a']
+ ], [
+ {'a'}
+ ])).isNotNull().deepEquals(['at [<0>] is not a Set']);
+ });
+
+ test('reports long iterables', () {
+ check(deepCollectionEquals([0], [])).isNotNull().deepEquals([
+ 'has more elements than expected',
+ 'expected an iterable with 0 element(s)'
+ ]);
+ });
+
+ test('reports short iterables', () {
+ check(deepCollectionEquals([], [0])).isNotNull().deepEquals([
+ 'has too few elements',
+ 'expected an iterable with at least 1 element(s)'
+ ]);
+ });
+
+ test('reports unequal elements in iterables', () {
+ check(deepCollectionEquals([0], [1]))
+ .isNotNull()
+ .deepEquals(['at [<0>] is <0>', 'which does not equal <1>']);
+ });
+
+ test('reports unmet conditions in iterables', () {
+ check(deepCollectionEquals(
+ [0], [(Subject<dynamic> it) => it.isA<int>().isGreaterThan(0)]))
+ .isNotNull()
+ .deepEquals([
+ 'has an element at [<0>] that:',
+ ' Actual: <0>',
+ ' which is not greater than <0>'
+ ]);
+ });
+
+ test('reports unmet conditions in map values', () {
+ check(deepCollectionEquals({
+ 'a': 'b'
+ }, {
+ 'a': (Subject<dynamic> it) => it.isA<String>().startsWith('a')
+ })).isNotNull().deepEquals([
+ "has an element at ['a'] that:",
+ " Actual: 'b'",
+ " which does not start with 'a'",
+ ]);
+ });
+
+ test('reports unmet conditions in map keys', () {
+ check(deepCollectionEquals({
+ 'b': 'a'
+ }, {
+ (Subject<dynamic> it) => it.isA<String>().startsWith('a'): 'a'
+ })).isNotNull().deepEquals([
+ 'has no entry to match <A value that:',
+ ' is a String',
+ " starts with 'a'>: 'a'",
+ ]);
+ });
+
+ test('maintains paths through maps when the keys are all values', () {
+ check(deepCollectionEquals({
+ 'a': [
+ {'b': 'c'}
+ ]
+ }, {
+ 'a': [
+ {'b': 'd'}
+ ]
+ })).isNotNull().deepEquals([
+ "at ['a'][<0>]['b'] is 'c'",
+ "which does not equal 'd'",
+ ]);
+ });
+
+ test('reports recursive lists', () {
+ var l = <Object>[];
+ l.add(l);
+ check(deepCollectionEquals(l, l))
+ .isNotNull()
+ .deepEquals(['exceeds the depth limit of 1000']);
+ });
+
+ test('reports recursive sets', () {
+ var s = <Object>{};
+ s.add(s);
+ check(deepCollectionEquals(s, s))
+ .isNotNull()
+ .deepEquals(['exceeds the depth limit of 1000']);
+ });
+
+ test('reports maps with recursive keys', () {
+ var m = <Object, Object>{};
+ m[m] = 0;
+ check(deepCollectionEquals(m, m))
+ .isNotNull()
+ .deepEquals(['exceeds the depth limit of 1000']);
+ });
+
+ test('reports maps with recursive values', () {
+ var m = <Object, Object>{};
+ m[0] = m;
+ check(deepCollectionEquals(m, m))
+ .isNotNull()
+ .deepEquals(['exceeds the depth limit of 1000']);
+ });
+ });
+}
diff --git a/pkgs/checks/test/extensions/core_test.dart b/pkgs/checks/test/extensions/core_test.dart
new file mode 100644
index 0000000..2133c36
--- /dev/null
+++ b/pkgs/checks/test/extensions/core_test.dart
@@ -0,0 +1,163 @@
+// Copyright (c) 2022, 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 'package:checks/checks.dart';
+import 'package:test/scaffolding.dart';
+
+import '../test_shared.dart';
+
+void main() {
+ group('TypeChecks', () {
+ test('isA', () {
+ check(1).isA<int>();
+
+ check(1).isRejectedBy((it) => it.isA<String>(), which: ['Is a int']);
+ });
+ });
+ group('HasField', () {
+ test('has', () {
+ check(1).has((v) => v.isOdd, 'isOdd').isTrue();
+
+ check(null).isRejectedBy(
+ (it) => it.has((v) {
+ Error.throwWithStackTrace(
+ UnimplementedError(), StackTrace.fromString('fake trace'));
+ }, 'foo').isNotNull(),
+ which: [
+ 'threw while trying to read foo: <UnimplementedError>',
+ 'fake trace'
+ ]);
+ });
+
+ test('which', () {
+ check(true).which((it) => it.isTrue());
+ });
+
+ test('not', () {
+ check(false).not((it) => it.isTrue());
+ check(true).isRejectedBy((it) => it.not((it) => it.isTrue()), which: [
+ 'is a value that: ',
+ ' is true',
+ ]);
+ });
+
+ group('anyOf', () {
+ test('succeeds for happy case', () {
+ check(-10)
+ .anyOf([(it) => it.isGreaterThan(1), (it) => it.isLessThan(-1)]);
+ });
+ test('rejects values that do not satisfy any condition', () {
+ check(0).isRejectedBy(
+ (it) => it.anyOf(
+ [(it) => it.isGreaterThan(1), (it) => it.isLessThan(-1)]),
+ which: ['did not match any condition']);
+ });
+ });
+ });
+
+ group('BoolChecks', () {
+ test('isTrue', () {
+ check(true).isTrue();
+
+ check(false).isRejectedBy((it) => it.isTrue());
+ });
+
+ test('isFalse', () {
+ check(false).isFalse();
+
+ check(true).isRejectedBy((it) => it.isFalse());
+ });
+ });
+
+ group('EqualityChecks', () {
+ test('equals', () {
+ check(1).equals(1);
+
+ check(1).isRejectedBy((it) => it.equals(2), which: ['are not equal']);
+ });
+ test('identical', () {
+ check(1).identicalTo(1);
+
+ check(1)
+ .isRejectedBy((it) => it.identicalTo(2), which: ['is not identical']);
+ });
+ });
+ group('NullabilityChecks', () {
+ test('isNotNull', () {
+ check(1).isNotNull();
+
+ check(null).isRejectedBy((it) => it.isNotNull());
+ });
+ test('isNull', () {
+ check(null).isNull();
+
+ check(1).isRejectedBy((it) => it.isNull());
+ });
+ });
+
+ group('ComparableChecks on Duration', () {
+ group('isGreaterThan', () {
+ test('succeeds for greater', () {
+ check(const Duration(seconds: 10))
+ .isGreaterThan(const Duration(seconds: 1));
+ });
+ test('fails for equal', () {
+ check(const Duration(seconds: 10)).isRejectedBy(
+ (it) => it.isGreaterThan(const Duration(seconds: 10)),
+ which: ['is not greater than <0:00:10.000000>']);
+ });
+ test('fails for less', () {
+ check(const Duration(seconds: 10)).isRejectedBy(
+ (it) => it.isGreaterThan(const Duration(seconds: 50)),
+ which: ['is not greater than <0:00:50.000000>']);
+ });
+ });
+ group('isGreaterOrEqual', () {
+ test('succeeds for greater', () {
+ check(const Duration(seconds: 10))
+ .isGreaterOrEqual(const Duration(seconds: 1));
+ });
+ test('succeeds for equal', () {
+ check(const Duration(seconds: 10))
+ .isGreaterOrEqual(const Duration(seconds: 10));
+ });
+ test('fails for less', () {
+ check(const Duration(seconds: 10)).isRejectedBy(
+ (it) => it.isGreaterOrEqual(const Duration(seconds: 50)),
+ which: ['is not greater than or equal to <0:00:50.000000>']);
+ });
+ });
+ group('isLessThan', () {
+ test('succeeds for less', () {
+ check(const Duration(seconds: 1))
+ .isLessThan(const Duration(seconds: 10));
+ });
+ test('fails for equal', () {
+ check(const Duration(seconds: 10)).isRejectedBy(
+ (it) => it.isLessThan(const Duration(seconds: 10)),
+ which: ['is not less than <0:00:10.000000>']);
+ });
+ test('fails for greater', () {
+ check(const Duration(seconds: 50)).isRejectedBy(
+ (it) => it.isLessThan(const Duration(seconds: 10)),
+ which: ['is not less than <0:00:10.000000>']);
+ });
+ });
+ group('isLessOrEqual', () {
+ test('succeeds for less', () {
+ check(const Duration(seconds: 10))
+ .isLessOrEqual(const Duration(seconds: 50));
+ });
+ test('succeeds for equal', () {
+ check(const Duration(seconds: 10))
+ .isLessOrEqual(const Duration(seconds: 10));
+ });
+ test('fails for greater', () {
+ check(const Duration(seconds: 10)).isRejectedBy(
+ (it) => it.isLessOrEqual(const Duration(seconds: 1)),
+ which: ['is not less than or equal to <0:00:01.000000>']);
+ });
+ });
+ });
+}
diff --git a/pkgs/checks/test/extensions/function_test.dart b/pkgs/checks/test/extensions/function_test.dart
new file mode 100644
index 0000000..034d8fe
--- /dev/null
+++ b/pkgs/checks/test/extensions/function_test.dart
@@ -0,0 +1,44 @@
+// Copyright (c) 2022, 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 'package:checks/checks.dart';
+import 'package:test/scaffolding.dart';
+
+import '../test_shared.dart';
+
+void main() {
+ group('ThrowsChecks', () {
+ group('throws', () {
+ test('succeeds for happy case', () {
+ check(() => throw StateError('oops!')).throws<StateError>();
+ });
+ test('fails for functions that return normally', () {
+ check(() {}).isRejectedBy((it) => it.throws<StateError>(),
+ actual: ['a function that returned <null>'],
+ which: ['did not throw']);
+ });
+ test('fails for functions that throw the wrong type', () {
+ check(() => throw StateError('oops!')).isRejectedBy(
+ (it) => it.throws<ArgumentError>(),
+ actual: ['a function that threw error <Bad state: oops!>'],
+ which: ['did not throw an ArgumentError'],
+ );
+ });
+ });
+
+ group('returnsNormally', () {
+ test('succeeds for happy case', () {
+ check(() => 1).returnsNormally().equals(1);
+ });
+ test('fails for functions that throw', () {
+ check(() {
+ Error.throwWithStackTrace(
+ StateError('oops!'), StackTrace.fromString('fake trace'));
+ }).isRejectedBy((it) => it.returnsNormally(),
+ actual: ['a function that throws'],
+ which: ['threw <Bad state: oops!>', 'fake trace']);
+ });
+ });
+ });
+}
diff --git a/pkgs/checks/test/extensions/iterable_test.dart b/pkgs/checks/test/extensions/iterable_test.dart
new file mode 100644
index 0000000..dafd84d
--- /dev/null
+++ b/pkgs/checks/test/extensions/iterable_test.dart
@@ -0,0 +1,275 @@
+// Copyright (c) 2022, 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 'package:checks/checks.dart';
+import 'package:test/scaffolding.dart';
+
+import '../test_shared.dart';
+
+Iterable<int> get _testIterable => Iterable.generate(2, (i) => i);
+
+void main() {
+ test('length', () {
+ check(_testIterable).length.equals(2);
+ });
+
+ group('first', () {
+ test('succeeds for happy case', () {
+ check(_testIterable).first.equals(0);
+ });
+ test('rejects empty iterable', () {
+ check(<Object>[])
+ .isRejectedBy((it) => it.first.equals(0), which: ['has no elements']);
+ });
+ });
+
+ group('last', () {
+ test('succeeds for happy case', () {
+ check(_testIterable).last.equals(1);
+ });
+ test('rejects empty iterable', () {
+ check(<Object>[])
+ .isRejectedBy((it) => it.last.equals(0), which: ['has no elements']);
+ });
+ });
+
+ group('single', () {
+ test('succeeds for happy case', () {
+ check([42]).single.equals(42);
+ });
+ test('rejects empty iterable', () {
+ check(<Object>[]).isRejectedBy((it) => it.single.equals(0),
+ which: ['has no elements']);
+ });
+ test('rejects iterable with too many elements', () {
+ check(_testIterable).isRejectedBy((it) => it.single.equals(0),
+ which: ['has more than one element']);
+ });
+ });
+
+ test('isEmpty', () {
+ check(<Object>[]).isEmpty();
+ check(_testIterable)
+ .isRejectedBy((it) => it.isEmpty(), which: ['is not empty']);
+ });
+
+ test('isNotEmpty', () {
+ check(_testIterable).isNotEmpty();
+ check(const Iterable<int>.empty())
+ .isRejectedBy((it) => it.isNotEmpty(), which: ['is empty']);
+ });
+
+ test('contains', () {
+ check(_testIterable).contains(0);
+ check(_testIterable)
+ .isRejectedBy((it) => it.contains(2), which: ['does not contain <2>']);
+ });
+ test('any', () {
+ check(_testIterable).any((it) => it.equals(1));
+ check(_testIterable).isRejectedBy((it) => it.any((it) => it.equals(2)),
+ which: ['Contains no matching element']);
+ });
+
+ group('containsInOrder', () {
+ test('succeeds for happy case', () {
+ check([0, 1, 0, 2, 0, 3]).containsInOrder([1, 2, 3]);
+ });
+ test('can use Condition<dynamic>', () {
+ check([0, 1]).containsInOrder(
+ [(Subject<dynamic> it) => it.isA<int>().isGreaterThan(0)]);
+ });
+ test('can use Condition<T>', () {
+ check([0, 1]).containsInOrder([(Subject<int> it) => it.isGreaterThan(0)]);
+ });
+ test('fails for not found elements by equality', () async {
+ check([0]).isRejectedBy((it) => it.containsInOrder([1]), which: [
+ 'did not have an element matching the expectation at index 0 <1>'
+ ]);
+ });
+ test('fails for not found elements by condition', () async {
+ check([0]).isRejectedBy(
+ (it) => it.containsInOrder(
+ [(Subject<dynamic> it) => it.isA<int>().isGreaterThan(0)]),
+ which: [
+ 'did not have an element matching the expectation at index 0 '
+ '<A value that:',
+ ' is a int',
+ ' is greater than <0>>'
+ ]);
+ });
+ test('can be described', () {
+ check((Subject<Iterable> it) => it.containsInOrder([1, 2, 3]))
+ .description
+ .deepEquals([' contains, in order: [1, 2, 3]']);
+ check((Subject<Iterable> it) =>
+ it.containsInOrder([1, (Subject<dynamic> it) => it.equals(2)]))
+ .description
+ .deepEquals([
+ ' contains, in order: [1,',
+ ' <A value that:',
+ ' equals <2>>]'
+ ]);
+ });
+ });
+
+ group('containsMatchingInOrder', () {
+ test('succeeds for happy case', () {
+ check([0, 1, 0, 2, 0, 3]).containsMatchingInOrder([
+ (it) => it.isLessThan(2),
+ (it) => it.isLessThan(3),
+ (it) => it.isLessThan(4),
+ ]);
+ });
+ test('fails for not found elements', () async {
+ check([0]).isRejectedBy(
+ (it) => it.containsMatchingInOrder([(it) => it.isGreaterThan(0)]),
+ which: [
+ 'did not have an element matching the expectation at index 0 '
+ '<A value that:',
+ ' is greater than <0>>'
+ ]);
+ });
+ test('can be described', () {
+ check((Subject<Iterable<int>> it) => it.containsMatchingInOrder([
+ (it) => it.isLessThan(2),
+ (it) => it.isLessThan(3),
+ (it) => it.isLessThan(4),
+ ])).description.deepEquals([
+ ' contains, in order: [<A value that:',
+ ' is less than <2>>,',
+ ' <A value that:',
+ ' is less than <3>>,',
+ ' <A value that:',
+ ' is less than <4>>]',
+ ]);
+ check((Subject<Iterable<int>> it) => it.containsMatchingInOrder(
+ [(it) => it.equals(1), (it) => it.equals(2)]))
+ .description
+ .deepEquals([
+ ' contains, in order: [<A value that:',
+ ' equals <1>>,',
+ ' <A value that:',
+ ' equals <2>>]'
+ ]);
+ });
+ });
+
+ group('containsEqualInOrder', () {
+ test('succeeds for happy case', () {
+ check([0, 1, 0, 2, 0, 3]).containsEqualInOrder([1, 2, 3]);
+ });
+ test('fails for not found elements', () async {
+ check([0]).isRejectedBy((it) => it.containsEqualInOrder([1]), which: [
+ 'did not have an element equal to the expectation at index 0 <1>'
+ ]);
+ });
+ test('can be described', () {
+ check((Subject<Iterable<int>> it) => it.containsEqualInOrder([1, 2, 3]))
+ .description
+ .deepEquals([' contains, in order: [1, 2, 3]']);
+ check((Subject<Iterable<int>> it) => it.containsEqualInOrder([1, 2]))
+ .description
+ .deepEquals([
+ ' contains, in order: [1, 2]',
+ ]);
+ });
+ });
+ group('every', () {
+ test('succeeds for the happy path', () {
+ check(_testIterable).every((it) => it.isGreaterOrEqual(-1));
+ });
+
+ test('includes details of first failing element', () async {
+ check(_testIterable)
+ .isRejectedBy((it) => it.every((it) => it.isLessThan(0)), which: [
+ 'has an element at index 0 that:',
+ ' Actual: <0>',
+ ' Which: is not less than <0>',
+ ]);
+ });
+ });
+
+ group('unorderedEquals', () {
+ test('success for happy case', () {
+ check(_testIterable).unorderedEquals(_testIterable.toList().reversed);
+ });
+
+ test('reports unmatched elements', () {
+ check(_testIterable).isRejectedBy(
+ (it) => it.unorderedEquals(_testIterable.followedBy([42, 100])),
+ which: [
+ 'has no element equal to the expected element at index 2: <42>',
+ 'or 1 other elements'
+ ]);
+ });
+
+ test('reports unexpected elements', () {
+ check(_testIterable.followedBy([42, 100]))
+ .isRejectedBy((it) => it.unorderedEquals(_testIterable), which: [
+ 'has an unexpected element at index 2: <42>',
+ 'and 1 other unexpected elements'
+ ]);
+ });
+ });
+
+ group('unorderedMatches', () {
+ test('success for happy case', () {
+ check(_testIterable).unorderedMatches(
+ _testIterable.toList().reversed.map((i) => (it) => it.equals(i)));
+ });
+
+ test('reports unmatched elements', () {
+ check(_testIterable).isRejectedBy(
+ (it) => it.unorderedMatches(_testIterable
+ .followedBy([42, 100]).map((i) => (it) => it.equals(i))),
+ which: [
+ 'has no element matching the condition at index 2:',
+ ' equals <42>',
+ 'or 1 other conditions'
+ ]);
+ });
+
+ test('reports unexpected elements', () {
+ check(_testIterable.followedBy([42, 100])).isRejectedBy(
+ (it) => it
+ .unorderedMatches(_testIterable.map((i) => (it) => it.equals(i))),
+ which: [
+ 'has an unmatched element at index 2: <42>',
+ 'and 1 other unmatched elements'
+ ]);
+ });
+ });
+
+ group('pairwiseMatches', () {
+ test('succeeds for the happy path', () {
+ check(_testIterable).pairwiseMatches([1, 2],
+ (expected) => (it) => it.isLessThan(expected), 'is less than');
+ });
+ test('fails for mismatched element', () async {
+ check(_testIterable).isRejectedBy(
+ (it) => it.pairwiseMatches([1, 1],
+ (expected) => (it) => it.isLessThan(expected), 'is less than'),
+ which: [
+ 'does not have an element at index 1 that:',
+ ' is less than <1>',
+ 'Actual element at index 1: <1>',
+ 'Which: is not less than <1>'
+ ]);
+ });
+ test('fails for too few elements', () {
+ check(_testIterable).isRejectedBy(
+ (it) => it.pairwiseMatches([1, 2, 3],
+ (expected) => (it) => it.isLessThan(expected), 'is less than'),
+ which: [
+ 'has too few elements, there is no element to match at index 2'
+ ]);
+ });
+ test('fails for too many elements', () {
+ check(_testIterable).isRejectedBy(
+ (it) => it.pairwiseMatches([1],
+ (expected) => (it) => it.isLessThan(expected), 'is less than'),
+ which: ['has too many elements, expected exactly 1']);
+ });
+ });
+}
diff --git a/pkgs/checks/test/extensions/map_test.dart b/pkgs/checks/test/extensions/map_test.dart
new file mode 100644
index 0000000..cb3e3e4
--- /dev/null
+++ b/pkgs/checks/test/extensions/map_test.dart
@@ -0,0 +1,119 @@
+// Copyright (c) 2022, 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 'package:checks/checks.dart';
+import 'package:test/scaffolding.dart';
+
+import '../test_shared.dart';
+
+const _testMap = {
+ 'a': 1,
+ 'b': 2,
+};
+
+void main() {
+ test('length', () {
+ check(_testMap).length.equals(2);
+ });
+ test('entries', () {
+ check(_testMap).entries.any(
+ (it) => it
+ ..has((p0) => p0.key, 'key').equals('a')
+ ..has((p0) => p0.value, 'value').equals(1),
+ );
+ });
+ test('keys', () {
+ check(_testMap).keys.contains('a');
+ });
+ test('values', () {
+ check(_testMap).values.contains(1);
+ });
+
+ group('operator []', () {
+ test('succeeds for a key that exists', () {
+ check(_testMap)['a'].equals(1);
+ });
+ test('fails for a missing key', () {
+ check(_testMap).isRejectedBy((it) => it['z'],
+ which: ["does not contain the key 'z'"]);
+ });
+ test('can be described', () {
+ check((Subject<Map<String, Object>> it) => it['some\nlong\nkey'])
+ .description
+ .deepEquals([
+ " contains a value for 'some",
+ ' long',
+ " key'",
+ ]);
+ check((Subject<Map<String, Object>> it) =>
+ it['some\nlong\nkey'].equals(1)).description.deepEquals([
+ " contains a value for 'some",
+ ' long',
+ " key' that:",
+ ' equals <1>',
+ ]);
+ });
+ });
+ test('isEmpty', () {
+ check(<String, int>{}).isEmpty();
+ check(_testMap).isRejectedBy((it) => it.isEmpty(), which: ['is not empty']);
+ });
+ test('isNotEmpty', () {
+ check(_testMap).isNotEmpty();
+ check(<Object, Object>{})
+ .isRejectedBy((it) => it.isNotEmpty(), which: ['is not empty']);
+ });
+ group('containsKey', () {
+ test('succeeds for a key that exists', () {
+ check(_testMap).containsKey('a');
+ });
+ test('fails for a missing key', () {
+ check(_testMap).isRejectedBy(
+ (it) => it.containsKey('c'),
+ which: ["does not contain key 'c'"],
+ );
+ });
+ test('can be described', () {
+ check((Subject<Map<String, Object>> it) =>
+ it.containsKey('some\nlong\nkey')).description.deepEquals([
+ " contains key 'some",
+ ' long',
+ " key'",
+ ]);
+ });
+ });
+ test('containsKeyThat', () {
+ check(_testMap).containsKeyThat((it) => it.equals('a'));
+ check(_testMap).isRejectedBy(
+ (it) => it.containsKeyThat((it) => it.equals('c')),
+ which: ['Contains no matching key'],
+ );
+ });
+ group('containsValue', () {
+ test('succeeds for happy case', () {
+ check(_testMap).containsValue(1);
+ });
+ test('fails for missing value', () {
+ check(_testMap).isRejectedBy(
+ (it) => it.containsValue(3),
+ which: ['does not contain value <3>'],
+ );
+ });
+ test('can be described', () {
+ check((Subject<Map<String, String>> it) =>
+ it.containsValue('some\nlong\nkey')).description.deepEquals([
+ " contains value 'some",
+ ' long',
+ " key'",
+ ]);
+ });
+ });
+ test('containsValueThat', () {
+ check(_testMap).containsValueThat((it) => it.equals(1));
+ check(_testMap).isRejectedBy(
+ (it) => it.containsValueThat((it) => it.equals(3)),
+ which: ['Contains no matching value'],
+ );
+ });
+}
diff --git a/pkgs/checks/test/extensions/math_test.dart b/pkgs/checks/test/extensions/math_test.dart
new file mode 100644
index 0000000..0f346d3
--- /dev/null
+++ b/pkgs/checks/test/extensions/math_test.dart
@@ -0,0 +1,149 @@
+// Copyright (c) 2022, 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 'package:checks/checks.dart';
+import 'package:test/scaffolding.dart';
+
+import '../test_shared.dart';
+
+void main() {
+ group('num checks', () {
+ group('isNaN', () {
+ test('succeeds for happy case', () {
+ check(double.nan).isNaN();
+ });
+ test('fails for ints', () {
+ check(42).isRejectedBy((it) => it.isNaN(), which: ['is a number']);
+ });
+ test('fails for numeric doubles', () {
+ check(42.1).isRejectedBy((it) => it.isNaN(), which: ['is a number']);
+ });
+ });
+
+ group('isNotNan', () {
+ test('succeeds for ints', () {
+ check(42).isNotNaN();
+ });
+ test('succeeds numeric doubles', () {
+ check(42.1).isNotNaN();
+ });
+ test('fails for NaN', () {
+ check(double.nan).isRejectedBy((it) => it.isNotNaN(),
+ which: ['is not a number (NaN)']);
+ });
+ });
+ group('isNegative', () {
+ test('succeeds for negative ints', () {
+ check(-1).isNegative();
+ });
+ test('succeeds for -0.0', () {
+ check(-0.0).isNegative();
+ });
+ test('fails for zero', () {
+ check(0)
+ .isRejectedBy((it) => it.isNegative(), which: ['is not negative']);
+ });
+ });
+ group('isNotNegative', () {
+ test('succeeds for positive ints', () {
+ check(1).isNotNegative();
+ });
+ test('succeeds for 0', () {
+ check(0).isNotNegative();
+ });
+ test('fails for -0.0', () {
+ check(-0.0)
+ .isRejectedBy((it) => it.isNotNegative(), which: ['is negative']);
+ });
+ test('fails for negative numbers', () {
+ check(-1)
+ .isRejectedBy((it) => it.isNotNegative(), which: ['is negative']);
+ });
+ });
+
+ group('isFinite', () {
+ test('succeeds for finite numbers', () {
+ check(1).isFinite();
+ });
+ test('fails for NaN', () {
+ check(double.nan)
+ .isRejectedBy((it) => it.isFinite(), which: ['is not finite']);
+ });
+ test('fails for infinity', () {
+ check(double.infinity)
+ .isRejectedBy((it) => it.isFinite(), which: ['is not finite']);
+ });
+ test('fails for negative infinity', () {
+ check(double.negativeInfinity)
+ .isRejectedBy((it) => it.isFinite(), which: ['is not finite']);
+ });
+ });
+ group('isNotFinite', () {
+ test('succeeds for infinity', () {
+ check(double.infinity).isNotFinite();
+ });
+ test('succeeds for negative infinity', () {
+ check(double.negativeInfinity).isNotFinite();
+ });
+ test('succeeds for NaN', () {
+ check(double.nan).isNotFinite();
+ });
+ test('fails for finite numbers', () {
+ check(1).isRejectedBy((it) => it.isNotFinite(), which: ['is finite']);
+ });
+ });
+ group('isInfinite', () {
+ test('succeeds for infinity', () {
+ check(double.infinity).isInfinite();
+ });
+ test('succeeds for negative infinity', () {
+ check(double.negativeInfinity).isInfinite();
+ });
+ test('fails for NaN', () {
+ check(double.nan)
+ .isRejectedBy((it) => it.isInfinite(), which: ['is not infinite']);
+ });
+ test('fails for finite numbers', () {
+ check(1)
+ .isRejectedBy((it) => it.isInfinite(), which: ['is not infinite']);
+ });
+ });
+
+ group('isNotInfinite', () {
+ test('succeeds for finite numbers', () {
+ check(1).isNotInfinite();
+ });
+ test('succeeds for NaN', () {
+ check(double.nan).isNotInfinite();
+ });
+ test('fails for infinity', () {
+ check(double.infinity)
+ .isRejectedBy((it) => it.isNotInfinite(), which: ['is infinite']);
+ });
+ test('fails for negative infinity', () {
+ check(double.negativeInfinity)
+ .isRejectedBy((it) => it.isNotInfinite(), which: ['is infinite']);
+ });
+ });
+ group('closeTo', () {
+ test('succeeds for equal numbers', () {
+ check(1).isCloseTo(1, 1);
+ });
+ test('succeeds at less than delta away', () {
+ check(1).isCloseTo(2, 2);
+ });
+ test('succeeds at exactly delta away', () {
+ check(1).isCloseTo(2, 1);
+ });
+ test('fails for low values', () {
+ check(1).isRejectedBy((it) => it.isCloseTo(3, 1),
+ which: ['differs by <2>']);
+ });
+ test('fails for high values', () {
+ check(5).isRejectedBy((it) => it.isCloseTo(3, 1),
+ which: ['differs by <2>']);
+ });
+ });
+ });
+}
diff --git a/pkgs/checks/test/extensions/string_test.dart b/pkgs/checks/test/extensions/string_test.dart
new file mode 100644
index 0000000..2b651f1
--- /dev/null
+++ b/pkgs/checks/test/extensions/string_test.dart
@@ -0,0 +1,200 @@
+// Copyright (c) 2022, 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 'package:checks/checks.dart';
+import 'package:test/scaffolding.dart';
+
+import '../test_shared.dart';
+
+void main() {
+ group('StringChecks', () {
+ test('contains', () {
+ check('bob').contains('bo');
+ check('bob').isRejectedBy((it) => it.contains('kayleb'),
+ which: ["Does not contain 'kayleb'"]);
+ });
+ test('length', () {
+ check('bob').length.equals(3);
+ });
+ test('isEmpty', () {
+ check('').isEmpty();
+ check('bob').isRejectedBy((it) => it.isEmpty(), which: ['is not empty']);
+ });
+ test('isNotEmpty', () {
+ check('bob').isNotEmpty();
+ check('').isRejectedBy((it) => it.isNotEmpty(), which: ['is empty']);
+ });
+ test('startsWith', () {
+ check('bob').startsWith('bo');
+ check('bob').isRejectedBy((it) => it.startsWith('kayleb'),
+ which: ["does not start with 'kayleb'"]);
+ });
+ test('endsWith', () {
+ check('bob').endsWith('ob');
+ check('bob').isRejectedBy((it) => it.endsWith('kayleb'),
+ which: ["does not end with 'kayleb'"]);
+ });
+
+ group('matches', () {
+ test('succeeds for strings that match a regex', () {
+ check('123').matchesPattern(RegExp(r'\d\d\d'));
+ });
+ test('succeeds for strings that match a string pattern', () {
+ check(r'\d').matchesPattern(r'\d');
+ });
+ test('fails for non-matching regex', () {
+ check('abc').isRejectedBy((it) => it.matchesPattern(RegExp(r'\d\d\d')),
+ which: [r'does not match <RegExp: pattern=\d\d\d flags=>']);
+ });
+ test('fails for non-matching string pattern', () {
+ // A string is _not_ converted to a regex, string patterns must match
+ // directly.
+ check('123').isRejectedBy((it) => it.matchesPattern(r'\d\d\d'),
+ which: [r"does not match '\\d\\d\\d'"]);
+ });
+ test('can be described', () {
+ check((Subject<String> it) => it.matchesPattern(RegExp(r'\d\d\d')))
+ .description
+ .deepEquals([r' matches <RegExp: pattern=\d\d\d flags=>']);
+ check((Subject<String> it) => it.matchesPattern('abc'))
+ .description
+ .deepEquals([r" matches 'abc'"]);
+ });
+ });
+
+ group('containsInOrder', () {
+ test('happy case', () {
+ check('foo bar baz').containsInOrder(['foo', 'baz']);
+ });
+ test('reports when first substring is missing', () {
+ check('baz').isRejectedBy((it) => it.containsInOrder(['foo', 'baz']),
+ which: ['does not have a match for the substring \'foo\'']);
+ });
+ test('reports when substring is missing following a match', () {
+ check('foo bar')
+ .isRejectedBy((it) => it.containsInOrder(['foo', 'baz']), which: [
+ 'does not have a match for the substring \'baz\'',
+ 'following the other matches up to character 3'
+ ]);
+ });
+ });
+
+ group('equals', () {
+ test('succeeeds for happy case', () {
+ check('foo').equals('foo');
+ });
+ test('succeeeds for equal empty strings', () {
+ check('').equals('');
+ });
+ test('reports extra characters for long string', () {
+ check('foobar').isRejectedBy((it) => it.equals('foo'),
+ which: ['is too long with unexpected trailing characters:', 'bar']);
+ });
+ test('reports extra characters for long string against empty', () {
+ check('foo').isRejectedBy((it) => it.equals(''),
+ which: ['is not the empty string']);
+ });
+ test('reports truncated extra characters for very long string', () {
+ check('foobar baz more stuff').isRejectedBy((it) => it.equals('foo'),
+ which: [
+ 'is too long with unexpected trailing characters:',
+ 'bar baz mo ...'
+ ]);
+ });
+ test('reports missing characters for short string', () {
+ check('foo').isRejectedBy((it) => it.equals('foobar'),
+ which: ['is too short with missing trailing characters:', 'bar']);
+ });
+ test('reports missing characters for empty string', () {
+ check('').isRejectedBy((it) => it.equals('foo bar baz'),
+ actual: ['an empty string'],
+ which: ['is missing all expected characters:', 'foo bar ba ...']);
+ });
+ test('reports truncated missing characters for very short string', () {
+ check('foo').isRejectedBy((it) => it.equals('foobar baz more stuff'),
+ which: [
+ 'is too short with missing trailing characters:',
+ 'bar baz mo ...'
+ ]);
+ });
+ test('reports index of different character', () {
+ check('hit').isRejectedBy((it) => it.equals('hat'), which: [
+ 'differs at offset 1:',
+ 'hat',
+ 'hit',
+ ' ^',
+ ]);
+ });
+ test('reports truncated index of different character in large string',
+ () {
+ check('blah blah blah hit blah blah blah').isRejectedBy(
+ (it) => it.equals('blah blah blah hat blah blah blah'),
+ which: [
+ 'differs at offset 16:',
+ '... lah blah hat blah bl ...',
+ '... lah blah hit blah bl ...',
+ ' ^',
+ ]);
+ });
+ });
+
+ group('equalsIgnoringCase', () {
+ test('succeeeds for happy case', () {
+ check('FOO').equalsIgnoringCase('foo');
+ check('foo').equalsIgnoringCase('FOO');
+ });
+ test('reports original extra characters for long string', () {
+ check('FOOBAR').isRejectedBy((it) => it.equalsIgnoringCase('foo'),
+ which: ['is too long with unexpected trailing characters:', 'BAR']);
+ });
+ test('reports original missing characters for short string', () {
+ check('FOO').isRejectedBy((it) => it.equalsIgnoringCase('fooBAR'),
+ which: ['is too short with missing trailing characters:', 'BAR']);
+ });
+ test('reports index of different character with original characters', () {
+ check('HiT').isRejectedBy((it) => it.equalsIgnoringCase('hAt'), which: [
+ 'differs at offset 1:',
+ 'hAt',
+ 'HiT',
+ ' ^',
+ ]);
+ });
+ });
+
+ group('equalsIgnoringWhitespace', () {
+ test('allows differing internal whitespace', () {
+ check('foo \t\n bar').equalsIgnoringWhitespace('foo bar');
+ });
+ test('allows extra leading/trailing whitespace', () {
+ check(' foo ').equalsIgnoringWhitespace('foo');
+ });
+ test('allows missing leading/trailing whitespace', () {
+ check('foo').equalsIgnoringWhitespace(' foo ');
+ });
+ test('reports original extra characters for long string', () {
+ check('foo \t bar \n baz').isRejectedBy(
+ (it) => it.equalsIgnoringWhitespace('foo bar'),
+ which: [
+ 'is too long with unexpected trailing characters:',
+ ' baz'
+ ]);
+ });
+ test('reports original missing characters for short string', () {
+ check('foo bar').isRejectedBy(
+ (it) => it.equalsIgnoringWhitespace('foo bar baz'),
+ which: ['is too short with missing trailing characters:', ' baz']);
+ });
+ test('reports index of different character with original characters', () {
+ check('x hit x').isRejectedBy(
+ (it) => it.equalsIgnoringWhitespace('x hat x'),
+ which: [
+ 'differs at offset 3:',
+ 'x hat x',
+ 'x hit x',
+ ' ^',
+ ]);
+ });
+ });
+ });
+}
diff --git a/pkgs/checks/test/failure_message_test.dart b/pkgs/checks/test/failure_message_test.dart
new file mode 100644
index 0000000..ee5401c
--- /dev/null
+++ b/pkgs/checks/test/failure_message_test.dart
@@ -0,0 +1,53 @@
+import 'package:checks/checks.dart';
+import 'package:test/scaffolding.dart';
+import 'package:test_api/hooks.dart' show TestFailure;
+
+void main() {
+ group('failures', () {
+ test('includes expected, actual, and which', () {
+ check(() {
+ check(1).isGreaterThan(2);
+ }).throwsFailure().equals('''
+Expected: a int that:
+ is greater than <2>
+Actual: <1>
+Which: is not greater than <2>''');
+ });
+
+ test('includes matching portions of actual', () {
+ check(() {
+ check(<dynamic>[]).length.equals(1);
+ }).throwsFailure().equals('''
+Expected: a List<dynamic> that:
+ has length that:
+ equals <1>
+Actual: a List<dynamic> that:
+ has length that:
+ Actual: <0>
+ Which: are not equal''');
+ });
+
+ test('include a reason when provided', () {
+ check(() {
+ check(because: 'Some reason', 1).isGreaterThan(2);
+ }).throwsFailure().endsWith('Reason: Some reason');
+ });
+
+ test('retain type label following isNotNull', () {
+ check(() {
+ check<int?>(1).isNotNull().isGreaterThan(2);
+ }).throwsFailure().startsWith('Expected: a int? that:\n');
+ });
+
+ test('retain reason following isNotNull', () {
+ check(() {
+ check<int?>(because: 'Some reason', 1).isNotNull().isGreaterThan(2);
+ }).throwsFailure().endsWith('Reason: Some reason');
+ });
+ });
+}
+
+extension on Subject<void Function()> {
+ Subject<String> throwsFailure() =>
+ throws<TestFailure>().has((f) => f.message, 'message').isNotNull();
+}
diff --git a/pkgs/checks/test/soft_check_test.dart b/pkgs/checks/test/soft_check_test.dart
new file mode 100644
index 0000000..d919b0d
--- /dev/null
+++ b/pkgs/checks/test/soft_check_test.dart
@@ -0,0 +1,30 @@
+// 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 'package:checks/checks.dart';
+import 'package:test/scaffolding.dart';
+
+import 'test_shared.dart';
+
+void main() {
+ group('softCheck', () {
+ test('returns the first failure', () {
+ check(0).isRejectedBy(
+ (it) => it
+ ..isGreaterThan(1)
+ ..isGreaterThan(2),
+ which: ['is not greater than <1>']);
+ });
+ });
+ group('softCheckAsync', () {
+ test('returns the first failure', () async {
+ await check(Future.value(0)).isRejectedByAsync(
+ (it) => it
+ ..completes((it) => it.isGreaterThan(1))
+ ..completes((it) => it.isGreaterThan(2)),
+ actual: ['<0>'],
+ which: ['is not greater than <1>']);
+ });
+ });
+}
diff --git a/pkgs/checks/test/test_shared.dart b/pkgs/checks/test/test_shared.dart
new file mode 100644
index 0000000..87401ca
--- /dev/null
+++ b/pkgs/checks/test/test_shared.dart
@@ -0,0 +1,92 @@
+// Copyright (c) 2022, 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:checks/checks.dart';
+import 'package:checks/context.dart';
+
+extension RejectionChecks<T> on Subject<T> {
+ void isRejectedBy(Condition<T> condition,
+ {Iterable<String>? actual, Iterable<String>? which}) {
+ late T actualValue;
+ var didRunCallback = false;
+ final rejection = context.nest<Rejection>(
+ () => ['does not meet a condition with a Rejection'], (value) {
+ actualValue = value;
+ didRunCallback = true;
+ final failure = softCheck(value, condition);
+ if (failure == null) {
+ return Extracted.rejection(which: [
+ 'was accepted by the condition checking:',
+ ...describe(condition)
+ ]);
+ }
+ return Extracted.value(failure.rejection);
+ });
+ if (didRunCallback) {
+ rejection
+ .has((r) => r.actual, 'actual')
+ .deepEquals(actual ?? literal(actualValue));
+ } else {
+ rejection
+ .has((r) => r.actual, 'actual')
+ .context
+ .expect(() => ['is left default'], (_) => null);
+ }
+ if (which == null) {
+ rejection.has((r) => r.which, 'which').isNull();
+ } else {
+ rejection.has((r) => r.which, 'which').isNotNull().deepEquals(which);
+ }
+ }
+
+ Future<void> isRejectedByAsync(Condition<T> condition,
+ {Iterable<String>? actual, Iterable<String>? which}) async {
+ late T actualValue;
+ var didRunCallback = false;
+ await context.nestAsync<Rejection>(
+ () => ['does not meet an async condition with a Rejection'],
+ (value) async {
+ actualValue = value;
+ didRunCallback = true;
+ final failure = await softCheckAsync(value, condition);
+ if (failure == null) {
+ return Extracted.rejection(which: [
+ 'was accepted by the condition checking:',
+ ...await describeAsync(condition)
+ ]);
+ }
+ return Extracted.value(failure.rejection);
+ }, (rejection) {
+ if (didRunCallback) {
+ rejection
+ .has((r) => r.actual, 'actual')
+ .deepEquals(actual ?? literal(actualValue));
+ } else {
+ rejection
+ .has((r) => r.actual, 'actual')
+ .context
+ .expect(() => ['is left default'], (_) => null);
+ }
+ if (which == null) {
+ rejection.has((r) => r.which, 'which').isNull();
+ } else {
+ rejection.has((r) => r.which, 'which').isNotNull().deepEquals(which);
+ }
+ });
+ }
+}
+
+extension ConditionChecks<T> on Subject<Condition<T>> {
+ Subject<Iterable<String>> get description =>
+ has((c) => describe<T>(c), 'description');
+ Future<void> hasAsyncDescriptionWhich(
+ Condition<Iterable<String>> descriptionCondition) =>
+ context.nestAsync(
+ () => ['has description'],
+ (condition) async =>
+ Extracted.value(await describeAsync<T>(condition)),
+ descriptionCondition);
+}
diff --git a/pkgs/fake_async/.gitignore b/pkgs/fake_async/.gitignore
new file mode 100644
index 0000000..63fe85d
--- /dev/null
+++ b/pkgs/fake_async/.gitignore
@@ -0,0 +1,5 @@
+.packages
+.pub/
+.dart_tool/
+build/
+pubspec.lock
diff --git a/pkgs/fake_async/AUTHORS b/pkgs/fake_async/AUTHORS
new file mode 100644
index 0000000..e8063a8
--- /dev/null
+++ b/pkgs/fake_async/AUTHORS
@@ -0,0 +1,6 @@
+# Below is a list of people and organizations that have contributed
+# to the project. Names should be added to the list like so:
+#
+# Name/Organization <email address>
+
+Google Inc.
diff --git a/pkgs/fake_async/CHANGELOG.md b/pkgs/fake_async/CHANGELOG.md
new file mode 100644
index 0000000..0f964ee
--- /dev/null
+++ b/pkgs/fake_async/CHANGELOG.md
@@ -0,0 +1,102 @@
+## 1.3.2
+
+* Require Dart 3.3
+* Fix bug where a `flushTimers` or `elapse` call from within
+ the callback of a periodic timer would immediately invoke
+ the same timer.
+* Move to `dart-lang/test` monorepo.
+* Require Dart 3.5.
+
+## 1.3.1
+
+* Populate the pubspec `repository` field.
+
+## 1.3.0
+
+* `FakeTimer.tick` will return a value instead of throwing.
+* `FakeAsync.includeTimerStackTrace` allows controlling whether timers created
+ with a FakeAsync will include a creation Stack Trace.
+
+## 1.2.0
+
+* Stable release for null safety.
+
+## 1.2.0-nullsafety.3
+
+* Update SDK constraints to `>=2.12.0-0 <3.0.0` based on beta release
+ guidelines.
+
+## 1.2.0-nullsafety.2
+
+* Allow prerelease versions of the 2.12 sdk.
+
+## 1.2.0-nullsafety.1
+
+* Allow 2.10 stable and 2.11.0 dev SDK versions.
+
+## 1.2.0-nullsafety
+
+Pre-release for the null safety migration of this package.
+
+Note that `1.2.0` may not be the final stable null safety release version,
+we reserve the right to release it as a `2.0.0` breaking change.
+
+This release will be pinned to only allow pre-release sdk versions starting
+from `2.10.0-0`.
+
+## 1.1.0
+
+* Exposed the `FakeTimer` class as a public class.
+* Added `FakeAsync.pendingTimers` which gives access to all pending timers at
+ the time of the call.
+
+## 1.0.2
+
+* Update min SDK to 2.2.0
+
+## 1.0.1
+
+* Update to lowercase Dart core library constants.
+* Fix use of deprecated `isInstanceOf` matcher.
+
+## 1.0.0
+
+This release contains the `FakeAsync` class that was defined in [`quiver`][].
+It's backwards-compatible with both the `quiver` version *and* the old version
+of the `fake_async` package.
+
+[`quiver`]: https://pub.dev/packages/quiver
+
+### New Features
+
+* A top-level `fakeAsync()` function was added that encapsulates
+ `new FakeAsync().run(...)`.
+
+### New Features Relative to `quiver`
+
+* `FakeAsync.elapsed` returns the total amount of fake time elapsed since the
+ `FakeAsync` instance was created.
+
+* `new FakeAsync()` now takes an `initialTime` argument that sets the default
+ time for clocks created with `FakeAsync.getClock()`, and for the `clock`
+ package's top-level `clock` variable.
+
+### New Features Relative to `fake_async` 0.1
+
+* `FakeAsync.periodicTimerCount`, `FakeAsync.nonPeriodicTimerCount`, and
+ `FakeAsync.microtaskCount` provide visibility into the events scheduled within
+ `FakeAsync.run()`.
+
+* `FakeAsync.getClock()` provides access to fully-featured `Clock` objects based
+ on `FakeAsync`'s elapsed time.
+
+* `FakeAsync.flushMicrotasks()` empties the microtask queue without elapsing any
+ time or running any timers.
+
+* `FakeAsync.flushTimers()` runs all microtasks and timers until there are no
+ more scheduled.
+
+## 0.1.2
+
+* Integrate with the clock package.
+
diff --git a/pkgs/fake_async/LICENSE b/pkgs/fake_async/LICENSE
new file mode 100644
index 0000000..7a4a3ea
--- /dev/null
+++ b/pkgs/fake_async/LICENSE
@@ -0,0 +1,202 @@
+
+ Apache License
+ Version 2.0, January 2004
+ http://www.apache.org/licenses/
+
+ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+ 1. Definitions.
+
+ "License" shall mean the terms and conditions for use, reproduction,
+ and distribution as defined by Sections 1 through 9 of this document.
+
+ "Licensor" shall mean the copyright owner or entity authorized by
+ the copyright owner that is granting the License.
+
+ "Legal Entity" shall mean the union of the acting entity and all
+ other entities that control, are controlled by, or are under common
+ control with that entity. For the purposes of this definition,
+ "control" means (i) the power, direct or indirect, to cause the
+ direction or management of such entity, whether by contract or
+ otherwise, or (ii) ownership of fifty percent (50%) or more of the
+ outstanding shares, or (iii) beneficial ownership of such entity.
+
+ "You" (or "Your") shall mean an individual or Legal Entity
+ exercising permissions granted by this License.
+
+ "Source" form shall mean the preferred form for making modifications,
+ including but not limited to software source code, documentation
+ source, and configuration files.
+
+ "Object" form shall mean any form resulting from mechanical
+ transformation or translation of a Source form, including but
+ not limited to compiled object code, generated documentation,
+ and conversions to other media types.
+
+ "Work" shall mean the work of authorship, whether in Source or
+ Object form, made available under the License, as indicated by a
+ copyright notice that is included in or attached to the work
+ (an example is provided in the Appendix below).
+
+ "Derivative Works" shall mean any work, whether in Source or Object
+ form, that is based on (or derived from) the Work and for which the
+ editorial revisions, annotations, elaborations, or other modifications
+ represent, as a whole, an original work of authorship. For the purposes
+ of this License, Derivative Works shall not include works that remain
+ separable from, or merely link (or bind by name) to the interfaces of,
+ the Work and Derivative Works thereof.
+
+ "Contribution" shall mean any work of authorship, including
+ the original version of the Work and any modifications or additions
+ to that Work or Derivative Works thereof, that is intentionally
+ submitted to Licensor for inclusion in the Work by the copyright owner
+ or by an individual or Legal Entity authorized to submit on behalf of
+ the copyright owner. For the purposes of this definition, "submitted"
+ means any form of electronic, verbal, or written communication sent
+ to the Licensor or its representatives, including but not limited to
+ communication on electronic mailing lists, source code control systems,
+ and issue tracking systems that are managed by, or on behalf of, the
+ Licensor for the purpose of discussing and improving the Work, but
+ excluding communication that is conspicuously marked or otherwise
+ designated in writing by the copyright owner as "Not a Contribution."
+
+ "Contributor" shall mean Licensor and any individual or Legal Entity
+ on behalf of whom a Contribution has been received by Licensor and
+ subsequently incorporated within the Work.
+
+ 2. Grant of Copyright License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ copyright license to reproduce, prepare Derivative Works of,
+ publicly display, publicly perform, sublicense, and distribute the
+ Work and such Derivative Works in Source or Object form.
+
+ 3. Grant of Patent License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ (except as stated in this section) patent license to make, have made,
+ use, offer to sell, sell, import, and otherwise transfer the Work,
+ where such license applies only to those patent claims licensable
+ by such Contributor that are necessarily infringed by their
+ Contribution(s) alone or by combination of their Contribution(s)
+ with the Work to which such Contribution(s) was submitted. If You
+ institute patent litigation against any entity (including a
+ cross-claim or counterclaim in a lawsuit) alleging that the Work
+ or a Contribution incorporated within the Work constitutes direct
+ or contributory patent infringement, then any patent licenses
+ granted to You under this License for that Work shall terminate
+ as of the date such litigation is filed.
+
+ 4. Redistribution. You may reproduce and distribute copies of the
+ Work or Derivative Works thereof in any medium, with or without
+ modifications, and in Source or Object form, provided that You
+ meet the following conditions:
+
+ (a) You must give any other recipients of the Work or
+ Derivative Works a copy of this License; and
+
+ (b) You must cause any modified files to carry prominent notices
+ stating that You changed the files; and
+
+ (c) You must retain, in the Source form of any Derivative Works
+ that You distribute, all copyright, patent, trademark, and
+ attribution notices from the Source form of the Work,
+ excluding those notices that do not pertain to any part of
+ the Derivative Works; and
+
+ (d) If the Work includes a "NOTICE" text file as part of its
+ distribution, then any Derivative Works that You distribute must
+ include a readable copy of the attribution notices contained
+ within such NOTICE file, excluding those notices that do not
+ pertain to any part of the Derivative Works, in at least one
+ of the following places: within a NOTICE text file distributed
+ as part of the Derivative Works; within the Source form or
+ documentation, if provided along with the Derivative Works; or,
+ within a display generated by the Derivative Works, if and
+ wherever such third-party notices normally appear. The contents
+ of the NOTICE file are for informational purposes only and
+ do not modify the License. You may add Your own attribution
+ notices within Derivative Works that You distribute, alongside
+ or as an addendum to the NOTICE text from the Work, provided
+ that such additional attribution notices cannot be construed
+ as modifying the License.
+
+ You may add Your own copyright statement to Your modifications and
+ may provide additional or different license terms and conditions
+ for use, reproduction, or distribution of Your modifications, or
+ for any such Derivative Works as a whole, provided Your use,
+ reproduction, and distribution of the Work otherwise complies with
+ the conditions stated in this License.
+
+ 5. Submission of Contributions. Unless You explicitly state otherwise,
+ any Contribution intentionally submitted for inclusion in the Work
+ by You to the Licensor shall be under the terms and conditions of
+ this License, without any additional terms or conditions.
+ Notwithstanding the above, nothing herein shall supersede or modify
+ the terms of any separate license agreement you may have executed
+ with Licensor regarding such Contributions.
+
+ 6. Trademarks. This License does not grant permission to use the trade
+ names, trademarks, service marks, or product names of the Licensor,
+ except as required for reasonable and customary use in describing the
+ origin of the Work and reproducing the content of the NOTICE file.
+
+ 7. Disclaimer of Warranty. Unless required by applicable law or
+ agreed to in writing, Licensor provides the Work (and each
+ Contributor provides its Contributions) on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+ implied, including, without limitation, any warranties or conditions
+ of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+ PARTICULAR PURPOSE. You are solely responsible for determining the
+ appropriateness of using or redistributing the Work and assume any
+ risks associated with Your exercise of permissions under this License.
+
+ 8. Limitation of Liability. In no event and under no legal theory,
+ whether in tort (including negligence), contract, or otherwise,
+ unless required by applicable law (such as deliberate and grossly
+ negligent acts) or agreed to in writing, shall any Contributor be
+ liable to You for damages, including any direct, indirect, special,
+ incidental, or consequential damages of any character arising as a
+ result of this License or out of the use or inability to use the
+ Work (including but not limited to damages for loss of goodwill,
+ work stoppage, computer failure or malfunction, or any and all
+ other commercial damages or losses), even if such Contributor
+ has been advised of the possibility of such damages.
+
+ 9. Accepting Warranty or Additional Liability. While redistributing
+ the Work or Derivative Works thereof, You may choose to offer,
+ and charge a fee for, acceptance of support, warranty, indemnity,
+ or other liability obligations and/or rights consistent with this
+ License. However, in accepting such obligations, You may act only
+ on Your own behalf and on Your sole responsibility, not on behalf
+ of any other Contributor, and only if You agree to indemnify,
+ defend, and hold each Contributor harmless for any liability
+ incurred by, or claims asserted against, such Contributor by reason
+ of your accepting any such warranty or additional liability.
+
+ END OF TERMS AND CONDITIONS
+
+ APPENDIX: How to apply the Apache License to your work.
+
+ To apply the Apache License to your work, attach the following
+ boilerplate notice, with the fields enclosed by brackets "[]"
+ replaced with your own identifying information. (Don't include
+ the brackets!) The text should be enclosed in the appropriate
+ comment syntax for the file format. We also recommend that a
+ file or class name and description of purpose be included on the
+ same "printed page" as the copyright notice for easier
+ identification within third-party archives.
+
+ Copyright [yyyy] [name of copyright owner]
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
\ No newline at end of file
diff --git a/pkgs/fake_async/README.md b/pkgs/fake_async/README.md
new file mode 100644
index 0000000..c7bb40b
--- /dev/null
+++ b/pkgs/fake_async/README.md
@@ -0,0 +1,51 @@
+[](https://pub.dev/packages/fake_async)
+[](https://pub.dev/packages/fake_async/publisher)
+
+This package provides a [`FakeAsync`][] class, which makes it easy to
+deterministically test code that uses asynchronous features like `Future`s,
+`Stream`s, `Timer`s, and microtasks. It creates an environment in which the user
+can explicitly control Dart's notion of the "current time". When the time is
+advanced, `FakeAsync` fires all asynchronous events that are scheduled for that
+time period without actually needing the test to wait for real time to elapse.
+
+[`FakeAsync`]: https://www.dartdocs.org/documentation/fake_async/latest/fake_async/FakeAsync-class.html
+
+For example:
+
+```dart
+import 'dart:async';
+
+import 'package:fake_async/fake_async.dart';
+import 'package:test/test.dart';
+
+void main() {
+ test("Future.timeout() throws an error once the timeout is up", () {
+ // Any code run within [fakeAsync] is run within the context of the
+ // [FakeAsync] object passed to the callback.
+ fakeAsync((async) {
+ // All asynchronous features that rely on timing are automatically
+ // controlled by [fakeAsync].
+ expect(Completer().future.timeout(Duration(seconds: 5)),
+ throwsA(isA<TimeoutException>()));
+
+ // This will cause the timeout above to fire immediately, without waiting
+ // 5 seconds of real time.
+ async.elapse(Duration(seconds: 5));
+ });
+ });
+}
+```
+
+## Integration With `clock`
+
+`FakeAsync` can't control the time reported by [`DateTime.now()`][] or by
+the [`Stopwatch`][] class, since they're not part of `dart:async`. However, if
+you create them using the [`clock`][] package's [`clock.now()`][] or
+[`clock.stopwatch()`][] functions, `FakeAsync` will automatically override
+them to use the same notion of time as `dart:async` classes.
+
+[`DateTime.now()`]: https://api.dart.dev/stable/dart-core/DateTime/DateTime.now.html
+[`Stopwatch`]: https://api.dart.dev/stable/dart-core/Stopwatch-class.html
+[`clock`]: https://pub.dev/packages/clock
+[`clock.now()`]: https://pub.dev/documentation/clock/latest/clock/Clock/now.html
+[`clock.stopwatch()`]: https://pub.dev/documentation/clock/latest/clock/Clock/stopwatch.html
diff --git a/pkgs/fake_async/analysis_options.yaml b/pkgs/fake_async/analysis_options.yaml
new file mode 100644
index 0000000..4e1b8e8
--- /dev/null
+++ b/pkgs/fake_async/analysis_options.yaml
@@ -0,0 +1,21 @@
+include: package:dart_flutter_team_lints/analysis_options.yaml
+analyzer:
+ language:
+ strict-casts: true
+
+linter:
+ rules:
+ - avoid_bool_literals_in_conditional_expressions
+ - avoid_classes_with_only_static_members
+ - avoid_returning_this
+ - avoid_unused_constructor_parameters
+ - cancel_subscriptions
+ - cascade_invocations
+ - comment_references
+ - join_return_with_assignment
+ - literal_only_boolean_expressions
+ - no_adjacent_strings_in_list
+ - prefer_const_constructors
+ - prefer_final_locals
+ - test_types_in_equals
+ - unnecessary_await_in_return
diff --git a/pkgs/fake_async/lib/fake_async.dart b/pkgs/fake_async/lib/fake_async.dart
new file mode 100644
index 0000000..b4eea85
--- /dev/null
+++ b/pkgs/fake_async/lib/fake_async.dart
@@ -0,0 +1,332 @@
+// Copyright 2014 Google Inc. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+import 'dart:async';
+import 'dart:collection';
+
+import 'package:clock/clock.dart';
+import 'package:collection/collection.dart';
+
+/// The type of a microtask callback.
+typedef _Microtask = void Function();
+
+/// Runs [callback] in a [Zone] where all asynchrony is controlled by an
+/// instance of [FakeAsync].
+///
+/// All [Future]s, [Stream]s, [Timer]s, microtasks, and other time-based
+/// asynchronous features used within [callback] are controlled by calls to
+/// [FakeAsync.elapse] rather than the passing of real time.
+///
+/// The [`clock`][] property will be set to a clock that reports the fake
+/// elapsed time. By default, it starts at the time [fakeAsync] was created
+/// (according to [`clock.now()`][]), but this can be controlled by passing
+/// [initialTime].
+///
+/// [`clock`]: https://www.dartdocs.org/documentation/clock/latest/clock/clock.html
+/// [`clock.now()`]: https://www.dartdocs.org/documentation/clock/latest/clock/Clock/now.html
+///
+/// Returns the result of [callback].
+T fakeAsync<T>(T Function(FakeAsync async) callback, {DateTime? initialTime}) =>
+ FakeAsync(initialTime: initialTime).run(callback);
+
+/// A class that mocks out the passage of time within a [Zone].
+///
+/// Test code can be passed as a callback to [run], which causes it to be run in
+/// a [Zone] which fakes timer and microtask creation, such that they are run
+/// during calls to [elapse] which simulates the asynchronous passage of time.
+///
+/// The synchronous passage of time (as from blocking or expensive calls) can
+/// also be simulated using [elapseBlocking].
+class FakeAsync {
+ /// The value of [clock] within [run].
+ late final Clock _clock;
+
+ /// The amount of fake time that's elapsed since this [FakeAsync] was
+ /// created.
+ Duration get elapsed => _elapsed;
+ var _elapsed = Duration.zero;
+
+ /// Whether Timers created by this FakeAsync will include a creation stack
+ /// trace in [FakeAsync.pendingTimersDebugString].
+ final bool includeTimerStackTrace;
+
+ /// The fake time at which the current call to [elapse] will finish running.
+ ///
+ /// This is `null` if there's no current call to [elapse].
+ Duration? _elapsingTo;
+
+ /// Tasks that are scheduled to run when fake time progresses.
+ final _microtasks = Queue<_Microtask>();
+
+ /// All timers created within [run].
+ final _timers = <FakeTimer>{};
+
+ /// All the current pending timers.
+ List<FakeTimer> get pendingTimers => _timers.toList(growable: false);
+
+ /// The debug strings for all the current pending timers.
+ List<String> get pendingTimersDebugString =>
+ pendingTimers.map((timer) => timer.debugString).toList(growable: false);
+
+ /// The number of active periodic timers created within a call to [run] or
+ /// [fakeAsync].
+ int get periodicTimerCount =>
+ _timers.where((timer) => timer.isPeriodic).length;
+
+ /// The number of active non-periodic timers created within a call to [run] or
+ /// [fakeAsync].
+ int get nonPeriodicTimerCount =>
+ _timers.where((timer) => !timer.isPeriodic).length;
+
+ /// The number of pending microtasks scheduled within a call to [run] or
+ /// [fakeAsync].
+ int get microtaskCount => _microtasks.length;
+
+ /// Creates a [FakeAsync].
+ ///
+ /// Within [run], the [`clock`][] property will start at [initialTime] and
+ /// move forward as fake time elapses.
+ ///
+ /// [`clock`]: https://www.dartdocs.org/documentation/clock/latest/clock/clock.html
+ ///
+ /// Note: it's usually more convenient to use [fakeAsync] rather than creating
+ /// a [FakeAsync] object and calling [run] manually.
+ FakeAsync({DateTime? initialTime, this.includeTimerStackTrace = true}) {
+ final nonNullInitialTime = initialTime ?? clock.now();
+ _clock = Clock(() => nonNullInitialTime.add(elapsed));
+ }
+
+ /// Returns a fake [Clock] whose time can is elapsed by calls to [elapse] and
+ /// [elapseBlocking].
+ ///
+ /// The returned clock starts at [initialTime] plus the fake time that's
+ /// already been elapsed. Further calls to [elapse] and [elapseBlocking] will
+ /// advance the clock as well.
+ ///
+ /// Note that it's usually easier to use the top-level [`clock`][] property.
+ /// Only call this function if you want a different [initialTime] than the
+ /// default.
+ ///
+ /// [`clock`]: https://www.dartdocs.org/documentation/clock/latest/clock/clock.html
+ Clock getClock(DateTime initialTime) =>
+ Clock(() => initialTime.add(_elapsed));
+
+ /// Simulates the asynchronous passage of time.
+ ///
+ /// Throws an [ArgumentError] if [duration] is negative. Throws a [StateError]
+ /// if a previous call to [elapse] has not yet completed.
+ ///
+ /// Any timers created within [run] or [fakeAsync] will fire if their time is
+ /// within [duration]. The microtask queue is processed before and after each
+ /// timer fires.
+ void elapse(Duration duration) {
+ if (duration.inMicroseconds < 0) {
+ throw ArgumentError.value(duration, 'duration', 'may not be negative');
+ } else if (_elapsingTo != null) {
+ throw StateError('Cannot elapse until previous elapse is complete.');
+ }
+
+ _elapsingTo = _elapsed + duration;
+ _fireTimersWhile((next) => next._nextCall <= _elapsingTo!);
+ _elapseTo(_elapsingTo!);
+ _elapsingTo = null;
+ }
+
+ /// Simulates the synchronous passage of time, resulting from blocking or
+ /// expensive calls.
+ ///
+ /// Neither timers nor microtasks are run during this call, but if this is
+ /// called within [elapse] they may fire afterwards.
+ ///
+ /// Throws an [ArgumentError] if [duration] is negative.
+ void elapseBlocking(Duration duration) {
+ if (duration.inMicroseconds < 0) {
+ throw ArgumentError('Cannot call elapse with negative duration');
+ }
+
+ _elapsed += duration;
+ final elapsingTo = _elapsingTo;
+ if (elapsingTo != null && _elapsed > elapsingTo) _elapsingTo = _elapsed;
+ }
+
+ /// Runs [callback] in a [Zone] where all asynchrony is controlled by `this`.
+ ///
+ /// All [Future]s, [Stream]s, [Timer]s, microtasks, and other time-based
+ /// asynchronous features used within [callback] are controlled by calls to
+ /// [elapse] rather than the passing of real time.
+ ///
+ /// The [`clock`][] property will be set to a clock that reports the fake
+ /// elapsed time. By default, it starts at the time the [FakeAsync] was
+ /// created (according to [`clock.now()`][]), but this can be controlled by
+ /// passing `initialTime` to [FakeAsync.new].
+ ///
+ /// [`clock`]: https://www.dartdocs.org/documentation/clock/latest/clock/clock.html
+ /// [`clock.now()`]: https://www.dartdocs.org/documentation/clock/latest/clock/Clock/now.html
+ ///
+ /// Calls [callback] with `this` as argument and returns its result.
+ ///
+ /// Note: it's usually more convenient to use [fakeAsync] rather than creating
+ /// a [FakeAsync] object and calling [run] manually.
+ T run<T>(T Function(FakeAsync self) callback) =>
+ runZoned(() => withClock(_clock, () => callback(this)),
+ zoneSpecification: ZoneSpecification(
+ createTimer: (_, __, ___, duration, callback) =>
+ _createTimer(duration, callback, false),
+ createPeriodicTimer: (_, __, ___, duration, callback) =>
+ _createTimer(duration, callback, true),
+ scheduleMicrotask: (_, __, ___, microtask) =>
+ _microtasks.add(microtask)));
+
+ /// Runs all pending microtasks scheduled within a call to [run] or
+ /// [fakeAsync] until there are no more microtasks scheduled.
+ ///
+ /// Does not run timers.
+ void flushMicrotasks() {
+ while (_microtasks.isNotEmpty) {
+ _microtasks.removeFirst()();
+ }
+ }
+
+ /// Elapses time until there are no more active timers.
+ ///
+ /// If `flushPeriodicTimers` is `true` (the default), this will repeatedly run
+ /// periodic timers until they're explicitly canceled. Otherwise, this will
+ /// stop when the only active timers are periodic.
+ ///
+ /// The [timeout] controls how much fake time may elapse before a [StateError]
+ /// is thrown. This ensures that a periodic timer doesn't cause this method to
+ /// deadlock. It defaults to one hour.
+ void flushTimers(
+ {Duration timeout = const Duration(hours: 1),
+ bool flushPeriodicTimers = true}) {
+ final absoluteTimeout = _elapsed + timeout;
+ _fireTimersWhile((timer) {
+ if (timer._nextCall > absoluteTimeout) {
+ // TODO(nweiz): Make this a [TimeoutException].
+ throw StateError('Exceeded timeout $timeout while flushing timers');
+ }
+
+ if (flushPeriodicTimers) return _timers.isNotEmpty;
+
+ // Continue firing timers until the only ones left are periodic *and*
+ // every periodic timer has had a change to run against the final
+ // value of [_elapsed].
+ return _timers
+ .any((timer) => !timer.isPeriodic || timer._nextCall <= _elapsed);
+ });
+ }
+
+ /// Invoke the callback for each timer until [predicate] returns `false` for
+ /// the next timer that would be fired.
+ ///
+ /// Microtasks are flushed before and after each timer is fired. Before each
+ /// timer fires, [_elapsed] is updated to the appropriate duration.
+ void _fireTimersWhile(bool Function(FakeTimer timer) predicate) {
+ flushMicrotasks();
+ for (;;) {
+ if (_timers.isEmpty) break;
+
+ final timer = minBy(_timers, (FakeTimer timer) => timer._nextCall)!;
+ if (!predicate(timer)) break;
+
+ _elapseTo(timer._nextCall);
+ timer._fire();
+ flushMicrotasks();
+ }
+ }
+
+ /// Creates a new timer controlled by `this` that fires [callback] after
+ /// [duration] (or every [duration] if [periodic] is `true`).
+ Timer _createTimer(Duration duration, Function callback, bool periodic) {
+ final timer = FakeTimer._(duration, callback, periodic, this,
+ includeStackTrace: includeTimerStackTrace);
+ _timers.add(timer);
+ return timer;
+ }
+
+ /// Sets [_elapsed] to [to] if [to] is longer than [_elapsed].
+ void _elapseTo(Duration to) {
+ if (to > _elapsed) _elapsed = to;
+ }
+}
+
+/// An implementation of [Timer] that's controlled by a [FakeAsync].
+class FakeTimer implements Timer {
+ /// If this is periodic, the time that should elapse between firings of this
+ /// timer.
+ ///
+ /// This is not used by non-periodic timers.
+ final Duration duration;
+
+ /// The callback to invoke when the timer fires.
+ ///
+ /// For periodic timers, this is a `void Function(Timer)`. For non-periodic
+ /// timers, it's a `void Function()`.
+ final Function _callback;
+
+ /// Whether this is a periodic timer.
+ final bool isPeriodic;
+
+ /// The [FakeAsync] instance that controls this timer.
+ final FakeAsync _async;
+
+ /// The value of [FakeAsync._elapsed] at (or after) which this timer should be
+ /// fired.
+ late Duration _nextCall;
+
+ /// The current stack trace when this timer was created.
+ ///
+ /// If [FakeAsync.includeTimerStackTrace] is set to false then accessing
+ /// this field will throw a [TypeError].
+ StackTrace get creationStackTrace => _creationStackTrace!;
+ final StackTrace? _creationStackTrace;
+
+ var _tick = 0;
+
+ @override
+ int get tick => _tick;
+
+ /// Returns debugging information to try to identify the source of the
+ /// [Timer].
+ String get debugString => 'Timer (duration: $duration, periodic: $isPeriodic)'
+ '${_creationStackTrace != null ? ', created:\n$creationStackTrace' : ''}';
+
+ FakeTimer._(Duration duration, this._callback, this.isPeriodic, this._async,
+ {bool includeStackTrace = true})
+ : duration = duration < Duration.zero ? Duration.zero : duration,
+ _creationStackTrace = includeStackTrace ? StackTrace.current : null {
+ _nextCall = _async._elapsed + this.duration;
+ }
+
+ @override
+ bool get isActive => _async._timers.contains(this);
+
+ @override
+ void cancel() => _async._timers.remove(this);
+
+ /// Fires this timer's callback and updates its state as necessary.
+ void _fire() {
+ assert(isActive);
+ _tick++;
+ if (isPeriodic) {
+ _nextCall += duration;
+ // ignore: avoid_dynamic_calls
+ _callback(this);
+ } else {
+ cancel();
+ // ignore: avoid_dynamic_calls
+ _callback();
+ }
+ }
+}
diff --git a/pkgs/fake_async/mono_pkg.yaml b/pkgs/fake_async/mono_pkg.yaml
new file mode 100644
index 0000000..b447edb
--- /dev/null
+++ b/pkgs/fake_async/mono_pkg.yaml
@@ -0,0 +1,15 @@
+# See https://pub.dev/packages/mono_repo
+
+stages:
+- analyze_and_format:
+ - group:
+ - format
+ - analyze: --fatal-infos
+ sdk: dev
+ - group:
+ - analyze
+ sdk: pubspec
+- unit_test:
+ - group:
+ - command: dart test
+ sdk: [dev, pubspec]
diff --git a/pkgs/fake_async/pubspec.yaml b/pkgs/fake_async/pubspec.yaml
new file mode 100644
index 0000000..f345860
--- /dev/null
+++ b/pkgs/fake_async/pubspec.yaml
@@ -0,0 +1,17 @@
+name: fake_async
+version: 1.3.2
+description: >-
+ Fake asynchronous events such as timers and microtasks for deterministic
+ testing.
+repository: https://github.com/dart-lang/test/tree/master/pkgs/fake_async
+environment:
+ sdk: ^3.3.0
+
+dependencies:
+ clock: ^1.1.0
+ collection: ^1.15.0
+
+dev_dependencies:
+ async: ^2.5.0
+ dart_flutter_team_lints: ^2.0.0
+ test: ^1.16.0
diff --git a/pkgs/fake_async/test/fake_async_test.dart b/pkgs/fake_async/test/fake_async_test.dart
new file mode 100644
index 0000000..463eecd
--- /dev/null
+++ b/pkgs/fake_async/test/fake_async_test.dart
@@ -0,0 +1,663 @@
+// Copyright 2014 Google Inc. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+import 'dart:async';
+
+import 'package:clock/clock.dart';
+import 'package:fake_async/fake_async.dart';
+import 'package:test/test.dart';
+
+void main() {
+ final initialTime = DateTime(2000);
+ final elapseBy = const Duration(days: 1);
+
+ test('should set initial time', () {
+ expect(FakeAsync().getClock(initialTime).now(), initialTime);
+ });
+
+ group('elapseBlocking', () {
+ test('should elapse time without calling timers', () {
+ Timer(elapseBy ~/ 2, neverCalled);
+ FakeAsync().elapseBlocking(elapseBy);
+ });
+
+ test('should elapse time by the specified amount', () {
+ final async = FakeAsync()..elapseBlocking(elapseBy);
+ expect(async.elapsed, elapseBy);
+ });
+
+ test('should throw when called with a negative duration', () {
+ expect(() => FakeAsync().elapseBlocking(const Duration(days: -1)),
+ throwsArgumentError);
+ });
+ });
+
+ group('elapse', () {
+ test('should elapse time by the specified amount', () {
+ FakeAsync().run((async) {
+ async.elapse(elapseBy);
+ expect(async.elapsed, elapseBy);
+ });
+ });
+
+ test('should throw ArgumentError when called with a negative duration', () {
+ expect(() => FakeAsync().elapse(const Duration(days: -1)),
+ throwsArgumentError);
+ });
+
+ test('should throw when called before previous call is complete', () {
+ FakeAsync().run((async) {
+ Timer(elapseBy ~/ 2, expectAsync0(() {
+ expect(() => async.elapse(elapseBy), throwsStateError);
+ }));
+ async.elapse(elapseBy);
+ });
+ });
+
+ group('when creating timers', () {
+ test('should call timers expiring before or at end time', () {
+ FakeAsync().run((async) {
+ Timer(elapseBy ~/ 2, expectAsync0(() {}));
+ Timer(elapseBy, expectAsync0(() {}));
+ async.elapse(elapseBy);
+ });
+ });
+
+ test('should call timers expiring due to elapseBlocking', () {
+ FakeAsync().run((async) {
+ Timer(elapseBy, () => async.elapseBlocking(elapseBy));
+ Timer(elapseBy * 2, expectAsync0(() {}));
+ async.elapse(elapseBy);
+ expect(async.elapsed, elapseBy * 2);
+ });
+ });
+
+ test('should call timers at their scheduled time', () {
+ FakeAsync().run((async) {
+ Timer(elapseBy ~/ 2, expectAsync0(() {
+ expect(async.elapsed, elapseBy ~/ 2);
+ }));
+
+ final periodicCalledAt = <Duration>[];
+ Timer.periodic(
+ elapseBy ~/ 2, (_) => periodicCalledAt.add(async.elapsed));
+
+ async.elapse(elapseBy);
+ expect(periodicCalledAt, [elapseBy ~/ 2, elapseBy]);
+ });
+ });
+
+ test('should not call timers expiring after end time', () {
+ FakeAsync().run((async) {
+ Timer(elapseBy * 2, neverCalled);
+ async.elapse(elapseBy);
+ });
+ });
+
+ test('should not call canceled timers', () {
+ FakeAsync().run((async) {
+ Timer(elapseBy ~/ 2, neverCalled).cancel();
+ async.elapse(elapseBy);
+ });
+ });
+
+ test('should call periodic timers each time the duration elapses', () {
+ FakeAsync().run((async) {
+ Timer.periodic(elapseBy ~/ 10, expectAsync1((_) {}, count: 10));
+ async.elapse(elapseBy);
+ });
+ });
+
+ test('should call timers occurring at the same time in FIFO order', () {
+ FakeAsync().run((async) {
+ final log = <String>[];
+ Timer(elapseBy ~/ 2, () => log.add('1'));
+ Timer(elapseBy ~/ 2, () => log.add('2'));
+ async.elapse(elapseBy);
+ expect(log, ['1', '2']);
+ });
+ });
+
+ test('should maintain FIFO order even with periodic timers', () {
+ FakeAsync().run((async) {
+ final log = <String>[];
+ Timer.periodic(elapseBy ~/ 2, (_) => log.add('periodic 1'));
+ Timer(elapseBy ~/ 2, () => log.add('delayed 1'));
+ Timer(elapseBy, () => log.add('delayed 2'));
+ Timer.periodic(elapseBy, (_) => log.add('periodic 2'));
+
+ async.elapse(elapseBy);
+ expect(log, [
+ 'periodic 1',
+ 'delayed 1',
+ 'periodic 1',
+ 'delayed 2',
+ 'periodic 2'
+ ]);
+ });
+ });
+
+ test('should process microtasks surrounding each timer', () {
+ FakeAsync().run((async) {
+ var microtaskCalls = 0;
+ var timerCalls = 0;
+ void scheduleMicrotasks() {
+ for (var i = 0; i < 5; i++) {
+ scheduleMicrotask(() => microtaskCalls++);
+ }
+ }
+
+ scheduleMicrotasks();
+ Timer.periodic(elapseBy ~/ 5, (_) {
+ timerCalls++;
+ expect(microtaskCalls, 5 * timerCalls);
+ scheduleMicrotasks();
+ });
+ async.elapse(elapseBy);
+ expect(timerCalls, 5);
+ expect(microtaskCalls, 5 * (timerCalls + 1));
+ });
+ });
+
+ test('should pass the periodic timer itself to callbacks', () {
+ FakeAsync().run((async) {
+ late Timer constructed;
+ constructed = Timer.periodic(elapseBy, expectAsync1((passed) {
+ expect(passed, same(constructed));
+ }));
+ async.elapse(elapseBy);
+ });
+ });
+
+ test('should call microtasks before advancing time', () {
+ FakeAsync().run((async) {
+ scheduleMicrotask(expectAsync0(() {
+ expect(async.elapsed, Duration.zero);
+ }));
+ async.elapse(const Duration(minutes: 1));
+ });
+ });
+
+ test('should add event before advancing time', () {
+ FakeAsync().run((async) {
+ final controller = StreamController<void>();
+ expect(controller.stream.first.then((_) {
+ expect(async.elapsed, Duration.zero);
+ }), completes);
+ controller.add(null);
+ async.elapse(const Duration(minutes: 1));
+ });
+ });
+
+ test('should increase negative duration timers to zero duration', () {
+ FakeAsync().run((async) {
+ final negativeDuration = const Duration(days: -1);
+ Timer(negativeDuration, expectAsync0(() {
+ expect(async.elapsed, Duration.zero);
+ }));
+ async.elapse(const Duration(minutes: 1));
+ });
+ });
+
+ test('should not be additive with elapseBlocking', () {
+ FakeAsync().run((async) {
+ Timer(Duration.zero, () => async.elapseBlocking(elapseBy * 5));
+ async.elapse(elapseBy);
+ expect(async.elapsed, elapseBy * 5);
+ });
+ });
+
+ group('isActive', () {
+ test('should be false after timer is run', () {
+ FakeAsync().run((async) {
+ final timer = Timer(elapseBy ~/ 2, () {});
+ async.elapse(elapseBy);
+ expect(timer.isActive, isFalse);
+ });
+ });
+
+ test('should be true after periodic timer is run', () {
+ FakeAsync().run((async) {
+ final timer = Timer.periodic(elapseBy ~/ 2, (_) {});
+ async.elapse(elapseBy);
+ expect(timer.isActive, isTrue);
+ });
+ });
+
+ test('should be false after timer is canceled', () {
+ FakeAsync().run((async) {
+ final timer = Timer(elapseBy ~/ 2, () {})..cancel();
+ expect(timer.isActive, isFalse);
+ });
+ });
+ });
+
+ test('should work with new Future()', () {
+ FakeAsync().run((async) {
+ Future(expectAsync0(() {}));
+ async.elapse(Duration.zero);
+ });
+ });
+
+ test('should work with Future.delayed', () {
+ FakeAsync().run((async) {
+ Future.delayed(elapseBy, expectAsync0(() {}));
+ async.elapse(elapseBy);
+ });
+ });
+
+ test('should work with Future.timeout', () {
+ FakeAsync().run((async) {
+ final completer = Completer<void>();
+ expect(completer.future.timeout(elapseBy ~/ 2),
+ throwsA(const TypeMatcher<TimeoutException>()));
+ async.elapse(elapseBy);
+ completer.complete();
+ });
+ });
+
+ // TODO: Pausing and resuming the timeout Stream doesn't work since
+ // it uses `new Stopwatch()`.
+ //
+ // See https://code.google.com/p/dart/issues/detail?id=18149
+ test('should work with Stream.periodic', () {
+ FakeAsync().run((async) {
+ expect(Stream.periodic(const Duration(minutes: 1), (i) => i),
+ emitsInOrder([0, 1, 2]));
+ async.elapse(const Duration(minutes: 3));
+ });
+ });
+
+ test('should work with Stream.timeout', () {
+ FakeAsync().run((async) {
+ final controller = StreamController<int>();
+ final timed = controller.stream.timeout(const Duration(minutes: 2));
+
+ final events = <int>[];
+ final errors = <Object>[];
+ timed.listen(events.add, onError: errors.add);
+
+ controller.add(0);
+ async.elapse(const Duration(minutes: 1));
+ expect(events, [0]);
+
+ async.elapse(const Duration(minutes: 1));
+ expect(errors, hasLength(1));
+ expect(errors.first, const TypeMatcher<TimeoutException>());
+ });
+ });
+ });
+ });
+
+ group('flushMicrotasks', () {
+ test('should flush a microtask', () {
+ FakeAsync().run((async) {
+ Future.microtask(expectAsync0(() {}));
+ async.flushMicrotasks();
+ });
+ });
+
+ test('should flush microtasks scheduled by microtasks in order', () {
+ FakeAsync().run((async) {
+ final log = <int>[];
+ scheduleMicrotask(() {
+ log.add(1);
+ scheduleMicrotask(() => log.add(3));
+ });
+ scheduleMicrotask(() => log.add(2));
+
+ async.flushMicrotasks();
+ expect(log, [1, 2, 3]);
+ });
+ });
+
+ test('should not run timers', () {
+ FakeAsync().run((async) {
+ final log = <int>[];
+ scheduleMicrotask(() => log.add(1));
+ Timer.run(() => log.add(2));
+ Timer.periodic(const Duration(seconds: 1), (_) => log.add(2));
+
+ async.flushMicrotasks();
+ expect(log, [1]);
+ });
+ });
+ });
+
+ group('flushTimers', () {
+ test('should flush timers in FIFO order', () {
+ FakeAsync().run((async) {
+ final log = <int>[];
+ Timer.run(() {
+ log.add(1);
+ Timer(elapseBy, () => log.add(3));
+ });
+ Timer.run(() => log.add(2));
+
+ async.flushTimers(timeout: elapseBy * 2);
+ expect(log, [1, 2, 3]);
+ expect(async.elapsed, elapseBy);
+ });
+ });
+
+ test(
+ 'should run collateral periodic timers with non-periodic first if '
+ 'scheduled first', () {
+ FakeAsync().run((async) {
+ final log = <String>[];
+ Timer(const Duration(seconds: 2), () => log.add('delayed'));
+ Timer.periodic(const Duration(seconds: 1), (_) => log.add('periodic'));
+
+ async.flushTimers(flushPeriodicTimers: false);
+ expect(log, ['periodic', 'delayed', 'periodic']);
+ });
+ });
+
+ test(
+ 'should run collateral periodic timers with periodic first '
+ 'if scheduled first', () {
+ FakeAsync().run((async) {
+ final log = <String>[];
+ Timer.periodic(const Duration(seconds: 1), (_) => log.add('periodic'));
+ Timer(const Duration(seconds: 2), () => log.add('delayed'));
+
+ async.flushTimers(flushPeriodicTimers: false);
+ expect(log, ['periodic', 'periodic', 'delayed']);
+ });
+ });
+
+ test('should time out', () {
+ FakeAsync().run((async) {
+ // Schedule 3 timers. All but the last one should fire.
+ for (var delay in [30, 60, 90]) {
+ Timer(Duration(minutes: delay),
+ expectAsync0(() {}, count: delay == 90 ? 0 : 1));
+ }
+
+ expect(() => async.flushTimers(), throwsStateError);
+ });
+ });
+
+ test('should time out a chain of timers', () {
+ FakeAsync().run((async) {
+ var count = 0;
+ void createTimer() {
+ Timer(const Duration(minutes: 30), () {
+ count++;
+ createTimer();
+ });
+ }
+
+ createTimer();
+ expect(() => async.flushTimers(timeout: const Duration(hours: 2)),
+ throwsStateError);
+ expect(count, 4);
+ });
+ });
+
+ test('should time out periodic timers', () {
+ FakeAsync().run((async) {
+ Timer.periodic(
+ const Duration(minutes: 30), expectAsync1((_) {}, count: 2));
+ expect(() => async.flushTimers(timeout: const Duration(hours: 1)),
+ throwsStateError);
+ });
+ });
+
+ test('should flush periodic timers', () {
+ FakeAsync().run((async) {
+ var count = 0;
+ Timer.periodic(const Duration(minutes: 30), (timer) {
+ if (count == 3) timer.cancel();
+ count++;
+ });
+ async.flushTimers(timeout: const Duration(hours: 20));
+ expect(count, 4);
+ });
+ });
+
+ test('should compute absolute timeout as elapsed + timeout', () {
+ FakeAsync().run((async) {
+ var count = 0;
+ void createTimer() {
+ Timer(const Duration(minutes: 30), () {
+ count++;
+ if (count < 4) createTimer();
+ });
+ }
+
+ createTimer();
+ async
+ ..elapse(const Duration(hours: 1))
+ ..flushTimers(timeout: const Duration(hours: 1));
+ expect(count, 4);
+ });
+ });
+ });
+
+ group('stats', () {
+ test('should report the number of pending microtasks', () {
+ FakeAsync().run((async) {
+ expect(async.microtaskCount, 0);
+ scheduleMicrotask(() {});
+ expect(async.microtaskCount, 1);
+ scheduleMicrotask(() {});
+ expect(async.microtaskCount, 2);
+ async.flushMicrotasks();
+ expect(async.microtaskCount, 0);
+ });
+ });
+
+ test('it should report the number of pending periodic timers', () {
+ FakeAsync().run((async) {
+ expect(async.periodicTimerCount, 0);
+ final timer = Timer.periodic(const Duration(minutes: 30), (_) {});
+ expect(async.periodicTimerCount, 1);
+ Timer.periodic(const Duration(minutes: 20), (_) {});
+ expect(async.periodicTimerCount, 2);
+ async.elapse(const Duration(minutes: 20));
+ expect(async.periodicTimerCount, 2);
+ timer.cancel();
+ expect(async.periodicTimerCount, 1);
+ });
+ });
+
+ test('it should report the number of pending non periodic timers', () {
+ FakeAsync().run((async) {
+ expect(async.nonPeriodicTimerCount, 0);
+ final timer = Timer(const Duration(minutes: 30), () {});
+ expect(async.nonPeriodicTimerCount, 1);
+ Timer(const Duration(minutes: 20), () {});
+ expect(async.nonPeriodicTimerCount, 2);
+ async.elapse(const Duration(minutes: 25));
+ expect(async.nonPeriodicTimerCount, 1);
+ timer.cancel();
+ expect(async.nonPeriodicTimerCount, 0);
+ });
+ });
+
+ test('should report debugging information of pending timers', () {
+ FakeAsync().run((fakeAsync) {
+ expect(fakeAsync.pendingTimers, isEmpty);
+ final nonPeriodic =
+ Timer(const Duration(seconds: 1), () {}) as FakeTimer;
+ final periodic =
+ Timer.periodic(const Duration(seconds: 2), (Timer timer) {})
+ as FakeTimer;
+ final debugInfo = fakeAsync.pendingTimers;
+ expect(debugInfo.length, 2);
+ expect(
+ debugInfo,
+ containsAll([
+ nonPeriodic,
+ periodic,
+ ]),
+ );
+
+ const thisFileName = 'fake_async_test.dart';
+ expect(nonPeriodic.debugString, contains(':01.0'));
+ expect(nonPeriodic.debugString, contains('periodic: false'));
+ expect(nonPeriodic.debugString, contains(thisFileName));
+ expect(periodic.debugString, contains(':02.0'));
+ expect(periodic.debugString, contains('periodic: true'));
+ expect(periodic.debugString, contains(thisFileName));
+ });
+ });
+
+ test(
+ 'should report debugging information of pending timers excluding '
+ 'stack traces', () {
+ FakeAsync(includeTimerStackTrace: false).run((fakeAsync) {
+ expect(fakeAsync.pendingTimers, isEmpty);
+ final nonPeriodic =
+ Timer(const Duration(seconds: 1), () {}) as FakeTimer;
+ final periodic =
+ Timer.periodic(const Duration(seconds: 2), (Timer timer) {})
+ as FakeTimer;
+ final debugInfo = fakeAsync.pendingTimers;
+ expect(debugInfo.length, 2);
+ expect(
+ debugInfo,
+ containsAll([
+ nonPeriodic,
+ periodic,
+ ]),
+ );
+
+ const thisFileName = 'fake_async_test.dart';
+ expect(nonPeriodic.debugString, contains(':01.0'));
+ expect(nonPeriodic.debugString, contains('periodic: false'));
+ expect(nonPeriodic.debugString, isNot(contains(thisFileName)));
+ expect(periodic.debugString, contains(':02.0'));
+ expect(periodic.debugString, contains('periodic: true'));
+ expect(periodic.debugString, isNot(contains(thisFileName)));
+ });
+ });
+ });
+
+ group('timers', () {
+ test("should become inactive as soon as they're invoked", () {
+ return FakeAsync().run((async) {
+ late Timer timer;
+ timer = Timer(elapseBy, expectAsync0(() {
+ expect(timer.isActive, isFalse);
+ }));
+
+ expect(timer.isActive, isTrue);
+ async.elapse(elapseBy);
+ expect(timer.isActive, isFalse);
+ });
+ });
+
+ test('should increment tick in a non-periodic timer', () {
+ return FakeAsync().run((async) {
+ late Timer timer;
+ timer = Timer(elapseBy, expectAsync0(() {
+ expect(timer.tick, 1);
+ }));
+
+ expect(timer.tick, 0);
+ async.elapse(elapseBy);
+ });
+ });
+
+ test('should increment tick in a periodic timer', () {
+ return FakeAsync().run((async) {
+ final ticks = <int>[];
+ Timer.periodic(
+ elapseBy,
+ expectAsync1((timer) {
+ ticks.add(timer.tick);
+ }, count: 2));
+ async
+ ..elapse(elapseBy)
+ ..elapse(elapseBy);
+ expect(ticks, [1, 2]);
+ });
+ });
+
+ test('should update periodic timer state before invoking callback', () {
+ // Regression test for: https://github.com/dart-lang/fake_async/issues/88
+ FakeAsync().run((async) {
+ final log = <String>[];
+ Timer.periodic(const Duration(seconds: 2), (timer) {
+ log.add('periodic ${timer.tick}');
+ async.elapse(Duration.zero);
+ });
+ Timer(const Duration(seconds: 3), () {
+ log.add('single');
+ });
+
+ async.flushTimers(flushPeriodicTimers: false);
+ expect(log, ['periodic 1', 'single']);
+ });
+ });
+ });
+
+ group('clock', () {
+ test('updates following elapse()', () {
+ FakeAsync().run((async) {
+ final before = clock.now();
+ async.elapse(elapseBy);
+ expect(clock.now(), before.add(elapseBy));
+ });
+ });
+
+ test('updates following elapseBlocking()', () {
+ FakeAsync().run((async) {
+ final before = clock.now();
+ async.elapseBlocking(elapseBy);
+ expect(clock.now(), before.add(elapseBy));
+ });
+ });
+
+ group('starts at', () {
+ test('the time at which the FakeAsync was created', () {
+ final start = DateTime.now();
+ FakeAsync().run((async) {
+ expect(clock.now(), _closeToTime(start));
+ async.elapse(elapseBy);
+ expect(clock.now(), _closeToTime(start.add(elapseBy)));
+ });
+ });
+
+ test('the value of clock.now()', () {
+ final start = DateTime(1990, 8, 11);
+ withClock(Clock.fixed(start), () {
+ FakeAsync().run((async) {
+ expect(clock.now(), start);
+ async.elapse(elapseBy);
+ expect(clock.now(), start.add(elapseBy));
+ });
+ });
+ });
+
+ test('an explicit value', () {
+ final start = DateTime(1990, 8, 11);
+ FakeAsync(initialTime: start).run((async) {
+ expect(clock.now(), start);
+ async.elapse(elapseBy);
+ expect(clock.now(), start.add(elapseBy));
+ });
+ });
+ });
+ });
+}
+
+/// Returns a matcher that asserts that a [DateTime] is within 100ms of
+/// [expected].
+Matcher _closeToTime(DateTime expected) => predicate(
+ (actual) =>
+ expected.difference(actual as DateTime).inMilliseconds.abs() < 100,
+ 'is close to $expected');
diff --git a/pkgs/matcher/.gitignore b/pkgs/matcher/.gitignore
new file mode 100644
index 0000000..ab3cb76
--- /dev/null
+++ b/pkgs/matcher/.gitignore
@@ -0,0 +1,16 @@
+# Don’t commit the following directories created by pub.
+.buildlog
+.dart_tool/
+.pub/
+build/
+packages
+.packages
+
+# Or the files created by dart2js.
+*.dart.js
+*.js_
+*.js.deps
+*.js.map
+
+# Include when developing application packages.
+pubspec.lock
diff --git a/pkgs/matcher/CHANGELOG.md b/pkgs/matcher/CHANGELOG.md
new file mode 100644
index 0000000..0522c4c
--- /dev/null
+++ b/pkgs/matcher/CHANGELOG.md
@@ -0,0 +1,289 @@
+## 0.12.18-wip
+
+* Remove some dynamic invocations.
+
+## 0.12.17
+
+* Require Dart 3.4
+* Move to `dart-lang/test` monorepo.
+
+## 0.12.16+1
+
+* Require Dart 3.0
+* Support latest version of `package:test_api`.
+
+## 0.12.16
+
+* Expand bounds on `test_api` dependency to allow the next breaking release
+ which will remove the cyclic dependency on this package.
+
+## 0.12.15
+
+* Add `package:matcher/expect.dart` library. Copies the implementation of
+ `expect` and the asynchronous matchers from `package:test`.
+
+## 0.12.14
+
+* Add `containsOnce` matcher.
+* Deprecate `isCyclicInitializationError` and `NullThrownError`. These errors
+ will be removed from the SDK. Update them to catch more general errors.
+
+## 0.12.13
+
+* Require Dart 2.17 or greater.
+* Make `isCastError` no longer depend on the deprecated `CastError` type.
+* Annotate `TypeMatcher.having` with `useResult`.
+
+## 0.12.12
+
+* Add a best practices section to readme.
+* Populate the pubspec `repository` field.
+
+## 0.12.11
+
+* Change many argument types from `dynamic` to `Object?`.
+* Fix `stringContainsInOrder` to account for repetitions and empty strings.
+ * **Note**: This may break some existing tests, as the behavior does change.
+
+## 0.12.10
+
+* Stable release for null safety.
+
+## 0.12.10-nullsafety.3
+
+* Update SDK constraints to `>=2.12.0-0 <3.0.0` based on beta release
+ guidelines.
+
+## 0.12.10-nullsafety.2
+
+- Allow prerelease versions of the 2.12 sdk.
+
+## 0.12.10-nullsafety.1
+
+- Allow 2.10 stable and 2.11.0 dev SDK versions.
+
+## 0.12.10-nullsafety
+
+- Migrate to NNBD.
+ - Apis have been updated to express intent of the existing code and how it
+ handled nulls.
+
+## 0.12.9
+
+- Improve mismatch descriptions for deep matches. Previously, if the user tried
+ to do a deep match where the expectation included a complex matcher (such as a
+ "having" matcher), the failure message would just say "failed to match ...";
+ it wouldn't call on the expectation's matcher to explain why the match failed.
+
+## 0.12.8
+
+- Add a mismatch description to `TypeMatcher`.
+
+## 0.12.7
+
+- Deprecate the `mirror_matchers.dart` library.
+
+## 0.12.6
+
+- Update minimum Dart SDK to `2.2.0`.
+- Consistently point to `isA` as a replacement for `instanceOf`.
+- Pretty print with private type names.
+
+## 0.12.5
+
+- Add `isA()` to create `TypeMatcher` instances in a more fluent way.
+- **Potentially breaking bug fix**. Ordering matchers no longer treat objects
+ with a partial ordering (such as NaN for double values) as if they had a
+ complete ordering. For instance `greaterThan` now compares with the `>`
+ operator rather not `<` and not `=`. This could cause tests which relied on
+ this bug to start failing.
+
+## 0.12.4
+
+- Add isCastError.
+
+## 0.12.3+1
+
+- Set max SDK version to <3.0.0, and adjusted other dependencies.
+
+## 0.12.3
+
+- Many improvements to `TypeMatcher`
+ - Can now be used directly as `const TypeMatcher<MyType>()`.
+ - Added a type parameter to specify the target `Type`.
+ - Made the `name` constructor parameter optional and marked it deprecated.
+ It's redundant to the type parameter.
+ - Migrated all `isType` matchers to `TypeMatcher`.
+ - Added a `having` function that allows chained validations of specific
+ features of the target type.
+
+ ```dart
+ /// Validates that the object is a [RangeError] with a message containing
+ /// the string 'details' and `start` and `end` properties that are `null`.
+ final _rangeMatcher = isRangeError
+ .having((e) => e.message, 'message', contains('details'))
+ .having((e) => e.start, 'start', isNull)
+ .having((e) => e.end, 'end', isNull);
+ ```
+
+- Deprecated the `isInstanceOf` class. Use `TypeMatcher` instead.
+
+- Improved the output of `Matcher` instances that fail due to type errors.
+
+## 0.12.2+1
+
+- Updated SDK version to 2.0.0-dev.17.0
+
+## 0.12.2
+
+* Fixed `unorderedMatches` in cases where the matchers may match more than one
+ element and order of the elements doesn't line up with the order of the
+ matchers.
+
+* Add containsAll matcher for Iterables. This Matcher checks that all
+ values/matchers in an expected iterable are satisfied by an element in the
+ value without allowing the same value to satisfy multiple matchers.
+
+## 0.12.1+4
+
+* Fixed SDK constraint to allow edge builds.
+
+## 0.12.1+3
+
+* Make `predicate` and `pairwiseCompare` generic methods to allow typed
+ functions to be passed to them as arguments.
+
+* Make internal implementations take better advantage of type promotion to avoid
+ dynamic call overhead.
+
+## 0.12.1+2
+
+* Fixed small documentation issues.
+
+* Fixed small issue in `StringEqualsMatcher`.
+
+* Update to support future Dart language changes.
+
+## 0.12.1+1
+
+* Produce a better error message when a `CustomMatcher`'s feature throws.
+
+## 0.12.1
+
+* Add containsAllInOrder matcher for Iterables
+
+## 0.12.0+2
+
+* Fix all strong-mode warnings.
+
+## 0.12.0+1
+
+* Fix test files to use `test` instead of `unittest` pkg.
+
+## 0.12.0
+
+* Moved a number of members to the
+ [`unittest`](https://pub.dev/packages/unittest) package.
+ * `TestFailure`, `ErrorFormatter`, `expect`, `fail`, and 'wrapAsync'.
+ * `completes`, `completion`, `throws`, and `throwsA` Matchers.
+ * The `Throws` class.
+ * All of the `throws...Error` Matchers.
+
+* Removed `FailureHandler`, `DefaultFailureHandler`,
+ `configureExpectFailureHandler`, and `getOrCreateExpectFailureHandler`.
+ Now that `expect` is in the `unittest` package, these are no longer needed.
+
+* Removed the `name` parameter for `isInstanceOf`. This was previously
+ deprecated, and is no longer necessary since all language implementations now
+ support converting the type parameter to a string directly.
+
+## 0.11.4+6
+
+* Fix a bug introduced in 0.11.4+5 in which operator matchers broke when taking
+ lists of matchers.
+
+## 0.11.4+5
+
+* Fix all strong-mode warnings.
+
+## 0.11.4+4
+
+* Deprecate the name parameter to `isInstanceOf`. All language implementations
+ now support converting the type parameter to a string directly.
+
+## 0.11.4+3
+
+* Fix the examples for `equalsIgnoringWhitespace`.
+
+## 0.11.4+2
+
+* Improve the formatting of strings that contain unprintable ASCII characters.
+
+## 0.11.4+1
+
+* Correctly match and print `String`s containing characters that must be
+ represented as escape sequences.
+
+## 0.11.4
+
+* Remove the type checks in the `isEmpty` and `isNotEmpty` matchers and simply
+ access the `isEmpty` respectively `isNotEmpty` fields. This allows them to
+ work with custom collections. See [Issue
+ 21792](https://code.google.com/p/dart/issues/detail?id=21792) and [Issue
+ 21562](https://code.google.com/p/dart/issues/detail?id=21562)
+
+## 0.11.3+1
+
+* Fix the `prints` matcher test on dart2js.
+
+## 0.11.3
+
+* Add a `prints` matcher that matches output a callback emits via `print`.
+
+## 0.11.2
+
+* Add an `isNotEmpty` matcher.
+
+## 0.11.1+1
+
+* Refactored libraries and tests.
+
+* Fixed spelling mistake.
+
+## 0.11.1
+
+* Added `isNaN` and `isNotNaN` matchers.
+
+## 0.11.0
+
+* Removed deprecated matchers.
+
+## 0.10.1+1
+
+* Get the tests passing when run on dart2js in minified mode.
+
+## 0.10.1
+
+* Compare sets order-independently when using `equals()`.
+
+## 0.10.0+3
+
+* Removed `@deprecated` annotation on matchers due to
+[Issue 19173](https://code.google.com/p/dart/issues/detail?id=19173)
+
+## 0.10.0+2
+
+* Added types to a number of constants.
+
+## 0.10.0+1
+
+* Matchers related to bad language use have been removed. These represent code
+structure that should rarely or never be validated in tests.
+ * `isAbstractClassInstantiationError`
+ * `throwsAbstractClassInstantiationError`
+ * `isFallThroughError`
+ * `throwsFallThroughError`
+
+* Added types to a number of method arguments.
+
+* The structure of the library and test code has been updated.
diff --git a/pkgs/matcher/LICENSE b/pkgs/matcher/LICENSE
new file mode 100644
index 0000000..000cd7b
--- /dev/null
+++ b/pkgs/matcher/LICENSE
@@ -0,0 +1,27 @@
+Copyright 2014, the Dart project authors.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+ * Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ * Redistributions in binary form must reproduce the above
+ copyright notice, this list of conditions and the following
+ disclaimer in the documentation and/or other materials provided
+ with the distribution.
+ * Neither the name of Google LLC nor the names of its
+ contributors may be used to endorse or promote products derived
+ from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
diff --git a/pkgs/matcher/README.md b/pkgs/matcher/README.md
new file mode 100644
index 0000000..efcae13
--- /dev/null
+++ b/pkgs/matcher/README.md
@@ -0,0 +1,265 @@
+[](https://pub.dev/packages/matcher)
+[](https://pub.dev/packages/matcher/publisher)
+
+Support for specifying test expectations, such as for unit tests.
+
+The matcher library provides a third-generation assertion mechanism, drawing
+inspiration from [Hamcrest](https://code.google.com/p/hamcrest/).
+
+For more information on testing, see
+[Unit Testing with Dart](https://github.com/dart-lang/test/blob/master/pkgs/test/README.md#writing-tests).
+
+## Using matcher
+
+Expectations start with a call to [`expect()`] or [`expectAsync()`].
+
+[`expect()`]: https://pub.dev/documentation/matcher/latest/expect/expect.html
+[`expectAsync()`]: https://pub.dev/documentation/matcher/latest/expect/expectAsync.html
+
+Any matchers package can be used with `expect()` to do
+complex validations:
+
+[`matcher`]: https://pub.dev/documentation/matcher/latest/matcher/matcher-library.html
+
+```dart
+import 'package:test/test.dart';
+
+void main() {
+ test('.split() splits the string on the delimiter', () {
+ expect('foo,bar,baz', allOf([
+ contains('foo'),
+ isNot(startsWith('bar')),
+ endsWith('baz')
+ ]));
+ });
+}
+```
+
+If a non-matcher value is passed, it will be wrapped with [`equals()`].
+
+[`equals()`]: https://pub.dev/documentation/matcher/latest/expect/equals.html
+
+## Exception matchers
+
+You can also test exceptions with the [`throwsA()`] function or a matcher such
+as [`throwsFormatException`]:
+
+[`throwsA()`]: https://pub.dev/documentation/matcher/latest/expect/throwsA.html
+[`throwsFormatException`]: https://pub.dev/documentation/matcher/latest/expect/throwsFormatException-constant.html
+
+```dart
+import 'package:test/test.dart';
+
+void main() {
+ test('.parse() fails on invalid input', () {
+ expect(() => int.parse('X'), throwsFormatException);
+ });
+}
+```
+
+### Future Matchers
+
+There are a number of useful functions and matchers for more advanced
+asynchrony. The [`completion()`] matcher can be used to test `Futures`; it
+ensures that the test doesn't finish until the `Future` completes, and runs a
+matcher against that `Future`'s value.
+
+[`completion()`]: https://pub.dev/documentation/matcher/latest/expect/completion.html
+
+```dart
+import 'dart:async';
+
+import 'package:test/test.dart';
+
+void main() {
+ test('Future.value() returns the value', () {
+ expect(Future.value(10), completion(equals(10)));
+ });
+}
+```
+
+The [`throwsA()`] matcher and the various [`throwsExceptionType`] matchers work
+with both synchronous callbacks and asynchronous `Future`s. They ensure that a
+particular type of exception is thrown:
+
+[`throwsExceptionType`]: https://pub.dev/documentation/matcher/latest/expect/throwsException-constant.html
+
+```dart
+import 'dart:async';
+
+import 'package:test/test.dart';
+
+void main() {
+ test('Future.error() throws the error', () {
+ expect(Future.error('oh no'), throwsA(equals('oh no')));
+ expect(Future.error(StateError('bad state')), throwsStateError);
+ });
+}
+```
+
+The [`expectAsync()`] function wraps another function and has two jobs. First,
+it asserts that the wrapped function is called a certain number of times, and
+will cause the test to fail if it's called too often; second, it keeps the test
+from finishing until the function is called the requisite number of times.
+
+```dart
+import 'dart:async';
+
+import 'package:test/test.dart';
+
+void main() {
+ test('Stream.fromIterable() emits the values in the iterable', () {
+ var stream = Stream.fromIterable([1, 2, 3]);
+
+ stream.listen(expectAsync1((number) {
+ expect(number, inInclusiveRange(1, 3));
+ }, count: 3));
+ });
+}
+```
+
+[`expectAsync()`]: https://pub.dev/documentation/matcher/latest/expect/expectAsync.html
+
+### Stream Matchers
+
+The `test` package provides a suite of powerful matchers for dealing with
+[asynchronous streams][Stream]. They're expressive and composable, and make it
+easy to write complex expectations about the values emitted by a stream. For
+example:
+
+[Stream]: https://api.dart.dev/stable/dart-async/Stream-class.html
+
+```dart
+import 'dart:async';
+
+import 'package:test/test.dart';
+
+void main() {
+ test('process emits status messages', () {
+ // Dummy data to mimic something that might be emitted by a process.
+ var stdoutLines = Stream.fromIterable([
+ 'Ready.',
+ 'Loading took 150ms.',
+ 'Succeeded!'
+ ]);
+
+ expect(stdoutLines, emitsInOrder([
+ // Values match individual events.
+ 'Ready.',
+
+ // Matchers also run against individual events.
+ startsWith('Loading took'),
+
+ // Stream matchers can be nested. This asserts that one of two events are
+ // emitted after the "Loading took" line.
+ emitsAnyOf(['Succeeded!', 'Failed!']),
+
+ // By default, more events are allowed after the matcher finishes
+ // matching. This asserts instead that the stream emits a done event and
+ // nothing else.
+ emitsDone
+ ]));
+ });
+}
+```
+
+A stream matcher can also match the [`async`] package's [`StreamQueue`] class,
+which allows events to be requested from a stream rather than pushed to the
+consumer. The matcher will consume the matched events, but leave the rest of the
+queue alone so that it can still be used by the test, unlike a normal `Stream`
+which can only have one subscriber. For example:
+
+[`async`]: https://pub.dev/packages/async
+[`StreamQueue`]: https://pub.dev/documentation/async/latest/async/StreamQueue-class.html
+
+```dart
+import 'dart:async';
+
+import 'package:async/async.dart';
+import 'package:test/test.dart';
+
+void main() {
+ test('process emits a WebSocket URL', () async {
+ // Wrap the Stream in a StreamQueue so that we can request events.
+ var stdout = StreamQueue(Stream.fromIterable([
+ 'WebSocket URL:',
+ 'ws://localhost:1234/',
+ 'Waiting for connection...'
+ ]));
+
+ // Ignore lines from the process until it's about to emit the URL.
+ await expectLater(stdout, emitsThrough('WebSocket URL:'));
+
+ // Parse the next line as a URL.
+ var url = Uri.parse(await stdout.next);
+ expect(url.host, equals('localhost'));
+
+ // You can match against the same StreamQueue multiple times.
+ await expectLater(stdout, emits('Waiting for connection...'));
+ });
+}
+```
+
+The following built-in stream matchers are available:
+
+* [`emits()`] matches a single data event.
+* [`emitsError()`] matches a single error event.
+* [`emitsDone`] matches a single done event.
+* [`mayEmit()`] consumes events if they match an inner matcher, without
+ requiring them to match.
+* [`mayEmitMultiple()`] works like `mayEmit()`, but it matches events against
+ the matcher as many times as possible.
+* [`emitsAnyOf()`] consumes events matching one (or more) of several possible
+ matchers.
+* [`emitsInOrder()`] consumes events matching multiple matchers in a row.
+* [`emitsInAnyOrder()`] works like `emitsInOrder()`, but it allows the
+ matchers to match in any order.
+* [`neverEmits()`] matches a stream that finishes *without* matching an inner
+ matcher.
+
+You can also define your own custom stream matchers with [`StreamMatcher()`].
+
+[`emits()`]: https://pub.dev/documentation/matcher/latest/expect/emits.html
+[`emitsError()`]: https://pub.dev/documentation/matcher/latest/expect/emitsError.html
+[`emitsDone`]: https://pub.dev/documentation/matcher/latest/expect/emitsDone.html
+[`mayEmit()`]: https://pub.dev/documentation/matcher/latest/expect/mayEmit.html
+[`mayEmitMultiple()`]: https://pub.dev/documentation/matcher/latest/expect/mayEmitMultiple.html
+[`emitsAnyOf()`]: https://pub.dev/documentation/matcher/latest/expect/emitsAnyOf.html
+[`emitsInOrder()`]: https://pub.dev/documentation/matcher/latest/expect/emitsInOrder.html
+[`emitsInAnyOrder()`]: https://pub.dev/documentation/matcher/latest/expect/emitsInAnyOrder.html
+[`neverEmits()`]: https://pub.dev/documentation/matcher/latest/expect/neverEmits.html
+[`StreamMatcher()`]: https://pub.dev/documentation/matcher/latest/expect/StreamMatcher-class.html
+
+## Best Practices
+
+### Prefer semantically meaningful matchers to comparing derived values
+
+Matchers which have knowledge of the semantics that are tested are able to emit
+more meaningful messages which don't require reading test source to understand
+why the test failed. For instance compare the failures between
+`expect(someList.length, 1)`, and `expect(someList, hasLength(1))`:
+
+```
+// expect(someList.length, 1);
+ Expected: <1>
+ Actual: <2>
+```
+
+```
+// expect(someList, hasLength(1));
+ Expected: an object with length of <1>
+ Actual: ['expected value', 'unexpected value']
+ Which: has length of <2>
+
+```
+
+### Prefer TypeMatcher to predicate if the match can fail in multiple ways
+
+The `predicate` utility is a convenient shortcut for testing an arbitrary
+(synchronous) property of a value, but it discards context and failures are
+opaque. Different failure modes cannot be distinguished in the output which is
+determined by a single "description" argument. Using `isA<SomeType>()` and the
+`TypeMatcher.having` API to extract and test derived properties in a structured
+way brings the context of that structure through to failure messages, so
+failures for different reasons will have distinguishable and actionable failure
+messages.
diff --git a/pkgs/matcher/analysis_options.yaml b/pkgs/matcher/analysis_options.yaml
new file mode 100644
index 0000000..d183f7b
--- /dev/null
+++ b/pkgs/matcher/analysis_options.yaml
@@ -0,0 +1,30 @@
+include: package:lints/recommended.yaml
+
+linter:
+ rules:
+ - always_declare_return_types
+ - avoid_dynamic_calls
+ - avoid_private_typedef_functions
+ - avoid_unused_constructor_parameters
+ - cancel_subscriptions
+ - comment_references
+ - directives_ordering
+ - lines_longer_than_80_chars
+ - literal_only_boolean_expressions
+ - missing_whitespace_between_adjacent_strings
+ - no_adjacent_strings_in_list
+ - no_runtimeType_toString
+ - omit_local_variable_types
+ - only_throw_errors
+ - prefer_const_constructors
+ - prefer_relative_imports
+ - prefer_single_quotes
+ - test_types_in_equals
+ - throw_in_finally
+ - type_annotate_public_apis
+ - unawaited_futures
+ - unnecessary_await_in_return
+ - unnecessary_lambdas
+ - unnecessary_parenthesis
+ - unnecessary_statements
+ - use_super_parameters
diff --git a/pkgs/matcher/lib/expect.dart b/pkgs/matcher/lib/expect.dart
new file mode 100644
index 0000000..c842d30
--- /dev/null
+++ b/pkgs/matcher/lib/expect.dart
@@ -0,0 +1,64 @@
+// Copyright (c) 2021, 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.
+
+// ignore_for_file: deprecated_member_use_from_same_package
+
+export 'matcher.dart';
+
+export 'src/expect/expect.dart' show ErrorFormatter, expect, expectLater, fail;
+export 'src/expect/expect_async.dart'
+ show
+ Func0,
+ Func1,
+ Func2,
+ Func3,
+ Func4,
+ Func5,
+ Func6,
+ expectAsync,
+ expectAsync0,
+ expectAsync1,
+ expectAsync2,
+ expectAsync3,
+ expectAsync4,
+ expectAsync5,
+ expectAsync6,
+ expectAsyncUntil0,
+ expectAsyncUntil1,
+ expectAsyncUntil2,
+ expectAsyncUntil3,
+ expectAsyncUntil4,
+ expectAsyncUntil5,
+ expectAsyncUntil6;
+export 'src/expect/future_matchers.dart'
+ show completes, completion, doesNotComplete;
+export 'src/expect/never_called.dart' show neverCalled;
+export 'src/expect/prints_matcher.dart' show prints;
+export 'src/expect/stream_matcher.dart' show StreamMatcher;
+export 'src/expect/stream_matchers.dart'
+ show
+ emitsDone,
+ emits,
+ emitsError,
+ mayEmit,
+ emitsAnyOf,
+ emitsInOrder,
+ emitsInAnyOrder,
+ emitsThrough,
+ mayEmitMultiple,
+ neverEmits;
+export 'src/expect/throws_matcher.dart' show Throws, throws, throwsA;
+export 'src/expect/throws_matchers.dart'
+ show
+ throwsArgumentError,
+ throwsConcurrentModificationError,
+ throwsCyclicInitializationError,
+ throwsException,
+ throwsFormatException,
+ throwsNoSuchMethodError,
+ throwsNullThrownError,
+ throwsRangeError,
+ throwsStateError,
+ throwsUnimplementedError,
+ throwsUnsupportedError;
diff --git a/pkgs/matcher/lib/matcher.dart b/pkgs/matcher/lib/matcher.dart
new file mode 100644
index 0000000..236d6f4
--- /dev/null
+++ b/pkgs/matcher/lib/matcher.dart
@@ -0,0 +1,21 @@
+// Copyright (c) 2014, 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.
+
+/// Support for specifying test expectations, such as for unit tests.
+library;
+
+export 'src/core_matchers.dart';
+export 'src/custom_matcher.dart';
+export 'src/description.dart';
+export 'src/equals_matcher.dart';
+export 'src/error_matchers.dart';
+export 'src/interfaces.dart';
+export 'src/iterable_matchers.dart';
+export 'src/map_matchers.dart';
+export 'src/numeric_matchers.dart';
+export 'src/operator_matchers.dart';
+export 'src/order_matchers.dart';
+export 'src/string_matchers.dart';
+export 'src/type_matcher.dart';
+export 'src/util.dart';
diff --git a/pkgs/matcher/lib/mirror_matchers.dart b/pkgs/matcher/lib/mirror_matchers.dart
new file mode 100644
index 0000000..5b2f4b6
--- /dev/null
+++ b/pkgs/matcher/lib/mirror_matchers.dart
@@ -0,0 +1,85 @@
+// Copyright (c) 2014, 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.
+
+@Deprecated('Check properties on known types')
+library;
+
+/// The mirror matchers library provides some additional matchers that
+/// make use of `dart:mirrors`.
+import 'dart:mirrors';
+
+import 'matcher.dart';
+
+/// Returns a matcher that checks if a class instance has a property
+/// with name [name], and optionally, if that property in turn satisfies
+/// a [matcher].
+Matcher hasProperty(String name, [Object? matcher]) =>
+ _HasProperty(name, matcher == null ? null : wrapMatcher(matcher));
+
+class _HasProperty extends Matcher {
+ final String _name;
+ final Matcher? _matcher;
+
+ const _HasProperty(this._name, [this._matcher]);
+
+ @override
+ bool matches(Object? item, Map matchState) {
+ var mirror = reflect(item);
+ var classMirror = mirror.type;
+ var symbol = Symbol(_name);
+ var candidate = classMirror.declarations[symbol];
+ if (candidate == null) {
+ addStateInfo(matchState, {'reason': 'has no property named "$_name"'});
+ return false;
+ }
+ var isInstanceField = candidate is VariableMirror && !candidate.isStatic;
+ var isInstanceGetter =
+ candidate is MethodMirror && candidate.isGetter && !candidate.isStatic;
+ if (!(isInstanceField || isInstanceGetter)) {
+ addStateInfo(matchState, {
+ 'reason':
+ 'has a member named "$_name", but it is not an instance property'
+ });
+ return false;
+ }
+ var matcher = _matcher;
+ if (matcher == null) return true;
+ var result = mirror.getField(symbol);
+ var resultMatches = matcher.matches(result.reflectee, matchState);
+ if (!resultMatches) {
+ addStateInfo(matchState, {'value': result.reflectee});
+ }
+ return resultMatches;
+ }
+
+ @override
+ Description describe(Description description) {
+ description.add('has property "$_name"');
+ if (_matcher != null) {
+ description.add(' which matches ').addDescriptionOf(_matcher);
+ }
+ return description;
+ }
+
+ @override
+ Description describeMismatch(Object? item, Description mismatchDescription,
+ Map matchState, bool verbose) {
+ var reason = matchState['reason'];
+ if (reason != null) {
+ mismatchDescription.add(reason as String);
+ } else {
+ mismatchDescription
+ .add('has property "$_name" with value ')
+ .addDescriptionOf(matchState['value']);
+ var innerDescription = StringDescription();
+ matchState['state'] ??= {};
+ _matcher?.describeMismatch(matchState['value'], innerDescription,
+ matchState['state'] as Map, verbose);
+ if (innerDescription.length > 0) {
+ mismatchDescription.add(' which ').add(innerDescription.toString());
+ }
+ }
+ return mismatchDescription;
+ }
+}
diff --git a/pkgs/matcher/lib/src/core_matchers.dart b/pkgs/matcher/lib/src/core_matchers.dart
new file mode 100644
index 0000000..afb835b
--- /dev/null
+++ b/pkgs/matcher/lib/src/core_matchers.dart
@@ -0,0 +1,327 @@
+// Copyright (c) 2012, 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 'feature_matcher.dart';
+import 'interfaces.dart';
+import 'type_matcher.dart';
+import 'util.dart';
+
+/// Returns a matcher that matches the isEmpty property.
+const Matcher isEmpty = _Empty();
+
+class _Empty extends Matcher {
+ const _Empty();
+
+ @override
+ bool matches(Object? item, Map matchState) => (item as dynamic).isEmpty;
+
+ @override
+ Description describe(Description description) => description.add('empty');
+}
+
+/// Returns a matcher that matches the isNotEmpty property.
+const Matcher isNotEmpty = _NotEmpty();
+
+class _NotEmpty extends Matcher {
+ const _NotEmpty();
+
+ @override
+ bool matches(Object? item, Map matchState) => (item as dynamic).isNotEmpty;
+
+ @override
+ Description describe(Description description) => description.add('non-empty');
+}
+
+/// A matcher that matches any null value.
+const Matcher isNull = _IsNull();
+
+/// A matcher that matches any non-null value.
+const Matcher isNotNull = _IsNotNull();
+
+class _IsNull extends Matcher {
+ const _IsNull();
+ @override
+ bool matches(Object? item, Map matchState) => item == null;
+ @override
+ Description describe(Description description) => description.add('null');
+}
+
+class _IsNotNull extends Matcher {
+ const _IsNotNull();
+ @override
+ bool matches(Object? item, Map matchState) => item != null;
+ @override
+ Description describe(Description description) => description.add('not null');
+}
+
+/// A matcher that matches the Boolean value true.
+const Matcher isTrue = _IsTrue();
+
+/// A matcher that matches anything except the Boolean value true.
+const Matcher isFalse = _IsFalse();
+
+class _IsTrue extends Matcher {
+ const _IsTrue();
+ @override
+ bool matches(Object? item, Map matchState) => item == true;
+ @override
+ Description describe(Description description) => description.add('true');
+}
+
+class _IsFalse extends Matcher {
+ const _IsFalse();
+ @override
+ bool matches(Object? item, Map matchState) => item == false;
+ @override
+ Description describe(Description description) => description.add('false');
+}
+
+/// A matcher that matches the numeric value NaN.
+const Matcher isNaN = _IsNaN();
+
+/// A matcher that matches any non-NaN value.
+const Matcher isNotNaN = _IsNotNaN();
+
+class _IsNaN extends FeatureMatcher<num> {
+ const _IsNaN();
+ @override
+ bool typedMatches(num item, Map matchState) =>
+ double.nan.compareTo(item) == 0;
+ @override
+ Description describe(Description description) => description.add('NaN');
+}
+
+class _IsNotNaN extends FeatureMatcher<num> {
+ const _IsNotNaN();
+ @override
+ bool typedMatches(num item, Map matchState) =>
+ double.nan.compareTo(item) != 0;
+ @override
+ Description describe(Description description) => description.add('not NaN');
+}
+
+/// Returns a matches that matches if the value is the same instance
+/// as [expected], using [identical].
+Matcher same(Object? expected) => _IsSameAs(expected);
+
+class _IsSameAs extends Matcher {
+ final Object? _expected;
+ const _IsSameAs(this._expected);
+ @override
+ bool matches(Object? item, Map matchState) => identical(item, _expected);
+ // If all types were hashable we could show a hash here.
+ @override
+ Description describe(Description description) =>
+ description.add('same instance as ').addDescriptionOf(_expected);
+}
+
+/// A matcher that matches any value.
+const Matcher anything = _IsAnything();
+
+class _IsAnything extends Matcher {
+ const _IsAnything();
+ @override
+ bool matches(Object? item, Map matchState) => true;
+ @override
+ Description describe(Description description) => description.add('anything');
+}
+
+/// **DEPRECATED** Use [isA] instead.
+///
+/// A matcher that matches if an object is an instance of [T] (or a subtype).
+@Deprecated('Use `isA<MyType>()` instead.')
+// ignore: camel_case_types
+class isInstanceOf<T> extends TypeMatcher<T> {
+ const isInstanceOf();
+}
+
+/// A matcher that matches a function call against no exception.
+///
+/// The function will be called once. Any exceptions will be silently swallowed.
+/// The value passed to expect() should be a reference to the function.
+/// Note that the function cannot take arguments; to handle this
+/// a wrapper will have to be created.
+const Matcher returnsNormally = _ReturnsNormally();
+
+class _ReturnsNormally extends FeatureMatcher<Function> {
+ const _ReturnsNormally();
+
+ @override
+ bool typedMatches(Function f, Map matchState) {
+ try {
+ // ignore: unnecessary_cast
+ (f as Function)();
+ return true;
+ } catch (e, s) {
+ addStateInfo(matchState, {'exception': e, 'stack': s});
+ return false;
+ }
+ }
+
+ @override
+ Description describe(Description description) =>
+ description.add('return normally');
+
+ @override
+ Description describeTypedMismatch(Function item,
+ Description mismatchDescription, Map matchState, bool verbose) {
+ mismatchDescription.add('threw ').addDescriptionOf(matchState['exception']);
+ if (verbose) {
+ mismatchDescription.add(' at ').add(matchState['stack'].toString());
+ }
+ return mismatchDescription;
+ }
+}
+
+/// A matcher for [Map].
+const isMap = TypeMatcher<Map>();
+
+/// A matcher for [List].
+const isList = TypeMatcher<List>();
+
+/// Returns a matcher that matches if an object has a length property
+/// that matches [matcher].
+Matcher hasLength(Object? matcher) => _HasLength(wrapMatcher(matcher));
+
+class _HasLength extends Matcher {
+ final Matcher _matcher;
+ const _HasLength(this._matcher);
+
+ @override
+ bool matches(Object? item, Map matchState) {
+ try {
+ final length = (item as dynamic).length;
+ return _matcher.matches(length, matchState);
+ } catch (e) {
+ return false;
+ }
+ }
+
+ @override
+ Description describe(Description description) =>
+ description.add('an object with length of ').addDescriptionOf(_matcher);
+
+ @override
+ Description describeMismatch(Object? item, Description mismatchDescription,
+ Map matchState, bool verbose) {
+ try {
+ final length = (item as dynamic).length;
+ return mismatchDescription.add('has length of ').addDescriptionOf(length);
+ } catch (e) {
+ return mismatchDescription.add('has no length property');
+ }
+ }
+}
+
+/// Returns a matcher that matches if the match argument contains the expected
+/// value.
+///
+/// For [String]s this means substring matching;
+/// for [Map]s it means the map has the key, and for [Iterable]s
+/// it means the iterable has a matching element. In the case of iterables,
+/// [expected] can itself be a matcher.
+Matcher contains(Object? expected) => _Contains(expected);
+
+class _Contains extends Matcher {
+ final Object? _expected;
+
+ const _Contains(this._expected);
+
+ @override
+ bool matches(Object? item, Map matchState) {
+ var expected = _expected;
+ if (item is String) {
+ return expected is Pattern && item.contains(expected);
+ } else if (item is Iterable) {
+ if (expected is Matcher) {
+ return item.any((e) => expected.matches(e, matchState));
+ } else {
+ return item.contains(_expected);
+ }
+ } else if (item is Map) {
+ return item.containsKey(_expected);
+ }
+ return false;
+ }
+
+ @override
+ Description describe(Description description) =>
+ description.add('contains ').addDescriptionOf(_expected);
+
+ @override
+ Description describeMismatch(Object? item, Description mismatchDescription,
+ Map matchState, bool verbose) {
+ if (item is String || item is Iterable || item is Map) {
+ super.describeMismatch(item, mismatchDescription, matchState, verbose);
+ mismatchDescription.add('does not contain ').addDescriptionOf(_expected);
+ return mismatchDescription;
+ } else {
+ return mismatchDescription.add('is not a string, map or iterable');
+ }
+ }
+}
+
+/// Returns a matcher that matches if the match argument is in
+/// the expected value. This is the converse of [contains].
+Matcher isIn(Object? expected) {
+ if (expected is Iterable) {
+ return _In(expected, expected.contains);
+ } else if (expected is String) {
+ return _In<Pattern>(expected, expected.contains);
+ } else if (expected is Map) {
+ return _In(expected, expected.containsKey);
+ }
+
+ throw ArgumentError.value(
+ expected, 'expected', 'Only Iterable, Map, and String are supported.');
+}
+
+class _In<T> extends FeatureMatcher<T> {
+ final Object _source;
+ final bool Function(T) _containsFunction;
+
+ const _In(this._source, this._containsFunction);
+
+ @override
+ bool typedMatches(T item, Map matchState) => _containsFunction(item);
+
+ @override
+ Description describe(Description description) =>
+ description.add('is in ').addDescriptionOf(_source);
+}
+
+/// Returns a matcher that uses an arbitrary function that returns whether the
+/// value is considered a match.
+///
+/// For example:
+///
+/// expect(actual, predicate<num>((v) => (v % 2) == 0, 'is even'));
+///
+/// Use this method when a value is checked for one conceptual property
+/// described by [description].
+///
+/// If the value can be rejected for more than one reason prefer using [isA] and
+/// the [TypeMatcher.having] API to build up a matcher with output that can
+/// distinquish between them.
+///
+/// Using an explicit generict argument allows a passed function literal to have
+/// an inferred argument type of [T], and values of the wrong type will be
+/// rejected with an informative message.
+Matcher predicate<T>(bool Function(T) f,
+ [String description = 'satisfies function']) =>
+ _Predicate(f, description);
+
+class _Predicate<T> extends FeatureMatcher<T> {
+ final bool Function(T) _matcher;
+ final String _description;
+
+ _Predicate(this._matcher, this._description);
+
+ @override
+ bool typedMatches(T item, Map matchState) => _matcher(item);
+
+ @override
+ Description describe(Description description) =>
+ description.add(_description);
+}
diff --git a/pkgs/matcher/lib/src/custom_matcher.dart b/pkgs/matcher/lib/src/custom_matcher.dart
new file mode 100644
index 0000000..b0f2d6b
--- /dev/null
+++ b/pkgs/matcher/lib/src/custom_matcher.dart
@@ -0,0 +1,100 @@
+// Copyright (c) 2012, 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 'package:stack_trace/stack_trace.dart';
+
+import 'description.dart';
+import 'interfaces.dart';
+import 'util.dart';
+
+/// A base class for [Matcher] instances that match based on some feature of the
+/// value under test.
+///
+/// Derived classes should call the base constructor with a feature name and
+/// description, and an instance matcher, and should implement the
+/// [featureValueOf] abstract method.
+///
+/// The feature description will typically describe the item and the feature,
+/// while the feature name will just name the feature. For example, we may
+/// have a Widget class where each Widget has a price; we could make a
+/// [CustomMatcher] that can make assertions about prices with:
+///
+/// ```dart
+/// class HasPrice extends CustomMatcher {
+/// HasPrice(matcher) : super("Widget with price that is", "price", matcher);
+/// featureValueOf(actual) => (actual as Widget).price;
+/// }
+/// ```
+///
+/// and then use this for example like:
+///
+/// ```dart
+/// expect(inventoryItem, HasPrice(greaterThan(0)));
+/// ```
+class CustomMatcher extends Matcher {
+ final String _featureDescription;
+ final String _featureName;
+ final Matcher _matcher;
+
+ CustomMatcher(
+ this._featureDescription, this._featureName, Object? valueOrMatcher)
+ : _matcher = wrapMatcher(valueOrMatcher);
+
+ /// Override this to extract the interesting feature.
+ Object? featureValueOf(dynamic actual) => actual;
+
+ @override
+ bool matches(Object? item, Map matchState) {
+ try {
+ var f = featureValueOf(item);
+ if (_matcher.matches(f, matchState)) return true;
+ addStateInfo(matchState, {'custom.feature': f});
+ } catch (exception, stack) {
+ addStateInfo(matchState, {
+ 'custom.exception': exception.toString(),
+ 'custom.stack': Chain.forTrace(stack)
+ .foldFrames(
+ (frame) =>
+ frame.package == 'test' ||
+ frame.package == 'stream_channel' ||
+ frame.package == 'matcher',
+ terse: true)
+ .toString()
+ });
+ }
+ return false;
+ }
+
+ @override
+ Description describe(Description description) =>
+ description.add(_featureDescription).add(' ').addDescriptionOf(_matcher);
+
+ @override
+ Description describeMismatch(Object? item, Description mismatchDescription,
+ Map matchState, bool verbose) {
+ if (matchState['custom.exception'] != null) {
+ mismatchDescription
+ .add('threw ')
+ .addDescriptionOf(matchState['custom.exception'])
+ .add('\n')
+ .add(matchState['custom.stack'].toString());
+ return mismatchDescription;
+ }
+
+ mismatchDescription
+ .add('has ')
+ .add(_featureName)
+ .add(' with value ')
+ .addDescriptionOf(matchState['custom.feature']);
+ var innerDescription = StringDescription();
+
+ _matcher.describeMismatch(matchState['custom.feature'], innerDescription,
+ matchState['state'] as Map, verbose);
+
+ if (innerDescription.length > 0) {
+ mismatchDescription.add(' which ').add(innerDescription.toString());
+ }
+ return mismatchDescription;
+ }
+}
diff --git a/pkgs/matcher/lib/src/description.dart b/pkgs/matcher/lib/src/description.dart
new file mode 100644
index 0000000..090aada
--- /dev/null
+++ b/pkgs/matcher/lib/src/description.dart
@@ -0,0 +1,72 @@
+// Copyright (c) 2012, 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 'interfaces.dart';
+import 'pretty_print.dart';
+
+/// The default implementation of [Description]. This should rarely need
+/// substitution, although conceivably it is a place where other languages
+/// could be supported.
+class StringDescription implements Description {
+ final StringBuffer _out = StringBuffer();
+
+ /// Initialize the description with initial contents [init].
+ StringDescription([String init = '']) {
+ _out.write(init);
+ }
+
+ @override
+ int get length => _out.length;
+
+ /// Get the description as a string.
+ @override
+ String toString() => _out.toString();
+
+ /// Append [text] to the description.
+ @override
+ Description add(String text) {
+ _out.write(text);
+ return this;
+ }
+
+ /// Change the value of the description.
+ @override
+ Description replace(String text) {
+ _out.clear();
+ return add(text);
+ }
+
+ /// Appends a description of [value]. If it is an IMatcher use its
+ /// describe method; if it is a string use its literal value after
+ /// escaping any embedded control characters; otherwise use its
+ /// toString() value and wrap it in angular "quotes".
+ @override
+ Description addDescriptionOf(Object? value) {
+ if (value is Matcher) {
+ value.describe(this);
+ } else {
+ add(prettyPrint(value, maxLineLength: 80, maxItems: 25));
+ }
+ return this;
+ }
+
+ /// Append an [Iterable] [list] of objects to the description, using the
+ /// specified [separator] and framing the list with [start]
+ /// and [end].
+ @override
+ Description addAll(
+ String start, String separator, String end, Iterable list) {
+ var separate = false;
+ add(start);
+ for (var item in list) {
+ if (separate) {
+ add(separator);
+ }
+ addDescriptionOf(item);
+ separate = true;
+ }
+ add(end);
+ return this;
+ }
+}
diff --git a/pkgs/matcher/lib/src/equals_matcher.dart b/pkgs/matcher/lib/src/equals_matcher.dart
new file mode 100644
index 0000000..5c4f4c5
--- /dev/null
+++ b/pkgs/matcher/lib/src/equals_matcher.dart
@@ -0,0 +1,327 @@
+// Copyright (c) 2018, 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 'feature_matcher.dart';
+import 'interfaces.dart';
+import 'util.dart';
+
+/// Returns a matcher that matches if the value is structurally equal to
+/// [expected].
+///
+/// If [expected] is a [Matcher], then it matches using that. Otherwise it tests
+/// for equality using `==` on the expected value.
+///
+/// For [Iterable]s and [Map]s, this will recursively match the elements. To
+/// handle cyclic structures a recursion depth [limit] can be provided. The
+/// default limit is 100. [Set]s will be compared order-independently.
+Matcher equals(Object? expected, [int limit = 100]) => expected is String
+ ? _StringEqualsMatcher(expected)
+ : _DeepMatcher(expected, limit);
+
+typedef _RecursiveMatcher = _Mismatch? Function(Object?, Object?, String, int);
+
+/// A special equality matcher for strings.
+class _StringEqualsMatcher extends FeatureMatcher<String> {
+ final String _value;
+
+ _StringEqualsMatcher(this._value);
+
+ @override
+ bool typedMatches(String item, Map matchState) => _value == item;
+
+ @override
+ Description describe(Description description) =>
+ description.addDescriptionOf(_value);
+
+ @override
+ Description describeTypedMismatch(String item,
+ Description mismatchDescription, Map matchState, bool verbose) {
+ var buff = StringBuffer();
+ buff.write('is different.');
+ var escapedItem = escape(item);
+ var escapedValue = escape(_value);
+ var minLength = escapedItem.length < escapedValue.length
+ ? escapedItem.length
+ : escapedValue.length;
+ var start = 0;
+ for (; start < minLength; start++) {
+ if (escapedValue.codeUnitAt(start) != escapedItem.codeUnitAt(start)) {
+ break;
+ }
+ }
+ if (start == minLength) {
+ if (escapedValue.length < escapedItem.length) {
+ buff.write(' Both strings start the same, but the actual value also'
+ ' has the following trailing characters: ');
+ _writeTrailing(buff, escapedItem, escapedValue.length);
+ } else {
+ buff.write(' Both strings start the same, but the actual value is'
+ ' missing the following trailing characters: ');
+ _writeTrailing(buff, escapedValue, escapedItem.length);
+ }
+ } else {
+ buff.write('\nExpected: ');
+ _writeLeading(buff, escapedValue, start);
+ _writeTrailing(buff, escapedValue, start);
+ buff.write('\n Actual: ');
+ _writeLeading(buff, escapedItem, start);
+ _writeTrailing(buff, escapedItem, start);
+ buff.write('\n ');
+ for (var i = start > 10 ? 14 : start; i > 0; i--) {
+ buff.write(' ');
+ }
+ buff.write('^\n Differ at offset $start');
+ }
+
+ return mismatchDescription.add(buff.toString());
+ }
+
+ static void _writeLeading(StringBuffer buff, String s, int start) {
+ if (start > 10) {
+ buff.write('... ');
+ buff.write(s.substring(start - 10, start));
+ } else {
+ buff.write(s.substring(0, start));
+ }
+ }
+
+ static void _writeTrailing(StringBuffer buff, String s, int start) {
+ if (start + 10 > s.length) {
+ buff.write(s.substring(start));
+ } else {
+ buff.write(s.substring(start, start + 10));
+ buff.write(' ...');
+ }
+ }
+}
+
+class _DeepMatcher extends Matcher {
+ final Object? _expected;
+ final int _limit;
+
+ _DeepMatcher(this._expected, [int limit = 1000]) : _limit = limit;
+
+ _Mismatch? _compareIterables(Iterable expected, Object? actual,
+ _RecursiveMatcher matcher, int depth, String location) {
+ if (actual is Iterable) {
+ var expectedIterator = expected.iterator;
+ var actualIterator = actual.iterator;
+ for (var index = 0;; index++) {
+ // Advance in lockstep.
+ var expectedNext = expectedIterator.moveNext();
+ var actualNext = actualIterator.moveNext();
+
+ // If we reached the end of both, we succeeded.
+ if (!expectedNext && !actualNext) return null;
+
+ // Fail if their lengths are different.
+ var newLocation = '$location[$index]';
+ if (!expectedNext) {
+ return _Mismatch.simple(newLocation, actual, 'longer than expected');
+ }
+ if (!actualNext) {
+ return _Mismatch.simple(newLocation, actual, 'shorter than expected');
+ }
+
+ // Match the elements.
+ var rp = matcher(expectedIterator.current, actualIterator.current,
+ newLocation, depth);
+ if (rp != null) return rp;
+ }
+ } else {
+ return _Mismatch.simple(location, actual, 'is not Iterable');
+ }
+ }
+
+ _Mismatch? _compareSets(Set expected, Object? actual,
+ _RecursiveMatcher matcher, int depth, String location) {
+ if (actual is Iterable) {
+ var other = actual.toSet();
+
+ for (var expectedElement in expected) {
+ if (other.every((actualElement) =>
+ matcher(expectedElement, actualElement, location, depth) != null)) {
+ return _Mismatch(
+ location,
+ actual,
+ (description, verbose) => description
+ .add('does not contain ')
+ .addDescriptionOf(expectedElement));
+ }
+ }
+
+ if (other.length > expected.length) {
+ return _Mismatch.simple(location, actual, 'larger than expected');
+ } else if (other.length < expected.length) {
+ return _Mismatch.simple(location, actual, 'smaller than expected');
+ } else {
+ return null;
+ }
+ } else {
+ return _Mismatch.simple(location, actual, 'is not Iterable');
+ }
+ }
+
+ _Mismatch? _recursiveMatch(
+ Object? expected, Object? actual, String location, int depth) {
+ // If the expected value is a matcher, try to match it.
+ if (expected is Matcher) {
+ var matchState = {};
+ if (expected.matches(actual, matchState)) return null;
+ return _Mismatch(location, actual, (description, verbose) {
+ var oldLength = description.length;
+ expected.describeMismatch(actual, description, matchState, verbose);
+ if (depth > 0 && description.length == oldLength) {
+ description.add('does not match ');
+ expected.describe(description);
+ }
+ });
+ } else {
+ // Otherwise, test for equality.
+ try {
+ if (expected == actual) return null;
+ } catch (e) {
+ // TODO(gram): Add a test for this case.
+ return _Mismatch(
+ location,
+ actual,
+ (description, verbose) =>
+ description.add('== threw ').addDescriptionOf(e));
+ }
+ }
+
+ if (depth > _limit) {
+ return _Mismatch.simple(
+ location, actual, 'recursion depth limit exceeded');
+ }
+
+ // If _limit is 1 we can only recurse one level into object.
+ if (depth == 0 || _limit > 1) {
+ if (expected is Set) {
+ return _compareSets(
+ expected, actual, _recursiveMatch, depth + 1, location);
+ } else if (expected is Iterable) {
+ return _compareIterables(
+ expected, actual, _recursiveMatch, depth + 1, location);
+ } else if (expected is Map) {
+ if (actual is! Map) {
+ return _Mismatch.simple(location, actual, 'expected a map');
+ }
+ var err = (expected.length == actual.length)
+ ? ''
+ : 'has different length and ';
+ for (var key in expected.keys) {
+ if (!actual.containsKey(key)) {
+ return _Mismatch(
+ location,
+ actual,
+ (description, verbose) => description
+ .add('${err}is missing map key ')
+ .addDescriptionOf(key));
+ }
+ }
+
+ for (var key in actual.keys) {
+ if (!expected.containsKey(key)) {
+ return _Mismatch(
+ location,
+ actual,
+ (description, verbose) => description
+ .add('${err}has extra map key ')
+ .addDescriptionOf(key));
+ }
+ }
+
+ for (var key in expected.keys) {
+ var rp = _recursiveMatch(
+ expected[key], actual[key], "$location['$key']", depth + 1);
+ if (rp != null) return rp;
+ }
+
+ return null;
+ }
+ }
+
+ // If we have recursed, show the expected value too; if not, expect() will
+ // show it for us.
+ if (depth > 0) {
+ return _Mismatch(location, actual,
+ (description, verbose) => description.addDescriptionOf(expected),
+ instead: true);
+ } else {
+ return _Mismatch(location, actual, null);
+ }
+ }
+
+ @override
+ bool matches(Object? actual, Map matchState) {
+ var mismatch = _recursiveMatch(_expected, actual, '', 0);
+ if (mismatch == null) return true;
+ addStateInfo(matchState, {'mismatch': mismatch});
+ return false;
+ }
+
+ @override
+ Description describe(Description description) =>
+ description.addDescriptionOf(_expected);
+
+ @override
+ Description describeMismatch(Object? item, Description mismatchDescription,
+ Map matchState, bool verbose) {
+ var mismatch = matchState['mismatch'] as _Mismatch;
+ var describeProblem = mismatch.describeProblem;
+ if (mismatch.location.isNotEmpty) {
+ mismatchDescription
+ .add('at location ')
+ .add(mismatch.location)
+ .add(' is ')
+ .addDescriptionOf(mismatch.actual);
+ if (describeProblem != null) {
+ mismatchDescription
+ .add(' ${mismatch.instead ? 'instead of' : 'which'} ');
+ describeProblem(mismatchDescription, verbose);
+ }
+ } else {
+ // If we didn't get a good reason, that would normally be a
+ // simple 'is <value>' message. We only add that if the mismatch
+ // description is non empty (so we are supplementing the mismatch
+ // description).
+ if (describeProblem == null) {
+ if (mismatchDescription.length > 0) {
+ mismatchDescription.add('is ').addDescriptionOf(item);
+ }
+ } else {
+ describeProblem(mismatchDescription, verbose);
+ }
+ }
+ return mismatchDescription;
+ }
+}
+
+class _Mismatch {
+ /// A human-readable description of the location within the collection where
+ /// the mismatch occurred.
+ final String location;
+
+ /// The actual value found at [location].
+ final Object? actual;
+
+ /// Callback that can create a detailed description of the problem.
+ final void Function(Description, bool verbose)? describeProblem;
+
+ /// If `true`, [describeProblem] describes the expected value, so when the
+ /// final mismatch description is pieced together, it will be preceded by
+ /// `instead of` (e.g. `at location [2] is <3> instead of <4>`). If `false`,
+ /// [describeProblem] is a problem description from a sub-matcher, so when the
+ /// final mismatch description is pieced together, it will be preceded by
+ /// `which` (e.g. `at location [2] is <foo> which has length of 3`).
+ final bool instead;
+
+ _Mismatch(this.location, this.actual, this.describeProblem,
+ {this.instead = false});
+
+ _Mismatch.simple(this.location, this.actual, String problem)
+ : describeProblem = ((description, verbose) => description.add(problem)),
+ instead = false;
+}
diff --git a/pkgs/matcher/lib/src/error_matchers.dart b/pkgs/matcher/lib/src/error_matchers.dart
new file mode 100644
index 0000000..5b6238d
--- /dev/null
+++ b/pkgs/matcher/lib/src/error_matchers.dart
@@ -0,0 +1,48 @@
+// Copyright (c) 2012, 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 'type_matcher.dart';
+
+/// A matcher for [ArgumentError].
+const isArgumentError = TypeMatcher<ArgumentError>();
+
+/// A matcher for [TypeError].
+@Deprecated('CastError has been deprecated in favor of TypeError. ')
+const isCastError = TypeMatcher<TypeError>();
+
+/// A matcher for [ConcurrentModificationError].
+const isConcurrentModificationError =
+ TypeMatcher<ConcurrentModificationError>();
+
+/// A matcher for [Error].
+@Deprecated(
+ 'CyclicInitializationError is deprecated and will be removed in Dart 3. '
+ 'Use `isA<Error>()` instead.')
+const isCyclicInitializationError = TypeMatcher<Error>();
+
+/// A matcher for [Exception].
+const isException = TypeMatcher<Exception>();
+
+/// A matcher for [FormatException].
+const isFormatException = TypeMatcher<FormatException>();
+
+/// A matcher for [NoSuchMethodError].
+const isNoSuchMethodError = TypeMatcher<NoSuchMethodError>();
+
+/// A matcher for [TypeError].
+@Deprecated('NullThrownError is deprecated and will be removed in Dart 3. '
+ 'Use `isA<TypeError>()` instead.')
+const isNullThrownError = TypeMatcher<TypeError>();
+
+/// A matcher for [RangeError].
+const isRangeError = TypeMatcher<RangeError>();
+
+/// A matcher for [StateError].
+const isStateError = TypeMatcher<StateError>();
+
+/// A matcher for [UnimplementedError].
+const isUnimplementedError = TypeMatcher<UnimplementedError>();
+
+/// A matcher for [UnsupportedError].
+const isUnsupportedError = TypeMatcher<UnsupportedError>();
diff --git a/pkgs/matcher/lib/src/expect/async_matcher.dart b/pkgs/matcher/lib/src/expect/async_matcher.dart
new file mode 100644
index 0000000..854151d
--- /dev/null
+++ b/pkgs/matcher/lib/src/expect/async_matcher.dart
@@ -0,0 +1,68 @@
+// Copyright (c) 2017, 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.
+
+// ignore_for_file: deprecated_member_use_from_same_package
+
+import 'package:test_api/hooks.dart';
+
+import '../description.dart';
+import '../equals_matcher.dart';
+import '../interfaces.dart';
+import '../operator_matchers.dart';
+import '../type_matcher.dart';
+import 'expect.dart';
+
+/// A matcher that does asynchronous computation.
+///
+/// Rather than implementing [matches], subclasses implement [matchAsync].
+/// [AsyncMatcher.matches] ensures that the test doesn't complete until the
+/// returned future completes, and [expect] returns a future that completes when
+/// the returned future completes so that tests can wait for it.
+abstract class AsyncMatcher extends Matcher {
+ const AsyncMatcher();
+
+ /// Returns `null` if this matches [item], or a [String] description of the
+ /// failure if it doesn't match.
+ ///
+ /// This can return a [Future] or a synchronous value. If it returns a
+ /// [Future], neither [expect] nor the test will complete until that [Future]
+ /// completes.
+ ///
+ /// If this returns a [String] synchronously, [expect] will synchronously
+ /// throw a [TestFailure] and [matches] will synchronously return `false`.
+ dynamic /*FutureOr<String>*/ matchAsync(dynamic item);
+
+ @override
+ bool matches(dynamic item, Map matchState) {
+ final result = matchAsync(item);
+ expect(
+ result,
+ anyOf([
+ equals(null),
+ const TypeMatcher<Future>(),
+ const TypeMatcher<String>()
+ ]),
+ reason: 'matchAsync() may only return a String, a Future, or null.');
+
+ if (result is Future) {
+ final outstandingWork = TestHandle.current.markPending();
+ result.then((realResult) {
+ if (realResult != null) {
+ fail(formatFailure(this, item, realResult as String));
+ }
+ outstandingWork.complete();
+ });
+ } else if (result is String) {
+ matchState[this] = result;
+ return false;
+ }
+
+ return true;
+ }
+
+ @override
+ Description describeMismatch(dynamic item, Description mismatchDescription,
+ Map matchState, bool verbose) =>
+ StringDescription(matchState[this] as String);
+}
diff --git a/pkgs/matcher/lib/src/expect/expect.dart b/pkgs/matcher/lib/src/expect/expect.dart
new file mode 100644
index 0000000..8dd8cae
--- /dev/null
+++ b/pkgs/matcher/lib/src/expect/expect.dart
@@ -0,0 +1,161 @@
+// Copyright (c) 2015, 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.
+
+// ignore_for_file: deprecated_member_use_from_same_package
+
+import 'package:test_api/hooks.dart';
+
+import '../description.dart';
+import '../equals_matcher.dart';
+import '../interfaces.dart';
+import '../operator_matchers.dart';
+import '../type_matcher.dart';
+import '../util.dart';
+import 'async_matcher.dart';
+import 'future_matchers.dart';
+import 'prints_matcher.dart';
+import 'throws_matcher.dart';
+import 'util/pretty_print.dart';
+
+/// The type used for functions that can be used to build up error reports
+/// upon failures in [expect].
+@Deprecated('Will be removed in 0.13.0.')
+typedef ErrorFormatter = String Function(Object? actual, Matcher matcher,
+ String? reason, Map matchState, bool verbose);
+
+/// Assert that [actual] matches [matcher].
+///
+/// This is the main assertion function. [reason] is optional and is typically
+/// not supplied, as a reason is generated from [matcher]; if [reason]
+/// is included it is appended to the reason generated by the matcher.
+///
+/// [matcher] can be a value in which case it will be wrapped in an
+/// [equals] matcher.
+///
+/// If the assertion fails a [TestFailure] is thrown.
+///
+/// If [skip] is a String or `true`, the assertion is skipped. The arguments are
+/// still evaluated, but [actual] is not verified to match [matcher]. If
+/// [actual] is a [Future], the test won't complete until the future emits a
+/// value.
+///
+/// If [skip] is a string, it should explain why the assertion is skipped; this
+/// reason will be printed when running the test.
+///
+/// Certain matchers, like [completion] and [throwsA], either match or fail
+/// asynchronously. When you use [expect] with these matchers, it ensures that
+/// the test doesn't complete until the matcher has either matched or failed. If
+/// you want to wait for the matcher to complete before continuing the test, you
+/// can call [expectLater] instead and `await` the result.
+void expect(dynamic actual, dynamic matcher,
+ {String? reason,
+ Object? /* String|bool */ skip,
+ @Deprecated('Will be removed in 0.13.0.') bool verbose = false,
+ @Deprecated('Will be removed in 0.13.0.') ErrorFormatter? formatter}) {
+ _expect(actual, matcher,
+ reason: reason, skip: skip, verbose: verbose, formatter: formatter);
+}
+
+/// Just like [expect], but returns a [Future] that completes when the matcher
+/// has finished matching.
+///
+/// For the [completes] and [completion] matchers, as well as [throwsA] and
+/// related matchers when they're matched against a [Future], the returned
+/// future completes when the matched future completes. For the [prints]
+/// matcher, it completes when the future returned by the callback completes.
+/// Otherwise, it completes immediately.
+///
+/// If the matcher fails asynchronously, that failure is piped to the returned
+/// future where it can be handled by user code.
+Future expectLater(dynamic actual, dynamic matcher,
+ {String? reason, Object? /* String|bool */ skip}) =>
+ _expect(actual, matcher, reason: reason, skip: skip);
+
+/// The implementation of [expect] and [expectLater].
+Future _expect(Object? actual, Object? matcher,
+ {String? reason, skip, bool verbose = false, ErrorFormatter? formatter}) {
+ final test = TestHandle.current;
+ formatter ??= (actual, matcher, reason, matchState, verbose) {
+ var mismatchDescription = StringDescription();
+ matcher.describeMismatch(actual, mismatchDescription, matchState, verbose);
+
+ return formatFailure(matcher, actual, mismatchDescription.toString(),
+ reason: reason);
+ };
+
+ if (skip != null && skip is! bool && skip is! String) {
+ throw ArgumentError.value(skip, 'skip', 'must be a bool or a String');
+ }
+
+ matcher = wrapMatcher(matcher);
+ if (skip != null && skip != false) {
+ String message;
+ if (skip is String) {
+ message = 'Skip expect: $skip';
+ } else if (reason != null) {
+ message = 'Skip expect ($reason).';
+ } else {
+ var description = StringDescription().addDescriptionOf(matcher);
+ message = 'Skip expect ($description).';
+ }
+
+ test.markSkipped(message);
+ return Future.sync(() {});
+ }
+
+ if (matcher is AsyncMatcher) {
+ // Avoid async/await so that expect() throws synchronously when possible.
+ var result = matcher.matchAsync(actual);
+ expect(
+ result,
+ anyOf([
+ equals(null),
+ const TypeMatcher<Future>(),
+ const TypeMatcher<String>()
+ ]),
+ reason: 'matchAsync() may only return a String, a Future, or null.');
+
+ if (result is String) {
+ fail(formatFailure(matcher, actual, result, reason: reason));
+ } else if (result is Future) {
+ final outstandingWork = test.markPending();
+ return result.then((realResult) {
+ if (realResult == null) return;
+ fail(formatFailure(matcher as Matcher, actual, realResult as String,
+ reason: reason));
+ }).whenComplete(
+ // Always remove this, in case the failure is caught and handled
+ // gracefully.
+ outstandingWork.complete);
+ }
+
+ return Future.sync(() {});
+ }
+
+ var matchState = {};
+ try {
+ if ((matcher as Matcher).matches(actual, matchState)) {
+ return Future.sync(() {});
+ }
+ } catch (e, trace) {
+ reason ??= '$e at $trace';
+ }
+ fail(formatter(actual, matcher as Matcher, reason, matchState, verbose));
+}
+
+/// Convenience method for throwing a new [TestFailure] with the provided
+/// [message].
+Never fail(String message) => throw TestFailure(message);
+
+// The default error formatter.
+@Deprecated('Will be removed in 0.13.0.')
+String formatFailure(Matcher expected, Object? actual, String which,
+ {String? reason}) {
+ var buffer = StringBuffer();
+ buffer.writeln(indent(prettyPrint(expected), first: 'Expected: '));
+ buffer.writeln(indent(prettyPrint(actual), first: ' Actual: '));
+ if (which.isNotEmpty) buffer.writeln(indent(which, first: ' Which: '));
+ if (reason != null) buffer.writeln(reason);
+ return buffer.toString();
+}
diff --git a/pkgs/matcher/lib/src/expect/expect_async.dart b/pkgs/matcher/lib/src/expect/expect_async.dart
new file mode 100644
index 0000000..88cf6f2
--- /dev/null
+++ b/pkgs/matcher/lib/src/expect/expect_async.dart
@@ -0,0 +1,586 @@
+// Copyright (c) 2015, 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 'package:test_api/hooks.dart';
+
+import 'util/placeholder.dart';
+
+// Function types returned by expectAsync# methods.
+
+typedef Func0<T> = T Function();
+typedef Func1<T, A> = T Function([A a]);
+typedef Func2<T, A, B> = T Function([A a, B b]);
+typedef Func3<T, A, B, C> = T Function([A a, B b, C c]);
+typedef Func4<T, A, B, C, D> = T Function([A a, B b, C c, D d]);
+typedef Func5<T, A, B, C, D, E> = T Function([A a, B b, C c, D d, E e]);
+typedef Func6<T, A, B, C, D, E, F> = T Function([A a, B b, C c, D d, E e, F f]);
+
+/// A wrapper for a function that ensures that it's called the appropriate
+/// number of times.
+///
+/// The containing test won't be considered to have completed successfully until
+/// this function has been called the appropriate number of times.
+///
+/// The wrapper function is accessible via [func]. It supports up to six
+/// optional and/or required positional arguments, but no named arguments.
+class _ExpectedFunction<T> {
+ /// The wrapped callback.
+ final Function _callback;
+
+ /// The minimum number of calls that are expected to be made to the function.
+ ///
+ /// If fewer calls than this are made, the test will fail.
+ final int _minExpectedCalls;
+
+ /// The maximum number of calls that are expected to be made to the function.
+ ///
+ /// If more calls than this are made, the test will fail.
+ final int _maxExpectedCalls;
+
+ /// A callback that should return whether the function is not expected to have
+ /// any more calls.
+ ///
+ /// This will be called after every time the function is run. The test case
+ /// won't be allowed to terminate until it returns `true`.
+ ///
+ /// This may be `null`. If so, the function is considered to be done after
+ /// it's been run once.
+ final bool Function()? _isDone;
+
+ /// A descriptive name for the function.
+ final String _id;
+
+ /// An optional description of why the function is expected to be called.
+ ///
+ /// If not passed, this will be an empty string.
+ final String _reason;
+
+ /// The number of times the function has been called.
+ int _actualCalls = 0;
+
+ /// The test in which this function was wrapped.
+ late final TestHandle _test;
+
+ /// Whether this function has been called the requisite number of times.
+ late bool _complete;
+
+ OutstandingWork? _outstandingWork;
+
+ /// Wraps [callback] in a function that asserts that it's called at least
+ /// [minExpected] times and no more than [maxExpected] times.
+ ///
+ /// If passed, [id] is used as a descriptive name fo the function and [reason]
+ /// as a reason it's expected to be called. If [isDone] is passed, the test
+ /// won't be allowed to complete until it returns `true`.
+ _ExpectedFunction(Function callback, int minExpected, int maxExpected,
+ {String? id, String? reason, bool Function()? isDone})
+ : _callback = callback,
+ _minExpectedCalls = minExpected,
+ _maxExpectedCalls =
+ (maxExpected == 0 && minExpected > 0) ? minExpected : maxExpected,
+ _isDone = isDone,
+ _reason = reason == null ? '' : '\n$reason',
+ _id = _makeCallbackId(id, callback) {
+ try {
+ _test = TestHandle.current;
+ } on OutsideTestException {
+ throw StateError('`expectAsync` must be called within a test.');
+ }
+
+ if (maxExpected > 0 && minExpected > maxExpected) {
+ throw ArgumentError('max ($maxExpected) may not be less than count '
+ '($minExpected).');
+ }
+
+ if (isDone != null || minExpected > 0) {
+ _outstandingWork = _test.markPending();
+ _complete = false;
+ } else {
+ _complete = true;
+ }
+ }
+
+ /// Tries to find a reasonable name for [callback].
+ ///
+ /// If [id] is passed, uses that. Otherwise, tries to determine a name from
+ /// calling `toString`. If no name can be found, returns the empty string.
+ static String _makeCallbackId(String? id, Function callback) {
+ if (id != null) return '$id ';
+
+ // If the callback is not an anonymous closure, try to get the
+ // name.
+ var toString = callback.toString();
+ var prefix = "Function '";
+ var start = toString.indexOf(prefix);
+ if (start == -1) return '';
+
+ start += prefix.length;
+ var end = toString.indexOf("'", start);
+ if (end == -1) return '';
+ return '${toString.substring(start, end)} ';
+ }
+
+ /// Returns a function that has the same number of positional arguments as the
+ /// wrapped function (up to a total of 6).
+ Function get func {
+ if (_callback is Function(Never, Never, Never, Never, Never, Never)) {
+ return max6;
+ }
+ if (_callback is Function(Never, Never, Never, Never, Never)) return max5;
+ if (_callback is Function(Never, Never, Never, Never)) return max4;
+ if (_callback is Function(Never, Never, Never)) return max3;
+ if (_callback is Function(Never, Never)) return max2;
+ if (_callback is Function(Never)) return max1;
+ if (_callback is Function()) return max0;
+
+ _outstandingWork?.complete();
+ throw ArgumentError(
+ 'The wrapped function has more than 6 required arguments');
+ }
+
+ // This indirection is critical. It ensures the returned function has an
+ // argument count of zero.
+ T max0() => max6();
+
+ T max1([Object? a0 = placeholder]) => max6(a0);
+
+ T max2([Object? a0 = placeholder, Object? a1 = placeholder]) => max6(a0, a1);
+
+ T max3(
+ [Object? a0 = placeholder,
+ Object? a1 = placeholder,
+ Object? a2 = placeholder]) =>
+ max6(a0, a1, a2);
+
+ T max4(
+ [Object? a0 = placeholder,
+ Object? a1 = placeholder,
+ Object? a2 = placeholder,
+ Object? a3 = placeholder]) =>
+ max6(a0, a1, a2, a3);
+
+ T max5(
+ [Object? a0 = placeholder,
+ Object? a1 = placeholder,
+ Object? a2 = placeholder,
+ Object? a3 = placeholder,
+ Object? a4 = placeholder]) =>
+ max6(a0, a1, a2, a3, a4);
+
+ T max6(
+ [Object? a0 = placeholder,
+ Object? a1 = placeholder,
+ Object? a2 = placeholder,
+ Object? a3 = placeholder,
+ Object? a4 = placeholder,
+ Object? a5 = placeholder]) =>
+ _run([a0, a1, a2, a3, a4, a5].where((a) => a != placeholder));
+
+ /// Runs the wrapped function with [args] and returns its return value.
+ T _run(Iterable args) {
+ // Note that in the old test, this returned `null` if it encountered an
+ // error, where now it just re-throws that error because Zone machinery will
+ // pass it to the invoker anyway.
+ try {
+ _actualCalls++;
+ if (_test.shouldBeDone) {
+ throw TestFailure(
+ 'Callback ${_id}called ($_actualCalls) after test case '
+ '${_test.name} had already completed.$_reason');
+ } else if (_maxExpectedCalls >= 0 && _actualCalls > _maxExpectedCalls) {
+ throw TestFailure('Callback ${_id}called more times than expected '
+ '($_maxExpectedCalls).$_reason');
+ }
+
+ return Function.apply(_callback, args.toList()) as T;
+ } finally {
+ _afterRun();
+ }
+ }
+
+ /// After each time the function is run, check to see if it's complete.
+ void _afterRun() {
+ if (_complete) return;
+ if (_minExpectedCalls > 0 && _actualCalls < _minExpectedCalls) return;
+ if (_isDone != null && !_isDone()) return;
+
+ // Mark this callback as complete and remove it from the test case's
+ // outstanding callback count; if that hits zero the test is done.
+ _complete = true;
+ _outstandingWork?.complete();
+ }
+}
+
+/// This function is deprecated because it doesn't work well with strong mode.
+/// Use [expectAsync0], [expectAsync1],
+/// [expectAsync2], [expectAsync3], [expectAsync4], [expectAsync5], or
+/// [expectAsync6] instead.
+@Deprecated('Will be removed in 0.13.0')
+Function expectAsync(Function callback,
+ {int count = 1, int max = 0, String? id, String? reason}) =>
+ _ExpectedFunction(callback, count, max, id: id, reason: reason).func;
+
+/// Informs the framework that the given [callback] of arity 0 is expected to be
+/// called [count] number of times (by default 1).
+///
+/// Returns a wrapped function that should be used as a replacement of the
+/// original callback.
+///
+/// The test framework will wait for the callback to run the [count] times
+/// before it considers the current test to be complete.
+///
+/// [max] can be used to specify an upper bound on the number of calls; if this
+/// is exceeded the test will fail. If [max] is `0` (the default), the callback
+/// is expected to be called exactly [count] times. If [max] is `-1`, the
+/// callback is allowed to be called any number of times greater than [count].
+///
+/// Both [id] and [reason] are optional and provide extra information about the
+/// callback when debugging. [id] should be the name of the callback, while
+/// [reason] should be the reason the callback is expected to be called.
+///
+/// This method takes callbacks with zero arguments. See also
+/// [expectAsync1], [expectAsync2], [expectAsync3], [expectAsync4],
+/// [expectAsync5], and [expectAsync6] for callbacks with different arity.
+Func0<T> expectAsync0<T>(T Function() callback,
+ {int count = 1, int max = 0, String? id, String? reason}) =>
+ _ExpectedFunction<T>(callback, count, max, id: id, reason: reason).max0;
+
+/// Informs the framework that the given [callback] of arity 1 is expected to be
+/// called [count] number of times (by default 1).
+///
+/// Returns a wrapped function that should be used as a replacement of the
+/// original callback.
+///
+/// The test framework will wait for the callback to run the [count] times
+/// before it considers the current test to be complete.
+///
+/// [max] can be used to specify an upper bound on the number of calls; if this
+/// is exceeded the test will fail. If [max] is `0` (the default), the callback
+/// is expected to be called exactly [count] times. If [max] is `-1`, the
+/// callback is allowed to be called any number of times greater than [count].
+///
+/// Both [id] and [reason] are optional and provide extra information about the
+/// callback when debugging. [id] should be the name of the callback, while
+/// [reason] should be the reason the callback is expected to be called.
+///
+/// This method takes callbacks with one argument. See also
+/// [expectAsync0], [expectAsync2], [expectAsync3], [expectAsync4],
+/// [expectAsync5], and [expectAsync6] for callbacks with different arity.
+Func1<T, A> expectAsync1<T, A>(T Function(A) callback,
+ {int count = 1, int max = 0, String? id, String? reason}) =>
+ _ExpectedFunction<T>(callback, count, max, id: id, reason: reason).max1;
+
+/// Informs the framework that the given [callback] of arity 2 is expected to be
+/// called [count] number of times (by default 1).
+///
+/// Returns a wrapped function that should be used as a replacement of the
+/// original callback.
+///
+/// The test framework will wait for the callback to run the [count] times
+/// before it considers the current test to be complete.
+///
+/// [max] can be used to specify an upper bound on the number of calls; if this
+/// is exceeded the test will fail. If [max] is `0` (the default), the callback
+/// is expected to be called exactly [count] times. If [max] is `-1`, the
+/// callback is allowed to be called any number of times greater than [count].
+///
+/// Both [id] and [reason] are optional and provide extra information about the
+/// callback when debugging. [id] should be the name of the callback, while
+/// [reason] should be the reason the callback is expected to be called.
+///
+/// This method takes callbacks with two arguments. See also
+/// [expectAsync0], [expectAsync1], [expectAsync3], [expectAsync4],
+/// [expectAsync5], and [expectAsync6] for callbacks with different arity.
+Func2<T, A, B> expectAsync2<T, A, B>(T Function(A, B) callback,
+ {int count = 1, int max = 0, String? id, String? reason}) =>
+ _ExpectedFunction<T>(callback, count, max, id: id, reason: reason).max2;
+
+/// Informs the framework that the given [callback] of arity 3 is expected to be
+/// called [count] number of times (by default 1).
+///
+/// Returns a wrapped function that should be used as a replacement of the
+/// original callback.
+///
+/// The test framework will wait for the callback to run the [count] times
+/// before it considers the current test to be complete.
+///
+/// [max] can be used to specify an upper bound on the number of calls; if this
+/// is exceeded the test will fail. If [max] is `0` (the default), the callback
+/// is expected to be called exactly [count] times. If [max] is `-1`, the
+/// callback is allowed to be called any number of times greater than [count].
+///
+/// Both [id] and [reason] are optional and provide extra information about the
+/// callback when debugging. [id] should be the name of the callback, while
+/// [reason] should be the reason the callback is expected to be called.
+///
+/// This method takes callbacks with three arguments. See also
+/// [expectAsync0], [expectAsync1], [expectAsync2], [expectAsync4],
+/// [expectAsync5], and [expectAsync6] for callbacks with different arity.
+Func3<T, A, B, C> expectAsync3<T, A, B, C>(T Function(A, B, C) callback,
+ {int count = 1, int max = 0, String? id, String? reason}) =>
+ _ExpectedFunction<T>(callback, count, max, id: id, reason: reason).max3;
+
+/// Informs the framework that the given [callback] of arity 4 is expected to be
+/// called [count] number of times (by default 1).
+///
+/// Returns a wrapped function that should be used as a replacement of the
+/// original callback.
+///
+/// The test framework will wait for the callback to run the [count] times
+/// before it considers the current test to be complete.
+///
+/// [max] can be used to specify an upper bound on the number of calls; if this
+/// is exceeded the test will fail. If [max] is `0` (the default), the callback
+/// is expected to be called exactly [count] times. If [max] is `-1`, the
+/// callback is allowed to be called any number of times greater than [count].
+///
+/// Both [id] and [reason] are optional and provide extra information about the
+/// callback when debugging. [id] should be the name of the callback, while
+/// [reason] should be the reason the callback is expected to be called.
+///
+/// This method takes callbacks with four arguments. See also
+/// [expectAsync0], [expectAsync1], [expectAsync2], [expectAsync3],
+/// [expectAsync5], and [expectAsync6] for callbacks with different arity.
+Func4<T, A, B, C, D> expectAsync4<T, A, B, C, D>(
+ T Function(A, B, C, D) callback,
+ {int count = 1,
+ int max = 0,
+ String? id,
+ String? reason}) =>
+ _ExpectedFunction<T>(callback, count, max, id: id, reason: reason).max4;
+
+/// Informs the framework that the given [callback] of arity 5 is expected to be
+/// called [count] number of times (by default 1).
+///
+/// Returns a wrapped function that should be used as a replacement of the
+/// original callback.
+///
+/// The test framework will wait for the callback to run the [count] times
+/// before it considers the current test to be complete.
+///
+/// [max] can be used to specify an upper bound on the number of calls; if this
+/// is exceeded the test will fail. If [max] is `0` (the default), the callback
+/// is expected to be called exactly [count] times. If [max] is `-1`, the
+/// callback is allowed to be called any number of times greater than [count].
+///
+/// Both [id] and [reason] are optional and provide extra information about the
+/// callback when debugging. [id] should be the name of the callback, while
+/// [reason] should be the reason the callback is expected to be called.
+///
+/// This method takes callbacks with five arguments. See also
+/// [expectAsync0], [expectAsync1], [expectAsync2], [expectAsync3],
+/// [expectAsync4], and [expectAsync6] for callbacks with different arity.
+Func5<T, A, B, C, D, E> expectAsync5<T, A, B, C, D, E>(
+ T Function(A, B, C, D, E) callback,
+ {int count = 1,
+ int max = 0,
+ String? id,
+ String? reason}) =>
+ _ExpectedFunction<T>(callback, count, max, id: id, reason: reason).max5;
+
+/// Informs the framework that the given [callback] of arity 6 is expected to be
+/// called [count] number of times (by default 1).
+///
+/// Returns a wrapped function that should be used as a replacement of the
+/// original callback.
+///
+/// The test framework will wait for the callback to run the [count] times
+/// before it considers the current test to be complete.
+///
+/// [max] can be used to specify an upper bound on the number of calls; if this
+/// is exceeded the test will fail. If [max] is `0` (the default), the callback
+/// is expected to be called exactly [count] times. If [max] is `-1`, the
+/// callback is allowed to be called any number of times greater than [count].
+///
+/// Both [id] and [reason] are optional and provide extra information about the
+/// callback when debugging. [id] should be the name of the callback, while
+/// [reason] should be the reason the callback is expected to be called.
+///
+/// This method takes callbacks with six arguments. See also
+/// [expectAsync0], [expectAsync1], [expectAsync2], [expectAsync3],
+/// [expectAsync4], and [expectAsync5] for callbacks with different arity.
+Func6<T, A, B, C, D, E, F> expectAsync6<T, A, B, C, D, E, F>(
+ T Function(A, B, C, D, E, F) callback,
+ {int count = 1,
+ int max = 0,
+ String? id,
+ String? reason}) =>
+ _ExpectedFunction<T>(callback, count, max, id: id, reason: reason).max6;
+
+/// This function is deprecated because it doesn't work well with strong mode.
+/// Use [expectAsyncUntil0], [expectAsyncUntil1],
+/// [expectAsyncUntil2], [expectAsyncUntil3], [expectAsyncUntil4],
+/// [expectAsyncUntil5], or [expectAsyncUntil6] instead.
+@Deprecated('Will be removed in 0.13.0')
+Function expectAsyncUntil(Function callback, bool Function() isDone,
+ {String? id, String? reason}) =>
+ _ExpectedFunction(callback, 0, -1, id: id, reason: reason, isDone: isDone)
+ .func;
+
+/// Informs the framework that the given [callback] of arity 0 is expected to be
+/// called until [isDone] returns true.
+///
+/// Returns a wrapped function that should be used as a replacement of the
+/// original callback.
+///
+/// [isDone] is called after each time the function is run. Only when it returns
+/// true will the callback be considered complete.
+///
+/// Both [id] and [reason] are optional and provide extra information about the
+/// callback when debugging. [id] should be the name of the callback, while
+/// [reason] should be the reason the callback is expected to be called.
+///
+/// This method takes callbacks with zero arguments. See also
+/// [expectAsyncUntil1], [expectAsyncUntil2], [expectAsyncUntil3],
+/// [expectAsyncUntil4], [expectAsyncUntil5], and [expectAsyncUntil6] for
+/// callbacks with different arity.
+Func0<T> expectAsyncUntil0<T>(T Function() callback, bool Function() isDone,
+ {String? id, String? reason}) =>
+ _ExpectedFunction<T>(callback, 0, -1,
+ id: id, reason: reason, isDone: isDone)
+ .max0;
+
+/// Informs the framework that the given [callback] of arity 1 is expected to be
+/// called until [isDone] returns true.
+///
+/// Returns a wrapped function that should be used as a replacement of the
+/// original callback.
+///
+/// [isDone] is called after each time the function is run. Only when it returns
+/// true will the callback be considered complete.
+///
+/// Both [id] and [reason] are optional and provide extra information about the
+/// callback when debugging. [id] should be the name of the callback, while
+/// [reason] should be the reason the callback is expected to be called.
+///
+/// This method takes callbacks with one argument. See also
+/// [expectAsyncUntil0], [expectAsyncUntil2], [expectAsyncUntil3],
+/// [expectAsyncUntil4], [expectAsyncUntil5], and [expectAsyncUntil6] for
+/// callbacks with different arity.
+Func1<T, A> expectAsyncUntil1<T, A>(
+ T Function(A) callback, bool Function() isDone,
+ {String? id, String? reason}) =>
+ _ExpectedFunction<T>(callback, 0, -1,
+ id: id, reason: reason, isDone: isDone)
+ .max1;
+
+/// Informs the framework that the given [callback] of arity 2 is expected to be
+/// called until [isDone] returns true.
+///
+/// Returns a wrapped function that should be used as a replacement of the
+/// original callback.
+///
+/// [isDone] is called after each time the function is run. Only when it returns
+/// true will the callback be considered complete.
+///
+/// Both [id] and [reason] are optional and provide extra information about the
+/// callback when debugging. [id] should be the name of the callback, while
+/// [reason] should be the reason the callback is expected to be called.
+///
+/// This method takes callbacks with two arguments. See also
+/// [expectAsyncUntil0], [expectAsyncUntil1], [expectAsyncUntil3],
+/// [expectAsyncUntil4], [expectAsyncUntil5], and [expectAsyncUntil6] for
+/// callbacks with different arity.
+Func2<T, A, B> expectAsyncUntil2<T, A, B>(
+ T Function(A, B) callback, bool Function() isDone,
+ {String? id, String? reason}) =>
+ _ExpectedFunction<T>(callback, 0, -1,
+ id: id, reason: reason, isDone: isDone)
+ .max2;
+
+/// Informs the framework that the given [callback] of arity 3 is expected to be
+/// called until [isDone] returns true.
+///
+/// Returns a wrapped function that should be used as a replacement of the
+/// original callback.
+///
+/// [isDone] is called after each time the function is run. Only when it returns
+/// true will the callback be considered complete.
+///
+/// Both [id] and [reason] are optional and provide extra information about the
+/// callback when debugging. [id] should be the name of the callback, while
+/// [reason] should be the reason the callback is expected to be called.
+///
+/// This method takes callbacks with three arguments. See also
+/// [expectAsyncUntil0], [expectAsyncUntil1], [expectAsyncUntil2],
+/// [expectAsyncUntil4], [expectAsyncUntil5], and [expectAsyncUntil6] for
+/// callbacks with different arity.
+Func3<T, A, B, C> expectAsyncUntil3<T, A, B, C>(
+ T Function(A, B, C) callback, bool Function() isDone,
+ {String? id, String? reason}) =>
+ _ExpectedFunction<T>(callback, 0, -1,
+ id: id, reason: reason, isDone: isDone)
+ .max3;
+
+/// Informs the framework that the given [callback] of arity 4 is expected to be
+/// called until [isDone] returns true.
+///
+/// Returns a wrapped function that should be used as a replacement of the
+/// original callback.
+///
+/// [isDone] is called after each time the function is run. Only when it returns
+/// true will the callback be considered complete.
+///
+/// Both [id] and [reason] are optional and provide extra information about the
+/// callback when debugging. [id] should be the name of the callback, while
+/// [reason] should be the reason the callback is expected to be called.
+///
+/// This method takes callbacks with four arguments. See also
+/// [expectAsyncUntil0], [expectAsyncUntil1], [expectAsyncUntil2],
+/// [expectAsyncUntil3], [expectAsyncUntil5], and [expectAsyncUntil6] for
+/// callbacks with different arity.
+Func4<T, A, B, C, D> expectAsyncUntil4<T, A, B, C, D>(
+ T Function(A, B, C, D) callback, bool Function() isDone,
+ {String? id, String? reason}) =>
+ _ExpectedFunction<T>(callback, 0, -1,
+ id: id, reason: reason, isDone: isDone)
+ .max4;
+
+/// Informs the framework that the given [callback] of arity 5 is expected to be
+/// called until [isDone] returns true.
+///
+/// Returns a wrapped function that should be used as a replacement of the
+/// original callback.
+///
+/// [isDone] is called after each time the function is run. Only when it returns
+/// true will the callback be considered complete.
+///
+/// Both [id] and [reason] are optional and provide extra information about the
+/// callback when debugging. [id] should be the name of the callback, while
+/// [reason] should be the reason the callback is expected to be called.
+///
+/// This method takes callbacks with five arguments. See also
+/// [expectAsyncUntil0], [expectAsyncUntil1], [expectAsyncUntil2],
+/// [expectAsyncUntil3], [expectAsyncUntil4], and [expectAsyncUntil6] for
+/// callbacks with different arity.
+Func5<T, A, B, C, D, E> expectAsyncUntil5<T, A, B, C, D, E>(
+ T Function(A, B, C, D, E) callback, bool Function() isDone,
+ {String? id, String? reason}) =>
+ _ExpectedFunction<T>(callback, 0, -1,
+ id: id, reason: reason, isDone: isDone)
+ .max5;
+
+/// Informs the framework that the given [callback] of arity 6 is expected to be
+/// called until [isDone] returns true.
+///
+/// Returns a wrapped function that should be used as a replacement of the
+/// original callback.
+///
+/// [isDone] is called after each time the function is run. Only when it returns
+/// true will the callback be considered complete.
+///
+/// Both [id] and [reason] are optional and provide extra information about the
+/// callback when debugging. [id] should be the name of the callback, while
+/// [reason] should be the reason the callback is expected to be called.
+///
+/// This method takes callbacks with six arguments. See also
+/// [expectAsyncUntil0], [expectAsyncUntil1], [expectAsyncUntil2],
+/// [expectAsyncUntil3], [expectAsyncUntil4], and [expectAsyncUntil5] for
+/// callbacks with different arity.
+Func6<T, A, B, C, D, E, F> expectAsyncUntil6<T, A, B, C, D, E, F>(
+ T Function(A, B, C, D, E, F) callback, bool Function() isDone,
+ {String? id, String? reason}) =>
+ _ExpectedFunction<T>(callback, 0, -1,
+ id: id, reason: reason, isDone: isDone)
+ .max6;
diff --git a/pkgs/matcher/lib/src/expect/future_matchers.dart b/pkgs/matcher/lib/src/expect/future_matchers.dart
new file mode 100644
index 0000000..407b9b8
--- /dev/null
+++ b/pkgs/matcher/lib/src/expect/future_matchers.dart
@@ -0,0 +1,119 @@
+// Copyright (c) 2012, 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.
+
+// ignore_for_file: deprecated_member_use_from_same_package
+
+import 'package:test_api/hooks.dart' show pumpEventQueue;
+
+import '../description.dart';
+import '../interfaces.dart';
+import '../util.dart';
+import 'async_matcher.dart';
+import 'expect.dart';
+import 'throws_matcher.dart';
+import 'util/pretty_print.dart';
+
+/// Matches a [Future] that completes successfully with any value.
+///
+/// This creates an asynchronous expectation. The call to [expect] will return
+/// immediately and execution will continue. To wait for the future to
+/// complete and the expectation to run use [expectLater] and wait on the
+/// returned future.
+///
+/// To test that a Future completes with an exception, you can use [throws] and
+/// [throwsA].
+final Matcher completes = const _Completes(null);
+
+/// Matches a [Future] that completes successfully with a value that matches
+/// [matcher].
+///
+/// This creates an asynchronous expectation. The call to [expect] will return
+/// immediately and execution will continue. Later, when the future completes,
+/// the expectation against [matcher] will run. To wait for the future to
+/// complete and the expectation to run use [expectLater] and wait on the
+/// returned future.
+///
+/// To test that a Future completes with an exception, you can use [throws] and
+/// [throwsA].
+Matcher completion(Object? matcher,
+ [@Deprecated('this parameter is ignored') String? description]) =>
+ _Completes(wrapMatcher(matcher));
+
+class _Completes extends AsyncMatcher {
+ final Matcher? _matcher;
+
+ const _Completes(this._matcher);
+
+ // Avoid async/await so we synchronously start listening to [item].
+ @override
+ dynamic /*FutureOr<String>*/ matchAsync(Object? item) {
+ if (item is! Future) return 'was not a Future';
+
+ return item.then((value) async {
+ if (_matcher == null) return null;
+
+ String? result;
+ if (_matcher is AsyncMatcher) {
+ result = await _matcher.matchAsync(value) as String?;
+ if (result == null) return null;
+ } else {
+ var matchState = {};
+ if (_matcher.matches(value, matchState)) return null;
+ result = _matcher
+ .describeMismatch(value, StringDescription(), matchState, false)
+ .toString();
+ }
+
+ var buffer = StringBuffer();
+ buffer.writeln(indent(prettyPrint(value), first: 'emitted '));
+ if (result.isNotEmpty) buffer.writeln(indent(result, first: ' which '));
+ return buffer.toString().trimRight();
+ });
+ }
+
+ @override
+ Description describe(Description description) {
+ if (_matcher == null) {
+ description.add('completes successfully');
+ } else {
+ description.add('completes to a value that ').addDescriptionOf(_matcher);
+ }
+ return description;
+ }
+}
+
+/// Matches a [Future] that does not complete.
+///
+/// Note that this creates an asynchronous expectation. The call to
+/// `expect()` that includes this will return immediately and execution will
+/// continue.
+final Matcher doesNotComplete = const _DoesNotComplete();
+
+class _DoesNotComplete extends Matcher {
+ const _DoesNotComplete();
+
+ @override
+ Description describe(Description description) {
+ description.add('does not complete');
+ return description;
+ }
+
+ @override
+ bool matches(Object? item, Map matchState) {
+ if (item is! Future) return false;
+ item.then((value) {
+ fail('Future was not expected to complete but completed with a value of '
+ '$value');
+ });
+ expect(pumpEventQueue(), completes);
+ return true;
+ }
+
+ @override
+ Description describeMismatch(
+ Object? item, Description description, Map matchState, bool verbose) {
+ if (item is! Future) return description.add('$item is not a Future');
+ return description;
+ }
+}
diff --git a/pkgs/matcher/lib/src/expect/never_called.dart b/pkgs/matcher/lib/src/expect/never_called.dart
new file mode 100644
index 0000000..20b5299
--- /dev/null
+++ b/pkgs/matcher/lib/src/expect/never_called.dart
@@ -0,0 +1,68 @@
+// Copyright (c) 2017, 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:stack_trace/stack_trace.dart';
+import 'package:test_api/hooks.dart';
+
+import 'expect.dart';
+import 'future_matchers.dart';
+import 'util/placeholder.dart';
+import 'util/pretty_print.dart';
+
+/// Returns a function that causes the test to fail if it's called.
+///
+/// This can safely be passed in place of any callback that takes ten or fewer
+/// positional parameters. For example:
+///
+/// ```dart
+/// // Asserts that the stream never emits an event.
+/// stream.listen(neverCalled);
+/// ```
+///
+/// This also ensures that the test doesn't complete until a call to
+/// [pumpEventQueue] finishes, so that the callback has a chance to be called.
+Null Function(
+ [Object?,
+ Object?,
+ Object?,
+ Object?,
+ Object?,
+ Object?,
+ Object?,
+ Object?,
+ Object?,
+ Object?]) get neverCalled {
+ // Make sure the test stays alive long enough to call the function if it's
+ // going to.
+ expect(pumpEventQueue(), completes);
+
+ var zone = Zone.current;
+ return (
+ [a1 = placeholder,
+ a2 = placeholder,
+ a3 = placeholder,
+ a4 = placeholder,
+ a5 = placeholder,
+ a6 = placeholder,
+ a7 = placeholder,
+ a8 = placeholder,
+ a9 = placeholder,
+ a10 = placeholder]) {
+ var arguments = [a1, a2, a3, a4, a5, a6, a7, a8, a9, a10]
+ .where((argument) => argument != placeholder)
+ .toList();
+
+ var argsText = arguments.isEmpty
+ ? ' no arguments.'
+ : ':\n${bullet(arguments.map(prettyPrint))}';
+ zone.handleUncaughtError(
+ TestFailure(
+ 'Callback should never have been called, but it was called with'
+ '$argsText'),
+ zone.run(Chain.current));
+ return null;
+ };
+}
diff --git a/pkgs/matcher/lib/src/expect/prints_matcher.dart b/pkgs/matcher/lib/src/expect/prints_matcher.dart
new file mode 100644
index 0000000..57ae95e
--- /dev/null
+++ b/pkgs/matcher/lib/src/expect/prints_matcher.dart
@@ -0,0 +1,72 @@
+// Copyright (c) 2014, 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 '../description.dart';
+import '../interfaces.dart';
+import '../util.dart';
+import 'async_matcher.dart';
+import 'expect.dart';
+import 'util/pretty_print.dart';
+
+/// Matches a [Function] that prints text that matches [matcher].
+///
+/// [matcher] may be a String or a [Matcher].
+///
+/// If the function this runs against returns a [Future], all text printed by
+/// the function (using [Zone] scoping) until that Future completes is matched.
+///
+/// This only tracks text printed using the [print] function.
+///
+/// This returns an [AsyncMatcher], so [expect] won't complete until the matched
+/// function does.
+Matcher prints(Object? matcher) => _Prints(wrapMatcher(matcher));
+
+class _Prints extends AsyncMatcher {
+ final Matcher _matcher;
+
+ _Prints(this._matcher);
+
+ // Avoid async/await so we synchronously fail if the function is
+ // synchronous.
+ @override
+ dynamic /*FutureOr<String>*/ matchAsync(Object? item) {
+ if (item is! Function()) return 'was not a unary Function';
+
+ var buffer = StringBuffer();
+ var result = runZoned(item,
+ zoneSpecification: ZoneSpecification(print: (_, __, ____, line) {
+ buffer.writeln(line);
+ }));
+
+ return result is Future
+ ? result.then((_) => _check(buffer.toString()))
+ : _check(buffer.toString());
+ }
+
+ @override
+ Description describe(Description description) =>
+ description.add('prints ').addDescriptionOf(_matcher);
+
+ /// Verifies that [actual] matches [_matcher] and returns a [String]
+ /// description of the failure if it doesn't.
+ String? _check(String actual) {
+ var matchState = {};
+ if (_matcher.matches(actual, matchState)) return null;
+
+ var result = _matcher
+ .describeMismatch(actual, StringDescription(), matchState, false)
+ .toString();
+
+ var buffer = StringBuffer();
+ if (actual.isEmpty) {
+ buffer.writeln('printed nothing');
+ } else {
+ buffer.writeln(indent(prettyPrint(actual), first: 'printed '));
+ }
+ if (result.isNotEmpty) buffer.writeln(indent(result, first: ' which '));
+ return buffer.toString().trimRight();
+ }
+}
diff --git a/pkgs/matcher/lib/src/expect/stream_matcher.dart b/pkgs/matcher/lib/src/expect/stream_matcher.dart
new file mode 100644
index 0000000..0c1d852
--- /dev/null
+++ b/pkgs/matcher/lib/src/expect/stream_matcher.dart
@@ -0,0 +1,196 @@
+// Copyright (c) 2017, 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 'package:async/async.dart';
+import 'package:test_api/hooks.dart';
+
+import '../interfaces.dart';
+import 'async_matcher.dart';
+import 'expect.dart';
+import 'util/pretty_print.dart';
+
+/// A matcher that matches events from [Stream]s or [StreamQueue]s.
+///
+/// Stream matchers are designed to make it straightforward to create complex
+/// expectations for streams, and to interleave expectations with the rest of a
+/// test. They can be used on a [Stream] to match all events it emits:
+///
+/// ```dart
+/// expect(stream, emitsInOrder([
+/// // Values match individual events.
+/// "Ready.",
+///
+/// // Matchers also run against individual events.
+/// startsWith("Loading took"),
+///
+/// // Stream matchers can be nested. This asserts that one of two events are
+/// // emitted after the "Loading took" line.
+/// emitsAnyOf(["Succeeded!", "Failed!"]),
+///
+/// // By default, more events are allowed after the matcher finishes
+/// // matching. This asserts instead that the stream emits a done event and
+/// // nothing else.
+/// emitsDone
+/// ]));
+/// ```
+///
+/// It can also match a [StreamQueue], in which case it consumes the matched
+/// events. The call to [expect] returns a [Future] that completes when the
+/// matcher is done matching. You can `await` this to consume different events
+/// at different times:
+///
+/// ```dart
+/// var stdout = StreamQueue(stdoutLineStream);
+///
+/// // Ignore lines from the process until it's about to emit the URL.
+/// await expectLater(stdout, emitsThrough('WebSocket URL:'));
+///
+/// // Parse the next line as a URL.
+/// var url = Uri.parse(await stdout.next);
+/// expect(url.host, equals('localhost'));
+///
+/// // You can match against the same StreamQueue multiple times.
+/// await expectLater(stdout, emits('Waiting for connection...'));
+/// ```
+///
+/// Users can call [StreamMatcher] to create custom matchers.
+abstract class StreamMatcher extends Matcher {
+ /// The description of this matcher.
+ ///
+ /// This is in the subjunctive mood, which means it can be used after the word
+ /// "should". For example, it might be "emit the right events".
+ String get description;
+
+ /// Creates a new [StreamMatcher] described by [description] that matches
+ /// events with [matchQueue].
+ ///
+ /// The [matchQueue] callback is used to implement [StreamMatcher.matchQueue],
+ /// and should follow all the guarantees of that method. In particular:
+ ///
+ /// * If it matches successfully, it should return `null` and possibly consume
+ /// events.
+ /// * If it fails to match, consume no events and return a description of the
+ /// failure.
+ /// * The description should be in past tense.
+ /// * The description should be grammatically valid when used after "the
+ /// stream"—"emitted the wrong events", for example.
+ ///
+ /// The [matchQueue] callback may return the empty string to indicate a
+ /// failure if it has no information to add beyond the description of the
+ /// failure and the events actually emitted by the stream.
+ ///
+ /// The [description] should be in the subjunctive mood. This means that it
+ /// should be grammatically valid when used after the word "should". For
+ /// example, it might be "emit the right events".
+ factory StreamMatcher(Future<String?> Function(StreamQueue) matchQueue,
+ String description) = _StreamMatcher;
+
+ /// Tries to match events emitted by [queue].
+ ///
+ /// If this matches successfully, it consumes the matching events from [queue]
+ /// and returns `null`.
+ ///
+ /// If this fails to match, it doesn't consume any events and returns a
+ /// description of the failure. This description is in the past tense, and
+ /// could grammatically be used after "the stream". For example, it might
+ /// return "emitted the wrong events".
+ ///
+ /// The description string may also be empty, which indicates that the
+ /// matcher's description and the events actually emitted by the stream are
+ /// enough to understand the failure.
+ ///
+ /// If the queue emits an error, that error is re-thrown unless otherwise
+ /// indicated by the matcher.
+ Future<String?> matchQueue(StreamQueue queue);
+}
+
+/// A concrete implementation of [StreamMatcher].
+///
+/// This is separate from the original type to hide the private [AsyncMatcher]
+/// interface.
+class _StreamMatcher extends AsyncMatcher implements StreamMatcher {
+ @override
+ final String description;
+
+ /// The callback used to implement [matchQueue].
+ final Future<String?> Function(StreamQueue) _matchQueue;
+
+ _StreamMatcher(this._matchQueue, this.description);
+
+ @override
+ Future<String?> matchQueue(StreamQueue queue) => _matchQueue(queue);
+
+ @override
+ dynamic /*FutureOr<String>*/ matchAsync(Object? item) {
+ StreamQueue queue;
+ var shouldCancelQueue = false;
+ if (item is StreamQueue) {
+ queue = item;
+ } else if (item is Stream) {
+ queue = StreamQueue(item);
+ shouldCancelQueue = true;
+ } else {
+ return 'was not a Stream or a StreamQueue';
+ }
+
+ // Avoid async/await in the outer method so that we synchronously error out
+ // for an invalid argument type.
+ var transaction = queue.startTransaction();
+ var copy = transaction.newQueue();
+ return matchQueue(copy).then((result) async {
+ // Accept the transaction if the result is null, indicating that the match
+ // succeeded.
+ if (result == null) {
+ transaction.commit(copy);
+ return null;
+ }
+
+ // Get a list of events emitted by the stream so we can emit them as part
+ // of the error message.
+ var replay = transaction.newQueue();
+ var events = <Result?>[];
+ var subscription = Result.captureStreamTransformer
+ .bind(replay.rest.cast())
+ .listen(events.add, onDone: () => events.add(null));
+
+ // Wait on a timer tick so all buffered events are emitted.
+ await Future.delayed(Duration.zero);
+ _unawaited(subscription.cancel());
+
+ var eventsString = events.map((event) {
+ if (event == null) {
+ return 'x Stream closed.';
+ } else if (event.isValue) {
+ return addBullet(event.asValue!.value.toString());
+ } else {
+ var error = event.asError!;
+ var chain = TestHandle.current.formatStackTrace(error.stackTrace);
+ var text = '${error.error}\n$chain';
+ return indent(text, first: '! ');
+ }
+ }).join('\n');
+ if (eventsString.isEmpty) eventsString = 'no events';
+
+ transaction.reject();
+
+ var buffer = StringBuffer();
+ buffer.writeln(indent(eventsString, first: 'emitted '));
+ if (result.isNotEmpty) buffer.writeln(indent(result, first: ' which '));
+ return buffer.toString().trimRight();
+ }, onError: (Object error) {
+ transaction.reject();
+ // ignore: only_throw_errors
+ throw error;
+ }).then((result) {
+ if (shouldCancelQueue) queue.cancel();
+ return result;
+ });
+ }
+
+ @override
+ Description describe(Description description) =>
+ description.add('should ').add(this.description);
+}
+
+void _unawaited(Future<void> f) {}
diff --git a/pkgs/matcher/lib/src/expect/stream_matchers.dart b/pkgs/matcher/lib/src/expect/stream_matchers.dart
new file mode 100644
index 0000000..02efff3
--- /dev/null
+++ b/pkgs/matcher/lib/src/expect/stream_matchers.dart
@@ -0,0 +1,377 @@
+// Copyright (c) 2017, 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 'package:async/async.dart';
+
+import '../description.dart';
+import '../interfaces.dart';
+import '../util.dart';
+import 'async_matcher.dart';
+import 'stream_matcher.dart';
+import 'throws_matcher.dart';
+import 'util/pretty_print.dart';
+
+/// Returns a [StreamMatcher] that asserts that the stream emits a "done" event.
+final emitsDone = StreamMatcher(
+ (queue) async => (await queue.hasNext) ? '' : null, 'be done');
+
+/// Returns a [StreamMatcher] for [matcher].
+///
+/// If [matcher] is already a [StreamMatcher], it's returned as-is. If it's any
+/// other [Matcher], this matches a single event that matches that matcher. If
+/// it's any other Object, this matches a single event that's equal to that
+/// object.
+///
+/// This functions like [wrapMatcher] for [StreamMatcher]s: it can convert any
+/// matcher-like value into a proper [StreamMatcher].
+StreamMatcher emits(Object? matcher) {
+ if (matcher is StreamMatcher) return matcher;
+ var wrapped = wrapMatcher(matcher);
+
+ var matcherDescription = wrapped.describe(StringDescription());
+
+ return StreamMatcher((queue) async {
+ if (!await queue.hasNext) return '';
+
+ var matchState = {};
+ var actual = await queue.next;
+ if (wrapped.matches(actual, matchState)) return null;
+
+ var mismatchDescription = StringDescription();
+ wrapped.describeMismatch(actual, mismatchDescription, matchState, false);
+
+ if (mismatchDescription.length == 0) return '';
+ return 'emitted an event that $mismatchDescription';
+ },
+ // TODO(nweiz): add "should" once matcher#42 is fixed.
+ 'emit an event that $matcherDescription');
+}
+
+/// Returns a [StreamMatcher] that matches a single error event that matches
+/// [matcher].
+StreamMatcher emitsError(Object? matcher) {
+ var wrapped = wrapMatcher(matcher);
+ var matcherDescription = wrapped.describe(StringDescription());
+ var throwsMatcher = throwsA(wrapped) as AsyncMatcher;
+
+ return StreamMatcher(
+ (queue) => throwsMatcher.matchAsync(queue.next) as Future<String?>,
+ // TODO(nweiz): add "should" once matcher#42 is fixed.
+ 'emit an error that $matcherDescription');
+}
+
+/// Returns a [StreamMatcher] that allows (but doesn't require) [matcher] to
+/// match the stream.
+///
+/// This matcher always succeeds; if [matcher] doesn't match, this just consumes
+/// no events.
+StreamMatcher mayEmit(Object? matcher) {
+ var streamMatcher = emits(matcher);
+ return StreamMatcher((queue) async {
+ await queue.withTransaction(
+ (copy) async => (await streamMatcher.matchQueue(copy)) == null);
+ return null;
+ }, 'maybe ${streamMatcher.description}');
+}
+
+/// Returns a [StreamMatcher] that matches the stream if at least one of
+/// [matchers] matches.
+///
+/// If multiple matchers match the stream, this chooses the matcher that
+/// consumes as many events as possible.
+///
+/// If any matchers match the stream, no errors from other matchers are thrown.
+/// If no matchers match and multiple matchers threw errors, the first error is
+/// re-thrown.
+StreamMatcher emitsAnyOf(Iterable matchers) {
+ var streamMatchers = matchers.map(emits).toList();
+ if (streamMatchers.isEmpty) {
+ throw ArgumentError('matcher may not be empty');
+ }
+
+ if (streamMatchers.length == 1) return streamMatchers.first;
+ var description = 'do one of the following:\n'
+ '${bullet(streamMatchers.map((matcher) => matcher.description))}';
+
+ return StreamMatcher((queue) async {
+ var transaction = queue.startTransaction();
+
+ // Allocate the failures list ahead of time so that its order matches the
+ // order of [matchers], and thus the order the matchers will be listed in
+ // the description.
+ var failures = List<String?>.filled(matchers.length, null);
+
+ // The first error thrown. If no matchers match and this exists, we rethrow
+ // it.
+ Object? firstError;
+ StackTrace? firstStackTrace;
+
+ var futures = <Future>[];
+ StreamQueue? consumedMost;
+ for (var i = 0; i < matchers.length; i++) {
+ futures.add(() async {
+ var copy = transaction.newQueue();
+
+ String? result;
+ try {
+ result = await streamMatchers[i].matchQueue(copy);
+ } catch (error, stackTrace) {
+ if (firstError == null) {
+ firstError = error;
+ firstStackTrace = stackTrace;
+ }
+ return;
+ }
+
+ if (result != null) {
+ failures[i] = result;
+ } else if (consumedMost == null ||
+ consumedMost!.eventsDispatched < copy.eventsDispatched) {
+ consumedMost = copy;
+ }
+ }());
+ }
+
+ await Future.wait(futures);
+
+ if (consumedMost == null) {
+ transaction.reject();
+ if (firstError != null) {
+ await Future.error(firstError!, firstStackTrace);
+ }
+
+ var failureMessages = <String>[];
+ for (var i = 0; i < matchers.length; i++) {
+ var message = 'failed to ${streamMatchers[i].description}';
+ if (failures[i]!.isNotEmpty) {
+ message += message.contains('\n') ? '\n' : ' ';
+ message += 'because it ${failures[i]}';
+ }
+
+ failureMessages.add(message);
+ }
+
+ return 'failed all options:\n${bullet(failureMessages)}';
+ } else {
+ transaction.commit(consumedMost!);
+ return null;
+ }
+ }, description);
+}
+
+/// Returns a [StreamMatcher] that matches the stream if each matcher in
+/// [matchers] matches, one after another.
+///
+/// If any matcher fails to match, this fails and consumes no events.
+StreamMatcher emitsInOrder(Iterable matchers) {
+ var streamMatchers = matchers.map(emits).toList();
+ if (streamMatchers.length == 1) return streamMatchers.first;
+
+ var description = 'do the following in order:\n'
+ '${bullet(streamMatchers.map((matcher) => matcher.description))}';
+
+ return StreamMatcher((queue) async {
+ for (var i = 0; i < streamMatchers.length; i++) {
+ var matcher = streamMatchers[i];
+ var result = await matcher.matchQueue(queue);
+ if (result == null) continue;
+
+ var newResult = "didn't ${matcher.description}";
+ if (result.isNotEmpty) {
+ newResult += newResult.contains('\n') ? '\n' : ' ';
+ newResult += 'because it $result';
+ }
+ return newResult;
+ }
+ return null;
+ }, description);
+}
+
+/// Returns a [StreamMatcher] that matches any number of events followed by
+/// events that match [matcher].
+///
+/// This consumes all events matched by [matcher], as well as all events before.
+/// If the stream emits a done event without matching [matcher], this fails and
+/// consumes no events.
+StreamMatcher emitsThrough(Object? matcher) {
+ var streamMatcher = emits(matcher);
+ return StreamMatcher((queue) async {
+ var failures = <String>[];
+
+ Future<bool> tryHere() => queue.withTransaction((copy) async {
+ var result = await streamMatcher.matchQueue(copy);
+ if (result == null) return true;
+ failures.add(result);
+ return false;
+ });
+
+ while (await queue.hasNext) {
+ if (await tryHere()) return null;
+ await queue.next;
+ }
+
+ // Try after the queue is done in case the matcher can match an empty
+ // stream.
+ if (await tryHere()) return null;
+
+ var result = 'never did ${streamMatcher.description}';
+
+ var failureMessages =
+ bullet(failures.where((failure) => failure.isNotEmpty));
+ if (failureMessages.isNotEmpty) {
+ result += result.contains('\n') ? '\n' : ' ';
+ result += 'because it:\n$failureMessages';
+ }
+
+ return result;
+ }, 'eventually ${streamMatcher.description}');
+}
+
+/// Returns a [StreamMatcher] that matches any number of events that match
+/// [matcher].
+///
+/// This consumes events until [matcher] no longer matches. It always succeeds;
+/// if [matcher] doesn't match, this just consumes no events. It never rethrows
+/// errors.
+StreamMatcher mayEmitMultiple(Object? matcher) {
+ var streamMatcher = emits(matcher);
+
+ var description = streamMatcher.description;
+ description += description.contains('\n') ? '\n' : ' ';
+ description += 'zero or more times';
+
+ return StreamMatcher((queue) async {
+ while (await _tryMatch(queue, streamMatcher)) {
+ // Do nothing; the matcher presumably already consumed events.
+ }
+ return null;
+ }, description);
+}
+
+/// Returns a [StreamMatcher] that matches a stream that never matches
+/// [matcher].
+///
+/// This doesn't complete until the stream emits a done event. It never consumes
+/// any events. It never re-throws errors.
+StreamMatcher neverEmits(Object? matcher) {
+ var streamMatcher = emits(matcher);
+ return StreamMatcher((queue) async {
+ var events = 0;
+ var matched = false;
+ await queue.withTransaction((copy) async {
+ while (await copy.hasNext) {
+ matched = await _tryMatch(copy, streamMatcher);
+ if (matched) return false;
+
+ events++;
+
+ try {
+ await copy.next;
+ } catch (_) {
+ // Ignore errors events.
+ }
+ }
+
+ matched = await _tryMatch(copy, streamMatcher);
+ return false;
+ });
+
+ if (!matched) return null;
+ return "after $events ${pluralize('event', events)} did "
+ '${streamMatcher.description}';
+ }, 'never ${streamMatcher.description}');
+}
+
+/// Returns whether [matcher] matches [queue] at its current position.
+///
+/// This treats errors as failures to match.
+Future<bool> _tryMatch(StreamQueue queue, StreamMatcher matcher) {
+ return queue.withTransaction((copy) async {
+ try {
+ return (await matcher.matchQueue(copy)) == null;
+ } catch (_) {
+ return false;
+ }
+ });
+}
+
+/// Returns a [StreamMatcher] that matches the stream if each matcher in
+/// [matchers] matches, in any order.
+///
+/// If any matcher fails to match, this fails and consumes no events. If the
+/// matchers match in multiple different possible orders, this chooses the order
+/// that consumes as many events as possible.
+///
+/// If any sequence of matchers matches the stream, no errors from other
+/// sequences are thrown. If no sequences match and multiple sequences throw
+/// errors, the first error is re-thrown.
+///
+/// Note that checking every ordering of [matchers] is O(n!) in the worst case,
+/// so this should only be called when there are very few [matchers].
+StreamMatcher emitsInAnyOrder(Iterable matchers) {
+ var streamMatchers = matchers.map(emits).toSet();
+ if (streamMatchers.length == 1) return streamMatchers.first;
+ var description = 'do the following in any order:\n'
+ '${bullet(streamMatchers.map((matcher) => matcher.description))}';
+
+ return StreamMatcher(
+ (queue) async => await _tryInAnyOrder(queue, streamMatchers) ? null : '',
+ description);
+}
+
+/// Returns whether [queue] matches [matchers] in any order.
+Future<bool> _tryInAnyOrder(
+ StreamQueue queue, Set<StreamMatcher> matchers) async {
+ if (matchers.length == 1) {
+ return await matchers.first.matchQueue(queue) == null;
+ }
+
+ var transaction = queue.startTransaction();
+ StreamQueue? consumedMost;
+
+ // The first error thrown. If no matchers match and this exists, we rethrow
+ // it.
+ Object? firstError;
+ StackTrace? firstStackTrace;
+
+ await Future.wait(matchers.map((matcher) async {
+ var copy = transaction.newQueue();
+ try {
+ if (await matcher.matchQueue(copy) != null) return;
+ } catch (error, stackTrace) {
+ if (firstError == null) {
+ firstError = error;
+ firstStackTrace = stackTrace;
+ }
+ return;
+ }
+
+ var rest = Set<StreamMatcher>.from(matchers);
+ rest.remove(matcher);
+
+ try {
+ if (!await _tryInAnyOrder(copy, rest)) return;
+ } catch (error, stackTrace) {
+ if (firstError == null) {
+ firstError = error;
+ firstStackTrace = stackTrace;
+ }
+ return;
+ }
+
+ if (consumedMost == null ||
+ consumedMost!.eventsDispatched < copy.eventsDispatched) {
+ consumedMost = copy;
+ }
+ }));
+
+ if (consumedMost == null) {
+ transaction.reject();
+ if (firstError != null) await Future.error(firstError!, firstStackTrace);
+ return false;
+ } else {
+ transaction.commit(consumedMost!);
+ return true;
+ }
+}
diff --git a/pkgs/matcher/lib/src/expect/throws_matcher.dart b/pkgs/matcher/lib/src/expect/throws_matcher.dart
new file mode 100644
index 0000000..37676ef
--- /dev/null
+++ b/pkgs/matcher/lib/src/expect/throws_matcher.dart
@@ -0,0 +1,139 @@
+// Copyright (c) 2014, 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.
+
+// ignore_for_file: deprecated_member_use_from_same_package
+
+import 'package:test_api/hooks.dart';
+
+import '../description.dart';
+import '../interfaces.dart';
+import '../util.dart';
+import 'async_matcher.dart';
+import 'util/pretty_print.dart';
+
+/// This function is deprecated.
+///
+/// Use [throwsA] instead. We strongly recommend that you add assertions about
+/// at least the type of the error, but you can write `throwsA(anything)` to
+/// mimic the behavior of this matcher.
+@Deprecated('Will be removed in 0.13.0')
+const Matcher throws = Throws();
+
+/// This can be used to match three kinds of objects:
+///
+/// * A [Function] that throws an exception when called. The function cannot
+/// take any arguments. If you want to test that a function expecting
+/// arguments throws, wrap it in another zero-argument function that calls
+/// the one you want to test.
+///
+/// * A [Future] that completes with an exception. Note that this creates an
+/// asynchronous expectation. The call to `expect()` that includes this will
+/// return immediately and execution will continue. Later, when the future
+/// completes, the actual expectation will run.
+///
+/// * A [Function] that returns a [Future] that completes with an exception.
+///
+/// In all three cases, when an exception is thrown, this will test that the
+/// exception object matches [matcher]. If [matcher] is not an instance of
+/// [Matcher], it will implicitly be treated as `equals(matcher)`.
+///
+/// Examples:
+/// ```dart
+/// void functionThatThrows() => throw SomeException();
+///
+/// void functionWithArgument(bool shouldThrow) {
+/// if (shouldThrow) {
+/// throw SomeException();
+/// }
+/// }
+///
+/// Future<void> asyncFunctionThatThrows() async => throw SomeException();
+///
+/// expect(functionThatThrows, throwsA(isA<SomeException>()));
+///
+/// expect(() => functionWithArgument(true), throwsA(isA<SomeException>()));
+///
+/// var future = asyncFunctionThatThrows();
+/// await expectLater(future, throwsA(isA<SomeException>()));
+///
+/// await expectLater(
+/// asyncFunctionThatThrows, throwsA(isA<SomeException>()));
+/// ```
+Matcher throwsA(Object? matcher) => Throws(wrapMatcher(matcher));
+
+/// Use the [throwsA] function instead.
+@Deprecated('Will be removed in 0.13.0')
+class Throws extends AsyncMatcher {
+ final Matcher? _matcher;
+
+ const Throws([Matcher? matcher]) : _matcher = matcher;
+
+ // Avoid async/await so we synchronously fail if we match a synchronous
+ // function.
+ @override
+ dynamic /*FutureOr<String>*/ matchAsync(Object? item) {
+ if (item is! Function && item is! Future) {
+ return 'was not a Function or Future';
+ }
+
+ if (item is Future) {
+ return _matchFuture(item, 'emitted ');
+ }
+
+ try {
+ var value = (item as Function)();
+ if (value is Future) {
+ return _matchFuture(value, 'returned a Future that emitted ');
+ }
+
+ return indent(prettyPrint(value), first: 'returned ');
+ } catch (error, trace) {
+ return _check(error, trace);
+ }
+ }
+
+ /// Matches [future], using try/catch since `onError` doesn't seem to work
+ /// properly in nnbd.
+ Future<String?> _matchFuture(
+ Future<dynamic> future, String messagePrefix) async {
+ try {
+ var value = await future;
+ return indent(prettyPrint(value), first: messagePrefix);
+ } catch (error, trace) {
+ return _check(error, trace);
+ }
+ }
+
+ @override
+ Description describe(Description description) {
+ if (_matcher == null) {
+ return description.add('throws');
+ } else {
+ return description.add('throws ').addDescriptionOf(_matcher);
+ }
+ }
+
+ /// Verifies that [error] matches [_matcher] and returns a [String]
+ /// description of the failure if it doesn't.
+ String? _check(error, StackTrace? trace) {
+ if (_matcher == null) return null;
+
+ var matchState = {};
+ if (_matcher.matches(error, matchState)) return null;
+
+ var result = _matcher
+ .describeMismatch(error, StringDescription(), matchState, false)
+ .toString();
+
+ var buffer = StringBuffer();
+ buffer.writeln(indent(prettyPrint(error), first: 'threw '));
+ if (trace != null) {
+ buffer.writeln(indent(
+ TestHandle.current.formatStackTrace(trace).toString(),
+ first: 'stack '));
+ }
+ if (result.isNotEmpty) buffer.writeln(indent(result, first: 'which '));
+ return buffer.toString().trimRight();
+ }
+}
diff --git a/pkgs/matcher/lib/src/expect/throws_matchers.dart b/pkgs/matcher/lib/src/expect/throws_matchers.dart
new file mode 100644
index 0000000..67d35b7
--- /dev/null
+++ b/pkgs/matcher/lib/src/expect/throws_matchers.dart
@@ -0,0 +1,72 @@
+// Copyright (c) 2014, 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.
+
+// ignore_for_file: deprecated_member_use_from_same_package
+
+import '../error_matchers.dart';
+import '../interfaces.dart';
+import '../type_matcher.dart';
+import 'throws_matcher.dart';
+
+/// A matcher for functions that throw ArgumentError.
+///
+/// See [throwsA] for objects that this can be matched against.
+const Matcher throwsArgumentError = Throws(isArgumentError);
+
+/// A matcher for functions that throw ConcurrentModificationError.
+///
+/// See [throwsA] for objects that this can be matched against.
+const Matcher throwsConcurrentModificationError =
+ Throws(isConcurrentModificationError);
+
+/// A matcher for functions that throw CyclicInitializationError.
+///
+/// See [throwsA] for objects that this can be matched against.
+@Deprecated('throwsCyclicInitializationError has been deprecated, because '
+ 'the type will longer exists in Dart 3.0. It will now catch any kind of '
+ 'error, not only CyclicInitializationError.')
+const Matcher throwsCyclicInitializationError = Throws(TypeMatcher<Error>());
+
+/// A matcher for functions that throw Exception.
+///
+/// See [throwsA] for objects that this can be matched against.
+const Matcher throwsException = Throws(isException);
+
+/// A matcher for functions that throw FormatException.
+///
+/// See [throwsA] for objects that this can be matched against.
+const Matcher throwsFormatException = Throws(isFormatException);
+
+/// A matcher for functions that throw NoSuchMethodError.
+///
+/// See [throwsA] for objects that this can be matched against.
+const Matcher throwsNoSuchMethodError = Throws(isNoSuchMethodError);
+
+/// A matcher for functions that throw NullThrownError.
+///
+/// See [throwsA] for objects that this can be matched against.
+@Deprecated('throwsNullThrownError has been deprecated, because '
+ 'NullThrownError has been replaced with TypeError. '
+ 'Use `throwsA(isA<TypeError>())` instead.')
+const Matcher throwsNullThrownError = Throws(TypeMatcher<TypeError>());
+
+/// A matcher for functions that throw RangeError.
+///
+/// See [throwsA] for objects that this can be matched against.
+const Matcher throwsRangeError = Throws(isRangeError);
+
+/// A matcher for functions that throw StateError.
+///
+/// See [throwsA] for objects that this can be matched against.
+const Matcher throwsStateError = Throws(isStateError);
+
+/// A matcher for functions that throw Exception.
+///
+/// See [throwsA] for objects that this can be matched against.
+const Matcher throwsUnimplementedError = Throws(isUnimplementedError);
+
+/// A matcher for functions that throw UnsupportedError.
+///
+/// See [throwsA] for objects that this can be matched against.
+const Matcher throwsUnsupportedError = Throws(isUnsupportedError);
diff --git a/pkgs/matcher/lib/src/expect/util/placeholder.dart b/pkgs/matcher/lib/src/expect/util/placeholder.dart
new file mode 100644
index 0000000..ee2dc70
--- /dev/null
+++ b/pkgs/matcher/lib/src/expect/util/placeholder.dart
@@ -0,0 +1,16 @@
+// Copyright (c) 2017, 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.
+
+/// A class that's used as a default argument to detect whether an argument was
+/// passed.
+///
+/// We use a custom class for this rather than just `const Object()` so that
+/// callers can't accidentally pass the placeholder value.
+class _Placeholder {
+ const _Placeholder();
+}
+
+/// A placeholder to use as a default argument value to detect whether an
+/// argument was passed.
+const placeholder = _Placeholder();
diff --git a/pkgs/matcher/lib/src/expect/util/pretty_print.dart b/pkgs/matcher/lib/src/expect/util/pretty_print.dart
new file mode 100644
index 0000000..de635ba
--- /dev/null
+++ b/pkgs/matcher/lib/src/expect/util/pretty_print.dart
@@ -0,0 +1,48 @@
+// Copyright (c) 2021, 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 'package:term_glyph/term_glyph.dart' as glyph;
+
+import '../../description.dart';
+
+/// Indent each line in [text] by [first] spaces.
+///
+/// [first] is used in place of the first line's indentation.
+String indent(String text, {required String first}) {
+ final prefix = ' ' * first.length;
+ var lines = text.split('\n');
+ if (lines.length == 1) return '$first$text';
+
+ var buffer = StringBuffer('$first${lines.first}\n');
+
+ // Write out all but the first and last lines with [prefix].
+ for (var line in lines.skip(1).take(lines.length - 2)) {
+ buffer.writeln('$prefix$line');
+ }
+ buffer.write('$prefix${lines.last}');
+ return buffer.toString();
+}
+
+/// Returns a pretty-printed representation of [value].
+///
+/// The matcher package doesn't expose its pretty-print function directly, but
+/// we can use it through StringDescription.
+String prettyPrint(Object? value) =>
+ StringDescription().addDescriptionOf(value).toString();
+
+/// Indents [text], and adds a bullet at the beginning.
+String addBullet(String text) => indent(text, first: '${glyph.bullet} ');
+
+/// Converts [strings] to a bulleted list.
+String bullet(Iterable<String> strings) => strings.map(addBullet).join('\n');
+
+/// Returns [name] if [number] is 1, or the plural of [name] otherwise.
+///
+/// By default, this just adds "s" to the end of [name] to get the plural. If
+/// [plural] is passed, that's used instead.
+String pluralize(String name, int number, {String? plural}) {
+ if (number == 1) return name;
+ if (plural != null) return plural;
+ return '${name}s';
+}
diff --git a/pkgs/matcher/lib/src/feature_matcher.dart b/pkgs/matcher/lib/src/feature_matcher.dart
new file mode 100644
index 0000000..1dbe56c
--- /dev/null
+++ b/pkgs/matcher/lib/src/feature_matcher.dart
@@ -0,0 +1,34 @@
+// Copyright (c) 2018, 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 'interfaces.dart';
+import 'type_matcher.dart';
+
+/// A package-private [TypeMatcher] implementation that makes it easy for
+/// subclasses to validate aspects of specific types while providing consistent
+/// type checking.
+abstract class FeatureMatcher<T> extends TypeMatcher<T> {
+ const FeatureMatcher();
+
+ @override
+ bool matches(dynamic item, Map matchState) =>
+ super.matches(item, matchState) && typedMatches(item as T, matchState);
+
+ bool typedMatches(T item, Map matchState);
+
+ @override
+ Description describeMismatch(Object? item, Description mismatchDescription,
+ Map matchState, bool verbose) {
+ if (item is T) {
+ return describeTypedMismatch(
+ item, mismatchDescription, matchState, verbose);
+ }
+
+ return super.describe(mismatchDescription.add('not an '));
+ }
+
+ Description describeTypedMismatch(T item, Description mismatchDescription,
+ Map matchState, bool verbose) =>
+ mismatchDescription;
+}
diff --git a/pkgs/matcher/lib/src/having_matcher.dart b/pkgs/matcher/lib/src/having_matcher.dart
new file mode 100644
index 0000000..2d2dc3d
--- /dev/null
+++ b/pkgs/matcher/lib/src/having_matcher.dart
@@ -0,0 +1,75 @@
+// Copyright (c) 2018, 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 'custom_matcher.dart';
+import 'interfaces.dart';
+import 'type_matcher.dart';
+import 'util.dart';
+
+/// A package-private [TypeMatcher] implementation that handles is returned
+/// by calls to [TypeMatcher.having].
+class HavingMatcher<T> implements TypeMatcher<T> {
+ final TypeMatcher<T> _parent;
+ final List<_FunctionMatcher<T>> _functionMatchers;
+
+ HavingMatcher(this._parent, String description, Object? Function(T) feature,
+ dynamic matcher)
+ : _functionMatchers = [
+ _FunctionMatcher<T>(description, feature, matcher)
+ ];
+
+ HavingMatcher._fromExisting(
+ this._parent,
+ String description,
+ Object? Function(T) feature,
+ dynamic matcher,
+ Iterable<_FunctionMatcher<T>>? existing)
+ : _functionMatchers = [
+ ...?existing,
+ _FunctionMatcher<T>(description, feature, matcher)
+ ];
+
+ @override
+ TypeMatcher<T> having(
+ Object? Function(T) feature, String description, dynamic matcher) =>
+ HavingMatcher._fromExisting(
+ _parent, description, feature, matcher, _functionMatchers);
+
+ @override
+ bool matches(dynamic item, Map matchState) {
+ for (var matcher in <Matcher>[_parent].followedBy(_functionMatchers)) {
+ if (!matcher.matches(item, matchState)) {
+ addStateInfo(matchState, {'matcher': matcher});
+ return false;
+ }
+ }
+ return true;
+ }
+
+ @override
+ Description describeMismatch(Object? item, Description mismatchDescription,
+ Map matchState, bool verbose) {
+ var matcher = matchState['matcher'] as Matcher;
+ matcher.describeMismatch(
+ item, mismatchDescription, matchState['state'] as Map, verbose);
+ return mismatchDescription;
+ }
+
+ @override
+ Description describe(Description description) => description
+ .add('')
+ .addDescriptionOf(_parent)
+ .add(' with ')
+ .addAll('', ' and ', '', _functionMatchers);
+}
+
+class _FunctionMatcher<T> extends CustomMatcher {
+ final Object? Function(T value) _feature;
+
+ _FunctionMatcher(String name, this._feature, Object? matcher)
+ : super('`$name`:', '`$name`', matcher);
+
+ @override
+ Object? featureValueOf(covariant T actual) => _feature(actual);
+}
diff --git a/pkgs/matcher/lib/src/interfaces.dart b/pkgs/matcher/lib/src/interfaces.dart
new file mode 100644
index 0000000..24527f7
--- /dev/null
+++ b/pkgs/matcher/lib/src/interfaces.dart
@@ -0,0 +1,60 @@
+// Copyright (c) 2012, 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.
+
+/// Matchers build up their error messages by appending to Description objects.
+///
+/// This interface is implemented by StringDescription.
+///
+/// This interface is unlikely to need other implementations, but could be
+/// useful to replace in some cases - e.g. language conversion.
+abstract class Description {
+ int get length;
+
+ /// Change the value of the description.
+ Description replace(String text);
+
+ /// This is used to add arbitrary text to the description.
+ Description add(String text);
+
+ /// This is used to add a meaningful description of a value.
+ Description addDescriptionOf(Object? value);
+
+ /// This is used to add a description of an [Iterable] [list],
+ /// with appropriate [start] and [end] markers and inter-element [separator].
+ Description addAll(String start, String separator, String end, Iterable list);
+}
+
+/// The base class for all matchers.
+///
+/// [matches] and [describe] must be implemented by subclasses.
+///
+/// Subclasses can override [describeMismatch] if a more specific description is
+/// required when the matcher fails.
+abstract class Matcher {
+ const Matcher();
+
+ /// Does the matching of the actual vs expected values.
+ ///
+ /// [item] is the actual value. [matchState] can be supplied
+ /// and may be used to add details about the mismatch that are too
+ /// costly to determine in [describeMismatch].
+ bool matches(dynamic item, Map matchState);
+
+ /// Builds a textual description of the matcher.
+ Description describe(Description description);
+
+ /// Builds a textual description of a specific mismatch.
+ ///
+ /// [item] is the value that was tested by [matches]; [matchState] is
+ /// the [Map] that was passed to and supplemented by [matches]
+ /// with additional information about the mismatch, and [mismatchDescription]
+ /// is the [Description] that is being built to describe the mismatch.
+ ///
+ /// A few matchers make use of the [verbose] flag to provide detailed
+ /// information that is not typically included but can be of help in
+ /// diagnosing failures, such as stack traces.
+ Description describeMismatch(dynamic item, Description mismatchDescription,
+ Map matchState, bool verbose) =>
+ mismatchDescription;
+}
diff --git a/pkgs/matcher/lib/src/iterable_matchers.dart b/pkgs/matcher/lib/src/iterable_matchers.dart
new file mode 100644
index 0000000..abc9688
--- /dev/null
+++ b/pkgs/matcher/lib/src/iterable_matchers.dart
@@ -0,0 +1,416 @@
+// Copyright (c) 2012, 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 'description.dart';
+import 'equals_matcher.dart';
+import 'feature_matcher.dart';
+import 'interfaces.dart';
+import 'util.dart';
+
+/// Returns a matcher which matches [Iterable]s in which all elements
+/// match the given [valueOrMatcher].
+Matcher everyElement(Object? valueOrMatcher) =>
+ _EveryElement(wrapMatcher(valueOrMatcher));
+
+class _EveryElement extends _IterableMatcher {
+ final Matcher _matcher;
+
+ _EveryElement(this._matcher);
+
+ @override
+ bool typedMatches(Iterable item, Map matchState) {
+ var i = 0;
+ for (var element in item) {
+ if (!_matcher.matches(element, matchState)) {
+ addStateInfo(matchState, {'index': i, 'element': element});
+ return false;
+ }
+ ++i;
+ }
+ return true;
+ }
+
+ @override
+ Description describe(Description description) =>
+ description.add('every element(').addDescriptionOf(_matcher).add(')');
+
+ @override
+ Description describeTypedMismatch(dynamic item,
+ Description mismatchDescription, Map matchState, bool verbose) {
+ if (matchState['index'] != null) {
+ var index = matchState['index'];
+ var element = matchState['element'];
+ mismatchDescription
+ .add('has value ')
+ .addDescriptionOf(element)
+ .add(' which ');
+ var subDescription = StringDescription();
+ _matcher.describeMismatch(
+ element, subDescription, matchState['state'] as Map, verbose);
+ if (subDescription.length > 0) {
+ mismatchDescription.add(subDescription.toString());
+ } else {
+ mismatchDescription.add("doesn't match ");
+ _matcher.describe(mismatchDescription);
+ }
+ mismatchDescription.add(' at index $index');
+ return mismatchDescription;
+ }
+ return super
+ .describeMismatch(item, mismatchDescription, matchState, verbose);
+ }
+}
+
+/// Returns a matcher which matches [Iterable]s in which at least one
+/// element matches the given [valueOrMatcher].
+Matcher anyElement(Object? valueOrMatcher) =>
+ _AnyElement(wrapMatcher(valueOrMatcher));
+
+class _AnyElement extends _IterableMatcher {
+ final Matcher _matcher;
+
+ _AnyElement(this._matcher);
+
+ @override
+ bool typedMatches(Iterable item, Map matchState) =>
+ item.any((e) => _matcher.matches(e, matchState));
+
+ @override
+ Description describe(Description description) =>
+ description.add('some element ').addDescriptionOf(_matcher);
+}
+
+/// Returns a matcher which matches [Iterable]s that have the same
+/// length and the same elements as [expected], in the same order.
+///
+/// This is equivalent to [equals] but does not recurse.
+Matcher orderedEquals(Iterable expected) => _OrderedEquals(expected);
+
+class _OrderedEquals extends _IterableMatcher {
+ final Iterable _expected;
+ final Matcher _matcher;
+
+ _OrderedEquals(this._expected) : _matcher = equals(_expected, 1);
+
+ @override
+ bool typedMatches(Iterable item, Map matchState) =>
+ _matcher.matches(item, matchState);
+
+ @override
+ Description describe(Description description) =>
+ description.add('equals ').addDescriptionOf(_expected).add(' ordered');
+
+ @override
+ Description describeTypedMismatch(Iterable item,
+ Description mismatchDescription, Map matchState, bool verbose) {
+ return _matcher.describeMismatch(
+ item, mismatchDescription, matchState, verbose);
+ }
+}
+
+/// Returns a matcher which matches [Iterable]s that have the same length and
+/// the same elements as [expected], but not necessarily in the same order.
+///
+/// Note that this is worst case O(n^2) runtime and memory usage so it should
+/// only be used on small iterables.
+Matcher unorderedEquals(Iterable expected) => _UnorderedEquals(expected);
+
+class _UnorderedEquals extends _UnorderedMatches {
+ final List _expectedValues;
+
+ _UnorderedEquals(Iterable expected)
+ : _expectedValues = expected.toList(),
+ super(expected.map(equals));
+
+ @override
+ Description describe(Description description) => description
+ .add('equals ')
+ .addDescriptionOf(_expectedValues)
+ .add(' unordered');
+}
+
+/// Iterable matchers match against [Iterable]s. We add this intermediate
+/// class to give better mismatch error messages than the base Matcher class.
+abstract class _IterableMatcher extends FeatureMatcher<Iterable> {
+ const _IterableMatcher();
+}
+
+/// Returns a matcher which matches [Iterable]s whose elements match the
+/// matchers in [expected], but not necessarily in the same order.
+///
+/// Note that this is worst case O(n^2) runtime and memory usage so it should
+/// only be used on small iterables.
+Matcher unorderedMatches(Iterable expected) => _UnorderedMatches(expected);
+
+class _UnorderedMatches extends _IterableMatcher {
+ final List<Matcher> _expected;
+ final bool _allowUnmatchedValues;
+
+ _UnorderedMatches(Iterable expected, {bool allowUnmatchedValues = false})
+ : _expected = expected.map(wrapMatcher).toList(),
+ _allowUnmatchedValues = allowUnmatchedValues;
+
+ String? _test(List values) {
+ // Check the lengths are the same.
+ if (_expected.length > values.length) {
+ return 'has too few elements (${values.length} < ${_expected.length})';
+ } else if (!_allowUnmatchedValues && _expected.length < values.length) {
+ return 'has too many elements (${values.length} > ${_expected.length})';
+ }
+
+ var edges = List.generate(values.length, (_) => <int>[], growable: false);
+ for (var v = 0; v < values.length; v++) {
+ for (var m = 0; m < _expected.length; m++) {
+ if (_expected[m].matches(values[v], {})) {
+ edges[v].add(m);
+ }
+ }
+ }
+ // The index into `values` matched with each matcher or `null` if no value
+ // has been matched yet.
+ var matched = List<int?>.filled(_expected.length, null);
+ for (var valueIndex = 0; valueIndex < values.length; valueIndex++) {
+ _findPairing(edges, valueIndex, matched);
+ }
+ for (var matcherIndex = 0;
+ matcherIndex < _expected.length;
+ matcherIndex++) {
+ if (matched[matcherIndex] == null) {
+ final description = StringDescription()
+ .add('has no match for ')
+ .addDescriptionOf(_expected[matcherIndex])
+ .add(' at index $matcherIndex');
+ final remainingUnmatched =
+ matched.sublist(matcherIndex + 1).where((m) => m == null).length;
+ return remainingUnmatched == 0
+ ? description.toString()
+ : description
+ .add(' along with $remainingUnmatched other unmatched')
+ .toString();
+ }
+ }
+ return null;
+ }
+
+ @override
+ bool typedMatches(Iterable item, Map mismatchState) =>
+ _test(item.toList()) == null;
+
+ @override
+ Description describe(Description description) => description
+ .add('matches ')
+ .addAll('[', ', ', ']', _expected)
+ .add(' unordered');
+
+ @override
+ Description describeTypedMismatch(Iterable item,
+ Description mismatchDescription, Map matchState, bool verbose) =>
+ mismatchDescription.add(_test(item.toList())!);
+
+ /// Returns `true` if the value at [valueIndex] can be paired with some
+ /// unmatched matcher and updates the state of [matched].
+ ///
+ /// If there is a conflict where multiple values may match the same matcher
+ /// recursively looks for a new place to match the old value.
+ bool _findPairing(
+ List<List<int>> edges, int valueIndex, List<int?> matched) =>
+ _findPairingInner(edges, valueIndex, matched, <int>{});
+
+ /// Implementation of [_findPairing], tracks [reserved] which are the
+ /// matchers that have been used _during_ this search.
+ bool _findPairingInner(List<List<int>> edges, int valueIndex,
+ List<int?> matched, Set<int> reserved) {
+ final possiblePairings =
+ edges[valueIndex].where((m) => !reserved.contains(m));
+ for (final matcherIndex in possiblePairings) {
+ reserved.add(matcherIndex);
+ final previouslyMatched = matched[matcherIndex];
+ if (previouslyMatched == null ||
+ // If the matcher isn't already free, check whether the existing value
+ // occupying the matcher can be bumped to another one.
+ _findPairingInner(edges, matched[matcherIndex]!, matched, reserved)) {
+ matched[matcherIndex] = valueIndex;
+ return true;
+ }
+ }
+ return false;
+ }
+}
+
+/// A pairwise matcher for [Iterable]s.
+///
+/// The [comparator] function, taking an expected and an actual argument, and
+/// returning whether they match, will be applied to each pair in order.
+/// [description] should be a meaningful name for the comparator.
+Matcher pairwiseCompare<S, T>(Iterable<S> expected,
+ bool Function(S, T) comparator, String description) =>
+ _PairwiseCompare(expected, comparator, description);
+
+typedef _Comparator<S, T> = bool Function(S a, T b);
+
+class _PairwiseCompare<S, T> extends _IterableMatcher {
+ final Iterable<S> _expected;
+ final _Comparator<S, T> _comparator;
+ final String _description;
+
+ _PairwiseCompare(this._expected, this._comparator, this._description);
+
+ @override
+ bool typedMatches(Iterable item, Map matchState) {
+ if (item.length != _expected.length) return false;
+ var iterator = item.iterator;
+ var i = 0;
+ for (var e in _expected) {
+ iterator.moveNext();
+ if (!_comparator(e, iterator.current as T)) {
+ addStateInfo(matchState,
+ {'index': i, 'expected': e, 'actual': iterator.current});
+ return false;
+ }
+ i++;
+ }
+ return true;
+ }
+
+ @override
+ Description describe(Description description) =>
+ description.add('pairwise $_description ').addDescriptionOf(_expected);
+
+ @override
+ Description describeTypedMismatch(Iterable item,
+ Description mismatchDescription, Map matchState, bool verbose) {
+ if (item.length != _expected.length) {
+ return mismatchDescription
+ .add('has length ${item.length} instead of ${_expected.length}');
+ } else {
+ return mismatchDescription
+ .add('has ')
+ .addDescriptionOf(matchState['actual'])
+ .add(' which is not $_description ')
+ .addDescriptionOf(matchState['expected'])
+ .add(' at index ${matchState["index"]}');
+ }
+ }
+}
+
+/// Matches [Iterable]s which contain an element matching every value in
+/// [expected] in any order, and may contain additional values.
+///
+/// For example: `[0, 1, 0, 2, 0]` matches `containsAll([1, 2])` and
+/// `containsAll([2, 1])` but not `containsAll([1, 2, 3])`.
+///
+/// Will only match values which implement [Iterable].
+///
+/// Each element in the value will only be considered a match for a single
+/// matcher in [expected] even if it could satisfy more than one. For instance
+/// `containsAll([greaterThan(1), greaterThan(2)])` will not be satisfied by
+/// `[3]`. To check that all matchers are satisfied within an iterable and allow
+/// the same element to satisfy multiple matchers use
+/// `allOf(matchers.map(contains))`.
+///
+/// Note that this is worst case O(n^2) runtime and memory usage so it should
+/// only be used on small iterables.
+Matcher containsAll(Iterable expected) => _ContainsAll(expected);
+
+class _ContainsAll extends _UnorderedMatches {
+ final Iterable _unwrappedExpected;
+
+ _ContainsAll(Iterable expected)
+ : _unwrappedExpected = expected,
+ super(expected.map(wrapMatcher), allowUnmatchedValues: true);
+ @override
+ Description describe(Description description) =>
+ description.add('contains all of ').addDescriptionOf(_unwrappedExpected);
+}
+
+/// Matches [Iterable]s which contain an element matching every value in
+/// [expected] in the same order, but may contain additional values interleaved
+/// throughout.
+///
+/// For example: `[0, 1, 0, 2, 0]` matches `containsAllInOrder([1, 2])` but not
+/// `containsAllInOrder([2, 1])` or `containsAllInOrder([1, 2, 3])`.
+///
+/// Will only match values which implement [Iterable].
+Matcher containsAllInOrder(Iterable expected) => _ContainsAllInOrder(expected);
+
+class _ContainsAllInOrder extends _IterableMatcher {
+ final Iterable _expected;
+
+ _ContainsAllInOrder(this._expected);
+
+ String? _test(Iterable item, Map matchState) {
+ var matchers = _expected.map(wrapMatcher).toList();
+ var matcherIndex = 0;
+ for (var value in item) {
+ if (matchers[matcherIndex].matches(value, matchState)) matcherIndex++;
+ if (matcherIndex == matchers.length) return null;
+ }
+ return StringDescription()
+ .add('did not find a value matching ')
+ .addDescriptionOf(matchers[matcherIndex])
+ .add(' following expected prior values')
+ .toString();
+ }
+
+ @override
+ bool typedMatches(Iterable item, Map matchState) =>
+ _test(item, matchState) == null;
+
+ @override
+ Description describe(Description description) => description
+ .add('contains in order(')
+ .addDescriptionOf(_expected)
+ .add(')');
+
+ @override
+ Description describeTypedMismatch(Iterable item,
+ Description mismatchDescription, Map matchState, bool verbose) =>
+ mismatchDescription.add(_test(item, matchState)!);
+}
+
+/// Matches [Iterable]s where exactly one element matches the expected
+/// value, and all other elements don't match.
+Matcher containsOnce(Object? expected) => _ContainsOnce(expected);
+
+class _ContainsOnce extends _IterableMatcher {
+ final Object? _expected;
+
+ _ContainsOnce(this._expected);
+
+ String? _test(Iterable item, Map matchState) {
+ var matcher = wrapMatcher(_expected);
+ var matches = [
+ for (var value in item)
+ if (matcher.matches(value, matchState)) value,
+ ];
+ if (matches.length == 1) {
+ return null;
+ }
+ if (matches.isEmpty) {
+ return StringDescription()
+ .add('did not find a value matching ')
+ .addDescriptionOf(matcher)
+ .toString();
+ }
+ return StringDescription()
+ .add('expected only one value matching ')
+ .addDescriptionOf(matcher)
+ .add(' but found multiple: ')
+ .addAll('', ', ', '', matches)
+ .toString();
+ }
+
+ @override
+ bool typedMatches(Iterable item, Map matchState) =>
+ _test(item, matchState) == null;
+
+ @override
+ Description describe(Description description) =>
+ description.add('contains once(').addDescriptionOf(_expected).add(')');
+
+ @override
+ Description describeTypedMismatch(Iterable item,
+ Description mismatchDescription, Map matchState, bool verbose) =>
+ mismatchDescription.add(_test(item, matchState)!);
+}
diff --git a/pkgs/matcher/lib/src/map_matchers.dart b/pkgs/matcher/lib/src/map_matchers.dart
new file mode 100644
index 0000000..4476d06
--- /dev/null
+++ b/pkgs/matcher/lib/src/map_matchers.dart
@@ -0,0 +1,69 @@
+// Copyright (c) 2012, 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 'interfaces.dart';
+import 'util.dart';
+
+/// Returns a matcher which matches maps containing the given [value].
+Matcher containsValue(Object? value) => _ContainsValue(value);
+
+class _ContainsValue extends Matcher {
+ final Object? _value;
+
+ const _ContainsValue(this._value);
+
+ @override
+ bool matches(Object? item, Map matchState) =>
+ // ignore: avoid_dynamic_calls
+ (item as dynamic).containsValue(_value);
+ @override
+ Description describe(Description description) =>
+ description.add('contains value ').addDescriptionOf(_value);
+}
+
+/// Returns a matcher which matches maps containing the key-value pair
+/// with [key] => [valueOrMatcher].
+Matcher containsPair(Object? key, Object? valueOrMatcher) =>
+ _ContainsMapping(key, wrapMatcher(valueOrMatcher));
+
+class _ContainsMapping extends Matcher {
+ final Object? _key;
+ final Matcher _valueMatcher;
+
+ const _ContainsMapping(this._key, this._valueMatcher);
+
+ @override
+ bool matches(Object? item, Map matchState) =>
+ // ignore: avoid_dynamic_calls
+ (item as dynamic).containsKey(_key) &&
+ _valueMatcher.matches((item as dynamic)[_key], matchState);
+
+ @override
+ Description describe(Description description) {
+ return description
+ .add('contains pair ')
+ .addDescriptionOf(_key)
+ .add(' => ')
+ .addDescriptionOf(_valueMatcher);
+ }
+
+ @override
+ Description describeMismatch(Object? item, Description mismatchDescription,
+ Map matchState, bool verbose) {
+ // ignore: avoid_dynamic_calls
+ if (!((item as dynamic).containsKey(_key) as bool)) {
+ return mismatchDescription
+ .add(" doesn't contain key ")
+ .addDescriptionOf(_key);
+ } else {
+ mismatchDescription
+ .add(' contains key ')
+ .addDescriptionOf(_key)
+ .add(' but with value ');
+ _valueMatcher.describeMismatch(
+ (item as dynamic)[_key], mismatchDescription, matchState, verbose);
+ return mismatchDescription;
+ }
+ }
+}
diff --git a/pkgs/matcher/lib/src/numeric_matchers.dart b/pkgs/matcher/lib/src/numeric_matchers.dart
new file mode 100644
index 0000000..a798160
--- /dev/null
+++ b/pkgs/matcher/lib/src/numeric_matchers.dart
@@ -0,0 +1,89 @@
+// Copyright (c) 2012, 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 'feature_matcher.dart';
+import 'interfaces.dart';
+
+/// Returns a matcher which matches if the match argument is within [delta]
+/// of some [value].
+///
+/// In other words, this matches if the match argument is greater than
+/// than or equal [value]-[delta] and less than or equal to [value]+[delta].
+Matcher closeTo(num value, num delta) => _IsCloseTo(value, delta);
+
+class _IsCloseTo extends FeatureMatcher<num> {
+ final num _value, _delta;
+
+ const _IsCloseTo(this._value, this._delta);
+
+ @override
+ bool typedMatches(num item, Map matchState) {
+ var diff = item - _value;
+ if (diff < 0) diff = -diff;
+ return diff <= _delta;
+ }
+
+ @override
+ Description describe(Description description) => description
+ .add('a numeric value within ')
+ .addDescriptionOf(_delta)
+ .add(' of ')
+ .addDescriptionOf(_value);
+
+ @override
+ Description describeTypedMismatch(
+ num item, Description mismatchDescription, Map matchState, bool verbose) {
+ var diff = item - _value;
+ if (diff < 0) diff = -diff;
+ return mismatchDescription.add(' differs by ').addDescriptionOf(diff);
+ }
+}
+
+/// Returns a matcher which matches if the match argument is greater
+/// than or equal to [low] and less than or equal to [high].
+Matcher inInclusiveRange(num low, num high) => _InRange(low, high, true, true);
+
+/// Returns a matcher which matches if the match argument is greater
+/// than [low] and less than [high].
+Matcher inExclusiveRange(num low, num high) =>
+ _InRange(low, high, false, false);
+
+/// Returns a matcher which matches if the match argument is greater
+/// than [low] and less than or equal to [high].
+Matcher inOpenClosedRange(num low, num high) =>
+ _InRange(low, high, false, true);
+
+/// Returns a matcher which matches if the match argument is greater
+/// than or equal to a [low] and less than [high].
+Matcher inClosedOpenRange(num low, num high) =>
+ _InRange(low, high, true, false);
+
+class _InRange extends FeatureMatcher<num> {
+ final num _low, _high;
+ final bool _lowMatchValue, _highMatchValue;
+
+ const _InRange(
+ this._low, this._high, this._lowMatchValue, this._highMatchValue);
+
+ @override
+ bool typedMatches(num value, Map matchState) {
+ if (value < _low || value > _high) {
+ return false;
+ }
+ if (value == _low) {
+ return _lowMatchValue;
+ }
+ if (value == _high) {
+ return _highMatchValue;
+ }
+ // Value may still be outside if range if it can't be compared.
+ return value > _low && value < _high;
+ }
+
+ @override
+ Description describe(Description description) =>
+ description.add('be in range from '
+ "$_low (${_lowMatchValue ? 'inclusive' : 'exclusive'}) to "
+ "$_high (${_highMatchValue ? 'inclusive' : 'exclusive'})");
+}
diff --git a/pkgs/matcher/lib/src/operator_matchers.dart b/pkgs/matcher/lib/src/operator_matchers.dart
new file mode 100644
index 0000000..15e50ff
--- /dev/null
+++ b/pkgs/matcher/lib/src/operator_matchers.dart
@@ -0,0 +1,131 @@
+// Copyright (c) 2012, 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 'interfaces.dart';
+import 'util.dart';
+
+/// Returns a matcher that inverts [valueOrMatcher] to its logical negation.
+Matcher isNot(Object? valueOrMatcher) => _IsNot(wrapMatcher(valueOrMatcher));
+
+class _IsNot extends Matcher {
+ final Matcher _matcher;
+
+ const _IsNot(this._matcher);
+
+ @override
+ bool matches(dynamic item, Map matchState) =>
+ !_matcher.matches(item, matchState);
+
+ @override
+ Description describe(Description description) =>
+ description.add('not ').addDescriptionOf(_matcher);
+}
+
+/// This returns a matcher that matches if all of the matchers passed as
+/// arguments (up to 7) match.
+///
+/// Instead of passing the matchers separately they can be passed as a single
+/// List argument. Any argument that is not a matcher is implicitly wrapped in a
+/// Matcher to check for equality.
+Matcher allOf(Object? arg0,
+ [Object? arg1,
+ Object? arg2,
+ Object? arg3,
+ Object? arg4,
+ Object? arg5,
+ Object? arg6]) {
+ return _AllOf(_wrapArgs(arg0, arg1, arg2, arg3, arg4, arg5, arg6));
+}
+
+class _AllOf extends Matcher {
+ final List<Matcher> _matchers;
+
+ const _AllOf(this._matchers);
+
+ @override
+ bool matches(dynamic item, Map matchState) {
+ for (var matcher in _matchers) {
+ if (!matcher.matches(item, matchState)) {
+ addStateInfo(matchState, {'matcher': matcher});
+ return false;
+ }
+ }
+ return true;
+ }
+
+ @override
+ Description describeMismatch(dynamic item, Description mismatchDescription,
+ Map matchState, bool verbose) {
+ var matcher = matchState['matcher'] as Matcher;
+ matcher.describeMismatch(
+ item, mismatchDescription, matchState['state'], verbose);
+ return mismatchDescription;
+ }
+
+ @override
+ Description describe(Description description) =>
+ description.addAll('(', ' and ', ')', _matchers);
+}
+
+/// Matches if any of the given matchers evaluate to true.
+///
+/// The arguments can be a set of matchers as separate parameters
+/// (up to 7), or a List of matchers.
+///
+/// The matchers are evaluated from left to right using short-circuit
+/// evaluation, so evaluation stops as soon as a matcher returns true.
+///
+/// Any argument that is not a matcher is implicitly wrapped in a
+/// Matcher to check for equality.
+Matcher anyOf(Object? arg0,
+ [Object? arg1,
+ Object? arg2,
+ Object? arg3,
+ Object? arg4,
+ Object? arg5,
+ Object? arg6]) {
+ return _AnyOf(_wrapArgs(arg0, arg1, arg2, arg3, arg4, arg5, arg6));
+}
+
+class _AnyOf extends Matcher {
+ final List<Matcher> _matchers;
+
+ const _AnyOf(this._matchers);
+
+ @override
+ bool matches(dynamic item, Map matchState) {
+ for (var matcher in _matchers) {
+ if (matcher.matches(item, matchState)) {
+ return true;
+ }
+ }
+ return false;
+ }
+
+ @override
+ Description describe(Description description) =>
+ description.addAll('(', ' or ', ')', _matchers);
+}
+
+List<Matcher> _wrapArgs(Object? arg0, Object? arg1, Object? arg2, Object? arg3,
+ Object? arg4, Object? arg5, Object? arg6) {
+ Iterable args;
+ if (arg0 is List) {
+ if (arg1 != null ||
+ arg2 != null ||
+ arg3 != null ||
+ arg4 != null ||
+ arg5 != null ||
+ arg6 != null) {
+ throw ArgumentError('If arg0 is a List, all other arguments must be'
+ ' null.');
+ }
+
+ args = arg0;
+ } else {
+ args = [arg0, arg1, arg2, arg3, arg4, arg5, arg6].where((e) => e != null);
+ }
+
+ return args.map(wrapMatcher).toList();
+}
diff --git a/pkgs/matcher/lib/src/order_matchers.dart b/pkgs/matcher/lib/src/order_matchers.dart
new file mode 100644
index 0000000..6fe7c76
--- /dev/null
+++ b/pkgs/matcher/lib/src/order_matchers.dart
@@ -0,0 +1,108 @@
+// Copyright (c) 2016, 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 'interfaces.dart';
+
+/// Returns a matcher which matches if the match argument is greater
+/// than the given [value].
+Matcher greaterThan(Object value) =>
+ _OrderingMatcher(value, false, false, true, 'a value greater than');
+
+/// Returns a matcher which matches if the match argument is greater
+/// than or equal to the given [value].
+Matcher greaterThanOrEqualTo(Object value) => _OrderingMatcher(
+ value, true, false, true, 'a value greater than or equal to');
+
+/// Returns a matcher which matches if the match argument is less
+/// than the given [value].
+Matcher lessThan(Object value) =>
+ _OrderingMatcher(value, false, true, false, 'a value less than');
+
+/// Returns a matcher which matches if the match argument is less
+/// than or equal to the given [value].
+Matcher lessThanOrEqualTo(Object value) =>
+ _OrderingMatcher(value, true, true, false, 'a value less than or equal to');
+
+/// A matcher which matches if the match argument is zero.
+const Matcher isZero =
+ _OrderingMatcher(0, true, false, false, 'a value equal to');
+
+/// A matcher which matches if the match argument is non-zero.
+const Matcher isNonZero =
+ _OrderingMatcher(0, false, true, true, 'a value not equal to');
+
+/// A matcher which matches if the match argument is positive.
+const Matcher isPositive =
+ _OrderingMatcher(0, false, false, true, 'a positive value', false);
+
+/// A matcher which matches if the match argument is zero or negative.
+const Matcher isNonPositive =
+ _OrderingMatcher(0, true, true, false, 'a non-positive value', false);
+
+/// A matcher which matches if the match argument is negative.
+const Matcher isNegative =
+ _OrderingMatcher(0, false, true, false, 'a negative value', false);
+
+/// A matcher which matches if the match argument is zero or positive.
+const Matcher isNonNegative =
+ _OrderingMatcher(0, true, false, true, 'a non-negative value', false);
+
+// TODO(kevmoo) Note that matchers that use _OrderingComparison only use
+// `==` and `<` operators to evaluate the match. Or change the matcher.
+class _OrderingMatcher extends Matcher {
+ /// Expected value.
+ final Object _value;
+
+ /// What to return if actual == expected
+ final bool _equalValue;
+
+ /// What to return if actual < expected
+ final bool _lessThanValue;
+
+ /// What to return if actual > expected
+ final bool _greaterThanValue;
+
+ /// Textual name of the inequality
+ final String _comparisonDescription;
+
+ /// Whether to include the expected value in the description
+ final bool _valueInDescription;
+
+ const _OrderingMatcher(this._value, this._equalValue, this._lessThanValue,
+ this._greaterThanValue, this._comparisonDescription,
+ [bool valueInDescription = true])
+ : _valueInDescription = valueInDescription;
+
+ @override
+ bool matches(Object? item, Map matchState) {
+ if (item == _value) {
+ return _equalValue;
+ } else if ((item as dynamic) < _value) {
+ return _lessThanValue;
+ } else if ((item as dynamic) > _value) {
+ return _greaterThanValue;
+ } else {
+ return false;
+ }
+ }
+
+ @override
+ Description describe(Description description) {
+ if (_valueInDescription) {
+ return description
+ .add(_comparisonDescription)
+ .add(' ')
+ .addDescriptionOf(_value);
+ } else {
+ return description.add(_comparisonDescription);
+ }
+ }
+
+ @override
+ Description describeMismatch(dynamic item, Description mismatchDescription,
+ Map matchState, bool verbose) {
+ mismatchDescription.add('is not ');
+ return describe(mismatchDescription);
+ }
+}
diff --git a/pkgs/matcher/lib/src/pretty_print.dart b/pkgs/matcher/lib/src/pretty_print.dart
new file mode 100644
index 0000000..d9eaaec
--- /dev/null
+++ b/pkgs/matcher/lib/src/pretty_print.dart
@@ -0,0 +1,133 @@
+// Copyright (c) 2013, 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 'description.dart';
+import 'interfaces.dart';
+import 'util.dart';
+
+/// Returns a pretty-printed representation of [object].
+///
+/// If [maxLineLength] is passed, this will attempt to ensure that each line is
+/// no longer than [maxLineLength] characters long. This isn't guaranteed, since
+/// individual objects may have string representations that are too long, but
+/// most lines will be less than [maxLineLength] long.
+///
+/// If [maxItems] is passed, [Iterable]s and [Map]s will only print their first
+/// [maxItems] members or key/value pairs, respectively.
+String prettyPrint(Object? object, {int? maxLineLength, int? maxItems}) {
+ String prettyPrintImpl(
+ Object? object, int indent, Set<Object?> seen, bool top) {
+ // If the object is a matcher, use its description.
+ if (object is Matcher) {
+ var description = StringDescription();
+ object.describe(description);
+ return '<$description>';
+ }
+
+ // Avoid looping infinitely on recursively-nested data structures.
+ if (seen.contains(object)) return '(recursive)';
+ seen = seen.union({object});
+ String pp(Object? child) => prettyPrintImpl(child, indent + 2, seen, false);
+
+ if (object is Iterable) {
+ // Print the type name for non-List iterables.
+ var type = object is List ? '' : '${_typeName(object)}:';
+
+ // Truncate the list of strings if it's longer than [maxItems].
+ var strings = object.map(pp).toList();
+ if (maxItems != null && strings.length > maxItems) {
+ strings.replaceRange(maxItems - 1, strings.length, ['...']);
+ }
+
+ // If the printed string is short and doesn't contain a newline, print it
+ // as a single line.
+ var singleLine = "$type[${strings.join(', ')}]";
+ if ((maxLineLength == null ||
+ singleLine.length + indent <= maxLineLength) &&
+ !singleLine.contains('\n')) {
+ return singleLine;
+ }
+
+ // Otherwise, print each member on its own line.
+ return '$type[\n${strings.map((string) {
+ return _indent(indent + 2) + string;
+ }).join(',\n')}\n${_indent(indent)}]';
+ } else if (object is Map) {
+ // Convert the contents of the map to string representations.
+ var strings = object.keys.map((key) {
+ return '${pp(key)}: ${pp(object[key])}';
+ }).toList();
+
+ // Truncate the list of strings if it's longer than [maxItems].
+ if (maxItems != null && strings.length > maxItems) {
+ strings.replaceRange(maxItems - 1, strings.length, ['...']);
+ }
+
+ // If the printed string is short and doesn't contain a newline, print it
+ // as a single line.
+ var singleLine = '{${strings.join(", ")}}';
+ if ((maxLineLength == null ||
+ singleLine.length + indent <= maxLineLength) &&
+ !singleLine.contains('\n')) {
+ return singleLine;
+ }
+
+ // Otherwise, print each key/value pair on its own line.
+ return '{\n${strings.map((string) {
+ return _indent(indent + 2) + string;
+ }).join(',\n')}\n${_indent(indent)}}';
+ } else if (object is String) {
+ // Escape strings and print each line on its own line.
+ var value = object
+ .split('\n')
+ .map(_escapeString)
+ .join("\\n'\n${_indent(indent + 2)}'");
+ return "'$value'";
+ } else {
+ var value = object.toString().replaceAll('\n', '${_indent(indent)}\n');
+ var defaultToString = value.startsWith('Instance of ');
+
+ // If this is the top-level call to [prettyPrint], wrap the value on angle
+ // brackets to set it apart visually.
+ if (top) value = '<$value>';
+
+ // Print the type of objects with custom [toString] methods. Primitive
+ // objects and objects that don't implement a custom [toString] don't need
+ // to have their types printed.
+ if (object is num ||
+ object is bool ||
+ object is Function ||
+ object is RegExp ||
+ object is MapEntry ||
+ object is Expando ||
+ object == null ||
+ defaultToString) {
+ return value;
+ } else {
+ return '${_typeName(object)}:$value';
+ }
+ }
+ }
+
+ return prettyPrintImpl(object, 0, <Object?>{}, true);
+}
+
+String _indent(int length) => List.filled(length, ' ').join('');
+
+/// Returns the name of the type of [x] with fallbacks for core types with
+/// private implementations.
+String _typeName(Object x) {
+ if (x is Type) return 'Type';
+ if (x is Uri) return 'Uri';
+ if (x is Set) return 'Set';
+ if (x is BigInt) return 'BigInt';
+ return '${x.runtimeType}';
+}
+
+/// Returns [source] with any control characters replaced by their escape
+/// sequences.
+///
+/// This doesn't add quotes to the string, but it does escape single quote
+/// characters so that single quotes can be applied externally.
+String _escapeString(String source) => escape(source).replaceAll("'", r"\'");
diff --git a/pkgs/matcher/lib/src/string_matchers.dart b/pkgs/matcher/lib/src/string_matchers.dart
new file mode 100644
index 0000000..b819fa5
--- /dev/null
+++ b/pkgs/matcher/lib/src/string_matchers.dart
@@ -0,0 +1,183 @@
+// Copyright (c) 2012, 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 'feature_matcher.dart';
+import 'interfaces.dart';
+
+/// Returns a matcher which matches if the match argument is a string and
+/// is equal to [value] when compared case-insensitively.
+Matcher equalsIgnoringCase(String value) => _IsEqualIgnoringCase(value);
+
+class _IsEqualIgnoringCase extends FeatureMatcher<String> {
+ final String _value;
+ final String _matchValue;
+
+ _IsEqualIgnoringCase(String value)
+ : _value = value,
+ _matchValue = value.toLowerCase();
+
+ @override
+ bool typedMatches(String item, Map matchState) =>
+ _matchValue == item.toLowerCase();
+
+ @override
+ Description describe(Description description) =>
+ description.addDescriptionOf(_value).add(' ignoring case');
+}
+
+/// Returns a matcher which matches if the match argument is a string and
+/// is equal to [value], ignoring whitespace.
+///
+/// In this matcher, "ignoring whitespace" means comparing with all runs of
+/// whitespace collapsed to single space characters and leading and trailing
+/// whitespace removed.
+///
+/// For example, the following will all match successfully:
+///
+/// expect("hello world", equalsIgnoringWhitespace("hello world"));
+/// expect(" hello world", equalsIgnoringWhitespace("hello world"));
+/// expect("hello world ", equalsIgnoringWhitespace("hello world"));
+///
+/// The following will not match:
+///
+/// expect("helloworld", equalsIgnoringWhitespace("hello world"));
+/// expect("he llo world", equalsIgnoringWhitespace("hello world"));
+Matcher equalsIgnoringWhitespace(String value) =>
+ _IsEqualIgnoringWhitespace(value);
+
+class _IsEqualIgnoringWhitespace extends FeatureMatcher<String> {
+ final String _matchValue;
+
+ _IsEqualIgnoringWhitespace(String value)
+ : _matchValue = collapseWhitespace(value);
+
+ @override
+ bool typedMatches(String item, Map matchState) =>
+ _matchValue == collapseWhitespace(item);
+
+ @override
+ Description describe(Description description) =>
+ description.addDescriptionOf(_matchValue).add(' ignoring whitespace');
+
+ @override
+ Description describeTypedMismatch(dynamic item,
+ Description mismatchDescription, Map matchState, bool verbose) {
+ return mismatchDescription
+ .add('is ')
+ .addDescriptionOf(collapseWhitespace(item))
+ .add(' with whitespace compressed');
+ }
+}
+
+/// Returns a matcher that matches if the match argument is a string and
+/// starts with [prefixString].
+Matcher startsWith(String prefixString) => _StringStartsWith(prefixString);
+
+class _StringStartsWith extends FeatureMatcher<String> {
+ final String _prefix;
+
+ const _StringStartsWith(this._prefix);
+
+ @override
+ bool typedMatches(String item, Map matchState) => item.startsWith(_prefix);
+
+ @override
+ Description describe(Description description) =>
+ description.add('a string starting with ').addDescriptionOf(_prefix);
+}
+
+/// Returns a matcher that matches if the match argument is a string and
+/// ends with [suffixString].
+Matcher endsWith(String suffixString) => _StringEndsWith(suffixString);
+
+class _StringEndsWith extends FeatureMatcher<String> {
+ final String _suffix;
+
+ const _StringEndsWith(this._suffix);
+
+ @override
+ bool typedMatches(String item, Map matchState) => item.endsWith(_suffix);
+
+ @override
+ Description describe(Description description) =>
+ description.add('a string ending with ').addDescriptionOf(_suffix);
+}
+
+/// Returns a matcher that matches if the match argument is a string and
+/// contains a given list of [substrings] in relative order.
+///
+/// For example, `stringContainsInOrder(["a", "e", "i", "o", "u"])` will match
+/// "abcdefghijklmnopqrstuvwxyz".
+
+Matcher stringContainsInOrder(List<String> substrings) =>
+ _StringContainsInOrder(substrings);
+
+class _StringContainsInOrder extends FeatureMatcher<String> {
+ final List<String> _substrings;
+
+ const _StringContainsInOrder(this._substrings);
+
+ @override
+ bool typedMatches(String item, Map matchState) {
+ var fromIndex = 0;
+ for (var s in _substrings) {
+ var index = item.indexOf(s, fromIndex);
+ if (index < 0) return false;
+ fromIndex = index + s.length;
+ }
+ return true;
+ }
+
+ @override
+ Description describe(Description description) => description.addAll(
+ 'a string containing ', ', ', ' in order', _substrings);
+}
+
+/// Returns a matcher that matches if the match argument is a string and
+/// matches the regular expression given by [re].
+///
+/// [re] can be a [RegExp] instance or a [String]; in the latter case it will be
+/// used to create a RegExp instance.
+Matcher matches(Pattern re) => _MatchesRegExp(re);
+
+class _MatchesRegExp extends FeatureMatcher<String> {
+ final RegExp _regexp;
+
+ _MatchesRegExp(Pattern re)
+ : _regexp = (re is String)
+ ? RegExp(re)
+ : (re is RegExp)
+ ? re
+ : throw ArgumentError('matches requires a regexp or string');
+
+ @override
+ bool typedMatches(dynamic item, Map matchState) => _regexp.hasMatch(item);
+
+ @override
+ Description describe(Description description) =>
+ description.add("match '${_regexp.pattern}'");
+}
+
+/// Utility function to collapse whitespace runs to single spaces
+/// and strip leading/trailing whitespace.
+String collapseWhitespace(String string) {
+ var result = StringBuffer();
+ var skipSpace = true;
+ for (var i = 0; i < string.length; i++) {
+ var character = string[i];
+ if (_isWhitespace(character)) {
+ if (!skipSpace) {
+ result.write(' ');
+ skipSpace = true;
+ }
+ } else {
+ result.write(character);
+ skipSpace = false;
+ }
+ }
+ return result.toString().trim();
+}
+
+bool _isWhitespace(String ch) =>
+ ch == ' ' || ch == '\n' || ch == '\r' || ch == '\t';
diff --git a/pkgs/matcher/lib/src/type_matcher.dart b/pkgs/matcher/lib/src/type_matcher.dart
new file mode 100644
index 0000000..9d32b9f
--- /dev/null
+++ b/pkgs/matcher/lib/src/type_matcher.dart
@@ -0,0 +1,115 @@
+// Copyright (c) 2018, 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 'package:meta/meta.dart';
+
+import 'having_matcher.dart';
+import 'interfaces.dart';
+
+/// Returns a matcher that matches objects with type [T].
+///
+/// ```dart
+/// expect(shouldBeDuration, isA<Duration>());
+/// ```
+///
+/// Expectations can be chained on top of the type using the
+/// [TypeMatcher.having] method to add additional constraints.
+TypeMatcher<T> isA<T>() => TypeMatcher<T>();
+
+/// A [Matcher] subclass that supports validating the [Type] of the target
+/// object.
+///
+/// ```dart
+/// expect(shouldBeDuration, TypeMatcher<Duration>());
+/// ```
+///
+/// If you want to further validate attributes of the specified [Type], use the
+/// [having] function.
+///
+/// ```dart
+/// void shouldThrowRangeError(int value) {
+/// throw RangeError.range(value, 10, 20);
+/// }
+///
+/// expect(
+/// () => shouldThrowRangeError(5),
+/// throwsA(const TypeMatcher<RangeError>()
+/// .having((e) => e.start, 'start', greaterThanOrEqualTo(10))
+/// .having((e) => e.end, 'end', lessThanOrEqualTo(20))));
+/// ```
+///
+/// Notice that you can chain multiple calls to [having] to verify multiple
+/// aspects of an object.
+///
+/// Note: All of the top-level `isType` matchers exposed by this package are
+/// instances of [TypeMatcher], so you can use the [having] function without
+/// creating your own instance.
+///
+/// ```dart
+/// expect(
+/// () => shouldThrowRangeError(5),
+/// throwsA(isRangeError
+/// .having((e) => e.start, 'start', greaterThanOrEqualTo(10))
+/// .having((e) => e.end, 'end', lessThanOrEqualTo(20))));
+/// ```
+class TypeMatcher<T> extends Matcher {
+ final String? _name;
+
+ /// Create a matcher matches instances of type [T].
+ ///
+ /// For a fluent API to create TypeMatchers see [isA].
+ const TypeMatcher(
+ [@Deprecated('Provide a type argument to TypeMatcher and omit the name. '
+ 'This argument will be removed in the next release.')
+ String? name])
+ : _name =
+ // ignore: deprecated_member_use_from_same_package
+ name;
+
+ /// Returns a new [TypeMatcher] that validates the existing type as well as
+ /// a specific [feature] of the object with the provided [matcher].
+ ///
+ /// Provides a human-readable [description] of the [feature] to make debugging
+ /// failures easier.
+ ///
+ /// ```dart
+ /// /// Validates that the object is a [RangeError] with a message containing
+ /// /// the string 'details' and `start` and `end` properties that are `null`.
+ /// final _rangeMatcher = isRangeError
+ /// .having((e) => e.message, 'message', contains('details'))
+ /// .having((e) => e.start, 'start', isNull)
+ /// .having((e) => e.end, 'end', isNull);
+ /// ```
+ @useResult
+ TypeMatcher<T> having(
+ Object? Function(T) feature, String description, dynamic matcher) =>
+ HavingMatcher(this, description, feature, matcher);
+
+ @override
+ Description describe(Description description) {
+ var name = _name ?? _stripDynamic(T);
+ return description.add("<Instance of '$name'>");
+ }
+
+ @override
+ bool matches(Object? item, Map matchState) => item is T;
+
+ @override
+ Description describeMismatch(dynamic item, Description mismatchDescription,
+ Map matchState, bool verbose) {
+ var name = _name ?? _stripDynamic(T);
+ return mismatchDescription.add("is not an instance of '$name'");
+ }
+}
+
+final _dart2DynamicArgs = RegExp('<dynamic(, dynamic)*>');
+
+/// With this expression `{}.runtimeType.toString`,
+/// Dart 1: "`<Instance of Map>`"
+/// Dart 2: "`<Instance of Map<dynamic, dynamic>>`"
+///
+/// This functions returns the Dart 1 output, when Dart 2 runtime semantics
+/// are enabled.
+String _stripDynamic(Type type) =>
+ type.toString().replaceAll(_dart2DynamicArgs, '');
diff --git a/pkgs/matcher/lib/src/util.dart b/pkgs/matcher/lib/src/util.dart
new file mode 100644
index 0000000..af0ba2c
--- /dev/null
+++ b/pkgs/matcher/lib/src/util.dart
@@ -0,0 +1,70 @@
+// Copyright (c) 2014, 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 'core_matchers.dart';
+import 'equals_matcher.dart';
+import 'interfaces.dart';
+
+/// A [Map] between whitespace characters and their escape sequences.
+const _escapeMap = {
+ '\n': r'\n',
+ '\r': r'\r',
+ '\f': r'\f',
+ '\b': r'\b',
+ '\t': r'\t',
+ '\v': r'\v',
+ '\x7F': r'\x7F', // delete
+};
+
+/// A [RegExp] that matches whitespace characters that should be escaped.
+final _escapeRegExp = RegExp(
+ '[\\x00-\\x07\\x0E-\\x1F${_escapeMap.keys.map(_getHexLiteral).join()}]');
+
+/// Useful utility for nesting match states.
+void addStateInfo(Map matchState, Map values) {
+ var innerState = Map.of(matchState);
+ matchState.clear();
+ matchState['state'] = innerState;
+ matchState.addAll(values);
+}
+
+/// Takes an argument and returns an equivalent [Matcher].
+///
+/// If the argument is already a matcher this does nothing,
+/// else if the argument is a function, it generates a predicate
+/// function matcher, else it generates an equals matcher.
+Matcher wrapMatcher(Object? valueOrMatcher) {
+ if (valueOrMatcher is Matcher) {
+ return valueOrMatcher;
+ } else if (valueOrMatcher is bool Function(Object?)) {
+ // already a predicate that can handle anything
+ return predicate(valueOrMatcher);
+ } else if (valueOrMatcher is bool Function(Never)) {
+ // unary predicate, but expects a specific type
+ // so wrap it.
+ // ignore: unnecessary_lambdas
+ return predicate((a) => (valueOrMatcher as dynamic)(a));
+ } else {
+ return equals(valueOrMatcher);
+ }
+}
+
+/// Returns [str] with all whitespace characters represented as their escape
+/// sequences.
+///
+/// Backslash characters are escaped as `\\`
+String escape(String str) {
+ str = str.replaceAll('\\', r'\\');
+ return str.replaceAllMapped(_escapeRegExp, (match) {
+ var mapped = _escapeMap[match[0]];
+ if (mapped != null) return mapped;
+ return _getHexLiteral(match[0]!);
+ });
+}
+
+/// Given single-character string, return the hex-escaped equivalent.
+String _getHexLiteral(String input) {
+ var rune = input.runes.single;
+ return r'\x' + rune.toRadixString(16).toUpperCase().padLeft(2, '0');
+}
diff --git a/pkgs/matcher/mono_pkg.yaml b/pkgs/matcher/mono_pkg.yaml
new file mode 100644
index 0000000..9ef7927
--- /dev/null
+++ b/pkgs/matcher/mono_pkg.yaml
@@ -0,0 +1,17 @@
+# See https://pub.dev/packages/mono_repo
+
+sdk:
+- dev
+
+stages:
+- analyze_and_format:
+ - group:
+ - format
+ - analyze: --fatal-infos
+ - group:
+ - analyze
+ sdk: pubspec
+- unit_test:
+ - group:
+ - command: dart test
+ sdk: [dev, pubspec]
diff --git a/pkgs/matcher/pubspec.yaml b/pkgs/matcher/pubspec.yaml
new file mode 100644
index 0000000..237e559
--- /dev/null
+++ b/pkgs/matcher/pubspec.yaml
@@ -0,0 +1,25 @@
+name: matcher
+version: 0.12.18-wip
+description: >-
+ Support for specifying test expectations via an extensible Matcher class.
+ Also includes a number of built-in Matcher implementations for common cases.
+repository: https://github.com/dart-lang/test/tree/master/pkgs/matcher
+
+environment:
+ sdk: ^3.4.0
+
+dependencies:
+ async: ^2.10.0
+ meta: ^1.8.0
+ stack_trace: ^1.10.0
+ term_glyph: ^1.2.0
+ test_api: ">=0.5.0 <0.8.0"
+
+dev_dependencies:
+ fake_async: ^1.3.0
+ lints: ^3.0.0
+ test: ^1.23.0
+
+dependency_overrides:
+ test: 1.25.0
+ test_api: 0.7.3
diff --git a/pkgs/matcher/test/core_matchers_test.dart b/pkgs/matcher/test/core_matchers_test.dart
new file mode 100644
index 0000000..04fc8b3
--- /dev/null
+++ b/pkgs/matcher/test/core_matchers_test.dart
@@ -0,0 +1,247 @@
+// Copyright (c) 2012, 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 'package:matcher/matcher.dart';
+import 'package:test/test.dart' show test, group;
+
+import 'test_utils.dart';
+
+void main() {
+ test('isTrue', () {
+ shouldPass(true, isTrue);
+ shouldFail(false, isTrue, 'Expected: true Actual: <false>');
+ });
+
+ test('isFalse', () {
+ shouldPass(false, isFalse);
+ shouldFail(10, isFalse, 'Expected: false Actual: <10>');
+ shouldFail(true, isFalse, 'Expected: false Actual: <true>');
+ });
+
+ test('isNull', () {
+ shouldPass(null, isNull);
+ shouldFail(false, isNull, 'Expected: null Actual: <false>');
+ });
+
+ test('isNotNull', () {
+ shouldPass(false, isNotNull);
+ shouldFail(null, isNotNull, 'Expected: not null Actual: <null>');
+ });
+
+ test('isNaN', () {
+ shouldPass(double.nan, isNaN);
+ shouldFail(3.1, isNaN, 'Expected: NaN Actual: <3.1>');
+ shouldFail('not a num', isNaN, endsWith('not an <Instance of \'num\'>'));
+ });
+
+ test('isNotNaN', () {
+ shouldPass(3.1, isNotNaN);
+ shouldFail(double.nan, isNotNaN, 'Expected: not NaN Actual: <NaN>');
+ shouldFail('not a num', isNotNaN, endsWith('not an <Instance of \'num\'>'));
+ });
+
+ test('same', () {
+ var a = {};
+ var b = {};
+ shouldPass(a, same(a));
+ shouldFail(b, same(a), 'Expected: same instance as {} Actual: {}');
+ });
+
+ test('equals', () {
+ var a = {};
+ var b = {};
+ shouldPass(a, equals(a));
+ shouldPass(a, equals(b));
+ });
+
+ test('equals with null', () {
+ Object? a; // null
+ var b = {};
+ shouldPass(a, equals(a));
+ shouldFail(
+ a, equals(b), 'Expected: {} Actual: <null> Which: expected a map');
+ shouldFail(b, equals(a), 'Expected: <null> Actual: {}');
+ });
+
+ test('equals with a set', () {
+ var numbers = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10];
+ var set1 = numbers.toSet();
+ numbers.shuffle();
+ var set2 = numbers.toSet();
+
+ shouldPass(set2, equals(set1));
+ shouldPass(numbers, equals(set1));
+ shouldFail(
+ [1, 2, 3, 4, 5, 6, 7, 8, 9],
+ equals(set1),
+ matches(r'Expected: .*:\[1, 2, 3, 4, 5, 6, 7, 8, 9, 10\]'
+ r' Actual: \[1, 2, 3, 4, 5, 6, 7, 8, 9\]'
+ r' Which: does not contain <10>'));
+ shouldFail(
+ [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11],
+ equals(set1),
+ matches(r'Expected: .*:\[1, 2, 3, 4, 5, 6, 7, 8, 9, 10\]'
+ r' Actual: \[1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11\]'
+ r' Which: larger than expected'));
+ });
+
+ test('anything', () {
+ var a = {};
+ shouldPass(0, anything);
+ shouldPass(null, anything);
+ shouldPass(a, anything);
+ shouldFail(a, isNot(anything), 'Expected: not anything Actual: {}');
+ });
+
+ test('returnsNormally', () {
+ shouldPass(doesNotThrow, returnsNormally);
+ shouldFail(
+ doesThrow,
+ returnsNormally,
+ matches(r'Expected: return normally'
+ r' Actual: <Closure.*>'
+ r' Which: threw StateError:<Bad state: X>'));
+ shouldFail('not a function', returnsNormally,
+ contains('not an <Instance of \'Function\'>'));
+ });
+
+ test('hasLength', () {
+ var a = {};
+ var b = [];
+ shouldPass(a, hasLength(0));
+ shouldPass(b, hasLength(0));
+ shouldPass('a', hasLength(1));
+ shouldFail(
+ 0,
+ hasLength(0),
+ 'Expected: an object with length of <0> '
+ 'Actual: <0> '
+ 'Which: has no length property');
+
+ b.add(0);
+ shouldPass(b, hasLength(1));
+ shouldFail(
+ b,
+ hasLength(2),
+ 'Expected: an object with length of <2> '
+ 'Actual: [0] '
+ 'Which: has length of <1>');
+
+ b.add(0);
+ shouldFail(
+ b,
+ hasLength(1),
+ 'Expected: an object with length of <1> '
+ 'Actual: [0, 0] '
+ 'Which: has length of <2>');
+ shouldPass(b, hasLength(2));
+ });
+
+ test('scalar type mismatch', () {
+ shouldFail(
+ 'error',
+ equals(5.1),
+ 'Expected: <5.1> '
+ "Actual: 'error'");
+ });
+
+ test('nested type mismatch', () {
+ shouldFail(
+ ['error'],
+ equals([5.1]),
+ 'Expected: [5.1] '
+ "Actual: ['error'] "
+ "Which: at location [0] is 'error' instead of <5.1>");
+ });
+
+ test('doubly-nested type mismatch', () {
+ shouldFail(
+ [
+ ['error']
+ ],
+ equals([
+ [5.1]
+ ]),
+ 'Expected: [[5.1]] '
+ "Actual: [['error']] "
+ "Which: at location [0][0] is 'error' instead of <5.1>");
+ });
+
+ test('doubly nested inequality', () {
+ var actual1 = [
+ ['foo', 'bar'],
+ ['foo'],
+ 3,
+ []
+ ];
+ var expected1 = [
+ ['foo', 'bar'],
+ ['foo'],
+ 4,
+ []
+ ];
+ var reason1 = "Expected: [['foo', 'bar'], ['foo'], 4, []] "
+ "Actual: [['foo', 'bar'], ['foo'], 3, []] "
+ 'Which: at location [2] is <3> instead of <4>';
+
+ var actual2 = [
+ ['foo', 'barry'],
+ ['foo'],
+ 4,
+ []
+ ];
+ var expected2 = [
+ ['foo', 'bar'],
+ ['foo'],
+ 4,
+ []
+ ];
+ var reason2 = "Expected: [['foo', 'bar'], ['foo'], 4, []] "
+ "Actual: [['foo', 'barry'], ['foo'], 4, []] "
+ "Which: at location [0][1] is 'barry' instead of 'bar'";
+
+ var actual3 = [
+ ['foo', 'bar'],
+ ['foo'],
+ 4,
+ {'foo': 'bar'}
+ ];
+ var expected3 = [
+ ['foo', 'bar'],
+ ['foo'],
+ 4,
+ {'foo': 'barry'}
+ ];
+ var reason3 = "Expected: [['foo', 'bar'], ['foo'], 4, {'foo': 'barry'}] "
+ "Actual: [['foo', 'bar'], ['foo'], 4, {'foo': 'bar'}] "
+ "Which: at location [3]['foo'] is 'bar' instead of 'barry'";
+
+ shouldFail(actual1, equals(expected1), reason1);
+ shouldFail(actual2, equals(expected2), reason2);
+ shouldFail(actual3, equals(expected3), reason3);
+ });
+
+ group('Predicate Matchers', () {
+ test('isInstanceOf', () {
+ shouldFail(0, predicate((x) => x is String, 'an instance of String'),
+ 'Expected: an instance of String Actual: <0>');
+ shouldPass('cow', predicate((x) => x is String, 'an instance of String'));
+
+ shouldFail(0, predicate((bool x) => x, 'bool value is true'),
+ endsWith("not an <Instance of 'bool'>"));
+ });
+ });
+
+ group('wrapMatcher', () {
+ test('wraps a predicate which allows a nullable argument', () {
+ final matcher = wrapMatcher((_) => true);
+ shouldPass(null, matcher);
+ });
+
+ test('wraps a predicate which has a typed argument check', () {
+ final matcher = wrapMatcher((int _) => true);
+ shouldPass(1, matcher);
+ });
+ });
+}
diff --git a/pkgs/matcher/test/custom_matcher_test.dart b/pkgs/matcher/test/custom_matcher_test.dart
new file mode 100644
index 0000000..d0a17c9
--- /dev/null
+++ b/pkgs/matcher/test/custom_matcher_test.dart
@@ -0,0 +1,48 @@
+// Copyright (c) 2012, 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 'package:matcher/matcher.dart';
+import 'package:test/test.dart' show test;
+
+import 'test_utils.dart';
+
+class _BadCustomMatcher extends CustomMatcher {
+ _BadCustomMatcher() : super('feature', 'description', {1: 'a'});
+ @override
+ Object? featureValueOf(dynamic actual) => throw Exception('bang');
+}
+
+class _HasPrice extends CustomMatcher {
+ _HasPrice(Object? matcher)
+ : super('Widget with a price that is', 'price', matcher);
+ @override
+ Object? featureValueOf(Object? actual) => (actual as Widget).price;
+}
+
+void main() {
+ test('Feature Matcher', () {
+ var w = Widget();
+ w.price = 10;
+ shouldPass(w, _HasPrice(10));
+ shouldPass(w, _HasPrice(greaterThan(0)));
+ shouldFail(
+ w,
+ _HasPrice(greaterThan(10)),
+ 'Expected: Widget with a price that is a value greater than <10> '
+ "Actual: <Instance of 'Widget'> "
+ 'Which: has price with value <10> which is not '
+ 'a value greater than <10>');
+ });
+
+ test('Custom Matcher Exception', () {
+ shouldFail(
+ 'a',
+ _BadCustomMatcher(),
+ allOf([
+ contains("Expected: feature {1: 'a'} "),
+ contains("Actual: 'a' "),
+ contains("Which: threw 'Exception: bang' "),
+ ]));
+ });
+}
diff --git a/pkgs/matcher/test/escape_test.dart b/pkgs/matcher/test/escape_test.dart
new file mode 100644
index 0000000..c898054
--- /dev/null
+++ b/pkgs/matcher/test/escape_test.dart
@@ -0,0 +1,63 @@
+// Copyright (c) 2015, 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.
+
+// ignore_for_file: missing_whitespace_between_adjacent_strings
+
+import 'package:test/test.dart';
+
+void main() {
+ group('escaping should work with', () {
+ _testEscaping('no escaped chars', 'Hello, world!', 'Hello, world!');
+ _testEscaping('newline', '\n', r'\n');
+ _testEscaping('carriage return', '\r', r'\r');
+ _testEscaping('form feed', '\f', r'\f');
+ _testEscaping('backspace', '\b', r'\b');
+ _testEscaping('tab', '\t', r'\t');
+ _testEscaping('vertical tab', '\v', r'\v');
+ _testEscaping('null byte', '\x00', r'\x00');
+ _testEscaping('ASCII control character', '\x11', r'\x11');
+ _testEscaping('delete', '\x7F', r'\x7F');
+ _testEscaping('escape combos', r'\n', r'\\n');
+ _testEscaping(
+ 'All characters',
+ 'A new line\nA charriage return\rA form feed\fA backspace\b'
+ 'A tab\tA vertical tab\vA slash\\A null byte\x00A control char\x1D'
+ 'A delete\x7F',
+ r'A new line\nA charriage return\rA form feed\fA backspace\b'
+ r'A tab\tA vertical tab\vA slash\\A null byte\x00A control char\x1D'
+ r'A delete\x7F');
+ });
+
+ group('unequal strings remain unequal when escaped', () {
+ _testUnequalStrings('with a newline', '\n', r'\n');
+ _testUnequalStrings('with slash literals', '\\', r'\\');
+ });
+}
+
+/// Creates a [test] with name [name] that verifies [source] escapes to value
+/// [target].
+void _testEscaping(String name, String source, String target) {
+ test(name, () {
+ var escaped = escape(source);
+ expect(escaped == target, isTrue,
+ reason: 'Expected escaped value: $target\n'
+ ' Actual escaped value: $escaped');
+ });
+}
+
+/// Creates a [test] with name [name] that ensures two different [String] values
+/// [s1] and [s2] remain unequal when escaped.
+void _testUnequalStrings(String name, String s1, String s2) {
+ test(name, () {
+ // Explicitly not using the equals matcher
+ expect(s1 != s2, isTrue, reason: 'The source values should be unequal');
+
+ var escapedS1 = escape(s1);
+ var escapedS2 = escape(s2);
+
+ // Explicitly not using the equals matcher
+ expect(escapedS1 != escapedS2, isTrue,
+ reason: 'Unequal strings, when escaped, should remain unequal.');
+ });
+}
diff --git a/pkgs/matcher/test/expect_async_test.dart b/pkgs/matcher/test/expect_async_test.dart
new file mode 100644
index 0000000..7619893
--- /dev/null
+++ b/pkgs/matcher/test/expect_async_test.dart
@@ -0,0 +1,393 @@
+// Copyright (c) 2015, 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.
+
+// ignore_for_file: only_throw_errors
+
+import 'dart:async';
+
+import 'package:fake_async/fake_async.dart';
+import 'package:test/test.dart';
+import 'package:test_api/hooks_testing.dart';
+
+import 'utils_new.dart';
+
+void main() {
+ group('supports a function with this many arguments:', () {
+ test('0', () async {
+ var callbackRun = false;
+ var monitor = await TestCaseMonitor.run(() {
+ expectAsync0(() {
+ callbackRun = true;
+ })();
+ });
+
+ expectTestPassed(monitor);
+ expect(callbackRun, isTrue);
+ });
+
+ test('1', () async {
+ var callbackRun = false;
+ var monitor = await TestCaseMonitor.run(() {
+ expectAsync1((int arg) {
+ expect(arg, equals(1));
+ callbackRun = true;
+ })(1);
+ });
+
+ expectTestPassed(monitor);
+ expect(callbackRun, isTrue);
+ });
+
+ test('2', () async {
+ var callbackRun = false;
+ var monitor = await TestCaseMonitor.run(() {
+ expectAsync2((arg1, arg2) {
+ expect(arg1, equals(1));
+ expect(arg2, equals(2));
+ callbackRun = true;
+ })(1, 2);
+ });
+
+ expectTestPassed(monitor);
+ expect(callbackRun, isTrue);
+ });
+
+ test('3', () async {
+ var callbackRun = false;
+ var monitor = await TestCaseMonitor.run(() {
+ expectAsync3((arg1, arg2, arg3) {
+ expect(arg1, equals(1));
+ expect(arg2, equals(2));
+ expect(arg3, equals(3));
+ callbackRun = true;
+ })(1, 2, 3);
+ });
+
+ expectTestPassed(monitor);
+ expect(callbackRun, isTrue);
+ });
+
+ test('4', () async {
+ var callbackRun = false;
+ var monitor = await TestCaseMonitor.run(() {
+ expectAsync4((arg1, arg2, arg3, arg4) {
+ expect(arg1, equals(1));
+ expect(arg2, equals(2));
+ expect(arg3, equals(3));
+ expect(arg4, equals(4));
+ callbackRun = true;
+ })(1, 2, 3, 4);
+ });
+
+ expectTestPassed(monitor);
+ expect(callbackRun, isTrue);
+ });
+
+ test('5', () async {
+ var callbackRun = false;
+ var monitor = await TestCaseMonitor.run(() {
+ expectAsync5((arg1, arg2, arg3, arg4, arg5) {
+ expect(arg1, equals(1));
+ expect(arg2, equals(2));
+ expect(arg3, equals(3));
+ expect(arg4, equals(4));
+ expect(arg5, equals(5));
+ callbackRun = true;
+ })(1, 2, 3, 4, 5);
+ });
+
+ expectTestPassed(monitor);
+ expect(callbackRun, isTrue);
+ });
+
+ test('6', () async {
+ var callbackRun = false;
+ var monitor = await TestCaseMonitor.run(() {
+ expectAsync6((arg1, arg2, arg3, arg4, arg5, arg6) {
+ expect(arg1, equals(1));
+ expect(arg2, equals(2));
+ expect(arg3, equals(3));
+ expect(arg4, equals(4));
+ expect(arg5, equals(5));
+ expect(arg6, equals(6));
+ callbackRun = true;
+ })(1, 2, 3, 4, 5, 6);
+ });
+
+ expectTestPassed(monitor);
+ expect(callbackRun, isTrue);
+ });
+ });
+
+ group('with optional arguments', () {
+ test('allows them to be passed', () async {
+ var callbackRun = false;
+ var monitor = await TestCaseMonitor.run(() {
+ expectAsync1(([arg = 1]) {
+ expect(arg, equals(2));
+ callbackRun = true;
+ })(2);
+ });
+
+ expectTestPassed(monitor);
+ expect(callbackRun, isTrue);
+ });
+
+ test('allows them not to be passed', () async {
+ var callbackRun = false;
+ var monitor = await TestCaseMonitor.run(() {
+ expectAsync1(([arg = 1]) {
+ expect(arg, equals(1));
+ callbackRun = true;
+ })();
+ });
+
+ expectTestPassed(monitor);
+ expect(callbackRun, isTrue);
+ });
+ });
+
+ group('by default', () {
+ test("won't allow the test to complete until it's called", () async {
+ late void Function() callback;
+ final monitor = TestCaseMonitor.start(() {
+ callback = expectAsync0(() {});
+ });
+
+ await pumpEventQueue();
+ expect(monitor.state, equals(State.running));
+ callback();
+ await monitor.onDone;
+
+ expectTestPassed(monitor);
+ });
+
+ test('may only be called once', () async {
+ var monitor = await TestCaseMonitor.run(() {
+ var callback = expectAsync0(() {});
+ callback();
+ callback();
+ });
+
+ expectTestFailed(
+ monitor, 'Callback called more times than expected (1).');
+ });
+ });
+
+ group('with count', () {
+ test(
+ "won't allow the test to complete until it's called at least that "
+ 'many times', () async {
+ late void Function() callback;
+ final monitor = TestCaseMonitor.start(() {
+ callback = expectAsync0(() {}, count: 3);
+ });
+
+ await pumpEventQueue();
+ expect(monitor.state, equals(State.running));
+ callback();
+
+ await pumpEventQueue();
+ expect(monitor.state, equals(State.running));
+ callback();
+
+ await pumpEventQueue();
+ expect(monitor.state, equals(State.running));
+ callback();
+
+ await monitor.onDone;
+
+ expectTestPassed(monitor);
+ });
+
+ test("will throw an error if it's called more than that many times",
+ () async {
+ var monitor = await TestCaseMonitor.run(() {
+ var callback = expectAsync0(() {}, count: 3);
+ callback();
+ callback();
+ callback();
+ callback();
+ });
+
+ expectTestFailed(
+ monitor, 'Callback called more times than expected (3).');
+ });
+
+ group('0,', () {
+ test("won't block the test's completion", () {
+ expectAsync0(() {}, count: 0);
+ });
+
+ test("will throw an error if it's ever called", () async {
+ var monitor = await TestCaseMonitor.run(() {
+ expectAsync0(() {}, count: 0)();
+ });
+
+ expectTestFailed(
+ monitor, 'Callback called more times than expected (0).');
+ });
+ });
+ });
+
+ group('with max', () {
+ test('will allow the callback to be called that many times', () {
+ var callback = expectAsync0(() {}, max: 3);
+ callback();
+ callback();
+ callback();
+ });
+
+ test('will allow the callback to be called fewer than that many times', () {
+ var callback = expectAsync0(() {}, max: 3);
+ callback();
+ });
+
+ test("will throw an error if it's called more than that many times",
+ () async {
+ var monitor = await TestCaseMonitor.run(() {
+ var callback = expectAsync0(() {}, max: 3);
+ callback();
+ callback();
+ callback();
+ callback();
+ });
+
+ expectTestFailed(
+ monitor, 'Callback called more times than expected (3).');
+ });
+
+ test('-1, will allow the callback to be called any number of times', () {
+ var callback = expectAsync0(() {}, max: -1);
+ for (var i = 0; i < 20; i++) {
+ callback();
+ }
+ });
+ });
+
+ test('will throw an error if max is less than count', () {
+ expect(() => expectAsync0(() {}, max: 1, count: 2), throwsArgumentError);
+ });
+
+ group('expectAsyncUntil()', () {
+ test("won't allow the test to complete until isDone returns true",
+ () async {
+ late TestCaseMonitor monitor;
+ late Future future;
+ monitor = TestCaseMonitor.start(() {
+ var done = false;
+ var callback = expectAsyncUntil0(() {}, () => done);
+
+ future = () async {
+ await pumpEventQueue();
+ expect(monitor.state, equals(State.running));
+ callback();
+ await pumpEventQueue();
+ expect(monitor.state, equals(State.running));
+ done = true;
+ callback();
+ }();
+ });
+ await monitor.onDone;
+
+ expectTestPassed(monitor);
+ // Ensure that the outer test doesn't complete until the inner future
+ // completes.
+ await future;
+ });
+
+ test("doesn't call isDone until after the callback is called", () {
+ var callbackRun = false;
+ expectAsyncUntil0(() => callbackRun = true, () {
+ expect(callbackRun, isTrue);
+ return true;
+ })();
+ });
+ });
+
+ test('allows errors', () async {
+ var monitor = await TestCaseMonitor.run(() {
+ expect(expectAsync0(() => throw 'oh no'), throwsA('oh no'));
+ });
+
+ expectTestPassed(monitor);
+ });
+
+ test('may be called in a non-test zone', () async {
+ var monitor = await TestCaseMonitor.run(() {
+ var callback = expectAsync0(() {});
+ Zone.root.run(callback);
+ });
+ expectTestPassed(monitor);
+ });
+
+ test('may be called in a FakeAsync zone that does not run further', () async {
+ var monitor = await TestCaseMonitor.run(() {
+ FakeAsync().run((_) {
+ var callback = expectAsync0(() {});
+ callback();
+ });
+ });
+ expectTestPassed(monitor);
+ });
+
+ group('old-style expectAsync()', () {
+ test('works with no arguments', () async {
+ var callbackRun = false;
+ var monitor = await TestCaseMonitor.run(() {
+ // ignore: deprecated_member_use_from_same_package, avoid_dynamic_calls
+ expectAsync(() {
+ callbackRun = true;
+ })();
+ });
+
+ expectTestPassed(monitor);
+ expect(callbackRun, isTrue);
+ });
+
+ test('works with dynamic arguments', () async {
+ var callbackRun = false;
+ var monitor = await TestCaseMonitor.run(() {
+ // ignore: deprecated_member_use_from_same_package, avoid_dynamic_calls
+ expectAsync((arg1, arg2) {
+ callbackRun = true;
+ })(1, 2);
+ });
+
+ expectTestPassed(monitor);
+ expect(callbackRun, isTrue);
+ });
+
+ test('works with non-nullable arguments', () async {
+ var callbackRun = false;
+ var monitor = await TestCaseMonitor.run(() {
+ // ignore: deprecated_member_use_from_same_package, avoid_dynamic_calls
+ expectAsync((int arg1, int arg2) {
+ callbackRun = true;
+ })(1, 2);
+ });
+
+ expectTestPassed(monitor);
+ expect(callbackRun, isTrue);
+ });
+
+ test('works with 6 arguments', () async {
+ var callbackRun = false;
+ var monitor = await TestCaseMonitor.run(() {
+ // ignore: deprecated_member_use_from_same_package, avoid_dynamic_calls
+ expectAsync((arg1, arg2, arg3, arg4, arg5, arg6) {
+ callbackRun = true;
+ })(1, 2, 3, 4, 5, 6);
+ });
+
+ expectTestPassed(monitor);
+ expect(callbackRun, isTrue);
+ });
+
+ test("doesn't support a function with 7 arguments", () {
+ // ignore: deprecated_member_use_from_same_package
+ expect(() => expectAsync((a, b, c, d, e, f, g) {}), throwsArgumentError);
+ });
+ });
+}
diff --git a/pkgs/matcher/test/expect_test.dart b/pkgs/matcher/test/expect_test.dart
new file mode 100644
index 0000000..e2ef497
--- /dev/null
+++ b/pkgs/matcher/test/expect_test.dart
@@ -0,0 +1,36 @@
+// Copyright (c) 2017, 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 'package:test/test.dart';
+
+import 'utils_new.dart';
+
+void main() {
+ group('returned Future from expectLater()', () {
+ test('completes immediately for a sync matcher', () {
+ expect(expectLater(true, isTrue), completes);
+ });
+
+ test('contains the expect failure', () {
+ expect(expectLater(Future.value(true), completion(isFalse)),
+ throwsA(isTestFailure(anything)));
+ });
+
+ test('contains an async error', () {
+ expect(expectLater(Future.error('oh no'), completion(isFalse)),
+ throwsA('oh no'));
+ });
+ });
+
+ group('an async matcher that fails synchronously', () {
+ test('throws synchronously', () {
+ expect(() => expect(() {}, throwsA(anything)),
+ throwsA(isTestFailure(anything)));
+ });
+
+ test('can be used with synchronous operators', () {
+ expect(() {}, isNot(throwsA(anything)));
+ });
+ });
+}
diff --git a/pkgs/matcher/test/having_test.dart b/pkgs/matcher/test/having_test.dart
new file mode 100644
index 0000000..ddada77
--- /dev/null
+++ b/pkgs/matcher/test/having_test.dart
@@ -0,0 +1,129 @@
+// Copyright (c) 2018, 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.
+
+// ignore_for_file: lines_longer_than_80_chars
+
+import 'package:matcher/matcher.dart';
+import 'package:test/test.dart' show test, expect, throwsA, group;
+
+import 'test_utils.dart';
+
+void main() {
+ test('success', () {
+ shouldPass(RangeError('details'), _rangeMatcher);
+ });
+
+ test('failure', () {
+ shouldFail(
+ CustomRangeError.range(-1, 1, 10),
+ _rangeMatcher,
+ "Expected: <Instance of 'RangeError'> with "
+ "`message`: contains 'details' and `start`: null and `end`: null "
+ 'Actual: CustomRangeError:<RangeError: Invalid value: details> '
+ "Which: has `message` with value 'Invalid value' "
+ "which does not contain 'details'",
+ );
+ });
+
+ // This code is used in the [TypeMatcher] doc comments.
+ test('integration and example', () {
+ void shouldThrowRangeError(int value) {
+ throw RangeError.range(value, 10, 20);
+ }
+
+ expect(
+ () => shouldThrowRangeError(5),
+ throwsA(const TypeMatcher<RangeError>()
+ .having((e) => e.start, 'start', greaterThanOrEqualTo(10))
+ .having((e) => e.end, 'end', lessThanOrEqualTo(20))));
+
+ expect(
+ () => shouldThrowRangeError(5),
+ throwsA(isRangeError
+ .having((e) => e.start, 'start', greaterThanOrEqualTo(10))
+ .having((e) => e.end, 'end', lessThanOrEqualTo(20))));
+ });
+
+ test('having inside deep matcher', () {
+ shouldFail(
+ [RangeError.range(-1, 1, 10)],
+ equals([_rangeMatcher]),
+ anyOf([
+ equalsIgnoringWhitespace(
+ "Expected: [ <<Instance of 'RangeError'> with "
+ "`message`: contains 'details' and `start`: null and `end`: null> ] "
+ 'Actual: [RangeError:RangeError: '
+ 'Invalid value: Not in inclusive range 1..10: -1] '
+ 'Which: at location [0] is RangeError:<RangeError: '
+ 'Invalid value: Not in inclusive range 1..10: -1> '
+ "which has `message` with value 'Invalid value' "
+ "which does not contain 'details'"),
+ equalsIgnoringWhitespace(// Older SDKs
+ "Expected: [ <<Instance of 'RangeError'> with "
+ "`message`: contains 'details' and `start`: null and `end`: null> ] "
+ 'Actual: [RangeError:RangeError: '
+ 'Invalid value: Not in range 1..10, inclusive: -1] '
+ 'Which: at location [0] is RangeError:<RangeError: '
+ 'Invalid value: Not in range 1..10, inclusive: -1> '
+ "which has `message` with value 'Invalid value' "
+ "which does not contain 'details'")
+ ]));
+ });
+
+ group('CustomMatcher copy', () {
+ test('Feature Matcher', () {
+ var w = Widget();
+ w.price = 10;
+ shouldPass(w, _hasPrice(10));
+ shouldPass(w, _hasPrice(greaterThan(0)));
+ shouldFail(
+ w,
+ _hasPrice(greaterThan(10)),
+ "Expected: <Instance of 'Widget'> with `price`: a value greater than <10> "
+ "Actual: <Instance of 'Widget'> "
+ 'Which: has `price` with value <10> which is not '
+ 'a value greater than <10>');
+ });
+
+ test('Custom Matcher Exception', () {
+ shouldFail(
+ 'a',
+ _badCustomMatcher(),
+ allOf([
+ contains(
+ "Expected: <Instance of 'Widget'> with `feature`: {1: 'a'} "),
+ contains("Actual: 'a'"),
+ ]));
+ shouldFail(
+ Widget(),
+ _badCustomMatcher(),
+ allOf([
+ contains(
+ "Expected: <Instance of 'Widget'> with `feature`: {1: 'a'} "),
+ contains("Actual: <Instance of 'Widget'> "),
+ contains("Which: threw 'Exception: bang' "),
+ ]));
+ });
+ });
+}
+
+final _rangeMatcher = isRangeError
+ .having((e) => e.message, 'message', contains('details'))
+ .having((e) => e.start, 'start', isNull)
+ .having((e) => e.end, 'end', isNull);
+
+Matcher _hasPrice(Object matcher) =>
+ const TypeMatcher<Widget>().having((e) => e.price, 'price', matcher);
+
+Matcher _badCustomMatcher() => const TypeMatcher<Widget>()
+ .having((e) => throw Exception('bang'), 'feature', {1: 'a'});
+
+class CustomRangeError extends RangeError {
+ CustomRangeError.range(
+ super.invalidValue, int super.minValue, int super.maxValue)
+ : super.range();
+
+ @override
+ String toString() => 'RangeError: Invalid value: details';
+}
diff --git a/pkgs/matcher/test/iterable_matchers_test.dart b/pkgs/matcher/test/iterable_matchers_test.dart
new file mode 100644
index 0000000..7607d18
--- /dev/null
+++ b/pkgs/matcher/test/iterable_matchers_test.dart
@@ -0,0 +1,395 @@
+// Copyright (c) 2012, 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 'package:test/test.dart';
+
+import 'test_utils.dart';
+
+void main() {
+ test('isEmpty', () {
+ shouldPass([], isEmpty);
+ shouldFail([1], isEmpty, 'Expected: empty Actual: [1]');
+ });
+
+ test('isNotEmpty', () {
+ shouldFail([], isNotEmpty, 'Expected: non-empty Actual: []');
+ shouldPass([1], isNotEmpty);
+ });
+
+ test('contains', () {
+ var d = [1, 2];
+ shouldPass(d, contains(1));
+ shouldFail(
+ d,
+ contains(0),
+ 'Expected: contains <0> '
+ 'Actual: [1, 2] '
+ 'Which: does not contain <0>');
+
+ shouldFail(
+ 'String',
+ contains(42),
+ "Expected: contains <42> Actual: 'String' "
+ 'Which: does not contain <42>');
+ });
+
+ test('equals with matcher element', () {
+ var d = ['foo', 'bar'];
+ shouldPass(d, equals(['foo', startsWith('ba')]));
+ shouldFail(
+ d,
+ equals(['foo', endsWith('ba')]),
+ "Expected: ['foo', <a string ending with 'ba'>] "
+ "Actual: ['foo', 'bar'] "
+ "Which: at location [1] is 'bar' which "
+ "does not match a string ending with 'ba'");
+ });
+
+ test('isIn', () {
+ // Iterable
+ shouldPass(1, isIn([1, 2]));
+ shouldFail(0, isIn([1, 2]), 'Expected: is in [1, 2] Actual: <0>');
+
+ // Map
+ shouldPass(1, isIn({1: null}));
+ shouldFail(0, isIn({1: null}), 'Expected: is in {1: null} Actual: <0>');
+
+ // String
+ shouldPass('42', isIn('1421'));
+ shouldFail('42', isIn('41'), "Expected: is in '41' Actual: '42'");
+ shouldFail(
+ 0, isIn('a string'), endsWith('not an <Instance of \'Pattern\'>'));
+
+ // Invalid arg
+ expect(() => isIn(42), throwsArgumentError);
+ });
+
+ test('everyElement', () {
+ var d = [1, 2];
+ var e = [1, 1, 1];
+ shouldFail(
+ d,
+ everyElement(1),
+ 'Expected: every element(<1>) '
+ 'Actual: [1, 2] '
+ "Which: has value <2> which doesn't match <1> at index 1");
+ shouldPass(e, everyElement(1));
+ shouldFail('not iterable', everyElement(1),
+ endsWith('not an <Instance of \'Iterable\'>'));
+ });
+
+ test('nested everyElement', () {
+ var d = [
+ ['foo', 'bar'],
+ ['foo'],
+ []
+ ];
+ var e = [
+ ['foo', 'bar'],
+ ['foo'],
+ 3,
+ []
+ ];
+ shouldPass(d, everyElement(anyOf(isEmpty, contains('foo'))));
+ shouldFail(
+ d,
+ everyElement(everyElement(equals('foo'))),
+ "Expected: every element(every element('foo')) "
+ "Actual: [['foo', 'bar'], ['foo'], []] "
+ "Which: has value ['foo', 'bar'] which has value 'bar' "
+ 'which is different. Expected: foo Actual: bar ^ '
+ 'Differ at offset 0 at index 1 at index 0');
+ shouldFail(
+ d,
+ everyElement(allOf(hasLength(greaterThan(0)), contains('foo'))),
+ 'Expected: every element((an object with length of a value '
+ "greater than <0> and contains 'foo')) "
+ "Actual: [['foo', 'bar'], ['foo'], []] "
+ 'Which: has value [] which has length of <0> at index 2');
+ shouldFail(
+ d,
+ everyElement(allOf(contains('foo'), hasLength(greaterThan(0)))),
+ "Expected: every element((contains 'foo' and "
+ 'an object with length of a value greater than <0>)) '
+ "Actual: [['foo', 'bar'], ['foo'], []] "
+ "Which: has value [] which does not contain 'foo' at index 2");
+ shouldFail(
+ e,
+ everyElement(allOf(contains('foo'), hasLength(greaterThan(0)))),
+ "Expected: every element((contains 'foo' and an object with "
+ 'length of a value greater than <0>)) '
+ "Actual: [['foo', 'bar'], ['foo'], 3, []] "
+ 'Which: has value <3> which is not a string, map or iterable '
+ 'at index 2');
+ });
+
+ test('anyElement', () {
+ var d = [1, 2];
+ var e = [1, 1, 1];
+ shouldPass(d, anyElement(2));
+ shouldFail(
+ e, anyElement(2), 'Expected: some element <2> Actual: [1, 1, 1]');
+ shouldFail('not an iterable', anyElement(2),
+ endsWith('not an <Instance of \'Iterable\'>'));
+ });
+
+ test('orderedEquals', () {
+ shouldPass([null], orderedEquals([null]));
+ var d = [1, 2];
+ shouldPass(d, orderedEquals([1, 2]));
+ shouldFail(
+ d,
+ orderedEquals([2, 1]),
+ 'Expected: equals [2, 1] ordered '
+ 'Actual: [1, 2] '
+ 'Which: at location [0] is <1> instead of <2>');
+ shouldFail('not an iterable', orderedEquals([1]),
+ endsWith('not an <Instance of \'Iterable\'>'));
+ });
+
+ test('unorderedEquals', () {
+ var d = [1, 2];
+ shouldPass(d, unorderedEquals([2, 1]));
+ shouldFail(
+ d,
+ unorderedEquals([1]),
+ 'Expected: equals [1] unordered '
+ 'Actual: [1, 2] '
+ 'Which: has too many elements (2 > 1)');
+ shouldFail(
+ d,
+ unorderedEquals([3, 2, 1]),
+ 'Expected: equals [3, 2, 1] unordered '
+ 'Actual: [1, 2] '
+ 'Which: has too few elements (2 < 3)');
+ shouldFail(
+ d,
+ unorderedEquals([3, 1]),
+ 'Expected: equals [3, 1] unordered '
+ 'Actual: [1, 2] '
+ 'Which: has no match for <3> at index 0');
+ shouldFail(
+ d,
+ unorderedEquals([3, 4]),
+ 'Expected: equals [3, 4] unordered '
+ 'Actual: [1, 2] '
+ 'Which: has no match for <3> at index 0'
+ ' along with 1 other unmatched');
+ shouldFail('not an iterable', unorderedEquals([1]),
+ endsWith('not an <Instance of \'Iterable\'>'));
+ });
+
+ test('unorderedMatches', () {
+ var d = [1, 2];
+ shouldPass(d, unorderedMatches([2, 1]));
+ shouldPass(d, unorderedMatches([greaterThan(1), greaterThan(0)]));
+ shouldPass(d, unorderedMatches([greaterThan(0), greaterThan(1)]));
+ shouldPass([2, 1], unorderedMatches([greaterThan(1), greaterThan(0)]));
+
+ shouldPass([2, 1], unorderedMatches([greaterThan(0), greaterThan(1)]));
+ // Excersize the case where pairings should get "bumped" multiple times
+ shouldPass(
+ [0, 1, 2, 3, 5, 6],
+ unorderedMatches([
+ greaterThan(1), // 6
+ equals(2), // 2
+ allOf([lessThan(3), isNot(0)]), // 1
+ equals(0), // 0
+ predicate((int v) => v % 2 == 1), // 3
+ equals(5), // 5
+ ]));
+ shouldFail(
+ d,
+ unorderedMatches([greaterThan(0)]),
+ 'Expected: matches [a value greater than <0>] unordered '
+ 'Actual: [1, 2] '
+ 'Which: has too many elements (2 > 1)');
+ shouldFail(
+ d,
+ unorderedMatches([3, 2, 1]),
+ 'Expected: matches [<3>, <2>, <1>] unordered '
+ 'Actual: [1, 2] '
+ 'Which: has too few elements (2 < 3)');
+ shouldFail(
+ d,
+ unorderedMatches([3, 1]),
+ 'Expected: matches [<3>, <1>] unordered '
+ 'Actual: [1, 2] '
+ 'Which: has no match for <3> at index 0');
+ shouldFail(
+ d,
+ unorderedMatches([greaterThan(3), greaterThan(0)]),
+ 'Expected: matches [a value greater than <3>, a value greater than '
+ '<0>] unordered '
+ 'Actual: [1, 2] '
+ 'Which: has no match for a value greater than <3> at index 0');
+ shouldFail('not an iterable', unorderedMatches([greaterThan(1)]),
+ endsWith('not an <Instance of \'Iterable\'>'));
+ });
+
+ test('containsAll', () {
+ var d = [0, 1, 2];
+ shouldPass(d, containsAll([1, 2]));
+ shouldPass(d, containsAll([2, 1]));
+ shouldPass(d, containsAll([greaterThan(0), greaterThan(1)]));
+ shouldPass([2, 1], containsAll([greaterThan(0), greaterThan(1)]));
+ shouldFail(
+ d,
+ containsAll([1, 2, 3]),
+ 'Expected: contains all of [1, 2, 3] '
+ 'Actual: [0, 1, 2] '
+ 'Which: has no match for <3> at index 2');
+ shouldFail(
+ 1,
+ containsAll([1]),
+ 'Expected: contains all of [1] '
+ 'Actual: <1> '
+ "Which: not an <Instance of 'Iterable'>");
+ shouldFail(
+ [-1, 2],
+ containsAll([greaterThan(0), greaterThan(1)]),
+ 'Expected: contains all of [<a value greater than <0>>, '
+ '<a value greater than <1>>] '
+ 'Actual: [-1, 2] '
+ 'Which: has no match for a value greater than <1> at index 1');
+ shouldFail('not an iterable', containsAll([1, 2, 3]),
+ endsWith('not an <Instance of \'Iterable\'>'));
+ });
+
+ test('containsAllInOrder', () {
+ var d = [0, 1, 0, 2];
+ shouldPass(d, containsAllInOrder([1, 2]));
+ shouldPass(d, containsAllInOrder([greaterThan(0), greaterThan(1)]));
+ shouldFail(
+ d,
+ containsAllInOrder([2, 1]),
+ 'Expected: contains in order([2, 1]) '
+ 'Actual: [0, 1, 0, 2] '
+ 'Which: did not find a value matching <1> following expected prior '
+ 'values');
+ shouldFail(
+ d,
+ containsAllInOrder([greaterThan(1), greaterThan(0)]),
+ 'Expected: contains in order([<a value greater than <1>>, '
+ '<a value greater than <0>>]) '
+ 'Actual: [0, 1, 0, 2] '
+ 'Which: did not find a value matching a value greater than <0> '
+ 'following expected prior values');
+ shouldFail(
+ d,
+ containsAllInOrder([1, 2, 3]),
+ 'Expected: contains in order([1, 2, 3]) '
+ 'Actual: [0, 1, 0, 2] '
+ 'Which: did not find a value matching <3> following expected prior '
+ 'values');
+ shouldFail(
+ 1,
+ containsAllInOrder([1]),
+ 'Expected: contains in order([1]) '
+ 'Actual: <1> '
+ "Which: not an <Instance of 'Iterable'>");
+ });
+
+ test('containsOnce', () {
+ shouldPass([1, 2, 3, 4], containsOnce(2));
+ shouldPass([1, 2, 11, 3], containsOnce(greaterThan(10)));
+ shouldFail(
+ [1, 2, 3, 4],
+ containsOnce(10),
+ 'Expected: contains once(<10>) '
+ 'Actual: [1, 2, 3, 4] '
+ 'Which: did not find a value matching <10>');
+ shouldFail(
+ [1, 2, 3, 4],
+ containsOnce(greaterThan(10)),
+ 'Expected: contains once(a value greater than <10>) '
+ 'Actual: [1, 2, 3, 4] '
+ 'Which: did not find a value matching a value greater than <10>');
+ shouldFail(
+ [1, 2, 1, 2],
+ containsOnce(2),
+ 'Expected: contains once(<2>) '
+ 'Actual: [1, 2, 1, 2] '
+ 'Which: expected only one value matching <2> '
+ 'but found multiple: <2>, <2>');
+ shouldFail(
+ [1, 2, 10, 20],
+ containsOnce(greaterThan(5)),
+ 'Expected: contains once(a value greater than <5>) '
+ 'Actual: [1, 2, 10, 20] '
+ 'Which: expected only one value matching a value greater than <5> '
+ 'but found multiple: <10>, <20>');
+ });
+
+ test('pairwise compare', () {
+ var c = [1, 2];
+ var d = [1, 2, 3];
+ var e = [1, 4, 9];
+ shouldFail(
+ 'x',
+ pairwiseCompare(e, (int e, int a) => a <= e, 'less than or equal'),
+ 'Expected: pairwise less than or equal [1, 4, 9] '
+ "Actual: 'x' "
+ "Which: not an <Instance of 'Iterable'>");
+ shouldFail(
+ c,
+ pairwiseCompare(e, (int e, int a) => a <= e, 'less than or equal'),
+ 'Expected: pairwise less than or equal [1, 4, 9] '
+ 'Actual: [1, 2] '
+ 'Which: has length 2 instead of 3');
+ shouldPass(
+ d, pairwiseCompare(e, (int e, int a) => a <= e, 'less than or equal'));
+ shouldFail(
+ d,
+ pairwiseCompare(e, (int e, int a) => a < e, 'less than'),
+ 'Expected: pairwise less than [1, 4, 9] '
+ 'Actual: [1, 2, 3] '
+ 'Which: has <1> which is not less than <1> at index 0');
+ shouldPass(
+ d, pairwiseCompare(e, (int e, int a) => a * a == e, 'square root of'));
+ shouldFail(
+ d,
+ pairwiseCompare(e, (int e, int a) => a + a == e, 'double'),
+ 'Expected: pairwise double [1, 4, 9] '
+ 'Actual: [1, 2, 3] '
+ 'Which: has <1> which is not double <1> at index 0');
+ shouldFail(
+ 'not an iterable',
+ pairwiseCompare(e, (int e, int a) => a + a == e, 'double'),
+ endsWith('not an <Instance of \'Iterable\'>'));
+ });
+
+ test('isEmpty', () {
+ var d = SimpleIterable(0);
+ var e = SimpleIterable(1);
+ shouldPass(d, isEmpty);
+ shouldFail(
+ e,
+ isEmpty,
+ 'Expected: empty '
+ 'Actual: SimpleIterable:[1]');
+ });
+
+ test('isNotEmpty', () {
+ var d = SimpleIterable(0);
+ var e = SimpleIterable(1);
+ shouldPass(e, isNotEmpty);
+ shouldFail(
+ d,
+ isNotEmpty,
+ 'Expected: non-empty '
+ 'Actual: SimpleIterable:[]');
+ });
+
+ test('contains', () {
+ var d = SimpleIterable(3);
+ shouldPass(d, contains(2));
+ shouldFail(
+ d,
+ contains(5),
+ 'Expected: contains <5> '
+ 'Actual: SimpleIterable:[3, 2, 1] '
+ 'Which: does not contain <5>');
+ });
+}
diff --git a/pkgs/matcher/test/map_matchers_test.dart b/pkgs/matcher/test/map_matchers_test.dart
new file mode 100644
index 0000000..4c699ab
--- /dev/null
+++ b/pkgs/matcher/test/map_matchers_test.dart
@@ -0,0 +1,100 @@
+import 'package:matcher/matcher.dart'
+ show contains, containsValue, containsPair;
+import 'package:test/test.dart' show test;
+
+import 'test_utils.dart';
+
+void main() {
+ test('contains', () {
+ shouldPass({'a': 1}, contains('a'));
+ shouldPass({null: 1}, contains(null));
+ shouldFail(
+ {'a': 1},
+ contains(2),
+ 'Expected: contains <2> '
+ 'Actual: {\'a\': 1} '
+ 'Which: does not contain <2>',
+ );
+ shouldFail(
+ {'a': 1},
+ contains(null),
+ 'Expected: contains <null> '
+ 'Actual: {\'a\': 1} '
+ 'Which: does not contain <null>',
+ );
+ });
+
+ test('containsValue', () {
+ shouldPass({'a': 1, 'null': null}, containsValue(1));
+ shouldPass({'a': 1, 'null': null}, containsValue(null));
+ shouldFail(
+ {'a': 1, 'null': null},
+ containsValue(2),
+ 'Expected: contains value <2> '
+ "Actual: {'a': 1, 'null': null}",
+ );
+ });
+
+ test('containsPair', () {
+ shouldPass({'a': 1, 'null': null}, containsPair('a', 1));
+ shouldPass({'a': 1, 'null': null}, containsPair('null', null));
+ shouldPass({null: null}, containsPair(null, null));
+ shouldFail(
+ {'a': 1, 'null': null},
+ containsPair('a', 2),
+ "Expected: contains pair 'a' => <2> "
+ "Actual: {'a': 1, 'null': null} "
+ "Which: contains key 'a' but with value is <1>",
+ );
+ shouldFail(
+ {'a': 1, 'null': null},
+ containsPair('b', 1),
+ "Expected: contains pair 'b' => <1> "
+ "Actual: {'a': 1, 'null': null} "
+ "Which: doesn't contain key 'b'",
+ );
+ shouldFail(
+ {'a': 1, 'null': null},
+ containsPair('null', 2),
+ "Expected: contains pair 'null' => <2> "
+ "Actual: {'a': 1, 'null': null} "
+ "Which: contains key 'null' but with value is <null>",
+ );
+ shouldFail(
+ {'a': 1, 'null': null},
+ containsPair('2', null),
+ "Expected: contains pair '2' => <null> "
+ "Actual: {'a': 1, 'null': null} "
+ "Which: doesn't contain key '2'",
+ );
+ shouldFail(
+ {'a': 1, 'null': null},
+ containsPair('2', 'b'),
+ "Expected: contains pair '2' => 'b' "
+ "Actual: {'a': 1, 'null': null} "
+ "Which: doesn't contain key '2'",
+ );
+ shouldFail(
+ {null: null},
+ containsPair('not null', null),
+ "Expected: contains pair 'not null' => <null> "
+ 'Actual: {null: null} '
+ "Which: doesn't contain key 'not null'",
+ );
+ shouldFail(
+ {null: null},
+ containsPair(null, 'not null'),
+ 'Expected: contains pair <null> => \'not null\' '
+ 'Actual: {null: null} '
+ 'Which: contains key <null> but with value not an '
+ '<Instance of \'String\'>',
+ );
+ shouldFail(
+ {null: null},
+ containsPair('not null', 'not null'),
+ 'Expected: contains pair \'not null\' => \'not null\' '
+ 'Actual: {null: null} '
+ 'Which: doesn\'t contain key \'not null\' ',
+ );
+ });
+}
diff --git a/pkgs/matcher/test/matcher/completion_test.dart b/pkgs/matcher/test/matcher/completion_test.dart
new file mode 100644
index 0000000..9259cd1
--- /dev/null
+++ b/pkgs/matcher/test/matcher/completion_test.dart
@@ -0,0 +1,192 @@
+// Copyright (c) 2015, 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:test/test.dart';
+import 'package:test_api/hooks_testing.dart';
+
+import '../utils_new.dart';
+
+void main() {
+ group('[doesNotComplete]', () {
+ test('fails when provided a non future', () async {
+ var monitor = await TestCaseMonitor.run(() {
+ expect(10, doesNotComplete);
+ });
+
+ expectTestFailed(monitor, contains('10 is not a Future'));
+ });
+
+ test('succeeds when a future does not complete', () {
+ var completer = Completer();
+ expect(completer.future, doesNotComplete);
+ });
+
+ test('fails when a future does complete', () async {
+ var monitor = await TestCaseMonitor.run(() {
+ var completer = Completer();
+ completer.complete(null);
+ expect(completer.future, doesNotComplete);
+ });
+
+ expectTestFailed(
+ monitor,
+ 'Future was not expected to complete but completed with a value of'
+ ' null');
+ });
+
+ test('fails when a future completes after the expect', () async {
+ var monitor = await TestCaseMonitor.run(() {
+ var completer = Completer();
+ expect(completer.future, doesNotComplete);
+ completer.complete(null);
+ });
+
+ expectTestFailed(
+ monitor,
+ 'Future was not expected to complete but completed with a value of'
+ ' null');
+ });
+
+ test('fails when a future eventually completes', () async {
+ var monitor = await TestCaseMonitor.run(() {
+ var completer = Completer();
+ expect(completer.future, doesNotComplete);
+ Future(() async {
+ await pumpEventQueue(times: 10);
+ }).then(completer.complete);
+ });
+
+ expectTestFailed(
+ monitor,
+ 'Future was not expected to complete but completed with a value of'
+ ' null');
+ });
+ });
+ group('[completes]', () {
+ test('blocks the test until the Future completes', () async {
+ final completer = Completer<void>();
+ final monitor = TestCaseMonitor.start(() {
+ expect(completer.future, completes);
+ });
+ await pumpEventQueue();
+ expect(monitor.state, State.running);
+ completer.complete();
+ await monitor.onDone;
+ expectTestPassed(monitor);
+ });
+
+ test('with an error', () async {
+ var monitor = await TestCaseMonitor.run(() {
+ expect(Future.error('X'), completes);
+ });
+
+ expect(monitor.state, equals(State.failed));
+ expect(monitor.errors, [isAsyncError(equals('X'))]);
+ });
+
+ test('with a failure', () async {
+ var monitor = await TestCaseMonitor.run(() {
+ expect(Future.error(TestFailure('oh no')), completes);
+ });
+
+ expectTestFailed(monitor, 'oh no');
+ });
+
+ test('with a non-future', () async {
+ var monitor = await TestCaseMonitor.run(() {
+ expect(10, completes);
+ });
+
+ expectTestFailed(
+ monitor,
+ 'Expected: completes successfully\n'
+ ' Actual: <10>\n'
+ ' Which: was not a Future\n');
+ });
+
+ test('with a successful future', () {
+ expect(Future.value('1'), completes);
+ });
+ });
+
+ group('[completion]', () {
+ test('blocks the test until the Future completes', () async {
+ final completer = Completer<Object?>();
+ final monitor = TestCaseMonitor.start(() {
+ expect(completer.future, completion(isNull));
+ });
+ await pumpEventQueue();
+ expect(monitor.state, State.running);
+ completer.complete(null);
+ await monitor.onDone;
+ expectTestPassed(monitor);
+ });
+
+ test('with an error', () async {
+ var monitor = await TestCaseMonitor.run(() {
+ expect(Future.error('X'), completion(isNull));
+ });
+
+ expect(monitor.state, equals(State.failed));
+ expect(monitor.errors, [isAsyncError(equals('X'))]);
+ });
+
+ test('with a failure', () async {
+ var monitor = await TestCaseMonitor.run(() {
+ expect(Future.error(TestFailure('oh no')), completion(isNull));
+ });
+
+ expectTestFailed(monitor, 'oh no');
+ });
+
+ test('with a non-future', () async {
+ var monitor = await TestCaseMonitor.run(() {
+ expect(10, completion(equals(10)));
+ });
+
+ expectTestFailed(
+ monitor,
+ 'Expected: completes to a value that <10>\n'
+ ' Actual: <10>\n'
+ ' Which: was not a Future\n');
+ });
+
+ test('with an incorrect value', () async {
+ var monitor = await TestCaseMonitor.run(() {
+ expect(Future.value('a'), completion(equals('b')));
+ });
+
+ expectTestFailed(
+ monitor,
+ allOf([
+ startsWith("Expected: completes to a value that 'b'\n"
+ ' Actual: <'),
+ endsWith('>\n'
+ " Which: emitted 'a'\n"
+ ' which is different.\n'
+ ' Expected: b\n'
+ ' Actual: a\n'
+ ' ^\n'
+ ' Differ at offset 0\n')
+ ]));
+ });
+
+ test("blocks expectLater's Future", () async {
+ var completer = Completer();
+ var fired = false;
+ unawaited(expectLater(completer.future, completion(equals(1))).then((_) {
+ fired = true;
+ }));
+
+ await pumpEventQueue();
+ expect(fired, isFalse);
+
+ completer.complete(1);
+ await pumpEventQueue();
+ expect(fired, isTrue);
+ });
+ });
+}
diff --git a/pkgs/matcher/test/matcher/prints_test.dart b/pkgs/matcher/test/matcher/prints_test.dart
new file mode 100644
index 0000000..cbdb12a
--- /dev/null
+++ b/pkgs/matcher/test/matcher/prints_test.dart
@@ -0,0 +1,208 @@
+// Copyright (c) 2014, 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:test/test.dart';
+import 'package:test_api/hooks_testing.dart';
+
+import '../utils_new.dart';
+
+void main() {
+ group('synchronous', () {
+ test('passes with an expected print', () {
+ expect(() => print('Hello, world!'), prints('Hello, world!\n'));
+ });
+
+ test('combines multiple prints', () {
+ expect(() {
+ print('Hello');
+ print('World!');
+ }, prints('Hello\nWorld!\n'));
+ });
+
+ test('works with a Matcher', () {
+ expect(() => print('Hello, world!'), prints(contains('Hello')));
+ });
+
+ test('describes a failure nicely', () async {
+ void local() => print('Hello, world!');
+ var monitor = await TestCaseMonitor.run(() {
+ expect(local, prints('Goodbye, world!\n'));
+ });
+
+ expectTestFailed(
+ monitor,
+ allOf([
+ startsWith("Expected: prints 'Goodbye, world!\\n'\n"
+ " ''\n"
+ ' Actual: <'),
+ endsWith('>\n'
+ " Which: printed 'Hello, world!\\n'\n"
+ " ''\n"
+ ' which is different.\n'
+ ' Expected: Goodbye, w ...\n'
+ ' Actual: Hello, wor ...\n'
+ ' ^\n'
+ ' Differ at offset 0\n')
+ ]));
+ });
+
+ test('describes a failure with a non-descriptive Matcher nicely', () async {
+ void local() => print('Hello, world!');
+ var monitor = await TestCaseMonitor.run(() {
+ expect(local, prints(contains('Goodbye')));
+ });
+
+ expectTestFailed(
+ monitor,
+ allOf([
+ startsWith("Expected: prints contains 'Goodbye'\n"
+ ' Actual: <'),
+ endsWith('>\n'
+ " Which: printed 'Hello, world!\\n'\n"
+ " ''\n"
+ ' which does not contain \'Goodbye\'\n')
+ ]));
+ });
+
+ test('describes a failure with no text nicely', () async {
+ void local() {}
+ var monitor = await TestCaseMonitor.run(() {
+ expect(local, prints(contains('Goodbye')));
+ });
+
+ expectTestFailed(
+ monitor,
+ allOf([
+ startsWith("Expected: prints contains 'Goodbye'\n"
+ ' Actual: <'),
+ endsWith('>\n'
+ ' Which: printed nothing\n'
+ ' which does not contain \'Goodbye\'\n')
+ ]));
+ });
+
+ test('with a non-function', () async {
+ var monitor = await TestCaseMonitor.run(() {
+ expect(10, prints(contains('Goodbye')));
+ });
+
+ expectTestFailed(
+ monitor,
+ "Expected: prints contains 'Goodbye'\n"
+ ' Actual: <10>\n'
+ ' Which: was not a unary Function\n');
+ });
+ });
+
+ group('asynchronous', () {
+ test('passes with an expected print', () {
+ expect(() => Future(() => print('Hello, world!')),
+ prints('Hello, world!\n'));
+ });
+
+ test('combines multiple prints', () {
+ expect(
+ () => Future(() {
+ print('Hello');
+ print('World!');
+ }),
+ prints('Hello\nWorld!\n'));
+ });
+
+ test('works with a Matcher', () {
+ expect(() => Future(() => print('Hello, world!')),
+ prints(contains('Hello')));
+ });
+
+ test('describes a failure nicely', () async {
+ void local() => Future(() => print('Hello, world!'));
+ var monitor = await TestCaseMonitor.run(() {
+ expect(local, prints('Goodbye, world!\n'));
+ });
+
+ expectTestFailed(
+ monitor,
+ allOf([
+ startsWith("Expected: prints 'Goodbye, world!\\n'\n"
+ " ''\n"
+ ' Actual: <'),
+ contains('>\n'
+ " Which: printed 'Hello, world!\\n'\n"
+ " ''\n"
+ ' which is different.\n'
+ ' Expected: Goodbye, w ...\n'
+ ' Actual: Hello, wor ...\n'
+ ' ^\n'
+ ' Differ at offset 0')
+ ]));
+ });
+
+ test('describes a failure with a non-descriptive Matcher nicely', () async {
+ void local() => Future(() => print('Hello, world!'));
+ var monitor = await TestCaseMonitor.run(() {
+ expect(local, prints(contains('Goodbye')));
+ });
+
+ expectTestFailed(
+ monitor,
+ allOf([
+ startsWith("Expected: prints contains 'Goodbye'\n"
+ ' Actual: <'),
+ contains('>\n'
+ " Which: printed 'Hello, world!\\n'\n"
+ " ''")
+ ]));
+ });
+
+ test('describes a failure with no text nicely', () async {
+ void local() => Future.value();
+ var monitor = await TestCaseMonitor.run(() {
+ expect(local, prints(contains('Goodbye')));
+ });
+
+ expectTestFailed(
+ monitor,
+ allOf([
+ startsWith("Expected: prints contains 'Goodbye'\n"
+ ' Actual: <'),
+ contains('>\n'
+ ' Which: printed nothing')
+ ]));
+ });
+
+ test("won't let the test end until the Future completes", () async {
+ final completer = Completer<void>();
+ final monitor = TestCaseMonitor.start(() {
+ expect(() => completer.future, prints(isEmpty));
+ });
+ await pumpEventQueue();
+ expect(monitor.state, State.running);
+ completer.complete();
+ await monitor.onDone;
+ expectTestPassed(monitor);
+ });
+
+ test("blocks expectLater's Future", () async {
+ var completer = Completer();
+ var fired = false;
+
+ unawaited(expectLater(() {
+ scheduleMicrotask(() => print('hello!'));
+ return completer.future;
+ }, prints('hello!\n'))
+ .then((_) {
+ fired = true;
+ }));
+
+ await pumpEventQueue();
+ expect(fired, isFalse);
+
+ completer.complete();
+ await pumpEventQueue();
+ expect(fired, isTrue);
+ });
+ });
+}
diff --git a/pkgs/matcher/test/matcher/throws_test.dart b/pkgs/matcher/test/matcher/throws_test.dart
new file mode 100644
index 0000000..25b93a9
--- /dev/null
+++ b/pkgs/matcher/test/matcher/throws_test.dart
@@ -0,0 +1,282 @@
+// Copyright (c) 2015, 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.
+
+// ignore_for_file: only_throw_errors
+
+import 'dart:async';
+
+import 'package:test/test.dart';
+import 'package:test_api/hooks_testing.dart';
+
+import '../utils_new.dart';
+
+void main() {
+ group('synchronous', () {
+ group('[throws]', () {
+ test('with a function that throws an error', () {
+ // ignore: deprecated_member_use_from_same_package
+ expect(() => throw 'oh no', throws);
+ });
+
+ test("with a function that doesn't throw", () async {
+ void local() {}
+ var monitor = await TestCaseMonitor.run(() {
+ // ignore: deprecated_member_use_from_same_package
+ expect(local, throws);
+ });
+
+ expectTestFailed(
+ monitor,
+ allOf([
+ startsWith('Expected: throws\n'
+ ' Actual: <'),
+ endsWith('>\n'
+ ' Which: returned <null>\n')
+ ]));
+ });
+
+ test('with a non-function', () async {
+ var monitor = await TestCaseMonitor.run(() {
+ // ignore: deprecated_member_use_from_same_package
+ expect(10, throws);
+ });
+
+ expectTestFailed(
+ monitor,
+ 'Expected: throws\n'
+ ' Actual: <10>\n'
+ ' Which: was not a Function or Future\n');
+ });
+ });
+
+ group('[throwsA]', () {
+ test('with a function that throws an identical error', () {
+ expect(() => throw 'oh no', throwsA('oh no'));
+ });
+
+ test('with a function that throws a matching error', () {
+ expect(() => throw const FormatException('bad'),
+ throwsA(isFormatException));
+ });
+
+ test("with a function that doesn't throw", () async {
+ void local() {}
+ var monitor = await TestCaseMonitor.run(() {
+ expect(local, throwsA('oh no'));
+ });
+
+ expectTestFailed(
+ monitor,
+ allOf([
+ startsWith("Expected: throws 'oh no'\n"
+ ' Actual: <'),
+ endsWith('>\n'
+ ' Which: returned <null>\n')
+ ]));
+ });
+
+ test('with a non-function', () async {
+ var monitor = await TestCaseMonitor.run(() {
+ expect(10, throwsA('oh no'));
+ });
+
+ expectTestFailed(
+ monitor,
+ "Expected: throws 'oh no'\n"
+ ' Actual: <10>\n'
+ ' Which: was not a Function or Future\n');
+ });
+
+ test('with a function that throws the wrong error', () async {
+ var monitor = await TestCaseMonitor.run(() {
+ expect(() => throw 'aw dang', throwsA('oh no'));
+ });
+
+ expectTestFailed(
+ monitor,
+ allOf([
+ startsWith("Expected: throws 'oh no'\n"
+ ' Actual: <'),
+ contains('>\n'
+ " Which: threw 'aw dang'\n"
+ ' stack'),
+ endsWith(' which is different.\n'
+ ' Expected: oh no\n'
+ ' Actual: aw dang\n'
+ ' ^\n'
+ ' Differ at offset 0\n')
+ ]));
+ });
+ });
+ });
+
+ group('asynchronous', () {
+ group('[throws]', () {
+ test('with a Future that throws an error', () {
+ // ignore: deprecated_member_use_from_same_package
+ expect(Future.error('oh no'), throws);
+ });
+
+ test("with a Future that doesn't throw", () async {
+ var monitor = await TestCaseMonitor.run(() {
+ // ignore: deprecated_member_use_from_same_package
+ expect(Future.value(), throws);
+ });
+
+ expectTestFailed(
+ monitor,
+ allOf([
+ startsWith('Expected: throws\n'
+ ' Actual: <'),
+ endsWith('>\n'
+ ' Which: emitted <null>\n')
+ ]));
+ });
+
+ test('with a closure that returns a Future that throws an error', () {
+ // ignore: deprecated_member_use_from_same_package
+ expect(() => Future.error('oh no'), throws);
+ });
+
+ test("with a closure that returns a Future that doesn't throw", () async {
+ var monitor = await TestCaseMonitor.run(() {
+ // ignore: deprecated_member_use_from_same_package
+ expect(Future.value, throws);
+ });
+
+ expectTestFailed(
+ monitor,
+ allOf([
+ startsWith('Expected: throws\n'
+ ' Actual: <'),
+ endsWith('>\n'
+ ' Which: returned a Future that emitted <null>\n')
+ ]));
+ });
+
+ test("won't let the test end until the Future completes", () async {
+ late void Function() callback;
+ final monitor = TestCaseMonitor.start(() {
+ final completer = Completer<void>();
+ // ignore: deprecated_member_use_from_same_package
+ expect(completer.future, throws);
+ callback = () => completer.completeError('oh no');
+ });
+ await pumpEventQueue();
+ expect(monitor.state, State.running);
+ callback();
+ await monitor.onDone;
+ expectTestPassed(monitor);
+ });
+ });
+
+ group('[throwsA]', () {
+ test('with a Future that throws an identical error', () {
+ expect(Future.error('oh no'), throwsA('oh no'));
+ });
+
+ test('with a Future that throws a matching error', () {
+ expect(Future.error(const FormatException('bad')),
+ throwsA(isFormatException));
+ });
+
+ test("with a Future that doesn't throw", () async {
+ var monitor = await TestCaseMonitor.run(() {
+ expect(Future.value(), throwsA('oh no'));
+ });
+
+ expectTestFailed(
+ monitor,
+ allOf([
+ startsWith("Expected: throws 'oh no'\n"
+ ' Actual: <'),
+ endsWith('>\n'
+ ' Which: emitted <null>\n')
+ ]));
+ });
+
+ test('with a Future that throws the wrong error', () async {
+ var monitor = await TestCaseMonitor.run(() {
+ expect(Future.error('aw dang'), throwsA('oh no'));
+ });
+
+ expectTestFailed(
+ monitor,
+ allOf([
+ startsWith("Expected: throws 'oh no'\n"
+ ' Actual: <'),
+ contains('>\n'
+ " Which: threw 'aw dang'\n")
+ ]));
+ });
+
+ test('with a closure that returns a Future that throws a matching error',
+ () {
+ expect(() => Future.error(const FormatException('bad')),
+ throwsA(isFormatException));
+ });
+
+ test("with a closure that returns a Future that doesn't throw", () async {
+ var monitor = await TestCaseMonitor.run(() {
+ expect(Future.value, throwsA('oh no'));
+ });
+
+ expectTestFailed(
+ monitor,
+ allOf([
+ startsWith("Expected: throws 'oh no'\n"
+ ' Actual: <'),
+ endsWith('>\n'
+ ' Which: returned a Future that emitted <null>\n')
+ ]));
+ });
+
+ test('with closure that returns a Future that throws the wrong error',
+ () async {
+ var monitor = await TestCaseMonitor.run(() {
+ expect(() => Future.error('aw dang'), throwsA('oh no'));
+ });
+
+ expectTestFailed(
+ monitor,
+ allOf([
+ startsWith("Expected: throws 'oh no'\n"
+ ' Actual: <'),
+ contains('>\n'
+ " Which: threw 'aw dang'\n")
+ ]));
+ });
+
+ test("won't let the test end until the Future completes", () async {
+ late void Function() callback;
+ final monitor = TestCaseMonitor.start(() {
+ final completer = Completer<void>();
+ expect(completer.future, throwsA('oh no'));
+ callback = () => completer.completeError('oh no');
+ });
+ await pumpEventQueue();
+ expect(monitor.state, State.running);
+ callback();
+ await monitor.onDone;
+
+ expectTestPassed(monitor);
+ });
+
+ test("blocks expectLater's Future", () async {
+ var completer = Completer();
+ var fired = false;
+ unawaited(expectLater(completer.future, throwsArgumentError).then((_) {
+ fired = true;
+ }));
+
+ await pumpEventQueue();
+ expect(fired, isFalse);
+
+ completer.completeError(ArgumentError('oh no'));
+ await pumpEventQueue();
+ expect(fired, isTrue);
+ });
+ });
+ });
+}
diff --git a/pkgs/matcher/test/matcher/throws_type_test.dart b/pkgs/matcher/test/matcher/throws_type_test.dart
new file mode 100644
index 0000000..557a73a
--- /dev/null
+++ b/pkgs/matcher/test/matcher/throws_type_test.dart
@@ -0,0 +1,177 @@
+// Copyright (c) 2015, 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.
+
+// ignore_for_file: only_throw_errors
+
+import 'package:test/test.dart';
+import 'package:test_api/hooks_testing.dart';
+
+import '../utils_new.dart';
+
+void main() {
+ group('[throwsArgumentError]', () {
+ test('passes when a ArgumentError is thrown', () {
+ expect(() => throw ArgumentError(''), throwsArgumentError);
+ });
+
+ test('fails when a non-ArgumentError is thrown', () async {
+ var liveTest = await TestCaseMonitor.run(() {
+ expect(() => throw Exception(), throwsArgumentError);
+ });
+
+ expectTestFailed(liveTest,
+ startsWith("Expected: throws <Instance of 'ArgumentError'>"));
+ });
+ });
+
+ group('[throwsConcurrentModificationError]', () {
+ test('passes when a ConcurrentModificationError is thrown', () {
+ expect(() => throw ConcurrentModificationError(''),
+ throwsConcurrentModificationError);
+ });
+
+ test('fails when a non-ConcurrentModificationError is thrown', () async {
+ var liveTest = await TestCaseMonitor.run(() {
+ expect(() => throw Exception(), throwsConcurrentModificationError);
+ });
+
+ expectTestFailed(
+ liveTest,
+ startsWith(
+ "Expected: throws <Instance of 'ConcurrentModificationError'>"));
+ });
+ });
+
+ group('[throwsCyclicInitializationError]', () {
+ test('passes when a CyclicInitializationError is thrown', () {
+ expect(
+ () => _CyclicInitializationFailure().x,
+ // ignore: deprecated_member_use_from_same_package
+ throwsCyclicInitializationError);
+ });
+
+ test('fails when a non-CyclicInitializationError is thrown', () async {
+ var liveTest = await TestCaseMonitor.run(() {
+ // ignore: deprecated_member_use_from_same_package
+ expect(() => throw Exception(), throwsCyclicInitializationError);
+ });
+
+ expectTestFailed(
+ liveTest, startsWith("Expected: throws <Instance of 'Error'>"));
+ });
+ });
+
+ group('[throwsException]', () {
+ test('passes when a Exception is thrown', () {
+ expect(() => throw Exception(''), throwsException);
+ });
+
+ test('fails when a non-Exception is thrown', () async {
+ var liveTest = await TestCaseMonitor.run(() {
+ expect(() => throw 'oh no', throwsException);
+ });
+
+ expectTestFailed(
+ liveTest, startsWith("Expected: throws <Instance of 'Exception'>"));
+ });
+ });
+
+ group('[throwsFormatException]', () {
+ test('passes when a FormatException is thrown', () {
+ expect(() => throw const FormatException(''), throwsFormatException);
+ });
+
+ test('fails when a non-FormatException is thrown', () async {
+ var liveTest = await TestCaseMonitor.run(() {
+ expect(() => throw Exception(), throwsFormatException);
+ });
+
+ expectTestFailed(liveTest,
+ startsWith("Expected: throws <Instance of 'FormatException'>"));
+ });
+ });
+
+ group('[throwsNoSuchMethodError]', () {
+ test('passes when a NoSuchMethodError is thrown', () {
+ expect(() {
+ // ignore: avoid_dynamic_calls
+ (1 as dynamic).notAMethodOnInt();
+ }, throwsNoSuchMethodError);
+ });
+
+ test('fails when a non-NoSuchMethodError is thrown', () async {
+ var liveTest = await TestCaseMonitor.run(() {
+ expect(() => throw Exception(), throwsNoSuchMethodError);
+ });
+
+ expectTestFailed(liveTest,
+ startsWith("Expected: throws <Instance of 'NoSuchMethodError'>"));
+ });
+ });
+
+ group('[throwsRangeError]', () {
+ test('passes when a RangeError is thrown', () {
+ expect(() => throw RangeError(''), throwsRangeError);
+ });
+
+ test('fails when a non-RangeError is thrown', () async {
+ var liveTest = await TestCaseMonitor.run(() {
+ expect(() => throw Exception(), throwsRangeError);
+ });
+
+ expectTestFailed(
+ liveTest, startsWith("Expected: throws <Instance of 'RangeError'>"));
+ });
+ });
+
+ group('[throwsStateError]', () {
+ test('passes when a StateError is thrown', () {
+ expect(() => throw StateError(''), throwsStateError);
+ });
+
+ test('fails when a non-StateError is thrown', () async {
+ var liveTest = await TestCaseMonitor.run(() {
+ expect(() => throw Exception(), throwsStateError);
+ });
+
+ expectTestFailed(
+ liveTest, startsWith("Expected: throws <Instance of 'StateError'>"));
+ });
+ });
+
+ group('[throwsUnimplementedError]', () {
+ test('passes when a UnimplementedError is thrown', () {
+ expect(() => throw UnimplementedError(''), throwsUnimplementedError);
+ });
+
+ test('fails when a non-UnimplementedError is thrown', () async {
+ var liveTest = await TestCaseMonitor.run(() {
+ expect(() => throw Exception(), throwsUnimplementedError);
+ });
+
+ expectTestFailed(liveTest,
+ startsWith("Expected: throws <Instance of 'UnimplementedError'>"));
+ });
+ });
+
+ group('[throwsUnsupportedError]', () {
+ test('passes when a UnsupportedError is thrown', () {
+ expect(() => throw UnsupportedError(''), throwsUnsupportedError);
+ });
+
+ test('fails when a non-UnsupportedError is thrown', () async {
+ var liveTest = await TestCaseMonitor.run(() {
+ expect(() => throw Exception(), throwsUnsupportedError);
+ });
+
+ expectTestFailed(liveTest,
+ startsWith("Expected: throws <Instance of 'UnsupportedError'>"));
+ });
+ });
+}
+
+class _CyclicInitializationFailure {
+ late int x = y;
+ late int y = x;
+}
diff --git a/pkgs/matcher/test/mirror_matchers_test.dart b/pkgs/matcher/test/mirror_matchers_test.dart
new file mode 100644
index 0000000..06f0df4
--- /dev/null
+++ b/pkgs/matcher/test/mirror_matchers_test.dart
@@ -0,0 +1,56 @@
+// Copyright (c) 2012, 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.
+
+// ignore_for_file: deprecated_member_use_from_same_package
+
+@TestOn('vm')
+library;
+
+import 'package:matcher/mirror_matchers.dart';
+import 'package:test/test.dart';
+
+import 'test_utils.dart';
+
+class C {
+ int instanceField = 1;
+ int get instanceGetter => 2;
+ static int staticField = 3;
+ static int get staticGetter => 4;
+}
+
+void main() {
+ test('hasProperty', () {
+ var foo = [3];
+ shouldPass(foo, hasProperty('length', 1));
+ shouldFail(
+ foo,
+ hasProperty('foo'),
+ 'Expected: has property "foo" '
+ 'Actual: [3] '
+ 'Which: has no property named "foo"');
+ shouldFail(
+ foo,
+ hasProperty('length', 2),
+ 'Expected: has property "length" which matches <2> '
+ 'Actual: [3] '
+ 'Which: has property "length" with value <1>');
+ var c = C();
+ shouldPass(c, hasProperty('instanceField', 1));
+ shouldPass(c, hasProperty('instanceGetter', 2));
+ shouldFail(
+ c,
+ hasProperty('staticField'),
+ 'Expected: has property "staticField" '
+ 'Actual: <Instance of \'C\'> '
+ 'Which: has a member named "staticField",'
+ ' but it is not an instance property');
+ shouldFail(
+ c,
+ hasProperty('staticGetter'),
+ 'Expected: has property "staticGetter" '
+ 'Actual: <Instance of \'C\'> '
+ 'Which: has a member named "staticGetter",'
+ ' but it is not an instance property');
+ });
+}
diff --git a/pkgs/matcher/test/never_called_test.dart b/pkgs/matcher/test/never_called_test.dart
new file mode 100644
index 0000000..4c83e39
--- /dev/null
+++ b/pkgs/matcher/test/never_called_test.dart
@@ -0,0 +1,75 @@
+// Copyright (c) 2017, 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 'package:term_glyph/term_glyph.dart' as glyph;
+import 'package:test/test.dart';
+import 'package:test_api/hooks_testing.dart';
+
+import 'utils_new.dart';
+
+void main() {
+ setUpAll(() {
+ glyph.ascii = true;
+ });
+
+ test("doesn't throw if it isn't called", () async {
+ var monitor = await TestCaseMonitor.run(() {
+ const Stream.empty().listen(neverCalled);
+ });
+
+ expectTestPassed(monitor);
+ });
+
+ group("if it's called", () {
+ test('throws', () async {
+ var monitor = await TestCaseMonitor.run(() {
+ neverCalled();
+ });
+
+ expectTestFailed(
+ monitor,
+ 'Callback should never have been called, but it was called with no '
+ 'arguments.');
+ });
+
+ test('pretty-prints arguments', () async {
+ var monitor = await TestCaseMonitor.run(() {
+ neverCalled(1, 'foo\nbar');
+ });
+
+ expectTestFailed(
+ monitor,
+ 'Callback should never have been called, but it was called with:\n'
+ '* <1>\n'
+ "* 'foo\\n'\n"
+ " 'bar'");
+ });
+
+ test('keeps the test alive', () async {
+ var monitor = await TestCaseMonitor.run(() {
+ pumpEventQueue(times: 10).then(neverCalled);
+ });
+
+ expectTestFailed(
+ monitor,
+ 'Callback should never have been called, but it was called with:\n'
+ '* <null>');
+ });
+
+ test("can't be caught", () async {
+ var monitor = await TestCaseMonitor.run(() {
+ try {
+ neverCalled();
+ } catch (_) {
+ // Do nothing.
+ }
+ });
+
+ expectTestFailed(
+ monitor,
+ 'Callback should never have been called, but it was called with '
+ 'no arguments.');
+ });
+ });
+}
diff --git a/pkgs/matcher/test/numeric_matchers_test.dart b/pkgs/matcher/test/numeric_matchers_test.dart
new file mode 100644
index 0000000..3919588
--- /dev/null
+++ b/pkgs/matcher/test/numeric_matchers_test.dart
@@ -0,0 +1,98 @@
+// Copyright (c) 2012, 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 'package:test/test.dart';
+
+import 'test_utils.dart';
+
+void main() {
+ test('closeTo', () {
+ shouldPass(0, closeTo(0, 1));
+ shouldPass(-1, closeTo(0, 1));
+ shouldPass(1, closeTo(0, 1));
+ shouldFail(
+ 1.001,
+ closeTo(0, 1),
+ 'Expected: a numeric value within <1> of <0> '
+ 'Actual: <1.001> '
+ 'Which: differs by <1.001>');
+ shouldFail(
+ -1.001,
+ closeTo(0, 1),
+ 'Expected: a numeric value within <1> of <0> '
+ 'Actual: <-1.001> '
+ 'Which: differs by <1.001>');
+ shouldFail(
+ 'not a num', closeTo(0, 1), endsWith('not an <Instance of \'num\'>'));
+ });
+
+ test('inInclusiveRange', () {
+ shouldFail(
+ -1,
+ inInclusiveRange(0, 2),
+ 'Expected: be in range from 0 (inclusive) to 2 (inclusive) '
+ 'Actual: <-1>');
+ shouldPass(0, inInclusiveRange(0, 2));
+ shouldPass(1, inInclusiveRange(0, 2));
+ shouldPass(2, inInclusiveRange(0, 2));
+ shouldFail(
+ 3,
+ inInclusiveRange(0, 2),
+ 'Expected: be in range from 0 (inclusive) to 2 (inclusive) '
+ 'Actual: <3>');
+ shouldFail('not a num', inInclusiveRange(0, 1),
+ endsWith('not an <Instance of \'num\'>'));
+ });
+
+ test('inExclusiveRange', () {
+ shouldFail(
+ 0,
+ inExclusiveRange(0, 2),
+ 'Expected: be in range from 0 (exclusive) to 2 (exclusive) '
+ 'Actual: <0>');
+ shouldPass(1, inExclusiveRange(0, 2));
+ shouldFail(
+ 2,
+ inExclusiveRange(0, 2),
+ 'Expected: be in range from 0 (exclusive) to 2 (exclusive) '
+ 'Actual: <2>');
+ shouldFail('not a num', inExclusiveRange(0, 1),
+ endsWith('not an <Instance of \'num\'>'));
+ });
+
+ test('inOpenClosedRange', () {
+ shouldFail(
+ 0,
+ inOpenClosedRange(0, 2),
+ 'Expected: be in range from 0 (exclusive) to 2 (inclusive) '
+ 'Actual: <0>');
+ shouldPass(1, inOpenClosedRange(0, 2));
+ shouldPass(2, inOpenClosedRange(0, 2));
+ shouldFail('not a num', inOpenClosedRange(0, 1),
+ endsWith('not an <Instance of \'num\'>'));
+ });
+
+ test('inClosedOpenRange', () {
+ shouldPass(0, inClosedOpenRange(0, 2));
+ shouldPass(1, inClosedOpenRange(0, 2));
+ shouldFail(
+ 2,
+ inClosedOpenRange(0, 2),
+ 'Expected: be in range from 0 (inclusive) to 2 (exclusive) '
+ 'Actual: <2>');
+ shouldFail('not a num', inClosedOpenRange(0, 1),
+ endsWith('not an <Instance of \'num\'>'));
+ });
+
+ group('NaN', () {
+ test('inInclusiveRange', () {
+ shouldFail(
+ double.nan,
+ inExclusiveRange(double.negativeInfinity, double.infinity),
+ 'Expected: be in range from '
+ '-Infinity (exclusive) to Infinity (exclusive) '
+ 'Actual: <NaN>');
+ });
+ });
+}
diff --git a/pkgs/matcher/test/operator_matchers_test.dart b/pkgs/matcher/test/operator_matchers_test.dart
new file mode 100644
index 0000000..f4b6d3a
--- /dev/null
+++ b/pkgs/matcher/test/operator_matchers_test.dart
@@ -0,0 +1,63 @@
+// Copyright (c) 2012, 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 'package:matcher/matcher.dart';
+import 'package:test/test.dart' show test, expect, throwsArgumentError;
+
+import 'test_utils.dart';
+
+void main() {
+ test('anyOf', () {
+ // with a list
+ shouldFail(
+ 0, anyOf([equals(1), equals(2)]), 'Expected: (<1> or <2>) Actual: <0>');
+ shouldPass(1, anyOf([equals(1), equals(2)]));
+
+ // with individual items
+ shouldFail(
+ 0, anyOf(equals(1), equals(2)), 'Expected: (<1> or <2>) Actual: <0>');
+ shouldPass(1, anyOf(equals(1), equals(2)));
+ });
+
+ test('allOf', () {
+ // with a list
+ shouldPass(1, allOf([lessThan(10), greaterThan(0)]));
+ shouldFail(
+ -1,
+ allOf([lessThan(10), greaterThan(0)]),
+ 'Expected: (a value less than <10> and a value greater than <0>) '
+ 'Actual: <-1> '
+ 'Which: is not a value greater than <0>');
+
+ // with individual items
+ shouldPass(1, allOf(lessThan(10), greaterThan(0)));
+ shouldFail(
+ -1,
+ allOf(lessThan(10), greaterThan(0)),
+ 'Expected: (a value less than <10> and a value greater than <0>) '
+ 'Actual: <-1> '
+ 'Which: is not a value greater than <0>');
+
+ // with maximum items
+ shouldPass(
+ 1,
+ allOf(lessThan(10), lessThan(9), lessThan(8), lessThan(7), lessThan(6),
+ lessThan(5), lessThan(4)));
+ shouldFail(
+ 4,
+ allOf(lessThan(10), lessThan(9), lessThan(8), lessThan(7), lessThan(6),
+ lessThan(5), lessThan(4)),
+ 'Expected: (a value less than <10> and a value less than <9> and a '
+ 'value less than <8> and a value less than <7> and a value less than '
+ '<6> and a value less than <5> and a value less than <4>) '
+ 'Actual: <4> '
+ 'Which: is not a value less than <4>');
+ });
+
+ test('If the first argument is a List, the rest must be null', () {
+ expect(() => allOf([], 5), throwsArgumentError);
+ expect(
+ () => anyOf([], null, null, null, null, null, 42), throwsArgumentError);
+ });
+}
diff --git a/pkgs/matcher/test/order_matchers_test.dart b/pkgs/matcher/test/order_matchers_test.dart
new file mode 100644
index 0000000..8a7c3df
--- /dev/null
+++ b/pkgs/matcher/test/order_matchers_test.dart
@@ -0,0 +1,149 @@
+// Copyright (c) 2012, 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 'package:test/test.dart';
+
+import 'test_utils.dart';
+
+void main() {
+ test('greaterThan', () {
+ shouldPass(10, greaterThan(9));
+ shouldFail(
+ 9,
+ greaterThan(10),
+ 'Expected: a value greater than <10> '
+ 'Actual: <9> '
+ 'Which: is not a value greater than <10>');
+ });
+
+ test('greaterThanOrEqualTo', () {
+ shouldPass(10, greaterThanOrEqualTo(10));
+ shouldFail(
+ 9,
+ greaterThanOrEqualTo(10),
+ 'Expected: a value greater than or equal to <10> '
+ 'Actual: <9> '
+ 'Which: is not a value greater than or equal to <10>');
+ });
+
+ test('lessThan', () {
+ shouldFail(
+ 10,
+ lessThan(9),
+ 'Expected: a value less than <9> '
+ 'Actual: <10> '
+ 'Which: is not a value less than <9>');
+ shouldPass(9, lessThan(10));
+ });
+
+ test('lessThanOrEqualTo', () {
+ shouldPass(10, lessThanOrEqualTo(10));
+ shouldFail(
+ 11,
+ lessThanOrEqualTo(10),
+ 'Expected: a value less than or equal to <10> '
+ 'Actual: <11> '
+ 'Which: is not a value less than or equal to <10>');
+ });
+
+ test('isZero', () {
+ shouldPass(0, isZero);
+ shouldFail(
+ 1,
+ isZero,
+ 'Expected: a value equal to <0> '
+ 'Actual: <1> '
+ 'Which: is not a value equal to <0>');
+ });
+
+ test('isNonZero', () {
+ shouldFail(
+ 0,
+ isNonZero,
+ 'Expected: a value not equal to <0> '
+ 'Actual: <0> '
+ 'Which: is not a value not equal to <0>');
+ shouldPass(1, isNonZero);
+ });
+
+ test('isPositive', () {
+ shouldFail(
+ -1,
+ isPositive,
+ 'Expected: a positive value '
+ 'Actual: <-1> '
+ 'Which: is not a positive value');
+ shouldFail(
+ 0,
+ isPositive,
+ 'Expected: a positive value '
+ 'Actual: <0> '
+ 'Which: is not a positive value');
+ shouldPass(1, isPositive);
+ });
+
+ test('isNegative', () {
+ shouldPass(-1, isNegative);
+ shouldFail(
+ 0,
+ isNegative,
+ 'Expected: a negative value '
+ 'Actual: <0> '
+ 'Which: is not a negative value');
+ });
+
+ test('isNonPositive', () {
+ shouldPass(-1, isNonPositive);
+ shouldPass(0, isNonPositive);
+ shouldFail(
+ 1,
+ isNonPositive,
+ 'Expected: a non-positive value '
+ 'Actual: <1> '
+ 'Which: is not a non-positive value');
+ });
+
+ test('isNonNegative', () {
+ shouldPass(1, isNonNegative);
+ shouldPass(0, isNonNegative);
+ shouldFail(
+ -1,
+ isNonNegative,
+ 'Expected: a non-negative value '
+ 'Actual: <-1> '
+ 'Which: is not a non-negative value');
+ });
+
+ group('NaN', () {
+ test('greaterThan', () {
+ shouldFail(
+ double.nan,
+ greaterThan(10),
+ 'Expected: a value greater than <10> '
+ 'Actual: <NaN> '
+ 'Which: is not a value greater than <10>');
+ shouldFail(
+ 10,
+ greaterThan(double.nan),
+ 'Expected: a value greater than <NaN> '
+ 'Actual: <10> '
+ 'Which: is not a value greater than <NaN>');
+ });
+
+ test('lessThanOrEqualTo', () {
+ shouldFail(
+ double.nan,
+ lessThanOrEqualTo(10),
+ 'Expected: a value less than or equal to <10> '
+ 'Actual: <NaN> '
+ 'Which: is not a value less than or equal to <10>');
+ shouldFail(
+ 10,
+ lessThanOrEqualTo(double.nan),
+ 'Expected: a value less than or equal to <NaN> '
+ 'Actual: <10> '
+ 'Which: is not a value less than or equal to <NaN>');
+ });
+ });
+}
diff --git a/pkgs/matcher/test/pretty_print_test.dart b/pkgs/matcher/test/pretty_print_test.dart
new file mode 100644
index 0000000..184704b
--- /dev/null
+++ b/pkgs/matcher/test/pretty_print_test.dart
@@ -0,0 +1,263 @@
+// Copyright (c) 2013, 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:collection';
+
+import 'package:matcher/matcher.dart';
+import 'package:matcher/src/pretty_print.dart';
+import 'package:test/test.dart' show group, test, expect;
+
+class DefaultToString {}
+
+class CustomToString {
+ @override
+ String toString() => 'string representation';
+}
+
+class _PrivateName {
+ @override
+ String toString() => 'string representation';
+}
+
+class _PrivateNameIterable extends IterableMixin {
+ @override
+ Iterator get iterator => [1, 2, 3].iterator;
+}
+
+void main() {
+ test('with primitive objects', () {
+ expect(prettyPrint(12), equals('<12>'));
+ expect(prettyPrint(12.13), equals('<12.13>'));
+ expect(prettyPrint(true), equals('<true>'));
+ expect(prettyPrint(null), equals('<null>'));
+ expect(prettyPrint(() => 12), matches(r'<Closure.*>'));
+ });
+
+ group('with a string', () {
+ test('containing simple characters', () {
+ expect(prettyPrint('foo'), equals("'foo'"));
+ });
+
+ test('containing newlines', () {
+ expect(
+ prettyPrint('foo\nbar\nbaz'),
+ equals("'foo\\n'\n"
+ " 'bar\\n'\n"
+ " 'baz'"));
+ });
+
+ test('containing escapable characters', () {
+ expect(prettyPrint("foo\rbar\tbaz'qux\v"),
+ equals(r"'foo\rbar\tbaz\'qux\v'"));
+ });
+ });
+
+ group('with an iterable', () {
+ test('containing primitive objects', () {
+ expect(prettyPrint([1, true, 'foo']), equals("[1, true, 'foo']"));
+ });
+
+ test('containing a multiline string', () {
+ expect(
+ prettyPrint(['foo', 'bar\nbaz\nbip', 'qux']),
+ equals('[\n'
+ " 'foo',\n"
+ " 'bar\\n'\n"
+ " 'baz\\n'\n"
+ " 'bip',\n"
+ " 'qux'\n"
+ ']'));
+ });
+
+ test('containing a matcher', () {
+ expect(prettyPrint(['foo', endsWith('qux')]),
+ equals("['foo', <a string ending with 'qux'>]"));
+ });
+
+ test("that's under maxLineLength", () {
+ expect(prettyPrint([0, 1, 2, 3, 4, 5, 6, 7, 8, 9], maxLineLength: 30),
+ equals('[0, 1, 2, 3, 4, 5, 6, 7, 8, 9]'));
+ });
+
+ test("that's over maxLineLength", () {
+ expect(
+ prettyPrint([0, 1, 2, 3, 4, 5, 6, 7, 8, 9], maxLineLength: 29),
+ equals('[\n'
+ ' 0,\n'
+ ' 1,\n'
+ ' 2,\n'
+ ' 3,\n'
+ ' 4,\n'
+ ' 5,\n'
+ ' 6,\n'
+ ' 7,\n'
+ ' 8,\n'
+ ' 9\n'
+ ']'));
+ });
+
+ test('factors indentation into maxLineLength', () {
+ expect(
+ prettyPrint([
+ 'foo\nbar',
+ [0, 1, 2, 3, 4, 5, 6, 7, 8, 9],
+ ], maxLineLength: 30),
+ equals('[\n'
+ " 'foo\\n'\n"
+ " 'bar',\n"
+ ' [\n'
+ ' 0,\n'
+ ' 1,\n'
+ ' 2,\n'
+ ' 3,\n'
+ ' 4,\n'
+ ' 5,\n'
+ ' 6,\n'
+ ' 7,\n'
+ ' 8,\n'
+ ' 9\n'
+ ' ]\n'
+ ']'));
+ });
+
+ test("that's under maxItems", () {
+ expect(prettyPrint([0, 1, 2, 3, 4, 5, 6, 7, 8, 9], maxItems: 10),
+ equals('[0, 1, 2, 3, 4, 5, 6, 7, 8, 9]'));
+ });
+
+ test("that's over maxItems", () {
+ expect(prettyPrint([0, 1, 2, 3, 4, 5, 6, 7, 8, 9], maxItems: 9),
+ equals('[0, 1, 2, 3, 4, 5, 6, 7, ...]'));
+ });
+
+ test("that's recursive", () {
+ var list = <dynamic>[1, 2, 3];
+ list.add(list);
+ expect(prettyPrint(list), equals('[1, 2, 3, (recursive)]'));
+ });
+ });
+
+ group('with a map', () {
+ test('containing primitive objects', () {
+ expect(prettyPrint({'foo': 1, 'bar': true}),
+ equals("{'foo': 1, 'bar': true}"));
+ });
+
+ test('containing a multiline string key', () {
+ expect(
+ prettyPrint({'foo\nbar': 1, 'bar': true}),
+ equals('{\n'
+ " 'foo\\n'\n"
+ " 'bar': 1,\n"
+ " 'bar': true\n"
+ '}'));
+ });
+
+ test('containing a multiline string value', () {
+ expect(
+ prettyPrint({'foo': 'bar\nbaz', 'qux': true}),
+ equals('{\n'
+ " 'foo': 'bar\\n'\n"
+ " 'baz',\n"
+ " 'qux': true\n"
+ '}'));
+ });
+
+ test('containing a multiline string key/value pair', () {
+ expect(
+ prettyPrint({'foo\nbar': 'baz\nqux'}),
+ equals('{\n'
+ " 'foo\\n'\n"
+ " 'bar': 'baz\\n'\n"
+ " 'qux'\n"
+ '}'));
+ });
+
+ test('containing a matcher key', () {
+ expect(prettyPrint({endsWith('bar'): 'qux'}),
+ equals("{<a string ending with 'bar'>: 'qux'}"));
+ });
+
+ test('containing a matcher value', () {
+ expect(prettyPrint({'foo': endsWith('qux')}),
+ equals("{'foo': <a string ending with 'qux'>}"));
+ });
+
+ test("that's under maxLineLength", () {
+ expect(prettyPrint({'0': 1, '2': 3, '4': 5, '6': 7}, maxLineLength: 32),
+ equals("{'0': 1, '2': 3, '4': 5, '6': 7}"));
+ });
+
+ test("that's over maxLineLength", () {
+ expect(
+ prettyPrint({'0': 1, '2': 3, '4': 5, '6': 7}, maxLineLength: 31),
+ equals('{\n'
+ " '0': 1,\n"
+ " '2': 3,\n"
+ " '4': 5,\n"
+ " '6': 7\n"
+ '}'));
+ });
+
+ test('factors indentation into maxLineLength', () {
+ expect(
+ prettyPrint([
+ 'foo\nbar',
+ {'0': 1, '2': 3, '4': 5, '6': 7}
+ ], maxLineLength: 32),
+ equals('[\n'
+ " 'foo\\n'\n"
+ " 'bar',\n"
+ ' {\n'
+ " '0': 1,\n"
+ " '2': 3,\n"
+ " '4': 5,\n"
+ " '6': 7\n"
+ ' }\n'
+ ']'));
+ });
+
+ test("that's under maxItems", () {
+ expect(prettyPrint({'0': 1, '2': 3, '4': 5, '6': 7}, maxItems: 4),
+ equals("{'0': 1, '2': 3, '4': 5, '6': 7}"));
+ });
+
+ test("that's over maxItems", () {
+ expect(prettyPrint({'0': 1, '2': 3, '4': 5, '6': 7}, maxItems: 3),
+ equals("{'0': 1, '2': 3, ...}"));
+ });
+ });
+ group('with an object', () {
+ test('with a default [toString]', () {
+ expect(prettyPrint(DefaultToString()),
+ equals("<Instance of 'DefaultToString'>"));
+ });
+
+ test('with a custom [toString]', () {
+ expect(prettyPrint(CustomToString()),
+ equals('CustomToString:<string representation>'));
+ });
+
+ test('with a custom [toString] and a private name', () {
+ expect(prettyPrint(_PrivateName()),
+ equals('_PrivateName:<string representation>'));
+ });
+ });
+
+ group('with an iterable', () {
+ test("that's not a list", () {
+ expect(prettyPrint([1, 2, 3, 4].map((n) => n * 2)),
+ equals('MappedListIterable<int, int>:[2, 4, 6, 8]'));
+ });
+
+ test("that's not a list and has a private name", () {
+ expect(prettyPrint(_PrivateNameIterable()),
+ equals('_PrivateNameIterable:[1, 2, 3]'));
+ });
+ });
+
+ test('Type', () {
+ expect(prettyPrint(''.runtimeType), 'Type:<String>');
+ });
+}
diff --git a/pkgs/matcher/test/stream_matcher_test.dart b/pkgs/matcher/test/stream_matcher_test.dart
new file mode 100644
index 0000000..c4af666
--- /dev/null
+++ b/pkgs/matcher/test/stream_matcher_test.dart
@@ -0,0 +1,358 @@
+// Copyright (c) 2017, 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:async/async.dart';
+import 'package:term_glyph/term_glyph.dart' as glyph;
+import 'package:test/test.dart';
+
+import 'utils_new.dart';
+
+void main() {
+ setUpAll(() {
+ glyph.ascii = true;
+ });
+
+ late Stream stream;
+ late StreamQueue queue;
+ late Stream errorStream;
+ late StreamQueue errorQueue;
+ setUp(() {
+ stream = Stream.fromIterable([1, 2, 3, 4, 5]);
+ queue = StreamQueue(Stream.fromIterable([1, 2, 3, 4, 5]));
+ errorStream = Stream.fromFuture(Future.error('oh no!', StackTrace.current));
+ errorQueue = StreamQueue(
+ Stream.fromFuture(Future.error('oh no!', StackTrace.current)));
+ });
+
+ group('emits()', () {
+ test('matches the first event of a Stream', () {
+ expect(stream, emits(1));
+ });
+
+ test('rejects the first event of a Stream', () {
+ expect(
+ expectLater(stream, emits(2)),
+ throwsTestFailure(allOf([
+ startsWith('Expected: should emit an event that <2>\n'),
+ endsWith(' Which: emitted * 1\n'
+ ' * 2\n'
+ ' * 3\n'
+ ' * 4\n'
+ ' * 5\n'
+ ' x Stream closed.\n')
+ ])));
+ });
+
+ test('matches and consumes the next event of a StreamQueue', () {
+ expect(queue, emits(1));
+ expect(queue.next, completion(equals(2)));
+ expect(queue, emits(3));
+ expect(queue.next, completion(equals(4)));
+ });
+
+ test('rejects and does not consume the first event of a StreamQueue', () {
+ expect(
+ expectLater(queue, emits(2)),
+ throwsTestFailure(allOf([
+ startsWith('Expected: should emit an event that <2>\n'),
+ endsWith(' Which: emitted * 1\n'
+ ' * 2\n'
+ ' * 3\n'
+ ' * 4\n'
+ ' * 5\n'
+ ' x Stream closed.\n')
+ ])));
+
+ expect(queue, emits(1));
+ });
+
+ test('rejects an empty stream', () {
+ expect(
+ expectLater(const Stream.empty(), emits(1)),
+ throwsTestFailure(allOf([
+ startsWith('Expected: should emit an event that <1>\n'),
+ endsWith(' Which: emitted x Stream closed.\n')
+ ])));
+ });
+
+ test('forwards a stream error', () {
+ expect(expectLater(errorStream, emits(1)), throwsA('oh no!'));
+ });
+
+ test('wraps a normal matcher', () {
+ expect(queue, emits(lessThan(5)));
+ expect(expectLater(queue, emits(greaterThan(5))),
+ throwsTestFailure(anything));
+ });
+
+ test('returns a StreamMatcher as-is', () {
+ expect(queue, emits(emitsThrough(4)));
+ expect(queue, emits(5));
+ });
+ });
+
+ group('emitsDone', () {
+ test('succeeds for an empty stream', () {
+ expect(const Stream.empty(), emitsDone);
+ });
+
+ test('fails for a stream with events', () {
+ expect(
+ expectLater(stream, emitsDone),
+ throwsTestFailure(allOf([
+ startsWith('Expected: should be done\n'),
+ endsWith(' Which: emitted * 1\n'
+ ' * 2\n'
+ ' * 3\n'
+ ' * 4\n'
+ ' * 5\n'
+ ' x Stream closed.\n')
+ ])));
+ });
+ });
+
+ group('emitsError()', () {
+ test('consumes a matching error', () {
+ expect(errorQueue, emitsError('oh no!'));
+ expect(errorQueue.hasNext, completion(isFalse));
+ });
+
+ test('fails for a non-matching error', () {
+ expect(
+ expectLater(errorStream, emitsError('oh heck')),
+ throwsTestFailure(allOf([
+ startsWith("Expected: should emit an error that 'oh heck'\n"),
+ contains(' Which: emitted ! oh no!\n'),
+ contains(' x Stream closed.\n'
+ " which threw 'oh no!'\n"
+ ' stack '),
+ endsWith(' which is different.\n'
+ ' Expected: oh heck\n'
+ ' Actual: oh no!\n'
+ ' ^\n'
+ ' Differ at offset 3\n')
+ ])));
+ });
+
+ test('fails for a stream with events', () {
+ expect(
+ expectLater(stream, emitsDone),
+ throwsTestFailure(allOf([
+ startsWith('Expected: should be done\n'),
+ endsWith(' Which: emitted * 1\n'
+ ' * 2\n'
+ ' * 3\n'
+ ' * 4\n'
+ ' * 5\n'
+ ' x Stream closed.\n')
+ ])));
+ });
+ });
+
+ group('mayEmit()', () {
+ test('consumes a matching event', () {
+ expect(queue, mayEmit(1));
+ expect(queue, emits(2));
+ });
+
+ test('allows a non-matching event', () {
+ expect(queue, mayEmit('fish'));
+ expect(queue, emits(1));
+ });
+ });
+
+ group('emitsAnyOf()', () {
+ test('consumes an event that matches a matcher', () {
+ expect(queue, emitsAnyOf([2, 1, 3]));
+ expect(queue, emits(2));
+ });
+
+ test('consumes as many events as possible', () {
+ expect(
+ queue,
+ emitsAnyOf([
+ 1,
+ emitsInOrder([1, 2]),
+ emitsInOrder([1, 2, 3])
+ ]));
+
+ expect(queue, emits(4));
+ });
+
+ test('fails if no matchers match', () {
+ expect(
+ expectLater(stream, emitsAnyOf([2, 3, 4])),
+ throwsTestFailure(allOf([
+ startsWith('Expected: should do one of the following:\n'
+ ' * emit an event that <2>\n'
+ ' * emit an event that <3>\n'
+ ' * emit an event that <4>\n'),
+ endsWith(' Which: emitted * 1\n'
+ ' * 2\n'
+ ' * 3\n'
+ ' * 4\n'
+ ' * 5\n'
+ ' x Stream closed.\n'
+ ' which failed all options:\n'
+ ' * failed to emit an event that <2>\n'
+ ' * failed to emit an event that <3>\n'
+ ' * failed to emit an event that <4>\n')
+ ])));
+ });
+
+ test('allows an error if any matcher matches', () {
+ expect(errorStream, emitsAnyOf([1, 2, emitsError('oh no!')]));
+ });
+
+ test('rethrows an error if no matcher matches', () {
+ expect(
+ expectLater(errorStream, emitsAnyOf([1, 2, 3])), throwsA('oh no!'));
+ });
+ });
+
+ group('emitsInOrder()', () {
+ test('consumes matching events', () {
+ expect(queue, emitsInOrder([1, 2, emitsThrough(4)]));
+ expect(queue, emits(5));
+ });
+
+ test("fails if the matchers don't match in order", () {
+ expect(
+ expectLater(queue, emitsInOrder([1, 3, 2])),
+ throwsTestFailure(allOf([
+ startsWith('Expected: should do the following in order:\n'
+ ' * emit an event that <1>\n'
+ ' * emit an event that <3>\n'
+ ' * emit an event that <2>\n'),
+ endsWith(' Which: emitted * 1\n'
+ ' * 2\n'
+ ' * 3\n'
+ ' * 4\n'
+ ' * 5\n'
+ ' x Stream closed.\n'
+ " which didn't emit an event that <3>\n")
+ ])));
+ });
+ });
+
+ group('emitsThrough()', () {
+ test('consumes events including those matching the matcher', () {
+ expect(queue, emitsThrough(emitsInOrder([3, 4])));
+ expect(queue, emits(5));
+ });
+
+ test('consumes the entire queue with emitsDone', () {
+ expect(queue, emitsThrough(emitsDone));
+ expect(queue.hasNext, completion(isFalse));
+ });
+
+ test('fails if the queue never matches the matcher', () {
+ expect(
+ expectLater(queue, emitsThrough(6)),
+ throwsTestFailure(allOf([
+ startsWith('Expected: should eventually emit an event that <6>\n'),
+ endsWith(' Which: emitted * 1\n'
+ ' * 2\n'
+ ' * 3\n'
+ ' * 4\n'
+ ' * 5\n'
+ ' x Stream closed.\n'
+ ' which never did emit an event that <6>\n')
+ ])));
+ });
+ });
+
+ group('mayEmitMultiple()', () {
+ test('consumes multiple instances of the given matcher', () {
+ expect(queue, mayEmitMultiple(lessThan(3)));
+ expect(queue, emits(3));
+ });
+
+ test('consumes zero instances of the given matcher', () {
+ expect(queue, mayEmitMultiple(6));
+ expect(queue, emits(1));
+ });
+
+ test("doesn't rethrow errors", () {
+ expect(errorQueue, mayEmitMultiple(1));
+ expect(errorQueue, emitsError('oh no!'));
+ });
+ });
+
+ group('neverEmits()', () {
+ test('succeeds if the event never matches', () {
+ expect(queue, neverEmits(6));
+ expect(queue, emits(1));
+ });
+
+ test('fails if the event matches', () {
+ expect(
+ expectLater(stream, neverEmits(4)),
+ throwsTestFailure(allOf([
+ startsWith('Expected: should never emit an event that <4>\n'),
+ endsWith(' Which: emitted * 1\n'
+ ' * 2\n'
+ ' * 3\n'
+ ' * 4\n'
+ ' * 5\n'
+ ' x Stream closed.\n'
+ ' which after 3 events did emit an event that <4>\n')
+ ])));
+ });
+
+ test('fails if emitsDone matches', () {
+ expect(expectLater(stream, neverEmits(emitsDone)),
+ throwsTestFailure(anything));
+ });
+
+ test("doesn't rethrow errors", () {
+ expect(errorQueue, neverEmits(6));
+ expect(errorQueue, emitsError('oh no!'));
+ });
+ });
+
+ group('emitsInAnyOrder()', () {
+ test('consumes events that match in any order', () {
+ expect(queue, emitsInAnyOrder([3, 1, 2]));
+ expect(queue, emits(4));
+ });
+
+ test("fails if the events don't match in any order", () {
+ expect(
+ expectLater(stream, emitsInAnyOrder([4, 1, 2])),
+ throwsTestFailure(allOf([
+ startsWith('Expected: should do the following in any order:\n'
+ ' * emit an event that <4>\n'
+ ' * emit an event that <1>\n'
+ ' * emit an event that <2>\n'),
+ endsWith(' Which: emitted * 1\n'
+ ' * 2\n'
+ ' * 3\n'
+ ' * 4\n'
+ ' * 5\n'
+ ' x Stream closed.\n')
+ ])));
+ });
+
+ test("doesn't rethrow if some ordering matches", () {
+ expect(errorQueue, emitsInAnyOrder([emitsDone, emitsError('oh no!')]));
+ });
+
+ test('rethrows if no ordering matches', () {
+ expect(
+ expectLater(errorQueue, emitsInAnyOrder([1, emitsError('oh no!')])),
+ throwsA('oh no!'));
+ });
+ });
+
+ test('A custom StreamController doesn\'t hang on close', () async {
+ var controller = StreamController<void>();
+ var done = expectLater(controller.stream, emits(null));
+ controller.add(null);
+ await done;
+ await controller.close();
+ });
+}
diff --git a/pkgs/matcher/test/string_matchers_test.dart b/pkgs/matcher/test/string_matchers_test.dart
new file mode 100644
index 0000000..be9e768
--- /dev/null
+++ b/pkgs/matcher/test/string_matchers_test.dart
@@ -0,0 +1,151 @@
+// Copyright (c) 2012, 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 'package:matcher/matcher.dart';
+import 'package:test/test.dart' show test, expect;
+
+import 'test_utils.dart';
+
+void main() {
+ test('Reports mismatches in whitespace and escape sequences', () {
+ shouldFail('before\nafter', equals('before\\nafter'),
+ contains('Differ at offset 7'));
+ });
+
+ test('Retains outer matcher mismatch text', () {
+ shouldFail(
+ {'word': 'thing'},
+ containsPair('word', equals('notthing')),
+ allOf([
+ contains("contains key 'word' but with value is different"),
+ contains('Differ at offset 0')
+ ]));
+ });
+
+ test('collapseWhitespace', () {
+ var source = '\t\r\n hello\t\r\n world\r\t \n';
+ expect(collapseWhitespace(source), 'hello world');
+ });
+
+ test('isEmpty', () {
+ shouldPass('', isEmpty);
+ shouldFail(null, isEmpty, startsWith('Expected: empty Actual: <null>'));
+ shouldFail(0, isEmpty, startsWith('Expected: empty Actual: <0>'));
+ shouldFail('a', isEmpty, startsWith("Expected: empty Actual: 'a'"));
+ });
+
+ // Regression test for: https://code.google.com/p/dart/issues/detail?id=21562
+ test('isNot(isEmpty)', () {
+ shouldPass('a', isNot(isEmpty));
+ shouldFail('', isNot(isEmpty), 'Expected: not empty Actual: \'\'');
+ shouldFail(null, isNot(isEmpty),
+ startsWith('Expected: not empty Actual: <null>'));
+ });
+
+ test('isNotEmpty', () {
+ shouldFail('', isNotEmpty, startsWith("Expected: non-empty Actual: ''"));
+ shouldFail(
+ null, isNotEmpty, startsWith('Expected: non-empty Actual: <null>'));
+ shouldFail(0, isNotEmpty, startsWith('Expected: non-empty Actual: <0>'));
+ shouldPass('a', isNotEmpty);
+ });
+
+ test('equalsIgnoringCase', () {
+ shouldPass('hello', equalsIgnoringCase('HELLO'));
+ shouldFail('hi', equalsIgnoringCase('HELLO'),
+ "Expected: 'HELLO' ignoring case Actual: 'hi'");
+ shouldFail(42, equalsIgnoringCase('HELLO'),
+ endsWith('not an <Instance of \'String\'>'));
+ });
+
+ test('equalsIgnoringWhitespace', () {
+ shouldPass(' hello world ', equalsIgnoringWhitespace('hello world'));
+ shouldFail(
+ ' helloworld ',
+ equalsIgnoringWhitespace('hello world'),
+ "Expected: 'hello world' ignoring whitespace "
+ "Actual: ' helloworld ' "
+ "Which: is 'helloworld' with whitespace compressed");
+ shouldFail(42, equalsIgnoringWhitespace('HELLO'),
+ endsWith('not an <Instance of \'String\'>'));
+ });
+
+ test('startsWith', () {
+ shouldPass('hello', startsWith(''));
+ shouldPass('hello', startsWith('hell'));
+ shouldPass('hello', startsWith('hello'));
+ shouldFail(
+ 'hello',
+ startsWith('hello '),
+ "Expected: a string starting with 'hello ' "
+ "Actual: 'hello'");
+ shouldFail(
+ 42, startsWith('hello '), endsWith('not an <Instance of \'String\'>'));
+ });
+
+ test('endsWith', () {
+ shouldPass('hello', endsWith(''));
+ shouldPass('hello', endsWith('lo'));
+ shouldPass('hello', endsWith('hello'));
+ shouldFail(
+ 'hello',
+ endsWith(' hello'),
+ "Expected: a string ending with ' hello' "
+ "Actual: 'hello'");
+ shouldFail(
+ 42, startsWith('hello '), endsWith('not an <Instance of \'String\'>'));
+ });
+
+ test('contains', () {
+ shouldPass('hello', contains(''));
+ shouldPass('hello', contains('h'));
+ shouldPass('hello', contains('o'));
+ shouldPass('hello', contains('hell'));
+ shouldPass('hello', contains('hello'));
+ shouldFail('hello', contains(' '),
+ "Expected: contains ' ' Actual: 'hello' Which: does not contain ' '");
+ });
+
+ test('stringContainsInOrder', () {
+ shouldPass('goodbye cruel world', stringContainsInOrder(['']));
+ shouldPass('goodbye cruel world', stringContainsInOrder(['goodbye']));
+ shouldPass('goodbye cruel world', stringContainsInOrder(['cruel']));
+ shouldPass('goodbye cruel world', stringContainsInOrder(['world']));
+ shouldPass(
+ 'goodbye cruel world', stringContainsInOrder(['good', 'bye', 'world']));
+ shouldPass(
+ 'goodbye cruel world', stringContainsInOrder(['goodbye', 'cruel']));
+ shouldPass(
+ 'goodbye cruel world', stringContainsInOrder(['cruel', 'world']));
+ shouldPass('goodbye cruel world',
+ stringContainsInOrder(['goodbye', 'cruel', 'world']));
+ shouldPass(
+ 'foo', stringContainsInOrder(['f', '', '', '', 'o', '', '', 'o']));
+
+ shouldFail(
+ 'abc',
+ stringContainsInOrder(['ab', 'bc']),
+ "Expected: a string containing 'ab', 'bc' in order "
+ "Actual: 'abc'");
+ shouldFail(
+ 'hello',
+ stringContainsInOrder(['hello', 'hello']),
+ "Expected: a string containing 'hello', 'hello' in order "
+ "Actual: 'hello'");
+ shouldFail(
+ 'goodbye cruel world',
+ stringContainsInOrder(['goo', 'cruel', 'bye']),
+ "Expected: a string containing 'goo', 'cruel', 'bye' in order "
+ "Actual: 'goodbye cruel world'");
+ });
+
+ test('matches', () {
+ shouldPass('c0d', matches('[a-z][0-9][a-z]'));
+ shouldPass('c0d', matches(RegExp('[a-z][0-9][a-z]')));
+ shouldFail('cOd', matches('[a-z][0-9][a-z]'),
+ "Expected: match '[a-z][0-9][a-z]' Actual: 'cOd'");
+ shouldFail(42, matches('[a-z][0-9][a-z]'),
+ endsWith('not an <Instance of \'String\'>'));
+ });
+}
diff --git a/pkgs/matcher/test/test_utils.dart b/pkgs/matcher/test/test_utils.dart
new file mode 100644
index 0000000..67b61a1
--- /dev/null
+++ b/pkgs/matcher/test/test_utils.dart
@@ -0,0 +1,67 @@
+// Copyright (c) 2012, 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 'package:test/test.dart';
+
+void shouldFail(Object? value, Matcher matcher, Object? expected) {
+ var failed = false;
+ try {
+ expect(value, matcher);
+ } on TestFailure catch (err) {
+ failed = true;
+
+ var errorString = err.message;
+
+ if (expected is String) {
+ expect(errorString, equalsIgnoringWhitespace(expected));
+ } else {
+ expect(errorString?.replaceAll('\n', ''), expected);
+ }
+ }
+
+ expect(failed, isTrue, reason: 'Expected to fail.');
+}
+
+void shouldPass(Object? value, Matcher matcher) {
+ expect(value, matcher);
+}
+
+void doesNotThrow() {}
+void doesThrow() {
+ throw StateError('X');
+}
+
+class Widget {
+ int? price;
+}
+
+class SimpleIterable extends Iterable<int> {
+ final int count;
+
+ SimpleIterable(this.count);
+
+ @override
+ Iterator<int> get iterator => _SimpleIterator(count);
+}
+
+class _SimpleIterator implements Iterator<int> {
+ int _count;
+ int _current;
+
+ _SimpleIterator(this._count) : _current = -1;
+
+ @override
+ bool moveNext() {
+ if (_count > 0) {
+ _current = _count;
+ _count--;
+ return true;
+ }
+ _current = -1;
+ return false;
+ }
+
+ @override
+ int get current => _current;
+}
diff --git a/pkgs/matcher/test/type_matcher_test.dart b/pkgs/matcher/test/type_matcher_test.dart
new file mode 100644
index 0000000..99d4459
--- /dev/null
+++ b/pkgs/matcher/test/type_matcher_test.dart
@@ -0,0 +1,66 @@
+// Copyright (c) 2012, 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.
+
+// ignore_for_file: deprecated_member_use_from_same_package
+import 'package:matcher/matcher.dart';
+import 'package:test/test.dart' show test, group;
+
+import 'test_utils.dart';
+
+void main() {
+ _test(isMap, {}, name: 'Map');
+ _test(isList, [], name: 'List');
+ _test(isArgumentError, ArgumentError());
+ _test(isCastError, TypeError());
+ _test<Exception>(isException, const FormatException());
+ _test(isFormatException, const FormatException());
+ _test(isStateError, StateError('oops'));
+ _test(isRangeError, RangeError('oops'));
+ _test(isUnimplementedError, UnimplementedError('oops'));
+ _test(isUnsupportedError, UnsupportedError('oops'));
+ _test(isConcurrentModificationError, ConcurrentModificationError());
+ _test(isCyclicInitializationError, Error());
+ _test<NoSuchMethodError?>(isNoSuchMethodError, null,
+ name: 'NoSuchMethodError');
+ _test(isNullThrownError, TypeError());
+
+ group('custom `TypeMatcher`', () {
+ _test(const isInstanceOf<String>(), 'hello');
+ _test(const _StringMatcher(), 'hello');
+ _test(const TypeMatcher<String>(), 'hello');
+ _test(isA<String>(), 'hello');
+ });
+}
+
+void _test<T>(Matcher typeMatcher, T matchingInstance, {String? name}) {
+ name ??= T.toString();
+ group('for `$name`', () {
+ if (matchingInstance != null) {
+ test('succeeds', () {
+ shouldPass(matchingInstance, typeMatcher);
+ });
+ }
+
+ test('fails', () {
+ shouldFail(
+ const _TestType(),
+ typeMatcher,
+ "Expected: <Instance of '$name'> Actual: <Instance of '_TestType'>"
+ " Which: is not an instance of '$name'",
+ );
+ });
+ });
+}
+
+// Validate that existing implementations continue to work.
+class _StringMatcher extends TypeMatcher {
+ const _StringMatcher() : super('String');
+
+ @override
+ bool matches(dynamic item, Map matchState) => item is String;
+}
+
+class _TestType {
+ const _TestType();
+}
diff --git a/pkgs/matcher/test/utils_new.dart b/pkgs/matcher/test/utils_new.dart
new file mode 100644
index 0000000..7d85a02
--- /dev/null
+++ b/pkgs/matcher/test/utils_new.dart
@@ -0,0 +1,49 @@
+// 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));
diff --git a/pkgs/test/.test_config b/pkgs/test/.test_config
new file mode 100644
index 0000000..412fc5c
--- /dev/null
+++ b/pkgs/test/.test_config
@@ -0,0 +1,3 @@
+{
+ "test_package": true
+}
\ No newline at end of file
diff --git a/pkgs/test/CHANGELOG.md b/pkgs/test/CHANGELOG.md
new file mode 100644
index 0000000..afe8dec
--- /dev/null
+++ b/pkgs/test/CHANGELOG.md
@@ -0,0 +1,1836 @@
+## 1.25.12
+
+* Fix hang when running multiple precompiled browser tests.
+
+## 1.25.11
+
+* Update to be forward compatible with `package:shelf_web_socket` version `3.x`.
+
+## 1.25.10
+
+* Update the `package:vm_service` constraint to allow version `15.x`.
+
+## 1.25.9
+
+* Allow `analyzer: '>=6.0.0 <8.0.0'`
+* Fix dart2wasm tests on windows.
+* Increase SDK constraint to ^3.5.0.
+* Support running Node.js tests compiled with dart2wasm.
+* Allow `firefox` or `firefox-bin` executable name on macOS.
+
+## 1.25.8
+
+* Increase SDK constraint to ^3.4.0.
+
+## 1.25.7
+
+* Enable asserts for `dart2wasm` tests.
+
+## 1.25.6
+
+* Point API doc links to `package:test` canonical libraries.
+* Fix testing with `dart2wasm` - use `dart compile wasm` instead of depending on
+ SDK internals
+* Update min SDK constraint to 3.2.0.
+
+## 1.25.5
+
+* Update the `package:web_socket_channel` version constraint to allow `3.x`.
+* Update the `package:shelf_web_socket` version constraint to allow `2.x`.
+
+## 1.25.4
+
+* Add `@doNotSubmit` to more declarations of the `solo` parameter.
+
+## 1.25.3
+
+* Remove outdated StreamMatcher link from README table of contents.
+* Document the silent reporter in CLI help output.
+* Support enabling experiments with the dart2wasm compiler.
+* Added [`@doNotSubmit`](https://pub.dev/documentation/meta/latest/meta/doNotSubmit-constant.html) to `test(solo: ...)` and `group(solo: ...)`. In
+ practice, this means that code that was relying on ignoring deprecation
+ warnings and using `solo` or `group` with a `skip` parameter will now fail if
+ `dart analyze --fatal-infos` (or similar) is enabled.
+
+## 1.25.2
+
+* Fix a bug running browser tests with paths containing windows directory
+ separator follow by a character which is an invalid Dart string escape
+ sequence.
+
+## 1.25.1
+
+* Fix a bug where in precompiled mode, html files for tests were no longer
+ created.
+* Support the latest version of `package:js`.
+* Document the silent reporter in CLI help output.
+
+## 1.25.0
+
+* Handle paths with leading `/` when spawning test isolates.
+* Add support for the `dart2wasm` compiler in chrome and firefox.
+* **BREAKING**: Remove the `experimental-chrome-wasm` platform, you can now use
+ `-p chrome -c dart2wasm` instead.
+ * Note that this has always been advertised as a change that would happen in a
+ future non-breaking release.
+* **BREAKING**:Dropped support for `--pub-serve` which has long not been tested
+ or supported.
+ * We do not anticipate much if any actual breakage or existing usage of this
+ feature, which is why we are making this change in a non-breaking release.
+ * If you do require this feature, file an issue and we can look at adding it
+ back.
+* **BREAKING**: Fully remove support for Internet Explorer.
+* Fix running of tests defined under `lib/` with relative imports to other
+ libraries in the package.
+
+## 1.24.9
+
+* Update the vm_service constraint to allow version `13.x`.
+
+## 1.24.8
+
+* Remove spurious deprecation during autocomplete for `setUp` and `tearDown`.
+
+## 1.24.7
+
+* Simplify the initialization of the per-suite message channel within browser
+ tests. See https://github.com/dart-lang/test/issues/2065
+* Add a timeout to browser test suite loads.
+* Fix running of browser tests that use deferred loaded libraries.
+
+## 1.24.6
+
+* Fix communication failures between minified test apps and the non-minified
+ host app.
+* Add support for discontinuing after the first failing test with `--fail-fast`.
+
+## 1.24.5
+
+* Change `compiling <path>` to `loading <path>` message in all cases. Surface
+ the "loading" messages in the situations where previously only the
+ "compiling" message would be used.
+* Support browser tests where the frame creates the message channel.
+
+## 1.24.4
+
+* Drop support for null unsafe Dart, bump SDK constraint to `3.0.0`.
+* Make some annotation classes `final`: `OnPlatform`, `Retry`, `Skip`, `Tags`,
+ `TestOn`, `Timeout`.
+* Fix the `root_` fields in the JSON reporter when running a test on Windows
+ with an absolute path.
+* Add support for `SAFARI_EXECUTABLE`, `FIREFOX_EXECUTABLE` and
+ `MS_EDGE_EXECUTABLE` for custom browser installations.
+* Allow the latest analyzer (6.x.x).
+* Add `MOZ_AUTOMATION=1` environmental variable to Firefox runner, to make
+ launcher process on Windows wait for browser exit.
+
+## 1.24.3
+
+* Fix compatibility with wasm number semantics.
+
+## 1.24.2
+
+* Copy an existing nonce from a script on the test HTML page to the script
+ created by the test runner host javascript. This only impacts environments
+ testing with custom HTML that includes a nonce.
+* Support the Microsoft Edge browser (use the `edge` platform in your test
+ configuration file or `-p edge` on the command line).
+
+## 1.24.1
+
+* Handle a missing `'compiler'` value when running a test compiled against a
+ newer `test_api` than the runner back end is using. The expectation was that
+ the json protocol is only used across packages compatible with the same major
+ version of the `test_api` package, but `flutter test` does not check the
+ version of packages in the pub solve for user test code.
+
+## 1.24.0
+
+* Support the `--compiler` flag, which can be used to configure which compiler
+ to use.
+ * To specify a compiler by platform, the argument supports platform selectors
+ through this syntax `[<platform>:]<compiler>`. For example the command line
+ argument `--compiler vm:source` would run all vm tests from source instead
+ of compiling to kernel first.
+ * If no given compiler is compatible for a platform, it will use its default
+ compiler instead.
+* Add support for running tests as native executables (vm platform only).
+ * You can run tests this way with `--compiler exe`.
+* Support compiler identifiers in platform selectors.
+* List the supported compilers for each platform in the usage text.
+* Update all reporters to print the compiler along with the platform name
+ when configured to print the platform. Extend the logic for printing platofrm
+ information to do so if any compilers are explicitly configured.
+* Deprecate `--use-data-isolate-strategy`. It is now an alias for `-c vm:source`
+ which is roughly equivalent. If this is breaking for you please file an issue.
+
+## 1.23.1
+
+* Fix running paths by absolute path (with drive letter) on windows.
+
+## 1.23.0
+
+* Avoid empty expandable groups for tests without extra output in Github
+ reporter.
+* Add support for CHROME_EXECUTABLE environment variable. This overrides any
+ config file settings.
+* Support running tests by absolute file uri.
+
+## 1.22.2
+
+* Don't run `tearDown` until the test body and outstanding work is complete,
+ even if the test has already failed.
+* Change URL secrets for browser tests to always be alphanumeric characters.
+
+## 1.22.1
+
+* Add documentation for the `--ignore-timeouts` argument.
+* Merge command lines args repeating the same test path to run the suite one
+ time with all the test cases across the different arguments.
+* Fix VM tests which run after some test has changed the working directory.
+ There are still issues with browser tests after changing directory.
+* Deprecate `throwsNullThrownError`, use `throwsA(isA<TypeError>())` instead. The
+ implementation has been changed to ease migrations.
+* Deprecate `throwsCyclicInitializationError` and replace the implementation
+ with `Throws(TypeMatcher<Error>())`. The specific exception no longer exists
+ and there is no guarantee about what type of error will be thrown.
+
+## 1.22.0
+
+* Fix an issue with the github reporter where tests that fail asynchronously
+ after they've completed would show up as succeeded tests.
+* Add the `experimental-chrome-wasm` platform. This is very unstable and will
+ eventually be deleted, to be replaced by a `--compiler` flag. See
+ https://github.com/dart-lang/test/issues/1776 for more information on future
+ plans.
+
+## 1.21.7
+
+* Support `package:matcher` version `0.12.13`.
+
+## 1.21.6
+
+* Require Dart >= 2.18.0
+* Fix the coverage usage example in the README.md
+* Support the latest `package:test_api` and `package:test_core`.
+
+## 1.21.5
+
+* Fix `printOnFailure` output to be associated with the correct test.
+* Migrate all dom interactions to static interop.
+
+## 1.21.4
+
+* Make the labels for test loading more readable in the compact and expanded
+ reporters, use gray instead of black.
+* Print a command to re-run the failed test after each failure in the compact
+ reporter.
+* Fix the package config path used when running pre-compiled vm tests.
+
+## 1.21.3
+
+* Support the latest `package:test_api` and `package:test_core`.
+
+## 1.21.2
+
+* Add `Target` to restrict `TestOn` annotation to library level.
+* Update the github reporter to output the platform in the test names when
+ multiple platforms are used.
+* Fix `spawnHybridUri` support for `package:` uris.
+
+## 1.21.1
+
+* Fix a bug loading JS sources with non-utf8 content while parsing coverage
+ information from chrome.
+
+## 1.21.0
+
+* Allow analyzer version `4.x`.
+* Add a `github` reporter option for use with GitHub Actions.
+* Make the `github` test reporter the default when we detect we're running on
+ GitHub Actions.
+
+## 1.20.2
+
+* Drop `dart2js-path` command line argument.
+* Allow loading tests under a path with the directory named `packages`.
+* Add retry for launching browsers. Reduce timeout back to 30 seconds.
+
+## 1.20.1
+
+* Allow the latest `vm_service` package.
+
+## 1.20.0
+
+* Update `analyzer` constraint to `>=2.0.0 <4.0.0`.
+* Add an `--ignore-timeouts` command line flag, which disables all timeouts
+ for all tests. This can be useful when debugging, so tests don't time out
+ during debug sessions.
+* Create a trusted types policy when available for assigning the script URL for
+ web tests.
+
+## 1.19.5
+
+* Try to get more logging from `chrome` on windows to diagnose intermittent
+ failures.
+
+## 1.19.4
+
+* Wait for paused VM platform isolates before shutdown.
+* `TestFailure` implements `Exception` for compatibility with
+ `only_throw_exceptions`.
+
+## 1.19.3
+
+* Remove duplicate logging of suggestion to enable the `chain-stack-traces`
+ flag, a single log will now appear at the end.
+
+## 1.19.2
+
+* Republish with missing JS file for browser tests.
+
+## 1.19.1
+
+* Fix parsing of file paths into a URI on windows.
+
+## 1.19.0
+
+* Support query parameters `name`, `full-name`, `line`, and `col` on test paths,
+ which will apply the filters to only those test suites.
+ * All specified filters must match for a test to run.
+ * Global filters (ie: `--name`) are also still respected and must match.
+ * The `line` and `col` will match if any frame from the test trace matches
+ (the test trace is the current stack trace where `test` is invoked).
+* Give a better exception when using `markTestSkipped` outside of a test.
+
+## 1.18.2
+
+* Publish with the `host.dart.js` file.
+
+## 1.18.1
+
+* Add defaulting for older test backends that don't pass a configuration for
+ the `allow_duplicate_test_names` parameter to the remote listener.
+
+## 1.18.0
+
+* Add configuration to disallow duplicate test and group names. See the
+ [docs][allow_duplicate_test_names] for more information.
+* Remove dependency on pedantic.
+
+[allow_duplicate_test_names]: https://github.com/dart-lang/test/blob/master/pkgs/test/doc/configuration.md#allow_duplicate_test_names
+
+## 1.17.12
+
+* Support the latest `test_core`.
+* Re-use the cached dill file from previous runs on subsequent runs.
+
+## 1.17.11
+
+* Use the latest `package:matcher`.
+ * Change many argument types from `dynamic` to `Object?`.
+ * Fix `stringContainsInOrder` to account for repetitions and empty strings.
+ * **Note**: This may break some existing tests, as the behavior does change.
+
+## 1.17.10
+
+* Report incomplete tests as errors in the JSON reporter when the run is
+ canceled early.
+* Update `analyzer` constraint to `>=1.0.0 <3.0.0`.
+
+## 1.17.9
+
+* Fix a bug where a tag level configuration would cause test suites with that
+ tag to ignore the `--test-randomize-ordering-seed` argument.
+
+## 1.17.8
+
+* Update json reporter docs with updated nullability annotations and
+ descriptions.
+* Add `time` field to the json reporters `allSuites` event type so that all
+ event types can be unified.
+
+## 1.17.7
+
+* Support the latest `test_core`.
+
+## 1.17.6
+
+* Give a better error when `printOnFailure` is called from outside a test
+ zone.
+
+## 1.17.5
+
+* Support the latest vm_service release (`7.0.0`).
+
+## 1.17.4
+
+* Fix race condition between compilation of vm tests and the running of
+ isolates.
+
+## 1.17.3
+
+* Forward experiment args from the runner executable to the compiler with the
+ new vm test loading strategy.
+
+## 1.17.2
+
+* Fix a windows issue with the new loading strategy.
+
+## 1.17.1
+
+* Fix an issue where you couldn't have tests compiled in both sound and
+ unsound null safety modes.
+
+## 1.17.0
+
+* Change the default way VM tests are launched and ran to greatly speed up
+ loading performance.
+ * You can force the old strategy with `--use-data-isolate-strategy` flag if
+ you run into issues, but please also file a bug.
+* Disable stack trace chaining by default. It can be re-enabled by explicitly
+ passing the `--chain-stack-traces` flag.
+* Remove `phantomjs` support completely, it was previously broken.
+* Fix `expectAsync` function type checks.
+* Add libraries `scaffolding.dart`, and `expect.dart` to allow importing a
+ subset of the normal surface area.
+
+## 1.16.8
+
+* Fix an issue where coverage collection could hang on Chrome.
+* ~~Disable stack trace chaining by default. It can be re-enabled by explicitly
+ passing the `--chain-stack-traces` flag.~~
+
+## 1.16.7
+
+* Update `spawnHybridCode` to default to the current packages language version.
+* Update `test_core` and `test_api` deps.
+
+## 1.16.6
+
+* Complete the migration to null safety.
+
+## 1.16.5
+
+* Expand several deps to allow the latest versions.
+
+## 1.16.4
+
+* Update `test_core` dependency to `0.3.14`.
+
+## 1.16.3
+
+* Update `web_socket_channel` dependency to support latest.
+
+## 1.16.2
+
+* Update `test_core` dependency to `0.3.13`.
+
+## 1.16.1
+
+* Allow the latest analyzer `1.0.0`.
+
+## 1.16.0
+
+* Stable null safety release.
+
+## 1.16.0-nullsafety.19
+
+* Use the `test_api` for stable null safety.
+
+## 1.16.0-nullsafety.18
+
+* Expand upper bound constraints for some null safe migrated packages.
+
+## 1.16.0-nullsafety.17
+
+* Support the latest shelf release (`1.x.x`).
+
+## 1.16.0-nullsafety.16
+
+* Support the latest vm_service release (`6.x.x`).
+
+## 1.16.0-nullsafety.15
+
+* Support the latest coverage release (`0.15.x`).
+
+## 1.16.0-nullsafety.14
+
+* Allow the latest args release (`2.x`).
+
+## 1.16.0-nullsafety.13
+
+* Allow the latest glob release (`2.x`).
+
+## 1.16.0-nullsafety.12
+
+* Fix `spawnHybridUri` on windows.
+* Fix failures running tests on the `node` platform.
+* Allow `package:yaml` version `3.x.x`.
+
+## 1.16.0-nullsafety.11
+
+* Set up a stack trace mapper in precompiled mode if source maps exist. If
+ the stack traces are already mapped then this has no effect, otherwise it
+ will try to map any JS lines it sees.
+
+## 1.16.0-nullsafety.10
+
+* Allow injecting a test channel for browser tests.
+* Allow `package:analyzer` version `0.41.x`.
+
+## 1.16.0-nullsafety.9
+
+* Fix `spawnHybridUri` to respect language versioning of the spawned uri.
+
+## 1.16.0-nullsafety.8
+
+* Update SDK constraints to `>=2.12.0-0 <3.0.0` based on beta release
+ guidelines.
+
+## 1.16.0-nullsafety.7
+
+* Allow prerelease versions of the 2.12 sdk.
+
+## 1.16.0-nullsafety.6
+
+* Add `markTestSkipped` API.
+
+## 1.16.0-nullsafety.5
+
+* Allow `2.10` stable and `2.11.0-dev` SDKs.
+* Annotate the classes used as annotations to restrict their usage to library
+ level.
+* Stop required a `SILENT_OBSERVATORY` environment variable to run with
+ debugging and the JSON reporter.
+
+## 1.16.0-nullsafety.4
+
+* Depend on the latest test_core.
+
+## 1.16.0-nullsafety.3
+
+* Clean up `--help` output.
+
+## 1.16.0-nullsafety.2
+
+* Allow version `0.40.x` of `analyzer`.
+
+## 1.16.0-nullsafety.1
+
+* Depend on the latest test_core.
+
+## 1.16.0-nullsafety
+
+* Support running tests with null safety.
+ * Note that the test runner itself is not fully migrated yet.
+* Add the `Fake` class, available through `package:test_api/fake.dart`. This
+ was previously part of the Mockito package, but with null safety it is useful
+ enough that we decided to make it available through `package:test`. In a
+ future release it will be made available directly through
+ `package:test_api/test_api.dart` (and hence through
+ `package:test_core/test_core.dart` and `package:test/test.dart`).
+
+## 1.15.7 (Backport)
+
+* Fix `spawnHybridUri` on windows.
+
+## 1.15.6 (Backport)
+
+* Support `package:analyzer` version `0.41.x`.
+
+## 1.15.5 (Backport)
+
+* Fix `spawnHybridUri` to respect language versioning of the spawned uri.
+
+## 1.15.4
+
+* Allow analyzer 0.40.x.
+
+## 1.15.3
+
+* Update to `matcher` version `0.12.9` which improves the mismatch description
+ for deep collection equality matchers and TypeMatcher.
+
+## 1.15.2
+
+* Use the latest `test_core` which resolves an issue with the latest
+ `package:meta`.
+
+## 1.15.1
+
+* Avoid a confusing stack trace when there is a problem loading a platform when
+ using the JSON reporter and enabling debugging.
+* Restore behavior of listening for both `IPv6` and `IPv4` sockets for the node
+ platform.
+
+## 1.15.0
+
+* Update bootstrapping logic to ensure the bootstrap library has
+ the same language version as the test.
+* The Node platform will now communicate over only IPv6 if it is available.
+
+## 1.14.7
+
+* Support the latest `package:coverage`.
+
+
+## 1.14.6
+
+* Update `test_core` to `0.3.6`.
+
+## 1.14.5
+
+* Add additional information to an exception when we end up with a null
+ `RunnerSuite`.
+
+## 1.14.4
+
+* Use non-headless Chrome when provided the flag `--pause-after-load`.
+
+## 1.14.3
+
+* Fix an issue where coverage tests could not run in Chrome headless.
+* Fix an issue where coverage collection would not work with source
+ maps that contained absolute file URIs.
+* Fix error messages for incorrect string literals in test annotations.
+* Update `test_core` to `0.3.4`.
+
+## 1.14.2
+
+* Update `test_core` to `0.3.3`.
+
+## 1.14.1
+
+* Allow the latest shelf_packages_handler.
+
+## 1.14.0
+
+* Drop the `package_resolver` dependency for the `package_config` dependency
+ which is lower level.
+
+## 1.13.0
+
+* Enable asserts in code running through `spawnHybrid` APIs.
+* Exit with a non-zero code if no tests were ran, whether due to skips or having
+ no tests defined.
+* Fix the stack trace labels in SDK code for `dart2js` compiled tests.
+* Cancel any StreamQueue that is created as a part of a stream matcher once it
+ is done matching.
+ * This fixes a bug where using a matcher on a custom stream controller and
+ then awaiting the `close()` method on that controller would hang.
+* Avoid causing the test runner to hang if there is a timeout during a
+ `tearDown` callback following a failing test case.
+
+## 1.12.0
+
+* Bump minimum SDK to `2.4.0` for safer usage of for-loop elements.
+* Deprecate `PhantomJS` and provide warning when used. Support for `PhantomJS`
+ will be removed in version `2.0.0`.
+* Support coverage collection for the Chrome platform. See `README.md` for usage
+ details.
+
+## 1.11.1
+
+* Allow `test_api` `0.2.13` to work around a bug in the SDK version `2.3.0`.
+
+## 1.11.0
+
+* Add `file_reporters` configuration option and `--file-reporter` CLI option to
+ allow specifying a separate reporter that writes to a file instead of stdout.
+
+## 1.10.0
+
+* Add `customHtmlTemplateFile` configuration option to allow sharing an
+ html template between tests
+* Depend on the latest `package:test_core`.
+* Depend on the latest `package:test_api`.
+
+## 1.9.4
+
+* Extend the timeout for synthetic tests, e.g. `tearDownAll`.
+* Depend on the latest `package:test_core`.
+* Depend on the latest `package:test_api`.
+
+## 1.9.3
+
+* Depend on the latest `package:test_core`.
+* Support the latest `package:analyzer`.
+* Update to latest `package:matcher`. Improves output for instances of private
+ classes.
+
+## 1.9.2
+
+* Depend on the latest `package:test_api` and `package:test_core`.
+* While using `solo` tests that are not run will now be reported as skipped.
+
+## 1.9.1
+
+* Depend on latest `test_core`.
+
+## 1.9.0
+
+* Implement code coverage collection for VM based tests
+
+## 1.8.0
+
+* Expose the previously hidden sharding arguments
+ * `--total-shards` specifies how many shards the suite should
+ be split into
+ * `--shard-index` specifies which shard should be run
+
+## 1.7.0
+
+* Add a `--debug` flag for running the VM/Chrome in debug mode.
+
+## 1.6.11
+
+* Depend on the latest `test_core` and `test_api`.
+
+## 1.6.10
+
+* Depend on the latest `test_core`.
+
+## 1.6.9
+
+* Add `--disable-dev-shm-usage` to the default Chrome flags.
+
+## 1.6.8
+
+* Depend on the latest `test_core` and `test_api`.
+
+## 1.6.7
+
+* Allow `analyzer` version `0.38.x`.
+
+## 1.6.6
+
+* Pass `--server-mode` to dart2js instead of `--categories=Server` to fix a
+ warning about the flag deprecation.
+* Drop dependency on `pub_semver`.
+* Fix issue with the latest `Utf8Decoder` and the `node` platform.
+
+## 1.6.5
+
+* Depend on the latest `test_core`.
+* Depend on the latest `package:analyzer`.
+
+## 1.6.4
+
+* Don't swallow exceptions from callbacks in `expectAsync*`.
+* Internal cleanup - fix lints.
+
+## 1.6.3
+
+* Depend on latest `package:test_core`.
+ * This fixes an issue where non-completed tests were considered passing.
+
+## 1.6.2
+
+* Avoid `dart:isolate` imports on code loaded in tests.
+
+## 1.6.1
+
+* Allow `stream_channel` version `2.0.0`.
+
+## 1.6.0
+
+* Allow `analyzer` version `0.36.x`.
+* Matcher changes:
+ * Add `isA()` to create `TypeMatcher` instances in a more fluent way.
+ * Add `isCastError`.
+ * **Potentially breaking bug fix**. Ordering matchers no longer treat objects
+ with a partial ordering (such as NaN for double values) as if they had a
+ complete ordering. For instance `greaterThan` now compares with the `>`
+ operator rather not `<` and not `=`. This could cause tests which relied on
+ this bug to start failing.
+
+## 1.5.3
+
+* Allow `analyzer` version `0.35.x`.
+
+## 1.5.2
+
+* Require Dart SDK `>=2.1.0`.
+* Depend on latest `test_core` and `test_api`.
+
+## 1.5.1
+
+* Depend on latest `test_core` and `test_api`.
+
+## 1.5.0
+
+* Depend on `package:test_core` for core functionality.
+
+## 1.4.0
+
+* Depend on `package:test_api` for core functionality.
+
+## 1.3.4
+
+* Allow remote_listener to be closed and sent an event on close.
+
+## 1.3.3
+
+* Add conditional imports so that `dart:io` is not imported from the main
+ `test.dart` entrypoint unless it is available.
+* Fix an issue with dartdevc in precompiled mode and the json reporter.
+* Fix an issue parsing test metadata annotations without explicit `const`.
+
+## 1.3.2
+
+* Widen the constraints on the analyzer package.
+
+## 1.3.1
+
+* Handle parsing annotations which omit `const` on collection literals.
+* Fix an issue where `root_line`, `root_column`, and `root_url` in the
+ JSON reported may not be populated correctly on Windows.
+* Removed requirement for the test/pub_serve transformer in --pub-serve mode.
+
+## 1.3.0
+
+* When using `--precompiled`, the test runner now allows symlinks to reach
+ outside the precompiled directory. This allows more efficient creation of
+ precompiled directories (using symlinks instead of copies).
+* Updated max sdk range to `<3.0.0`.
+
+## 1.2.0
+
+* Added support for using precompiled kernel files when running vm tests.
+ * When using the `--precompiled` flag we will now first check for a
+ `<original-test-path>.vm_test.vm.app.dill` file, and if present load that
+ directly in the isolate. Otherwise the `<original-test-path>.vm_test.dart`
+ file will be used.
+
+## 1.1.0
+
+* Added a new `pid` field to the StartEvent in the json runner containing the
+ pid of the VM process running the tests.
+
+## 1.0.0
+
+* No change from `0.12.42`. We are simply signalling to users that this is a
+ well supported package and is the preferred way to write Dart tests.
+
+## 0.12.42
+
+* Add support for `solo` test and group. When the argument is `true` only tests
+ and groups marked as solo will be run. It is still recommended that users
+ instead filter their tests by using the runner argument `-n`.
+
+* Updated exported `package:matcher` to `0.12.3` which includes these updates:
+
+ - Many improvements to `TypeMatcher`
+ - Can now be used directly as `const TypeMatcher<MyType>()`.
+ - Added a type parameter to specify the target `Type`.
+ - Made the `name` constructor parameter optional and marked it deprecated.
+ It's redundant to the type parameter.
+ - Migrated all `isType` matchers to `TypeMatcher`.
+ - Added a `having` function that allows chained validations of specific
+ features of the target type.
+
+ ```dart
+ /// Validates that the object is a [RangeError] with a message containing
+ /// the string 'details' and `start` and `end` properties that are `null`.
+ final _rangeMatcher = isRangeError
+ .having((e) => e.message, 'message', contains('details'))
+ .having((e) => e.start, 'start', isNull)
+ .having((e) => e.end, 'end', isNull);
+ ```
+
+ - Deprecated the `isInstanceOf` class. Use `TypeMatcher` instead.
+
+ - Improved the output of `Matcher` instances that fail due to type errors.
+
+## 0.12.41
+
+* Add support for debugging VM tests.
+* Tweak default reporter and color logic again so that they are always enabled
+ on all non-windows platforms.
+
+## 0.12.40
+
+* Added some new optional fields to the json reporter, `root_line`,
+ `root_column`, and `root_url`. These will be present if `url` is not the same
+ as the suite url, and will represent the location in the original test suite
+ from which the call to `test` originated.
+
+## 0.12.39
+
+* Change the default reporter and color defaults to be based on
+ `stdout.supportsAnsiEscapes` instead of based on platform (previously both
+ were disabled on windows).
+
+## 0.12.38+3
+
+* Fix Dart 2 runtime errors around communicating with browsers.
+
+
+## 0.12.38+2
+
+* Fix more Dart 2 runtime type errors.
+
+## 0.12.38+1
+
+* Fix several Dart 2 runtime type errors.
+
+## 0.12.38
+
+* Give `neverCalled` a type that works in Dart 2 semantics.
+* Support `package:analyzer` `0.32.0`.
+
+## 0.12.37
+
+* Removed the transformer, and the `pub_serve.dart` entrypoint. This is not
+ being treated as a breaking change because the minimum sdk constraint now
+ points to an sdk which does not support pub serve or barback any more anyways.
+* Drop the dependency on `barback`.
+
+## 0.12.36
+
+* Expose the test bootstrapping methods, so that build systems can precompile
+ tests without relying on internal apis.
+
+## 0.12.35
+
+* Dropped support for Dart 1. Going forward only Dart 2 will be supported.
+ * If you experience blocking issues and are still on the Dart 1 sdk, we will
+ consider bug fixes on a per-case basis based on severity and impact.
+ * Drop support for `dartium` and `content-shell` platforms since those are
+ removed from the Dart 2 SDK.
+* Fixed an issue `--precompiled` node tests in subdirectories.
+* Fixed some dart2 issues with node test bootstrapping code so that dartdevc
+ tests can run.
+* Fixed default custom html handler so it correctly includes the
+ packages/test/dart.js file. This allows you to get proper errors instead of
+ timeouts if there are load exceptions in the browser.
+* Upgrade to package:matcher 0.12.2
+
+## 0.12.34
+
+* Requires at least Dart 1.24.0.
+* The `--precompiled` flag is now supported for the vm platform and the node
+ platform.
+* On browser platforms the `--precompiled` flag now serves all sources directly
+ from the precompiled directory, and will never attempt to do its own
+ compilation.
+
+## 0.12.33
+
+* Pass `--categories=Server` to `dart2js` when compiling tests for Node.js. This
+ tells it that `dart:html` is unavailable.
+
+* Don't crash when attempting to format stack traces when running via
+ `dart path/to/test.dart`.
+
+## 0.12.32+2
+
+* Work around an SDK bug that caused timeouts in asynchronous code.
+
+## 0.12.32+1
+
+* Fix a bug that broke content shell on Dart 1.24.
+
+## 0.12.32
+
+* Add an `include` configuration field which specifies the path to another
+ configuration file whose configuration should be used.
+
+* Add a `google` platform selector variable that's only true on Google's
+ internal infrastructure.
+
+## 0.12.31
+
+* Add a `headless` configuration option for Chrome.
+
+* Re-enable headless mode for Chrome by default.
+
+* Don't hang when a Node.js test fails to compile.
+
+## 0.12.30+4
+
+* Stop running Chrome in headless mode temporarily to work around a browser bug.
+
+## 0.12.30+3
+
+* Fix a memory leak when loading browser tests.
+
+## 0.12.30+2
+
+* Avoid loading test suites whose tags are excluded by `--excluded-tags`.
+
+## 0.12.30+1
+
+* Internal changes.
+
+## 0.12.30
+
+* Platform selectors for operating systems now work for Node.js tests
+ ([#742][]).
+
+* `fail()` is now typed to return `Null`, so it can be used in the same places
+ as a raw `throw`.
+
+* Run Chrome in headless mode unless debugging is enabled.
+
+[#742]: https://github.com/dart-lang/test/issues/742
+
+## 0.12.29+1
+
+* Fix strong mode runtime cast failures.
+
+## 0.12.29
+
+* Node.js tests can now import modules from a top-level `node_modules`
+ directory, if one exists.
+
+* Raw `console.log()` calls no longer crash Node.js tests.
+
+* When a browser crashes, include its standard output in the error message.
+
+## 0.12.28+1
+
+* Add a `pumpEventQueue()` function to make it easy to wait until all
+ asynchronous tasks are complete.
+
+* Add a `neverCalled` getter that returns a function that causes the test to
+ fail if it's ever called.
+
+## 0.12.27+1
+
+* Increase the timeout for loading tests to 12 minutes.
+
+## 0.12.27
+
+* When `addTearDown()` is called within a call to `setUpAll()`, it runs its
+ callback after *all* tests instead of running it after the `setUpAll()`
+ callback.
+
+* When running in an interactive terminal, the test runner now prints status
+ lines as wide as the terminal and no wider.
+
+## 0.12.26+1
+
+* Fix lower bound on package `stack_trace`. Now 1.6.0.
+* Manually close browser process streams to prevent test hangs.
+
+## 0.12.26
+
+* The `spawnHybridUri()` function now allows root-relative URLs, which are
+ interpreted as relative to the root of the package.
+
+## 0.12.25
+
+* Add a `override_platforms` configuration field which allows test platforms'
+ settings (such as browsers' executables) to be overridden by the user.
+
+* Add a `define_platforms` configuration field which makes it possible to define
+ new platforms that use the same logic as existing ones but have different
+ settings.
+
+## 0.12.24+8
+
+* `spawnHybridUri()` now interprets relative URIs correctly in browser tests.
+
+## 0.12.24+7
+
+* Declare support for `async` 2.0.0.
+
+## 0.12.24+6
+
+* Small refactoring to make the package compatible with strong-mode compliant Zone API.
+ No user-visible change.
+
+## 0.12.24+5
+
+* Expose a way for tests to forward a `loadException` to the server.
+
+## 0.12.24+4
+
+* Drain browser process `stdout` and `stdin`. This resolves test flakiness, especially in Travis
+ with the `Precise` image.
+
+## 0.12.24+3
+
+* Extend `deserializeTimeout`.
+
+## 0.12.24+2
+
+* Only force exit if `FORCE_TEST_EXIT` is set in the environment.
+
+## 0.12.24+1
+
+* Widen version constraint on `analyzer`.
+
+## 0.12.24
+
+* Add a `node` platform for compiling tests to JavaScript and running them on
+ Node.js.
+
+## 0.12.23+1
+
+* Remove unused imports.
+
+## 0.12.23
+
+* Add a `fold_stack_frames` field for `dart_test.yaml`. This will
+ allow users to customize which packages' frames are folded.
+
+## 0.12.22+2
+
+* Properly allocate ports when debugging Chrome and Dartium in an IPv6-only
+ environment.
+
+## 0.12.22+1
+
+* Support `args` 1.0.0.
+
+* Run tear-down callbacks in the same error zone as the test function. This
+ makes it possible to safely share `Future`s and `Stream`s between tests and
+ their tear-downs.
+
+## 0.12.22
+
+* Add a `retry` option to `test()` and `group()` functions, as well
+ as `@Retry()` annotation for test files and a `retry`
+ configuration field for `dart_test.yaml`. A test with reties
+ enabled will be re-run if it fails for a reason other than a
+ `TestFailure`.
+
+* Add a `--no-retry` runner flag that disables retries of failing tests.
+
+* Fix a "concurrent modification during iteration" error when calling
+ `addTearDown()` from within a tear down.
+
+## 0.12.21
+
+* Add a `doesNotComplete` matcher that asserts that a Future never completes.
+
+* `throwsA()` and all related matchers will now match functions that return
+ `Future`s that emit exceptions.
+
+* Respect `onPlatform` for groups.
+
+* Only print browser load errors once per browser.
+
+* Gracefully time out when attempting to deserialize a test suite.
+
+## 0.12.20+13
+
+* Upgrade to package:matcher 0.12.1
+
+## 0.12.20+12
+
+* Now support `v0.30.0` of `pkg/analyzer`
+
+* The test executable now does a "hard exit" when complete to ensure lingering
+ isolates or async code don't block completion. This may affect users trying
+ to use the Dart service protocol or observatory.
+
+## 0.12.20+11
+
+* Refactor bootstrapping to simplify the test/pub_serve transformer.
+
+## 0.12.20+10
+
+* Refactor for internal tools.
+
+## 0.12.20+9
+
+* Introduce new flag `--chain-stack-traces` to conditionally chain stack traces.
+
+## 0.12.20+8
+
+* Fixed more blockers for compiling with `dev_compiler`.
+* Dartfmt the entire repo.
+
+* **Note:** 0.12.20+5-0.12.20+7 were tagged but not officially published.
+
+## 0.12.20+4
+
+* Fixed strong-mode errors and other blockers for compiling with `dev_compiler`.
+
+## 0.12.20+3
+
+* `--pause-after-load` no longer deadlocks with recent versions of Chrome.
+
+* Fix Dartified stack traces for JS-compiled tests run through `pub serve`.
+
+## 0.12.20+2
+
+* Print "[E]" after test failures to make them easier to identify visually and
+ via automated search.
+
+## 0.12.20+1
+
+* Tighten the dependency on `stream_channel` to reflect the APIs being used.
+
+* Use a 1024 x 768 iframe for browser tests.
+
+## 0.12.20
+
+* **Breaking change:** The `expect()` method no longer returns a `Future`, since
+ this broke backwards-compatibility in cases where a void function was
+ returning an `expect()` (such as `void foo() => expect(...)`). Instead, a new
+ `expectLater()` function has been added that return a `Future` that completes
+ when the matcher has finished running.
+
+* The `verbose` parameter to `expect()` and the `formatFailure()` function are
+ deprecated.
+
+## 0.12.19+1
+
+* Make sure asynchronous matchers that can fail synchronously, such as
+ `throws*()` and `prints()`, can be used with synchronous matcher operators
+ like `isNot()`.
+
+## 0.12.19
+
+* Added the `StreamMatcher` class, as well as several built-in stream matchers:
+ `emits()`, `emitsError()`, `emitsDone, mayEmit()`, `mayEmitMultiple()`,
+ `emitsAnyOf()`, `emitsInOrder()`, `emitsInAnyOrder()`, and `neverEmits()`.
+
+* `expect()` now returns a Future for the asynchronous matchers `completes`,
+ `completion()`, `throws*()`, and `prints()`.
+
+* Add a `printOnFailure()` method for providing debugging information that's
+ only printed when a test fails.
+
+* Automatically configure the [`term_glyph`][term_glyph] package to use ASCII
+ glyphs when the test runner is running on Windows.
+
+[term_glyph]: https://pub.dev/packages/term_glyph
+
+* Deprecate the `throws` matcher in favor of `throwsA()`.
+
+* Deprecate the `Throws` class. These matchers should only be constructed via
+ `throwsA()`.
+
+## 0.12.18+1
+
+* Fix the deprecated `expectAsync()` function. The deprecation caused it to
+ fail to support functions that take arguments.
+
+## 0.12.18
+
+* Add an `addTearDown()` function, which allows tests to register additional
+ tear-down callbacks as they're running.
+
+* Add the `spawnHybridUri()` and `spawnHybridCode()` functions, which allow
+ browser tests to run code on the VM.
+
+* Fix the new `expectAsync` functions so that they don't produce analysis errors
+ when passed callbacks with optional arguments.
+
+## 0.12.17+3
+
+* Internal changes only.
+
+## 0.12.17+2
+
+* Fix Dartium debugging on Windows.
+
+## 0.12.17+1
+
+* Fix a bug where tags couldn't be marked as skipped.
+
+## 0.12.17
+
+* Deprecate `expectAsync` and `expectAsyncUntil`, since they currently can't be
+ made to work cleanly in strong mode. They are replaced with separate methods
+ for each number of callback arguments:
+ * `expectAsync0`, `expectAsync1`, ... `expectAsync6`, and
+ * `expectAsyncUntil0`, `expectAsyncUntil1`, ... `expectAsyncUntil6`.
+
+## 0.12.16
+
+* Allow tools to interact with browser debuggers using the JSON reporter.
+
+## 0.12.15+12
+
+* Fix a race condition that could cause the runner to stall for up to three
+ seconds after completing.
+
+## 0.12.15+11
+
+* Make test iframes visible when debugging.
+
+## 0.12.15+10
+
+* Throw a better error if a group body is asynchronous.
+
+## 0.12.15+9
+
+* Widen version constraint on `analyzer`.
+
+## 0.12.15+8
+
+* Make test suites with thousands of tests load much faster on the VM (and
+ possibly other platforms).
+
+## 0.12.15+7
+
+* Fix a bug where tags would be dropped when `on_platform` was defined in a
+ config file.
+
+## 0.12.15+6
+
+* Fix a broken link in the `--help` documentation.
+
+## 0.12.15+5
+
+* Internal-only change.
+
+## 0.12.15+4
+
+* Widen version constraint on `analyzer`.
+
+## 0.12.15+3
+
+* Move `nestingMiddleware` to `lib/src/util/path_handler.dart` to enable a
+ cleaner separation between test-runner files and test writing files.
+
+## 0.12.15+2
+
+* Support running without a `packages/` directory.
+
+## 0.12.15+1
+
+* Declare support for version 1.19 of the Dart SDK.
+
+## 0.12.15
+
+* Add a `skip` parameter to `expect()`. Marking a single expect as skipped will
+ cause the test itself to be marked as skipped.
+
+* Add a `--run-skipped` parameter and `run_skipped` configuration field that
+ cause tests to be run even if they're marked as skipped.
+
+## 0.12.14+1
+
+* Narrow the constraint on `yaml`.
+
+## 0.12.14
+
+* Add test and group location information to the JSON reporter.
+
+## 0.12.13+5
+
+* Declare support for version 1.18 of the Dart SDK.
+
+* Use the latest `collection` package.
+
+## 0.12.13+4
+
+* Compatibility with an upcoming release of the `collection` package.
+
+## 0.12.13+3
+
+* Internal changes only.
+
+## 0.12.13+2
+
+* Fix all strong-mode errors and warnings.
+
+## 0.12.13+1
+
+* Declare support for version 1.17 of the Dart SDK.
+
+## 0.12.13
+
+* Add support for a global configuration file. On Windows, this file defaults to
+ `%LOCALAPPDATA%\DartTest.yaml`. On Unix, it defaults to `~/.dart_test.yaml`.
+ It can also be explicitly set using the `DART_TEST_CONFIG` environment
+ variable. See [the configuration documentation][global config] for details.
+
+* The `--name` and `--plain-name` arguments may be passed more than once, and
+ may be passed together. A test must match all name constraints in order to be
+ run.
+
+* Add `names` and `plain_names` fields to the package configuration file. These
+ allow presets to control which tests are run based on their names.
+
+* Add `include_tags` and `exclude_tags` fields to the package configuration
+ file. These allow presets to control which tests are run based on their tags.
+
+* Add a `pause_after_load` field to the package configuration file. This allows
+ presets to enable debugging mode.
+
+[global config]: https://github.com/dart-lang/test/blob/master/pkgs/test/doc/configuration.md#global-configuration
+
+## 0.12.12
+
+* Add support for [test presets][]. These are defined using the `presets` field
+ in the package configuration file. They can be selected by passing `--preset`
+ or `-P`, or by using the `add_presets` field in the package configuration
+ file.
+
+* Add an `on_os` field to the package configuration file that allows users to
+ select different configuration for different operating systems.
+
+* Add an `on_platform` field to the package configuration file that allows users
+ to configure all tests differently depending on which platform they run on.
+
+* Add an `ios` platform selector variable. This variable will only be true when
+ the `test` executable itself is running on iOS, not when it's running browser
+ tests on an iOS browser.
+
+[test presets]: https://github.com/dart-lang/test/blob/master/pkgs/test/doc/package_config.md#configuration-presets
+
+## 0.12.11+2
+
+* Update to `shelf_web_socket` 0.2.0.
+
+## 0.12.11+1
+
+* Purely internal change.
+
+## 0.12.11
+
+* Add a `tags` field to the package configuration file that allows users to
+ provide configuration for specific tags.
+
+* The `--tags` and `--exclude-tags` command-line flags now allow
+ [boolean selector syntax][]. For example, you can now pass `--tags "(chrome ||
+ firefox) && !slow"` to select quick Chrome or Firefox tests.
+
+[boolean selector syntax]: https://github.com/dart-lang/boolean_selector/blob/master/README.md
+
+## 0.12.10+2
+
+* Re-add help output separators.
+
+* Tighten the constraint on `args`.
+
+## 0.12.10+1
+
+* Temporarily remove separators from the help output. Version 0.12.8 was
+ erroneously released without an appropriate `args` constraint for the features
+ it used; this version will help ensure that users who can't use `args` 0.13.1
+ will get a working version of `test`.
+
+## 0.12.10
+
+* Add support for a package-level configuration file called `dart_test.yaml`.
+
+## 0.12.9
+
+* Add `SuiteEvent` to the JSON reporter, which reports data about the suites in
+ which tests are run.
+
+* Add `AllSuitesEvent` to the JSON reporter, which reports the total number of
+ suites that will be run.
+
+* Add `Group.testCount` to the JSON reporter, which reports the total number of
+ tests in each group.
+
+## 0.12.8
+
+* Organize the `--help` output into sections.
+
+* Add a `--timeout` flag.
+
+## 0.12.7
+
+* Add the ability to re-run tests while debugging. When the browser is paused at
+ a breakpoint, the test runner will open an interactive console on the command
+ line that can be used to restart the test.
+
+* Add support for passing any object as a description to `test()` and `group()`.
+ These objects will be converted to strings.
+
+* Add the ability to tag tests. Tests with specific tags may be run by passing
+ the `--tags` command-line argument, or excluded by passing the
+ `--exclude-tags` parameter.
+
+ This feature is not yet complete. For now, tags are only intended to be added
+ temporarily to enable use-cases like [focusing][] on a specific test or group.
+ Further development can be followed on [the issue tracker][issue 16].
+
+* Wait for a test's tear-down logic to run, even if it times out.
+
+[focusing]: https://jasmine.github.io/2.1/focused_specs.html
+[issue 16]: https://github.com/dart-lang/test/issues/16
+
+## 0.12.6+2
+
+* Declare compatibility with `http_parser` 2.0.0.
+
+## 0.12.6+1
+
+* Declare compatibility with `http_multi_server` 2.0.0.
+
+## 0.12.6
+
+* Add a machine-readable JSON reporter. For details, see
+ [the protocol documentation][json-protocol].
+
+* Skipped groups now properly print skip messages.
+
+[json-protocol]: https://github.com/dart-lang/test/blob/master/pkgs/test/json_reporter.md
+
+## 0.12.5+2
+
+* Declare compatibility with Dart 1.14 and 1.15.
+
+## 0.12.5+1
+
+* Fixed a deadlock bug when using `setUpAll()` and `tearDownAll()`.
+
+## 0.12.5
+
+* Add `setUpAll()` and `tearDownAll()` methods that run callbacks before and
+ after all tests in a group or suite. **Note that these methods are for special
+ cases and should be avoided**—they make it very easy to accidentally introduce
+ dependencies between tests. Use `setUp()` and `tearDown()` instead if
+ possible.
+
+* Allow `setUp()` and `tearDown()` to be called multiple times within the same
+ group.
+
+* When a `tearDown()` callback runs after a signal has been caught, it can now
+ schedule out-of-band asynchronous callbacks normally rather than having them
+ throw exceptions.
+
+* Don't show package warnings when compiling tests with dart2js. This was
+ accidentally enabled in 0.12.2, but was never intended.
+
+## 0.12.4+9
+
+* If a `tearDown()` callback throws an error, outer `tearDown()` callbacks are
+ still executed.
+
+## 0.12.4+8
+
+* Don't compile tests to JavaScript when running via `pub serve` on Dartium or
+ content shell.
+
+## 0.12.4+7
+
+* Support `http_parser` 1.0.0.
+
+## 0.12.4+6
+
+* Fix a broken link in the README.
+
+## 0.12.4+5
+
+* Internal changes only.
+
+## 0.12.4+4
+
+* Widen the Dart SDK constraint to include `1.13.0`.
+
+## 0.12.4+3
+
+* Make source maps work properly in the browser when not using `--pub-serve`.
+
+## 0.12.4+2
+
+* Fix a memory leak when running many browser tests where old test suites failed
+ to be unloaded when they were supposed to.
+
+## 0.12.4+1
+
+* Require Dart SDK >= `1.11.0` and `shelf` >= `0.6.0`, allowing `test` to remove
+ various hacks and workarounds.
+
+## 0.12.4
+
+* Add a `--pause-after-load` flag that pauses the test runner after each suite
+ is loaded so that breakpoints and other debugging annotations can be added.
+ Currently this is only supported on browsers.
+
+* Add a `Timeout.none` value indicating that a test should never time out.
+
+* The `dart-vm` platform selector variable is now `true` for Dartium and content
+ shell.
+
+* The compact reporter no longer prints status lines that only update the clock
+ if they would get in the way of messages or errors from a test.
+
+* The expanded reporter no longer double-prints the descriptions of skipped
+ tests.
+
+## 0.12.3+9
+
+* Widen the constraint on `analyzer` to include `0.26.0`.
+
+## 0.12.3+8
+
+* Fix an uncaught error that could crop up when killing the test runner process
+ at the wrong time.
+
+## 0.12.3+7
+
+* Add a missing dependency on the `collection` package.
+
+## 0.12.3+6
+
+**This version was unpublished due to [issue 287][].**
+
+* Properly report load errors caused by failing to start browsers.
+
+* Substantially increase browser timeouts. These timeouts are the cause of a lot
+ of flakiness, and now that they don't block test running there's less harm in
+ making them longer.
+
+## 0.12.3+5
+
+**This version was unpublished due to [issue 287][].**
+
+* Fix a crash when skipping tests because their platforms don't match.
+
+## 0.12.3+4
+
+**This version was unpublished due to [issue 287][].**
+
+* The compact reporter will update the timer every second, rather than only
+ updating it occasionally.
+
+* The compact reporter will now print the full, untruncated test name before any
+ errors or prints emitted by a test.
+
+* The expanded reporter will now *always* print the full, untruncated test name.
+
+## 0.12.3+3
+
+**This version was unpublished due to [issue 287][].**
+
+* Limit the number of test suites loaded at once. This helps ensure that the
+ test runner won't run out of memory when running many test suites that each
+ load a large amount of code.
+
+## 0.12.3+2
+
+**This version was unpublished due to [issue 287][].**
+
+[issue 287]: https://github.com/dart-lang/test/issues/287
+
+* Improve the display of syntax errors in VM tests.
+
+* Work around a [Firefox bug][]. Computed styles now work in tests on Firefox.
+
+[Firefox bug]: https://bugzilla.mozilla.org/show_bug.cgi?id=548397
+
+* Fix a bug where VM tests would be loaded from the wrong URLs on Windows (or in
+ special circumstances on other operating systems).
+
+## 0.12.3+1
+
+* Fix a bug that caused the test runner to crash on Windows because symlink
+ resolution failed.
+
+## 0.12.3
+
+* If a future matched against the `completes` or `completion()` matcher throws
+ an error, that error is printed directly rather than being wrapped in a
+ string. This allows such errors to be captured using the Zone API and improves
+ formatting.
+
+* Improve support for Polymer tests. This fixes a flaky time-out error and adds
+ support for Dartifying JavaScript stack traces when running Polymer tests via
+ `pub serve`.
+
+* In order to be more extensible, all exception handling within tests now uses
+ the Zone API.
+
+* Add a heartbeat to reset a test's timeout whenever the test interacts with the
+ test infrastructure.
+
+* `expect()`, `expectAsync()`, and `expectAsyncUntil()` throw more useful errors
+ if called outside a test body.
+
+## 0.12.2
+
+* Convert JavaScript stack traces into Dart stack traces using source maps. This
+ can be disabled with the new `--js-trace` flag.
+
+* Improve the browser test suite timeout logic to avoid timeouts when running
+ many browser suites at once.
+
+## 0.12.1
+
+* Add a `--verbose-trace` flag to include core library frames in stack traces.
+
+## 0.12.0
+
+### Test Runner
+
+`0.12.0` adds support for a test runner, which can be run via
+`pub run test:test` (or `pub run test` in Dart 1.10). By default it runs all
+files recursively in the `test/` directory that end in `_test.dart` and aren't
+in a `packages/` directory.
+
+The test runner supports running tests on the Dart VM and many different
+browsers. Test files can use the `@TestOn` annotation to declare which platforms
+they support. For more information on this and many more new features, see [the
+README](README).
+
+[README]: https://github.com/dart-lang/test/blob/master/README.md
+
+### Removed and Changed APIs
+
+As part of moving to a runner-based model, most test configuration is moving out
+of the test file and into the runner. As such, many ancillary APIs have been
+removed. These APIs include `skip_` and `solo_` functions, `Configuration` and
+all its subclasses, `TestCase`, `TestFunction`, `testConfiguration`,
+`formatStacks`, `filterStacks`, `groupSep`, `logMessage`, `testCases`,
+`BREATH_INTERVAL`, `currentTestCase`, `PASS`, `FAIL`, `ERROR`, `filterTests`,
+`runTests`, `ensureInitialized`, `setSoloTest`, `enableTest`, `disableTest`, and
+`withTestEnvironment`.
+
+`FailureHandler`, `DefaultFailureHandler`, `configureExpectFailureHandler`, and
+`getOrCreateExpectFailureHandler` which used to be exported from the `matcher`
+package have also been removed. They existed to enable integration between
+`test` and `matcher` that has been streamlined.
+
+A number of APIs from `matcher` have been into `test`, including: `completes`,
+`completion`, `ErrorFormatter`, `expect`,`fail`, `prints`, `TestFailure`,
+`Throws`, and all of the `throws` methods. Some of these have changed slightly:
+
+* `expect` no longer has a named `failureHandler` argument.
+
+* `expect` added an optional `formatter` argument.
+
+* `completion` argument `id` renamed to `description`.
+
+## 0.11.6+4
+
+* Fix some strong mode warnings we missed in the `vm_config.dart` and
+ `html_config.dart` libraries.
+
+## 0.11.6+3
+
+* Fix a bug introduced in 0.11.6+2 in which operator matchers broke when taking
+ lists of matchers.
+
+## 0.11.6+2
+
+* Fix all strong mode warnings.
+
+## 0.11.6+1
+
+* Give tests more time to start running.
+
+## 0.11.6
+
+* Merge in the last `0.11.x` release of `matcher` to allow projects to use both
+ `test` and `unittest` without conflicts.
+
+* Fix running individual tests with `HtmlIndividualConfiguration` when the test
+ name contains URI-escaped values and is provided with the `group` query
+ parameter.
+
+## 0.11.5+1
+
+* Internal code cleanups and documentation improvements.
+
+## 0.11.5
+
+* Bumped the version constraint for `matcher`.
+
+## 0.11.4
+
+* Bump the version constraint for `matcher`.
+
+## 0.11.3
+
+* Narrow the constraint on matcher to ensure that new features are reflected in
+ unittest's version.
+
+## 0.11.2
+
+* Prints a warning instead of throwing an error when setting the test
+ configuration after it has already been set. The first configuration is always
+ used.
+
+## 0.11.1+1
+
+* Fix bug in withTestEnvironment where test cases were not reinitialized if
+ called multiple times.
+
+## 0.11.1
+
+* Add `reason` named argument to `expectAsync` and `expectAsyncUntil`, which has
+ the same definition as `expect`'s `reason` argument.
+* Added support for private test environments.
+
+## 0.11.0+6
+
+* Refactored package tests.
+
+## 0.11.0+5
+
+* Release test functions after each test is run.
+
+## 0.11.0+4
+
+* Fix for [20153](https://code.google.com/p/dart/issues/detail?id=20153)
+
+## 0.11.0+3
+
+* Updated maximum `matcher` version.
+
+## 0.11.0+2
+
+* Removed unused files from tests and standardized remaining test file names.
+
+## 0.11.0+1
+
+* Widen the version constraint for `stack_trace`.
+
+## 0.11.0
+
+* Deprecated methods have been removed:
+ * `expectAsync0`, `expectAsync1`, and `expectAsync2` - use `expectAsync`
+ instead
+ * `expectAsyncUntil0`, `expectAsyncUntil1`, and `expectAsyncUntil2` - use
+ `expectAsyncUntil` instead
+ * `guardAsync` - no longer needed
+ * `protectAsync0`, `protectAsync1`, and `protectAsync2` - no longer needed
+* `matcher.dart` and `mirror_matchers.dart` have been removed. They are now in
+ the `matcher` package.
+* `mock.dart` has been removed. It is now in the `mock` package.
+
+## 0.10.1+2
+
+* Fixed deprecation message for `mock`.
+
+## 0.10.1+1
+
+* Fixed CHANGELOG
+* Moved to triple-slash for all doc comments.
+
+## 0.10.1
+
+* **DEPRECATED**
+ * `matcher.dart` and `mirror_matchers.dart` are now in the `matcher`
+ package.
+ * `mock.dart` is now in the `mock` package.
+* `equals` now allows a nested matcher as an expected list element or map value
+ when doing deep matching.
+* `expectAsync` and `expectAsyncUntil` now support up to 6 positional arguments
+ and correctly handle functions with optional positional arguments with default
+ values.
+
+## 0.10.0
+
+* Each test is run in a separate `Zone`. This ensures that any exceptions that
+ occur is async operations are reported back to the source test case.
+* **DEPRECATED** `guardAsync`, `protectAsync0`, `protectAsync1`,
+ and `protectAsync2`
+ * Running each test in a `Zone` addresses the need for these methods.
+* **NEW!** `expectAsync` replaces the now deprecated `expectAsync0`,
+ `expectAsync1` and `expectAsync2`
+* **NEW!** `expectAsyncUntil` replaces the now deprecated `expectAsyncUntil0`,
+ `expectAsyncUntil1` and `expectAsyncUntil2`
+* `TestCase`:
+ * Removed properties: `setUp`, `tearDown`, `testFunction`
+ * `enabled` is now get-only
+ * Removed methods: `pass`, `fail`, `error`
+* `interactive_html_config.dart` has been removed.
+* `runTests`, `tearDown`, `setUp`, `test`, `group`, `solo_test`, and
+ `solo_group` now throw a `StateError` if called while tests are running.
+* `rerunTests` has been removed.
diff --git a/pkgs/test/LICENSE b/pkgs/test/LICENSE
new file mode 100644
index 0000000..000cd7b
--- /dev/null
+++ b/pkgs/test/LICENSE
@@ -0,0 +1,27 @@
+Copyright 2014, the Dart project authors.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+ * Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ * Redistributions in binary form must reproduce the above
+ copyright notice, this list of conditions and the following
+ disclaimer in the documentation and/or other materials provided
+ with the distribution.
+ * Neither the name of Google LLC nor the names of its
+ contributors may be used to endorse or promote products derived
+ from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
diff --git a/pkgs/test/README.md b/pkgs/test/README.md
new file mode 100644
index 0000000..36103d9
--- /dev/null
+++ b/pkgs/test/README.md
@@ -0,0 +1,874 @@
+[](https://pub.dev/packages/test)
+[](https://pub.dev/packages/test/publisher)
+
+`test` provides a standard way of writing and running tests in Dart.
+
+## Using package:test
+
+* [Writing Tests](#writing-tests)
+* [Running Tests](#running-tests)
+ * [Sharding Tests](#sharding-tests)
+ * [Test Concurrency](#test-concurrency)
+ * [Shuffling Tests](#shuffling-tests)
+ * [Selecting a Test Reporter](#selecting-a-test-reporter)
+ * [Collecting Code Coverage](#collecting-code-coverage)
+ * [Restricting Tests to Certain Platforms](#restricting-tests-to-certain-platforms)
+ * [Platform Selectors](#platform-selectors)
+ * [Compiler Selectors](#compiler-selectors)
+ * [Running Tests on Node.js](#running-tests-on-nodejs)
+* [Asynchronous Tests](#asynchronous-tests)
+* [Running Tests With Custom HTML](#running-tests-with-custom-html)
+ * [Providing a custom HTML template](#providing-a-custom-html-template)
+* [Configuring Tests](#configuring-tests)
+ * [Skipping Tests](#skipping-tests)
+ * [Timeouts](#timeouts)
+ * [Platform-Specific Configuration](#platform-specific-configuration)
+ * [Whole-Package Configuration](#whole-package-configuration)
+* [Tagging Tests](#tagging-tests)
+* [Debugging](#debugging)
+* [Browser/VM Hybrid Tests](#browservm-hybrid-tests)
+* [Support for Other Packages](#support-for-other-packages)
+ * [`build_runner`](#build_runner)
+ * [`term_glyph`](#term_glyph)
+* [Further Reading](#further-reading)
+
+## Writing Tests
+
+Tests are specified using the top-level [`test()`] function.
+Test asserts can be made using [`expect` from `package:matcher`][expect]
+
+[`test()`]: https://pub.dev/documentation/test/latest/test/test.html
+
+[expect]: https://pub.dev/documentation/matcher/latest/expect/expect.html
+
+```dart
+import 'package:test/test.dart';
+
+void main() {
+ test('String.split() splits the string on the delimiter', () {
+ var string = 'foo,bar,baz';
+ expect(string.split(','), equals(['foo', 'bar', 'baz']));
+ });
+
+ test('String.trim() removes surrounding whitespace', () {
+ var string = ' foo ';
+ expect(string.trim(), equals('foo'));
+ });
+}
+```
+
+Tests can be grouped together using the [`group()`] function. Each group's
+description is added to the beginning of its test's descriptions.
+
+[`group()`]: https://pub.dev/documentation/test/latest/test/group.html
+
+```dart
+import 'package:test/test.dart';
+
+void main() {
+ group('String', () {
+ test('.split() splits the string on the delimiter', () {
+ var string = 'foo,bar,baz';
+ expect(string.split(','), equals(['foo', 'bar', 'baz']));
+ });
+
+ test('.trim() removes surrounding whitespace', () {
+ var string = ' foo ';
+ expect(string.trim(), equals('foo'));
+ });
+ });
+
+ group('int', () {
+ test('.remainder() returns the remainder of division', () {
+ expect(11.remainder(3), equals(2));
+ });
+
+ test('.toRadixString() returns a hex string', () {
+ expect(11.toRadixString(16), equals('b'));
+ });
+ });
+}
+```
+
+You can use the [`setUp()`] and [`tearDown()`] functions to share code between
+tests. The `setUp()` callback will run before every test in a group or test
+suite, and `tearDown()` will run after. `tearDown()` will run even if a test
+fails, to ensure that it has a chance to clean up after itself.
+
+```dart
+import 'package:test/test.dart';
+
+void main() {
+ late HttpServer server;
+ late Uri url;
+ setUp(() async {
+ server = await HttpServer.bind('localhost', 0);
+ url = Uri.parse('http://${server.address.host}:${server.port}');
+ });
+
+ tearDown(() async {
+ await server.close(force: true);
+ server = null;
+ url = null;
+ });
+
+ // ...
+}
+```
+
+[`setUp()`]: https://pub.dev/documentation/test/latest/test/setUp.html
+
+[`tearDown()`]: https://pub.dev/documentation/test/latest/test/tearDown.html
+
+## Running Tests
+
+A single test file can be run just using `dart test path/to/test.dart` (as of
+Dart 2.10 - prior sdk versions must use `pub run test` instead of `dart test`).
+
+
+
+Many tests can be run at a time using `dart test path/to/dir`.
+
+
+
+It's also possible to run a test on the Dart VM only by invoking it using `dart
+path/to/test.dart`, but this doesn't load the full test runner and will be
+missing some features.
+
+The test runner accepts one or more path arguments. If there are no path
+arguments the runner defaults to running tests under the `test/` directory. When
+running for `test/` or any other directory, the runner will recursively search
+the directory for files that match the test name pattern `*_test.dart`. The
+pattern can be overridden in `dart_test.yaml`. When a path argument is a file
+instead of a directory it will be run as a test, regardless of the file name.
+Arguments which use shell globbing should avoid including non-test files in the
+path argument. Tests which are run by other test runners may use a different
+default path, such as `integration_test/`. Directories other than `test/` are
+ignored by `dart test` unless passed explicitly as a path to run.
+
+You can select specific tests cases to run by name using `dart test -n "test
+name"`. The string is interpreted as a regular expression, and only tests whose
+description (including any group descriptions) match that regular expression
+will be run. You can also use the `-N` flag to run tests whose names contain a
+plain-text string.
+
+By default, tests are run in the Dart VM, but you can run them in the browser as
+well by passing `dart test -p chrome path/to/test.dart`. `test` will take
+care of starting the browser and loading the tests, and all the results will be
+reported on the command line just like for VM tests. In fact, you can even run
+tests on both platforms with a single command: `dart test -p "chrome,vm"
+path/to/test.dart`.
+
+By default each platform has a default compiler, but some of them support
+more than one compiler. You can choose which compiler to use by passing
+`dart test -c source`, which would run all VM tests from source instead of
+compiling them to kernel. This also supports targeting a specific platform
+using normal platform selectors, like this `dart test -c vm:source`.
+
+### Test Path Queries
+
+Some query parameters are supported on test paths, which allow you to filter the
+tests that will run within just those paths. These filters are merged with any
+global options that are passed, and all filters must match for a test to be ran.
+
+- **name**: Works the same as `--name` (simple contains check).
+ - This is the only option that supports more than one entry.
+- **full-name**: Requires an exact match for the name of the test.
+- **line**: Matches any test that originates from this line in the test suite.
+- **col**: Matches any test that originates from this column in the test suite.
+
+**Example Usage**: `dart test "path/to/test.dart?line=10&col=2"`
+
+#### Line/Col Matching Semantics
+
+The `line` and `col` filters match against the current stack trace taken from
+the invocation to the `test` function, and are considered a match if
+**any frame** in the trace meets **all** of the following criteria:
+
+* The URI of the frame matches the root test suite uri.
+ * This means it will not match lines from imported libraries.
+* If both `line` and `col` are passed, both must match **the same frame**.
+* The specific `line` and `col` to be matched are defined by the tools creating
+ the stack trace. This generally means they are 1 based and not 0 based, but
+ this package is not in control of the exact semantics and they may vary based
+ on platform implementations.
+
+### Sharding Tests
+
+Tests can also be sharded with the `--total-shards` and `--shard-index` arguments,
+allowing you to split up your test suites and run them separately. For example,
+if you wanted to run 3 shards of your test suite, you could run them as follows:
+
+```bash
+dart test --total-shards 3 --shard-index 0 path/to/test.dart
+dart test --total-shards 3 --shard-index 1 path/to/test.dart
+dart test --total-shards 3 --shard-index 2 path/to/test.dart
+```
+Sharding: This refers to the process of splitting up a large test suite into
+smaller subsets (called shards) that can be run independently. Sharding is
+particularly useful for distributed testing, where multiple machines are used
+to run tests simultaneously. By dividing the test suite into smaller subsets,
+you can run tests in parallel across multiple machines, which can significantly
+reduce the overall testing time.
+
+### Test concurrency
+
+Test suites run concurrently by default, using half of the host's CPU cores. Use
+`--concurrency` to control the number of test suites that runs concurrently,
+meaning that multiple tests in independent suites or platforms can run at the
+same time. For example, if you wanted to run the tests on 4 threads, you could
+run the tests as follows:
+
+```bash
+dart test --concurrency=4
+```
+This can speed up the overall testing process, especially if you have a large
+number of test suites.
+
+### Shuffling Tests
+
+Test order can be shuffled with the `--test-randomize-ordering-seed` argument.
+This allows you to shuffle your tests with a specific seed (deterministic) or
+a random seed for each run. For example, consider the following test runs:
+
+```bash
+dart test --test-randomize-ordering-seed=12345
+dart test --test-randomize-ordering-seed=random
+```
+
+Setting `--test-randomize-ordering-seed=0` will have the same effect as not
+specifying it at all, meaning the test order will remain as-is.
+
+### Selecting a Test Reporter
+
+You can adjust the output format of test results using the `--reporter=<option>`
+command line flag. The default format is the `compact` output format - a single
+line, continuously updated as tests are run. When running on the GitHub Actions CI
+however (detected via checking the `GITHUB_ACTIONS` environment variable for `true`),
+the default changes to the `github` output format - a reporter customized
+for that CI/CD system.
+
+The available options for the `--reporter` flag are:
+
+- `compact`: a single, continuously updated line
+- `expanded`: a separate line for each update
+- `github`: a custom reporter for GitHub Actions
+- `json`: a machine-readable format; see https://dart.dev/go/test-docs/json_reporter.md
+
+### Collecting Code Coverage
+
+To collect code coverage, you can run tests with the `--coverage <directory>`
+argument. The directory specified can be an absolute or relative path.
+If a directory does not exist at the path specified, a directory will be
+created. If a directory does exist, files may be overwritten with the latest
+coverage data, if they conflict.
+
+This option will enable code coverage collection on a suite-by-suite basis,
+and the resulting coverage files will be outputted in the directory specified.
+The files can then be formatted using the `package:coverage`
+`format_coverage` executable.
+
+Coverage gathering is currently only implemented for tests run on the Dart VM or
+Chrome.
+
+Here's an example of how to run tests and format the collected coverage to LCOV:
+
+```shell
+## Run Dart tests and output them at directory `./coverage`:
+dart run test --coverage=./coverage
+
+## Activate package `coverage` (if needed):
+dart pub global activate coverage
+
+## Format collected coverage to LCOV (only for directory "lib")
+dart pub global run coverage:format_coverage --packages=.dart_tool/package_config.json --report-on=lib --lcov -o ./coverage/lcov.info -i ./coverage
+
+## Generate LCOV report:
+genhtml -o ./coverage/report ./coverage/lcov.info
+
+## Open the HTML coverage report:
+open ./coverage/report/index.html
+```
+
+* *LCOV is a GNU tool which provides information about what parts of a program are
+ actually executed (i.e. "covered") while running a particular test case.*
+* The binary `genhtml` is one of the LCOV tools.
+* See the LCOV project for more: https://github.com/linux-test-project/lcov
+* See the Homebrew LCOV formula: https://formulae.brew.sh/formula/lcov
+
+### Restricting Tests to Certain Platforms
+
+Some test files only make sense to run on particular platforms. They may use
+`dart:html` or `dart:io`, they might test Windows' particular filesystem
+behavior, or they might use a feature that's only available in Chrome. The
+[`@TestOn`] annotation makes it easy to declare exactly which platforms a test
+file should run on. Just put it at the top of your file, before any `library` or
+`import` declarations:
+
+```dart
+@TestOn('vm')
+
+import 'dart:io';
+
+import 'package:test/test.dart';
+
+void main() {
+ // ...
+}
+```
+
+[`@TestOn`]: https://pub.dev/documentation/test/latest/test/TestOn-class.html
+
+The string you pass to `@TestOn` is what's called a "platform selector", and it
+specifies exactly which platforms a test can run on. It can be as simple as the
+name of a platform, or a more complex Dart-like boolean expression involving
+these platform names.
+
+You can also declare that your entire package only works on certain platforms by
+adding a [`test_on` field] to your package config file.
+
+[`test_on` field]: https://github.com/dart-lang/test/blob/master/pkgs/test/doc/configuration.md#test_on
+
+### Platform Selectors
+
+Platform selectors use the [boolean selector syntax] defined in the
+[`boolean_selector`] package, which is a subset of Dart's expression syntax that
+only supports boolean operations. The following identifiers are defined:
+
+[boolean selector syntax]: https://github.com/dart-lang/boolean_selector/blob/master/README.md
+
+[`boolean_selector`]: https://pub.dev/packages/boolean_selector
+
+* `vm`: Whether the test is running on the command-line Dart VM.
+
+* `chrome`: Whether the test is running on Google Chrome.
+
+* `firefox`: Whether the test is running on Mozilla Firefox.
+
+* `safari`: Whether the test is running on Apple Safari.
+
+* `edge`: Whether the test is running on Microsoft Edge browser.
+
+* `node`: Whether the test is running on Node.js.
+
+* `dart-vm`: Whether the test is running on the Dart VM in any context. It's
+ identical to `!js`.
+
+* `browser`: Whether the test is running in any browser.
+
+* `js`: Whether the test has been compiled to JS. This is identical to
+ `!dart-vm`.
+
+* `blink`: Whether the test is running in a browser that uses the Blink
+ rendering engine.
+
+* `windows`: Whether the test is running on Windows. This can only be `true` if
+ either `vm` or `node` is true.
+
+* `mac-os`: Whether the test is running on MacOS. This can only be `true` if
+ either `vm` or `node` is true.
+
+* `linux`: Whether the test is running on Linux. This can only be `true` if
+ either `vm` or `node` is true.
+
+* `android`: Whether the test is running on Android. If `vm` is false, this will
+ be `false` as well, which means that this *won't* be true if the test is
+ running on an Android browser.
+
+* `ios`: Whether the test is running on iOS. If `vm` is false, this will be
+ `false` as well, which means that this *won't* be true if the test is running
+ on an iOS browser.
+
+* `posix`: Whether the test is running on a POSIX operating system. This is
+ equivalent to `!windows`.
+
+* `dart2js`: Whether the test has been compiled with Dart2Js.
+
+* `dart2wasm`: Whether the test has been compiled with Dart2Wasm.
+
+* `kernel`: Whether the test has been compiled to kernel.
+
+* `source`: Whether the test has been run with no compiler (from source).
+
+For example, if you wanted to run a test on every browser but Chrome, you would
+write `@TestOn('browser && !chrome')`.
+
+### Running Tests on Node.js
+
+The test runner also supports compiling tests to JavaScript and running them on
+[Node.js] by passing `--platform node`. Note that Node has access to *neither*
+`dart:html` nor `dart:io`, so any platform-specific APIs will have to be invoked
+using the [`js`] package. However, it may be useful when testing APIs that are
+meant to be used by JavaScript code.
+
+[Node.js]: https://nodejs.org/en/
+
+[`js`]: https://pub.dev/packages/js
+
+The test runner looks for an executable named `node` (on Mac OS or Linux) or
+`node.exe` (on Windows) on your system path. When compiling Node.js tests, it
+passes `-Dnode=true`, so tests can determine whether they're running on Node
+using [`const bool.fromEnvironment('node')`][bool.fromEnvironment]. It also sets
+`--server-mode`, which will tell the compiler that `dart:html` is not available.
+
+[bool.fromEnvironment]: https://api.dart.dev/stable/dart-core/bool/bool.fromEnvironment.html
+
+If a top-level `node_modules` directory exists, tests running on Node.js can
+import modules from it.
+
+## Asynchronous Tests
+
+Tests written with `async`/`await` will work automatically. The test runner
+won't consider the test finished until the returned `Future` completes.
+
+```dart
+import 'dart:async';
+
+import 'package:test/test.dart';
+
+void main() {
+ test('Future.value() returns the value', () async {
+ var value = await Future.value(10);
+ expect(value, equals(10));
+ });
+}
+```
+
+### Uncaught Async Errors
+
+Any uncaught asynchronous error throws within the zone that a test is running in
+will cause the test to be considered a failure. This can cause a test which was
+previously considered complete and passing to change into a failure if the
+uncaught async error is raised late. If all test cases within the suite have
+completed this may cause some errors to be missed, or to surface in only some
+runs.
+
+Avoid uncaught async errors by ensuring that all futures have an error handler
+[before they complete as an error][early-handler].
+
+[early-handler]:https://dart.dev/guides/libraries/futures-error-handling#potential-problem-failing-to-register-error-handlers-early
+
+## Running Tests With Custom HTML
+
+By default, the test runner will generate its own empty HTML file for browser
+tests. However, tests that need custom HTML can create their own files. These
+files have three requirements:
+
+* They must have the same name as the test, with `.dart` replaced by `.html`. You can also
+ provide a configuration path to an HTML file if you want it to be reused across all tests.
+ See [Providing a custom HTML template](#providing-a-custom-html-template) below.
+
+* They must contain a `link` tag with `rel="x-dart-test"` and an `href`
+ attribute pointing to the test script.
+
+* They must contain `<script src="packages/test/dart.js"></script>`.
+
+For example, if you had a test called `custom_html_test.dart`, you might write
+the following HTML file:
+
+```html
+<!doctype html>
+<!-- custom_html_test.html -->
+<html>
+ <head>
+ <title>Custom HTML Test</title>
+ <link rel="x-dart-test" href="custom_html_test.dart">
+ <script src="packages/test/dart.js"></script>
+ </head>
+ <body>
+ // ...
+ </body>
+</html>
+```
+
+### Providing a custom HTML template
+
+If you want to share the same HTML file across all tests, you can provide a
+`custom_html_template_path` configuration option to your configuration file.
+This file should follow the rules above, except that instead of the link tag
+add exactly one `{{testScript}}` in the place where you want the template processor to insert it.
+
+You can also optionally use any number of `{{testName}}` placeholders which will be replaced by the test filename.
+
+The template can't be named like any test file, as that would clash with using the
+custom HTML mechanics. In such a case, an error will be thrown.
+
+For example:
+
+```yaml
+custom_html_template_path: html_template.html.tpl
+```
+
+```html
+<!doctype html>
+<!-- html_template.html.tpl -->
+<html>
+ <head>
+ <title>{{testName}} Test</title>
+ {{testScript}}
+ <script src="packages/test/dart.js"></script>
+ </head>
+ <body>
+ // ...
+ </body>
+</html>
+```
+
+## Configuring Tests
+
+### Skipping Tests
+
+If a test, group, or entire suite isn't working yet, and you just want it to stop
+complaining, you can mark it as "skipped". The test or tests won't be run, and,
+if you supply a reason why, that reason will be printed. In general, skipping
+tests indicates that they should run but is temporarily not working. If they're
+fundamentally incompatible with a platform, [`@TestOn`/`testOn`][TestOn]
+should be used instead.
+
+[TestOn]: #restricting-tests-to-certain-platforms
+
+To skip a test suite, put a `@Skip` annotation at the top of the file:
+
+```dart
+@Skip('currently failing (see issue 1234)')
+
+import 'package:test/test.dart';
+
+void main() {
+ // ...
+}
+```
+
+The string you pass should describe why the test is skipped. You don't have to
+include it, but it's a good idea to document why the test isn't running.
+
+Groups and individual tests can be skipped by passing the `skip` parameter. This
+can be either `true` or a String describing why the test is skipped. For
+example:
+
+```dart
+import 'package:test/test.dart';
+
+void main() {
+ group('complicated algorithm tests', () {
+ // ...
+ }, skip: "the algorithm isn't quite right");
+
+ test('error-checking test', () {
+ // ...
+ }, skip: 'TODO: add error-checking.');
+}
+```
+
+### Timeouts
+
+By default, tests will time out after 30 seconds of inactivity. The timeout
+applies to deadlocks or cases where the test stops making progress, it does not
+ensure that an overall test case or test suite completes within any set time.
+
+Timeouts can be configured on a per-test, -group, or -suite basis. To change the
+timeout for a test suite, put a `@Timeout` annotation at the top of the file:
+
+```dart
+@Timeout(Duration(seconds: 45))
+
+import 'package:test/test.dart';
+
+void main() {
+ // ...
+}
+```
+
+In addition to setting an absolute timeout, you can set the timeout relative to
+the default using `@Timeout.factor`. For example, `@Timeout.factor(1.5)` will
+set the timeout to one and a half times as long as the default—45 seconds.
+
+Timeouts can be set for tests and groups using the `timeout` parameter. This
+parameter takes a `Timeout` object just like the annotation. For example:
+
+```dart
+import 'package:test/test.dart';
+
+void main() {
+ group('slow tests', () {
+ // ...
+
+ test('even slower test', () {
+ // ...
+ }, timeout: Timeout.factor(2));
+ }, timeout: Timeout(Duration(minutes: 1)));
+}
+```
+
+Nested timeouts apply in order from outermost to innermost. That means that
+"even slower test" will take two minutes to time out, since it multiplies the
+group's timeout by 2.
+
+### Platform-Specific Configuration
+
+Sometimes a test may need to be configured differently for different platforms.
+Windows might run your code slower than other platforms, or your DOM
+manipulation might not work right on Safari yet. For these cases, you can use
+the `@OnPlatform` annotation and the `onPlatform` named parameter to `test()`
+and `group()`. For example:
+
+```dart
+@OnPlatform({
+ // Give Windows some extra wiggle-room before timing out.
+ 'windows': Timeout.factor(2)
+})
+
+import 'package:test/test.dart';
+
+void main() {
+ test('do a thing', () {
+ // ...
+ }, onPlatform: {
+ 'safari': Skip('Safari is currently broken (see #1234)')
+ });
+}
+```
+
+Both the annotation and the parameter take a map. The map's keys are [platform
+selectors](#platform-selectors) which describe the platforms for which the
+specialized configuration applies. Its values are instances of some of the same
+annotation classes that can be used for a suite: `Skip` and `Timeout`. A value
+can also be a list of these values.
+
+If multiple platforms match, the configuration is applied in order from first to
+last, just as they would in nested groups. This means that for configuration
+like duration-based timeouts, the last matching value wins.
+
+You can also set up global platform-specific configuration using the
+[package configuration file][configuring platforms].
+
+[configuring platforms]: https://github.com/dart-lang/test/blob/master/pkgs/test/doc/configuration.md#configuring-platforms
+
+### Tagging Tests
+
+Tags are short strings that you can associate with tests, groups, and suites.
+They don't have any built-in meaning, but they're very useful nonetheless: you
+can associate your own custom configuration with them, or you can use them to
+easily filter tests so you only run the ones you need to.
+
+Tags are defined using the `@Tags` annotation for suites and the `tags` named
+parameter to `test()` and `group()`. For example:
+
+```dart
+@Tags(['browser'])
+
+import 'package:test/test.dart';
+
+void main() {
+ test('successfully launches Chrome', () {
+ // ...
+ }, tags: 'chrome');
+
+ test('launches two browsers at once', () {
+ // ...
+ }, tags: ['chrome', 'firefox']);
+}
+```
+
+If the test runner encounters a tag that wasn't declared in the
+[package configuration file][configuring tags], it'll print a warning, so be
+sure to include all your tags there. You can also use the file to provide
+default configuration for tags, like giving all `browser` tests twice as much
+time before they time out.
+
+[configuring tags]: https://github.com/dart-lang/test/blob/master/pkgs/test/doc/configuration.md#configuring-tags
+
+Tests can be filtered based on their tags by passing command line flags. The
+`--tags` or `-t` flag will cause the test runner to only run tests with the
+given tags, and the `--exclude-tags` or `-x` flag will cause it to only run
+tests *without* the given tags. These flags also support
+[boolean selector syntax]. For example, you can pass `--tags "(chrome ||
+firefox) && !slow"` to select quick Chrome or Firefox tests.
+
+Note that tags must be valid Dart identifiers, although they may also contain
+hyphens.
+
+### Whole-Package Configuration
+
+For configuration that applies across multiple files, or even the entire
+package, `test` supports a configuration file called `dart_test.yaml`. At its
+simplest, this file can contain the same sort of configuration that can be
+passed as command-line arguments:
+
+```yaml
+# This package's tests are very slow. Double the default timeout.
+timeout: 2x
+
+# This is a browser-only package, so test on chrome by default.
+platforms: [chrome]
+```
+
+The configuration file sets new defaults. These defaults can still be overridden
+by command-line arguments, just like the built-in defaults. In the example
+above, you could pass `--platform firefox` to run on Firefox.
+
+A configuration file can do much more than just set global defaults. See
+[the full documentation][package config] for more details.
+
+[package config]: https://github.com/dart-lang/test/blob/master/pkgs/test/doc/configuration.md
+
+### Compiler flags
+
+The test runner does not support general purpose flags to control compilation
+such as `-D` defines or flags like `--no-sound-null-safety`. In most cases it is
+preferable to avoid writing tests that depend on the fine-grained compiler
+configuration. For instance to choose between sound and unsound null safety,
+prefer to choose a language version for each test which has the desired behavior
+by default - choose a language version below `2.12` to disable sound null
+safety, and a language version above `2.12` to enable sound null safety. When
+fine-grained configuration is unavoidable, the approach varies by platform.
+
+Compilation for browser and node tests can be configured by passing arguments to
+`dart compile js` with `--dart2js-args` options.
+
+Fine-grained compilation configuration is not supported for the VM. Any
+configuration which impacts runtime behavior for the entire VM, such as `-D`
+defines (when used for non-const values) and runtime behavior experiments, will
+influence both the test runner and the isolates spawned to run test suites.
+Experiments which are breaking may cause incompatibilities with the test runner.
+These may be specified with a `DART_VM_OPTIONS` environment variable when
+running with `pub run test`, or by passing them to the `dart` command before the
+`test` subcommand when using `dart test`.
+
+## Debugging
+
+Tests can be debugged interactively using platforms' built-in development tools.
+Tests running on browsers can use those browsers' development consoles to inspect
+the document, set breakpoints, and step through code. Those running on the Dart
+VM use [Dart DevTools][devtools].
+
+[devtools]: https://dart.dev/tools/dart-devtools
+
+The first step when debugging is to pass the `--pause-after-load` flag to the
+test runner. This pauses the browser after each test suite has loaded, so that
+you have time to open the development tools and set breakpoints. For the Dart VM
+it will print the remote debugger URL.
+
+Once you've set breakpoints, either click the big arrow in the middle of the web
+page or press Enter in your terminal to start the tests running. When you hit a
+breakpoint, the runner will open its own debugging console in the terminal that
+controls how tests are run. You can type "restart" there to re-run your test as
+many times as you need to figure out what's going on.
+
+Normally, browser tests are run in hidden iframes. However, when debugging, the
+iframe for the current test suite is expanded to fill the browser window so you
+can see and interact with any HTML it renders. Note that the Dart animation may
+still be visible behind the iframe; to hide it, just add a `background-color` to
+the page's HTML.
+
+## Browser/VM Hybrid Tests
+
+Code that's written for the browser often needs to talk to some kind of server.
+Maybe you're testing the HTML served by your app, or maybe you're writing a
+library that communicates over WebSockets. We call tests that run code on both
+the browser and the VM **hybrid tests**.
+
+Hybrid tests use one of two functions: [`spawnHybridCode()`] and
+[`spawnHybridUri()`]. Both of these spawn Dart VM
+[isolates][dart:isolate] that can import `dart:io` and other VM-only libraries.
+The only difference is where the code from the isolate comes from:
+`spawnHybridCode()` takes a chunk of actual Dart code, whereas
+`spawnHybridUri()` takes a URL. They both return a [`StreamChannel`] that
+communicates with the hybrid isolate. For example:
+
+[`spawnHybridCode()`]: https://pub.dev/documentation/test/latest/test/spawnHybridCode.html
+
+[`spawnHybridUri()`]: https://pub.dev/documentation/test/latest/test/spawnHybridUri.html
+
+[dart:isolate]: https://api.dart.dev/stable/dart-isolate/dart-isolate-library.html
+
+[`StreamChannel`]: https://pub.dev/documentation/stream_channel/latest/stream_channel/StreamChannel-class.html
+
+```dart
+// ## test/web_socket_server.dart
+
+// The library loaded by spawnHybridUri() can import any packages that your
+// package depends on, including those that only work on the VM.
+import 'package:shelf/shelf_io.dart' as io;
+import 'package:shelf_web_socket/shelf_web_socket.dart';
+import 'package:stream_channel/stream_channel.dart';
+
+// Once the hybrid isolate starts, it will call the special function
+// hybridMain() with a StreamChannel that's connected to the channel
+// returned spawnHybridCode().
+hybridMain(StreamChannel channel) async {
+ // Start a WebSocket server that just sends "hello!" to its clients.
+ var server = await io.serve(webSocketHandler((webSocket, _) {
+ webSocket.sink.add('hello!');
+ }), 'localhost', 0);
+
+ // Send the port number of the WebSocket server to the browser test, so
+ // it knows what to connect to.
+ channel.sink.add(server.port);
+}
+
+
+// ## test/web_socket_test.dart
+
+@TestOn('browser')
+
+import 'dart:html';
+
+import 'package:test/test.dart';
+
+void main() {
+ test('connects to a server-side WebSocket', () async {
+ // Each spawnHybrid function returns a StreamChannel that communicates with
+ // the hybrid isolate. You can close this channel to kill the isolate.
+ var channel = spawnHybridUri('web_socket_server.dart');
+
+ // Get the port for the WebSocket server from the hybrid isolate.
+ var port = await channel.stream.first;
+
+ var socket = WebSocket('ws://localhost:$port');
+ var message = await socket.onMessage.first;
+ expect(message.data, equals('hello!'));
+ });
+}
+```
+
+
+
+**Note**: If you write hybrid tests, be sure to add a dependency on the
+`stream_channel` package, since you're using its API!
+
+## Support for Other Packages
+
+### `build_runner`
+
+If you are using `package:build_runner` to build your package, then you will
+need a dependency on `build_test` in your `dev_dependencies`, and then you can
+use the `pub run build_runner test` command to run tests.
+
+To supply arguments to `package:test`, you need to separate them from your build
+args with a `--` argument. For example, running all web tests in release mode
+would look like this `pub run build_runner test --release -- -p vm`.
+
+### `term_glyph`
+
+The [`term_glyph`] package provides getters for Unicode glyphs with
+ASCII alternatives. `test` ensures that it's configured to produce ASCII when
+the user is running on Windows, where Unicode isn't supported. This ensures that
+testing libraries can use Unicode on POSIX operating systems without breaking
+Windows users.
+
+[`term_glyph`]: https://pub.dev/packages/term_glyph
+
+## Further Reading
+
+Check out the [API docs] for detailed information about all the functions
+available to tests.
+
+[API docs]: https://pub.dev/documentation/test/latest/
+
+The test runner also supports a machine-readable JSON-based reporter. This
+reporter allows the test runner to be wrapped and its progress presented in
+custom ways (for example, in an IDE). See [the protocol documentation][json] for
+more details.
+
+[json]: https://github.com/dart-lang/test/blob/master/pkgs/test/doc/json_reporter.md
diff --git a/pkgs/test/bin/test.dart b/pkgs/test/bin/test.dart
new file mode 100644
index 0000000..0b40282
--- /dev/null
+++ b/pkgs/test/bin/test.dart
@@ -0,0 +1,5 @@
+// Copyright (c) 2015, 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.
+
+export 'package:test/src/executable.dart';
diff --git a/pkgs/test/dart_test.yaml b/pkgs/test/dart_test.yaml
new file mode 100644
index 0000000..49af036
--- /dev/null
+++ b/pkgs/test/dart_test.yaml
@@ -0,0 +1,55 @@
+# Disallow duplicate test names in this package
+allow_duplicate_test_names: false
+
+# Fold frames from helper packages we use in our tests, but not from test
+# itself.
+fold_stack_frames:
+ except:
+ - shelf_test_handler
+ - stream_channel
+ - test_descriptor
+ - test_process
+
+presets:
+ # "-P terse-trace" folds frames from test's implementation to make the output
+ # less verbose when
+ terse-trace:
+ fold_stack_frames:
+ except: [test]
+
+tags:
+ browser:
+ timeout: 2x
+
+ # Browsers can sometimes randomly time out while starting, especially on
+ # Travis which is pretty slow. Don't retry locally because it makes
+ # debugging more annoying.
+ presets: {travis: {retry: 3}}
+
+ dart2js:
+ add_tags: [browser]
+ timeout: 2x
+
+ firefox:
+ add_tags: [dart2js]
+ test_on: linux
+ chrome: {add_tags: [dart2js]}
+
+ safari:
+ add_tags: [dart2js]
+ test_on: mac-os
+
+ edge:
+ add_tags: [dart2js]
+ test_on: windows
+
+ # Tests that run pub. These tests may need to be excluded when there are local
+ # dependency_overrides.
+ pub:
+ timeout: 2x
+
+ # Tests that use Node.js. These tests may need to be excluded on systems that
+ # don't have Node installed.
+ node:
+ timeout: 2x
+ test_on: linux
diff --git a/pkgs/test/doc/architecture.md b/pkgs/test/doc/architecture.md
new file mode 100644
index 0000000..c378e0c
--- /dev/null
+++ b/pkgs/test/doc/architecture.md
@@ -0,0 +1,236 @@
+# Test Package Architecture
+
+* [Code Organization](#code-organization)
+ * [Frontend](#frontend)
+ * [Backend](#backend)
+ * [Runner](#runner)
+* [Lifecycle of a Test Run](#lifecycle-of-a-test-run)
+ * [Loading a Suite on the VM](#loading-a-suite-on-the-vm)
+ * [Loading a Suite in the Browser](#loading-a-suite-in-the-browser)
+
+## Code Organization
+
+From a user's perspective, the test package provides two main pieces of
+functionality: an API for defining tests, and a command-line tool to run those
+tests. The structure of the package reflects this division. The code is divided
+into three main sections: the frontend, the backend, and the runner.
+
+### Frontend
+
+The [`lib/src/frontend`][frontend] directory contains APIs that are exposed to
+the user when they import `package:test/test.dart`. This includes core functions
+such as `expect()` and `expectAsync()`, test-specific matchers such as
+`throwsA()` and `prints()`, and annotation classes such as `TestOn` and
+`Timeout`. The functions that define the top-level structure of the test, such
+as `test()` and `group()`, are defined in `lib/test.dart`, but they can be
+thought of as frontend functions as well.
+
+[frontend]: https://github.com/dart-lang/test/tree/master/lib/src/frontend
+
+The frontend communicates with the backend using zone-scoped getters.
+[`Invoker.current`][Invoker] provides access to the current test case to
+matchers like [`completion()`][completion], for example to control when
+it completes. Structural functions use [`Declarer.current`][Declarer] to
+gradually build up an in-memory representation of a test suite. The runner is in
+charge of setting up these variables, but the frontend never communicates with
+the runner directly.
+
+[Invoker]: https://github.com/dart-lang/test/blob/master/lib/src/backend/invoker.dart
+[completion]: https://pub.dev/documentation/matcher/latest/expect/completion.html
+[Declarer]: https://github.com/dart-lang/test/blob/master/lib/src/backend/declarer.dart
+
+### Backend
+
+The [`lib/src/backend`][backend] directory contains classes that represent the
+in-memory structure of a test suite. A [`Suite`][Suite] represents a single test
+file, and class contains a tree of [`Group`][Group]s, each of which contains
+many [`Test`][Test]s. These classes are built using a [`Declarer`][Declarer].
+
+[backend]: https://github.com/dart-lang/test/tree/master/lib/src/backend
+[Suite]: https://github.com/dart-lang/test/blob/master/lib/src/backend/suite.dart
+[Group]: https://github.com/dart-lang/test/blob/master/lib/src/backend/group.dart
+[Test]: https://github.com/dart-lang/test/blob/master/lib/src/backend/test.dart
+
+The backend also contains the [`Invoker`][Invoker], which is responsible for
+actually running an individual test case—including tracking how many outstanding
+asynchronous callbacks are pending, handling exceptions, and timing out the test
+if it takes too long. The `Invoker` provides information about the status of a
+running test as streams and futures on a [`LiveTest`][LiveTest] object.
+
+[LiveTest]: https://github.com/dart-lang/test/blob/master/lib/src/backend/live_test.dart
+
+The backend provides a bridge between the frontend and the runner. The runner
+sets up the `Declarer` and starts the `Invoker`, which the frontend functions
+then communicate with directly.
+
+### Runner
+
+The [`lib/src/runner`][runner] directory contains the code that's executed when
+`dart test` is invoked. It's in charge of locating test files, loading them,
+executing them, and communicating their results to the user. It's also by far
+the biggest section. For more information on the runner architecture, see
+[Lifecycle of a Test Run](#lifecycle-of-a-test-suite) below.
+
+[runner]: https://github.com/dart-lang/test/tree/master/lib/src/runner
+
+## Lifecycle of a Test Run
+
+To understand generally how the test runner works, let's look at an example run.
+When the user first invokes `dart test`, the command-line arguments and
+[configuration files][] are combined into a single
+[`Configuration`][Configuration] object which is passed into the
+[`Runner`][Runner] class. The `Runner` is mostly just glue: it starts up the
+various components necessary for a test run, and connects them to one another.
+It's also in charge of handling certain `Configuration` flags.
+
+[configuration files]: https://github.com/dart-lang/test/blob/master/doc/configuration.md
+[Configuration]: https://github.com/dart-lang/test/tree/master/lib/src/runner/configuration.dart
+[Runner]: https://github.com/dart-lang/test/tree/master/lib/src/runner.dart
+
+The first thing the runner starts is the [`Engine`][Engine]. The engine iterates
+through a test suite's tests and invokes them in order. It knows how to handle
+set-up and tear-down functions, and how to combine the output of multiple test
+suites running concurrently. It exposes its progress through a collection of
+getters and streams that provide access to individual [`LiveTest`][LiveTest]s.
+
+[Engine]: https://github.com/dart-lang/test/tree/master/lib/src/runner/engine.dart
+
+The runner then passes the `Engine` to a [`Reporter`][Reporter], which listens
+to the `Engine`'s streams and exposes the information there to the user, usually
+by printing human-readable text. [`CompactReporter`][CompactReporter] is the
+default on Posix platforms, but others may be selected based on the
+`Configuration`. Nearly everything the user sees comes through the reporter.
+
+[Reporter]: https://github.com/dart-lang/test/tree/master/lib/src/runner/reporter.dart
+[CompactReporter]: https://github.com/dart-lang/test/tree/master/lib/src/runner/reporter/compact.dart
+
+The `Engine` and `Reporter` can't do much of anything, though, without any test
+suites to run. The next step is to load those suites. The [`Loader`][Loader] is
+in charge of this part. It takes in file or directory paths and finds all the
+test files they contain—by default any files matching `*_test.dart`. It then
+proceeds to load each file on all the platforms specified in the `Configuration`
+that's also supported by the test suite.
+
+[Loader]: https://github.com/dart-lang/test/tree/master/lib/src/runner/loader.dart
+
+The specifics of loading suites differs based on whether the platform is a
+browser or the Dart VM. I'll cover each platform below, but for now let's stick
+to what they have in common. Every platform will emit a
+[`LoadSuite`][LoadSuite], which is a synthetic [`Suite`][Suite] containing a
+single test that, when invoked, produces the actual `Suite` defined in the test
+file.
+
+[LoadSuite]: https://github.com/dart-lang/test/tree/master/lib/src/runner/load_suite.dart
+
+Wrapping the loading process in a synthetic `Suite` gives us the very useful
+invariant that *all test errors occur within a `Suite`*. Loading can fail in all
+sorts of ways—the code might not compile, the `main()` method might throw, the
+browser might not be installed, and so on. Locating those errors within a
+`Suite` means that the `Engine` and `Reporter`, which already know how to deal
+with test errors, can deal with load errors in exactly the same way. It makes
+the load process a little more complex, but it makes everything else a lot
+cleaner.
+
+Once a `Suite` has been loaded, the runner does a little post-processing to make
+sure the `Configuration` is handled properly. It filters out tests whose tags
+don't match the `--tags` flag, or whose names don't match the `--name` flag.
+Then it passes the resulting `Suite`s on to the `Engine` and they begin to run.
+
+### Loading a Suite on the VM
+
+Let's start with looking at how suites are loaded on the Dart VM, since the
+process is substantially simpler than loading them on a browser. This loading is
+handled by the [`VMPlatform`][VMPlatform], which extends the
+[`PlatformPlugin`][PlatformPlugin] class. [Eventually][issue 49], we plan to
+support a user-accessible platform plugin API, so we model platforms as plugins
+to prepare for that.
+
+[VMPlatform]: https://github.com/dart-lang/test/tree/master/lib/src/runner/vm/platform.dart
+[PlatformPlugin]: https://github.com/dart-lang/test/tree/master/lib/src/runner/plugin/platform.dart
+[issue 49]: https://github.com/dart-lang/test/issues/49
+
+In its simplest form, a `PlatformPlugin`'s responsibility is just to create a
+[`StreamChannel`][StreamChannel] that connects the test runner to a remote
+isolate—everything else is handled by helper functions. The `VMPlatform` uses
+[`Isolate`][Isolate]s to dynamically load its test suites, and then communicates
+with them using an [`IsolateChannel`][IsolateChannel]. It passes in a `data:`
+URI containing Dart code that imports the user's code, and runs that code in the
+context of the [`serializeSuite()`][remote platform helpers] helper, and the
+`PlatformPlugin` superclass deserializes it on the other side using
+[`deserializeSuite()`][platform helpers].
+
+[StreamChannel]: https://pub.dev/packages/stream_channel
+[Isolate]: https://api.dart.dev/stable/dart-isolate/Isolate-class.html
+[IsolateChannel]: https://pub.dev/documentation/stream_channel/latest/stream_channel/IsolateChannel-class.html
+[remote platform helpers]: https://github.com/dart-lang/test/tree/master/lib/src/runner/plugin/remote_platform_helpers.dart
+[platform helpers]: https://github.com/dart-lang/test/tree/master/lib/src/runner/plugin/platform_helpers.dart
+
+When a test suite is serialized and deserialized, it's not just converted to and
+from some static representation like JSON. The [`Engine`][Engine] needs
+fine-grained control over the remote suite, and the [`Reporter`][Reporter] needs
+fine-grained access to the [`LiveTest`][LiveTest]s it emits. To make this work,
+the helper functions use the [`MultiChannel`][MultiChannel] class to tunnel
+streams for each test through the main `IsolateChannel`. Each test has its own
+virtual channel that gets a message when the test runner calls
+[`Test.load()`][Test], and that sends messages back to indicate the progress of
+the test.
+
+Information about these virtual channels, as well as test names and metadata,
+are bundled up into a JSON object and sent over the `IsolateChannel` to be
+deserialized. The deserialization process then converts them into
+[`RunnerTest`][RunnerTest]s within a [`RunnerSuite`][RunnerSuite], which the
+`Engine` can then run just like normal `Test`s in a normal [`Suite`][Suite].
+
+[MultiChannel]: https://pub.dev/documentation/stream_channel/latest/stream_channel/MultiChannel-class.html
+[RunnerTest]: https://github.com/dart-lang/test/tree/master/lib/src/runner/runner_test.dart
+[RunnerSuite]: https://github.com/dart-lang/test/tree/master/lib/src/runner/runner_suite.dart
+
+### Loading a Suite in the Browser
+
+The [`BrowserPlatform`][BrowserPlatform] class also extends
+[`PlatformPlugin`][PlatformPlugin], but rather than just emitting a
+[`StreamChannel`][StreamChannel] and letting the plugin helpers do the rest, it
+takes more control over the loading process. It emits its own
+[`RunnerSuite`][RunnerSuite], which allows it to expose its own
+[`Environment`][Environment] to enable debugging.
+
+[BrowserPlatform]: https://github.com/dart-lang/test/tree/master/lib/src/runner/browser/platform.dart
+[Environment]: https://github.com/dart-lang/test/tree/master/lib/src/runner/environment.dart
+
+Whereas the [`VMPlatform`][VMPlatform] loads each separate suite in isolation,
+the `BrowserPlatform` shares a substantial amount of resources between suites.
+All suites load their code from a single HTTP server, which is managed by the
+platform. This server provides access to compiled JavaScript for other browsers,
+and to HTML files that bootstrap the tests.
+
+In addition to sharing a server, when multiple suites are loaded for the same
+browser, they all share a tab within that browser. Each separate browser is
+controlled by its own [`BrowserManager`][BrowserManager], which uses
+`WebSocket`s to communicate with Dart code running in the main frame—also known
+as [the host][host].
+
+[BrowserManager]: https://github.com/dart-lang/test/tree/master/lib/src/runner/browser/browser_manager.dart
+[host]: https://github.com/dart-lang/test/tree/master/lib/src/runner/browser/static/host.dart
+
+Each browser is spawned with a tab pointing to
+`packages/test/src/runner/browser/static/index.html`, the host page. The host's
+code then opens a `WebSocket` connection to a dynamically-generated URL. This
+URL tells the `BrowserPlatform` which `BrowserManager` to send the `WebSocket`
+to.
+
+To load a suite for this browser, the `BrowserPlatform` passes the URL for that
+suite's HTML file to the `BrowserManager`, which in turn sends it down to the
+host page. The host opens this HTML in an iframe, opens a
+[`StreamChannel`][StreamChannel] with this iframe using
+[`Window.postMessage()`][Window.postMessage]. It then tunnels this channel
+through the `WebSocket` connection, again using [`MultiChannel`][MultiChannel],
+so that the `BrowserManager` has a direct line to the iframe where the tests are
+defined.
+
+[Window.postMessage]: https://api.dart.dev/stable/dart-html/Window/postMessage.html
+
+From this point forward the process is similar to `VMPlatform`. The iframe
+serializes its test suite using [`serializeSuite()`][remote platform helpers],
+and the `BrowserManager` deserializes it using
+[`deserializeSuite()`][platform helpers]. It's then forwarded to the `Loader`
+via the `BrowserPlatform`.
diff --git a/pkgs/test/doc/configuration.md b/pkgs/test/doc/configuration.md
new file mode 100644
index 0000000..6541b97
--- /dev/null
+++ b/pkgs/test/doc/configuration.md
@@ -0,0 +1,890 @@
+Each package may include a configuration file that applies to the package as a
+whole. This file can be used to provide custom defaults for various options, to
+define configuration for multiple files, and more.
+
+The file is named `dart_test.yaml` and lives at the root of the package, next to
+the package's pubspec. Like the pubspec, it's a [YAML][] file. Here's an
+example:
+
+[YAML]: http://yaml.org/
+
+```yaml
+# This package's tests are very slow. Double the default timeout.
+timeout: 2x
+
+# This is a browser-only package, so test on chrome by default.
+platforms: [chrome]
+
+tags:
+ # Integration tests are even slower, so increase the timeout again.
+ integration: {timeout: 2x}
+
+ # Sanity tests are quick and verify that nothing is obviously wrong. Declaring
+ # the tag allows us to tag tests with it without getting warnings.
+ sanity:
+```
+
+* [Test Configuration](#test-configuration)
+ * [`timeout`](#timeout)
+ * [`ignore-timeouts`](#ignore-timeouts)
+ * [`verbose_trace`](#verbose_trace)
+ * [`chain_stack_traces`](#chain_stack_traces)
+ * [`js_trace`](#js_trace)
+ * [`skip`](#skip)
+ * [`retry`](#retry)
+ * [`test_on`](#test_on)
+ * [`allow_test_randomization`](#allow_test_randomization)
+ * [`allow_duplicate_test_names`](#allow_duplicate_test_names)
+* [Runner Configuration](#runner-configuration)
+ * [`include`](#include)
+ * [`paths`](#paths)
+ * [`filename`](#filename)
+ * [`names`](#names)
+ * [`plain_names`](#plain_names)
+ * [`include_tags`](#include_tags)
+ * [`exclude_tags`](#exclude_tags)
+ * [`platforms`](#platforms)
+ * [`concurrency`](#concurrency)
+ * [`pause_after_load`](#pause_after_load)
+ * [`run_skipped`](#run_skipped)
+ * [`reporter`](#reporter)
+ * [`file_reporters`](#file_reporters)
+ * [`fold_stack_frames`](#fold_stack_frames)
+ * [`custom_html_template_path`](#custom_html_template_path)
+* [Configuring Tags](#configuring-tags)
+ * [`tags`](#tags)
+ * [`add_tags`](#add_tags)
+* [Configuring Platforms](#configuring-platforms)
+ * [`on_os`](#on_os)
+ * [`on_platform`](#on_platform)
+ * [`override_platforms`](#override_platforms)
+ * [`define_platforms`](#define_platforms)
+ * [Browser and Node.js Settings](#browser-and-nodejs-settings)
+ * [`arguments`](#arguments)
+ * [`executable`](#executable)
+ * [`headless`](#headless)
+* [Configuration Presets](#configuration-presets)
+ * [`presets`](#presets)
+ * [`add_presets`](#add_presets)
+* [Global Configuration](#global-configuration)
+
+## Test Configuration
+
+There are two major categories of configuration field: "test" and "runner". Test
+configuration controls how individual tests run, while
+[runner configuration](#runner-configuration) controls the test runner as a
+whole. Both types of fields may be used at the top level of a configuration
+file. However, because different tests can have different test configuration,
+only test configuration fields may be used to [configure tags](#tags) or
+[platforms](#on_platform).
+
+### `timeout`
+
+This field indicates how much time the test runner should allow a test to remain
+inactive before it considers that test to have failed. It has three possible
+formats:
+
+* The string "none" indicates that tests should never time out.
+
+* A number followed by a unit abbreviation indicates an exact time. For example,
+ "1m" means a timeout of one minute, and "30s" means a timeout of thirty
+ seconds. Multiple numbers can be combined, as in "1m 30s".
+
+* A number followed by "x" indicates a multiple. This is applied to the default
+ value of 30s.
+
+```yaml
+timeout: 1m
+```
+
+### `ignore-timeouts`
+
+This field disables all timeouts for all tests. This can be useful when debugging, so tests don't time out during debug sessions. It defaults to `false`.
+
+```yaml
+ignore-timeouts: true
+```
+
+### `verbose_trace`
+
+This boolean field controls whether or not stack traces caused by errors are
+trimmed to remove internal stack frames. This includes frames from the Dart core
+libraries, the [`stack_trace`][stack_trace] package, and the `test` package
+itself. It defaults to `false`.
+
+[stack_trace]: https://pub.dev/packages/stack_trace
+
+```yaml
+verbose_trace: true
+```
+
+### `chain_stack_traces`
+
+This boolean field controls whether or not stack traces are chained.
+Disabling [`stack trace chaining`][stack trace chaining] will improve
+performance for heavily asynchronous code at the cost of debuggability.
+
+[stack trace chaining]: https://github.com/dart-lang/stack_trace/blob/master/README.md#stack-chains
+
+```yaml
+chain_stack_traces: false
+```
+
+### `js_trace`
+
+This boolean field controls whether or not stack traces caused by errors that
+occur while running Dart compiled to JS are converted back to Dart style. This
+conversion uses the source map generated by `dart2js` to approximate the
+original Dart line, column, and in some cases member name for each stack frame.
+It defaults to `false`.
+
+```yaml
+js_trace: true
+```
+
+### `skip`
+
+This field controls whether or not tests are skipped. It's usually applied to
+[specific tags](#configuring-tags) rather than used at the top level. Like the
+`skip` parameter for [`test()`][test], it can either be a boolean indicating
+whether the tests are skipped or a string indicating the reason they're skipped.
+
+[test]: https://pub.dev/documentation/test/latest/test/test.html
+
+```yaml
+tags:
+ chrome:
+ skip: "Our Chrome launcher is busted. See issue 1234."
+```
+
+This field is not supported in the
+[global configuration file](#global-configuration).
+
+### `retry`
+
+This int field controls how many times a test is retried upon failure.
+
+```yaml
+tags:
+ chrome:
+ retry: 3 # Retry chrome failures 3 times.
+```
+
+This field is not supported in the
+[global configuration file](#global-configuration).
+
+### `test_on`
+
+This field declares which platforms a test supports. It takes a
+[platform selector][platform selectors] and only allows tests to run on
+platforms that match the selector. It's often used with
+[specific tags](#configuring-tags) to ensure that certain features will only be
+tested on supported platforms.
+
+[platform selectors]: https://github.com/dart-lang/test/tree/master/pkgs/test#platform-selectors
+
+```yaml
+tags:
+ # Test on browsers other than firefox
+ some_feature: {test_on: "browser && !firefox"}
+```
+
+The field can also be used at the top level of the configuration file to
+indicate that the entire package only supports a particular platform. If someone
+tries to run the tests on an unsupported platform, the runner will print a
+warning and skip that platform.
+
+```yaml
+# This package uses dart:io.
+test_on: vm
+```
+
+This field is not supported in the
+[global configuration file](#global-configuration).
+
+### `allow_test_randomization`
+
+This can be used to disable test randomization for certain tests, regardless
+of the `--test-randomize-ordering-seed` configuration.
+
+This is typically useful when a subset of your tests are order dependent, but
+you want to run the other ones with randomized ordering.
+
+```yaml
+tags:
+ doNotRandomize:
+ allow_test_randomization: false
+```
+
+### `allow_duplicate_test_names`
+
+This can be used to allow multiple tests in the same suite to have the same
+name. This is disabled by default because it is usually an indication of a
+mistake, and it causes problems with IDE integrations which run tests by name.
+
+It can be disabled for all tests:
+
+```yaml
+allow_duplicate_test_names: true
+```
+
+Or for tagged tests only (useful if migrating to enable this):
+
+```yaml
+tags:
+ allowDuplicates:
+ allow_duplicate_test_names: true
+```
+
+It cannot be globally enabled or configured on the command line - this would
+make it so that tests might pass on one users machine but not anothers which
+should be avoided.
+
+## Runner Configuration
+
+Unlike [test configuration](#test-configuration), runner configuration affects
+the test runner as a whole rather than individual tests. It can only be used at
+the top level of the configuration file.
+
+### `include`
+
+This field loads another configuration file. It's useful for repositories that
+contain multiple packages and want to share configuration among them. It takes a
+(usually relative) `file:` URL.
+
+If you have a repository with the following structure:
+
+```
+repo/
+ dart_test_base.yaml
+ package/
+ test/
+ dart_test.yaml
+ pubspec.yaml
+```
+
+```yaml
+# repo/dart_test_base.yaml
+filename: "test_*.dart"
+```
+
+```yaml
+# repo/package/dart_test.yaml
+include: ../dart_test_base.yaml
+```
+
+...tests in the `package` directory will use configuration from both
+`dart_test_base.yaml` and `dart_test.yaml`.
+
+The local configuration file's fields take precedence over those from an
+included file, so it's possible to override a base configuration.
+
+### `paths`
+
+This field indicates the default paths that the test runner should run. These
+paths are usually directories, although single filenames may be used as well.
+Paths must be relative, and they must be in URL format so that they're
+compatible across operating systems. This defaults to `[test]`.
+
+```yaml
+paths: [dart/test]
+
+paths:
+- test/instantaneous
+- test/fast
+- test/middling
+```
+
+This field is not supported in the
+[global configuration file](#global-configuration).
+
+### `filename`
+
+This field indicates the filename pattern that the test runner uses to find test
+files in directories. All files in directories passed on the command line (or in
+directories in [`paths`](#paths), if none are passed) whose basenames match this
+pattern will be loaded and run as tests.
+
+This supports the full [glob syntax][]. However, since it's only compared
+against a path's basename, path separators aren't especially useful. It defaults
+to `"*_test.dart"`.
+
+```yaml
+filename: "test_*.dart"
+```
+
+[glob syntax]: https://github.com/dart-lang/glob#syntax
+
+This field is not supported in the
+[global configuration file](#global-configuration).
+
+### `names`
+
+This field causes the runner to only run tests whose names match the given
+regular expressions. A test's name must match *all* regular expressions in
+`names`, as well as containing all strings in [`plain_names`](#plain_names), in
+order to be run.
+
+This is usually used in a [preset](#configuration-presets) to make it possible
+to quickly select a given set of tests.
+
+```yaml
+presets:
+ # Pass "-P chrome" to run only Chrome tests.
+ chrome:
+ names:
+ - "^browser:"
+ - "[Cc]hrome"
+```
+
+This field is not supported in the
+[global configuration file](#global-configuration).
+
+### `plain_names`
+
+This field causes the runner to only run tests whose names contain the given
+strings. A test's name must contain *all* strings in `plain_names`, as well as
+matching all regular expressions in [`names`](#names), in order to be run.
+
+This is usually used in a [preset](#configuration-presets) to make it possible
+to quickly select a given set of tests.
+
+```yaml
+presets:
+ # Pass "-P feature" to run only tests with "feature name" in the name.
+ feature:
+ plain_names:
+ - "feature name"
+```
+
+This field is not supported in the
+[global configuration file](#global-configuration).
+
+### `include_tags`
+
+This field causes the runner to only run tests whose tags match the given
+[boolean selector][]. If both `include_tags` and [`exclude_tags`](#exclude_tags)
+are used, the exclusions take precedence.
+
+[boolean selector]: https://github.com/dart-lang/boolean_selector/blob/master/README.md
+
+This is usually used in a [preset](#configuration-preset) to make it possible to
+quickly select a set of tests.
+
+```yaml
+presets:
+ # Pass "-P windowless" to run tests that don't open browser windows.
+ windowless:
+ include_tags: !browser || content-shell
+```
+
+This field is not supported in the
+[global configuration file](#global-configuration).
+
+### `exclude_tags`
+
+This field causes the runner not to run tests whose tags match the given
+[boolean selector][]. If both [`include_tags`](#include_tags) and `exclude_tags`
+are used, the exclusions take precedence.
+
+This is usually used in a [preset](#configuration-preset) to make it possible to
+quickly select a set of tests.
+
+```yaml
+presets:
+ # Pass "-P windowless" to run tests that don't open browser windows.
+ windowless:
+ exclude_tags: browser && !content-shell
+```
+
+This field is not supported in the
+[global configuration file](#global-configuration).
+
+### `platforms`
+
+This field indicates which platforms tests should run on by default. It allows
+the same platform identifiers that can be passed to `--platform`. If multiple
+platforms are included, the test runner will default to running tests on all of
+them. This defaults to `[vm]`.
+
+```yaml
+platforms: [chrome]
+
+platforms:
+- chrome
+- firefox
+```
+
+### `compilers`
+
+This field indicates which compilers tests should be compiled with by default.
+It allows the same compiler selectors that can be passed to `--compiler`. If
+a given platform has no supported compiler configured, it will use its default.
+
+```yaml
+compilers: [source]
+
+compilers:
+- source
+```
+
+### `concurrency`
+
+This field indicates the default number of test suites to run in parallel. More
+parallelism can improve the overall speed of running tests up to a point, but
+eventually it just adds more memory overhead without any performance gain. This
+defaults to approximately half the number of processors on the current machine.
+If it's set to 1, only one test suite will run at a time.
+
+```yaml
+concurrency: 3
+```
+
+### `pause_after_load`
+
+This field indicates that the test runner should pause for debugging after each
+test suite is loaded but before its tests are executed. If it's set,
+[`concurrency`](#concurrency) is automatically set to 1 and
+[`timeout`](#timeout) is automatically set to `none`.
+
+This is usually used in a [preset](#configuration-presets).
+
+```yaml
+presets:
+ # Pass "-P debug" to enable debugging configuration
+ debug:
+ pause_after_load: true
+ exclude_tags: undebuggable
+ reporter: expanded
+```
+
+### `run_skipped`
+
+This field indicates that the test runner should run tests even if they're
+marked as skipped.
+
+This is usually used in a [preset](#configuration-presets).
+
+```yaml
+presets:
+ # Pass "-P all" to run all tests
+ debug:
+ run_skipped: true
+ paths: ["test/", "extra_test/"]
+```
+
+### `reporter`
+
+This field indicates the default reporter to use. It may be set to "compact",
+"expanded", or "json" (although why anyone would want to default to JSON is
+beyond me). It defaults to "expanded" on Windows and "compact" everywhere else.
+
+```yaml
+reporter: expanded
+```
+
+This field is not supported in the
+[global configuration file](#global-configuration).
+
+### `file_reporters`
+
+This field specifies additional reporters to use that will write their output to
+a file rather than stdout. It should be a map of reporter names to filepaths.
+
+```yaml
+file_reporters:
+ json: reports/tests.json
+```
+
+This field is not supported in the
+[global configuration file](#global-configuration).
+
+### `fold_stack_frames`
+
+This field controls which packages' stack frames will be folded away
+when displaying stack traces. Packages contained in the `except`
+option will be folded. If `only` is provided, all packages not
+contained in this list will be folded. By default,
+frames from the `test` package and the `stream_channel`
+package are folded.
+
+```yaml
+fold_stack_frames:
+ except:
+ - test
+ - stream_channel
+```
+
+Sample stack trace, note the absence of `package:test`
+and `package:stream_channel`:
+```
+test/sample_test.dart 7:5 main.<fn>
+===== asynchronous gap ===========================
+dart:async _Completer.completeError
+test/sample_test.dart 8:3 main.<fn>
+===== asynchronous gap ===========================
+dart:async _asyncThenWrapperHelper
+test/sample_test.dart 5:27 main.<fn>
+```
+
+### `custom_html_template_path`
+
+This field specifies the path of the HTML template file to be used for tests run in an HTML environment.
+Any HTML file that is named the same as the test and in the same directory will take precedence over the template.
+For more information about the usage of this option see [Providing a custom HTML template](https://github.com/dart-lang/test/blob/master/README.md#providing-a-custom-html-template)
+
+## Configuring Tags
+
+### `tags`
+
+The `tag` field can be used to apply [test configuration](#test-configuration)
+to all tests [with a given tag][tagging tests] or set of tags. It takes a map
+from tag selectors to configuration maps. These configuration maps are just like
+the top level of the configuration file, except that they may not contain
+[runner configuration](#runner-configuration).
+
+[tagging tests]: https://github.com/dart-lang/test/blob/master/README.md#tagging-tests
+
+```yaml
+tags:
+ # Integration tests need more time to run.
+ integration:
+ timeout: 1m
+```
+
+Tags may also have no configuration associated with them. The test runner prints
+a warning whenever it encounters a tag it doesn't recognize, and this the best
+way to tell it that a tag exists.
+
+```yaml
+# We occasionally want to use --tags or --exclude-tags on these tags.
+tags:
+ # A test that spawns a browser.
+ browser:
+
+ # A test that needs Ruby installed.
+ ruby:
+```
+
+You can also use [boolean selector syntax][] to define configuration that
+involves multiple tags. For example:
+
+[boolean selector syntax]: https://github.com/dart-lang/boolean_selector/blob/master/README.md
+
+```yaml
+tags:
+ # Tests that invoke sub-processes tend to be a little slower.
+ ruby || python:
+ timeout: 1.5x
+```
+
+Tag configuration is applied at whatever level the tag appears—so if a group is
+tagged as `integration`, its timeout will take precedence over the suite's
+timeout but not any tests'. If the group itself had a timeout declared, the
+group's explicit timeout would take precedence over the tag.
+
+If multiple tags appear at the same level, and they have conflicting
+configurations, the test runner *does not guarantee* what order they'll be
+resolved in. In practice, conflicting configuration is pretty unlikely and it's
+easy to just explicitly specify what you want on the test itself.
+
+This field counts as [test configuration](#test-configuration). It is not
+supported in the [global configuration file](#global-configuration).
+
+### `add_tags`
+
+This field adds additional tags. It's technically
+[test configuration](#test-configuration), but it's usually used in more
+specific contexts. For example, when included in a tag's configuration, it can
+be used to enable tag inheritance, where adding one tag implicitly adds another
+as well. It takes a list of tag name strings.
+
+```yaml
+tags:
+ # Any test that spawns a browser.
+ browser:
+ timeout: 2x
+
+ # Tests that spawn specific browsers. These automatically get the browser tag
+ # as well.
+ chrome: {add_tags: [browser]}
+ firefox: {add_tags: [browser]}
+ safari: {add_tags: [browser]}
+ edge: {add_tags: [browser]}
+```
+
+This field is not supported in the
+[global configuration file](#global-configuration).
+
+## Configuring Platforms
+
+There are two different kinds of platform configuration.
+[Operating system configuration](#on_os) cares about the operating system on
+which test runner is running. It sets global configuration for the runner on
+particular OSes. [Test platform configuration](#on_platform), on the other hand,
+cares about the platform the *test* is running on (like the
+[`@OnPlatform` annotation][@OnPlatform]). It sets configuration for particular
+tests that are running on matching platforms.
+
+[@OnPlatform]: https://github.com/dart-lang/test/tree/master/pkgs/test#platform-specific-configuration
+
+### `on_os`
+
+This field applies configuration when specific operating systems are being used.
+It takes a map from operating system identifiers (the same ones that are used in
+[platform selectors][]) to configuration maps that are applied on those
+operating systems. These configuration maps are just like the top level of the
+configuration file, and allow any fields that may be used in the context where
+`on_os` was used.
+
+```yaml
+on_os:
+ windows:
+ # Both of these are the defaults anyway, but let's be explicit about it.
+ color: false
+ runner: expanded
+
+ # My Windows machine is real slow.
+ timeout: 2x
+
+ # My Linux machine has SO MUCH RAM.
+ linux:
+ concurrency: 500
+```
+
+This field counts as [test configuration](#test-configuration). If it's used in
+a context that only allows test configuration, it may only contain test
+configuration.
+
+### `on_platform`
+
+This field applies configuration to tests that are run on specific platforms. It
+takes a map from [platform selectors][] to configuration maps that are applied
+to tests run on those platforms. These configuration maps are just like the top
+level of the configuration file, except that they may not contain
+[runner configuration](#runner-configuration).
+
+```yaml
+# Our code is kind of slow on Blink and WebKit.
+on_platform:
+ chrome || safari: {timeout: 2x}
+```
+
+**Note**: operating system names that appear in `on_platform` refer to tests
+that are run on the Dart VM under that operating system. To configure all tests
+when running on a particular operating system, use [`on_os`](#on_os) instead.
+
+This field counts as [test configuration](#test-configuration).
+
+### `override_platforms`
+
+This field allows you to customize the settings for built-in test platforms. It
+takes a map from platform identifiers to settings for those platforms. For example:
+
+```yaml
+override_platforms:
+ chrome:
+ # The settings to override for this platform.
+ settings:
+ executable: chromium
+```
+
+This tells the test runner to use the `chromium` executable for Chrome tests. It
+calls that executable with the same logic and flags it normally uses for Chrome.
+
+Each platform can define exactly which settings it supports. All browsers and
+Node.js support [the same settings](#browser-and-node-js-settings), but the VM
+doesn't support any settings and so can't be overridden.
+
+### `define_platforms`
+
+You can define new platforms in terms of old ones using the `define_platforms`
+field. This lets you define variants of existing platforms without overriding
+the old ones. This field takes a map from the new platform identifiers to
+definitions for those platforms. For example:
+
+```yaml
+define_platforms:
+ # This identifier is used to select the platform with the --platform flag.
+ chromium:
+ # A human-friendly name for the platform.
+ name: Chromium
+
+ # The identifier for the platform that this is based on.
+ extends: chrome
+
+ # Settings for the new child platform.
+ settings:
+ executable: chromium
+```
+
+Once this is defined, you can run `dart test -p chromium` and it will run
+those tests in the Chromium browser, using the same logic it normally uses for
+Chrome. You can even use `chromium` in platform selectors; for example, you
+might pass `testOn: "chromium"` to declare that a test is Chromium-specific.
+User-defined platforms also count as their parents, so Chromium will run tests
+that say `testOn: "chrome"` as well.
+
+Each platform can define exactly which settings it supports. All browsers and
+Node.js support [the same settings](#browser-and-node-js-settings), but the VM
+doesn't support any settings and so can't be extended.
+
+This field is not supported in the
+[global configuration file](#global-configuration).
+
+### Browser and Node.js Settings
+
+All built-in browser platforms, as well as the built-in Node.js platform,
+provide the same settings that can be set using
+[`define_platforms`](#define_platforms), which control how their executables are
+invoked.
+
+#### `arguments`
+
+The `arguments` field provides extra arguments to the executable. It takes a
+string, and parses it in the same way as the POSIX shell:
+
+```yaml
+override_platforms:
+ firefox:
+ settings:
+ arguments: -headless
+```
+
+#### `executable`
+
+The `executable` field tells the test runner where to look for the executable to
+use to start the subprocess. It has three sub-keys, one for each supported
+operating system, which each take a path or an executable name:
+
+```yaml
+define_platforms:
+ chromium:
+ name: Chromium
+ extends: chrome
+
+ settings:
+ executable:
+ linux: chromium
+ mac_os: /Applications/Chromium.app/Contents/MacOS/Chromium
+ windows: Chromium\Application\chrome.exe
+```
+
+Executables can be defined in three ways:
+
+* As a plain basename, with no path separators. These executables are passed
+ directly to the OS, which looks them up using the `PATH` environment variable.
+
+* As an absolute path, which is used as-is.
+
+* **Only on Windows**, as a relative path. The test runner will look up this
+ path relative to the `LOCALAPPATA`, `PROGRAMFILES`, and `PROGRAMFILES(X86)`
+ environment variables, in that order.
+
+If a platform is omitted, it defaults to using the built-in executable location.
+
+As a shorthand, you can also define the same executable for all operating
+systems:
+
+```yaml
+define_platforms:
+ chromium:
+ name: Chromium
+ extends: chrome
+
+ settings:
+ executable: chromium
+```
+
+#### `headless`
+
+The `headless` field says whether or not to run the browser in headless mode.
+It defaults to `true`. It's currently only supported for Chrome:
+
+```yaml
+override_platforms:
+ chrome:
+ settings:
+ headless: false
+```
+
+Note that headless mode is always disabled when debugging.
+
+## Configuration Presets
+
+*Presets* are collections of configuration that can be explicitly selected on
+the command-line. They're useful for quickly selecting options that are
+frequently used together, for providing special configuration for continuous
+integration systems, and for defining more complex logic than can be expressed
+directly using command-line arguments.
+
+Presets can be selected on the command line using the `--preset` or `-P` flag.
+Any number of presets can be selected this way; if they conflict, the last one
+selected wins. Only presets that are defined in the configuration file may be
+selected.
+
+### `presets`
+
+This field defines which presets are available to select. It takes a map from
+preset names to configuration maps that are applied when those presets are
+selected. These configuration maps are just like the top level of the
+configuration file, and allow any fields that may be used in the context where
+`presets` was used.
+
+```yaml
+presets:
+ # Use this when you need completely un-munged stack traces.
+ debug:
+ verbose_trace: false
+ js_trace: true
+
+ # Shortcut for running only browser tests.
+ browser:
+ paths:
+ - test/runner/browser
+```
+
+The `presets` field counts as [test configuration](#test-configuration). It can
+be useful to use it in combination with other fields for advanced preset
+behavior.
+
+```yaml
+tags:
+ chrome:
+ skip: "Our Chrome launcher is busted. See issue 1234."
+
+ # Pass -P force to verify that the launcher is still busted.
+ presets: {force: {skip: false}}
+```
+
+### `add_presets`
+
+This field selects additional presets. It's technically
+[runner configuration](#runner-configuration), but it's usually used in more
+specific contexts. For example, when included in a preset's configuration, it
+can be used to enable preset inheritance, where selecting one preset implicitly
+selects another as well. It takes a list of preset name strings.
+
+```yaml
+presets:
+ # Shortcut for running only browser tests.
+ browser:
+ paths: [test/runner/browser]
+
+ # Shortcut for running only Chrome tests.
+ chrome:
+ filename: "chrome_*_test.dart"
+ add_presets: [browser]
+```
+
+## Global Configuration
+
+The test runner also supports a global configuration file. On Windows, this
+file's local defaults to `%LOCALAPPDATA%\DartTest.yaml`. On Unix, it defaults to
+`~/.dart_test.yaml`. It can also be explicitly set using the `DART_TEST_CONFIG`
+environment variable.
+
+The global configuration file supports a subset of the fields supported by the
+package-specific configuration file. In general, it doesn't support fields that
+are closely tied to the structure of an individual package. Fields that are not
+supported in the global configuration file say so in their documentation.
diff --git a/pkgs/test/doc/json_reporter.md b/pkgs/test/doc/json_reporter.md
new file mode 100644
index 0000000..be18ddb
--- /dev/null
+++ b/pkgs/test/doc/json_reporter.md
@@ -0,0 +1,504 @@
+JSON Reporter Protocol
+======================
+
+The test runner supports a JSON reporter which provides a machine-readable
+representation of the test runner's progress. This reporter is intended for use
+by IDEs and other tools to present a custom view of the test runner's operation
+without needing to parse output intended for humans.
+
+Note that the test runner is highly asynchronous, and users of this protocol
+shouldn't make assumptions about the ordering of events beyond what's explicitly
+specified in this document. It's possible for events from multiple tests to be
+intertwined, for a single test to emit an error after it completed successfully,
+and so on.
+
+## Usage
+
+Pass the `--reporter json` command-line flag to the test runner to activate the
+JSON reporter.
+
+ dart test --reporter json <path-to-test-file>
+
+You may also use the `--file-reporter` option to enable the JSON reporter output
+to a file, in addition to another reporter writing to stdout.
+
+ dart test --file-reporter json:reports/tests.json <path-to-test-file>
+
+The JSON stream will be emitted via standard output. It will be a stream of JSON
+objects, separated by newlines.
+
+See `json_reporter.schema.json` for a formal description of the protocol schema.
+See `test/runner/json_reporter_test.dart` for some sample output.
+
+## Compatibility
+
+The protocol emitted by the JSON reporter is considered part of the public API
+of the `test` package, and is subject to its [semantic versioning][semver]
+restrictions. In particular:
+
+[semver]: https://dart.dev/tools/pub/versioning#semantic-versions
+
+* No new feature will be added to the protocol without increasing the test
+ package's minor version number.
+
+* No breaking change will be made to the protocol without increasing the test
+ package's major version number.
+
+The following changes are not considered breaking. This is not necessarily a
+comprehensive list.
+
+* Adding a new attribute to an existing object.
+
+* Adding a new type of any object with a `type` parameter.
+
+* Adding new test state values.
+
+## Reading this Document
+
+Each major type of JSON object used by the protocol is described by a class.
+Classes have names which are referred to in this document, but are not used as
+part of the protocol. Classes have typed attributes, which refer to the types
+and names of attributes in the JSON objects. If an attribute's type is another
+class, that refers to a nested object. The special type `List<...>` indicates a
+JSON list of the given type.
+
+Classes can "extend" one another, meaning that the subclass has all the
+attributes of the superclass. Concrete subclasses can be distinguished by the
+specific value of their `type` attribute. Classes may be abstract, indicating
+that only their subclasses will ever be used.
+
+## Events
+
+### Event
+
+```
+abstract class Event {
+ // The type of the event.
+ //
+ // This is always one of the subclass types listed below.
+ String type;
+
+ // The time (in milliseconds) that has elapsed since the test runner started.
+ int time;
+}
+```
+
+This is the root class of the protocol. All root-level objects emitted by the
+JSON reporter will be subclasses of `Event`.
+
+### StartEvent
+
+```
+class StartEvent extends Event {
+ String type = "start";
+
+ // The version of the JSON reporter protocol being used.
+ //
+ // This is a semantic version, but it reflects only the version of the
+ // protocol—it's not identical to the version of the test runner itself.
+ String protocolVersion;
+
+ // The version of the test runner being used.
+ //
+ // This is null if for some reason the version couldn't be loaded.
+ String? runnerVersion;
+
+ // The pid of the VM process running the tests.
+ int pid;
+}
+```
+
+A single start event is emitted before any other events. It indicates that the
+test runner has started running.
+
+### AllSuitesEvent
+
+```
+class AllSuitesEvent extends Event {
+ String type = "allSuites";
+
+ /// The total number of suites that will be loaded.
+ int count;
+}
+```
+
+A single suite count event is emitted once the test runner knows the total
+number of suites that will be loaded over the course of the test run. Because
+this is determined asynchronously, its position relative to other events (except
+`StartEvent`) is not guaranteed.
+
+### SuiteEvent
+
+```
+class SuiteEvent extends Event {
+ String type = "suite";
+
+ /// Metadata about the suite.
+ Suite suite;
+}
+```
+
+A suite event is emitted before any `GroupEvent`s for groups in a given test
+suite. This is the only event that contains the full metadata about a suite;
+future events will refer to the suite by its opaque ID.
+
+### DebugEvent
+
+```
+class DebugEvent extends Event {
+ String type = "debug";
+
+ /// The suite for which debug information is reported.
+ int suiteID;
+
+ /// The HTTP URL for the Dart Observatory, or `null` if the Observatory isn't
+ /// available for this suite.
+ String? observatory;
+
+ /// The HTTP URL for the remote debugger for this suite's host page, or `null`
+ /// if no remote debugger is available for this suite.
+ String? remoteDebugger;
+}
+```
+
+A debug event is emitted after (although not necessarily directly after) a
+`SuiteEvent`, and includes information about how to debug that suite. It's only
+emitted if the `--debug` flag is passed to the test runner.
+
+Note that the `remoteDebugger` URL refers to a remote debugger whose protocol
+may differ based on the browser the suite is running on. You can tell which
+protocol is in use by the `Suite.platform` field for the suite with the given
+ID. Since the same browser instance is used for multiple suites, different
+suites may have the same `host` URL, although only one suite at a time will be
+active when `--pause-after-load` is passed.
+
+### GroupEvent
+
+```
+class GroupEvent extends Event {
+ String type = "group";
+
+ /// Metadata about the group.
+ Group group;
+}
+```
+
+A group event is emitted before any `TestStartEvent`s for tests in a given
+group. This is the only event that contains the full metadata about a group;
+future events will refer to the group by its opaque ID.
+
+This includes the implicit group at the root of each suite, which has a `null`
+name. However, it does *not* include implicit groups for the virtual suites
+generated to represent loading test files.
+
+If the group is skipped, a single `TestStartEvent` will be emitted for a test
+within the group, followed by a `TestDoneEvent` marked as skipped. The
+`group.metadata` field should *not* be used for determining whether a group is
+skipped.
+
+### TestStartEvent
+
+```
+class TestStartEvent extends Event {
+ String type = "testStart";
+
+ // Metadata about the test that started.
+ Test test;
+}
+```
+
+An event emitted when a test begins running. This is the only event that
+contains the full metadata about a test; future events will refer to the test by
+its opaque ID.
+
+If the test is skipped, its `TestDoneEvent` will have `skipped` set to `true`.
+The `test.metadata` should *not* be used for determining whether a test is
+skipped.
+
+### MessageEvent
+
+```
+class MessageEvent extends Event {
+ String type = "print";
+
+ // The ID of the test that printed a message.
+ int testID;
+
+ // The type of message being printed.
+ String messageType;
+
+ // The message that was printed.
+ String message;
+}
+```
+
+A `MessageEvent` indicates that a test emitted a message that should be
+displayed to the user. The `messageType` field indicates the precise type of
+this message. Different message types should be visually distinguishable.
+
+A message of type "print" comes from a user explicitly calling `print()`.
+
+A message of type "skip" comes from a test, or a section of a test, being
+skipped. A skip message shouldn't be considered the authoritative source that a
+test was skipped; the `TestDoneEvent.skipped` field should be used instead.
+
+### ErrorEvent
+
+```
+class ErrorEvent extends Event {
+ String type = "error";
+
+ // The ID of the test that experienced the error.
+ int testID;
+
+ // The result of calling toString() on the error object.
+ String error;
+
+ // The error's stack trace, in the stack_trace package format.
+ String stackTrace;
+
+ // Whether the error was a TestFailure.
+ bool isFailure;
+}
+```
+
+A `ErrorEvent` indicates that a test encountered an uncaught error. Note
+that this may happen even after the test has completed, in which case it should
+be considered to have failed.
+
+If a test is asynchronous, it may encounter multiple errors, which will result
+in multiple `ErrorEvent`s.
+
+### TestDoneEvent
+
+```
+class TestDoneEvent extends Event {
+ String type = "testDone";
+
+ // The ID of the test that completed.
+ int testID;
+
+ // The result of the test.
+ String result;
+
+ // Whether the test's result should be hidden.
+ bool hidden;
+
+ // Whether the test (or some part of it) was skipped.
+ bool skipped;
+}
+```
+
+An event emitted when a test completes. The `result` attribute indicates the
+result of the test:
+
+* `"success"` if the test had no errors.
+
+* `"failure"` if the test had a `TestFailure` but no other errors.
+
+* `"error"` if the test had an error other than a `TestFailure`.
+
+If the test encountered an error, the `TestDoneEvent` will be emitted after the
+corresponding `ErrorEvent`.
+
+The `hidden` attribute indicates that the test's result should be hidden and not
+counted towards the total number of tests run for the suite. This is true for
+virtual tests created for loading test suites, `setUpAll()`, and
+`tearDownAll()`. Only successful tests will be hidden.
+
+Note that it's possible for a test to encounter an error after completing. In
+that case, it should be considered to have failed, but no additional
+`TestDoneEvent` will be emitted. If a previously-hidden test encounters an
+error after completing, it should be made visible.
+
+### DoneEvent
+
+```
+class DoneEvent extends Event {
+ String type = "done";
+
+ // Whether all tests succeeded (or were skipped).
+ //
+ // Will be `null` if the test runner was close before all tests completed
+ // running.
+ bool? success;
+}
+```
+
+An event indicating the result of the entire test run. This will be the final
+event emitted by the reporter.
+
+## Other Classes
+
+### Test
+
+```
+class Test {
+ // An opaque ID for the test.
+ int id;
+
+ // The name of the test, including prefixes from any containing groups.
+ String name;
+
+ // The ID of the suite containing this test.
+ int suiteID;
+
+ // The IDs of groups containing this test, in order from outermost to
+ // innermost.
+ List<int> groupIDs;
+
+ // The (1-based) line on which the test was defined, or `null`.
+ int? line;
+
+ // The (1-based) column on which the test was defined, or `null`.
+ int? column;
+
+ // The URL for the file in which the test was defined, or `null`.
+ String? url;
+
+ // The (1-based) line in the original test suite from which the test
+ // originated.
+ //
+ // Will only be present if `root_url` is different from `url`.
+ int? root_line;
+
+ // The (1-based) line on in the original test suite from which the test
+ // originated.
+ //
+ // Will only be present if `root_url` is different from `url`.
+ int? root_column;
+
+ // The URL for the original test suite in which the test was defined.
+ //
+ // Will only be present if different from `url`.
+ String? root_url;
+
+ // This field is deprecated and should not be used.
+ Metadata metadata;
+}
+```
+
+A single test case. The test's ID is unique in the context of this test run.
+It's used elsewhere in the protocol to refer to this test without including its
+full representation.
+
+Most tests will have at least one group ID, representing the implicit root
+group. However, some may not; these should be treated as having no group
+metadata.
+
+The `line`, `column`, and `url` fields indicate the location the `test()`
+function was called to create this test. They're treated as a unit: they'll
+either all be `null` or they'll all be non-`null`. The URL is always absolute,
+and may be a `package:` URL.
+
+### Suite
+
+```
+class Suite {
+ // An opaque ID for the group.
+ int id;
+
+ // The platform on which the suite is running.
+ String platform;
+
+ // The path to the suite's file, or `null` if that path is unknown.
+ String? path;
+}
+```
+
+A test suite corresponding to a loaded test file. The suite's ID is unique in
+the context of this test run. It's used elsewhere in the protocol to refer to
+this suite without including its full representation.
+
+A suite's platform is one of the platforms that can be passed to the
+`--platform` option, or `null` if there is no platform (for example if the file
+doesn't exist at all). Its path is either absolute or relative to the root of
+the current package.
+
+### Group
+
+```
+class Group {
+ // An opaque ID for the group.
+ int id;
+
+ // The name of the group, including prefixes from any containing groups.
+ String name;
+
+ // The ID of the suite containing this group.
+ int suiteID;
+
+ // The ID of the group's parent group, unless it's the root group.
+ int? parentID;
+
+ // The number of tests (recursively) within this group.
+ int testCount;
+
+ // The (1-based) line on which the group was defined, or `null`.
+ int? line;
+
+ // The (1-based) column on which the group was defined, or `null`.
+ int? column;
+
+ // The URL for the file in which the group was defined, or `null`.
+ String? url;
+
+ // This field is deprecated and should not be used.
+ Metadata metadata;
+}
+```
+
+A group containing test cases. The group's ID is unique in the context of this
+test run. It's used elsewhere in the protocol to refer to this group without
+including its full representation.
+
+The implicit group at the root of each test suite has `null` `name` and
+`parentID` attributes.
+
+The `line`, `column`, and `url` fields indicate the location the `group()`
+function was called to create this group. They're treated as a unit: they'll
+either all be `null` or they'll all be non-`null`. The URL is always absolute,
+and may be a `package:` URL.
+
+### Metadata
+
+```
+class Metadata {
+ bool skip;
+
+ // The reason the tests was skipped, or `null` if it wasn't skipped.
+ String? skipReason;
+}
+```
+
+The metadata class is deprecated and should not be used.
+
+## Remote Debugger APIs
+
+When running browser tests with `--pause-after-load`, the test package embeds a
+few APIs in the JavaScript context of the host page. These allow tools to
+control the debugging process in the same way a user might do from the command
+line. They can be accessed by connecting to the remote debugger using the
+[`DebugEvent.remoteDebugger`](#DebugEvent) URL.
+
+All APIs are defined as methods on the top-level `dartTest` object. The
+following methods are available:
+
+### `resume()`
+
+Calling `resume()` when the test runner is paused causes it to resume running
+tests. If the test runner is not paused, it won't do anything. When
+`--pause-after-load` is passed, the test runner will pause after loading each
+suite but before any tests are run.
+
+This gives external tools a chance to use the remote debugger protocol to set
+breakpoints before tests have begun executing. They can start the test runner
+with `--pause-after-load`, connect to the remote debugger using the
+[`DebugEvent.remoteDebugger`](#DebugEvent) URL, set breakpoints, then call
+`dartTest.resume()` in the host frame when they're finished.
+
+### `restartCurrent()`
+
+Calling `restartCurrent()` when the test runner is running a test causes it to
+re-run that test once it completes its current run. It's intended to be called
+when the browser is paused, as at a breakpoint.
diff --git a/pkgs/test/doc/json_reporter.schema.json b/pkgs/test/doc/json_reporter.schema.json
new file mode 100644
index 0000000..25417e2
--- /dev/null
+++ b/pkgs/test/doc/json_reporter.schema.json
@@ -0,0 +1,220 @@
+{
+ "$schema": "http://json-schema.org/draft-04/schema#",
+ "description": "An event emitted by the test package's JSON reporter",
+
+ "definitions": {
+ "GroupEntry": {
+ "required": [
+ "id",
+ "suiteID",
+ "metadata",
+ "line",
+ "column",
+ "url"
+ ],
+ "properties": {
+ "id": {"type": "integer", "minimum": 0},
+ "suiteID": {"type": "integer", "minimum": 0},
+ "metadata": {"$ref": "#/definitions/Metadata"}
+ },
+ "oneOf": [
+ {
+ "properties": {
+ "line": {"type": "integer", "minimum": 1},
+ "column": {"type": "integer", "minimum": 1},
+ "url": {"type": "string", "format": "uri"}
+ }
+ },
+ {
+ "properties": {
+ "line": {"type": "null"},
+ "column": {"type": "null"},
+ "url": {"type": "null"}
+ }
+ }
+ ]
+ },
+
+ "Test": {
+ "allOf": [{"$ref": "#/definitions/GroupEntry"}],
+ "required": [
+ "name",
+ "groupIDs"
+ ],
+ "properties": {
+ "name": {"type": "string"},
+ "groupIDs": {
+ "type": "array",
+ "items": {"type": "integer", "minimum": 0}
+ }
+ }
+ },
+
+ "Suite": {
+ "required": ["id", "platform", "path"],
+ "properties": {
+ "id": {"type": "integer", "minimum": 0},
+ "platform": {
+ "oneOf": [{"type": "string"}, {"type": "null"}]
+ },
+ "path": {"type": "string"}
+ }
+ },
+
+ "Group": {
+ "allOf": [{"$ref": "#/definitions/GroupEntry"}],
+ "required": ["name"],
+ "properties": {
+ "parentID": {
+ "oneOf": [{"type": "integer", "minimum": 0}, {"type": "null"}]
+ },
+ "name": {
+ "oneOf": [{"type": "string"}, {"type": "null"}]
+ },
+ "testCount": {"type": "integer", "minimum": 0}
+ }
+ },
+
+ "Metadata": {
+ "required": ["skip", "skipReason"],
+ "properties": {
+ "skip": {"type": "boolean"},
+ "skipReason": {
+ "oneOf": [{"type": "string"}, {"type": "null"}]
+ }
+ }
+ }
+ },
+
+ "required": ["type", "time"],
+ "properties": {
+ "time": {"type": "integer", "minimum": 0},
+ "type": {"type": "string"}
+ },
+
+ "oneOf": [
+ {
+ "title": "StartEvent",
+ "required": ["protocolVersion", "runnerVersion"],
+ "properties": {
+ "type": {"enum": ["start"]},
+ "pid": {"type": "integer", "minimum": 0},
+ "protocolVersion": {"type": "string", "pattern": "^0\\.1\\."},
+ "runnerVersion": {
+ "oneOf": [{"type": "string"}, {"type": "null"}]
+ }
+ }
+ },
+
+ {
+ "title": "TestStartEvent",
+ "required": ["test"],
+ "properties": {
+ "type": {"enum": ["testStart"]},
+ "test": {"$ref": "#/definitions/Test"}
+ }
+ },
+
+ {
+ "title": "AllSuitesEvent",
+ "required": ["count"],
+ "properties": {
+ "type": {"enum": ["allSuites"]},
+ "count": {"type": "integer", "minimum": 0}
+ }
+ },
+
+ {
+ "title": "SuiteEvent",
+ "required": ["suite"],
+ "properties": {
+ "type": {"enum": ["suite"]},
+ "suite": {"$ref": "#/definitions/Suite"}
+ }
+ },
+
+ {
+ "title": "DebugEvent",
+ "required": ["suiteID"],
+ "properties": {
+ "type": {"enum": ["debug"]},
+ "suiteID": {"type": "integer", "minimum": 0},
+ "observatory": {
+ "oneOf": [{"type": "string", "format": "uri"}, {"type": "null"}]
+ },
+ "remoteDebugger": {
+ "oneOf": [{"type": "string", "format": "uri"}, {"type": "null"}]
+ }
+ }
+ },
+
+ {
+ "title": "GroupEvent",
+ "required": ["group"],
+ "properties": {
+ "type": {"enum": ["group"]},
+ "group": {"$ref": "#/definitions/Group"}
+ }
+ },
+
+ {
+ "title": "MessageEvent",
+ "required": ["testID", "message", "type"],
+ "properties": {
+ "type": {"enum": ["print"]},
+ "testID": {"type": "integer", "minimum": 0},
+ "message": {"type": "string"},
+ "messageType": {"type": "string", "enum": ["print", "skip"]}
+ }
+ },
+
+ {
+ "title": "ErrorEvent",
+ "required": ["testID", "error", "stackTrace", "isFailure"],
+ "properties": {
+ "type": {"enum": ["error"]},
+ "testID": {"type": "integer", "minimum": 0},
+ "error": {"type": "string"},
+ "stackTrace": {"type": "string"},
+ "isFailure": {"type": "boolean"}
+ }
+ },
+
+ {
+ "title": "TestDoneEvent",
+ "required": ["testID", "result", "hidden", "skipped"],
+ "properties": {
+ "type": {"enum": ["testDone"]},
+ "testID": {"type": "integer", "minimum": 0},
+ "result": {"type": "string", "enum": ["success", "failure", "error"]},
+ "hidden": {"type": "boolean"},
+ "skipped": {"type": "boolean"}
+ }
+ },
+
+ {
+ "title": "DoneEvent",
+ "required": ["success"],
+ "properties": {
+ "type": {"enum": ["done"]},
+ "success": {"type": "boolean"}
+ }
+ },
+
+ {
+ "title": "FutureEvent",
+ "description":
+ "A placeholder event to allow new events to be added in the future.",
+ "properties": {
+ "type": {
+ "not": {
+ "enum": [
+ "start", "testStart", "allSuites", "suite", "group", "print",
+ "error", "testDone", "done", "debug"
+ ]
+ }
+ }
+ }
+ }
+ ]
+}
diff --git a/pkgs/test/doc/package_config.md b/pkgs/test/doc/package_config.md
new file mode 120000
index 0000000..422034a
--- /dev/null
+++ b/pkgs/test/doc/package_config.md
@@ -0,0 +1 @@
+configuration.md
\ No newline at end of file
diff --git a/pkgs/test/image/hybrid.png b/pkgs/test/image/hybrid.png
new file mode 100644
index 0000000..554a28c
--- /dev/null
+++ b/pkgs/test/image/hybrid.png
Binary files differ
diff --git a/pkgs/test/image/test1.gif b/pkgs/test/image/test1.gif
new file mode 100644
index 0000000..289e3ee
--- /dev/null
+++ b/pkgs/test/image/test1.gif
Binary files differ
diff --git a/pkgs/test/image/test2.gif b/pkgs/test/image/test2.gif
new file mode 100644
index 0000000..7bae0fc
--- /dev/null
+++ b/pkgs/test/image/test2.gif
Binary files differ
diff --git a/pkgs/test/lib/bootstrap/browser.dart b/pkgs/test/lib/bootstrap/browser.dart
new file mode 100644
index 0000000..b70cf11
--- /dev/null
+++ b/pkgs/test/lib/bootstrap/browser.dart
@@ -0,0 +1,5 @@
+// Copyright (c) 2018, 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.
+
+export '../src/bootstrap/browser.dart';
diff --git a/pkgs/test/lib/bootstrap/node.dart b/pkgs/test/lib/bootstrap/node.dart
new file mode 100644
index 0000000..0214d6b
--- /dev/null
+++ b/pkgs/test/lib/bootstrap/node.dart
@@ -0,0 +1,5 @@
+// Copyright (c) 2018, 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.
+
+export '../src/bootstrap/node.dart';
diff --git a/pkgs/test/lib/bootstrap/vm.dart b/pkgs/test/lib/bootstrap/vm.dart
new file mode 100644
index 0000000..8115736
--- /dev/null
+++ b/pkgs/test/lib/bootstrap/vm.dart
@@ -0,0 +1,5 @@
+// Copyright (c) 2018, 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.
+
+export 'package:test_core/src/bootstrap/vm.dart';
diff --git a/pkgs/test/lib/dart.js b/pkgs/test/lib/dart.js
new file mode 100644
index 0000000..3840ba7
--- /dev/null
+++ b/pkgs/test/lib/dart.js
@@ -0,0 +1,80 @@
+// Copyright (c) 2015, 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.
+
+// This script runs in HTML files and loads the corresponding test scripts for
+// a JS browser. It's used by "pub serve" and user-authored HTML files;
+window.onload = function() {
+
+// Sends an error message to the server indicating that the script failed to
+// load.
+//
+// This mimics a MultiChannel-formatted message.
+var sendLoadException = function(message) {
+ window.parent.postMessage({
+ "data": [0, {"type": "loadException", "message": message}],
+ "exception": true,
+ }, window.location.origin);
+}
+
+// Listen for dartLoadException events and forward to the server.
+window.addEventListener('dartLoadException', function(e) {
+ sendLoadException(e.detail);
+});
+
+// The basename of the current page.
+var name = window.location.href.replace(/.*\//, '').replace(/#.*/, '');
+
+// Find <link rel="x-dart-test">.
+var links = document.getElementsByTagName("link");
+var testLinks = [];
+var length = links.length;
+for (var i = 0; i < length; ++i) {
+ if (links[i].rel == "x-dart-test") testLinks.push(links[i]);
+}
+
+if (testLinks.length != 1) {
+ sendLoadException(
+ 'Expected exactly 1 <link rel="x-dart-test"> in ' + name + ', found ' +
+ testLinks.length + '.');
+ return;
+}
+
+var link = testLinks[0];
+
+if (link.href == '') {
+ sendLoadException(
+ 'Expected <link rel="x-dart-test"> in ' + name + ' to have an "href" ' +
+ 'attribute.');
+ return;
+}
+
+var script = document.createElement('script');
+
+if (typeof trustedTypes !== 'undefined') {
+ const sanitizer = trustedTypes.createPolicy('dart#test', {
+ createScriptURL: (input) => input + '.browser_test.dart.js'
+ });
+ script.src = sanitizer.createScriptURL(link.href);
+} else {
+ script.src = link.href + '.browser_test.dart.js';
+}
+
+script.onerror = function(event) {
+ var message = "Failed to load script at " + script.src +
+ (event.message ? ": " + event.message : ".");
+ sendLoadException(message);
+};
+
+Array.from(document.querySelectorAll('script')).some(currentScript => {
+ if (currentScript.nonce) {
+ script.nonce = currentScript.nonce;
+ return true;
+ }
+});
+
+var parent = link.parentNode;
+document.currentScript = script;
+parent.replaceChild(script, link);
+
+};
diff --git a/pkgs/test/lib/expect.dart b/pkgs/test/lib/expect.dart
new file mode 100644
index 0000000..5e62622
--- /dev/null
+++ b/pkgs/test/lib/expect.dart
@@ -0,0 +1,5 @@
+// Copyright (c) 2021, 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.
+
+export 'package:matcher/expect.dart';
diff --git a/pkgs/test/lib/fake.dart b/pkgs/test/lib/fake.dart
new file mode 100644
index 0000000..fc28bef
--- /dev/null
+++ b/pkgs/test/lib/fake.dart
@@ -0,0 +1,10 @@
+// Copyright (c) 2020, 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.
+
+// Note: eventually we would like to fold this into test.dart, but we can't do
+// so until Mockito stops implementing its own version of `Fake`, because there
+// is code in the wild that imports both test_api.dart and Mockito.
+
+// ignore: deprecated_member_use
+export 'package:test_api/fake.dart';
diff --git a/pkgs/test/lib/scaffolding.dart b/pkgs/test/lib/scaffolding.dart
new file mode 100644
index 0000000..06e9029
--- /dev/null
+++ b/pkgs/test/lib/scaffolding.dart
@@ -0,0 +1,5 @@
+// Copyright (c) 2021, 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.
+
+export 'package:test_core/src/scaffolding.dart';
diff --git a/pkgs/test/lib/src/bootstrap/browser.dart b/pkgs/test/lib/src/bootstrap/browser.dart
new file mode 100644
index 0000000..1a66e2b
--- /dev/null
+++ b/pkgs/test/lib/src/bootstrap/browser.dart
@@ -0,0 +1,21 @@
+// Copyright (c) 2017, 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 'package:stream_channel/stream_channel.dart';
+import 'package:test_core/src/runner/plugin/remote_platform_helpers.dart'; // ignore: implementation_imports
+import 'package:test_core/src/util/stack_trace_mapper.dart'; // ignore: implementation_imports
+
+import '../runner/browser/post_message_channel.dart';
+
+/// Bootstraps a browser test to communicate with the test runner.
+void internalBootstrapBrowserTest(Function Function() getMain,
+ {StreamChannel<Object?>? testChannel}) {
+ var channel = serializeSuite(getMain, hidePrints: false,
+ beforeLoad: (suiteChannel) async {
+ var serialized = await suiteChannel('test.browser.mapper').stream.first;
+ if (serialized is! Map) return;
+ setStackTraceMapper(JSStackTraceMapper.deserialize(serialized)!);
+ });
+ (testChannel ?? postMessageChannel()).pipe(channel);
+}
diff --git a/pkgs/test/lib/src/bootstrap/node.dart b/pkgs/test/lib/src/bootstrap/node.dart
new file mode 100644
index 0000000..21089a4
--- /dev/null
+++ b/pkgs/test/lib/src/bootstrap/node.dart
@@ -0,0 +1,18 @@
+// Copyright (c) 2017, 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 'package:test_core/src/runner/plugin/remote_platform_helpers.dart'; // ignore: implementation_imports
+import 'package:test_core/src/util/stack_trace_mapper.dart'; // ignore: implementation_imports
+
+import '../runner/node/socket_channel.dart';
+
+/// Bootstraps a browser test to communicate with the test runner.
+void internalBootstrapNodeTest(Function Function() getMain) {
+ var channel = serializeSuite(getMain, beforeLoad: (suiteChannel) async {
+ var serialized = await suiteChannel('test.node.mapper').stream.first;
+ if (serialized is! Map) return;
+ setStackTraceMapper(JSStackTraceMapper.deserialize(serialized)!);
+ });
+ socketChannel().then((socket) => socket.pipe(channel));
+}
diff --git a/pkgs/test/lib/src/executable.dart b/pkgs/test/lib/src/executable.dart
new file mode 100644
index 0000000..5780694
--- /dev/null
+++ b/pkgs/test/lib/src/executable.dart
@@ -0,0 +1,23 @@
+// Copyright (c) 2015, 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 'package:test_api/src/backend/runtime.dart'; // ignore: implementation_imports
+// ignore: implementation_imports
+import 'package:test_core/src/executable.dart' as executable;
+import 'package:test_core/src/runner/hack_register_platform.dart'; // ignore: implementation_imports
+
+import 'runner/browser/platform.dart';
+import 'runner/node/platform.dart';
+
+Future<void> main(List<String> args) async {
+ registerPlatformPlugin([Runtime.nodeJS], NodePlatform.new);
+ registerPlatformPlugin([
+ Runtime.chrome,
+ Runtime.edge,
+ Runtime.firefox,
+ Runtime.safari,
+ ], BrowserPlatform.start);
+
+ await executable.main(args);
+}
diff --git a/pkgs/test/lib/src/runner/browser/browser.dart b/pkgs/test/lib/src/runner/browser/browser.dart
new file mode 100644
index 0000000..b025ea2
--- /dev/null
+++ b/pkgs/test/lib/src/runner/browser/browser.dart
@@ -0,0 +1,138 @@
+// Copyright (c) 2015, 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 'dart:convert';
+import 'dart:io';
+
+import 'package:test_core/src/runner/application_exception.dart'; // ignore: implementation_imports
+import 'package:test_core/src/util/errors.dart'; // ignore: implementation_imports
+
+/// An interface for running browser instances.
+///
+/// This is intentionally coarse-grained: browsers are controlled primary from
+/// inside a single tab. Thus this interface only provides support for closing
+/// the browser and seeing if it closes itself.
+///
+/// Any errors starting or running the browser process are reported through
+/// [onExit].
+abstract class Browser {
+ String get name;
+
+ /// The remote debugger URL for this browser.
+ ///
+ /// This will complete to `null` for browsers that don't support remote
+ /// debugging, or if the remote debugging URL can't be found.
+ Future<Uri?> get remoteDebuggerUrl async => null;
+
+ /// The underlying process.
+ ///
+ /// This will fire once the process has started successfully.
+ Future<Process> get _process => _processCompleter.future;
+ final _processCompleter = Completer<Process>();
+
+ /// Whether [close] has been called.
+ var _closed = false;
+
+ /// A future that completes when the browser exits.
+ ///
+ /// If there's a problem starting or running the browser, this will complete
+ /// with an error.
+ Future<void> get onExit => _onExitCompleter.future;
+ final _onExitCompleter = Completer<void>();
+
+ /// Standard IO streams for the underlying browser process.
+ final _ioSubscriptions = <StreamSubscription<String>>[];
+
+ final output = <String>[];
+
+ /// Creates a new browser.
+ ///
+ /// This is intended to be called by subclasses. They pass in [startBrowser],
+ /// which asynchronously returns the browser process. Any errors in
+ /// [startBrowser] (even those raised asynchronously after it returns) are
+ /// piped to [onExit] and will cause the browser to be killed.
+ Browser(Future<Process> Function() startBrowser) {
+ // Don't return a Future here because there's no need for the caller to wait
+ // for the process to actually start. They should just wait for the HTTP
+ // request instead.
+ runZonedGuarded(() async {
+ var process = await startBrowser();
+ _processCompleter.complete(process);
+
+ void drainOutput(Stream<List<int>> stream) {
+ try {
+ _ioSubscriptions.add(stream
+ .transform(utf8.decoder)
+ .transform(const LineSplitter())
+ .listen(output.add, cancelOnError: true));
+ } on StateError catch (_) {}
+ }
+
+ // If we don't drain the stdout and stderr the process can hang.
+ drainOutput(process.stdout);
+ drainOutput(process.stderr);
+
+ var exitCode = await process.exitCode;
+
+ // This hack dodges an otherwise intractable race condition. When the user
+ // presses Control-C, the signal is sent to the browser and the test
+ // runner at the same time. It's possible for the browser to exit before
+ // the [Browser.close] is called, which would trigger the error below.
+ //
+ // A negative exit code signals that the process exited due to a signal.
+ // However, it's possible that this signal didn't come from the user's
+ // Control-C, in which case we do want to throw the error. The only way to
+ // resolve the ambiguity is to wait a brief amount of time and see if this
+ // browser is actually closed.
+ if (!_closed && exitCode < 0) {
+ await Future<void>.delayed(const Duration(milliseconds: 200));
+ }
+
+ if (!_closed && exitCode != 0) {
+ var outputString = output.join('\n');
+ var message = '$name failed with exit code $exitCode.';
+ if (outputString.isNotEmpty) {
+ message += '\nStandard output:\n$outputString';
+ }
+
+ throw ApplicationException(message);
+ }
+
+ _onExitCompleter.complete();
+ }, (error, stackTrace) {
+ // Ignore any errors after the browser has been closed.
+ if (_closed) return;
+
+ // Make sure the process dies even if the error wasn't fatal.
+ _process.then((process) => process.kill());
+
+ if (_onExitCompleter.isCompleted) return;
+ _onExitCompleter.completeError(
+ ApplicationException(
+ 'Failed to run $name: ${getErrorMessage(error)}.'),
+ stackTrace);
+ });
+ }
+
+ /// Kills the browser process.
+ ///
+ /// Returns the same [Future] as [onExit], except that it won't emit
+ /// exceptions.
+ Future<void> close() async {
+ _closed = true;
+
+ // If we don't manually close the stream the test runner can hang.
+ // For example this happens with Chrome Headless.
+ // See SDK issue: https://github.com/dart-lang/sdk/issues/31264
+ for (var stream in _ioSubscriptions) {
+ unawaited(stream.cancel());
+ }
+
+ (await _process).kill();
+
+ // Swallow exceptions. The user should explicitly use [onExit] for these.
+ return onExit.onError((_, __) {});
+ }
+}
diff --git a/pkgs/test/lib/src/runner/browser/browser_manager.dart b/pkgs/test/lib/src/runner/browser/browser_manager.dart
new file mode 100644
index 0000000..409fbb4
--- /dev/null
+++ b/pkgs/test/lib/src/runner/browser/browser_manager.dart
@@ -0,0 +1,359 @@
+// Copyright (c) 2015, 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 'dart:convert';
+
+import 'package:async/async.dart';
+import 'package:pool/pool.dart';
+import 'package:stream_channel/stream_channel.dart';
+import 'package:test_api/backend.dart' show Compiler, Runtime, StackTraceMapper;
+import 'package:test_core/src/runner/application_exception.dart'; // ignore: implementation_imports
+import 'package:test_core/src/runner/configuration.dart'; // ignore: implementation_imports
+import 'package:test_core/src/runner/environment.dart'; // ignore: implementation_imports
+import 'package:test_core/src/runner/load_exception.dart'; // ignore: implementation_imports
+import 'package:test_core/src/runner/plugin/platform_helpers.dart'; // ignore: implementation_imports
+import 'package:test_core/src/runner/runner_suite.dart'; // ignore: implementation_imports
+import 'package:test_core/src/runner/suite.dart'; // ignore: implementation_imports
+import 'package:test_core/src/util/io.dart'; // ignore: implementation_imports
+import 'package:web_socket_channel/web_socket_channel.dart';
+
+import '../executable_settings.dart';
+import 'browser.dart';
+import 'chrome.dart';
+import 'firefox.dart';
+import 'microsoft_edge.dart';
+import 'safari.dart';
+
+/// A class that manages the connection to a single running browser.
+///
+/// This is in charge of telling the browser which test suites to load and
+/// converting its responses into [Suite] objects.
+class BrowserManager {
+ /// The browser instance that this is connected to via [_channel].
+ final Browser _browser;
+
+ // TODO(nweiz): Consider removing the duplication between this and
+ // [_browser.name].
+ /// The [Runtime] for [_browser].
+ final Runtime _runtime;
+
+ /// The channel used to communicate with the browser.
+ ///
+ /// This is connected to a page running `static/host.dart`.
+ late final MultiChannel<Object> _channel;
+
+ /// A pool that ensures that limits the number of initial connections the
+ /// manager will wait for at once.
+ ///
+ /// This isn't the *total* number of connections; any number of iframes may be
+ /// loaded in the same browser. However, the browser can only load so many at
+ /// once, and we want a timeout in case they fail so we only wait for so many
+ /// at once.
+ final _pool = Pool(8);
+
+ /// The ID of the next suite to be loaded.
+ ///
+ /// This is used to ensure that the suites can be referred to consistently
+ /// across the client and server.
+ int _suiteID = 0;
+
+ /// Whether the channel to the browser has closed.
+ bool _closed = false;
+
+ /// The completer for [_BrowserEnvironment.displayPause].
+ ///
+ /// This will be `null` as long as the browser isn't displaying a pause
+ /// screen.
+ CancelableCompleter<void>? _pauseCompleter;
+
+ /// The controller for [_BrowserEnvironment.onRestart].
+ final _onRestartController = StreamController<void>.broadcast();
+
+ /// The environment to attach to each suite.
+ late final Future<_BrowserEnvironment> _environment;
+
+ /// Controllers for every suite in this browser.
+ ///
+ /// These are used to mark suites as debugging or not based on the browser's
+ /// pings.
+ final _controllers = <RunnerSuiteController>{};
+
+ // A timer that's reset whenever we receive a message from the browser.
+ //
+ // Because the browser stops running code when the user is actively debugging,
+ // this lets us detect whether they're debugging reasonably accurately.
+ late final RestartableTimer _timer;
+
+ /// Starts the browser identified by [runtime] and has it connect to [url].
+ ///
+ /// [url] should serve a page that establishes a WebSocket connection with
+ /// this process. That connection, once established, should be emitted via
+ /// [future]. If [debug] is true, starts the browser in debug mode, with its
+ /// debugger interfaces on and detected.
+ ///
+ /// The [settings] indicate how to invoke this browser's executable.
+ ///
+ /// Returns the browser manager, or throws an [ApplicationException] if a
+ /// connection fails to be established.
+ static Future<BrowserManager> start(
+ Runtime runtime,
+ Uri url,
+ Future<WebSocketChannel> future,
+ ExecutableSettings settings,
+ Configuration configuration) =>
+ _start(runtime, url, future, settings, configuration, 1);
+
+ static const _maxRetries = 3;
+ static Future<BrowserManager> _start(
+ Runtime runtime,
+ Uri url,
+ Future<WebSocketChannel> future,
+ ExecutableSettings settings,
+ Configuration configuration,
+ int attempt) {
+ var browser = _newBrowser(url, runtime, settings, configuration);
+
+ var completer = Completer<BrowserManager>();
+
+ // TODO(nweiz): Gracefully handle the browser being killed before the
+ // tests complete.
+ browser.onExit
+ .then<void>((_) => throw ApplicationException(
+ '${runtime.name} exited before connecting.'))
+ .onError<Object>((error, stackTrace) {
+ if (!completer.isCompleted) {
+ completer.completeError(error, stackTrace);
+ }
+ });
+
+ future.then((webSocket) {
+ if (completer.isCompleted) return;
+ completer.complete(BrowserManager._(browser, runtime, webSocket));
+ }).onError((Object error, StackTrace stackTrace) {
+ browser.close();
+ if (completer.isCompleted) return;
+ completer.completeError(error, stackTrace);
+ });
+
+ return completer.future.timeout(const Duration(seconds: 30), onTimeout: () {
+ browser.close();
+ if (attempt >= _maxRetries) {
+ throw ApplicationException(
+ 'Timed out waiting for ${runtime.name} to connect.\n'
+ 'Browser output: ${browser.output.join('\n')}');
+ }
+ return _start(runtime, url, future, settings, configuration, ++attempt);
+ });
+ }
+
+ /// Starts the browser identified by [browser] using [settings] and has it load [url].
+ ///
+ /// If [debug] is true, starts the browser in debug mode.
+ static Browser _newBrowser(Uri url, Runtime browser,
+ ExecutableSettings settings, Configuration configuration) =>
+ switch (browser.root) {
+ Runtime.chrome => Chrome(url, configuration, settings: settings),
+ Runtime.firefox => Firefox(url, settings: settings),
+ Runtime.safari => Safari(url, settings: settings),
+ Runtime.edge => MicrosoftEdge(url, configuration, settings: settings),
+ _ => throw ArgumentError('$browser is not a browser.'),
+ };
+
+ /// Creates a new BrowserManager that communicates with [browser] over
+ /// [webSocket].
+ BrowserManager._(this._browser, this._runtime, WebSocketChannel webSocket) {
+ // The duration should be short enough that the debugging console is open as
+ // soon as the user is done setting breakpoints, but long enough that a test
+ // doing a lot of synchronous work doesn't trigger a false positive.
+ //
+ // Start this canceled because we don't want it to start ticking until we
+ // get some response from the iframe.
+ _timer = RestartableTimer(const Duration(seconds: 3), () {
+ for (var controller in _controllers) {
+ controller.setDebugging(true);
+ }
+ })
+ ..cancel();
+
+ // Whenever we get a message, no matter which child channel it's for, we the
+ // know browser is still running code which means the user isn't debugging.
+ _channel = MultiChannel(
+ webSocket.cast<String>().transform(jsonDocument).changeStream((stream) {
+ return stream.map((message) {
+ if (!_closed) _timer.reset();
+ for (var controller in _controllers) {
+ controller.setDebugging(false);
+ }
+
+ return message;
+ });
+ }));
+
+ _environment = _loadBrowserEnvironment();
+ _channel.stream.listen(
+ (message) => _onMessage(message as Map<Object, Object?>),
+ onDone: close);
+ }
+
+ /// Loads [_BrowserEnvironment].
+ Future<_BrowserEnvironment> _loadBrowserEnvironment() async =>
+ _BrowserEnvironment(
+ this, await _browser.remoteDebuggerUrl, _onRestartController.stream);
+
+ /// Tells the browser the load a test suite from the URL [url].
+ ///
+ /// [url] should be an HTML page with a reference to the JS-compiled test
+ /// suite. [path] is the path of the original test suite file, which is used
+ /// for reporting. [suiteConfig] is the configuration for the test suite.
+ ///
+ /// If [mapper] is passed, it's used to map stack traces for errors coming
+ /// from this test suite.
+ Future<RunnerSuite> load(String path, Uri url, SuiteConfiguration suiteConfig,
+ Map<String, Object?> message, Compiler compiler,
+ {StackTraceMapper? mapper, Duration? timeout}) async {
+ url = url.replace(
+ fragment: Uri.encodeFull(jsonEncode({
+ 'metadata': suiteConfig.metadata.serialize(),
+ 'browser': _runtime.identifier,
+ 'compiler': compiler.serialize(),
+ })));
+
+ var suiteID = _suiteID++;
+ RunnerSuiteController? controller;
+ void closeIframe() {
+ if (_closed) return;
+ if (controller != null) _controllers.remove(controller);
+ _channel.sink.add({'command': 'closeSuite', 'id': suiteID});
+ }
+
+ // The virtual channel will be closed when the suite is closed, in which
+ // case we should unload the iframe.
+ var virtualChannel = _channel.virtualChannel();
+ var suiteChannelID = virtualChannel.id;
+ var suiteChannel = virtualChannel
+ .transformStream(StreamTransformer.fromHandlers(handleDone: (sink) {
+ closeIframe();
+ sink.close();
+ }));
+
+ var suite = _pool.withResource<RunnerSuite>(() async {
+ _channel.sink.add({
+ 'command': 'loadSuite',
+ 'url': url.toString(),
+ 'id': suiteID,
+ 'channel': suiteChannelID
+ });
+
+ try {
+ controller = deserializeSuite(
+ path,
+ currentPlatform(_runtime, compiler),
+ suiteConfig,
+ await _environment,
+ suiteChannel.cast(),
+ message, gatherCoverage: () async {
+ var browser = _browser;
+ if (browser is Chrome) return browser.gatherCoverage();
+ return {};
+ });
+
+ controller!
+ .channel('test.browser.mapper')
+ .sink
+ .add(mapper?.serialize());
+
+ _controllers.add(controller!);
+ return await controller!.suite;
+ } catch (_) {
+ closeIframe();
+ rethrow;
+ }
+ });
+ if (timeout != null) {
+ suite = suite.timeout(timeout, onTimeout: () {
+ throw LoadException(
+ path,
+ 'Timed out waiting for browser to load test suite. '
+ 'Browser output: ${_browser.output.join('\n')}');
+ });
+ }
+ return suite;
+ }
+
+ /// An implementation of [Environment.displayPause].
+ CancelableOperation<void> _displayPause() {
+ if (_pauseCompleter != null) return _pauseCompleter!.operation;
+
+ final pauseCompleter = _pauseCompleter = CancelableCompleter(onCancel: () {
+ _channel.sink.add({'command': 'resume'});
+ _pauseCompleter = null;
+ });
+
+ pauseCompleter.operation.value.whenComplete(() {
+ _pauseCompleter = null;
+ });
+
+ _channel.sink.add({'command': 'displayPause'});
+
+ return pauseCompleter.operation;
+ }
+
+ /// The callback for handling messages received from the host page.
+ void _onMessage(Map<Object, Object?> message) {
+ switch (message['command'] as String) {
+ case 'ping':
+ break;
+
+ case 'restart':
+ _onRestartController.add(null);
+ break;
+
+ case 'resume':
+ _pauseCompleter?.complete();
+ break;
+
+ default:
+ // Unreachable.
+ assert(false);
+ break;
+ }
+ }
+
+ /// Closes the manager and releases any resources it owns, including closing
+ /// the browser.
+ Future<void> close() => _closeMemoizer.runOnce(() {
+ _closed = true;
+ _timer.cancel();
+ _pauseCompleter?.complete();
+ _pauseCompleter = null;
+ _controllers.clear();
+ return _browser.close();
+ });
+ final _closeMemoizer = AsyncMemoizer<void>();
+}
+
+/// An implementation of [Environment] for the browser.
+///
+/// All methods forward directly to [BrowserManager].
+class _BrowserEnvironment implements Environment {
+ final BrowserManager _manager;
+
+ @override
+ final supportsDebugging = true;
+
+ @override
+ Null get observatoryUrl => null;
+
+ @override
+ final Uri? remoteDebuggerUrl;
+
+ @override
+ final Stream<void> onRestart;
+
+ _BrowserEnvironment(this._manager, this.remoteDebuggerUrl, this.onRestart);
+
+ @override
+ CancelableOperation<void> displayPause() => _manager._displayPause();
+}
diff --git a/pkgs/test/lib/src/runner/browser/chrome.dart b/pkgs/test/lib/src/runner/browser/chrome.dart
new file mode 100644
index 0000000..e7dff75
--- /dev/null
+++ b/pkgs/test/lib/src/runner/browser/chrome.dart
@@ -0,0 +1,194 @@
+// Copyright (c) 2015, 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 'dart:convert';
+import 'dart:io';
+
+import 'package:collection/collection.dart';
+import 'package:coverage/coverage.dart';
+import 'package:path/path.dart' as p;
+import 'package:test_api/src/backend/runtime.dart'; // ignore: implementation_imports
+import 'package:test_core/src/runner/configuration.dart'; // ignore: implementation_imports
+import 'package:test_core/src/util/io.dart'; // ignore: implementation_imports
+import 'package:webkit_inspection_protocol/webkit_inspection_protocol.dart';
+
+import '../executable_settings.dart';
+import 'browser.dart';
+import 'chromium.dart';
+import 'default_settings.dart';
+
+/// A class for running an instance of Chrome.
+///
+/// Most of the communication with the browser is expected to happen via HTTP,
+/// so this exposes a bare-bones API. The browser starts as soon as the class is
+/// constructed, and is killed when [close] is called.
+///
+/// Any errors starting or running the process are reported through [onExit].
+class Chrome extends Browser {
+ @override
+ final name = 'Chrome';
+
+ @override
+ final Future<Uri?> remoteDebuggerUrl;
+
+ final Future<WipConnection> _tabConnection;
+ final Map<String, String> _idToUrl;
+
+ /// Starts a new instance of Chrome open to the given [url], which may be a
+ /// [Uri] or a [String].
+ factory Chrome(Uri url, Configuration configuration,
+ {ExecutableSettings? settings}) {
+ settings ??= defaultSettings[Runtime.chrome]!;
+ var remoteDebuggerCompleter = Completer<Uri?>.sync();
+ var connectionCompleter = Completer<WipConnection>();
+ var idToUrl = <String, String>{};
+ return Chrome._(() async {
+ Future<Process> tryPort([int? port]) async {
+ var process = await ChromiumBasedBrowser.chrome.spawn(
+ url,
+ configuration,
+ settings: settings,
+ additionalArgs: [
+ if (port != null)
+ // Chrome doesn't provide any way of ensuring that this port was
+ // successfully bound. It produces an error if the binding fails,
+ // but without a reliable and fast way to tell if it succeeded
+ // that doesn't provide us much. It's very unlikely that this port
+ // will fail, though.
+ '--remote-debugging-port=$port',
+ ],
+ );
+
+ if (port != null) {
+ remoteDebuggerCompleter.complete(
+ getRemoteDebuggerUrl(Uri.parse('http://localhost:$port')));
+
+ connectionCompleter.complete(_connect(process, port, idToUrl, url));
+ } else {
+ remoteDebuggerCompleter.complete(null);
+ }
+
+ return process;
+ }
+
+ if (!configuration.debug) return tryPort();
+ return getUnusedPort<Process>(tryPort);
+ }, remoteDebuggerCompleter.future, connectionCompleter.future, idToUrl);
+ }
+
+ /// Returns a Dart based hit-map containing coverage report, suitable for use
+ /// with `package:coverage`.
+ Future<Map<String, dynamic>> gatherCoverage() async {
+ var tabConnection = await _tabConnection;
+ var response = await tabConnection.debugger.connection
+ .sendCommand('Profiler.takePreciseCoverage', {});
+ var result =
+ (response.result!['result'] as List).cast<Map<String, dynamic>>();
+ var httpClient = HttpClient();
+ var coverage = await parseChromeCoverage(
+ result,
+ (scriptId) => _sourceProvider(scriptId, httpClient),
+ (scriptId) => _sourceMapProvider(scriptId, httpClient),
+ _sourceUriProvider,
+ );
+ httpClient.close(force: true);
+ return coverage;
+ }
+
+ Chrome._(super.startBrowser, this.remoteDebuggerUrl, this._tabConnection,
+ this._idToUrl);
+
+ Future<Uri?> _sourceUriProvider(String sourceUrl, String scriptId) async {
+ var script = _idToUrl[scriptId];
+ if (script == null) return null;
+ var sourceUri = Uri.parse(sourceUrl);
+ if (sourceUri.scheme == 'file') return sourceUri;
+ // If the provided sourceUrl is relative, determine the package path.
+ var uri = Uri.parse(script);
+ var path = p.join(
+ p.joinAll(uri.pathSegments.sublist(1, uri.pathSegments.length - 1)),
+ sourceUrl);
+ return path.contains('/packages/')
+ ? Uri(scheme: 'package', path: path.split('/packages/').last)
+ : null;
+ }
+
+ Future<String?> _sourceMapProvider(
+ String scriptId, HttpClient httpClient) async {
+ var script = _idToUrl[scriptId];
+ if (script == null) return null;
+ return await httpClient.getString('$script.map');
+ }
+
+ Future<String?> _sourceProvider(
+ String scriptId, HttpClient httpClient) async {
+ var script = _idToUrl[scriptId];
+ if (script == null) return null;
+ return await httpClient.getString(script);
+ }
+}
+
+Future<WipConnection> _connect(
+ Process process, int port, Map<String, String> idToUrl, Uri url) async {
+ // Wait for Chrome to be in a ready state.
+ await process.stderr
+ .transform(utf8.decoder)
+ .transform(const LineSplitter())
+ .firstWhere((line) => line.startsWith('DevTools listening'));
+
+ var chromeConnection = ChromeConnection('localhost', port);
+ ChromeTab? tab;
+ var attempt = 0;
+ while (tab == null) {
+ attempt++;
+ var tabs = await chromeConnection.getTabs();
+ tab = tabs.firstWhereOrNull((tab) => tab.url == url.toString());
+ if (tab == null) {
+ await Future<void>.delayed(const Duration(milliseconds: 100));
+ if (attempt > 5) {
+ throw StateError('Could not connect to test tab with url: $url');
+ }
+ }
+ }
+ var tabConnection = await tab.connect();
+
+ // Enable debugging.
+ await tabConnection.debugger.enable();
+
+ // Coverage reports are in terms of scriptIds so keep note of URLs.
+ tabConnection.debugger.onScriptParsed.listen((data) {
+ var script = data.script;
+ if (script.url.isNotEmpty) idToUrl[script.scriptId] = script.url;
+ });
+
+ // Enable coverage collection.
+ await tabConnection.debugger.connection.sendCommand('Profiler.enable', {});
+ await tabConnection.debugger.connection.sendCommand(
+ 'Profiler.startPreciseCoverage', {'detailed': true, 'callCount': false});
+
+ return tabConnection;
+}
+
+extension on HttpClient {
+ Encoding determineEncoding(HttpHeaders headers) {
+ final contentType = headers.contentType?.charset;
+
+ /// Using the `charset` property of the `contentType` if available.
+ /// If it's unavailable or if the encoding name is unknown, [latin1] is used by default,
+ /// as per [RFC 2616][].
+ ///
+ /// [RFC 2616]: http://www.w3.org/Protocols/rfc2616/rfc2616-sec3.html
+ return Encoding.getByName(contentType) ?? latin1;
+ }
+
+ Future<String?> getString(String url) async {
+ final request = await getUrl(Uri.parse(url));
+ final response = await request.close();
+ if (response.statusCode != HttpStatus.ok) return null;
+ var bytes = [await for (var chunk in response) ...chunk];
+ final encoding = determineEncoding(response.headers);
+ return encoding.decode(bytes);
+ }
+}
diff --git a/pkgs/test/lib/src/runner/browser/chromium.dart b/pkgs/test/lib/src/runner/browser/chromium.dart
new file mode 100644
index 0000000..b0243ba
--- /dev/null
+++ b/pkgs/test/lib/src/runner/browser/chromium.dart
@@ -0,0 +1,63 @@
+// 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 'dart:io';
+
+import 'package:test_api/src/backend/runtime.dart'; // ignore: implementation_imports
+import 'package:test_core/src/runner/configuration.dart'; // ignore: implementation_imports
+import 'package:test_core/src/util/io.dart'; // ignore: implementation_imports
+
+import '../executable_settings.dart';
+import 'default_settings.dart';
+
+enum ChromiumBasedBrowser {
+ chrome(Runtime.chrome),
+ microsoftEdge(Runtime.edge);
+
+ final Runtime runtime;
+
+ const ChromiumBasedBrowser(this.runtime);
+
+ Future<Process> spawn(
+ Uri url,
+ Configuration configuration, {
+ ExecutableSettings? settings,
+ List<String> additionalArgs = const [],
+ }) async {
+ settings ??= defaultSettings[runtime];
+
+ var dir = createTempDir();
+ var args = [
+ '--user-data-dir=$dir',
+ url.toString(),
+ '--enable-logging=stderr',
+ '--v=0',
+ '--disable-extensions',
+ '--disable-popup-blocking',
+ '--bwsi',
+ '--no-first-run',
+ '--no-default-browser-check',
+ '--disable-default-apps',
+ '--disable-translate',
+ '--disable-dev-shm-usage',
+ if (settings!.headless && !configuration.pauseAfterLoad) ...[
+ '--headless',
+ '--disable-gpu',
+ ],
+ if (!configuration.debug)
+ // We don't actually connect to the remote debugger, but Chrome will
+ // close as soon as the page is loaded if we don't turn it on.
+ '--remote-debugging-port=0',
+ ...settings.arguments,
+ ...additionalArgs,
+ ];
+
+ var process = await Process.start(settings.executable, args);
+
+ unawaited(process.exitCode.then((_) => Directory(dir).deleteWithRetry()));
+
+ return process;
+ }
+}
diff --git a/pkgs/test/lib/src/runner/browser/compilers/compiler_support.dart b/pkgs/test/lib/src/runner/browser/compilers/compiler_support.dart
new file mode 100644
index 0000000..4fa1b88
--- /dev/null
+++ b/pkgs/test/lib/src/runner/browser/compilers/compiler_support.dart
@@ -0,0 +1,105 @@
+// 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 'dart:convert';
+import 'dart:io';
+
+import 'package:path/path.dart' as p;
+import 'package:shelf/shelf.dart' as shelf;
+import 'package:test_api/backend.dart' show StackTraceMapper, SuitePlatform;
+import 'package:test_core/src/runner/configuration.dart'; // ignore: implementation_imports
+import 'package:test_core/src/runner/suite.dart'; // ignore: implementation_imports
+import 'package:web_socket_channel/web_socket_channel.dart'; // ignore: implementation_imports
+
+/// The shared interface for all compiler support libraries.
+abstract class CompilerSupport {
+ /// The global test runner configuration.
+ final Configuration config;
+
+ /// The default template path.
+ final String defaultTemplatePath;
+
+ CompilerSupport(this.config, this.defaultTemplatePath);
+
+ /// The URL at which this compiler serves its tests.
+ ///
+ /// Each compiler serves its tests under a different directory.
+ Uri get serverUrl;
+
+ /// Compiles [dartPath] using [suiteConfig] for [platform].
+ ///
+ /// [dartPath] is the path to the original `.dart` test suite, relative to the
+ /// package root.
+ Future<void> compileSuite(
+ String dartPath, SuiteConfiguration suiteConfig, SuitePlatform platform);
+
+ /// Retrieves a stack trace mapper for [dartPath] if available.
+ ///
+ /// [dartPath] is the path to the original `.dart` test suite, relative to the
+ /// package root.
+ StackTraceMapper? stackTraceMapperForPath(String dartPath);
+
+ /// Returns the eventual URI for the web socket, as well as the channel itself
+ /// once the connection is established.
+ (Uri uri, Future<WebSocketChannel> socket) get webSocket;
+
+ /// Closes down anything necessary for this implementation.
+ Future<void> close();
+
+ /// A handler that serves html wrapper files used to bootstrap tests.
+ shelf.Response htmlWrapperHandler(shelf.Request request);
+}
+
+mixin JsHtmlWrapper on CompilerSupport {
+ @override
+ shelf.Response htmlWrapperHandler(shelf.Request request) {
+ var path = p.fromUri(request.url);
+
+ if (path.endsWith('.html')) {
+ var test = p.setExtension(path, '.dart');
+ var scriptBase = htmlEscape.convert(p.basename(test));
+ var link = '<link rel="x-dart-test" href="$scriptBase">';
+ var testName = htmlEscape.convert(test);
+ var template = config.customHtmlTemplatePath ?? defaultTemplatePath;
+ var contents = File(template).readAsStringSync();
+ var processedContents = contents
+ // Checked during loading phase that there is only one {{testScript}} placeholder.
+ .replaceFirst('{{testScript}}', link)
+ .replaceAll('{{testName}}', testName);
+ return shelf.Response.ok(processedContents,
+ headers: {'Content-Type': 'text/html'});
+ }
+
+ return shelf.Response.notFound('Not found.');
+ }
+}
+
+mixin WasmHtmlWrapper on CompilerSupport {
+ @override
+ shelf.Response htmlWrapperHandler(shelf.Request request) {
+ var path = p.fromUri(request.url);
+
+ if (path.endsWith('.html')) {
+ var test = '${p.withoutExtension(path)}.dart';
+ var scriptBase = htmlEscape.convert(p.basename(test));
+ var link = '<link rel="x-dart-test" href="$scriptBase">';
+ var testName = htmlEscape.convert(test);
+ var template = config.customHtmlTemplatePath ?? defaultTemplatePath;
+ var contents = File(template).readAsStringSync();
+ var jsRuntime = p.basename('$test.browser_test.dart.mjs');
+ var wasmData = '<data id="WasmBootstrapInfo" '
+ 'data-wasmurl="${p.basename('$test.browser_test.dart.wasm')}" '
+ 'data-jsruntimeurl="$jsRuntime"></data>';
+ var processedContents = contents
+ // Checked during loading phase that there is only one {{testScript}} placeholder.
+ .replaceFirst('{{testScript}}', '$link\n$wasmData')
+ .replaceAll('{{testName}}', testName);
+ return shelf.Response.ok(processedContents,
+ headers: {'Content-Type': 'text/html'});
+ }
+
+ return shelf.Response.notFound('Not found.');
+ }
+}
diff --git a/pkgs/test/lib/src/runner/browser/compilers/dart2js.dart b/pkgs/test/lib/src/runner/browser/compilers/dart2js.dart
new file mode 100644
index 0000000..3cd6745
--- /dev/null
+++ b/pkgs/test/lib/src/runner/browser/compilers/dart2js.dart
@@ -0,0 +1,186 @@
+// 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 'dart:io';
+
+import 'package:http_multi_server/http_multi_server.dart';
+import 'package:path/path.dart' as p;
+import 'package:shelf/shelf.dart' as shelf;
+import 'package:shelf/shelf_io.dart' as shelf_io;
+import 'package:shelf_packages_handler/shelf_packages_handler.dart';
+import 'package:shelf_static/shelf_static.dart';
+import 'package:shelf_web_socket/shelf_web_socket.dart';
+import 'package:test_api/backend.dart' show StackTraceMapper, SuitePlatform;
+import 'package:test_core/src/runner/configuration.dart'; // ignore: implementation_imports
+import 'package:test_core/src/runner/dart2js_compiler_pool.dart'; // ignore: implementation_imports
+import 'package:test_core/src/runner/package_version.dart'; // ignore: implementation_imports
+import 'package:test_core/src/runner/suite.dart'; // ignore: implementation_imports
+import 'package:test_core/src/util/io.dart'; // ignore: implementation_imports
+import 'package:test_core/src/util/package_config.dart'; // ignore: implementation_imports
+import 'package:test_core/src/util/stack_trace_mapper.dart'; // ignore: implementation_imports
+import 'package:web_socket_channel/web_socket_channel.dart';
+
+import '../../../util/math.dart';
+import '../../../util/one_off_handler.dart';
+import '../../../util/package_map.dart';
+import '../../../util/path_handler.dart';
+import 'compiler_support.dart';
+
+/// Support for Dart2Js compiled tests.
+class Dart2JsSupport extends CompilerSupport with JsHtmlWrapper {
+ /// Whether [close] has been called.
+ bool _closed = false;
+
+ /// The temporary directory in which compiled JS is emitted.
+ final _compiledDir = createTempDir();
+
+ /// A map from test suite paths to Futures that will complete once those
+ /// suites are finished compiling.
+ ///
+ /// This is used to make sure that a given test suite is only compiled once
+ /// per run, rather than once per browser per run.
+ final _compileFutures = <String, Future<void>>{};
+
+ /// The [Dart2JsCompilerPool] managing active instances of `dart2js`.
+ final _compilerPool = Dart2JsCompilerPool();
+
+ /// Mappers for Dartifying stack traces, indexed by test path.
+ final _mappers = <String, StackTraceMapper>{};
+
+ /// A [PathHandler] used to serve test specific artifacts.
+ final _pathHandler = PathHandler();
+
+ /// The root directory served statically by this server.
+ final String _root;
+
+ /// Each compiler serves its tests under a different randomly-generated
+ /// secret URI to ensure that other users on the same system can't snoop
+ /// on data being served through this server, as well as distinguish tests
+ /// from different compilers from each other.
+ final String _secret = randomUrlSecret();
+
+ /// The underlying server.
+ final shelf.Server _server;
+
+ /// A [OneOffHandler] for servicing WebSocket connections for
+ /// [BrowserManager]s.
+ ///
+ /// This is one-off because each [BrowserManager] can only connect to a single
+ /// WebSocket.
+ final _webSocketHandler = OneOffHandler();
+
+ @override
+ Uri get serverUrl => _server.url.resolve('$_secret/');
+
+ Dart2JsSupport._(super.config, super.defaultTemplatePath, this._server,
+ this._root, String faviconPath) {
+ var cascade = shelf.Cascade()
+ .add(_webSocketHandler.handler)
+ .add(packagesDirHandler())
+ .add(_pathHandler.handler)
+ .add(createStaticHandler(_root))
+ .add(htmlWrapperHandler);
+
+ var pipeline = const shelf.Pipeline()
+ .addMiddleware(PathHandler.nestedIn(_secret))
+ .addHandler(cascade.handler);
+
+ _server.mount(shelf.Cascade()
+ .add(createFileHandler(faviconPath))
+ .add(pipeline)
+ .handler);
+ }
+
+ static Future<Dart2JsSupport> start({
+ required Configuration config,
+ required String defaultTemplatePath,
+ required String root,
+ required String faviconPath,
+ }) async {
+ var server = shelf_io.IOServer(await HttpMultiServer.loopback(0));
+ return Dart2JsSupport._(
+ config, defaultTemplatePath, server, root, faviconPath);
+ }
+
+ @override
+ Future<void> compileSuite(
+ String dartPath, SuiteConfiguration suiteConfig, SuitePlatform platform) {
+ return _compileFutures.putIfAbsent(dartPath, () async {
+ var dir = Directory(_compiledDir).createTempSync('test_').path;
+ var jsPath = p.join(dir, '${p.basename(dartPath)}.browser_test.dart.js');
+ var bootstrapContent = '''
+ ${suiteConfig.metadata.languageVersionComment ?? await rootPackageLanguageVersionComment}
+ import 'package:test/src/bootstrap/browser.dart';
+ import 'package:test/src/runner/browser/dom.dart' as dom;
+
+ import '${await absoluteUri(dartPath)}' as test;
+
+ void main() {
+ dom.window.console.log(r'Startup for test path $dartPath');
+ internalBootstrapBrowserTest(() => test.main);
+ }
+ ''';
+
+ await _compilerPool.compile(bootstrapContent, jsPath, suiteConfig);
+ if (_closed) return;
+
+ var bootstrapUrl = '${p.toUri(p.relative(dartPath, from: _root)).path}'
+ '.browser_test.dart';
+ _pathHandler.add(bootstrapUrl, (request) {
+ return shelf.Response.ok(bootstrapContent,
+ headers: {'Content-Type': 'application/dart'});
+ });
+
+ var jsUrl = '${p.toUri(p.relative(dartPath, from: _root)).path}'
+ '.browser_test.dart.js';
+ _pathHandler.add(jsUrl, (request) {
+ return shelf.Response.ok(File(jsPath).readAsStringSync(),
+ headers: {'Content-Type': 'application/javascript'});
+ });
+
+ var mapUrl = '${p.toUri(p.relative(dartPath, from: _root)).path}'
+ '.browser_test.dart.js.map';
+ _pathHandler.add(mapUrl, (request) {
+ return shelf.Response.ok(File('$jsPath.map').readAsStringSync(),
+ headers: {'Content-Type': 'application/json'});
+ });
+
+ if (suiteConfig.jsTrace) return;
+ var mapPath = '$jsPath.map';
+ _mappers[dartPath] = JSStackTraceMapper(File(mapPath).readAsStringSync(),
+ mapUrl: p.toUri(mapPath),
+ sdkRoot: Uri.parse('org-dartlang-sdk:///sdk'),
+ packageMap: (await currentPackageConfig).toPackageMap());
+ });
+ }
+
+ @override
+ Future<void> close() async {
+ if (_closed) return;
+ _closed = true;
+ await Future.wait([
+ Directory(_compiledDir).deleteWithRetry(),
+ _compilerPool.close(),
+ _server.close(),
+ ]);
+ }
+
+ @override
+ StackTraceMapper? stackTraceMapperForPath(String dartPath) =>
+ _mappers[dartPath];
+
+ @override
+ (Uri, Future<WebSocketChannel>) get webSocket {
+ var completer = Completer<WebSocketChannel>.sync();
+ // Note: the WebSocketChannel type below is needed for compatibility with
+ // package:shelf_web_socket v2.
+ var path =
+ _webSocketHandler.create(webSocketHandler((WebSocketChannel ws, _) {
+ completer.complete(ws);
+ }));
+ var webSocketUrl = serverUrl.replace(scheme: 'ws').resolve(path);
+ return (webSocketUrl, completer.future);
+ }
+}
diff --git a/pkgs/test/lib/src/runner/browser/compilers/dart2wasm.dart b/pkgs/test/lib/src/runner/browser/compilers/dart2wasm.dart
new file mode 100644
index 0000000..31ad661
--- /dev/null
+++ b/pkgs/test/lib/src/runner/browser/compilers/dart2wasm.dart
@@ -0,0 +1,192 @@
+// 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 'dart:io';
+
+import 'package:http_multi_server/http_multi_server.dart';
+import 'package:path/path.dart' as p;
+import 'package:shelf/shelf.dart' as shelf;
+import 'package:shelf/shelf_io.dart' as shelf_io;
+import 'package:shelf_packages_handler/shelf_packages_handler.dart';
+import 'package:shelf_static/shelf_static.dart';
+import 'package:shelf_web_socket/shelf_web_socket.dart';
+import 'package:test_api/backend.dart' show StackTraceMapper, SuitePlatform;
+import 'package:test_core/src/runner/configuration.dart'; // ignore: implementation_imports
+import 'package:test_core/src/runner/package_version.dart'; // ignore: implementation_imports
+import 'package:test_core/src/runner/suite.dart'; // ignore: implementation_imports
+import 'package:test_core/src/runner/wasm_compiler_pool.dart'; // ignore: implementation_imports
+import 'package:test_core/src/util/io.dart'; // ignore: implementation_imports
+import 'package:test_core/src/util/package_config.dart'; // ignore: implementation_imports
+import 'package:web_socket_channel/web_socket_channel.dart';
+
+import '../../../util/math.dart';
+import '../../../util/one_off_handler.dart';
+import '../../../util/path_handler.dart';
+import '../browser_manager.dart';
+import 'compiler_support.dart';
+
+/// Support for Dart2Wasm compiled tests.
+class Dart2WasmSupport extends CompilerSupport with WasmHtmlWrapper {
+ /// Whether [close] has been called.
+ bool _closed = false;
+
+ /// The temporary directory in which compiled JS is emitted.
+ final _compiledDir = createTempDir();
+
+ /// A map from test suite paths to Futures that will complete once those
+ /// suites are finished compiling.
+ ///
+ /// This is used to make sure that a given test suite is only compiled once
+ /// per run, rather than once per browser per run.
+ final _compileFutures = <String, Future<void>>{};
+
+ /// The [WasmCompilerPool] managing active instances of `dart2wasm`.
+ final _compilerPool = WasmCompilerPool();
+
+ /// The `package:test` side wrapper for the Dart2Wasm runtime.
+ final String _jsRuntimeWrapper;
+
+ /// Mappers for Dartifying stack traces, indexed by test path.
+ final _mappers = <String, StackTraceMapper>{};
+
+ /// A [PathHandler] used to serve test specific artifacts.
+ final _pathHandler = PathHandler();
+
+ /// The root directory served statically by this server.
+ final String _root;
+
+ /// Each compiler serves its tests under a different randomly-generated
+ /// secret URI to ensure that other users on the same system can't snoop
+ /// on data being served through this server, as well as distinguish tests
+ /// from different compilers from each other.
+ final String _secret = randomUrlSecret();
+
+ /// The underlying server.
+ final shelf.Server _server;
+
+ /// A [OneOffHandler] for servicing WebSocket connections for
+ /// [BrowserManager]s.
+ ///
+ /// This is one-off because each [BrowserManager] can only connect to a single
+ /// WebSocket.
+ final _webSocketHandler = OneOffHandler();
+
+ @override
+ Uri get serverUrl => _server.url.resolve('$_secret/');
+
+ Dart2WasmSupport._(super.config, super.defaultTemplatePath,
+ this._jsRuntimeWrapper, this._server, this._root, String faviconPath) {
+ var cascade = shelf.Cascade()
+ .add(_webSocketHandler.handler)
+ .add(packagesDirHandler())
+ .add(_pathHandler.handler)
+ .add(createStaticHandler(_root))
+ .add(htmlWrapperHandler);
+
+ var pipeline = const shelf.Pipeline()
+ .addMiddleware(PathHandler.nestedIn(_secret))
+ .addHandler(cascade.handler);
+
+ _server.mount(shelf.Cascade()
+ .add(createFileHandler(faviconPath))
+ .add(pipeline)
+ .handler);
+ }
+
+ static Future<Dart2WasmSupport> start({
+ required Configuration config,
+ required String defaultTemplatePath,
+ required String jsRuntimeWrapper,
+ required String root,
+ required String faviconPath,
+ }) async {
+ var server = shelf_io.IOServer(await HttpMultiServer.loopback(0));
+ return Dart2WasmSupport._(config, defaultTemplatePath, jsRuntimeWrapper,
+ server, root, faviconPath);
+ }
+
+ @override
+ Future<void> compileSuite(
+ String dartPath, SuiteConfiguration suiteConfig, SuitePlatform platform) {
+ return _compileFutures.putIfAbsent(dartPath, () async {
+ var dir = Directory(_compiledDir).createTempSync('test_').path;
+
+ var baseCompiledPath =
+ p.join(dir, '${p.basename(dartPath)}.browser_test.dart');
+ var baseUrl =
+ '${p.toUri(p.relative(dartPath, from: _root)).path}.browser_test.dart';
+ var wasmUrl = '$baseUrl.wasm';
+ var jsRuntimeWrapperUrl = '$baseUrl.js';
+ var jsRuntimeUrl = '$baseUrl.mjs';
+ var htmlUrl = '$baseUrl.html';
+
+ var bootstrapContent = '''
+ ${suiteConfig.metadata.languageVersionComment ?? await rootPackageLanguageVersionComment}
+ import 'package:test/src/bootstrap/browser.dart';
+
+ import '${await absoluteUri(dartPath)}' as test;
+
+ void main() {
+ internalBootstrapBrowserTest(() => test.main);
+ }
+ ''';
+
+ await _compilerPool.compile(
+ bootstrapContent, baseCompiledPath, suiteConfig);
+ if (_closed) return;
+
+ var wasmPath = '$baseCompiledPath.wasm';
+ _pathHandler.add(wasmUrl, (request) {
+ return shelf.Response.ok(File(wasmPath).readAsBytesSync(),
+ headers: {'Content-Type': 'application/wasm'});
+ });
+
+ _pathHandler.add(jsRuntimeWrapperUrl, (request) {
+ return shelf.Response.ok(File(_jsRuntimeWrapper).readAsBytesSync(),
+ headers: {'Content-Type': 'application/javascript'});
+ });
+
+ var jsRuntimePath = '$baseCompiledPath.mjs';
+ _pathHandler.add(jsRuntimeUrl, (request) {
+ return shelf.Response.ok(File(jsRuntimePath).readAsBytesSync(),
+ headers: {'Content-Type': 'application/javascript'});
+ });
+
+ var htmlPath = '$baseCompiledPath.html';
+ _pathHandler.add(htmlUrl, (request) {
+ return shelf.Response.ok(File(htmlPath).readAsBytesSync(),
+ headers: {'Content-Type': 'text/html'});
+ });
+ });
+ }
+
+ @override
+ Future<void> close() async {
+ if (_closed) return;
+ _closed = true;
+ await Future.wait([
+ Directory(_compiledDir).deleteWithRetry(),
+ _compilerPool.close(),
+ _server.close(),
+ ]);
+ }
+
+ @override
+ StackTraceMapper? stackTraceMapperForPath(String dartPath) =>
+ _mappers[dartPath];
+
+ @override
+ (Uri, Future<WebSocketChannel>) get webSocket {
+ var completer = Completer<WebSocketChannel>.sync();
+ // Note: the WebSocketChannel type below is needed for compatibility with
+ // package:shelf_web_socket v2.
+ var path =
+ _webSocketHandler.create(webSocketHandler((WebSocketChannel ws, _) {
+ completer.complete(ws);
+ }));
+ var webSocketUrl = serverUrl.replace(scheme: 'ws').resolve(path);
+ return (webSocketUrl, completer.future);
+ }
+}
diff --git a/pkgs/test/lib/src/runner/browser/compilers/precompiled.dart b/pkgs/test/lib/src/runner/browser/compilers/precompiled.dart
new file mode 100644
index 0000000..9cf44aa
--- /dev/null
+++ b/pkgs/test/lib/src/runner/browser/compilers/precompiled.dart
@@ -0,0 +1,149 @@
+// 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 'dart:io';
+
+import 'package:http_multi_server/http_multi_server.dart';
+import 'package:path/path.dart' as p;
+import 'package:shelf/shelf.dart' as shelf;
+import 'package:shelf/shelf_io.dart' as shelf_io;
+import 'package:shelf_packages_handler/shelf_packages_handler.dart';
+import 'package:shelf_static/shelf_static.dart';
+import 'package:shelf_web_socket/shelf_web_socket.dart';
+import 'package:test_api/backend.dart'
+ show Compiler, StackTraceMapper, SuitePlatform;
+import 'package:test_core/src/runner/configuration.dart'; // ignore: implementation_imports
+import 'package:test_core/src/runner/suite.dart'; // ignore: implementation_imports
+import 'package:test_core/src/util/package_config.dart'; // ignore: implementation_imports
+import 'package:test_core/src/util/stack_trace_mapper.dart'; // ignore: implementation_imports
+import 'package:web_socket_channel/web_socket_channel.dart';
+
+import '../../../util/math.dart';
+import '../../../util/one_off_handler.dart';
+import '../../../util/package_map.dart';
+import '../../../util/path_handler.dart';
+import 'compiler_support.dart';
+
+class JsPrecompiledSupport = PrecompiledSupport with JsHtmlWrapper;
+class WasmPrecompiledSupport = PrecompiledSupport with WasmHtmlWrapper;
+
+/// Support for precompiled test files.
+abstract class PrecompiledSupport extends CompilerSupport {
+ /// Whether [close] has been called.
+ bool _closed = false;
+
+ /// Mappers for Dartifying stack traces, indexed by test path.
+ final _mappers = <String, StackTraceMapper>{};
+
+ /// The root directory served statically by the server.
+ final String _root;
+
+ /// Each compiler serves its tests under a different randomly-generated
+ /// secret URI to ensure that other users on the same system can't snoop
+ /// on data being served through this server, as well as distinguish tests
+ /// from different compilers from each other.
+ final String _secret = randomUrlSecret();
+
+ /// The underlying server.
+ final shelf.Server _server;
+
+ /// A [OneOffHandler] for servicing WebSocket connections for
+ /// [BrowserManager]s.
+ ///
+ /// This is one-off because each [BrowserManager] can only connect to a single
+ /// WebSocket.
+ final _webSocketHandler = OneOffHandler();
+
+ /// The URL at which this compiler serves its tests.
+ ///
+ /// Each compiler serves its tests under a different directory.
+ @override
+ Uri get serverUrl => _server.url.resolve('$_secret/');
+
+ PrecompiledSupport._(super.config, super.defaultTemplatePath, this._server,
+ this._root, String faviconPath) {
+ var cascade = shelf.Cascade()
+ .add(_webSocketHandler.handler)
+ .add(createStaticHandler(_root, serveFilesOutsidePath: true))
+ // TODO: This packages dir handler should not be necessary?
+ .add(packagesDirHandler())
+ // Even for precompiled tests, we will auto-create a bootstrap html file
+ // if none was present.
+ .add(htmlWrapperHandler);
+
+ var pipeline = const shelf.Pipeline()
+ .addMiddleware(PathHandler.nestedIn(_secret))
+ .addHandler(cascade.handler);
+
+ _server.mount(shelf.Cascade()
+ .add(createFileHandler(faviconPath))
+ .add(pipeline)
+ .handler);
+ }
+
+ static Future<PrecompiledSupport> start({
+ required Compiler compiler,
+ required Configuration config,
+ required String defaultTemplatePath,
+ required String root,
+ required String faviconPath,
+ }) async {
+ var server = shelf_io.IOServer(await HttpMultiServer.loopback(0));
+
+ return switch (compiler) {
+ Compiler.dart2js => JsPrecompiledSupport._(
+ config, defaultTemplatePath, server, root, faviconPath),
+ Compiler.dart2wasm => WasmPrecompiledSupport._(
+ config, defaultTemplatePath, server, root, faviconPath),
+ Compiler.exe ||
+ Compiler.kernel ||
+ Compiler.source =>
+ throw UnsupportedError(
+ 'The browser platform does not support $compiler'),
+ };
+ }
+
+ /// Compiles [dartPath] using [suiteConfig] for [platform].
+ @override
+ Future<void> compileSuite(String dartPath, SuiteConfiguration suiteConfig,
+ SuitePlatform platform) async {
+ if (suiteConfig.jsTrace) return;
+ var mapPath = p.join(
+ suiteConfig.precompiledPath!, '$dartPath.browser_test.dart.js.map');
+ var mapFile = File(mapPath);
+ if (mapFile.existsSync()) {
+ _mappers[dartPath] = JSStackTraceMapper(mapFile.readAsStringSync(),
+ mapUrl: p.toUri(mapPath),
+ sdkRoot: Uri.parse(r'/packages/$sdk'),
+ packageMap: (await currentPackageConfig).toPackageMap());
+ }
+ }
+
+ /// Retrieves a stack trace mapper for [path] if available.
+ @override
+ StackTraceMapper? stackTraceMapperForPath(String dartPath) =>
+ _mappers[dartPath];
+
+ /// Closes down anything necessary for this implementation.
+ @override
+ Future<void> close() async {
+ if (_closed) return;
+ _closed = true;
+ await _server.close();
+ }
+
+ @override
+ (Uri, Future<WebSocketChannel>) get webSocket {
+ var completer = Completer<WebSocketChannel>.sync();
+ // Note: the WebSocketChannel type below is needed for compatibility with
+ // package:shelf_web_socket v2.
+ var path =
+ _webSocketHandler.create(webSocketHandler((WebSocketChannel ws, _) {
+ completer.complete(ws);
+ }));
+ var webSocketUrl = serverUrl.replace(scheme: 'ws').resolve(path);
+ return (webSocketUrl, completer.future);
+ }
+}
diff --git a/pkgs/test/lib/src/runner/browser/default_settings.dart b/pkgs/test/lib/src/runner/browser/default_settings.dart
new file mode 100644
index 0000000..312fc11
--- /dev/null
+++ b/pkgs/test/lib/src/runner/browser/default_settings.dart
@@ -0,0 +1,37 @@
+// Copyright (c) 2017, 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:collection';
+
+import 'package:test_api/src/backend/runtime.dart'; // ignore: implementation_imports
+import '../executable_settings.dart';
+
+/// Default settings for starting browser executables.
+final defaultSettings = UnmodifiableMapView({
+ Runtime.chrome: ExecutableSettings(
+ linuxExecutable: 'google-chrome',
+ macOSExecutable:
+ '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
+ windowsExecutable: r'Google\Chrome\Application\chrome.exe',
+ environmentOverride: 'CHROME_EXECUTABLE'),
+ Runtime.edge: ExecutableSettings(
+ linuxExecutable: 'microsoft-edge-stable',
+ windowsExecutable: r'Microsoft\Edge\Application\msedge.exe',
+ macOSExecutable:
+ '/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge',
+ environmentOverride: 'MS_EDGE_EXECUTABLE',
+ ),
+ Runtime.firefox: ExecutableSettings(
+ linuxExecutable: 'firefox',
+ macOSExecutables: [
+ '/Applications/Firefox.app/Contents/MacOS/firefox-bin',
+ '/Applications/Firefox.app/Contents/MacOS/firefox',
+ 'firefox',
+ ],
+ windowsExecutable: r'Mozilla Firefox\firefox.exe',
+ environmentOverride: 'FIREFOX_EXECUTABLE'),
+ Runtime.safari: ExecutableSettings(
+ macOSExecutable: '/Applications/Safari.app/Contents/MacOS/Safari',
+ environmentOverride: 'SAFARI_EXECUTABLE'),
+});
diff --git a/pkgs/test/lib/src/runner/browser/dom.dart b/pkgs/test/lib/src/runner/browser/dom.dart
new file mode 100644
index 0000000..d0fba48
--- /dev/null
+++ b/pkgs/test/lib/src/runner/browser/dom.dart
@@ -0,0 +1,280 @@
+// Copyright (c) 2022, 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:js_util' as js_util;
+
+import 'package:js/js.dart';
+
+@JS()
+@staticInterop
+class Window extends EventTarget {}
+
+extension WindowExtension on Window {
+ @pragma('dart2js:as:trust')
+ Window get parent => js_util.getProperty<dynamic>(this, 'parent') as Window;
+ external Location get location;
+ Console get console => js_util.getProperty(this, 'console') as Console;
+ CSSStyleDeclaration? getComputedStyle(Element elt, [String? pseudoElt]) =>
+ js_util.callMethod(this, 'getComputedStyle', <Object>[
+ elt,
+ if (pseudoElt != null) pseudoElt
+ ]) as CSSStyleDeclaration?;
+ external Navigator get navigator;
+ void postMessage(Object message, String targetOrigin,
+ [List<MessagePort>? messagePorts]) =>
+ js_util.callMethod(this, 'postMessage', <Object?>[
+ js_util.jsify(message),
+ targetOrigin,
+ if (messagePorts != null) js_util.jsify(messagePorts)
+ ]);
+}
+
+@JS('window')
+external Window get window;
+
+@JS()
+@staticInterop
+class Console {}
+
+extension ConsoleExtension on Console {
+ external void log(Object? object);
+ external void warn(Object? object);
+}
+
+@JS()
+@staticInterop
+class Document extends Node {}
+
+extension DocumentExtension on Document {
+ external Element? querySelector(String selectors);
+ Element createElement(String name, [Object? options]) => js_util.callMethod(
+ this, 'createElement', <Object>[name, if (options != null) options])
+ as Element;
+}
+
+@JS()
+@staticInterop
+class HTMLDocument extends Document {}
+
+extension HTMLDocumentExtension on HTMLDocument {
+ external HTMLBodyElement? get body;
+ external String? get title;
+}
+
+@JS('document')
+external HTMLDocument get document;
+
+@JS()
+@staticInterop
+class Navigator {}
+
+extension NavigatorExtension on Navigator {
+ external String get userAgent;
+}
+
+@JS()
+@staticInterop
+class Element extends Node {}
+
+extension DomElementExtension on Element {
+ external DomTokenList get classList;
+}
+
+@JS()
+@staticInterop
+class HTMLElement extends Element {}
+
+@JS()
+@staticInterop
+class HTMLBodyElement extends HTMLElement {}
+
+@JS()
+@staticInterop
+class Node extends EventTarget {}
+
+extension NodeExtension on Node {
+ external Node appendChild(Node node);
+ void remove() {
+ if (parentNode != null) {
+ final parent = parentNode!;
+ parent.removeChild(this);
+ }
+ }
+
+ external Node removeChild(Node child);
+ external Node? get parentNode;
+}
+
+@JS()
+@staticInterop
+class EventTarget {}
+
+extension EventTargetExtension on EventTarget {
+ void addEventListener(String type, EventListener? listener,
+ [bool? useCapture]) {
+ if (listener != null) {
+ js_util.callMethod<void>(this, 'addEventListener',
+ <Object>[type, listener, if (useCapture != null) useCapture]);
+ }
+ }
+
+ void removeEventListener(String type, EventListener? listener,
+ [bool? useCapture]) {
+ if (listener != null) {
+ js_util.callMethod<void>(this, 'removeEventListener',
+ <Object>[type, listener, if (useCapture != null) useCapture]);
+ }
+ }
+}
+
+typedef EventListener = void Function(Event event);
+
+@JS()
+@staticInterop
+class Event {}
+
+extension EventExtension on Event {
+ external void stopPropagation();
+}
+
+@JS()
+@staticInterop
+class MessageEvent extends Event {}
+
+extension MessageEventExtension on MessageEvent {
+ dynamic get data => js_util.dartify(js_util.getProperty(this, 'data'));
+ external String get origin;
+ List<MessagePort> get ports =>
+ js_util.getProperty<List>(this, 'ports').cast<MessagePort>();
+
+ /// The source may be a `WindowProxy`, a `MessagePort`, or a `ServiceWorker`.
+ ///
+ /// When a message is sent from an iframe through `window.parent.postMessage`
+ /// the source will be a `WindowProxy` which has the same methods as [Window].
+ @pragma('dart2js:as:trust')
+ MessageEventSource get source =>
+ js_util.getProperty<dynamic>(this, 'source') as MessageEventSource;
+}
+
+@JS()
+@staticInterop
+class MessageEventSource {}
+
+extension MessageEventSourceExtension on MessageEventSource {
+ @pragma('dart2js:as:trust')
+ MessageEventSourceLocation? get location =>
+ js_util.getProperty<dynamic>(this, 'location')
+ as MessageEventSourceLocation;
+}
+
+@JS()
+@staticInterop
+class MessageEventSourceLocation {}
+
+extension MessageEventSourceLocationExtension on MessageEventSourceLocation {
+ external String? get href;
+}
+
+@JS()
+@staticInterop
+class Location {}
+
+extension LocationExtension on Location {
+ external String get href;
+ external String get origin;
+}
+
+@JS()
+@staticInterop
+class MessagePort extends EventTarget {}
+
+extension MessagePortExtension on MessagePort {
+ void postMessage(Object? message) => js_util.callMethod(this, 'postMessage',
+ <Object>[if (message != null) js_util.jsify(message) as Object]);
+ external void start();
+}
+
+@JS()
+@staticInterop
+class CSSStyleDeclaration {}
+
+@JS()
+@staticInterop
+class HTMLScriptElement extends HTMLElement {}
+
+extension HTMLScriptElementExtension on HTMLScriptElement {
+ external set src(String value);
+}
+
+HTMLScriptElement createHTMLScriptElement() =>
+ document.createElement('script') as HTMLScriptElement;
+
+@JS()
+@staticInterop
+class DomTokenList {}
+
+extension DomTokenListExtension on DomTokenList {
+ external void add(String value);
+ external void remove(String value);
+ external bool contains(String token);
+}
+
+@JS()
+@staticInterop
+class HTMLIFrameElement extends HTMLElement {}
+
+extension HTMLIFrameElementExtension on HTMLIFrameElement {
+ external String? get src;
+ external set src(String? value);
+ external Window get contentWindow;
+}
+
+HTMLIFrameElement createHTMLIFrameElement() =>
+ document.createElement('iframe') as HTMLIFrameElement;
+
+@JS()
+@staticInterop
+class WebSocket extends EventTarget {}
+
+extension WebSocketExtension on WebSocket {
+ external void send(Object? data);
+}
+
+WebSocket createWebSocket(String url) =>
+ _callConstructor('WebSocket', <Object>[url])! as WebSocket;
+
+@JS()
+@staticInterop
+class MessageChannel {}
+
+extension MessageChannelExtension on MessageChannel {
+ external MessagePort get port1;
+ external MessagePort get port2;
+}
+
+MessageChannel createMessageChannel() =>
+ _callConstructor('MessageChannel', <Object>[])! as MessageChannel;
+
+Object? _findConstructor(String constructorName) =>
+ js_util.getProperty(window, constructorName);
+
+Object? _callConstructor(String constructorName, List<Object?> args) {
+ final constructor = _findConstructor(constructorName);
+ if (constructor == null) {
+ return null;
+ }
+ return js_util.callConstructor(constructor, args);
+}
+
+class Subscription {
+ final String type;
+ final EventTarget target;
+ final EventListener listener;
+
+ Subscription(this.target, this.type, this.listener) {
+ target.addEventListener(type, listener);
+ }
+
+ void cancel() => target.removeEventListener(type, listener);
+}
diff --git a/pkgs/test/lib/src/runner/browser/firefox.dart b/pkgs/test/lib/src/runner/browser/firefox.dart
new file mode 100644
index 0000000..503f103
--- /dev/null
+++ b/pkgs/test/lib/src/runner/browser/firefox.dart
@@ -0,0 +1,59 @@
+// Copyright (c) 2015, 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 'dart:io';
+
+import 'package:path/path.dart' as p;
+import 'package:test_api/src/backend/runtime.dart'; // ignore: implementation_imports
+import 'package:test_core/src/util/io.dart'; // ignore: implementation_imports
+
+import '../executable_settings.dart';
+import 'browser.dart';
+import 'default_settings.dart';
+
+final _preferences = '''
+user_pref("browser.shell.checkDefaultBrowser", false);
+user_pref("dom.disable_open_during_load", false);
+user_pref("dom.max_script_run_time", 0);
+''';
+
+/// A class for running an instance of Firefox.
+///
+/// Most of the communication with the browser is expected to happen via HTTP,
+/// so this exposes a bare-bones API. The browser starts as soon as the class is
+/// constructed, and is killed when [close] is called.
+///
+/// Any errors starting or running the process are reported through [onExit].
+class Firefox extends Browser {
+ @override
+ final name = 'Firefox';
+
+ Firefox(Uri url, {ExecutableSettings? settings})
+ : super(() =>
+ _startBrowser(url, settings ?? defaultSettings[Runtime.firefox]!));
+
+ /// Starts a new instance of Firefox open to the given [url], which may be a
+ /// [Uri] or a [String].
+ static Future<Process> _startBrowser(
+ Uri url, ExecutableSettings settings) async {
+ var dir = createTempDir();
+ File(p.join(dir, 'prefs.js')).writeAsStringSync(_preferences);
+
+ var process = await Process.start(settings.executable, [
+ '--profile',
+ dir,
+ url.toString(),
+ '--no-remote',
+ ...settings.arguments,
+ ], environment: {
+ 'MOZ_CRASHREPORTER_DISABLE': '1',
+ 'MOZ_AUTOMATION': '1',
+ });
+
+ unawaited(process.exitCode.then((_) => Directory(dir).deleteWithRetry()));
+
+ return process;
+ }
+}
diff --git a/pkgs/test/lib/src/runner/browser/microsoft_edge.dart b/pkgs/test/lib/src/runner/browser/microsoft_edge.dart
new file mode 100644
index 0000000..08fa8e2
--- /dev/null
+++ b/pkgs/test/lib/src/runner/browser/microsoft_edge.dart
@@ -0,0 +1,23 @@
+// 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 'package:test_core/src/runner/configuration.dart'; // ignore: implementation_imports
+
+import '../executable_settings.dart';
+import 'browser.dart';
+import 'chromium.dart';
+
+/// A class for running an instance of Microsoft Edge, a Chromium-based browser.
+class MicrosoftEdge extends Browser {
+ @override
+ String get name => 'Edge';
+
+ MicrosoftEdge(Uri url, Configuration configuration,
+ {ExecutableSettings? settings})
+ : super(() => ChromiumBasedBrowser.microsoftEdge.spawn(
+ url,
+ configuration,
+ settings: settings,
+ ));
+}
diff --git a/pkgs/test/lib/src/runner/browser/platform.dart b/pkgs/test/lib/src/runner/browser/platform.dart
new file mode 100644
index 0000000..da03a3e
--- /dev/null
+++ b/pkgs/test/lib/src/runner/browser/platform.dart
@@ -0,0 +1,269 @@
+// Copyright (c) 2016, 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 'dart:io';
+
+import 'package:async/async.dart';
+import 'package:path/path.dart' as p;
+import 'package:test_api/backend.dart' show Compiler, Runtime, SuitePlatform;
+import 'package:test_core/src/runner/configuration.dart'; // ignore: implementation_imports
+import 'package:test_core/src/runner/load_exception.dart'; // ignore: implementation_imports
+import 'package:test_core/src/runner/platform.dart'; // ignore: implementation_imports
+import 'package:test_core/src/runner/plugin/customizable_platform.dart'; // ignore: implementation_imports
+import 'package:test_core/src/runner/runner_suite.dart'; // ignore: implementation_imports
+import 'package:test_core/src/runner/suite.dart'; // ignore: implementation_imports
+import 'package:test_core/src/util/package_config.dart'; // ignore: implementation_imports
+import 'package:yaml/yaml.dart';
+
+import '../executable_settings.dart';
+import 'browser_manager.dart';
+import 'compilers/compiler_support.dart';
+import 'compilers/dart2js.dart';
+import 'compilers/dart2wasm.dart';
+import 'compilers/precompiled.dart';
+import 'default_settings.dart';
+
+class BrowserPlatform extends PlatformPlugin
+ implements CustomizablePlatform<ExecutableSettings> {
+ /// Starts the server.
+ ///
+ /// [root] is the root directory that the server should serve. It defaults to
+ /// the working directory.
+ static Future<BrowserPlatform> start({String? root}) async {
+ var packageConfig = await currentPackageConfig;
+ return BrowserPlatform._(
+ Configuration.current,
+ p.fromUri(packageConfig.resolve(
+ Uri.parse('package:test/src/runner/browser/static/favicon.ico'))),
+ p.fromUri(packageConfig.resolve(Uri.parse(
+ 'package:test/src/runner/browser/static/default.html.tpl'))),
+ p.fromUri(packageConfig.resolve(Uri.parse(
+ 'package:test/src/runner/browser/static/run_wasm_chrome.js'))),
+ root: root);
+ }
+
+ /// The test runner configuration.
+ final Configuration _config;
+
+ /// The cached [CompilerSupport] for each compiler.
+ final _compilerSupport = <Compiler, Future<CompilerSupport>>{};
+
+ /// The `package:test` side wrapper for the Dart2Wasm runtime.
+ final String _jsRuntimeWrapper;
+
+ /// The URL for this server and [compiler] combination.
+ ///
+ /// Each compiler serves its tests under a different randomly-generated
+ /// secret URI to ensure that other users on the same system can't snoop
+ /// on data being served through this server, as well as distinguish tests
+ /// from different compilers from each other.
+ Future<CompilerSupport> compilerSupport(Compiler compiler) =>
+ _compilerSupport.putIfAbsent(compiler, () {
+ if (_config.suiteDefaults.precompiledPath != null) {
+ return PrecompiledSupport.start(
+ compiler: compiler,
+ config: _config,
+ defaultTemplatePath: _defaultTemplatePath,
+ root: _config.suiteDefaults.precompiledPath!,
+ faviconPath: _faviconPath);
+ }
+ return switch (compiler) {
+ Compiler.dart2js => Dart2JsSupport.start(
+ config: _config,
+ defaultTemplatePath: _defaultTemplatePath,
+ root: _root,
+ faviconPath: _faviconPath),
+ Compiler.dart2wasm => Dart2WasmSupport.start(
+ config: _config,
+ defaultTemplatePath: _defaultTemplatePath,
+ jsRuntimeWrapper: _jsRuntimeWrapper,
+ root: _root,
+ faviconPath: _faviconPath),
+ _ => throw StateError('Unexpected compiler $compiler'),
+ };
+ });
+
+ /// The root directory served statically by this server.
+ final String _root;
+
+ /// Whether [close] has been called.
+ bool get _closed => _closeMemo.hasRun;
+
+ /// A map from browser identifiers to futures that will complete to the
+ /// [BrowserManager]s for those browsers, or `null` if they failed to load.
+ ///
+ /// This should only be accessed through [_browserManagerFor].
+ final _browserManagers = <(Runtime, Compiler), Future<BrowserManager?>>{};
+
+ /// Settings for invoking each browser.
+ ///
+ /// This starts out with the default settings, which may be overridden by user settings.
+ final _browserSettings =
+ Map<Runtime, ExecutableSettings>.from(defaultSettings);
+
+ /// The default template for html tests.
+ final String _defaultTemplatePath;
+
+ final String _faviconPath;
+
+ BrowserPlatform._(Configuration config, this._faviconPath,
+ this._defaultTemplatePath, this._jsRuntimeWrapper,
+ {String? root})
+ : _config = config,
+ _root = root ?? p.current;
+
+ @override
+ ExecutableSettings parsePlatformSettings(YamlMap settings) =>
+ ExecutableSettings.parse(settings);
+
+ @override
+ ExecutableSettings mergePlatformSettings(
+ ExecutableSettings settings1, ExecutableSettings settings2) =>
+ settings1.merge(settings2);
+
+ @override
+ void customizePlatform(Runtime runtime, ExecutableSettings settings) {
+ var oldSettings =
+ _browserSettings[runtime] ?? _browserSettings[runtime.root];
+ if (oldSettings != null) settings = oldSettings.merge(settings);
+ _browserSettings[runtime] = settings;
+ }
+
+ /// Loads the test suite at [path] on the platform [platform].
+ ///
+ /// This will start a browser to load the suite if one isn't already running.
+ /// Throws an [ArgumentError] if `platform.platform` isn't a browser.
+ @override
+ Future<RunnerSuite?> load(String path, SuitePlatform platform,
+ SuiteConfiguration suiteConfig, Map<String, Object?> message) async {
+ var browser = platform.runtime;
+ assert(suiteConfig.runtimes.contains(browser.identifier));
+
+ if (!browser.isBrowser) {
+ throw ArgumentError('$browser is not a browser.');
+ }
+
+ var compiler = platform.compiler;
+ var support = await compilerSupport(compiler);
+
+ var htmlPathFromTestPath = '${p.withoutExtension(path)}.html';
+ if (File(htmlPathFromTestPath).existsSync()) {
+ if (_config.customHtmlTemplatePath != null &&
+ p.basename(htmlPathFromTestPath) ==
+ p.basename(_config.customHtmlTemplatePath!)) {
+ throw LoadException(
+ path,
+ 'template file "${p.basename(_config.customHtmlTemplatePath!)}" cannot be named '
+ 'like the test file.');
+ }
+ _checkHtmlCorrectness(htmlPathFromTestPath, path);
+ } else if (_config.customHtmlTemplatePath != null) {
+ var htmlTemplatePath = _config.customHtmlTemplatePath!;
+ if (!File(htmlTemplatePath).existsSync()) {
+ throw LoadException(
+ path, '"$htmlTemplatePath" does not exist or is not readable');
+ }
+
+ final templateFileContents = File(htmlTemplatePath).readAsStringSync();
+ if ('{{testScript}}'.allMatches(templateFileContents).length != 1) {
+ throw LoadException(path,
+ '"$htmlTemplatePath" must contain exactly one {{testScript}} placeholder');
+ }
+ _checkHtmlCorrectness(htmlTemplatePath, path);
+ }
+
+ if (_closed) return null;
+ await support.compileSuite(path, suiteConfig, platform);
+
+ var suiteUrl = support.serverUrl.resolveUri(
+ p.toUri('${p.withoutExtension(p.relative(path, from: _root))}.html'));
+
+ if (_closed) return null;
+
+ var browserManager = await _browserManagerFor(browser, compiler);
+ if (_closed || browserManager == null) return null;
+
+ var timeout = const Duration(seconds: 30);
+ if (suiteConfig.metadata.timeout.apply(timeout) case final suiteTimeout?
+ when suiteTimeout > timeout) {
+ timeout = suiteTimeout;
+ }
+ var suite = await browserManager.load(
+ path, suiteUrl, suiteConfig, message, platform.compiler,
+ mapper: (await compilerSupport(compiler)).stackTraceMapperForPath(path),
+ timeout: timeout);
+ if (_closed) return null;
+ return suite;
+ }
+
+ void _checkHtmlCorrectness(String htmlPath, String path) {
+ if (!File(htmlPath).readAsStringSync().contains('packages/test/dart.js')) {
+ throw LoadException(
+ path,
+ '"$htmlPath" must contain <script src="packages/test/dart.js">'
+ '</script>.');
+ }
+ }
+
+ /// Returns the [BrowserManager] for [runtime], which should be a browser.
+ ///
+ /// If no browser manager is running yet, starts one.
+ Future<BrowserManager?> _browserManagerFor(
+ Runtime browser, Compiler compiler) {
+ var managerFuture = _browserManagers[(browser, compiler)];
+ if (managerFuture != null) return managerFuture;
+
+ var future = _createBrowserManager(browser, compiler);
+ // Store null values for browsers that error out so we know not to load them
+ // again.
+ _browserManagers[(browser, compiler)] =
+ future.then<BrowserManager?>((value) => value).onError((_, __) => null);
+
+ return future;
+ }
+
+ Future<BrowserManager> _createBrowserManager(
+ Runtime browser, Compiler compiler) async {
+ var support = await compilerSupport(compiler);
+ var (webSocketUrl, socketFuture) = support.webSocket;
+ var hostUrl = support.serverUrl
+ .resolve('packages/test/src/runner/browser/static/index.html')
+ .replace(queryParameters: {
+ 'managerUrl': webSocketUrl.toString(),
+ 'debug': _config.debug.toString()
+ });
+
+ return BrowserManager.start(
+ browser, hostUrl, socketFuture, _browserSettings[browser]!, _config);
+ }
+
+ /// Close all the browsers that the server currently has open.
+ ///
+ /// Note that this doesn't close the server itself. Browser tests can still be
+ /// loaded, they'll just spawn new browsers.
+ @override
+ Future<List<void>> closeEphemeral() {
+ var managers = _browserManagers.values.toList();
+ _browserManagers.clear();
+ return Future.wait(managers.map((manager) async {
+ var result = await manager;
+ if (result == null) return;
+ await result.close();
+ }));
+ }
+
+ /// Closes the server and releases all its resources.
+ ///
+ /// Returns a [Future] that completes once the server is closed and its
+ /// resources have been fully released.
+ @override
+ Future<void> close() async => _closeMemo.runOnce(() => Future.wait([
+ for (var browser in _browserManagers.values)
+ browser.then((b) => b?.close()),
+ for (var support in _compilerSupport.values)
+ support.then((s) => s.close()),
+ ]));
+ final _closeMemo = AsyncMemoizer<void>();
+}
diff --git a/pkgs/test/lib/src/runner/browser/post_message_channel.dart b/pkgs/test/lib/src/runner/browser/post_message_channel.dart
new file mode 100644
index 0000000..60a5a6b
--- /dev/null
+++ b/pkgs/test/lib/src/runner/browser/post_message_channel.dart
@@ -0,0 +1,31 @@
+// Copyright (c) 2015, 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:js_util';
+
+import 'package:stream_channel/stream_channel.dart';
+
+import 'dom.dart' as dom;
+
+/// Constructs a [StreamChannel] wrapping a new [MessageChannel] communicating
+/// with the host page.
+///
+/// Sends a [MessagePort] to the host page for the channel.
+StreamChannel<Object?> postMessageChannel() {
+ dom.window.console.log('Suite starting, sending channel to host');
+ var controller = StreamChannelController<Object?>(sync: true);
+ var channel = dom.createMessageChannel();
+ dom.window.parent
+ .postMessage('port', dom.window.location.origin, [channel.port2]);
+ var portSubscription = dom.Subscription(channel.port1, 'message',
+ allowInterop((dom.Event event) {
+ controller.local.sink.add((event as dom.MessageEvent).data);
+ }));
+ channel.port1.start();
+
+ controller.local.stream
+ .listen(channel.port1.postMessage, onDone: portSubscription.cancel);
+
+ return controller.foreign;
+}
diff --git a/pkgs/test/lib/src/runner/browser/safari.dart b/pkgs/test/lib/src/runner/browser/safari.dart
new file mode 100644
index 0000000..4e97205
--- /dev/null
+++ b/pkgs/test/lib/src/runner/browser/safari.dart
@@ -0,0 +1,48 @@
+// Copyright (c) 2015, 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 'dart:convert';
+import 'dart:io';
+
+import 'package:path/path.dart' as p;
+import 'package:test_api/src/backend/runtime.dart'; // ignore: implementation_imports
+import 'package:test_core/src/util/io.dart'; // ignore: implementation_imports
+
+import '../executable_settings.dart';
+import 'browser.dart';
+import 'default_settings.dart';
+
+/// A class for running an instance of Safari.
+///
+/// Any errors starting or running the process are reported through [onExit].
+class Safari extends Browser {
+ @override
+ final name = 'Safari';
+
+ Safari(Uri url, {ExecutableSettings? settings})
+ : super(() =>
+ _startBrowser(url, settings ?? defaultSettings[Runtime.safari]!));
+
+ /// Starts a new instance of Safari open to the given [url], which may be a
+ /// [Uri] or a [String].
+ static Future<Process> _startBrowser(
+ Uri url, ExecutableSettings settings) async {
+ var dir = createTempDir();
+
+ // Safari will only open files (not general URLs) via the command-line
+ // API, so we create a dummy file to redirect it to the page we actually
+ // want it to load.
+ var redirect = p.join(dir, 'redirect.html');
+ File(redirect).writeAsStringSync(
+ '<script>location = ${jsonEncode(url.toString())}</script>');
+
+ var process = await Process.start(
+ settings.executable, settings.arguments.toList()..add(redirect));
+
+ unawaited(process.exitCode.then((_) => Directory(dir).deleteWithRetry()));
+
+ return process;
+ }
+}
diff --git a/pkgs/test/lib/src/runner/browser/static/default.html.tpl b/pkgs/test/lib/src/runner/browser/static/default.html.tpl
new file mode 100644
index 0000000..a92f529
--- /dev/null
+++ b/pkgs/test/lib/src/runner/browser/static/default.html.tpl
@@ -0,0 +1,8 @@
+<!DOCTYPE html>
+<html>
+ <head>
+ <title>{{testName}} Test</title>
+ {{testScript}}
+ <script src="packages/test/dart.js"></script>
+ </head>
+</html>
diff --git a/pkgs/test/lib/src/runner/browser/static/favicon.ico b/pkgs/test/lib/src/runner/browser/static/favicon.ico
new file mode 100644
index 0000000..7ba349b
--- /dev/null
+++ b/pkgs/test/lib/src/runner/browser/static/favicon.ico
Binary files differ
diff --git a/pkgs/test/lib/src/runner/browser/static/host.css b/pkgs/test/lib/src/runner/browser/static/host.css
new file mode 100644
index 0000000..b8e0352
--- /dev/null
+++ b/pkgs/test/lib/src/runner/browser/static/host.css
@@ -0,0 +1,316 @@
+/* Copyright (c) 2015, 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. */
+
+iframe {
+ /* We would use display: none here, but then Firefox fails to properly compute
+ * styles. See #274 */
+ visibility: hidden;
+ width: 1024px;
+ height: 768px;
+}
+
+#play {
+ display: none;
+ cursor: pointer;
+}
+
+#dark {
+ display: none;
+}
+
+.paused #play {
+ display: block;
+ z-index: 1;
+}
+
+.paused #dark {
+ display: block;
+ position: absolute;
+ width: 100%;
+ height: 100%;
+ top: 0;
+ right: 0;
+ background-color: rgba(0, 0, 0, 0.5);
+}
+
+.paused #right-flank, .paused #right-ear, .paused #right-paw,
+.paused #left-flank, .paused #left-ear, .paused #left-paw {
+ -webkit-animation-play-state: paused;
+ animation-play-state: paused;
+}
+
+.debug body {
+ margin: 0;
+ padding: 0;
+}
+
+.debug iframe {
+ visibility: visible;
+ border: none;
+ position: absolute;
+ top: 0;
+ left: 0;
+ width: 100%;
+ height: 100%;
+}
+
+/* Compiled output from
+ * http://codepen.io/mknadler/pen/11b75cb014a3c382f54abf527655af21. */
+
+svg {
+ position: absolute;
+ margin: auto;
+ left: 0;
+ right: 0;
+ bottom: 0;
+ top: 0;
+}
+
+#right-flank {
+ fill: #0074C1;
+ stroke-color: #0074C1;
+ -webkit-animation: right-flank 8s ease infinite alternate;
+ animation: right-flank 8s ease infinite alternate;
+}
+
+#right-ear {
+ fill: #00B5AB;
+ stroke-color: #00B5AB;
+ -webkit-animation: right-ear 8s ease-in infinite alternate;
+ animation: right-ear 8s ease-in infinite alternate;
+}
+
+#right-paw {
+ fill: #00A6E4;
+ stroke-color: #00A6E4;
+ -webkit-animation: right-paw 8s ease-out infinite alternate;
+ animation: right-paw 8s ease-out infinite alternate;
+}
+
+#left-flank {
+ fill: #00B5AB;
+ stroke-color: #00B5AB;
+ -webkit-animation: left-flank 8s ease-in-out infinite alternate;
+ animation: left-flank 8s ease-in-out infinite alternate;
+}
+
+#left-ear {
+ fill: #0074C1;
+ stroke-color: #0074C1;
+ -webkit-animation: left-ear 8s linear infinite alternate;
+ animation: left-ear 8s linear infinite alternate;
+}
+
+#left-paw {
+ fill: #41C1BC;
+ stroke-color: #41C1BC;
+ -webkit-animation: left-paw 8s ease infinite alternate;
+ animation: left-paw 8s ease infinite alternate;
+}
+
+@-webkit-keyframes left-ear {
+ 20% {
+ -webkit-transform: translate(250px, 150px) rotateY(180deg) scale(0.6);
+ transform: translate(250px, 150px) rotateY(180deg) scale(0.6);
+ fill: #00A6E4;
+ }
+ 50% {
+ -webkit-transform: translate(100px, 75px) rotateY(80deg) scale(1.1);
+ transform: translate(100px, 75px) rotateY(80deg) scale(1.1);
+ fill: #41C1BC;
+ }
+ 80% {
+ -webkit-transform: translate(0px, 0px) scale(1);
+ transform: translate(0px, 0px) scale(1);
+ fill: #0074C1;
+ }
+}
+
+@keyframes left-ear {
+ 20% {
+ -webkit-transform: translate(250px, 150px) rotateY(180deg) scale(0.6);
+ transform: translate(250px, 150px) rotateY(180deg) scale(0.6);
+ fill: #00A6E4;
+ }
+ 50% {
+ -webkit-transform: translate(100px, 75px) rotateY(80deg) scale(1.1);
+ transform: translate(100px, 75px) rotateY(80deg) scale(1.1);
+ fill: #41C1BC;
+ }
+ 80% {
+ -webkit-transform: translate(0px, 0px) scale(1);
+ transform: translate(0px, 0px) scale(1);
+ fill: #0074C1;
+ }
+}
+@-webkit-keyframes right-ear {
+ 20% {
+ -webkit-transform: translate(200px, 250px) rotateX(180deg) scale(0.6);
+ transform: translate(200px, 250px) rotateX(180deg) scale(0.6);
+ fill: #41C1BC;
+ }
+ 50% {
+ -webkit-transform: translate(75px, 100px) rotateX(80deg) scale(1.1);
+ transform: translate(75px, 100px) rotateX(80deg) scale(1.1);
+ fill: #00A6E4;
+ }
+ 80% {
+ -webkit-transform: translate(0px, 0px) scale(1);
+ transform: translate(0px, 0px) scale(1);
+ fill: #00B5AB;
+ }
+}
+@keyframes right-ear {
+ 20% {
+ -webkit-transform: translate(200px, 250px) rotateX(180deg) scale(0.6);
+ transform: translate(200px, 250px) rotateX(180deg) scale(0.6);
+ fill: #41C1BC;
+ }
+ 50% {
+ -webkit-transform: translate(75px, 100px) rotateX(80deg) scale(1.1);
+ transform: translate(75px, 100px) rotateX(80deg) scale(1.1);
+ fill: #00A6E4;
+ }
+ 80% {
+ -webkit-transform: translate(0px, 0px) scale(1);
+ transform: translate(0px, 0px) scale(1);
+ fill: #00B5AB;
+ }
+}
+@-webkit-keyframes left-paw {
+ 20% {
+ -webkit-transform: translate(200px, 200px) rotate3d(-1, 0, 0.5, 60deg) scale(0.6);
+ transform: translate(200px, 200px) rotate3d(-1, 0, 0.5, 60deg) scale(0.6);
+ fill: #00B5AB;
+ }
+ 50% {
+ -webkit-transform: translate(150px, 250px) rotate3d(-1, 0, 0.5, 90deg) scale(0.6);
+ transform: translate(150px, 250px) rotate3d(-1, 0, 0.5, 90deg) scale(0.6);
+ fill: #00B5AB;
+ }
+ 80% {
+ -webkit-transform: translate(0px, 0px) scale(1);
+ transform: translate(0px, 0px) scale(1);
+ fill: #41C1BC;
+ }
+}
+@keyframes left-paw {
+ 20% {
+ -webkit-transform: translate(200px, 200px) rotate3d(-1, 0, 0.5, 60deg) scale(0.6);
+ transform: translate(200px, 200px) rotate3d(-1, 0, 0.5, 60deg) scale(0.6);
+ fill: #00B5AB;
+ }
+ 50% {
+ -webkit-transform: translate(150px, 250px) rotate3d(-1, 0, 0.5, 90deg) scale(0.6);
+ transform: translate(150px, 250px) rotate3d(-1, 0, 0.5, 90deg) scale(0.6);
+ fill: #00B5AB;
+ }
+ 80% {
+ -webkit-transform: translate(0px, 0px) scale(1);
+ transform: translate(0px, 0px) scale(1);
+ fill: #41C1BC;
+ }
+}
+@-webkit-keyframes right-paw {
+ 20% {
+ -webkit-transform: translate(200px, 200px) rotate3d(-1, 0, 0.5, -60deg) scale(0.6);
+ transform: translate(200px, 200px) rotate3d(-1, 0, 0.5, -60deg) scale(0.6);
+ fill: #41C1BC;
+ }
+ 50% {
+ -webkit-transform: translate(100px, 250px) rotate3d(-1, 0, 0.5, -90deg) scale(0.6);
+ transform: translate(100px, 250px) rotate3d(-1, 0, 0.5, -90deg) scale(0.6);
+ fill: #41C1BC;
+ }
+ 80% {
+ -webkit-transform: translate(0px, 0px) scale(1);
+ transform: translate(0px, 0px) scale(1);
+ fill: #00A6E4;
+ }
+}
+@keyframes right-paw {
+ 20% {
+ -webkit-transform: translate(200px, 200px) rotate3d(-1, 0, 0.5, -60deg) scale(0.6);
+ transform: translate(200px, 200px) rotate3d(-1, 0, 0.5, -60deg) scale(0.6);
+ fill: #41C1BC;
+ }
+ 50% {
+ -webkit-transform: translate(100px, 250px) rotate3d(-1, 0, 0.5, -90deg) scale(0.6);
+ transform: translate(100px, 250px) rotate3d(-1, 0, 0.5, -90deg) scale(0.6);
+ fill: #41C1BC;
+ }
+ 80% {
+ -webkit-transform: translate(0px, 0px) scale(1);
+ transform: translate(0px, 0px) scale(1);
+ fill: #00A6E4;
+ }
+}
+@-webkit-keyframes left-flank {
+ 20% {
+ -webkit-transform: translate(0px, 100px) scale(0.6);
+ transform: translate(0px, 100px) scale(0.6);
+ fill: #00A6E4;
+ }
+ 50% {
+ -webkit-transform: translate(0px, 100px) scale(0.4);
+ transform: translate(0px, 100px) scale(0.4);
+ fill: #00A6E4;
+ }
+ 80% {
+ -webkit-transform: translate(0px, 0px) scale(1);
+ transform: translate(0px, 0px) scale(1);
+ fill: #00B5AB;
+ }
+}
+@keyframes left-flank {
+ 20% {
+ -webkit-transform: translate(0px, 100px) scale(0.6);
+ transform: translate(0px, 100px) scale(0.6);
+ fill: #00A6E4;
+ }
+ 50% {
+ -webkit-transform: translate(0px, 100px) scale(0.4);
+ transform: translate(0px, 100px) scale(0.4);
+ fill: #00A6E4;
+ }
+ 80% {
+ -webkit-transform: translate(0px, 0px) scale(1);
+ transform: translate(0px, 0px) scale(1);
+ fill: #00B5AB;
+ }
+}
+@-webkit-keyframes right-flank {
+ 20% {
+ -webkit-transform: translate(100px, -25px) scale(0.6);
+ transform: translate(100px, -25px) scale(0.6);
+ fill: #41C1BC;
+ }
+ 50% {
+ -webkit-transform: translate(110px, 0px) scale(0.4);
+ transform: translate(110px, 0px) scale(0.4);
+ fill: #00A6E4;
+ }
+ 80% {
+ -webkit-transform: translate(0px, 0px) scale(1);
+ transform: translate(0px, 0px) scale(1);
+ fill: #0074C1;
+ }
+}
+@keyframes right-flank {
+ 20% {
+ -webkit-transform: translate(100px, -25px) scale(0.6);
+ transform: translate(100px, -25px) scale(0.6);
+ fill: #41C1BC;
+ }
+ 50% {
+ -webkit-transform: translate(110px, 0px) scale(0.4);
+ transform: translate(110px, 0px) scale(0.4);
+ fill: #00A6E4;
+ }
+ 80% {
+ -webkit-transform: translate(0px, 0px) scale(1);
+ transform: translate(0px, 0px) scale(1);
+ fill: #0074C1;
+ }
+}
diff --git a/pkgs/test/lib/src/runner/browser/static/host.dart.js b/pkgs/test/lib/src/runner/browser/static/host.dart.js
new file mode 100644
index 0000000..fd3ef38
--- /dev/null
+++ b/pkgs/test/lib/src/runner/browser/static/host.dart.js
@@ -0,0 +1,18333 @@
+// Generated by dart2js (NullSafetyMode.sound, csp, intern-composite-values), the Dart to JavaScript compiler version: 3.2.0-228.0.dev.
+// The code supports the following hooks:
+// dartPrint(message):
+// if this function is defined it is called instead of the Dart [print]
+// method.
+//
+// dartMainRunner(main, args):
+// if this function is defined, the Dart [main] method will not be invoked
+// directly. Instead, a closure that will invoke [main], and its arguments
+// [args] is passed to [dartMainRunner].
+//
+// dartDeferredLibraryLoader(uri, successCallback, errorCallback, loadId, loadPriority):
+// if this function is defined, it will be called when a deferred library
+// is loaded. It should load and eval the javascript of `uri`, and call
+// successCallback. If it fails to do so, it should call errorCallback with
+// an error. The loadId argument is the deferred import that resulted in
+// this uri being loaded. The loadPriority argument is the priority the
+// library should be loaded with as specified in the code via the
+// load-priority annotation (0: normal, 1: high).
+//
+// dartCallInstrumentation(id, qualifiedName):
+// if this function is defined, it will be called at each entry of a
+// method or constructor. Used only when compiling programs with
+// --experiment-call-instrumentation.
+(function dartProgram() {
+ function copyProperties(from, to) {
+ var keys = Object.keys(from);
+ for (var i = 0; i < keys.length; i++) {
+ var key = keys[i];
+ to[key] = from[key];
+ }
+ }
+ function mixinPropertiesHard(from, to) {
+ var keys = Object.keys(from);
+ for (var i = 0; i < keys.length; i++) {
+ var key = keys[i];
+ if (!to.hasOwnProperty(key))
+ to[key] = from[key];
+ }
+ }
+ function mixinPropertiesEasy(from, to) {
+ Object.assign(to, from);
+ }
+ var supportsDirectProtoAccess = function() {
+ var cls = function() {
+ };
+ cls.prototype = {p: {}};
+ var object = new cls();
+ if (!(Object.getPrototypeOf(object) && Object.getPrototypeOf(object).p === cls.prototype.p))
+ return false;
+ try {
+ if (typeof navigator != "undefined" && typeof navigator.userAgent == "string" && navigator.userAgent.indexOf("Chrome/") >= 0)
+ return true;
+ if (typeof version == "function" && version.length == 0) {
+ var v = version();
+ if (/^\d+\.\d+\.\d+\.\d+$/.test(v))
+ return true;
+ }
+ } catch (_) {
+ }
+ return false;
+ }();
+ function inherit(cls, sup) {
+ cls.prototype.constructor = cls;
+ cls.prototype["$is" + cls.name] = cls;
+ if (sup != null) {
+ if (supportsDirectProtoAccess) {
+ Object.setPrototypeOf(cls.prototype, sup.prototype);
+ return;
+ }
+ var clsPrototype = Object.create(sup.prototype);
+ copyProperties(cls.prototype, clsPrototype);
+ cls.prototype = clsPrototype;
+ }
+ }
+ function inheritMany(sup, classes) {
+ for (var i = 0; i < classes.length; i++)
+ inherit(classes[i], sup);
+ }
+ function mixinEasy(cls, mixin) {
+ mixinPropertiesEasy(mixin.prototype, cls.prototype);
+ cls.prototype.constructor = cls;
+ }
+ function mixinHard(cls, mixin) {
+ mixinPropertiesHard(mixin.prototype, cls.prototype);
+ cls.prototype.constructor = cls;
+ }
+ function lazyOld(holder, name, getterName, initializer) {
+ var uninitializedSentinel = holder;
+ holder[name] = uninitializedSentinel;
+ holder[getterName] = function() {
+ holder[getterName] = function() {
+ A.throwCyclicInit(name);
+ };
+ var result;
+ var sentinelInProgress = initializer;
+ try {
+ if (holder[name] === uninitializedSentinel) {
+ result = holder[name] = sentinelInProgress;
+ result = holder[name] = initializer();
+ } else
+ result = holder[name];
+ } finally {
+ if (result === sentinelInProgress)
+ holder[name] = null;
+ holder[getterName] = function() {
+ return this[name];
+ };
+ }
+ return result;
+ };
+ }
+ function lazy(holder, name, getterName, initializer) {
+ var uninitializedSentinel = holder;
+ holder[name] = uninitializedSentinel;
+ holder[getterName] = function() {
+ if (holder[name] === uninitializedSentinel)
+ holder[name] = initializer();
+ holder[getterName] = function() {
+ return this[name];
+ };
+ return holder[name];
+ };
+ }
+ function lazyFinal(holder, name, getterName, initializer) {
+ var uninitializedSentinel = holder;
+ holder[name] = uninitializedSentinel;
+ holder[getterName] = function() {
+ if (holder[name] === uninitializedSentinel) {
+ var value = initializer();
+ if (holder[name] !== uninitializedSentinel)
+ A.throwLateFieldADI(name);
+ holder[name] = value;
+ }
+ var finalValue = holder[name];
+ holder[getterName] = function() {
+ return finalValue;
+ };
+ return finalValue;
+ };
+ }
+ function makeConstList(list) {
+ list.immutable$list = Array;
+ list.fixed$length = Array;
+ return list;
+ }
+ function convertToFastObject(properties) {
+ function t() {
+ }
+ t.prototype = properties;
+ new t();
+ return properties;
+ }
+ function convertAllToFastObject(arrayOfObjects) {
+ for (var i = 0; i < arrayOfObjects.length; ++i)
+ convertToFastObject(arrayOfObjects[i]);
+ }
+ var functionCounter = 0;
+ function instanceTearOffGetter(isIntercepted, parameters) {
+ var cache = null;
+ return isIntercepted ? function(receiver) {
+ if (cache === null)
+ cache = A.closureFromTearOff(parameters);
+ return new cache(receiver, this);
+ } : function() {
+ if (cache === null)
+ cache = A.closureFromTearOff(parameters);
+ return new cache(this, null);
+ };
+ }
+ function staticTearOffGetter(parameters) {
+ var cache = null;
+ return function() {
+ if (cache === null)
+ cache = A.closureFromTearOff(parameters).prototype;
+ return cache;
+ };
+ }
+ var typesOffset = 0;
+ function tearOffParameters(container, isStatic, isIntercepted, requiredParameterCount, optionalParameterDefaultValues, callNames, funsOrNames, funType, applyIndex, needsDirectAccess) {
+ if (typeof funType == "number")
+ funType += typesOffset;
+ return {co: container, iS: isStatic, iI: isIntercepted, rC: requiredParameterCount, dV: optionalParameterDefaultValues, cs: callNames, fs: funsOrNames, fT: funType, aI: applyIndex || 0, nDA: needsDirectAccess};
+ }
+ function installStaticTearOff(holder, getterName, requiredParameterCount, optionalParameterDefaultValues, callNames, funsOrNames, funType, applyIndex) {
+ var parameters = tearOffParameters(holder, true, false, requiredParameterCount, optionalParameterDefaultValues, callNames, funsOrNames, funType, applyIndex, false);
+ var getterFunction = staticTearOffGetter(parameters);
+ holder[getterName] = getterFunction;
+ }
+ function installInstanceTearOff(prototype, getterName, isIntercepted, requiredParameterCount, optionalParameterDefaultValues, callNames, funsOrNames, funType, applyIndex, needsDirectAccess) {
+ isIntercepted = !!isIntercepted;
+ var parameters = tearOffParameters(prototype, false, isIntercepted, requiredParameterCount, optionalParameterDefaultValues, callNames, funsOrNames, funType, applyIndex, !!needsDirectAccess);
+ var getterFunction = instanceTearOffGetter(isIntercepted, parameters);
+ prototype[getterName] = getterFunction;
+ }
+ function setOrUpdateInterceptorsByTag(newTags) {
+ var tags = init.interceptorsByTag;
+ if (!tags) {
+ init.interceptorsByTag = newTags;
+ return;
+ }
+ copyProperties(newTags, tags);
+ }
+ function setOrUpdateLeafTags(newTags) {
+ var tags = init.leafTags;
+ if (!tags) {
+ init.leafTags = newTags;
+ return;
+ }
+ copyProperties(newTags, tags);
+ }
+ function updateTypes(newTypes) {
+ var types = init.types;
+ var length = types.length;
+ types.push.apply(types, newTypes);
+ return length;
+ }
+ function updateHolder(holder, newHolder) {
+ copyProperties(newHolder, holder);
+ return holder;
+ }
+ var hunkHelpers = function() {
+ var mkInstance = function(isIntercepted, requiredParameterCount, optionalParameterDefaultValues, callNames, applyIndex) {
+ return function(container, getterName, name, funType) {
+ return installInstanceTearOff(container, getterName, isIntercepted, requiredParameterCount, optionalParameterDefaultValues, callNames, [name], funType, applyIndex, false);
+ };
+ },
+ mkStatic = function(requiredParameterCount, optionalParameterDefaultValues, callNames, applyIndex) {
+ return function(container, getterName, name, funType) {
+ return installStaticTearOff(container, getterName, requiredParameterCount, optionalParameterDefaultValues, callNames, [name], funType, applyIndex);
+ };
+ };
+ return {inherit: inherit, inheritMany: inheritMany, mixin: mixinEasy, mixinHard: mixinHard, installStaticTearOff: installStaticTearOff, installInstanceTearOff: installInstanceTearOff, _instance_0u: mkInstance(0, 0, null, ["call$0"], 0), _instance_1u: mkInstance(0, 1, null, ["call$1"], 0), _instance_2u: mkInstance(0, 2, null, ["call$2"], 0), _instance_0i: mkInstance(1, 0, null, ["call$0"], 0), _instance_1i: mkInstance(1, 1, null, ["call$1"], 0), _instance_2i: mkInstance(1, 2, null, ["call$2"], 0), _static_0: mkStatic(0, null, ["call$0"], 0), _static_1: mkStatic(1, null, ["call$1"], 0), _static_2: mkStatic(2, null, ["call$2"], 0), makeConstList: makeConstList, lazy: lazy, lazyFinal: lazyFinal, lazyOld: lazyOld, updateHolder: updateHolder, convertToFastObject: convertToFastObject, updateTypes: updateTypes, setOrUpdateInterceptorsByTag: setOrUpdateInterceptorsByTag, setOrUpdateLeafTags: setOrUpdateLeafTags};
+ }();
+ function initializeDeferredHunk(hunk) {
+ typesOffset = init.types.length;
+ hunk(hunkHelpers, init, holders, $);
+ }
+ var J = {
+ makeDispatchRecord(interceptor, proto, extension, indexability) {
+ return {i: interceptor, p: proto, e: extension, x: indexability};
+ },
+ getNativeInterceptor(object) {
+ var proto, objectProto, $constructor, interceptor, t1,
+ record = object[init.dispatchPropertyName];
+ if (record == null)
+ if ($.initNativeDispatchFlag == null) {
+ A.initNativeDispatch();
+ record = object[init.dispatchPropertyName];
+ }
+ if (record != null) {
+ proto = record.p;
+ if (false === proto)
+ return record.i;
+ if (true === proto)
+ return object;
+ objectProto = Object.getPrototypeOf(object);
+ if (proto === objectProto)
+ return record.i;
+ if (record.e === objectProto)
+ throw A.wrapException(A.UnimplementedError$("Return interceptor for " + A.S(proto(object, record))));
+ }
+ $constructor = object.constructor;
+ if ($constructor == null)
+ interceptor = null;
+ else {
+ t1 = $._JS_INTEROP_INTERCEPTOR_TAG;
+ if (t1 == null)
+ t1 = $._JS_INTEROP_INTERCEPTOR_TAG = init.getIsolateTag("_$dart_js");
+ interceptor = $constructor[t1];
+ }
+ if (interceptor != null)
+ return interceptor;
+ interceptor = A.lookupAndCacheInterceptor(object);
+ if (interceptor != null)
+ return interceptor;
+ if (typeof object == "function")
+ return B.JavaScriptFunction_methods;
+ proto = Object.getPrototypeOf(object);
+ if (proto == null)
+ return B.PlainJavaScriptObject_methods;
+ if (proto === Object.prototype)
+ return B.PlainJavaScriptObject_methods;
+ if (typeof $constructor == "function") {
+ t1 = $._JS_INTEROP_INTERCEPTOR_TAG;
+ if (t1 == null)
+ t1 = $._JS_INTEROP_INTERCEPTOR_TAG = init.getIsolateTag("_$dart_js");
+ Object.defineProperty($constructor, t1, {value: B.UnknownJavaScriptObject_methods, enumerable: false, writable: true, configurable: true});
+ return B.UnknownJavaScriptObject_methods;
+ }
+ return B.UnknownJavaScriptObject_methods;
+ },
+ JSArray_JSArray$fixed($length, $E) {
+ if ($length < 0 || $length > 4294967295)
+ throw A.wrapException(A.RangeError$range($length, 0, 4294967295, "length", null));
+ return J.JSArray_JSArray$markFixed(new Array($length), $E);
+ },
+ JSArray_JSArray$growable($length, $E) {
+ if ($length < 0)
+ throw A.wrapException(A.ArgumentError$("Length must be a non-negative integer: " + $length, null));
+ return A._setArrayType(new Array($length), $E._eval$1("JSArray<0>"));
+ },
+ JSArray_JSArray$markFixed(allocation, $E) {
+ return J.JSArray_markFixedList(A._setArrayType(allocation, $E._eval$1("JSArray<0>")), $E);
+ },
+ JSArray_markFixedList(list, $T) {
+ list.fixed$length = Array;
+ return list;
+ },
+ JSArray_markUnmodifiableList(list) {
+ list.fixed$length = Array;
+ list.immutable$list = Array;
+ return list;
+ },
+ JSString__isWhitespace(codeUnit) {
+ if (codeUnit < 256)
+ switch (codeUnit) {
+ case 9:
+ case 10:
+ case 11:
+ case 12:
+ case 13:
+ case 32:
+ case 133:
+ case 160:
+ return true;
+ default:
+ return false;
+ }
+ switch (codeUnit) {
+ case 5760:
+ case 8192:
+ case 8193:
+ case 8194:
+ case 8195:
+ case 8196:
+ case 8197:
+ case 8198:
+ case 8199:
+ case 8200:
+ case 8201:
+ case 8202:
+ case 8232:
+ case 8233:
+ case 8239:
+ case 8287:
+ case 12288:
+ case 65279:
+ return true;
+ default:
+ return false;
+ }
+ },
+ JSString__skipLeadingWhitespace(string, index) {
+ var t1, codeUnit;
+ for (t1 = string.length; index < t1;) {
+ codeUnit = string.charCodeAt(index);
+ if (codeUnit !== 32 && codeUnit !== 13 && !J.JSString__isWhitespace(codeUnit))
+ break;
+ ++index;
+ }
+ return index;
+ },
+ JSString__skipTrailingWhitespace(string, index) {
+ var t1, index0, codeUnit;
+ for (t1 = string.length; index > 0; index = index0) {
+ index0 = index - 1;
+ if (!(index0 < t1))
+ return A.ioore(string, index0);
+ codeUnit = string.charCodeAt(index0);
+ if (codeUnit !== 32 && codeUnit !== 13 && !J.JSString__isWhitespace(codeUnit))
+ break;
+ }
+ return index;
+ },
+ getInterceptor$(receiver) {
+ if (typeof receiver == "number") {
+ if (Math.floor(receiver) == receiver)
+ return J.JSInt.prototype;
+ return J.JSNumNotInt.prototype;
+ }
+ if (typeof receiver == "string")
+ return J.JSString.prototype;
+ if (receiver == null)
+ return J.JSNull.prototype;
+ if (typeof receiver == "boolean")
+ return J.JSBool.prototype;
+ if (Array.isArray(receiver))
+ return J.JSArray.prototype;
+ if (typeof receiver != "object") {
+ if (typeof receiver == "function")
+ return J.JavaScriptFunction.prototype;
+ if (typeof receiver == "symbol")
+ return J.JavaScriptSymbol.prototype;
+ if (typeof receiver == "bigint")
+ return J.JavaScriptBigInt.prototype;
+ return receiver;
+ }
+ if (receiver instanceof A.Object)
+ return receiver;
+ return J.getNativeInterceptor(receiver);
+ },
+ getInterceptor$asx(receiver) {
+ if (typeof receiver == "string")
+ return J.JSString.prototype;
+ if (receiver == null)
+ return receiver;
+ if (Array.isArray(receiver))
+ return J.JSArray.prototype;
+ if (typeof receiver != "object") {
+ if (typeof receiver == "function")
+ return J.JavaScriptFunction.prototype;
+ if (typeof receiver == "symbol")
+ return J.JavaScriptSymbol.prototype;
+ if (typeof receiver == "bigint")
+ return J.JavaScriptBigInt.prototype;
+ return receiver;
+ }
+ if (receiver instanceof A.Object)
+ return receiver;
+ return J.getNativeInterceptor(receiver);
+ },
+ getInterceptor$ax(receiver) {
+ if (receiver == null)
+ return receiver;
+ if (Array.isArray(receiver))
+ return J.JSArray.prototype;
+ if (typeof receiver != "object") {
+ if (typeof receiver == "function")
+ return J.JavaScriptFunction.prototype;
+ if (typeof receiver == "symbol")
+ return J.JavaScriptSymbol.prototype;
+ if (typeof receiver == "bigint")
+ return J.JavaScriptBigInt.prototype;
+ return receiver;
+ }
+ if (receiver instanceof A.Object)
+ return receiver;
+ return J.getNativeInterceptor(receiver);
+ },
+ getInterceptor$n(receiver) {
+ if (typeof receiver == "number")
+ return J.JSNumber.prototype;
+ if (receiver == null)
+ return receiver;
+ if (!(receiver instanceof A.Object))
+ return J.UnknownJavaScriptObject.prototype;
+ return receiver;
+ },
+ getInterceptor$s(receiver) {
+ if (typeof receiver == "string")
+ return J.JSString.prototype;
+ if (receiver == null)
+ return receiver;
+ if (!(receiver instanceof A.Object))
+ return J.UnknownJavaScriptObject.prototype;
+ return receiver;
+ },
+ getInterceptor$x(receiver) {
+ if (receiver == null)
+ return receiver;
+ if (typeof receiver != "object") {
+ if (typeof receiver == "function")
+ return J.JavaScriptFunction.prototype;
+ if (typeof receiver == "symbol")
+ return J.JavaScriptSymbol.prototype;
+ if (typeof receiver == "bigint")
+ return J.JavaScriptBigInt.prototype;
+ return receiver;
+ }
+ if (receiver instanceof A.Object)
+ return receiver;
+ return J.getNativeInterceptor(receiver);
+ },
+ getInterceptor$z(receiver) {
+ if (receiver == null)
+ return receiver;
+ if (!(receiver instanceof A.Object))
+ return J.UnknownJavaScriptObject.prototype;
+ return receiver;
+ },
+ get$hashCode$(receiver) {
+ return J.getInterceptor$(receiver).get$hashCode(receiver);
+ },
+ get$isEmpty$asx(receiver) {
+ return J.getInterceptor$asx(receiver).get$isEmpty(receiver);
+ },
+ get$isNotEmpty$asx(receiver) {
+ return J.getInterceptor$asx(receiver).get$isNotEmpty(receiver);
+ },
+ get$iterator$ax(receiver) {
+ return J.getInterceptor$ax(receiver).get$iterator(receiver);
+ },
+ get$keys$x(receiver) {
+ return J.getInterceptor$x(receiver).get$keys(receiver);
+ },
+ get$length$asx(receiver) {
+ return J.getInterceptor$asx(receiver).get$length(receiver);
+ },
+ get$parent$z(receiver) {
+ return J.getInterceptor$z(receiver).get$parent(receiver);
+ },
+ get$runtimeType$(receiver) {
+ return J.getInterceptor$(receiver).get$runtimeType(receiver);
+ },
+ $eq$(receiver, a0) {
+ if (receiver == null)
+ return a0 == null;
+ if (typeof receiver != "object")
+ return a0 != null && receiver === a0;
+ return J.getInterceptor$(receiver).$eq(receiver, a0);
+ },
+ $index$asx(receiver, a0) {
+ if (typeof a0 === "number")
+ if (Array.isArray(receiver) || typeof receiver == "string" || A.isJsIndexable(receiver, receiver[init.dispatchPropertyName]))
+ if (a0 >>> 0 === a0 && a0 < receiver.length)
+ return receiver[a0];
+ return J.getInterceptor$asx(receiver).$index(receiver, a0);
+ },
+ $indexSet$ax(receiver, a0, a1) {
+ return J.getInterceptor$ax(receiver).$indexSet(receiver, a0, a1);
+ },
+ allMatches$1$s(receiver, a0) {
+ return J.getInterceptor$s(receiver).allMatches$1(receiver, a0);
+ },
+ allMatches$2$s(receiver, a0, a1) {
+ return J.getInterceptor$s(receiver).allMatches$2(receiver, a0, a1);
+ },
+ cancel$0$z(receiver) {
+ return J.getInterceptor$z(receiver).cancel$0(receiver);
+ },
+ cast$1$0$ax(receiver, $T1) {
+ return J.getInterceptor$ax(receiver).cast$1$0(receiver, $T1);
+ },
+ codeUnitAt$1$s(receiver, a0) {
+ return J.getInterceptor$s(receiver).codeUnitAt$1(receiver, a0);
+ },
+ contains$1$asx(receiver, a0) {
+ return J.getInterceptor$asx(receiver).contains$1(receiver, a0);
+ },
+ containsKey$1$x(receiver, a0) {
+ return J.getInterceptor$x(receiver).containsKey$1(receiver, a0);
+ },
+ elementAt$1$ax(receiver, a0) {
+ return J.getInterceptor$ax(receiver).elementAt$1(receiver, a0);
+ },
+ endsWith$1$s(receiver, a0) {
+ return J.getInterceptor$s(receiver).endsWith$1(receiver, a0);
+ },
+ forEach$1$x(receiver, a0) {
+ return J.getInterceptor$x(receiver).forEach$1(receiver, a0);
+ },
+ map$1$1$ax(receiver, a0, $T1) {
+ return J.getInterceptor$ax(receiver).map$1$1(receiver, a0, $T1);
+ },
+ matchAsPrefix$2$s(receiver, a0, a1) {
+ return J.getInterceptor$s(receiver).matchAsPrefix$2(receiver, a0, a1);
+ },
+ noSuchMethod$1$(receiver, a0) {
+ return J.getInterceptor$(receiver).noSuchMethod$1(receiver, a0);
+ },
+ skip$1$ax(receiver, a0) {
+ return J.getInterceptor$ax(receiver).skip$1(receiver, a0);
+ },
+ toInt$0$n(receiver) {
+ return J.getInterceptor$n(receiver).toInt$0(receiver);
+ },
+ toList$0$ax(receiver) {
+ return J.getInterceptor$ax(receiver).toList$0(receiver);
+ },
+ toString$0$(receiver) {
+ return J.getInterceptor$(receiver).toString$0(receiver);
+ },
+ Interceptor: function Interceptor() {
+ },
+ JSBool: function JSBool() {
+ },
+ JSNull: function JSNull() {
+ },
+ JavaScriptObject: function JavaScriptObject() {
+ },
+ LegacyJavaScriptObject: function LegacyJavaScriptObject() {
+ },
+ PlainJavaScriptObject: function PlainJavaScriptObject() {
+ },
+ UnknownJavaScriptObject: function UnknownJavaScriptObject() {
+ },
+ JavaScriptFunction: function JavaScriptFunction() {
+ },
+ JavaScriptBigInt: function JavaScriptBigInt() {
+ },
+ JavaScriptSymbol: function JavaScriptSymbol() {
+ },
+ JSArray: function JSArray(t0) {
+ this.$ti = t0;
+ },
+ JSUnmodifiableArray: function JSUnmodifiableArray(t0) {
+ this.$ti = t0;
+ },
+ ArrayIterator: function ArrayIterator(t0, t1, t2) {
+ var _ = this;
+ _._iterable = t0;
+ _.__interceptors$_length = t1;
+ _._index = 0;
+ _._current = null;
+ _.$ti = t2;
+ },
+ JSNumber: function JSNumber() {
+ },
+ JSInt: function JSInt() {
+ },
+ JSNumNotInt: function JSNumNotInt() {
+ },
+ JSString: function JSString() {
+ }
+ },
+ A = {JS_CONST: function JS_CONST() {
+ },
+ CastIterable_CastIterable(source, $S, $T) {
+ if ($S._eval$1("EfficientLengthIterable<0>")._is(source))
+ return new A._EfficientLengthCastIterable(source, $S._eval$1("@<0>")._bind$1($T)._eval$1("_EfficientLengthCastIterable<1,2>"));
+ return new A.CastIterable(source, $S._eval$1("@<0>")._bind$1($T)._eval$1("CastIterable<1,2>"));
+ },
+ hexDigitValue(char) {
+ var letter,
+ digit = char ^ 48;
+ if (digit <= 9)
+ return digit;
+ letter = char | 32;
+ if (97 <= letter && letter <= 102)
+ return letter - 87;
+ return -1;
+ },
+ SystemHash_combine(hash, value) {
+ hash = hash + value & 536870911;
+ hash = hash + ((hash & 524287) << 10) & 536870911;
+ return hash ^ hash >>> 6;
+ },
+ SystemHash_finish(hash) {
+ hash = hash + ((hash & 67108863) << 3) & 536870911;
+ hash ^= hash >>> 11;
+ return hash + ((hash & 16383) << 15) & 536870911;
+ },
+ checkNotNullable(value, $name, $T) {
+ return value;
+ },
+ isToStringVisiting(object) {
+ var t1, i;
+ for (t1 = $.toStringVisiting.length, i = 0; i < t1; ++i)
+ if (object === $.toStringVisiting[i])
+ return true;
+ return false;
+ },
+ SubListIterable$(_iterable, _start, _endOrLength, $E) {
+ A.RangeError_checkNotNegative(_start, "start");
+ if (_endOrLength != null) {
+ A.RangeError_checkNotNegative(_endOrLength, "end");
+ if (_start > _endOrLength)
+ A.throwExpression(A.RangeError$range(_start, 0, _endOrLength, "start", null));
+ }
+ return new A.SubListIterable(_iterable, _start, _endOrLength, $E._eval$1("SubListIterable<0>"));
+ },
+ MappedIterable_MappedIterable(iterable, $function, $S, $T) {
+ if (type$.EfficientLengthIterable_dynamic._is(iterable))
+ return new A.EfficientLengthMappedIterable(iterable, $function, $S._eval$1("@<0>")._bind$1($T)._eval$1("EfficientLengthMappedIterable<1,2>"));
+ return new A.MappedIterable(iterable, $function, $S._eval$1("@<0>")._bind$1($T)._eval$1("MappedIterable<1,2>"));
+ },
+ TakeIterable_TakeIterable(iterable, takeCount, $E) {
+ var _s9_ = "takeCount";
+ A.ArgumentError_checkNotNull(takeCount, _s9_, type$.int);
+ A.RangeError_checkNotNegative(takeCount, _s9_);
+ if (type$.EfficientLengthIterable_dynamic._is(iterable))
+ return new A.EfficientLengthTakeIterable(iterable, takeCount, $E._eval$1("EfficientLengthTakeIterable<0>"));
+ return new A.TakeIterable(iterable, takeCount, $E._eval$1("TakeIterable<0>"));
+ },
+ SkipIterable_SkipIterable(iterable, count, $E) {
+ var _s5_ = "count";
+ if (type$.EfficientLengthIterable_dynamic._is(iterable)) {
+ A.ArgumentError_checkNotNull(count, _s5_, type$.int);
+ A.RangeError_checkNotNegative(count, _s5_);
+ return new A.EfficientLengthSkipIterable(iterable, count, $E._eval$1("EfficientLengthSkipIterable<0>"));
+ }
+ A.ArgumentError_checkNotNull(count, _s5_, type$.int);
+ A.RangeError_checkNotNegative(count, _s5_);
+ return new A.SkipIterable(iterable, count, $E._eval$1("SkipIterable<0>"));
+ },
+ IterableElementError_noElement() {
+ return new A.StateError("No element");
+ },
+ IterableElementError_tooFew() {
+ return new A.StateError("Too few elements");
+ },
+ CastStream: function CastStream(t0, t1) {
+ this._source = t0;
+ this.$ti = t1;
+ },
+ CastStreamSubscription: function CastStreamSubscription(t0, t1, t2) {
+ var _ = this;
+ _._source = t0;
+ _.__internal$_zone = t1;
+ _._handleError = _._handleData = null;
+ _.$ti = t2;
+ },
+ _CastIterableBase: function _CastIterableBase() {
+ },
+ CastIterator: function CastIterator(t0, t1) {
+ this._source = t0;
+ this.$ti = t1;
+ },
+ CastIterable: function CastIterable(t0, t1) {
+ this._source = t0;
+ this.$ti = t1;
+ },
+ _EfficientLengthCastIterable: function _EfficientLengthCastIterable(t0, t1) {
+ this._source = t0;
+ this.$ti = t1;
+ },
+ _CastListBase: function _CastListBase() {
+ },
+ CastList: function CastList(t0, t1) {
+ this._source = t0;
+ this.$ti = t1;
+ },
+ LateError: function LateError(t0) {
+ this._message = t0;
+ },
+ CodeUnits: function CodeUnits(t0) {
+ this._string = t0;
+ },
+ nullFuture_closure: function nullFuture_closure() {
+ },
+ SentinelValue: function SentinelValue() {
+ },
+ EfficientLengthIterable: function EfficientLengthIterable() {
+ },
+ ListIterable: function ListIterable() {
+ },
+ SubListIterable: function SubListIterable(t0, t1, t2, t3) {
+ var _ = this;
+ _.__internal$_iterable = t0;
+ _._start = t1;
+ _._endOrLength = t2;
+ _.$ti = t3;
+ },
+ ListIterator: function ListIterator(t0, t1, t2) {
+ var _ = this;
+ _.__internal$_iterable = t0;
+ _.__internal$_length = t1;
+ _.__internal$_index = 0;
+ _.__internal$_current = null;
+ _.$ti = t2;
+ },
+ MappedIterable: function MappedIterable(t0, t1, t2) {
+ this.__internal$_iterable = t0;
+ this._f = t1;
+ this.$ti = t2;
+ },
+ EfficientLengthMappedIterable: function EfficientLengthMappedIterable(t0, t1, t2) {
+ this.__internal$_iterable = t0;
+ this._f = t1;
+ this.$ti = t2;
+ },
+ MappedIterator: function MappedIterator(t0, t1, t2) {
+ var _ = this;
+ _.__internal$_current = null;
+ _._iterator = t0;
+ _._f = t1;
+ _.$ti = t2;
+ },
+ MappedListIterable: function MappedListIterable(t0, t1, t2) {
+ this._source = t0;
+ this._f = t1;
+ this.$ti = t2;
+ },
+ WhereIterable: function WhereIterable(t0, t1, t2) {
+ this.__internal$_iterable = t0;
+ this._f = t1;
+ this.$ti = t2;
+ },
+ WhereIterator: function WhereIterator(t0, t1, t2) {
+ this._iterator = t0;
+ this._f = t1;
+ this.$ti = t2;
+ },
+ ExpandIterable: function ExpandIterable(t0, t1, t2) {
+ this.__internal$_iterable = t0;
+ this._f = t1;
+ this.$ti = t2;
+ },
+ ExpandIterator: function ExpandIterator(t0, t1, t2, t3) {
+ var _ = this;
+ _._iterator = t0;
+ _._f = t1;
+ _._currentExpansion = t2;
+ _.__internal$_current = null;
+ _.$ti = t3;
+ },
+ TakeIterable: function TakeIterable(t0, t1, t2) {
+ this.__internal$_iterable = t0;
+ this._takeCount = t1;
+ this.$ti = t2;
+ },
+ EfficientLengthTakeIterable: function EfficientLengthTakeIterable(t0, t1, t2) {
+ this.__internal$_iterable = t0;
+ this._takeCount = t1;
+ this.$ti = t2;
+ },
+ TakeIterator: function TakeIterator(t0, t1, t2) {
+ this._iterator = t0;
+ this._remaining = t1;
+ this.$ti = t2;
+ },
+ SkipIterable: function SkipIterable(t0, t1, t2) {
+ this.__internal$_iterable = t0;
+ this._skipCount = t1;
+ this.$ti = t2;
+ },
+ EfficientLengthSkipIterable: function EfficientLengthSkipIterable(t0, t1, t2) {
+ this.__internal$_iterable = t0;
+ this._skipCount = t1;
+ this.$ti = t2;
+ },
+ SkipIterator: function SkipIterator(t0, t1, t2) {
+ this._iterator = t0;
+ this._skipCount = t1;
+ this.$ti = t2;
+ },
+ SkipWhileIterable: function SkipWhileIterable(t0, t1, t2) {
+ this.__internal$_iterable = t0;
+ this._f = t1;
+ this.$ti = t2;
+ },
+ SkipWhileIterator: function SkipWhileIterator(t0, t1, t2) {
+ var _ = this;
+ _._iterator = t0;
+ _._f = t1;
+ _._hasSkipped = false;
+ _.$ti = t2;
+ },
+ EmptyIterable: function EmptyIterable(t0) {
+ this.$ti = t0;
+ },
+ EmptyIterator: function EmptyIterator(t0) {
+ this.$ti = t0;
+ },
+ WhereTypeIterable: function WhereTypeIterable(t0, t1) {
+ this._source = t0;
+ this.$ti = t1;
+ },
+ WhereTypeIterator: function WhereTypeIterator(t0, t1) {
+ this._source = t0;
+ this.$ti = t1;
+ },
+ FixedLengthListMixin: function FixedLengthListMixin() {
+ },
+ UnmodifiableListMixin: function UnmodifiableListMixin() {
+ },
+ UnmodifiableListBase: function UnmodifiableListBase() {
+ },
+ ReversedListIterable: function ReversedListIterable(t0, t1) {
+ this._source = t0;
+ this.$ti = t1;
+ },
+ Symbol: function Symbol(t0) {
+ this._name = t0;
+ },
+ __CastListBase__CastIterableBase_ListMixin: function __CastListBase__CastIterableBase_ListMixin() {
+ },
+ ConstantMap__throwUnmodifiable() {
+ throw A.wrapException(A.UnsupportedError$("Cannot modify unmodifiable Map"));
+ },
+ unminifyOrTag(rawClassName) {
+ var preserved = init.mangledGlobalNames[rawClassName];
+ if (preserved != null)
+ return preserved;
+ return rawClassName;
+ },
+ isJsIndexable(object, record) {
+ var result;
+ if (record != null) {
+ result = record.x;
+ if (result != null)
+ return result;
+ }
+ return type$.JavaScriptIndexingBehavior_dynamic._is(object);
+ },
+ S(value) {
+ var result;
+ if (typeof value == "string")
+ return value;
+ if (typeof value == "number") {
+ if (value !== 0)
+ return "" + value;
+ } else if (true === value)
+ return "true";
+ else if (false === value)
+ return "false";
+ else if (value == null)
+ return "null";
+ result = J.toString$0$(value);
+ return result;
+ },
+ Primitives_objectHashCode(object) {
+ var hash,
+ property = $.Primitives__identityHashCodeProperty;
+ if (property == null)
+ property = $.Primitives__identityHashCodeProperty = Symbol("identityHashCode");
+ hash = object[property];
+ if (hash == null) {
+ hash = Math.random() * 0x3fffffff | 0;
+ object[property] = hash;
+ }
+ return hash;
+ },
+ Primitives_parseInt(source, radix) {
+ var decimalMatch, maxCharCode, digitsPart, t1, i, _null = null,
+ match = /^\s*[+-]?((0x[a-f0-9]+)|(\d+)|([a-z0-9]+))\s*$/i.exec(source);
+ if (match == null)
+ return _null;
+ if (3 >= match.length)
+ return A.ioore(match, 3);
+ decimalMatch = match[3];
+ if (radix == null) {
+ if (decimalMatch != null)
+ return parseInt(source, 10);
+ if (match[2] != null)
+ return parseInt(source, 16);
+ return _null;
+ }
+ if (radix < 2 || radix > 36)
+ throw A.wrapException(A.RangeError$range(radix, 2, 36, "radix", _null));
+ if (radix === 10 && decimalMatch != null)
+ return parseInt(source, 10);
+ if (radix < 10 || decimalMatch == null) {
+ maxCharCode = radix <= 10 ? 47 + radix : 86 + radix;
+ digitsPart = match[1];
+ for (t1 = digitsPart.length, i = 0; i < t1; ++i)
+ if ((digitsPart.charCodeAt(i) | 32) > maxCharCode)
+ return _null;
+ }
+ return parseInt(source, radix);
+ },
+ Primitives_objectTypeName(object) {
+ return A.Primitives__objectTypeNameNewRti(object);
+ },
+ Primitives__objectTypeNameNewRti(object) {
+ var interceptor, dispatchName, $constructor, constructorName;
+ if (object instanceof A.Object)
+ return A._rtiToString(A.instanceType(object), null);
+ interceptor = J.getInterceptor$(object);
+ if (interceptor === B.Interceptor_methods || interceptor === B.JavaScriptObject_methods || type$.UnknownJavaScriptObject._is(object)) {
+ dispatchName = B.C_JS_CONST(object);
+ if (dispatchName !== "Object" && dispatchName !== "")
+ return dispatchName;
+ $constructor = object.constructor;
+ if (typeof $constructor == "function") {
+ constructorName = $constructor.name;
+ if (typeof constructorName == "string" && constructorName !== "Object" && constructorName !== "")
+ return constructorName;
+ }
+ }
+ return A._rtiToString(A.instanceType(object), null);
+ },
+ Primitives_safeToString(object) {
+ if (typeof object == "number" || A._isBool(object))
+ return J.toString$0$(object);
+ if (typeof object == "string")
+ return JSON.stringify(object);
+ if (object instanceof A.Closure)
+ return object.toString$0(0);
+ return "Instance of '" + A.Primitives_objectTypeName(object) + "'";
+ },
+ Primitives_currentUri() {
+ if (!!self.location)
+ return self.location.href;
+ return null;
+ },
+ Primitives__fromCharCodeApply(array) {
+ var result, i, i0, chunkEnd,
+ end = array.length;
+ if (end <= 500)
+ return String.fromCharCode.apply(null, array);
+ for (result = "", i = 0; i < end; i = i0) {
+ i0 = i + 500;
+ chunkEnd = i0 < end ? i0 : end;
+ result += String.fromCharCode.apply(null, array.slice(i, chunkEnd));
+ }
+ return result;
+ },
+ Primitives_stringFromCodePoints(codePoints) {
+ var t1, _i, i,
+ a = A._setArrayType([], type$.JSArray_int);
+ for (t1 = codePoints.length, _i = 0; _i < codePoints.length; codePoints.length === t1 || (0, A.throwConcurrentModificationError)(codePoints), ++_i) {
+ i = codePoints[_i];
+ if (!A._isInt(i))
+ throw A.wrapException(A.argumentErrorValue(i));
+ if (i <= 65535)
+ B.JSArray_methods.add$1(a, i);
+ else if (i <= 1114111) {
+ B.JSArray_methods.add$1(a, 55296 + (B.JSInt_methods._shrOtherPositive$1(i - 65536, 10) & 1023));
+ B.JSArray_methods.add$1(a, 56320 + (i & 1023));
+ } else
+ throw A.wrapException(A.argumentErrorValue(i));
+ }
+ return A.Primitives__fromCharCodeApply(a);
+ },
+ Primitives_stringFromCharCodes(charCodes) {
+ var t1, _i, i;
+ for (t1 = charCodes.length, _i = 0; _i < t1; ++_i) {
+ i = charCodes[_i];
+ if (!A._isInt(i))
+ throw A.wrapException(A.argumentErrorValue(i));
+ if (i < 0)
+ throw A.wrapException(A.argumentErrorValue(i));
+ if (i > 65535)
+ return A.Primitives_stringFromCodePoints(charCodes);
+ }
+ return A.Primitives__fromCharCodeApply(charCodes);
+ },
+ Primitives_stringFromNativeUint8List(charCodes, start, end) {
+ var i, result, i0, chunkEnd;
+ if (end <= 500 && start === 0 && end === charCodes.length)
+ return String.fromCharCode.apply(null, charCodes);
+ for (i = start, result = ""; i < end; i = i0) {
+ i0 = i + 500;
+ chunkEnd = i0 < end ? i0 : end;
+ result += String.fromCharCode.apply(null, charCodes.subarray(i, chunkEnd));
+ }
+ return result;
+ },
+ Primitives_stringFromCharCode(charCode) {
+ var bits;
+ if (0 <= charCode) {
+ if (charCode <= 65535)
+ return String.fromCharCode(charCode);
+ if (charCode <= 1114111) {
+ bits = charCode - 65536;
+ return String.fromCharCode((B.JSInt_methods._shrOtherPositive$1(bits, 10) | 55296) >>> 0, bits & 1023 | 56320);
+ }
+ }
+ throw A.wrapException(A.RangeError$range(charCode, 0, 1114111, null, null));
+ },
+ Primitives_lazyAsJsDate(receiver) {
+ if (receiver.date === void 0)
+ receiver.date = new Date(receiver._core$_value);
+ return receiver.date;
+ },
+ Primitives_getYear(receiver) {
+ var t1 = A.Primitives_lazyAsJsDate(receiver).getUTCFullYear() + 0;
+ return t1;
+ },
+ Primitives_getMonth(receiver) {
+ var t1 = A.Primitives_lazyAsJsDate(receiver).getUTCMonth() + 1;
+ return t1;
+ },
+ Primitives_getDay(receiver) {
+ var t1 = A.Primitives_lazyAsJsDate(receiver).getUTCDate() + 0;
+ return t1;
+ },
+ Primitives_getHours(receiver) {
+ var t1 = A.Primitives_lazyAsJsDate(receiver).getUTCHours() + 0;
+ return t1;
+ },
+ Primitives_getMinutes(receiver) {
+ var t1 = A.Primitives_lazyAsJsDate(receiver).getUTCMinutes() + 0;
+ return t1;
+ },
+ Primitives_getSeconds(receiver) {
+ var t1 = A.Primitives_lazyAsJsDate(receiver).getUTCSeconds() + 0;
+ return t1;
+ },
+ Primitives_getMilliseconds(receiver) {
+ var t1 = A.Primitives_lazyAsJsDate(receiver).getUTCMilliseconds() + 0;
+ return t1;
+ },
+ Primitives_functionNoSuchMethod($function, positionalArguments, namedArguments) {
+ var $arguments, namedArgumentList, t1 = {};
+ t1.argumentCount = 0;
+ $arguments = [];
+ namedArgumentList = [];
+ t1.argumentCount = positionalArguments.length;
+ B.JSArray_methods.addAll$1($arguments, positionalArguments);
+ t1.names = "";
+ if (namedArguments != null && namedArguments._length !== 0)
+ namedArguments.forEach$1(0, new A.Primitives_functionNoSuchMethod_closure(t1, namedArgumentList, $arguments));
+ return J.noSuchMethod$1$($function, new A.JSInvocationMirror(B.Symbol_call, 0, $arguments, namedArgumentList, 0));
+ },
+ Primitives_applyFunction($function, positionalArguments, namedArguments) {
+ var t1, argumentCount, jsStub;
+ if (Array.isArray(positionalArguments))
+ t1 = namedArguments == null || namedArguments._length === 0;
+ else
+ t1 = false;
+ if (t1) {
+ argumentCount = positionalArguments.length;
+ if (argumentCount === 0) {
+ if (!!$function.call$0)
+ return $function.call$0();
+ } else if (argumentCount === 1) {
+ if (!!$function.call$1)
+ return $function.call$1(positionalArguments[0]);
+ } else if (argumentCount === 2) {
+ if (!!$function.call$2)
+ return $function.call$2(positionalArguments[0], positionalArguments[1]);
+ } else if (argumentCount === 3) {
+ if (!!$function.call$3)
+ return $function.call$3(positionalArguments[0], positionalArguments[1], positionalArguments[2]);
+ } else if (argumentCount === 4) {
+ if (!!$function.call$4)
+ return $function.call$4(positionalArguments[0], positionalArguments[1], positionalArguments[2], positionalArguments[3]);
+ } else if (argumentCount === 5)
+ if (!!$function.call$5)
+ return $function.call$5(positionalArguments[0], positionalArguments[1], positionalArguments[2], positionalArguments[3], positionalArguments[4]);
+ jsStub = $function["call" + "$" + argumentCount];
+ if (jsStub != null)
+ return jsStub.apply($function, positionalArguments);
+ }
+ return A.Primitives__generalApplyFunction($function, positionalArguments, namedArguments);
+ },
+ Primitives__generalApplyFunction($function, positionalArguments, namedArguments) {
+ var defaultValuesClosure, t1, defaultValues, interceptor, jsFunction, maxArguments, missingDefaults, keys, _i, defaultValue, used, key,
+ $arguments = Array.isArray(positionalArguments) ? positionalArguments : A.List_List$of(positionalArguments, true, type$.dynamic),
+ argumentCount = $arguments.length,
+ requiredParameterCount = $function.$requiredArgCount;
+ if (argumentCount < requiredParameterCount)
+ return A.Primitives_functionNoSuchMethod($function, $arguments, namedArguments);
+ defaultValuesClosure = $function.$defaultValues;
+ t1 = defaultValuesClosure == null;
+ defaultValues = !t1 ? defaultValuesClosure() : null;
+ interceptor = J.getInterceptor$($function);
+ jsFunction = interceptor["call*"];
+ if (typeof jsFunction == "string")
+ jsFunction = interceptor[jsFunction];
+ if (t1) {
+ if (namedArguments != null && namedArguments._length !== 0)
+ return A.Primitives_functionNoSuchMethod($function, $arguments, namedArguments);
+ if (argumentCount === requiredParameterCount)
+ return jsFunction.apply($function, $arguments);
+ return A.Primitives_functionNoSuchMethod($function, $arguments, namedArguments);
+ }
+ if (Array.isArray(defaultValues)) {
+ if (namedArguments != null && namedArguments._length !== 0)
+ return A.Primitives_functionNoSuchMethod($function, $arguments, namedArguments);
+ maxArguments = requiredParameterCount + defaultValues.length;
+ if (argumentCount > maxArguments)
+ return A.Primitives_functionNoSuchMethod($function, $arguments, null);
+ if (argumentCount < maxArguments) {
+ missingDefaults = defaultValues.slice(argumentCount - requiredParameterCount);
+ if ($arguments === positionalArguments)
+ $arguments = A.List_List$of($arguments, true, type$.dynamic);
+ B.JSArray_methods.addAll$1($arguments, missingDefaults);
+ }
+ return jsFunction.apply($function, $arguments);
+ } else {
+ if (argumentCount > requiredParameterCount)
+ return A.Primitives_functionNoSuchMethod($function, $arguments, namedArguments);
+ if ($arguments === positionalArguments)
+ $arguments = A.List_List$of($arguments, true, type$.dynamic);
+ keys = Object.keys(defaultValues);
+ if (namedArguments == null)
+ for (t1 = keys.length, _i = 0; _i < keys.length; keys.length === t1 || (0, A.throwConcurrentModificationError)(keys), ++_i) {
+ defaultValue = defaultValues[A._asString(keys[_i])];
+ if (B.C__Required === defaultValue)
+ return A.Primitives_functionNoSuchMethod($function, $arguments, namedArguments);
+ B.JSArray_methods.add$1($arguments, defaultValue);
+ }
+ else {
+ for (t1 = keys.length, used = 0, _i = 0; _i < keys.length; keys.length === t1 || (0, A.throwConcurrentModificationError)(keys), ++_i) {
+ key = A._asString(keys[_i]);
+ if (namedArguments.containsKey$1(0, key)) {
+ ++used;
+ B.JSArray_methods.add$1($arguments, namedArguments.$index(0, key));
+ } else {
+ defaultValue = defaultValues[key];
+ if (B.C__Required === defaultValue)
+ return A.Primitives_functionNoSuchMethod($function, $arguments, namedArguments);
+ B.JSArray_methods.add$1($arguments, defaultValue);
+ }
+ }
+ if (used !== namedArguments._length)
+ return A.Primitives_functionNoSuchMethod($function, $arguments, namedArguments);
+ }
+ return jsFunction.apply($function, $arguments);
+ }
+ },
+ iae(argument) {
+ throw A.wrapException(A.argumentErrorValue(argument));
+ },
+ ioore(receiver, index) {
+ if (receiver == null)
+ J.get$length$asx(receiver);
+ throw A.wrapException(A.diagnoseIndexError(receiver, index));
+ },
+ diagnoseIndexError(indexable, index) {
+ var $length, _s5_ = "index";
+ if (!A._isInt(index))
+ return new A.ArgumentError(true, index, _s5_, null);
+ $length = A._asInt(J.get$length$asx(indexable));
+ if (index < 0 || index >= $length)
+ return A.IndexError$withLength(index, $length, indexable, _s5_);
+ return A.RangeError$value(index, _s5_);
+ },
+ diagnoseRangeError(start, end, $length) {
+ if (start > $length)
+ return A.RangeError$range(start, 0, $length, "start", null);
+ if (end != null)
+ if (end < start || end > $length)
+ return A.RangeError$range(end, start, $length, "end", null);
+ return new A.ArgumentError(true, end, "end", null);
+ },
+ argumentErrorValue(object) {
+ return new A.ArgumentError(true, object, null, null);
+ },
+ wrapException(ex) {
+ return A.initializeExceptionWrapper(new Error(), ex);
+ },
+ initializeExceptionWrapper(wrapper, ex) {
+ var t1;
+ if (ex == null)
+ ex = new A.TypeError();
+ wrapper.dartException = ex;
+ t1 = A.toStringWrapper;
+ if ("defineProperty" in Object) {
+ Object.defineProperty(wrapper, "message", {get: t1});
+ wrapper.name = "";
+ } else
+ wrapper.toString = t1;
+ return wrapper;
+ },
+ toStringWrapper() {
+ return J.toString$0$(this.dartException);
+ },
+ throwExpression(ex) {
+ throw A.wrapException(ex);
+ },
+ throwExpressionWithWrapper(ex, wrapper) {
+ throw A.initializeExceptionWrapper(wrapper, ex);
+ },
+ throwConcurrentModificationError(collection) {
+ throw A.wrapException(A.ConcurrentModificationError$(collection));
+ },
+ TypeErrorDecoder_extractPattern(message) {
+ var match, $arguments, argumentsExpr, expr, method, receiver;
+ message = A.quoteStringForRegExp(message.replace(String({}), "$receiver$"));
+ match = message.match(/\\\$[a-zA-Z]+\\\$/g);
+ if (match == null)
+ match = A._setArrayType([], type$.JSArray_String);
+ $arguments = match.indexOf("\\$arguments\\$");
+ argumentsExpr = match.indexOf("\\$argumentsExpr\\$");
+ expr = match.indexOf("\\$expr\\$");
+ method = match.indexOf("\\$method\\$");
+ receiver = match.indexOf("\\$receiver\\$");
+ return new A.TypeErrorDecoder(message.replace(new RegExp("\\\\\\$arguments\\\\\\$", "g"), "((?:x|[^x])*)").replace(new RegExp("\\\\\\$argumentsExpr\\\\\\$", "g"), "((?:x|[^x])*)").replace(new RegExp("\\\\\\$expr\\\\\\$", "g"), "((?:x|[^x])*)").replace(new RegExp("\\\\\\$method\\\\\\$", "g"), "((?:x|[^x])*)").replace(new RegExp("\\\\\\$receiver\\\\\\$", "g"), "((?:x|[^x])*)"), $arguments, argumentsExpr, expr, method, receiver);
+ },
+ TypeErrorDecoder_provokeCallErrorOn(expression) {
+ return function($expr$) {
+ var $argumentsExpr$ = "$arguments$";
+ try {
+ $expr$.$method$($argumentsExpr$);
+ } catch (e) {
+ return e.message;
+ }
+ }(expression);
+ },
+ TypeErrorDecoder_provokePropertyErrorOn(expression) {
+ return function($expr$) {
+ try {
+ $expr$.$method$;
+ } catch (e) {
+ return e.message;
+ }
+ }(expression);
+ },
+ JsNoSuchMethodError$(_message, match) {
+ var t1 = match == null,
+ t2 = t1 ? null : match.method;
+ return new A.JsNoSuchMethodError(_message, t2, t1 ? null : match.receiver);
+ },
+ unwrapException(ex) {
+ if (ex == null)
+ return new A.NullThrownFromJavaScriptException(ex);
+ if (typeof ex !== "object")
+ return ex;
+ if ("dartException" in ex)
+ return A.saveStackTrace(ex, ex.dartException);
+ return A._unwrapNonDartException(ex);
+ },
+ saveStackTrace(ex, error) {
+ if (type$.Error._is(error))
+ if (error.$thrownJsError == null)
+ error.$thrownJsError = ex;
+ return error;
+ },
+ _unwrapNonDartException(ex) {
+ var message, number, ieErrorCode, nsme, notClosure, nullCall, nullLiteralCall, undefCall, undefLiteralCall, nullProperty, undefProperty, undefLiteralProperty, match;
+ if (!("message" in ex))
+ return ex;
+ message = ex.message;
+ if ("number" in ex && typeof ex.number == "number") {
+ number = ex.number;
+ ieErrorCode = number & 65535;
+ if ((B.JSInt_methods._shrOtherPositive$1(number, 16) & 8191) === 10)
+ switch (ieErrorCode) {
+ case 438:
+ return A.saveStackTrace(ex, A.JsNoSuchMethodError$(A.S(message) + " (Error " + ieErrorCode + ")", null));
+ case 445:
+ case 5007:
+ A.S(message);
+ return A.saveStackTrace(ex, new A.NullError());
+ }
+ }
+ if (ex instanceof TypeError) {
+ nsme = $.$get$TypeErrorDecoder_noSuchMethodPattern();
+ notClosure = $.$get$TypeErrorDecoder_notClosurePattern();
+ nullCall = $.$get$TypeErrorDecoder_nullCallPattern();
+ nullLiteralCall = $.$get$TypeErrorDecoder_nullLiteralCallPattern();
+ undefCall = $.$get$TypeErrorDecoder_undefinedCallPattern();
+ undefLiteralCall = $.$get$TypeErrorDecoder_undefinedLiteralCallPattern();
+ nullProperty = $.$get$TypeErrorDecoder_nullPropertyPattern();
+ $.$get$TypeErrorDecoder_nullLiteralPropertyPattern();
+ undefProperty = $.$get$TypeErrorDecoder_undefinedPropertyPattern();
+ undefLiteralProperty = $.$get$TypeErrorDecoder_undefinedLiteralPropertyPattern();
+ match = nsme.matchTypeError$1(message);
+ if (match != null)
+ return A.saveStackTrace(ex, A.JsNoSuchMethodError$(A._asString(message), match));
+ else {
+ match = notClosure.matchTypeError$1(message);
+ if (match != null) {
+ match.method = "call";
+ return A.saveStackTrace(ex, A.JsNoSuchMethodError$(A._asString(message), match));
+ } else if (nullCall.matchTypeError$1(message) != null || nullLiteralCall.matchTypeError$1(message) != null || undefCall.matchTypeError$1(message) != null || undefLiteralCall.matchTypeError$1(message) != null || nullProperty.matchTypeError$1(message) != null || nullLiteralCall.matchTypeError$1(message) != null || undefProperty.matchTypeError$1(message) != null || undefLiteralProperty.matchTypeError$1(message) != null) {
+ A._asString(message);
+ return A.saveStackTrace(ex, new A.NullError());
+ }
+ }
+ return A.saveStackTrace(ex, new A.UnknownJsTypeError(typeof message == "string" ? message : ""));
+ }
+ if (ex instanceof RangeError) {
+ if (typeof message == "string" && message.indexOf("call stack") !== -1)
+ return new A.StackOverflowError();
+ message = function(ex) {
+ try {
+ return String(ex);
+ } catch (e) {
+ }
+ return null;
+ }(ex);
+ return A.saveStackTrace(ex, new A.ArgumentError(false, null, null, typeof message == "string" ? message.replace(/^RangeError:\s*/, "") : message));
+ }
+ if (typeof InternalError == "function" && ex instanceof InternalError)
+ if (typeof message == "string" && message === "too much recursion")
+ return new A.StackOverflowError();
+ return ex;
+ },
+ getTraceFromException(exception) {
+ var trace;
+ if (exception == null)
+ return new A._StackTrace(exception);
+ trace = exception.$cachedTrace;
+ if (trace != null)
+ return trace;
+ trace = new A._StackTrace(exception);
+ if (typeof exception === "object")
+ exception.$cachedTrace = trace;
+ return trace;
+ },
+ objectHashCode(object) {
+ if (object == null)
+ return J.get$hashCode$(object);
+ if (typeof object == "object")
+ return A.Primitives_objectHashCode(object);
+ return J.get$hashCode$(object);
+ },
+ fillLiteralMap(keyValuePairs, result) {
+ var index, index0, index1,
+ $length = keyValuePairs.length;
+ for (index = 0; index < $length; index = index1) {
+ index0 = index + 1;
+ index1 = index0 + 1;
+ result.$indexSet(0, keyValuePairs[index], keyValuePairs[index0]);
+ }
+ return result;
+ },
+ _invokeClosure(closure, numberOfArguments, arg1, arg2, arg3, arg4) {
+ type$.Function._as(closure);
+ switch (A._asInt(numberOfArguments)) {
+ case 0:
+ return closure.call$0();
+ case 1:
+ return closure.call$1(arg1);
+ case 2:
+ return closure.call$2(arg1, arg2);
+ case 3:
+ return closure.call$3(arg1, arg2, arg3);
+ case 4:
+ return closure.call$4(arg1, arg2, arg3, arg4);
+ }
+ throw A.wrapException(new A._Exception("Unsupported number of arguments for wrapped closure"));
+ },
+ convertDartClosureToJS(closure, arity) {
+ var $function = closure.$identity;
+ if (!!$function)
+ return $function;
+ $function = A.convertDartClosureToJSUncached(closure, arity);
+ closure.$identity = $function;
+ return $function;
+ },
+ convertDartClosureToJSUncached(closure, arity) {
+ var entry;
+ switch (arity) {
+ case 0:
+ entry = closure.call$0;
+ break;
+ case 1:
+ entry = closure.call$1;
+ break;
+ case 2:
+ entry = closure.call$2;
+ break;
+ case 3:
+ entry = closure.call$3;
+ break;
+ case 4:
+ entry = closure.call$4;
+ break;
+ default:
+ entry = null;
+ }
+ if (entry != null)
+ return entry.bind(closure);
+ return function(closure, arity, invoke) {
+ return function(a1, a2, a3, a4) {
+ return invoke(closure, arity, a1, a2, a3, a4);
+ };
+ }(closure, arity, A._invokeClosure);
+ },
+ Closure_fromTearOff(parameters) {
+ var $prototype, $constructor, t2, trampoline, applyTrampoline, i, stub, stub0, stubName, stubCallName,
+ container = parameters.co,
+ isStatic = parameters.iS,
+ isIntercepted = parameters.iI,
+ needsDirectAccess = parameters.nDA,
+ applyTrampolineIndex = parameters.aI,
+ funsOrNames = parameters.fs,
+ callNames = parameters.cs,
+ $name = funsOrNames[0],
+ callName = callNames[0],
+ $function = container[$name],
+ t1 = parameters.fT;
+ t1.toString;
+ $prototype = isStatic ? Object.create(new A.StaticClosure().constructor.prototype) : Object.create(new A.BoundClosure(null, null).constructor.prototype);
+ $prototype.$initialize = $prototype.constructor;
+ if (isStatic)
+ $constructor = function static_tear_off() {
+ this.$initialize();
+ };
+ else
+ $constructor = function tear_off(a, b) {
+ this.$initialize(a, b);
+ };
+ $prototype.constructor = $constructor;
+ $constructor.prototype = $prototype;
+ $prototype.$_name = $name;
+ $prototype.$_target = $function;
+ t2 = !isStatic;
+ if (t2)
+ trampoline = A.Closure_forwardCallTo($name, $function, isIntercepted, needsDirectAccess);
+ else {
+ $prototype.$static_name = $name;
+ trampoline = $function;
+ }
+ $prototype.$signature = A.Closure__computeSignatureFunctionNewRti(t1, isStatic, isIntercepted);
+ $prototype[callName] = trampoline;
+ for (applyTrampoline = trampoline, i = 1; i < funsOrNames.length; ++i) {
+ stub = funsOrNames[i];
+ if (typeof stub == "string") {
+ stub0 = container[stub];
+ stubName = stub;
+ stub = stub0;
+ } else
+ stubName = "";
+ stubCallName = callNames[i];
+ if (stubCallName != null) {
+ if (t2)
+ stub = A.Closure_forwardCallTo(stubName, stub, isIntercepted, needsDirectAccess);
+ $prototype[stubCallName] = stub;
+ }
+ if (i === applyTrampolineIndex)
+ applyTrampoline = stub;
+ }
+ $prototype["call*"] = applyTrampoline;
+ $prototype.$requiredArgCount = parameters.rC;
+ $prototype.$defaultValues = parameters.dV;
+ return $constructor;
+ },
+ Closure__computeSignatureFunctionNewRti(functionType, isStatic, isIntercepted) {
+ if (typeof functionType == "number")
+ return functionType;
+ if (typeof functionType == "string") {
+ if (isStatic)
+ throw A.wrapException("Cannot compute signature for static tearoff.");
+ return function(recipe, evalOnReceiver) {
+ return function() {
+ return evalOnReceiver(this, recipe);
+ };
+ }(functionType, A.BoundClosure_evalRecipe);
+ }
+ throw A.wrapException("Error in functionType of tearoff");
+ },
+ Closure_cspForwardCall(arity, needsDirectAccess, stubName, $function) {
+ var getReceiver = A.BoundClosure_receiverOf;
+ switch (needsDirectAccess ? -1 : arity) {
+ case 0:
+ return function(entry, receiverOf) {
+ return function() {
+ return receiverOf(this)[entry]();
+ };
+ }(stubName, getReceiver);
+ case 1:
+ return function(entry, receiverOf) {
+ return function(a) {
+ return receiverOf(this)[entry](a);
+ };
+ }(stubName, getReceiver);
+ case 2:
+ return function(entry, receiverOf) {
+ return function(a, b) {
+ return receiverOf(this)[entry](a, b);
+ };
+ }(stubName, getReceiver);
+ case 3:
+ return function(entry, receiverOf) {
+ return function(a, b, c) {
+ return receiverOf(this)[entry](a, b, c);
+ };
+ }(stubName, getReceiver);
+ case 4:
+ return function(entry, receiverOf) {
+ return function(a, b, c, d) {
+ return receiverOf(this)[entry](a, b, c, d);
+ };
+ }(stubName, getReceiver);
+ case 5:
+ return function(entry, receiverOf) {
+ return function(a, b, c, d, e) {
+ return receiverOf(this)[entry](a, b, c, d, e);
+ };
+ }(stubName, getReceiver);
+ default:
+ return function(f, receiverOf) {
+ return function() {
+ return f.apply(receiverOf(this), arguments);
+ };
+ }($function, getReceiver);
+ }
+ },
+ Closure_forwardCallTo(stubName, $function, isIntercepted, needsDirectAccess) {
+ var arity, t1;
+ if (isIntercepted)
+ return A.Closure_forwardInterceptedCallTo(stubName, $function, needsDirectAccess);
+ arity = $function.length;
+ t1 = A.Closure_cspForwardCall(arity, needsDirectAccess, stubName, $function);
+ return t1;
+ },
+ Closure_cspForwardInterceptedCall(arity, needsDirectAccess, stubName, $function) {
+ var getReceiver = A.BoundClosure_receiverOf,
+ getInterceptor = A.BoundClosure_interceptorOf;
+ switch (needsDirectAccess ? -1 : arity) {
+ case 0:
+ throw A.wrapException(new A.RuntimeError("Intercepted function with no arguments."));
+ case 1:
+ return function(entry, interceptorOf, receiverOf) {
+ return function() {
+ return interceptorOf(this)[entry](receiverOf(this));
+ };
+ }(stubName, getInterceptor, getReceiver);
+ case 2:
+ return function(entry, interceptorOf, receiverOf) {
+ return function(a) {
+ return interceptorOf(this)[entry](receiverOf(this), a);
+ };
+ }(stubName, getInterceptor, getReceiver);
+ case 3:
+ return function(entry, interceptorOf, receiverOf) {
+ return function(a, b) {
+ return interceptorOf(this)[entry](receiverOf(this), a, b);
+ };
+ }(stubName, getInterceptor, getReceiver);
+ case 4:
+ return function(entry, interceptorOf, receiverOf) {
+ return function(a, b, c) {
+ return interceptorOf(this)[entry](receiverOf(this), a, b, c);
+ };
+ }(stubName, getInterceptor, getReceiver);
+ case 5:
+ return function(entry, interceptorOf, receiverOf) {
+ return function(a, b, c, d) {
+ return interceptorOf(this)[entry](receiverOf(this), a, b, c, d);
+ };
+ }(stubName, getInterceptor, getReceiver);
+ case 6:
+ return function(entry, interceptorOf, receiverOf) {
+ return function(a, b, c, d, e) {
+ return interceptorOf(this)[entry](receiverOf(this), a, b, c, d, e);
+ };
+ }(stubName, getInterceptor, getReceiver);
+ default:
+ return function(f, interceptorOf, receiverOf) {
+ return function() {
+ var a = [receiverOf(this)];
+ Array.prototype.push.apply(a, arguments);
+ return f.apply(interceptorOf(this), a);
+ };
+ }($function, getInterceptor, getReceiver);
+ }
+ },
+ Closure_forwardInterceptedCallTo(stubName, $function, needsDirectAccess) {
+ var arity, t1;
+ if ($.BoundClosure__interceptorFieldNameCache == null)
+ $.BoundClosure__interceptorFieldNameCache = A.BoundClosure__computeFieldNamed("interceptor");
+ if ($.BoundClosure__receiverFieldNameCache == null)
+ $.BoundClosure__receiverFieldNameCache = A.BoundClosure__computeFieldNamed("receiver");
+ arity = $function.length;
+ t1 = A.Closure_cspForwardInterceptedCall(arity, needsDirectAccess, stubName, $function);
+ return t1;
+ },
+ closureFromTearOff(parameters) {
+ return A.Closure_fromTearOff(parameters);
+ },
+ BoundClosure_evalRecipe(closure, recipe) {
+ return A._Universe_evalInEnvironment(init.typeUniverse, A.instanceType(closure._receiver), recipe);
+ },
+ BoundClosure_receiverOf(closure) {
+ return closure._receiver;
+ },
+ BoundClosure_interceptorOf(closure) {
+ return closure._interceptor;
+ },
+ BoundClosure__computeFieldNamed(fieldName) {
+ var t1, i, $name,
+ template = new A.BoundClosure("receiver", "interceptor"),
+ names = J.JSArray_markFixedList(Object.getOwnPropertyNames(template), type$.nullable_Object);
+ for (t1 = names.length, i = 0; i < t1; ++i) {
+ $name = names[i];
+ if (template[$name] === fieldName)
+ return $name;
+ }
+ throw A.wrapException(A.ArgumentError$("Field name " + fieldName + " not found.", null));
+ },
+ boolConversionCheck(value) {
+ if (value == null)
+ A.assertThrow("boolean expression must not be null");
+ return value;
+ },
+ assertThrow(message) {
+ throw A.wrapException(new A._AssertionError(message));
+ },
+ throwCyclicInit(staticName) {
+ throw A.wrapException(new A._CyclicInitializationError(staticName));
+ },
+ getIsolateAffinityTag($name) {
+ return init.getIsolateTag($name);
+ },
+ defineProperty(obj, property, value) {
+ Object.defineProperty(obj, property, {value: value, enumerable: false, writable: true, configurable: true});
+ },
+ lookupAndCacheInterceptor(obj) {
+ var interceptor, interceptorClass, altTag, mark, t1,
+ tag = A._asString($.getTagFunction.call$1(obj)),
+ record = $.dispatchRecordsForInstanceTags[tag];
+ if (record != null) {
+ Object.defineProperty(obj, init.dispatchPropertyName, {value: record, enumerable: false, writable: true, configurable: true});
+ return record.i;
+ }
+ interceptor = $.interceptorsForUncacheableTags[tag];
+ if (interceptor != null)
+ return interceptor;
+ interceptorClass = init.interceptorsByTag[tag];
+ if (interceptorClass == null) {
+ altTag = A._asStringQ($.alternateTagFunction.call$2(obj, tag));
+ if (altTag != null) {
+ record = $.dispatchRecordsForInstanceTags[altTag];
+ if (record != null) {
+ Object.defineProperty(obj, init.dispatchPropertyName, {value: record, enumerable: false, writable: true, configurable: true});
+ return record.i;
+ }
+ interceptor = $.interceptorsForUncacheableTags[altTag];
+ if (interceptor != null)
+ return interceptor;
+ interceptorClass = init.interceptorsByTag[altTag];
+ tag = altTag;
+ }
+ }
+ if (interceptorClass == null)
+ return null;
+ interceptor = interceptorClass.prototype;
+ mark = tag[0];
+ if (mark === "!") {
+ record = A.makeLeafDispatchRecord(interceptor);
+ $.dispatchRecordsForInstanceTags[tag] = record;
+ Object.defineProperty(obj, init.dispatchPropertyName, {value: record, enumerable: false, writable: true, configurable: true});
+ return record.i;
+ }
+ if (mark === "~") {
+ $.interceptorsForUncacheableTags[tag] = interceptor;
+ return interceptor;
+ }
+ if (mark === "-") {
+ t1 = A.makeLeafDispatchRecord(interceptor);
+ Object.defineProperty(Object.getPrototypeOf(obj), init.dispatchPropertyName, {value: t1, enumerable: false, writable: true, configurable: true});
+ return t1.i;
+ }
+ if (mark === "+")
+ return A.patchInteriorProto(obj, interceptor);
+ if (mark === "*")
+ throw A.wrapException(A.UnimplementedError$(tag));
+ if (init.leafTags[tag] === true) {
+ t1 = A.makeLeafDispatchRecord(interceptor);
+ Object.defineProperty(Object.getPrototypeOf(obj), init.dispatchPropertyName, {value: t1, enumerable: false, writable: true, configurable: true});
+ return t1.i;
+ } else
+ return A.patchInteriorProto(obj, interceptor);
+ },
+ patchInteriorProto(obj, interceptor) {
+ var proto = Object.getPrototypeOf(obj);
+ Object.defineProperty(proto, init.dispatchPropertyName, {value: J.makeDispatchRecord(interceptor, proto, null, null), enumerable: false, writable: true, configurable: true});
+ return interceptor;
+ },
+ makeLeafDispatchRecord(interceptor) {
+ return J.makeDispatchRecord(interceptor, false, null, !!interceptor.$isJavaScriptIndexingBehavior);
+ },
+ makeDefaultDispatchRecord(tag, interceptorClass, proto) {
+ var interceptor = interceptorClass.prototype;
+ if (init.leafTags[tag] === true)
+ return A.makeLeafDispatchRecord(interceptor);
+ else
+ return J.makeDispatchRecord(interceptor, proto, null, null);
+ },
+ initNativeDispatch() {
+ if (true === $.initNativeDispatchFlag)
+ return;
+ $.initNativeDispatchFlag = true;
+ A.initNativeDispatchContinue();
+ },
+ initNativeDispatchContinue() {
+ var map, tags, fun, i, tag, proto, record, interceptorClass;
+ $.dispatchRecordsForInstanceTags = Object.create(null);
+ $.interceptorsForUncacheableTags = Object.create(null);
+ A.initHooks();
+ map = init.interceptorsByTag;
+ tags = Object.getOwnPropertyNames(map);
+ if (typeof window != "undefined") {
+ window;
+ fun = function() {
+ };
+ for (i = 0; i < tags.length; ++i) {
+ tag = tags[i];
+ proto = $.prototypeForTagFunction.call$1(tag);
+ if (proto != null) {
+ record = A.makeDefaultDispatchRecord(tag, map[tag], proto);
+ if (record != null) {
+ Object.defineProperty(proto, init.dispatchPropertyName, {value: record, enumerable: false, writable: true, configurable: true});
+ fun.prototype = proto;
+ }
+ }
+ }
+ }
+ for (i = 0; i < tags.length; ++i) {
+ tag = tags[i];
+ if (/^[A-Za-z_]/.test(tag)) {
+ interceptorClass = map[tag];
+ map["!" + tag] = interceptorClass;
+ map["~" + tag] = interceptorClass;
+ map["-" + tag] = interceptorClass;
+ map["+" + tag] = interceptorClass;
+ map["*" + tag] = interceptorClass;
+ }
+ }
+ },
+ initHooks() {
+ var transformers, i, transformer, getTag, getUnknownTag, prototypeForTag,
+ hooks = B.C_JS_CONST0();
+ hooks = A.applyHooksTransformer(B.C_JS_CONST1, A.applyHooksTransformer(B.C_JS_CONST2, A.applyHooksTransformer(B.C_JS_CONST3, A.applyHooksTransformer(B.C_JS_CONST3, A.applyHooksTransformer(B.C_JS_CONST4, A.applyHooksTransformer(B.C_JS_CONST5, A.applyHooksTransformer(B.C_JS_CONST6(B.C_JS_CONST), hooks)))))));
+ if (typeof dartNativeDispatchHooksTransformer != "undefined") {
+ transformers = dartNativeDispatchHooksTransformer;
+ if (typeof transformers == "function")
+ transformers = [transformers];
+ if (Array.isArray(transformers))
+ for (i = 0; i < transformers.length; ++i) {
+ transformer = transformers[i];
+ if (typeof transformer == "function")
+ hooks = transformer(hooks) || hooks;
+ }
+ }
+ getTag = hooks.getTag;
+ getUnknownTag = hooks.getUnknownTag;
+ prototypeForTag = hooks.prototypeForTag;
+ $.getTagFunction = new A.initHooks_closure(getTag);
+ $.alternateTagFunction = new A.initHooks_closure0(getUnknownTag);
+ $.prototypeForTagFunction = new A.initHooks_closure1(prototypeForTag);
+ },
+ applyHooksTransformer(transformer, hooks) {
+ return transformer(hooks) || hooks;
+ },
+ createRecordTypePredicate(shape, fieldRtis) {
+ var $length = fieldRtis.length,
+ $function = init.rttc["" + $length + ";" + shape];
+ if ($function == null)
+ return null;
+ if ($length === 0)
+ return $function;
+ if ($length === $function.length)
+ return $function.apply(null, fieldRtis);
+ return $function(fieldRtis);
+ },
+ JSSyntaxRegExp_makeNative(source, multiLine, caseSensitive, unicode, dotAll, global) {
+ var m = multiLine ? "m" : "",
+ i = caseSensitive ? "" : "i",
+ u = unicode ? "u" : "",
+ s = dotAll ? "s" : "",
+ g = global ? "g" : "",
+ regexp = function(source, modifiers) {
+ try {
+ return new RegExp(source, modifiers);
+ } catch (e) {
+ return e;
+ }
+ }(source, m + i + u + s + g);
+ if (regexp instanceof RegExp)
+ return regexp;
+ throw A.wrapException(A.FormatException$("Illegal RegExp pattern (" + String(regexp) + ")", source, null));
+ },
+ stringContainsUnchecked(receiver, other, startIndex) {
+ var t1;
+ if (typeof other == "string")
+ return receiver.indexOf(other, startIndex) >= 0;
+ else if (other instanceof A.JSSyntaxRegExp) {
+ t1 = B.JSString_methods.substring$1(receiver, startIndex);
+ return other._nativeRegExp.test(t1);
+ } else {
+ t1 = J.allMatches$1$s(other, B.JSString_methods.substring$1(receiver, startIndex));
+ return !t1.get$isEmpty(t1);
+ }
+ },
+ escapeReplacement(replacement) {
+ if (replacement.indexOf("$", 0) >= 0)
+ return replacement.replace(/\$/g, "$$$$");
+ return replacement;
+ },
+ stringReplaceFirstRE(receiver, regexp, replacement, startIndex) {
+ var match = regexp._execGlobal$2(receiver, startIndex);
+ if (match == null)
+ return receiver;
+ return A.stringReplaceRangeUnchecked(receiver, match._match.index, match.get$end(match), replacement);
+ },
+ quoteStringForRegExp(string) {
+ if (/[[\]{}()*+?.\\^$|]/.test(string))
+ return string.replace(/[[\]{}()*+?.\\^$|]/g, "\\$&");
+ return string;
+ },
+ stringReplaceAllUnchecked(receiver, pattern, replacement) {
+ var nativeRegexp;
+ if (typeof pattern == "string")
+ return A.stringReplaceAllUncheckedString(receiver, pattern, replacement);
+ if (pattern instanceof A.JSSyntaxRegExp) {
+ nativeRegexp = pattern.get$_nativeGlobalVersion();
+ nativeRegexp.lastIndex = 0;
+ return receiver.replace(nativeRegexp, A.escapeReplacement(replacement));
+ }
+ return A.stringReplaceAllGeneral(receiver, pattern, replacement);
+ },
+ stringReplaceAllGeneral(receiver, pattern, replacement) {
+ var t1, startIndex, t2, match;
+ for (t1 = J.allMatches$1$s(pattern, receiver), t1 = t1.get$iterator(t1), startIndex = 0, t2 = ""; t1.moveNext$0();) {
+ match = t1.get$current(t1);
+ t2 = t2 + receiver.substring(startIndex, match.get$start(match)) + replacement;
+ startIndex = match.get$end(match);
+ }
+ t1 = t2 + receiver.substring(startIndex);
+ return t1.charCodeAt(0) == 0 ? t1 : t1;
+ },
+ stringReplaceAllUncheckedString(receiver, pattern, replacement) {
+ var $length, t1, i;
+ if (pattern === "") {
+ if (receiver === "")
+ return replacement;
+ $length = receiver.length;
+ t1 = "" + replacement;
+ for (i = 0; i < $length; ++i)
+ t1 = t1 + receiver[i] + replacement;
+ return t1.charCodeAt(0) == 0 ? t1 : t1;
+ }
+ if (receiver.indexOf(pattern, 0) < 0)
+ return receiver;
+ if (receiver.length < 500 || replacement.indexOf("$", 0) >= 0)
+ return receiver.split(pattern).join(replacement);
+ return receiver.replace(new RegExp(A.quoteStringForRegExp(pattern), "g"), A.escapeReplacement(replacement));
+ },
+ stringReplaceFirstUnchecked(receiver, pattern, replacement, startIndex) {
+ var index, t1, matches, match;
+ if (typeof pattern == "string") {
+ index = receiver.indexOf(pattern, startIndex);
+ if (index < 0)
+ return receiver;
+ return A.stringReplaceRangeUnchecked(receiver, index, index + pattern.length, replacement);
+ }
+ if (pattern instanceof A.JSSyntaxRegExp)
+ return startIndex === 0 ? receiver.replace(pattern._nativeRegExp, A.escapeReplacement(replacement)) : A.stringReplaceFirstRE(receiver, pattern, replacement, startIndex);
+ t1 = J.allMatches$2$s(pattern, receiver, startIndex);
+ matches = t1.get$iterator(t1);
+ if (!matches.moveNext$0())
+ return receiver;
+ match = matches.get$current(matches);
+ return B.JSString_methods.replaceRange$3(receiver, match.get$start(match), match.get$end(match), replacement);
+ },
+ stringReplaceRangeUnchecked(receiver, start, end, replacement) {
+ return receiver.substring(0, start) + replacement + receiver.substring(end);
+ },
+ ConstantMapView: function ConstantMapView(t0, t1) {
+ this._collection$_map = t0;
+ this.$ti = t1;
+ },
+ ConstantMap: function ConstantMap() {
+ },
+ ConstantStringMap: function ConstantStringMap(t0, t1, t2) {
+ this._jsIndex = t0;
+ this._values = t1;
+ this.$ti = t2;
+ },
+ _KeysOrValues: function _KeysOrValues(t0, t1) {
+ this._elements = t0;
+ this.$ti = t1;
+ },
+ _KeysOrValuesOrElementsIterator: function _KeysOrValuesOrElementsIterator(t0, t1, t2) {
+ var _ = this;
+ _._elements = t0;
+ _._length = t1;
+ _.__js_helper$_index = 0;
+ _.__js_helper$_current = null;
+ _.$ti = t2;
+ },
+ Instantiation: function Instantiation() {
+ },
+ Instantiation1: function Instantiation1(t0, t1) {
+ this._genericClosure = t0;
+ this.$ti = t1;
+ },
+ JSInvocationMirror: function JSInvocationMirror(t0, t1, t2, t3, t4) {
+ var _ = this;
+ _._memberName = t0;
+ _.__js_helper$_kind = t1;
+ _._arguments = t2;
+ _._namedArgumentNames = t3;
+ _._typeArgumentCount = t4;
+ },
+ Primitives_functionNoSuchMethod_closure: function Primitives_functionNoSuchMethod_closure(t0, t1, t2) {
+ this._box_0 = t0;
+ this.namedArgumentList = t1;
+ this.$arguments = t2;
+ },
+ TypeErrorDecoder: function TypeErrorDecoder(t0, t1, t2, t3, t4, t5) {
+ var _ = this;
+ _._pattern = t0;
+ _._arguments = t1;
+ _._argumentsExpr = t2;
+ _._expr = t3;
+ _._method = t4;
+ _._receiver = t5;
+ },
+ NullError: function NullError() {
+ },
+ JsNoSuchMethodError: function JsNoSuchMethodError(t0, t1, t2) {
+ this.__js_helper$_message = t0;
+ this._method = t1;
+ this._receiver = t2;
+ },
+ UnknownJsTypeError: function UnknownJsTypeError(t0) {
+ this.__js_helper$_message = t0;
+ },
+ NullThrownFromJavaScriptException: function NullThrownFromJavaScriptException(t0) {
+ this._irritant = t0;
+ },
+ _StackTrace: function _StackTrace(t0) {
+ this._exception = t0;
+ this._trace = null;
+ },
+ Closure: function Closure() {
+ },
+ Closure0Args: function Closure0Args() {
+ },
+ Closure2Args: function Closure2Args() {
+ },
+ TearOffClosure: function TearOffClosure() {
+ },
+ StaticClosure: function StaticClosure() {
+ },
+ BoundClosure: function BoundClosure(t0, t1) {
+ this._receiver = t0;
+ this._interceptor = t1;
+ },
+ _CyclicInitializationError: function _CyclicInitializationError(t0) {
+ this.variableName = t0;
+ },
+ RuntimeError: function RuntimeError(t0) {
+ this.message = t0;
+ },
+ _AssertionError: function _AssertionError(t0) {
+ this.message = t0;
+ },
+ _Required: function _Required() {
+ },
+ JsLinkedHashMap: function JsLinkedHashMap(t0) {
+ var _ = this;
+ _._length = 0;
+ _._last = _._first = _.__js_helper$_rest = _._nums = _._strings = null;
+ _._modifications = 0;
+ _.$ti = t0;
+ },
+ JsLinkedHashMap_values_closure: function JsLinkedHashMap_values_closure(t0) {
+ this.$this = t0;
+ },
+ LinkedHashMapCell: function LinkedHashMapCell(t0, t1) {
+ var _ = this;
+ _.hashMapCellKey = t0;
+ _.hashMapCellValue = t1;
+ _._previous = _._next = null;
+ },
+ LinkedHashMapKeyIterable: function LinkedHashMapKeyIterable(t0, t1) {
+ this._map = t0;
+ this.$ti = t1;
+ },
+ LinkedHashMapKeyIterator: function LinkedHashMapKeyIterator(t0, t1, t2) {
+ var _ = this;
+ _._map = t0;
+ _._modifications = t1;
+ _.__js_helper$_current = _._cell = null;
+ _.$ti = t2;
+ },
+ initHooks_closure: function initHooks_closure(t0) {
+ this.getTag = t0;
+ },
+ initHooks_closure0: function initHooks_closure0(t0) {
+ this.getUnknownTag = t0;
+ },
+ initHooks_closure1: function initHooks_closure1(t0) {
+ this.prototypeForTag = t0;
+ },
+ JSSyntaxRegExp: function JSSyntaxRegExp(t0, t1) {
+ var _ = this;
+ _.pattern = t0;
+ _._nativeRegExp = t1;
+ _._nativeAnchoredRegExp = _._nativeGlobalRegExp = null;
+ },
+ _MatchImplementation: function _MatchImplementation(t0) {
+ this._match = t0;
+ },
+ _AllMatchesIterable: function _AllMatchesIterable(t0, t1, t2) {
+ this._re = t0;
+ this.__js_helper$_string = t1;
+ this.__js_helper$_start = t2;
+ },
+ _AllMatchesIterator: function _AllMatchesIterator(t0, t1, t2) {
+ var _ = this;
+ _._regExp = t0;
+ _.__js_helper$_string = t1;
+ _._nextIndex = t2;
+ _.__js_helper$_current = null;
+ },
+ StringMatch: function StringMatch(t0, t1) {
+ this.start = t0;
+ this.pattern = t1;
+ },
+ _StringAllMatchesIterable: function _StringAllMatchesIterable(t0, t1, t2) {
+ this._input = t0;
+ this._pattern = t1;
+ this.__js_helper$_index = t2;
+ },
+ _StringAllMatchesIterator: function _StringAllMatchesIterator(t0, t1, t2) {
+ var _ = this;
+ _._input = t0;
+ _._pattern = t1;
+ _.__js_helper$_index = t2;
+ _.__js_helper$_current = null;
+ },
+ throwLateFieldNI(fieldName) {
+ A.throwExpressionWithWrapper(new A.LateError("Field '" + fieldName + "' has not been initialized."), new Error());
+ },
+ throwLateFieldAI(fieldName) {
+ A.throwExpressionWithWrapper(new A.LateError("Field '" + fieldName + "' has already been initialized."), new Error());
+ },
+ throwLateFieldADI(fieldName) {
+ A.throwExpressionWithWrapper(new A.LateError("Field '" + fieldName + string$.x27_has_), new Error());
+ },
+ _Cell$named(_name) {
+ var t1 = new A._Cell(_name);
+ return t1._value = t1;
+ },
+ _InitializedCell$named(_name, _initializer) {
+ var t1 = new A._InitializedCell(_name, _initializer);
+ return t1._value = t1;
+ },
+ _Cell: function _Cell(t0) {
+ this.__late_helper$_name = t0;
+ this._value = null;
+ },
+ _InitializedCell: function _InitializedCell(t0, t1) {
+ this.__late_helper$_name = t0;
+ this._value = null;
+ this._initializer = t1;
+ },
+ _ensureNativeList(list) {
+ return list;
+ },
+ NativeInt8List__create1(arg) {
+ return new Int8Array(arg);
+ },
+ _checkValidIndex(index, list, $length) {
+ if (index >>> 0 !== index || index >= $length)
+ throw A.wrapException(A.diagnoseIndexError(list, index));
+ },
+ _checkValidRange(start, end, $length) {
+ var t1;
+ if (!(start >>> 0 !== start))
+ t1 = end >>> 0 !== end || start > end || end > $length;
+ else
+ t1 = true;
+ if (t1)
+ throw A.wrapException(A.diagnoseRangeError(start, end, $length));
+ return end;
+ },
+ NativeByteBuffer: function NativeByteBuffer() {
+ },
+ NativeTypedData: function NativeTypedData() {
+ },
+ NativeByteData: function NativeByteData() {
+ },
+ NativeTypedArray: function NativeTypedArray() {
+ },
+ NativeTypedArrayOfDouble: function NativeTypedArrayOfDouble() {
+ },
+ NativeTypedArrayOfInt: function NativeTypedArrayOfInt() {
+ },
+ NativeFloat32List: function NativeFloat32List() {
+ },
+ NativeFloat64List: function NativeFloat64List() {
+ },
+ NativeInt16List: function NativeInt16List() {
+ },
+ NativeInt32List: function NativeInt32List() {
+ },
+ NativeInt8List: function NativeInt8List() {
+ },
+ NativeUint16List: function NativeUint16List() {
+ },
+ NativeUint32List: function NativeUint32List() {
+ },
+ NativeUint8ClampedList: function NativeUint8ClampedList() {
+ },
+ NativeUint8List: function NativeUint8List() {
+ },
+ _NativeTypedArrayOfDouble_NativeTypedArray_ListMixin: function _NativeTypedArrayOfDouble_NativeTypedArray_ListMixin() {
+ },
+ _NativeTypedArrayOfDouble_NativeTypedArray_ListMixin_FixedLengthListMixin: function _NativeTypedArrayOfDouble_NativeTypedArray_ListMixin_FixedLengthListMixin() {
+ },
+ _NativeTypedArrayOfInt_NativeTypedArray_ListMixin: function _NativeTypedArrayOfInt_NativeTypedArray_ListMixin() {
+ },
+ _NativeTypedArrayOfInt_NativeTypedArray_ListMixin_FixedLengthListMixin: function _NativeTypedArrayOfInt_NativeTypedArray_ListMixin_FixedLengthListMixin() {
+ },
+ Rti__getQuestionFromStar(universe, rti) {
+ var question = rti._precomputed1;
+ return question == null ? rti._precomputed1 = A._Universe__lookupQuestionRti(universe, rti._primary, true) : question;
+ },
+ Rti__getFutureFromFutureOr(universe, rti) {
+ var future = rti._precomputed1;
+ return future == null ? rti._precomputed1 = A._Universe__lookupInterfaceRti(universe, "Future", [rti._primary]) : future;
+ },
+ Rti__getIsSubtypeCache(rti) {
+ var probe = rti._isSubtypeCache;
+ if (probe != null)
+ return probe;
+ return rti._isSubtypeCache = new Map();
+ },
+ Rti__isUnionOfFunctionType(rti) {
+ var kind = rti._kind;
+ if (kind === 6 || kind === 7 || kind === 8)
+ return A.Rti__isUnionOfFunctionType(rti._primary);
+ return kind === 12 || kind === 13;
+ },
+ Rti__getCanonicalRecipe(rti) {
+ return rti._canonicalRecipe;
+ },
+ findType(recipe) {
+ return A._Universe_eval(init.typeUniverse, recipe, false);
+ },
+ instantiatedGenericFunctionType(genericFunctionRti, instantiationRti) {
+ var t1, cache, key, probe, rti;
+ if (genericFunctionRti == null)
+ return null;
+ t1 = instantiationRti._rest;
+ cache = genericFunctionRti._bindCache;
+ if (cache == null)
+ cache = genericFunctionRti._bindCache = new Map();
+ key = instantiationRti._canonicalRecipe;
+ probe = cache.get(key);
+ if (probe != null)
+ return probe;
+ rti = A._substitute(init.typeUniverse, genericFunctionRti._primary, t1, 0);
+ cache.set(key, rti);
+ return rti;
+ },
+ _substitute(universe, rti, typeArguments, depth) {
+ var baseType, substitutedBaseType, interfaceTypeArguments, substitutedInterfaceTypeArguments, base, substitutedBase, $arguments, substitutedArguments, returnType, substitutedReturnType, functionParameters, substitutedFunctionParameters, bounds, substitutedBounds, index, argument,
+ kind = rti._kind;
+ switch (kind) {
+ case 5:
+ case 1:
+ case 2:
+ case 3:
+ case 4:
+ return rti;
+ case 6:
+ baseType = rti._primary;
+ substitutedBaseType = A._substitute(universe, baseType, typeArguments, depth);
+ if (substitutedBaseType === baseType)
+ return rti;
+ return A._Universe__lookupStarRti(universe, substitutedBaseType, true);
+ case 7:
+ baseType = rti._primary;
+ substitutedBaseType = A._substitute(universe, baseType, typeArguments, depth);
+ if (substitutedBaseType === baseType)
+ return rti;
+ return A._Universe__lookupQuestionRti(universe, substitutedBaseType, true);
+ case 8:
+ baseType = rti._primary;
+ substitutedBaseType = A._substitute(universe, baseType, typeArguments, depth);
+ if (substitutedBaseType === baseType)
+ return rti;
+ return A._Universe__lookupFutureOrRti(universe, substitutedBaseType, true);
+ case 9:
+ interfaceTypeArguments = rti._rest;
+ substitutedInterfaceTypeArguments = A._substituteArray(universe, interfaceTypeArguments, typeArguments, depth);
+ if (substitutedInterfaceTypeArguments === interfaceTypeArguments)
+ return rti;
+ return A._Universe__lookupInterfaceRti(universe, rti._primary, substitutedInterfaceTypeArguments);
+ case 10:
+ base = rti._primary;
+ substitutedBase = A._substitute(universe, base, typeArguments, depth);
+ $arguments = rti._rest;
+ substitutedArguments = A._substituteArray(universe, $arguments, typeArguments, depth);
+ if (substitutedBase === base && substitutedArguments === $arguments)
+ return rti;
+ return A._Universe__lookupBindingRti(universe, substitutedBase, substitutedArguments);
+ case 12:
+ returnType = rti._primary;
+ substitutedReturnType = A._substitute(universe, returnType, typeArguments, depth);
+ functionParameters = rti._rest;
+ substitutedFunctionParameters = A._substituteFunctionParameters(universe, functionParameters, typeArguments, depth);
+ if (substitutedReturnType === returnType && substitutedFunctionParameters === functionParameters)
+ return rti;
+ return A._Universe__lookupFunctionRti(universe, substitutedReturnType, substitutedFunctionParameters);
+ case 13:
+ bounds = rti._rest;
+ depth += bounds.length;
+ substitutedBounds = A._substituteArray(universe, bounds, typeArguments, depth);
+ base = rti._primary;
+ substitutedBase = A._substitute(universe, base, typeArguments, depth);
+ if (substitutedBounds === bounds && substitutedBase === base)
+ return rti;
+ return A._Universe__lookupGenericFunctionRti(universe, substitutedBase, substitutedBounds, true);
+ case 14:
+ index = rti._primary;
+ if (index < depth)
+ return rti;
+ argument = typeArguments[index - depth];
+ if (argument == null)
+ return rti;
+ return argument;
+ default:
+ throw A.wrapException(A.AssertionError$("Attempted to substitute unexpected RTI kind " + kind));
+ }
+ },
+ _substituteArray(universe, rtiArray, typeArguments, depth) {
+ var changed, i, rti, substitutedRti,
+ $length = rtiArray.length,
+ result = A._Utils_newArrayOrEmpty($length);
+ for (changed = false, i = 0; i < $length; ++i) {
+ rti = rtiArray[i];
+ substitutedRti = A._substitute(universe, rti, typeArguments, depth);
+ if (substitutedRti !== rti)
+ changed = true;
+ result[i] = substitutedRti;
+ }
+ return changed ? result : rtiArray;
+ },
+ _substituteNamed(universe, namedArray, typeArguments, depth) {
+ var changed, i, t1, t2, rti, substitutedRti,
+ $length = namedArray.length,
+ result = A._Utils_newArrayOrEmpty($length);
+ for (changed = false, i = 0; i < $length; i += 3) {
+ t1 = namedArray[i];
+ t2 = namedArray[i + 1];
+ rti = namedArray[i + 2];
+ substitutedRti = A._substitute(universe, rti, typeArguments, depth);
+ if (substitutedRti !== rti)
+ changed = true;
+ result.splice(i, 3, t1, t2, substitutedRti);
+ }
+ return changed ? result : namedArray;
+ },
+ _substituteFunctionParameters(universe, functionParameters, typeArguments, depth) {
+ var result,
+ requiredPositional = functionParameters._requiredPositional,
+ substitutedRequiredPositional = A._substituteArray(universe, requiredPositional, typeArguments, depth),
+ optionalPositional = functionParameters._optionalPositional,
+ substitutedOptionalPositional = A._substituteArray(universe, optionalPositional, typeArguments, depth),
+ named = functionParameters._named,
+ substitutedNamed = A._substituteNamed(universe, named, typeArguments, depth);
+ if (substitutedRequiredPositional === requiredPositional && substitutedOptionalPositional === optionalPositional && substitutedNamed === named)
+ return functionParameters;
+ result = new A._FunctionParameters();
+ result._requiredPositional = substitutedRequiredPositional;
+ result._optionalPositional = substitutedOptionalPositional;
+ result._named = substitutedNamed;
+ return result;
+ },
+ _setArrayType(target, rti) {
+ target[init.arrayRti] = rti;
+ return target;
+ },
+ closureFunctionType(closure) {
+ var t1,
+ signature = closure.$signature;
+ if (signature != null) {
+ if (typeof signature == "number")
+ return A.getTypeFromTypesTable(signature);
+ t1 = closure.$signature();
+ return t1;
+ }
+ return null;
+ },
+ instanceOrFunctionType(object, testRti) {
+ var rti;
+ if (A.Rti__isUnionOfFunctionType(testRti))
+ if (object instanceof A.Closure) {
+ rti = A.closureFunctionType(object);
+ if (rti != null)
+ return rti;
+ }
+ return A.instanceType(object);
+ },
+ instanceType(object) {
+ if (object instanceof A.Object)
+ return A._instanceType(object);
+ if (Array.isArray(object))
+ return A._arrayInstanceType(object);
+ return A._instanceTypeFromConstructor(J.getInterceptor$(object));
+ },
+ _arrayInstanceType(object) {
+ var rti = object[init.arrayRti],
+ defaultRti = type$.JSArray_dynamic;
+ if (rti == null)
+ return defaultRti;
+ if (rti.constructor !== defaultRti.constructor)
+ return defaultRti;
+ return rti;
+ },
+ _instanceType(object) {
+ var rti = object.$ti;
+ return rti != null ? rti : A._instanceTypeFromConstructor(object);
+ },
+ _instanceTypeFromConstructor(instance) {
+ var $constructor = instance.constructor,
+ probe = $constructor.$ccache;
+ if (probe != null)
+ return probe;
+ return A._instanceTypeFromConstructorMiss(instance, $constructor);
+ },
+ _instanceTypeFromConstructorMiss(instance, $constructor) {
+ var effectiveConstructor = instance instanceof A.Closure ? Object.getPrototypeOf(Object.getPrototypeOf(instance)).constructor : $constructor,
+ rti = A._Universe_findErasedType(init.typeUniverse, effectiveConstructor.name);
+ $constructor.$ccache = rti;
+ return rti;
+ },
+ getTypeFromTypesTable(index) {
+ var rti,
+ table = init.types,
+ type = table[index];
+ if (typeof type == "string") {
+ rti = A._Universe_eval(init.typeUniverse, type, false);
+ table[index] = rti;
+ return rti;
+ }
+ return type;
+ },
+ getRuntimeTypeOfDartObject(object) {
+ return A.createRuntimeType(A._instanceType(object));
+ },
+ getRuntimeTypeOfClosure(closure) {
+ var rti = A.closureFunctionType(closure);
+ return A.createRuntimeType(rti == null ? A.instanceType(closure) : rti);
+ },
+ _structuralTypeOf(object) {
+ var functionRti = object instanceof A.Closure ? A.closureFunctionType(object) : null;
+ if (functionRti != null)
+ return functionRti;
+ if (type$.TrustedGetRuntimeType._is(object))
+ return J.get$runtimeType$(object)._rti;
+ if (Array.isArray(object))
+ return A._arrayInstanceType(object);
+ return A.instanceType(object);
+ },
+ createRuntimeType(rti) {
+ var t1 = rti._cachedRuntimeType;
+ return t1 == null ? rti._cachedRuntimeType = A._createRuntimeType(rti) : t1;
+ },
+ _createRuntimeType(rti) {
+ var starErasedRti, t1,
+ s = rti._canonicalRecipe,
+ starErasedRecipe = s.replace(/\*/g, "");
+ if (starErasedRecipe === s)
+ return rti._cachedRuntimeType = new A._Type(rti);
+ starErasedRti = A._Universe_eval(init.typeUniverse, starErasedRecipe, true);
+ t1 = starErasedRti._cachedRuntimeType;
+ return t1 == null ? starErasedRti._cachedRuntimeType = A._createRuntimeType(starErasedRti) : t1;
+ },
+ typeLiteral(recipe) {
+ return A.createRuntimeType(A._Universe_eval(init.typeUniverse, recipe, false));
+ },
+ _installSpecializedIsTest(object) {
+ var t1, unstarred, unstarredKind, isFn, $name, predicate, testRti = this;
+ if (testRti === type$.Object)
+ return A._finishIsFn(testRti, object, A._isObject);
+ if (!A.isStrongTopType(testRti))
+ if (!(testRti === type$.legacy_Object))
+ t1 = false;
+ else
+ t1 = true;
+ else
+ t1 = true;
+ if (t1)
+ return A._finishIsFn(testRti, object, A._isTop);
+ t1 = testRti._kind;
+ if (t1 === 7)
+ return A._finishIsFn(testRti, object, A._generalNullableIsTestImplementation);
+ if (t1 === 1)
+ return A._finishIsFn(testRti, object, A._isNever);
+ unstarred = t1 === 6 ? testRti._primary : testRti;
+ unstarredKind = unstarred._kind;
+ if (unstarredKind === 8)
+ return A._finishIsFn(testRti, object, A._isFutureOr);
+ if (unstarred === type$.int)
+ isFn = A._isInt;
+ else if (unstarred === type$.double || unstarred === type$.num)
+ isFn = A._isNum;
+ else if (unstarred === type$.String)
+ isFn = A._isString;
+ else
+ isFn = unstarred === type$.bool ? A._isBool : null;
+ if (isFn != null)
+ return A._finishIsFn(testRti, object, isFn);
+ if (unstarredKind === 9) {
+ $name = unstarred._primary;
+ if (unstarred._rest.every(A.isTopType)) {
+ testRti._specializedTestResource = "$is" + $name;
+ if ($name === "List")
+ return A._finishIsFn(testRti, object, A._isListTestViaProperty);
+ return A._finishIsFn(testRti, object, A._isTestViaProperty);
+ }
+ } else if (unstarredKind === 11) {
+ predicate = A.createRecordTypePredicate(unstarred._primary, unstarred._rest);
+ return A._finishIsFn(testRti, object, predicate == null ? A._isNever : predicate);
+ }
+ return A._finishIsFn(testRti, object, A._generalIsTestImplementation);
+ },
+ _finishIsFn(testRti, object, isFn) {
+ testRti._is = isFn;
+ return testRti._is(object);
+ },
+ _installSpecializedAsCheck(object) {
+ var t1, testRti = this,
+ asFn = A._generalAsCheckImplementation;
+ if (!A.isStrongTopType(testRti))
+ if (!(testRti === type$.legacy_Object))
+ t1 = false;
+ else
+ t1 = true;
+ else
+ t1 = true;
+ if (t1)
+ asFn = A._asTop;
+ else if (testRti === type$.Object)
+ asFn = A._asObject;
+ else {
+ t1 = A.isNullable(testRti);
+ if (t1)
+ asFn = A._generalNullableAsCheckImplementation;
+ }
+ testRti._as = asFn;
+ return testRti._as(object);
+ },
+ _nullIs(testRti) {
+ var t1,
+ kind = testRti._kind;
+ if (!A.isStrongTopType(testRti))
+ if (!(testRti === type$.legacy_Object))
+ if (!(testRti === type$.legacy_Never))
+ if (kind !== 7)
+ if (!(kind === 6 && A._nullIs(testRti._primary)))
+ t1 = kind === 8 && A._nullIs(testRti._primary) || testRti === type$.Null || testRti === type$.JSNull;
+ else
+ t1 = true;
+ else
+ t1 = true;
+ else
+ t1 = true;
+ else
+ t1 = true;
+ else
+ t1 = true;
+ return t1;
+ },
+ _generalIsTestImplementation(object) {
+ var testRti = this;
+ if (object == null)
+ return A._nullIs(testRti);
+ return A.isSubtype(init.typeUniverse, A.instanceOrFunctionType(object, testRti), testRti);
+ },
+ _generalNullableIsTestImplementation(object) {
+ if (object == null)
+ return true;
+ return this._primary._is(object);
+ },
+ _isTestViaProperty(object) {
+ var tag, testRti = this;
+ if (object == null)
+ return A._nullIs(testRti);
+ tag = testRti._specializedTestResource;
+ if (object instanceof A.Object)
+ return !!object[tag];
+ return !!J.getInterceptor$(object)[tag];
+ },
+ _isListTestViaProperty(object) {
+ var tag, testRti = this;
+ if (object == null)
+ return A._nullIs(testRti);
+ if (typeof object != "object")
+ return false;
+ if (Array.isArray(object))
+ return true;
+ tag = testRti._specializedTestResource;
+ if (object instanceof A.Object)
+ return !!object[tag];
+ return !!J.getInterceptor$(object)[tag];
+ },
+ _generalAsCheckImplementation(object) {
+ var t1, testRti = this;
+ if (object == null) {
+ t1 = A.isNullable(testRti);
+ if (t1)
+ return object;
+ } else if (testRti._is(object))
+ return object;
+ A._failedAsCheck(object, testRti);
+ },
+ _generalNullableAsCheckImplementation(object) {
+ var testRti = this;
+ if (object == null)
+ return object;
+ else if (testRti._is(object))
+ return object;
+ A._failedAsCheck(object, testRti);
+ },
+ _failedAsCheck(object, testRti) {
+ throw A.wrapException(A._TypeError$fromMessage(A._Error_compose(object, A._rtiToString(testRti, null))));
+ },
+ checkTypeBound(type, bound, variable, methodName) {
+ if (A.isSubtype(init.typeUniverse, type, bound))
+ return type;
+ throw A.wrapException(A._TypeError$fromMessage("The type argument '" + A._rtiToString(type, null) + "' is not a subtype of the type variable bound '" + A._rtiToString(bound, null) + "' of type variable '" + variable + "' in '" + methodName + "'."));
+ },
+ _Error_compose(object, checkedTypeDescription) {
+ return A.Error_safeToString(object) + ": type '" + A._rtiToString(A._structuralTypeOf(object), null) + "' is not a subtype of type '" + checkedTypeDescription + "'";
+ },
+ _TypeError$fromMessage(message) {
+ return new A._TypeError("TypeError: " + message);
+ },
+ _TypeError__TypeError$forType(object, type) {
+ return new A._TypeError("TypeError: " + A._Error_compose(object, type));
+ },
+ _isFutureOr(object) {
+ var testRti = this,
+ unstarred = testRti._kind === 6 ? testRti._primary : testRti;
+ return unstarred._primary._is(object) || A.Rti__getFutureFromFutureOr(init.typeUniverse, unstarred)._is(object);
+ },
+ _isObject(object) {
+ return object != null;
+ },
+ _asObject(object) {
+ if (object != null)
+ return object;
+ throw A.wrapException(A._TypeError__TypeError$forType(object, "Object"));
+ },
+ _isTop(object) {
+ return true;
+ },
+ _asTop(object) {
+ return object;
+ },
+ _isNever(object) {
+ return false;
+ },
+ _isBool(object) {
+ return true === object || false === object;
+ },
+ _asBool(object) {
+ if (true === object)
+ return true;
+ if (false === object)
+ return false;
+ throw A.wrapException(A._TypeError__TypeError$forType(object, "bool"));
+ },
+ _asBoolS(object) {
+ if (true === object)
+ return true;
+ if (false === object)
+ return false;
+ if (object == null)
+ return object;
+ throw A.wrapException(A._TypeError__TypeError$forType(object, "bool"));
+ },
+ _asBoolQ(object) {
+ if (true === object)
+ return true;
+ if (false === object)
+ return false;
+ if (object == null)
+ return object;
+ throw A.wrapException(A._TypeError__TypeError$forType(object, "bool?"));
+ },
+ _asDouble(object) {
+ if (typeof object == "number")
+ return object;
+ throw A.wrapException(A._TypeError__TypeError$forType(object, "double"));
+ },
+ _asDoubleS(object) {
+ if (typeof object == "number")
+ return object;
+ if (object == null)
+ return object;
+ throw A.wrapException(A._TypeError__TypeError$forType(object, "double"));
+ },
+ _asDoubleQ(object) {
+ if (typeof object == "number")
+ return object;
+ if (object == null)
+ return object;
+ throw A.wrapException(A._TypeError__TypeError$forType(object, "double?"));
+ },
+ _isInt(object) {
+ return typeof object == "number" && Math.floor(object) === object;
+ },
+ _asInt(object) {
+ if (typeof object == "number" && Math.floor(object) === object)
+ return object;
+ throw A.wrapException(A._TypeError__TypeError$forType(object, "int"));
+ },
+ _asIntS(object) {
+ if (typeof object == "number" && Math.floor(object) === object)
+ return object;
+ if (object == null)
+ return object;
+ throw A.wrapException(A._TypeError__TypeError$forType(object, "int"));
+ },
+ _asIntQ(object) {
+ if (typeof object == "number" && Math.floor(object) === object)
+ return object;
+ if (object == null)
+ return object;
+ throw A.wrapException(A._TypeError__TypeError$forType(object, "int?"));
+ },
+ _isNum(object) {
+ return typeof object == "number";
+ },
+ _asNum(object) {
+ if (typeof object == "number")
+ return object;
+ throw A.wrapException(A._TypeError__TypeError$forType(object, "num"));
+ },
+ _asNumS(object) {
+ if (typeof object == "number")
+ return object;
+ if (object == null)
+ return object;
+ throw A.wrapException(A._TypeError__TypeError$forType(object, "num"));
+ },
+ _asNumQ(object) {
+ if (typeof object == "number")
+ return object;
+ if (object == null)
+ return object;
+ throw A.wrapException(A._TypeError__TypeError$forType(object, "num?"));
+ },
+ _isString(object) {
+ return typeof object == "string";
+ },
+ _asString(object) {
+ if (typeof object == "string")
+ return object;
+ throw A.wrapException(A._TypeError__TypeError$forType(object, "String"));
+ },
+ _asStringS(object) {
+ if (typeof object == "string")
+ return object;
+ if (object == null)
+ return object;
+ throw A.wrapException(A._TypeError__TypeError$forType(object, "String"));
+ },
+ _asStringQ(object) {
+ if (typeof object == "string")
+ return object;
+ if (object == null)
+ return object;
+ throw A.wrapException(A._TypeError__TypeError$forType(object, "String?"));
+ },
+ _rtiArrayToString(array, genericContext) {
+ var s, sep, i;
+ for (s = "", sep = "", i = 0; i < array.length; ++i, sep = ", ")
+ s += sep + A._rtiToString(array[i], genericContext);
+ return s;
+ },
+ _recordRtiToString(recordType, genericContext) {
+ var fieldCount, names, namesIndex, s, comma, i,
+ partialShape = recordType._primary,
+ fields = recordType._rest;
+ if ("" === partialShape)
+ return "(" + A._rtiArrayToString(fields, genericContext) + ")";
+ fieldCount = fields.length;
+ names = partialShape.split(",");
+ namesIndex = names.length - fieldCount;
+ for (s = "(", comma = "", i = 0; i < fieldCount; ++i, comma = ", ") {
+ s += comma;
+ if (namesIndex === 0)
+ s += "{";
+ s += A._rtiToString(fields[i], genericContext);
+ if (namesIndex >= 0)
+ s += " " + names[namesIndex];
+ ++namesIndex;
+ }
+ return s + "})";
+ },
+ _functionRtiToString(functionType, genericContext, bounds) {
+ var boundsLength, outerContextLength, offset, i, t1, t2, typeParametersText, typeSep, t3, t4, boundRti, kind, parameters, requiredPositional, requiredPositionalLength, optionalPositional, optionalPositionalLength, named, namedLength, returnTypeText, argumentsText, sep, _s2_ = ", ";
+ if (bounds != null) {
+ boundsLength = bounds.length;
+ if (genericContext == null) {
+ genericContext = A._setArrayType([], type$.JSArray_String);
+ outerContextLength = null;
+ } else
+ outerContextLength = genericContext.length;
+ offset = genericContext.length;
+ for (i = boundsLength; i > 0; --i)
+ B.JSArray_methods.add$1(genericContext, "T" + (offset + i));
+ for (t1 = type$.nullable_Object, t2 = type$.legacy_Object, typeParametersText = "<", typeSep = "", i = 0; i < boundsLength; ++i, typeSep = _s2_) {
+ t3 = genericContext.length;
+ t4 = t3 - 1 - i;
+ if (!(t4 >= 0))
+ return A.ioore(genericContext, t4);
+ typeParametersText = B.JSString_methods.$add(typeParametersText + typeSep, genericContext[t4]);
+ boundRti = bounds[i];
+ kind = boundRti._kind;
+ if (!(kind === 2 || kind === 3 || kind === 4 || kind === 5 || boundRti === t1))
+ if (!(boundRti === t2))
+ t3 = false;
+ else
+ t3 = true;
+ else
+ t3 = true;
+ if (!t3)
+ typeParametersText += " extends " + A._rtiToString(boundRti, genericContext);
+ }
+ typeParametersText += ">";
+ } else {
+ typeParametersText = "";
+ outerContextLength = null;
+ }
+ t1 = functionType._primary;
+ parameters = functionType._rest;
+ requiredPositional = parameters._requiredPositional;
+ requiredPositionalLength = requiredPositional.length;
+ optionalPositional = parameters._optionalPositional;
+ optionalPositionalLength = optionalPositional.length;
+ named = parameters._named;
+ namedLength = named.length;
+ returnTypeText = A._rtiToString(t1, genericContext);
+ for (argumentsText = "", sep = "", i = 0; i < requiredPositionalLength; ++i, sep = _s2_)
+ argumentsText += sep + A._rtiToString(requiredPositional[i], genericContext);
+ if (optionalPositionalLength > 0) {
+ argumentsText += sep + "[";
+ for (sep = "", i = 0; i < optionalPositionalLength; ++i, sep = _s2_)
+ argumentsText += sep + A._rtiToString(optionalPositional[i], genericContext);
+ argumentsText += "]";
+ }
+ if (namedLength > 0) {
+ argumentsText += sep + "{";
+ for (sep = "", i = 0; i < namedLength; i += 3, sep = _s2_) {
+ argumentsText += sep;
+ if (named[i + 1])
+ argumentsText += "required ";
+ argumentsText += A._rtiToString(named[i + 2], genericContext) + " " + named[i];
+ }
+ argumentsText += "}";
+ }
+ if (outerContextLength != null) {
+ genericContext.toString;
+ genericContext.length = outerContextLength;
+ }
+ return typeParametersText + "(" + argumentsText + ") => " + returnTypeText;
+ },
+ _rtiToString(rti, genericContext) {
+ var s, questionArgument, argumentKind, $name, $arguments, t1, t2,
+ kind = rti._kind;
+ if (kind === 5)
+ return "erased";
+ if (kind === 2)
+ return "dynamic";
+ if (kind === 3)
+ return "void";
+ if (kind === 1)
+ return "Never";
+ if (kind === 4)
+ return "any";
+ if (kind === 6) {
+ s = A._rtiToString(rti._primary, genericContext);
+ return s;
+ }
+ if (kind === 7) {
+ questionArgument = rti._primary;
+ s = A._rtiToString(questionArgument, genericContext);
+ argumentKind = questionArgument._kind;
+ return (argumentKind === 12 || argumentKind === 13 ? "(" + s + ")" : s) + "?";
+ }
+ if (kind === 8)
+ return "FutureOr<" + A._rtiToString(rti._primary, genericContext) + ">";
+ if (kind === 9) {
+ $name = A._unminifyOrTag(rti._primary);
+ $arguments = rti._rest;
+ return $arguments.length > 0 ? $name + ("<" + A._rtiArrayToString($arguments, genericContext) + ">") : $name;
+ }
+ if (kind === 11)
+ return A._recordRtiToString(rti, genericContext);
+ if (kind === 12)
+ return A._functionRtiToString(rti, genericContext, null);
+ if (kind === 13)
+ return A._functionRtiToString(rti._primary, genericContext, rti._rest);
+ if (kind === 14) {
+ t1 = rti._primary;
+ t2 = genericContext.length;
+ t1 = t2 - 1 - t1;
+ if (!(t1 >= 0 && t1 < t2))
+ return A.ioore(genericContext, t1);
+ return genericContext[t1];
+ }
+ return "?";
+ },
+ _unminifyOrTag(rawClassName) {
+ var preserved = init.mangledGlobalNames[rawClassName];
+ if (preserved != null)
+ return preserved;
+ return rawClassName;
+ },
+ _Universe_findRule(universe, targetType) {
+ var rule = universe.tR[targetType];
+ for (; typeof rule == "string";)
+ rule = universe.tR[rule];
+ return rule;
+ },
+ _Universe_findErasedType(universe, cls) {
+ var $length, erased, $arguments, i, $interface,
+ t1 = universe.eT,
+ probe = t1[cls];
+ if (probe == null)
+ return A._Universe_eval(universe, cls, false);
+ else if (typeof probe == "number") {
+ $length = probe;
+ erased = A._Universe__lookupTerminalRti(universe, 5, "#");
+ $arguments = A._Utils_newArrayOrEmpty($length);
+ for (i = 0; i < $length; ++i)
+ $arguments[i] = erased;
+ $interface = A._Universe__lookupInterfaceRti(universe, cls, $arguments);
+ t1[cls] = $interface;
+ return $interface;
+ } else
+ return probe;
+ },
+ _Universe_addRules(universe, rules) {
+ return A._Utils_objectAssign(universe.tR, rules);
+ },
+ _Universe_addErasedTypes(universe, types) {
+ return A._Utils_objectAssign(universe.eT, types);
+ },
+ _Universe_eval(universe, recipe, normalize) {
+ var rti,
+ t1 = universe.eC,
+ probe = t1.get(recipe);
+ if (probe != null)
+ return probe;
+ rti = A._Parser_parse(A._Parser_create(universe, null, recipe, normalize));
+ t1.set(recipe, rti);
+ return rti;
+ },
+ _Universe_evalInEnvironment(universe, environment, recipe) {
+ var probe, rti,
+ cache = environment._evalCache;
+ if (cache == null)
+ cache = environment._evalCache = new Map();
+ probe = cache.get(recipe);
+ if (probe != null)
+ return probe;
+ rti = A._Parser_parse(A._Parser_create(universe, environment, recipe, true));
+ cache.set(recipe, rti);
+ return rti;
+ },
+ _Universe_bind(universe, environment, argumentsRti) {
+ var argumentsRecipe, probe, rti,
+ cache = environment._bindCache;
+ if (cache == null)
+ cache = environment._bindCache = new Map();
+ argumentsRecipe = argumentsRti._canonicalRecipe;
+ probe = cache.get(argumentsRecipe);
+ if (probe != null)
+ return probe;
+ rti = A._Universe__lookupBindingRti(universe, environment, argumentsRti._kind === 10 ? argumentsRti._rest : [argumentsRti]);
+ cache.set(argumentsRecipe, rti);
+ return rti;
+ },
+ _Universe__installTypeTests(universe, rti) {
+ rti._as = A._installSpecializedAsCheck;
+ rti._is = A._installSpecializedIsTest;
+ return rti;
+ },
+ _Universe__lookupTerminalRti(universe, kind, key) {
+ var rti, t1,
+ probe = universe.eC.get(key);
+ if (probe != null)
+ return probe;
+ rti = new A.Rti(null, null);
+ rti._kind = kind;
+ rti._canonicalRecipe = key;
+ t1 = A._Universe__installTypeTests(universe, rti);
+ universe.eC.set(key, t1);
+ return t1;
+ },
+ _Universe__lookupStarRti(universe, baseType, normalize) {
+ var t1,
+ key = baseType._canonicalRecipe + "*",
+ probe = universe.eC.get(key);
+ if (probe != null)
+ return probe;
+ t1 = A._Universe__createStarRti(universe, baseType, key, normalize);
+ universe.eC.set(key, t1);
+ return t1;
+ },
+ _Universe__createStarRti(universe, baseType, key, normalize) {
+ var baseKind, t1, rti;
+ if (normalize) {
+ baseKind = baseType._kind;
+ if (!A.isStrongTopType(baseType))
+ t1 = baseType === type$.Null || baseType === type$.JSNull || baseKind === 7 || baseKind === 6;
+ else
+ t1 = true;
+ if (t1)
+ return baseType;
+ }
+ rti = new A.Rti(null, null);
+ rti._kind = 6;
+ rti._primary = baseType;
+ rti._canonicalRecipe = key;
+ return A._Universe__installTypeTests(universe, rti);
+ },
+ _Universe__lookupQuestionRti(universe, baseType, normalize) {
+ var t1,
+ key = baseType._canonicalRecipe + "?",
+ probe = universe.eC.get(key);
+ if (probe != null)
+ return probe;
+ t1 = A._Universe__createQuestionRti(universe, baseType, key, normalize);
+ universe.eC.set(key, t1);
+ return t1;
+ },
+ _Universe__createQuestionRti(universe, baseType, key, normalize) {
+ var baseKind, t1, starArgument, rti;
+ if (normalize) {
+ baseKind = baseType._kind;
+ if (!A.isStrongTopType(baseType))
+ if (!(baseType === type$.Null || baseType === type$.JSNull))
+ if (baseKind !== 7)
+ t1 = baseKind === 8 && A.isNullable(baseType._primary);
+ else
+ t1 = true;
+ else
+ t1 = true;
+ else
+ t1 = true;
+ if (t1)
+ return baseType;
+ else if (baseKind === 1 || baseType === type$.legacy_Never)
+ return type$.Null;
+ else if (baseKind === 6) {
+ starArgument = baseType._primary;
+ if (starArgument._kind === 8 && A.isNullable(starArgument._primary))
+ return starArgument;
+ else
+ return A.Rti__getQuestionFromStar(universe, baseType);
+ }
+ }
+ rti = new A.Rti(null, null);
+ rti._kind = 7;
+ rti._primary = baseType;
+ rti._canonicalRecipe = key;
+ return A._Universe__installTypeTests(universe, rti);
+ },
+ _Universe__lookupFutureOrRti(universe, baseType, normalize) {
+ var t1,
+ key = baseType._canonicalRecipe + "/",
+ probe = universe.eC.get(key);
+ if (probe != null)
+ return probe;
+ t1 = A._Universe__createFutureOrRti(universe, baseType, key, normalize);
+ universe.eC.set(key, t1);
+ return t1;
+ },
+ _Universe__createFutureOrRti(universe, baseType, key, normalize) {
+ var t1, t2, rti;
+ if (normalize) {
+ t1 = baseType._kind;
+ if (!A.isStrongTopType(baseType))
+ if (!(baseType === type$.legacy_Object))
+ t2 = false;
+ else
+ t2 = true;
+ else
+ t2 = true;
+ if (t2 || baseType === type$.Object)
+ return baseType;
+ else if (t1 === 1)
+ return A._Universe__lookupInterfaceRti(universe, "Future", [baseType]);
+ else if (baseType === type$.Null || baseType === type$.JSNull)
+ return type$.nullable_Future_Null;
+ }
+ rti = new A.Rti(null, null);
+ rti._kind = 8;
+ rti._primary = baseType;
+ rti._canonicalRecipe = key;
+ return A._Universe__installTypeTests(universe, rti);
+ },
+ _Universe__lookupGenericFunctionParameterRti(universe, index) {
+ var rti, t1,
+ key = "" + index + "^",
+ probe = universe.eC.get(key);
+ if (probe != null)
+ return probe;
+ rti = new A.Rti(null, null);
+ rti._kind = 14;
+ rti._primary = index;
+ rti._canonicalRecipe = key;
+ t1 = A._Universe__installTypeTests(universe, rti);
+ universe.eC.set(key, t1);
+ return t1;
+ },
+ _Universe__canonicalRecipeJoin($arguments) {
+ var s, sep, i,
+ $length = $arguments.length;
+ for (s = "", sep = "", i = 0; i < $length; ++i, sep = ",")
+ s += sep + $arguments[i]._canonicalRecipe;
+ return s;
+ },
+ _Universe__canonicalRecipeJoinNamed($arguments) {
+ var s, sep, i, t1, nameSep,
+ $length = $arguments.length;
+ for (s = "", sep = "", i = 0; i < $length; i += 3, sep = ",") {
+ t1 = $arguments[i];
+ nameSep = $arguments[i + 1] ? "!" : ":";
+ s += sep + t1 + nameSep + $arguments[i + 2]._canonicalRecipe;
+ }
+ return s;
+ },
+ _Universe__lookupInterfaceRti(universe, $name, $arguments) {
+ var probe, rti, t1,
+ s = $name;
+ if ($arguments.length > 0)
+ s += "<" + A._Universe__canonicalRecipeJoin($arguments) + ">";
+ probe = universe.eC.get(s);
+ if (probe != null)
+ return probe;
+ rti = new A.Rti(null, null);
+ rti._kind = 9;
+ rti._primary = $name;
+ rti._rest = $arguments;
+ if ($arguments.length > 0)
+ rti._precomputed1 = $arguments[0];
+ rti._canonicalRecipe = s;
+ t1 = A._Universe__installTypeTests(universe, rti);
+ universe.eC.set(s, t1);
+ return t1;
+ },
+ _Universe__lookupBindingRti(universe, base, $arguments) {
+ var newBase, newArguments, key, probe, rti, t1;
+ if (base._kind === 10) {
+ newBase = base._primary;
+ newArguments = base._rest.concat($arguments);
+ } else {
+ newArguments = $arguments;
+ newBase = base;
+ }
+ key = newBase._canonicalRecipe + (";<" + A._Universe__canonicalRecipeJoin(newArguments) + ">");
+ probe = universe.eC.get(key);
+ if (probe != null)
+ return probe;
+ rti = new A.Rti(null, null);
+ rti._kind = 10;
+ rti._primary = newBase;
+ rti._rest = newArguments;
+ rti._canonicalRecipe = key;
+ t1 = A._Universe__installTypeTests(universe, rti);
+ universe.eC.set(key, t1);
+ return t1;
+ },
+ _Universe__lookupRecordRti(universe, partialShapeTag, fields) {
+ var rti, t1,
+ key = "+" + (partialShapeTag + "(" + A._Universe__canonicalRecipeJoin(fields) + ")"),
+ probe = universe.eC.get(key);
+ if (probe != null)
+ return probe;
+ rti = new A.Rti(null, null);
+ rti._kind = 11;
+ rti._primary = partialShapeTag;
+ rti._rest = fields;
+ rti._canonicalRecipe = key;
+ t1 = A._Universe__installTypeTests(universe, rti);
+ universe.eC.set(key, t1);
+ return t1;
+ },
+ _Universe__lookupFunctionRti(universe, returnType, parameters) {
+ var sep, key, probe, rti, t1,
+ s = returnType._canonicalRecipe,
+ requiredPositional = parameters._requiredPositional,
+ requiredPositionalLength = requiredPositional.length,
+ optionalPositional = parameters._optionalPositional,
+ optionalPositionalLength = optionalPositional.length,
+ named = parameters._named,
+ namedLength = named.length,
+ recipe = "(" + A._Universe__canonicalRecipeJoin(requiredPositional);
+ if (optionalPositionalLength > 0) {
+ sep = requiredPositionalLength > 0 ? "," : "";
+ recipe += sep + "[" + A._Universe__canonicalRecipeJoin(optionalPositional) + "]";
+ }
+ if (namedLength > 0) {
+ sep = requiredPositionalLength > 0 ? "," : "";
+ recipe += sep + "{" + A._Universe__canonicalRecipeJoinNamed(named) + "}";
+ }
+ key = s + (recipe + ")");
+ probe = universe.eC.get(key);
+ if (probe != null)
+ return probe;
+ rti = new A.Rti(null, null);
+ rti._kind = 12;
+ rti._primary = returnType;
+ rti._rest = parameters;
+ rti._canonicalRecipe = key;
+ t1 = A._Universe__installTypeTests(universe, rti);
+ universe.eC.set(key, t1);
+ return t1;
+ },
+ _Universe__lookupGenericFunctionRti(universe, baseFunctionType, bounds, normalize) {
+ var t1,
+ key = baseFunctionType._canonicalRecipe + ("<" + A._Universe__canonicalRecipeJoin(bounds) + ">"),
+ probe = universe.eC.get(key);
+ if (probe != null)
+ return probe;
+ t1 = A._Universe__createGenericFunctionRti(universe, baseFunctionType, bounds, key, normalize);
+ universe.eC.set(key, t1);
+ return t1;
+ },
+ _Universe__createGenericFunctionRti(universe, baseFunctionType, bounds, key, normalize) {
+ var $length, typeArguments, count, i, bound, substitutedBase, substitutedBounds, rti;
+ if (normalize) {
+ $length = bounds.length;
+ typeArguments = A._Utils_newArrayOrEmpty($length);
+ for (count = 0, i = 0; i < $length; ++i) {
+ bound = bounds[i];
+ if (bound._kind === 1) {
+ typeArguments[i] = bound;
+ ++count;
+ }
+ }
+ if (count > 0) {
+ substitutedBase = A._substitute(universe, baseFunctionType, typeArguments, 0);
+ substitutedBounds = A._substituteArray(universe, bounds, typeArguments, 0);
+ return A._Universe__lookupGenericFunctionRti(universe, substitutedBase, substitutedBounds, bounds !== substitutedBounds);
+ }
+ }
+ rti = new A.Rti(null, null);
+ rti._kind = 13;
+ rti._primary = baseFunctionType;
+ rti._rest = bounds;
+ rti._canonicalRecipe = key;
+ return A._Universe__installTypeTests(universe, rti);
+ },
+ _Parser_create(universe, environment, recipe, normalize) {
+ return {u: universe, e: environment, r: recipe, s: [], p: 0, n: normalize};
+ },
+ _Parser_parse(parser) {
+ var t2, i, ch, t3, array, end, item,
+ source = parser.r,
+ t1 = parser.s;
+ for (t2 = source.length, i = 0; i < t2;) {
+ ch = source.charCodeAt(i);
+ if (ch >= 48 && ch <= 57)
+ i = A._Parser_handleDigit(i + 1, ch, source, t1);
+ else if ((((ch | 32) >>> 0) - 97 & 65535) < 26 || ch === 95 || ch === 36 || ch === 124)
+ i = A._Parser_handleIdentifier(parser, i, source, t1, false);
+ else if (ch === 46)
+ i = A._Parser_handleIdentifier(parser, i, source, t1, true);
+ else {
+ ++i;
+ switch (ch) {
+ case 44:
+ break;
+ case 58:
+ t1.push(false);
+ break;
+ case 33:
+ t1.push(true);
+ break;
+ case 59:
+ t1.push(A._Parser_toType(parser.u, parser.e, t1.pop()));
+ break;
+ case 94:
+ t1.push(A._Universe__lookupGenericFunctionParameterRti(parser.u, t1.pop()));
+ break;
+ case 35:
+ t1.push(A._Universe__lookupTerminalRti(parser.u, 5, "#"));
+ break;
+ case 64:
+ t1.push(A._Universe__lookupTerminalRti(parser.u, 2, "@"));
+ break;
+ case 126:
+ t1.push(A._Universe__lookupTerminalRti(parser.u, 3, "~"));
+ break;
+ case 60:
+ t1.push(parser.p);
+ parser.p = t1.length;
+ break;
+ case 62:
+ A._Parser_handleTypeArguments(parser, t1);
+ break;
+ case 38:
+ A._Parser_handleExtendedOperations(parser, t1);
+ break;
+ case 42:
+ t3 = parser.u;
+ t1.push(A._Universe__lookupStarRti(t3, A._Parser_toType(t3, parser.e, t1.pop()), parser.n));
+ break;
+ case 63:
+ t3 = parser.u;
+ t1.push(A._Universe__lookupQuestionRti(t3, A._Parser_toType(t3, parser.e, t1.pop()), parser.n));
+ break;
+ case 47:
+ t3 = parser.u;
+ t1.push(A._Universe__lookupFutureOrRti(t3, A._Parser_toType(t3, parser.e, t1.pop()), parser.n));
+ break;
+ case 40:
+ t1.push(-3);
+ t1.push(parser.p);
+ parser.p = t1.length;
+ break;
+ case 41:
+ A._Parser_handleArguments(parser, t1);
+ break;
+ case 91:
+ t1.push(parser.p);
+ parser.p = t1.length;
+ break;
+ case 93:
+ array = t1.splice(parser.p);
+ A._Parser_toTypes(parser.u, parser.e, array);
+ parser.p = t1.pop();
+ t1.push(array);
+ t1.push(-1);
+ break;
+ case 123:
+ t1.push(parser.p);
+ parser.p = t1.length;
+ break;
+ case 125:
+ array = t1.splice(parser.p);
+ A._Parser_toTypesNamed(parser.u, parser.e, array);
+ parser.p = t1.pop();
+ t1.push(array);
+ t1.push(-2);
+ break;
+ case 43:
+ end = source.indexOf("(", i);
+ t1.push(source.substring(i, end));
+ t1.push(-4);
+ t1.push(parser.p);
+ parser.p = t1.length;
+ i = end + 1;
+ break;
+ default:
+ throw "Bad character " + ch;
+ }
+ }
+ }
+ item = t1.pop();
+ return A._Parser_toType(parser.u, parser.e, item);
+ },
+ _Parser_handleDigit(i, digit, source, stack) {
+ var t1, ch,
+ value = digit - 48;
+ for (t1 = source.length; i < t1; ++i) {
+ ch = source.charCodeAt(i);
+ if (!(ch >= 48 && ch <= 57))
+ break;
+ value = value * 10 + (ch - 48);
+ }
+ stack.push(value);
+ return i;
+ },
+ _Parser_handleIdentifier(parser, start, source, stack, hasPeriod) {
+ var t1, ch, t2, string, environment, recipe,
+ i = start + 1;
+ for (t1 = source.length; i < t1; ++i) {
+ ch = source.charCodeAt(i);
+ if (ch === 46) {
+ if (hasPeriod)
+ break;
+ hasPeriod = true;
+ } else {
+ if (!((((ch | 32) >>> 0) - 97 & 65535) < 26 || ch === 95 || ch === 36 || ch === 124))
+ t2 = ch >= 48 && ch <= 57;
+ else
+ t2 = true;
+ if (!t2)
+ break;
+ }
+ }
+ string = source.substring(start, i);
+ if (hasPeriod) {
+ t1 = parser.u;
+ environment = parser.e;
+ if (environment._kind === 10)
+ environment = environment._primary;
+ recipe = A._Universe_findRule(t1, environment._primary)[string];
+ if (recipe == null)
+ A.throwExpression('No "' + string + '" in "' + A.Rti__getCanonicalRecipe(environment) + '"');
+ stack.push(A._Universe_evalInEnvironment(t1, environment, recipe));
+ } else
+ stack.push(string);
+ return i;
+ },
+ _Parser_handleTypeArguments(parser, stack) {
+ var base,
+ t1 = parser.u,
+ $arguments = A._Parser_collectArray(parser, stack),
+ head = stack.pop();
+ if (typeof head == "string")
+ stack.push(A._Universe__lookupInterfaceRti(t1, head, $arguments));
+ else {
+ base = A._Parser_toType(t1, parser.e, head);
+ switch (base._kind) {
+ case 12:
+ stack.push(A._Universe__lookupGenericFunctionRti(t1, base, $arguments, parser.n));
+ break;
+ default:
+ stack.push(A._Universe__lookupBindingRti(t1, base, $arguments));
+ break;
+ }
+ }
+ },
+ _Parser_handleArguments(parser, stack) {
+ var optionalPositional, named, requiredPositional, returnType, parameters, _null = null,
+ t1 = parser.u,
+ head = stack.pop();
+ if (typeof head == "number")
+ switch (head) {
+ case -1:
+ optionalPositional = stack.pop();
+ named = _null;
+ break;
+ case -2:
+ named = stack.pop();
+ optionalPositional = _null;
+ break;
+ default:
+ stack.push(head);
+ named = _null;
+ optionalPositional = named;
+ break;
+ }
+ else {
+ stack.push(head);
+ named = _null;
+ optionalPositional = named;
+ }
+ requiredPositional = A._Parser_collectArray(parser, stack);
+ head = stack.pop();
+ switch (head) {
+ case -3:
+ head = stack.pop();
+ if (optionalPositional == null)
+ optionalPositional = t1.sEA;
+ if (named == null)
+ named = t1.sEA;
+ returnType = A._Parser_toType(t1, parser.e, head);
+ parameters = new A._FunctionParameters();
+ parameters._requiredPositional = requiredPositional;
+ parameters._optionalPositional = optionalPositional;
+ parameters._named = named;
+ stack.push(A._Universe__lookupFunctionRti(t1, returnType, parameters));
+ return;
+ case -4:
+ stack.push(A._Universe__lookupRecordRti(t1, stack.pop(), requiredPositional));
+ return;
+ default:
+ throw A.wrapException(A.AssertionError$("Unexpected state under `()`: " + A.S(head)));
+ }
+ },
+ _Parser_handleExtendedOperations(parser, stack) {
+ var $top = stack.pop();
+ if (0 === $top) {
+ stack.push(A._Universe__lookupTerminalRti(parser.u, 1, "0&"));
+ return;
+ }
+ if (1 === $top) {
+ stack.push(A._Universe__lookupTerminalRti(parser.u, 4, "1&"));
+ return;
+ }
+ throw A.wrapException(A.AssertionError$("Unexpected extended operation " + A.S($top)));
+ },
+ _Parser_collectArray(parser, stack) {
+ var array = stack.splice(parser.p);
+ A._Parser_toTypes(parser.u, parser.e, array);
+ parser.p = stack.pop();
+ return array;
+ },
+ _Parser_toType(universe, environment, item) {
+ if (typeof item == "string")
+ return A._Universe__lookupInterfaceRti(universe, item, universe.sEA);
+ else if (typeof item == "number") {
+ environment.toString;
+ return A._Parser_indexToType(universe, environment, item);
+ } else
+ return item;
+ },
+ _Parser_toTypes(universe, environment, items) {
+ var i,
+ $length = items.length;
+ for (i = 0; i < $length; ++i)
+ items[i] = A._Parser_toType(universe, environment, items[i]);
+ },
+ _Parser_toTypesNamed(universe, environment, items) {
+ var i,
+ $length = items.length;
+ for (i = 2; i < $length; i += 3)
+ items[i] = A._Parser_toType(universe, environment, items[i]);
+ },
+ _Parser_indexToType(universe, environment, index) {
+ var typeArguments, len,
+ kind = environment._kind;
+ if (kind === 10) {
+ if (index === 0)
+ return environment._primary;
+ typeArguments = environment._rest;
+ len = typeArguments.length;
+ if (index <= len)
+ return typeArguments[index - 1];
+ index -= len;
+ environment = environment._primary;
+ kind = environment._kind;
+ } else if (index === 0)
+ return environment;
+ if (kind !== 9)
+ throw A.wrapException(A.AssertionError$("Indexed base must be an interface type"));
+ typeArguments = environment._rest;
+ if (index <= typeArguments.length)
+ return typeArguments[index - 1];
+ throw A.wrapException(A.AssertionError$("Bad index " + index + " for " + environment.toString$0(0)));
+ },
+ isSubtype(universe, s, t) {
+ var result,
+ sCache = A.Rti__getIsSubtypeCache(s),
+ probe = sCache.get(t);
+ if (probe != null)
+ return probe;
+ result = A._isSubtype(universe, s, null, t, null);
+ sCache.set(t, result);
+ return result;
+ },
+ _isSubtype(universe, s, sEnv, t, tEnv) {
+ var t1, sKind, leftTypeVariable, tKind, t2, sBounds, tBounds, sLength, i, sBound, tBound;
+ if (s === t)
+ return true;
+ if (!A.isStrongTopType(t))
+ if (!(t === type$.legacy_Object))
+ t1 = false;
+ else
+ t1 = true;
+ else
+ t1 = true;
+ if (t1)
+ return true;
+ sKind = s._kind;
+ if (sKind === 4)
+ return true;
+ if (A.isStrongTopType(s))
+ return false;
+ if (s._kind !== 1)
+ t1 = false;
+ else
+ t1 = true;
+ if (t1)
+ return true;
+ leftTypeVariable = sKind === 14;
+ if (leftTypeVariable)
+ if (A._isSubtype(universe, sEnv[s._primary], sEnv, t, tEnv))
+ return true;
+ tKind = t._kind;
+ t1 = s === type$.Null || s === type$.JSNull;
+ if (t1) {
+ if (tKind === 8)
+ return A._isSubtype(universe, s, sEnv, t._primary, tEnv);
+ return t === type$.Null || t === type$.JSNull || tKind === 7 || tKind === 6;
+ }
+ if (t === type$.Object) {
+ if (sKind === 8)
+ return A._isSubtype(universe, s._primary, sEnv, t, tEnv);
+ if (sKind === 6)
+ return A._isSubtype(universe, s._primary, sEnv, t, tEnv);
+ return sKind !== 7;
+ }
+ if (sKind === 6)
+ return A._isSubtype(universe, s._primary, sEnv, t, tEnv);
+ if (tKind === 6) {
+ t1 = A.Rti__getQuestionFromStar(universe, t);
+ return A._isSubtype(universe, s, sEnv, t1, tEnv);
+ }
+ if (sKind === 8) {
+ if (!A._isSubtype(universe, s._primary, sEnv, t, tEnv))
+ return false;
+ return A._isSubtype(universe, A.Rti__getFutureFromFutureOr(universe, s), sEnv, t, tEnv);
+ }
+ if (sKind === 7) {
+ t1 = A._isSubtype(universe, type$.Null, sEnv, t, tEnv);
+ return t1 && A._isSubtype(universe, s._primary, sEnv, t, tEnv);
+ }
+ if (tKind === 8) {
+ if (A._isSubtype(universe, s, sEnv, t._primary, tEnv))
+ return true;
+ return A._isSubtype(universe, s, sEnv, A.Rti__getFutureFromFutureOr(universe, t), tEnv);
+ }
+ if (tKind === 7) {
+ t1 = A._isSubtype(universe, s, sEnv, type$.Null, tEnv);
+ return t1 || A._isSubtype(universe, s, sEnv, t._primary, tEnv);
+ }
+ if (leftTypeVariable)
+ return false;
+ t1 = sKind !== 12;
+ if ((!t1 || sKind === 13) && t === type$.Function)
+ return true;
+ t2 = sKind === 11;
+ if (t2 && t === type$.Record)
+ return true;
+ if (tKind === 13) {
+ if (s === type$.JavaScriptFunction)
+ return true;
+ if (sKind !== 13)
+ return false;
+ sBounds = s._rest;
+ tBounds = t._rest;
+ sLength = sBounds.length;
+ if (sLength !== tBounds.length)
+ return false;
+ sEnv = sEnv == null ? sBounds : sBounds.concat(sEnv);
+ tEnv = tEnv == null ? tBounds : tBounds.concat(tEnv);
+ for (i = 0; i < sLength; ++i) {
+ sBound = sBounds[i];
+ tBound = tBounds[i];
+ if (!A._isSubtype(universe, sBound, sEnv, tBound, tEnv) || !A._isSubtype(universe, tBound, tEnv, sBound, sEnv))
+ return false;
+ }
+ return A._isFunctionSubtype(universe, s._primary, sEnv, t._primary, tEnv);
+ }
+ if (tKind === 12) {
+ if (s === type$.JavaScriptFunction)
+ return true;
+ if (t1)
+ return false;
+ return A._isFunctionSubtype(universe, s, sEnv, t, tEnv);
+ }
+ if (sKind === 9) {
+ if (tKind !== 9)
+ return false;
+ return A._isInterfaceSubtype(universe, s, sEnv, t, tEnv);
+ }
+ if (t2 && tKind === 11)
+ return A._isRecordSubtype(universe, s, sEnv, t, tEnv);
+ return false;
+ },
+ _isFunctionSubtype(universe, s, sEnv, t, tEnv) {
+ var sParameters, tParameters, sRequiredPositional, tRequiredPositional, sRequiredPositionalLength, tRequiredPositionalLength, requiredPositionalDelta, sOptionalPositional, tOptionalPositional, sOptionalPositionalLength, tOptionalPositionalLength, i, t1, sNamed, tNamed, sNamedLength, tNamedLength, sIndex, tIndex, tName, sName, sIsRequired;
+ if (!A._isSubtype(universe, s._primary, sEnv, t._primary, tEnv))
+ return false;
+ sParameters = s._rest;
+ tParameters = t._rest;
+ sRequiredPositional = sParameters._requiredPositional;
+ tRequiredPositional = tParameters._requiredPositional;
+ sRequiredPositionalLength = sRequiredPositional.length;
+ tRequiredPositionalLength = tRequiredPositional.length;
+ if (sRequiredPositionalLength > tRequiredPositionalLength)
+ return false;
+ requiredPositionalDelta = tRequiredPositionalLength - sRequiredPositionalLength;
+ sOptionalPositional = sParameters._optionalPositional;
+ tOptionalPositional = tParameters._optionalPositional;
+ sOptionalPositionalLength = sOptionalPositional.length;
+ tOptionalPositionalLength = tOptionalPositional.length;
+ if (sRequiredPositionalLength + sOptionalPositionalLength < tRequiredPositionalLength + tOptionalPositionalLength)
+ return false;
+ for (i = 0; i < sRequiredPositionalLength; ++i) {
+ t1 = sRequiredPositional[i];
+ if (!A._isSubtype(universe, tRequiredPositional[i], tEnv, t1, sEnv))
+ return false;
+ }
+ for (i = 0; i < requiredPositionalDelta; ++i) {
+ t1 = sOptionalPositional[i];
+ if (!A._isSubtype(universe, tRequiredPositional[sRequiredPositionalLength + i], tEnv, t1, sEnv))
+ return false;
+ }
+ for (i = 0; i < tOptionalPositionalLength; ++i) {
+ t1 = sOptionalPositional[requiredPositionalDelta + i];
+ if (!A._isSubtype(universe, tOptionalPositional[i], tEnv, t1, sEnv))
+ return false;
+ }
+ sNamed = sParameters._named;
+ tNamed = tParameters._named;
+ sNamedLength = sNamed.length;
+ tNamedLength = tNamed.length;
+ for (sIndex = 0, tIndex = 0; tIndex < tNamedLength; tIndex += 3) {
+ tName = tNamed[tIndex];
+ for (; true;) {
+ if (sIndex >= sNamedLength)
+ return false;
+ sName = sNamed[sIndex];
+ sIndex += 3;
+ if (tName < sName)
+ return false;
+ sIsRequired = sNamed[sIndex - 2];
+ if (sName < tName) {
+ if (sIsRequired)
+ return false;
+ continue;
+ }
+ t1 = tNamed[tIndex + 1];
+ if (sIsRequired && !t1)
+ return false;
+ t1 = sNamed[sIndex - 1];
+ if (!A._isSubtype(universe, tNamed[tIndex + 2], tEnv, t1, sEnv))
+ return false;
+ break;
+ }
+ }
+ for (; sIndex < sNamedLength;) {
+ if (sNamed[sIndex + 1])
+ return false;
+ sIndex += 3;
+ }
+ return true;
+ },
+ _isInterfaceSubtype(universe, s, sEnv, t, tEnv) {
+ var rule, recipes, $length, supertypeArgs, i, t1, t2,
+ sName = s._primary,
+ tName = t._primary;
+ for (; sName !== tName;) {
+ rule = universe.tR[sName];
+ if (rule == null)
+ return false;
+ if (typeof rule == "string") {
+ sName = rule;
+ continue;
+ }
+ recipes = rule[tName];
+ if (recipes == null)
+ return false;
+ $length = recipes.length;
+ supertypeArgs = $length > 0 ? new Array($length) : init.typeUniverse.sEA;
+ for (i = 0; i < $length; ++i)
+ supertypeArgs[i] = A._Universe_evalInEnvironment(universe, s, recipes[i]);
+ return A._areArgumentsSubtypes(universe, supertypeArgs, null, sEnv, t._rest, tEnv);
+ }
+ t1 = s._rest;
+ t2 = t._rest;
+ return A._areArgumentsSubtypes(universe, t1, null, sEnv, t2, tEnv);
+ },
+ _areArgumentsSubtypes(universe, sArgs, sVariances, sEnv, tArgs, tEnv) {
+ var i, t1, t2,
+ $length = sArgs.length;
+ for (i = 0; i < $length; ++i) {
+ t1 = sArgs[i];
+ t2 = tArgs[i];
+ if (!A._isSubtype(universe, t1, sEnv, t2, tEnv))
+ return false;
+ }
+ return true;
+ },
+ _isRecordSubtype(universe, s, sEnv, t, tEnv) {
+ var i,
+ sFields = s._rest,
+ tFields = t._rest,
+ sCount = sFields.length;
+ if (sCount !== tFields.length)
+ return false;
+ if (s._primary !== t._primary)
+ return false;
+ for (i = 0; i < sCount; ++i)
+ if (!A._isSubtype(universe, sFields[i], sEnv, tFields[i], tEnv))
+ return false;
+ return true;
+ },
+ isNullable(t) {
+ var t1,
+ kind = t._kind;
+ if (!(t === type$.Null || t === type$.JSNull))
+ if (!A.isStrongTopType(t))
+ if (kind !== 7)
+ if (!(kind === 6 && A.isNullable(t._primary)))
+ t1 = kind === 8 && A.isNullable(t._primary);
+ else
+ t1 = true;
+ else
+ t1 = true;
+ else
+ t1 = true;
+ else
+ t1 = true;
+ return t1;
+ },
+ isTopType(t) {
+ var t1;
+ if (!A.isStrongTopType(t))
+ if (!(t === type$.legacy_Object))
+ t1 = false;
+ else
+ t1 = true;
+ else
+ t1 = true;
+ return t1;
+ },
+ isStrongTopType(t) {
+ var kind = t._kind;
+ return kind === 2 || kind === 3 || kind === 4 || kind === 5 || t === type$.nullable_Object;
+ },
+ _Utils_objectAssign(o, other) {
+ var i, key,
+ keys = Object.keys(other),
+ $length = keys.length;
+ for (i = 0; i < $length; ++i) {
+ key = keys[i];
+ o[key] = other[key];
+ }
+ },
+ _Utils_newArrayOrEmpty($length) {
+ return $length > 0 ? new Array($length) : init.typeUniverse.sEA;
+ },
+ Rti: function Rti(t0, t1) {
+ var _ = this;
+ _._as = t0;
+ _._is = t1;
+ _._cachedRuntimeType = _._specializedTestResource = _._unsoundIsSubtypeCache = _._isSubtypeCache = _._precomputed1 = null;
+ _._kind = 0;
+ _._canonicalRecipe = _._bindCache = _._evalCache = _._rest = _._primary = null;
+ },
+ _FunctionParameters: function _FunctionParameters() {
+ this._named = this._optionalPositional = this._requiredPositional = null;
+ },
+ _Type: function _Type(t0) {
+ this._rti = t0;
+ },
+ _Error: function _Error() {
+ },
+ _TypeError: function _TypeError(t0) {
+ this.__rti$_message = t0;
+ },
+ _AsyncRun__initializeScheduleImmediate() {
+ var div, span, t1 = {};
+ if (self.scheduleImmediate != null)
+ return A.async__AsyncRun__scheduleImmediateJsOverride$closure();
+ if (self.MutationObserver != null && self.document != null) {
+ div = self.document.createElement("div");
+ span = self.document.createElement("span");
+ t1.storedCallback = null;
+ new self.MutationObserver(A.convertDartClosureToJS(new A._AsyncRun__initializeScheduleImmediate_internalCallback(t1), 1)).observe(div, {childList: true});
+ return new A._AsyncRun__initializeScheduleImmediate_closure(t1, div, span);
+ } else if (self.setImmediate != null)
+ return A.async__AsyncRun__scheduleImmediateWithSetImmediate$closure();
+ return A.async__AsyncRun__scheduleImmediateWithTimer$closure();
+ },
+ _AsyncRun__scheduleImmediateJsOverride(callback) {
+ self.scheduleImmediate(A.convertDartClosureToJS(new A._AsyncRun__scheduleImmediateJsOverride_internalCallback(type$.void_Function._as(callback)), 0));
+ },
+ _AsyncRun__scheduleImmediateWithSetImmediate(callback) {
+ self.setImmediate(A.convertDartClosureToJS(new A._AsyncRun__scheduleImmediateWithSetImmediate_internalCallback(type$.void_Function._as(callback)), 0));
+ },
+ _AsyncRun__scheduleImmediateWithTimer(callback) {
+ A.Timer__createTimer(B.Duration_0, type$.void_Function._as(callback));
+ },
+ Timer__createTimer(duration, callback) {
+ var milliseconds = B.JSInt_methods._tdivFast$1(duration._duration, 1000);
+ return A._TimerImpl$(milliseconds, callback);
+ },
+ Timer__createPeriodicTimer(duration, callback) {
+ var milliseconds = B.JSInt_methods._tdivFast$1(duration._duration, 1000);
+ return A._TimerImpl$periodic(milliseconds, callback);
+ },
+ _TimerImpl$(milliseconds, callback) {
+ var t1 = new A._TimerImpl();
+ t1._TimerImpl$2(milliseconds, callback);
+ return t1;
+ },
+ _TimerImpl$periodic(milliseconds, callback) {
+ var t1 = new A._TimerImpl();
+ t1._TimerImpl$periodic$2(milliseconds, callback);
+ return t1;
+ },
+ AsyncError$(error, stackTrace) {
+ var t1 = A.checkNotNullable(error, "error", type$.Object);
+ return new A.AsyncError(t1, stackTrace == null ? A.AsyncError_defaultStackTrace(error) : stackTrace);
+ },
+ AsyncError_defaultStackTrace(error) {
+ var stackTrace;
+ if (type$.Error._is(error)) {
+ stackTrace = error.get$stackTrace();
+ if (stackTrace != null)
+ return stackTrace;
+ }
+ return B._StringStackTrace_3uE;
+ },
+ Future_Future$value(value, $T) {
+ var t1;
+ $T._as(value);
+ t1 = new A._Future($.Zone__current, $T._eval$1("_Future<0>"));
+ t1._asyncComplete$1(value);
+ return t1;
+ },
+ _Future__chainCoreFutureSync(source, target) {
+ var t1, t2, listeners;
+ for (t1 = type$._Future_dynamic; t2 = source._async$_state, (t2 & 4) !== 0;)
+ source = t1._as(source._resultOrListeners);
+ if ((t2 & 24) !== 0) {
+ listeners = target._removeListeners$0();
+ target._cloneResult$1(source);
+ A._Future__propagateToListeners(target, listeners);
+ } else {
+ listeners = type$.nullable__FutureListener_dynamic_dynamic._as(target._resultOrListeners);
+ target._setChained$1(source);
+ source._prependListeners$1(listeners);
+ }
+ },
+ _Future__chainCoreFutureAsync(source, target) {
+ var t2, t3, listeners, _box_0 = {},
+ t1 = _box_0.source = source;
+ for (t2 = type$._Future_dynamic; t3 = t1._async$_state, (t3 & 4) !== 0; t1 = source) {
+ source = t2._as(t1._resultOrListeners);
+ _box_0.source = source;
+ }
+ if ((t3 & 24) === 0) {
+ listeners = type$.nullable__FutureListener_dynamic_dynamic._as(target._resultOrListeners);
+ target._setChained$1(t1);
+ _box_0.source._prependListeners$1(listeners);
+ return;
+ }
+ if ((t3 & 16) === 0 && target._resultOrListeners == null) {
+ target._cloneResult$1(t1);
+ return;
+ }
+ target._async$_state ^= 2;
+ target._zone.scheduleMicrotask$1(new A._Future__chainCoreFutureAsync_closure(_box_0, target));
+ },
+ _Future__propagateToListeners(source, listeners) {
+ var t2, t3, t4, _box_0, t5, t6, hasError, asyncError, nextListener, nextListener0, sourceResult, t7, zone, oldZone, result, current, _box_1 = {},
+ t1 = _box_1.source = source;
+ for (t2 = type$.AsyncError, t3 = type$.nullable__FutureListener_dynamic_dynamic, t4 = type$.Future_dynamic; true;) {
+ _box_0 = {};
+ t5 = t1._async$_state;
+ t6 = (t5 & 16) === 0;
+ hasError = !t6;
+ if (listeners == null) {
+ if (hasError && (t5 & 1) === 0) {
+ asyncError = t2._as(t1._resultOrListeners);
+ t1._zone.handleUncaughtError$2(asyncError.error, asyncError.stackTrace);
+ }
+ return;
+ }
+ _box_0.listener = listeners;
+ nextListener = listeners._nextListener;
+ for (t1 = listeners; nextListener != null; t1 = nextListener, nextListener = nextListener0) {
+ t1._nextListener = null;
+ A._Future__propagateToListeners(_box_1.source, t1);
+ _box_0.listener = nextListener;
+ nextListener0 = nextListener._nextListener;
+ }
+ t5 = _box_1.source;
+ sourceResult = t5._resultOrListeners;
+ _box_0.listenerHasError = hasError;
+ _box_0.listenerValueOrError = sourceResult;
+ if (t6) {
+ t7 = t1.state;
+ t7 = (t7 & 1) !== 0 || (t7 & 15) === 8;
+ } else
+ t7 = true;
+ if (t7) {
+ zone = t1.result._zone;
+ if (hasError) {
+ t1 = t5._zone;
+ t1 = !(t1 === zone || t1.get$errorZone() === zone.get$errorZone());
+ } else
+ t1 = false;
+ if (t1) {
+ t1 = _box_1.source;
+ asyncError = t2._as(t1._resultOrListeners);
+ t1._zone.handleUncaughtError$2(asyncError.error, asyncError.stackTrace);
+ return;
+ }
+ oldZone = $.Zone__current;
+ if (oldZone !== zone)
+ $.Zone__current = zone;
+ else
+ oldZone = null;
+ t1 = _box_0.listener.state;
+ if ((t1 & 15) === 8)
+ new A._Future__propagateToListeners_handleWhenCompleteCallback(_box_0, _box_1, hasError).call$0();
+ else if (t6) {
+ if ((t1 & 1) !== 0)
+ new A._Future__propagateToListeners_handleValueCallback(_box_0, sourceResult).call$0();
+ } else if ((t1 & 2) !== 0)
+ new A._Future__propagateToListeners_handleError(_box_1, _box_0).call$0();
+ if (oldZone != null)
+ $.Zone__current = oldZone;
+ t1 = _box_0.listenerValueOrError;
+ if (t1 instanceof A._Future) {
+ t5 = _box_0.listener.$ti;
+ t5 = t5._eval$1("Future<2>")._is(t1) || !t5._rest[1]._is(t1);
+ } else
+ t5 = false;
+ if (t5) {
+ t4._as(t1);
+ result = _box_0.listener.result;
+ if ((t1._async$_state & 24) !== 0) {
+ current = t3._as(result._resultOrListeners);
+ result._resultOrListeners = null;
+ listeners = result._reverseListeners$1(current);
+ result._async$_state = t1._async$_state & 30 | result._async$_state & 1;
+ result._resultOrListeners = t1._resultOrListeners;
+ _box_1.source = t1;
+ continue;
+ } else
+ A._Future__chainCoreFutureSync(t1, result);
+ return;
+ }
+ }
+ result = _box_0.listener.result;
+ current = t3._as(result._resultOrListeners);
+ result._resultOrListeners = null;
+ listeners = result._reverseListeners$1(current);
+ t1 = _box_0.listenerHasError;
+ t5 = _box_0.listenerValueOrError;
+ if (!t1) {
+ result.$ti._precomputed1._as(t5);
+ result._async$_state = 8;
+ result._resultOrListeners = t5;
+ } else {
+ t2._as(t5);
+ result._async$_state = result._async$_state & 1 | 16;
+ result._resultOrListeners = t5;
+ }
+ _box_1.source = result;
+ t1 = result;
+ }
+ },
+ _registerErrorHandler(errorHandler, zone) {
+ if (type$.dynamic_Function_Object_StackTrace._is(errorHandler))
+ return zone.registerBinaryCallback$3$1(errorHandler, type$.dynamic, type$.Object, type$.StackTrace);
+ if (type$.dynamic_Function_Object._is(errorHandler))
+ return zone.registerUnaryCallback$2$1(errorHandler, type$.dynamic, type$.Object);
+ throw A.wrapException(A.ArgumentError$value(errorHandler, "onError", string$.Error_));
+ },
+ _microtaskLoop() {
+ var entry, next;
+ for (entry = $._nextCallback; entry != null; entry = $._nextCallback) {
+ $._lastPriorityCallback = null;
+ next = entry.next;
+ $._nextCallback = next;
+ if (next == null)
+ $._lastCallback = null;
+ entry.callback.call$0();
+ }
+ },
+ _startMicrotaskLoop() {
+ $._isInCallbackLoop = true;
+ try {
+ A._microtaskLoop();
+ } finally {
+ $._lastPriorityCallback = null;
+ $._isInCallbackLoop = false;
+ if ($._nextCallback != null)
+ $.$get$_AsyncRun__scheduleImmediateClosure().call$1(A.async___startMicrotaskLoop$closure());
+ }
+ },
+ _scheduleAsyncCallback(callback) {
+ var newEntry = new A._AsyncCallbackEntry(callback),
+ lastCallback = $._lastCallback;
+ if (lastCallback == null) {
+ $._nextCallback = $._lastCallback = newEntry;
+ if (!$._isInCallbackLoop)
+ $.$get$_AsyncRun__scheduleImmediateClosure().call$1(A.async___startMicrotaskLoop$closure());
+ } else
+ $._lastCallback = lastCallback.next = newEntry;
+ },
+ _schedulePriorityAsyncCallback(callback) {
+ var entry, lastPriorityCallback, next,
+ t1 = $._nextCallback;
+ if (t1 == null) {
+ A._scheduleAsyncCallback(callback);
+ $._lastPriorityCallback = $._lastCallback;
+ return;
+ }
+ entry = new A._AsyncCallbackEntry(callback);
+ lastPriorityCallback = $._lastPriorityCallback;
+ if (lastPriorityCallback == null) {
+ entry.next = t1;
+ $._nextCallback = $._lastPriorityCallback = entry;
+ } else {
+ next = lastPriorityCallback.next;
+ entry.next = next;
+ $._lastPriorityCallback = lastPriorityCallback.next = entry;
+ if (next == null)
+ $._lastCallback = entry;
+ }
+ },
+ scheduleMicrotask(callback) {
+ var t1, _null = null,
+ currentZone = $.Zone__current;
+ if (B.C__RootZone === currentZone) {
+ A._rootScheduleMicrotask(_null, _null, B.C__RootZone, callback);
+ return;
+ }
+ if (B.C__RootZone === currentZone.get$_scheduleMicrotask().zone)
+ t1 = B.C__RootZone.get$errorZone() === currentZone.get$errorZone();
+ else
+ t1 = false;
+ if (t1) {
+ A._rootScheduleMicrotask(_null, _null, currentZone, currentZone.registerCallback$1$1(callback, type$.void));
+ return;
+ }
+ t1 = $.Zone__current;
+ t1.scheduleMicrotask$1(t1.bindCallbackGuarded$1(callback));
+ },
+ StreamController_StreamController(onCancel, onListen, sync, $T) {
+ return new A._SyncStreamController(onListen, null, null, onCancel, $T._eval$1("_SyncStreamController<0>"));
+ },
+ _runGuarded(notificationHandler) {
+ var e, s, exception;
+ if (notificationHandler == null)
+ return;
+ try {
+ notificationHandler.call$0();
+ } catch (exception) {
+ e = A.unwrapException(exception);
+ s = A.getTraceFromException(exception);
+ $.Zone__current.handleUncaughtError$2(e, s);
+ }
+ },
+ _BufferingStreamSubscription__registerDataHandler(zone, handleData, $T) {
+ var t1 = handleData == null ? A.async___nullDataHandler$closure() : handleData;
+ return zone.registerUnaryCallback$2$1(t1, type$.void, $T);
+ },
+ _BufferingStreamSubscription__registerErrorHandler(zone, handleError) {
+ if (handleError == null)
+ handleError = A.async___nullErrorHandler$closure();
+ if (type$.void_Function_Object_StackTrace._is(handleError))
+ return zone.registerBinaryCallback$3$1(handleError, type$.dynamic, type$.Object, type$.StackTrace);
+ if (type$.void_Function_Object._is(handleError))
+ return zone.registerUnaryCallback$2$1(handleError, type$.dynamic, type$.Object);
+ throw A.wrapException(A.ArgumentError$(string$.handle, null));
+ },
+ _nullDataHandler(value) {
+ },
+ _nullErrorHandler(error, stackTrace) {
+ type$.Object._as(error);
+ type$.StackTrace._as(stackTrace);
+ $.Zone__current.handleUncaughtError$2(error, stackTrace);
+ },
+ _nullDoneHandler() {
+ },
+ Timer_Timer$periodic(duration, callback) {
+ var boundCallback,
+ t1 = $.Zone__current;
+ if (t1 === B.C__RootZone)
+ return t1.createPeriodicTimer$2(duration, callback);
+ boundCallback = t1.bindUnaryCallbackGuarded$1$1(callback, type$.Timer);
+ return $.Zone__current.createPeriodicTimer$2(duration, boundCallback);
+ },
+ ZoneSpecification_ZoneSpecification$from(other, handleUncaughtError) {
+ var t1 = handleUncaughtError == null ? other.handleUncaughtError : handleUncaughtError;
+ return new A._ZoneSpecification(t1, other.run, other.runUnary, other.runBinary, other.registerCallback, other.registerUnaryCallback, other.registerBinaryCallback, other.errorCallback, other.scheduleMicrotask, other.createTimer, other.createPeriodicTimer, other.print, other.fork);
+ },
+ _rootHandleUncaughtError($self, $parent, zone, error, stackTrace) {
+ A._rootHandleError(error, type$.StackTrace._as(stackTrace));
+ },
+ _rootHandleError(error, stackTrace) {
+ A._schedulePriorityAsyncCallback(new A._rootHandleError_closure(error, stackTrace));
+ },
+ _rootRun($self, $parent, zone, f, $R) {
+ var old, t1;
+ type$.nullable_Zone._as($self);
+ type$.nullable_ZoneDelegate._as($parent);
+ type$.Zone._as(zone);
+ $R._eval$1("0()")._as(f);
+ t1 = $.Zone__current;
+ if (t1 === zone)
+ return f.call$0();
+ $.Zone__current = zone;
+ old = t1;
+ try {
+ t1 = f.call$0();
+ return t1;
+ } finally {
+ $.Zone__current = old;
+ }
+ },
+ _rootRunUnary($self, $parent, zone, f, arg, $R, $T) {
+ var old, t1;
+ type$.nullable_Zone._as($self);
+ type$.nullable_ZoneDelegate._as($parent);
+ type$.Zone._as(zone);
+ $R._eval$1("@<0>")._bind$1($T)._eval$1("1(2)")._as(f);
+ $T._as(arg);
+ t1 = $.Zone__current;
+ if (t1 === zone)
+ return f.call$1(arg);
+ $.Zone__current = zone;
+ old = t1;
+ try {
+ t1 = f.call$1(arg);
+ return t1;
+ } finally {
+ $.Zone__current = old;
+ }
+ },
+ _rootRunBinary($self, $parent, zone, f, arg1, arg2, $R, T1, T2) {
+ var old, t1;
+ type$.nullable_Zone._as($self);
+ type$.nullable_ZoneDelegate._as($parent);
+ type$.Zone._as(zone);
+ $R._eval$1("@<0>")._bind$1(T1)._bind$1(T2)._eval$1("1(2,3)")._as(f);
+ T1._as(arg1);
+ T2._as(arg2);
+ t1 = $.Zone__current;
+ if (t1 === zone)
+ return f.call$2(arg1, arg2);
+ $.Zone__current = zone;
+ old = t1;
+ try {
+ t1 = f.call$2(arg1, arg2);
+ return t1;
+ } finally {
+ $.Zone__current = old;
+ }
+ },
+ _rootRegisterCallback($self, $parent, zone, f, $R) {
+ return $R._eval$1("0()")._as(f);
+ },
+ _rootRegisterUnaryCallback($self, $parent, zone, f, $R, $T) {
+ return $R._eval$1("@<0>")._bind$1($T)._eval$1("1(2)")._as(f);
+ },
+ _rootRegisterBinaryCallback($self, $parent, zone, f, $R, T1, T2) {
+ return $R._eval$1("@<0>")._bind$1(T1)._bind$1(T2)._eval$1("1(2,3)")._as(f);
+ },
+ _rootErrorCallback($self, $parent, zone, error, stackTrace) {
+ type$.nullable_StackTrace._as(stackTrace);
+ return null;
+ },
+ _rootScheduleMicrotask($self, $parent, zone, f) {
+ var t1, t2;
+ type$.void_Function._as(f);
+ if (B.C__RootZone !== zone) {
+ t1 = B.C__RootZone.get$errorZone();
+ t2 = zone.get$errorZone();
+ f = t1 !== t2 ? zone.bindCallbackGuarded$1(f) : zone.bindCallback$1$1(f, type$.void);
+ }
+ A._scheduleAsyncCallback(f);
+ },
+ _rootCreateTimer($self, $parent, zone, duration, callback) {
+ type$.Duration._as(duration);
+ type$.void_Function._as(callback);
+ return A.Timer__createTimer(duration, B.C__RootZone !== zone ? zone.bindCallback$1$1(callback, type$.void) : callback);
+ },
+ _rootCreatePeriodicTimer($self, $parent, zone, duration, callback) {
+ type$.Duration._as(duration);
+ type$.void_Function_Timer._as(callback);
+ return A.Timer__createPeriodicTimer(duration, B.C__RootZone !== zone ? zone.bindUnaryCallback$2$1(callback, type$.void, type$.Timer) : callback);
+ },
+ _rootPrint($self, $parent, zone, line) {
+ A.printString(A.S(A._asString(line)));
+ },
+ _rootFork($self, $parent, zone, specification, zoneValues) {
+ var valueMap, t1, handleUncaughtError;
+ type$.nullable_ZoneSpecification._as(specification);
+ type$.nullable_Map_of_nullable_Object_and_nullable_Object._as(zoneValues);
+ valueMap = zone.get$_async$_map();
+ t1 = new A._CustomZone(zone.get$_run(), zone.get$_runUnary(), zone.get$_runBinary(), zone.get$_registerCallback(), zone.get$_registerUnaryCallback(), zone.get$_registerBinaryCallback(), zone.get$_errorCallback(), zone.get$_scheduleMicrotask(), zone.get$_createTimer(), zone.get$_createPeriodicTimer(), zone.get$_print(), zone.get$_fork(), zone.get$_handleUncaughtError(), zone, valueMap);
+ handleUncaughtError = specification.handleUncaughtError;
+ if (handleUncaughtError != null)
+ t1.set$_handleUncaughtError(new A._ZoneFunction(t1, handleUncaughtError, type$._ZoneFunction_of_void_Function_Zone_ZoneDelegate_Zone_Object_StackTrace));
+ return t1;
+ },
+ runZonedGuarded(body, onError, $R) {
+ var error, stackTrace, parentZone, errorHandler, t1, exception, _null = null, zoneSpecification = null, zoneValues = null;
+ A.checkNotNullable(body, "body", $R._eval$1("0()"));
+ A.checkNotNullable(onError, "onError", type$.void_Function_Object_StackTrace);
+ parentZone = $.Zone__current;
+ errorHandler = new A.runZonedGuarded_closure(parentZone, onError);
+ if (zoneSpecification == null)
+ zoneSpecification = new A._ZoneSpecification(errorHandler, _null, _null, _null, _null, _null, _null, _null, _null, _null, _null, _null, _null);
+ else
+ zoneSpecification = A.ZoneSpecification_ZoneSpecification$from(zoneSpecification, errorHandler);
+ try {
+ t1 = parentZone.fork$2$specification$zoneValues(zoneSpecification, zoneValues).run$1$1(body, $R);
+ return t1;
+ } catch (exception) {
+ error = A.unwrapException(exception);
+ stackTrace = A.getTraceFromException(exception);
+ onError.call$2(error, stackTrace);
+ }
+ return _null;
+ },
+ _AsyncRun__initializeScheduleImmediate_internalCallback: function _AsyncRun__initializeScheduleImmediate_internalCallback(t0) {
+ this._box_0 = t0;
+ },
+ _AsyncRun__initializeScheduleImmediate_closure: function _AsyncRun__initializeScheduleImmediate_closure(t0, t1, t2) {
+ this._box_0 = t0;
+ this.div = t1;
+ this.span = t2;
+ },
+ _AsyncRun__scheduleImmediateJsOverride_internalCallback: function _AsyncRun__scheduleImmediateJsOverride_internalCallback(t0) {
+ this.callback = t0;
+ },
+ _AsyncRun__scheduleImmediateWithSetImmediate_internalCallback: function _AsyncRun__scheduleImmediateWithSetImmediate_internalCallback(t0) {
+ this.callback = t0;
+ },
+ _TimerImpl: function _TimerImpl() {
+ this._tick = 0;
+ },
+ _TimerImpl_internalCallback: function _TimerImpl_internalCallback(t0, t1) {
+ this.$this = t0;
+ this.callback = t1;
+ },
+ _TimerImpl$periodic_closure: function _TimerImpl$periodic_closure(t0, t1, t2, t3) {
+ var _ = this;
+ _.$this = t0;
+ _.milliseconds = t1;
+ _.start = t2;
+ _.callback = t3;
+ },
+ AsyncError: function AsyncError(t0, t1) {
+ this.error = t0;
+ this.stackTrace = t1;
+ },
+ _Completer: function _Completer() {
+ },
+ _AsyncCompleter: function _AsyncCompleter(t0, t1) {
+ this.future = t0;
+ this.$ti = t1;
+ },
+ _SyncCompleter: function _SyncCompleter(t0, t1) {
+ this.future = t0;
+ this.$ti = t1;
+ },
+ _FutureListener: function _FutureListener(t0, t1, t2, t3, t4) {
+ var _ = this;
+ _._nextListener = null;
+ _.result = t0;
+ _.state = t1;
+ _.callback = t2;
+ _.errorCallback = t3;
+ _.$ti = t4;
+ },
+ _Future: function _Future(t0, t1) {
+ var _ = this;
+ _._async$_state = 0;
+ _._zone = t0;
+ _._resultOrListeners = null;
+ _.$ti = t1;
+ },
+ _Future__addListener_closure: function _Future__addListener_closure(t0, t1) {
+ this.$this = t0;
+ this.listener = t1;
+ },
+ _Future__prependListeners_closure: function _Future__prependListeners_closure(t0, t1) {
+ this._box_0 = t0;
+ this.$this = t1;
+ },
+ _Future__chainForeignFuture_closure: function _Future__chainForeignFuture_closure(t0) {
+ this.$this = t0;
+ },
+ _Future__chainForeignFuture_closure0: function _Future__chainForeignFuture_closure0(t0) {
+ this.$this = t0;
+ },
+ _Future__chainForeignFuture_closure1: function _Future__chainForeignFuture_closure1(t0, t1, t2) {
+ this.$this = t0;
+ this.e = t1;
+ this.s = t2;
+ },
+ _Future__chainCoreFutureAsync_closure: function _Future__chainCoreFutureAsync_closure(t0, t1) {
+ this._box_0 = t0;
+ this.target = t1;
+ },
+ _Future__asyncCompleteWithValue_closure: function _Future__asyncCompleteWithValue_closure(t0, t1) {
+ this.$this = t0;
+ this.value = t1;
+ },
+ _Future__asyncCompleteError_closure: function _Future__asyncCompleteError_closure(t0, t1, t2) {
+ this.$this = t0;
+ this.error = t1;
+ this.stackTrace = t2;
+ },
+ _Future__propagateToListeners_handleWhenCompleteCallback: function _Future__propagateToListeners_handleWhenCompleteCallback(t0, t1, t2) {
+ this._box_0 = t0;
+ this._box_1 = t1;
+ this.hasError = t2;
+ },
+ _Future__propagateToListeners_handleWhenCompleteCallback_closure: function _Future__propagateToListeners_handleWhenCompleteCallback_closure(t0) {
+ this.originalSource = t0;
+ },
+ _Future__propagateToListeners_handleValueCallback: function _Future__propagateToListeners_handleValueCallback(t0, t1) {
+ this._box_0 = t0;
+ this.sourceResult = t1;
+ },
+ _Future__propagateToListeners_handleError: function _Future__propagateToListeners_handleError(t0, t1) {
+ this._box_1 = t0;
+ this._box_0 = t1;
+ },
+ _AsyncCallbackEntry: function _AsyncCallbackEntry(t0) {
+ this.callback = t0;
+ this.next = null;
+ },
+ Stream: function Stream() {
+ },
+ Stream_pipe_closure: function Stream_pipe_closure(t0) {
+ this.streamConsumer = t0;
+ },
+ Stream_length_closure: function Stream_length_closure(t0, t1) {
+ this._box_0 = t0;
+ this.$this = t1;
+ },
+ Stream_length_closure0: function Stream_length_closure0(t0, t1) {
+ this._box_0 = t0;
+ this.future = t1;
+ },
+ _StreamController: function _StreamController() {
+ },
+ _StreamController__subscribe_closure: function _StreamController__subscribe_closure(t0) {
+ this.$this = t0;
+ },
+ _StreamController__recordCancel_complete: function _StreamController__recordCancel_complete(t0) {
+ this.$this = t0;
+ },
+ _SyncStreamControllerDispatch: function _SyncStreamControllerDispatch() {
+ },
+ _SyncStreamController: function _SyncStreamController(t0, t1, t2, t3, t4) {
+ var _ = this;
+ _._varData = null;
+ _._async$_state = 0;
+ _._doneFuture = null;
+ _.onListen = t0;
+ _.onPause = t1;
+ _.onResume = t2;
+ _.onCancel = t3;
+ _.$ti = t4;
+ },
+ _ControllerStream: function _ControllerStream(t0, t1) {
+ this._controller = t0;
+ this.$ti = t1;
+ },
+ _ControllerSubscription: function _ControllerSubscription(t0, t1, t2, t3, t4, t5, t6) {
+ var _ = this;
+ _._controller = t0;
+ _._onData = t1;
+ _._onError = t2;
+ _._onDone = t3;
+ _._zone = t4;
+ _._async$_state = t5;
+ _._pending = _._cancelFuture = null;
+ _.$ti = t6;
+ },
+ _StreamSinkWrapper: function _StreamSinkWrapper(t0, t1) {
+ this._target = t0;
+ this.$ti = t1;
+ },
+ _AddStreamState_cancel_closure: function _AddStreamState_cancel_closure(t0) {
+ this.$this = t0;
+ },
+ _BufferingStreamSubscription: function _BufferingStreamSubscription() {
+ },
+ _BufferingStreamSubscription__sendError_sendError: function _BufferingStreamSubscription__sendError_sendError(t0, t1, t2) {
+ this.$this = t0;
+ this.error = t1;
+ this.stackTrace = t2;
+ },
+ _BufferingStreamSubscription__sendDone_sendDone: function _BufferingStreamSubscription__sendDone_sendDone(t0) {
+ this.$this = t0;
+ },
+ _StreamImpl: function _StreamImpl() {
+ },
+ _DelayedEvent: function _DelayedEvent() {
+ },
+ _DelayedData: function _DelayedData(t0, t1) {
+ this.value = t0;
+ this.next = null;
+ this.$ti = t1;
+ },
+ _DelayedError: function _DelayedError(t0, t1) {
+ this.error = t0;
+ this.stackTrace = t1;
+ this.next = null;
+ },
+ _DelayedDone: function _DelayedDone() {
+ },
+ _PendingEvents: function _PendingEvents(t0) {
+ var _ = this;
+ _._async$_state = 0;
+ _.lastPendingEvent = _.firstPendingEvent = null;
+ _.$ti = t0;
+ },
+ _PendingEvents_schedule_closure: function _PendingEvents_schedule_closure(t0, t1) {
+ this.$this = t0;
+ this.dispatch = t1;
+ },
+ _DoneStreamSubscription: function _DoneStreamSubscription(t0, t1) {
+ var _ = this;
+ _._async$_state = 1;
+ _._zone = t0;
+ _._onDone = null;
+ _.$ti = t1;
+ },
+ _EmptyStream: function _EmptyStream(t0) {
+ this.$ti = t0;
+ },
+ _ZoneFunction: function _ZoneFunction(t0, t1, t2) {
+ this.zone = t0;
+ this.$function = t1;
+ this.$ti = t2;
+ },
+ _ZoneSpecification: function _ZoneSpecification(t0, t1, t2, t3, t4, t5, t6, t7, t8, t9, t10, t11, t12) {
+ var _ = this;
+ _.handleUncaughtError = t0;
+ _.run = t1;
+ _.runUnary = t2;
+ _.runBinary = t3;
+ _.registerCallback = t4;
+ _.registerUnaryCallback = t5;
+ _.registerBinaryCallback = t6;
+ _.errorCallback = t7;
+ _.scheduleMicrotask = t8;
+ _.createTimer = t9;
+ _.createPeriodicTimer = t10;
+ _.print = t11;
+ _.fork = t12;
+ },
+ _ZoneDelegate: function _ZoneDelegate(t0) {
+ this._delegationTarget = t0;
+ },
+ _Zone: function _Zone() {
+ },
+ _CustomZone: function _CustomZone(t0, t1, t2, t3, t4, t5, t6, t7, t8, t9, t10, t11, t12, t13, t14) {
+ var _ = this;
+ _._run = t0;
+ _._runUnary = t1;
+ _._runBinary = t2;
+ _._registerCallback = t3;
+ _._registerUnaryCallback = t4;
+ _._registerBinaryCallback = t5;
+ _._errorCallback = t6;
+ _._scheduleMicrotask = t7;
+ _._createTimer = t8;
+ _._createPeriodicTimer = t9;
+ _._print = t10;
+ _._fork = t11;
+ _._handleUncaughtError = t12;
+ _._delegateCache = null;
+ _.parent = t13;
+ _._async$_map = t14;
+ },
+ _CustomZone_bindCallback_closure: function _CustomZone_bindCallback_closure(t0, t1, t2) {
+ this.$this = t0;
+ this.registered = t1;
+ this.R = t2;
+ },
+ _CustomZone_bindUnaryCallback_closure: function _CustomZone_bindUnaryCallback_closure(t0, t1, t2, t3) {
+ var _ = this;
+ _.$this = t0;
+ _.registered = t1;
+ _.T = t2;
+ _.R = t3;
+ },
+ _CustomZone_bindCallbackGuarded_closure: function _CustomZone_bindCallbackGuarded_closure(t0, t1) {
+ this.$this = t0;
+ this.registered = t1;
+ },
+ _CustomZone_bindUnaryCallbackGuarded_closure: function _CustomZone_bindUnaryCallbackGuarded_closure(t0, t1, t2) {
+ this.$this = t0;
+ this.registered = t1;
+ this.T = t2;
+ },
+ _rootHandleError_closure: function _rootHandleError_closure(t0, t1) {
+ this.error = t0;
+ this.stackTrace = t1;
+ },
+ _RootZone: function _RootZone() {
+ },
+ _RootZone_bindCallback_closure: function _RootZone_bindCallback_closure(t0, t1, t2) {
+ this.$this = t0;
+ this.f = t1;
+ this.R = t2;
+ },
+ _RootZone_bindUnaryCallback_closure: function _RootZone_bindUnaryCallback_closure(t0, t1, t2, t3) {
+ var _ = this;
+ _.$this = t0;
+ _.f = t1;
+ _.T = t2;
+ _.R = t3;
+ },
+ _RootZone_bindCallbackGuarded_closure: function _RootZone_bindCallbackGuarded_closure(t0, t1) {
+ this.$this = t0;
+ this.f = t1;
+ },
+ _RootZone_bindUnaryCallbackGuarded_closure: function _RootZone_bindUnaryCallbackGuarded_closure(t0, t1, t2) {
+ this.$this = t0;
+ this.f = t1;
+ this.T = t2;
+ },
+ runZonedGuarded_closure: function runZonedGuarded_closure(t0, t1) {
+ this.parentZone = t0;
+ this.onError = t1;
+ },
+ HashMap_HashMap($K, $V) {
+ return new A._HashMap($K._eval$1("@<0>")._bind$1($V)._eval$1("_HashMap<1,2>"));
+ },
+ _HashMap__getTableEntry(table, key) {
+ var entry = table[key];
+ return entry === table ? null : entry;
+ },
+ _HashMap__setTableEntry(table, key, value) {
+ if (value == null)
+ table[key] = table;
+ else
+ table[key] = value;
+ },
+ _HashMap__newHashTable() {
+ var table = Object.create(null);
+ A._HashMap__setTableEntry(table, "<non-identifier-key>", table);
+ delete table["<non-identifier-key>"];
+ return table;
+ },
+ LinkedHashMap_LinkedHashMap$_literal(keyValuePairs, $K, $V) {
+ return $K._eval$1("@<0>")._bind$1($V)._eval$1("LinkedHashMap<1,2>")._as(A.fillLiteralMap(keyValuePairs, new A.JsLinkedHashMap($K._eval$1("@<0>")._bind$1($V)._eval$1("JsLinkedHashMap<1,2>"))));
+ },
+ LinkedHashMap_LinkedHashMap$_empty($K, $V) {
+ return new A.JsLinkedHashMap($K._eval$1("@<0>")._bind$1($V)._eval$1("JsLinkedHashMap<1,2>"));
+ },
+ LinkedHashSet_LinkedHashSet$_empty($E) {
+ return new A._LinkedHashSet($E._eval$1("_LinkedHashSet<0>"));
+ },
+ _LinkedHashSet__newHashTable() {
+ var table = Object.create(null);
+ table["<non-identifier-key>"] = table;
+ delete table["<non-identifier-key>"];
+ return table;
+ },
+ _LinkedHashSetIterator$(_set, _modifications, $E) {
+ var t1 = new A._LinkedHashSetIterator(_set, _modifications, $E._eval$1("_LinkedHashSetIterator<0>"));
+ t1._collection$_cell = _set._collection$_first;
+ return t1;
+ },
+ MapBase_mapToString(m) {
+ var result, t1 = {};
+ if (A.isToStringVisiting(m))
+ return "{...}";
+ result = new A.StringBuffer("");
+ try {
+ B.JSArray_methods.add$1($.toStringVisiting, m);
+ result._contents += "{";
+ t1.first = true;
+ J.forEach$1$x(m, new A.MapBase_mapToString_closure(t1, result));
+ result._contents += "}";
+ } finally {
+ if (0 >= $.toStringVisiting.length)
+ return A.ioore($.toStringVisiting, -1);
+ $.toStringVisiting.pop();
+ }
+ t1 = result._contents;
+ return t1.charCodeAt(0) == 0 ? t1 : t1;
+ },
+ _HashMap: function _HashMap(t0) {
+ var _ = this;
+ _._collection$_length = 0;
+ _._keys = _._collection$_rest = _._collection$_nums = _._collection$_strings = null;
+ _.$ti = t0;
+ },
+ _IdentityHashMap: function _IdentityHashMap(t0) {
+ var _ = this;
+ _._collection$_length = 0;
+ _._keys = _._collection$_rest = _._collection$_nums = _._collection$_strings = null;
+ _.$ti = t0;
+ },
+ _HashMapKeyIterable: function _HashMapKeyIterable(t0, t1) {
+ this._collection$_map = t0;
+ this.$ti = t1;
+ },
+ _HashMapKeyIterator: function _HashMapKeyIterator(t0, t1, t2) {
+ var _ = this;
+ _._collection$_map = t0;
+ _._keys = t1;
+ _._offset = 0;
+ _._collection$_current = null;
+ _.$ti = t2;
+ },
+ _LinkedHashSet: function _LinkedHashSet(t0) {
+ var _ = this;
+ _._collection$_length = 0;
+ _._collection$_last = _._collection$_first = _._collection$_rest = _._collection$_nums = _._collection$_strings = null;
+ _._collection$_modifications = 0;
+ _.$ti = t0;
+ },
+ _LinkedHashSetCell: function _LinkedHashSetCell(t0) {
+ this._element = t0;
+ this._collection$_previous = this._collection$_next = null;
+ },
+ _LinkedHashSetIterator: function _LinkedHashSetIterator(t0, t1, t2) {
+ var _ = this;
+ _._set = t0;
+ _._collection$_modifications = t1;
+ _._collection$_current = _._collection$_cell = null;
+ _.$ti = t2;
+ },
+ ListBase: function ListBase() {
+ },
+ MapBase: function MapBase() {
+ },
+ MapBase_mapToString_closure: function MapBase_mapToString_closure(t0, t1) {
+ this._box_0 = t0;
+ this.result = t1;
+ },
+ _UnmodifiableMapMixin: function _UnmodifiableMapMixin() {
+ },
+ MapView: function MapView() {
+ },
+ UnmodifiableMapView: function UnmodifiableMapView(t0, t1) {
+ this._collection$_map = t0;
+ this.$ti = t1;
+ },
+ SetBase: function SetBase() {
+ },
+ _SetBase: function _SetBase() {
+ },
+ _UnmodifiableMapView_MapView__UnmodifiableMapMixin: function _UnmodifiableMapView_MapView__UnmodifiableMapMixin() {
+ },
+ _parseJson(source, reviver) {
+ var e, exception, t1, parsed = null;
+ try {
+ parsed = JSON.parse(source);
+ } catch (exception) {
+ e = A.unwrapException(exception);
+ t1 = A.FormatException$(String(e), null, null);
+ throw A.wrapException(t1);
+ }
+ t1 = A._convertJsonToDartLazy(parsed);
+ return t1;
+ },
+ _convertJsonToDartLazy(object) {
+ var i;
+ if (object == null)
+ return null;
+ if (typeof object != "object")
+ return object;
+ if (Object.getPrototypeOf(object) !== Array.prototype)
+ return new A._JsonMap(object, Object.create(null));
+ for (i = 0; i < object.length; ++i)
+ object[i] = A._convertJsonToDartLazy(object[i]);
+ return object;
+ },
+ Utf8Decoder__convertIntercepted(allowMalformed, codeUnits, start, end) {
+ var casted, result;
+ if (codeUnits instanceof Uint8Array) {
+ casted = codeUnits;
+ end = casted.length;
+ if (end - start < 15)
+ return null;
+ result = A.Utf8Decoder__convertInterceptedUint8List(allowMalformed, casted, start, end);
+ if (result != null && allowMalformed)
+ if (result.indexOf("\ufffd") >= 0)
+ return null;
+ return result;
+ }
+ return null;
+ },
+ Utf8Decoder__convertInterceptedUint8List(allowMalformed, codeUnits, start, end) {
+ var decoder = allowMalformed ? $.$get$Utf8Decoder__decoderNonfatal() : $.$get$Utf8Decoder__decoder();
+ if (decoder == null)
+ return null;
+ if (0 === start && end === codeUnits.length)
+ return A.Utf8Decoder__useTextDecoder(decoder, codeUnits);
+ return A.Utf8Decoder__useTextDecoder(decoder, codeUnits.subarray(start, A.RangeError_checkValidRange(start, end, codeUnits.length)));
+ },
+ Utf8Decoder__useTextDecoder(decoder, codeUnits) {
+ var t1, exception;
+ try {
+ t1 = decoder.decode(codeUnits);
+ return t1;
+ } catch (exception) {
+ }
+ return null;
+ },
+ Base64Codec__checkPadding(source, sourceIndex, sourceEnd, firstPadding, paddingCount, $length) {
+ if (B.JSInt_methods.$mod($length, 4) !== 0)
+ throw A.wrapException(A.FormatException$("Invalid base64 padding, padded length must be multiple of four, is " + $length, source, sourceEnd));
+ if (firstPadding + paddingCount !== $length)
+ throw A.wrapException(A.FormatException$("Invalid base64 padding, '=' not at the end", source, sourceIndex));
+ if (paddingCount > 2)
+ throw A.wrapException(A.FormatException$("Invalid base64 padding, more than two '=' characters", source, sourceIndex));
+ },
+ JsonUnsupportedObjectError$(unsupportedObject, cause, partialResult) {
+ return new A.JsonUnsupportedObjectError(unsupportedObject, cause);
+ },
+ _defaultToEncodable(object) {
+ return object.toJson$0();
+ },
+ _JsonStringStringifier$(_sink, _toEncodable) {
+ return new A._JsonStringStringifier(_sink, [], A.convert___defaultToEncodable$closure());
+ },
+ _JsonStringStringifier_stringify(object, toEncodable, indent) {
+ var t1,
+ output = new A.StringBuffer("");
+ A._JsonStringStringifier_printOn(object, output, toEncodable, indent);
+ t1 = output._contents;
+ return t1.charCodeAt(0) == 0 ? t1 : t1;
+ },
+ _JsonStringStringifier_printOn(object, output, toEncodable, indent) {
+ var stringifier = A._JsonStringStringifier$(output, toEncodable);
+ stringifier.writeObject$1(object);
+ },
+ _Utf8Decoder_errorDescription(state) {
+ switch (state) {
+ case 65:
+ return "Missing extension byte";
+ case 67:
+ return "Unexpected extension byte";
+ case 69:
+ return "Invalid UTF-8 byte";
+ case 71:
+ return "Overlong encoding";
+ case 73:
+ return "Out of unicode range";
+ case 75:
+ return "Encoded surrogate";
+ case 77:
+ return "Unfinished UTF-8 octet sequence";
+ default:
+ return "";
+ }
+ },
+ _Utf8Decoder__makeUint8List(codeUnits, start, end) {
+ var t1, i, b,
+ $length = end - start,
+ bytes = new Uint8Array($length);
+ for (t1 = J.getInterceptor$asx(codeUnits), i = 0; i < $length; ++i) {
+ b = t1.$index(codeUnits, start + i);
+ if ((b & 4294967040) >>> 0 !== 0)
+ b = 255;
+ if (!(i < $length))
+ return A.ioore(bytes, i);
+ bytes[i] = b;
+ }
+ return bytes;
+ },
+ _JsonMap: function _JsonMap(t0, t1) {
+ this._original = t0;
+ this._processed = t1;
+ this._data = null;
+ },
+ _JsonMapKeyIterable: function _JsonMapKeyIterable(t0) {
+ this._convert$_parent = t0;
+ },
+ Utf8Decoder__decoder_closure: function Utf8Decoder__decoder_closure() {
+ },
+ Utf8Decoder__decoderNonfatal_closure: function Utf8Decoder__decoderNonfatal_closure() {
+ },
+ AsciiCodec: function AsciiCodec() {
+ },
+ _UnicodeSubsetEncoder: function _UnicodeSubsetEncoder() {
+ },
+ AsciiEncoder: function AsciiEncoder(t0) {
+ this._subsetMask = t0;
+ },
+ Base64Codec: function Base64Codec() {
+ },
+ Base64Encoder: function Base64Encoder() {
+ },
+ Codec: function Codec() {
+ },
+ _FusedCodec: function _FusedCodec(t0, t1, t2) {
+ this._convert$_first = t0;
+ this._second = t1;
+ this.$ti = t2;
+ },
+ Converter: function Converter() {
+ },
+ Encoding: function Encoding() {
+ },
+ JsonUnsupportedObjectError: function JsonUnsupportedObjectError(t0, t1) {
+ this.unsupportedObject = t0;
+ this.cause = t1;
+ },
+ JsonCyclicError: function JsonCyclicError(t0, t1) {
+ this.unsupportedObject = t0;
+ this.cause = t1;
+ },
+ JsonCodec: function JsonCodec() {
+ },
+ JsonEncoder: function JsonEncoder(t0) {
+ this._toEncodable = t0;
+ },
+ JsonDecoder: function JsonDecoder(t0) {
+ this._reviver = t0;
+ },
+ _JsonStringifier: function _JsonStringifier() {
+ },
+ _JsonStringifier_writeMap_closure: function _JsonStringifier_writeMap_closure(t0, t1) {
+ this._box_0 = t0;
+ this.keyValueList = t1;
+ },
+ _JsonStringStringifier: function _JsonStringStringifier(t0, t1, t2) {
+ this._sink = t0;
+ this._seen = t1;
+ this._toEncodable = t2;
+ },
+ Utf8Codec: function Utf8Codec() {
+ },
+ Utf8Encoder: function Utf8Encoder() {
+ },
+ _Utf8Encoder: function _Utf8Encoder(t0) {
+ this._bufferIndex = this._carry = 0;
+ this._buffer = t0;
+ },
+ Utf8Decoder: function Utf8Decoder(t0) {
+ this._allowMalformed = t0;
+ },
+ _Utf8Decoder: function _Utf8Decoder(t0) {
+ this.allowMalformed = t0;
+ this._state = 16;
+ this._charOrIndex = 0;
+ },
+ int_parse(source, radix) {
+ var value = A.Primitives_parseInt(source, radix);
+ if (value != null)
+ return value;
+ throw A.wrapException(A.FormatException$(source, null, null));
+ },
+ Error__throw(error, stackTrace) {
+ error = A.wrapException(error);
+ if (error == null)
+ error = type$.Object._as(error);
+ error.stack = stackTrace.toString$0(0);
+ throw error;
+ throw A.wrapException("unreachable");
+ },
+ List_List$filled($length, fill, growable, $E) {
+ var i,
+ result = growable ? J.JSArray_JSArray$growable($length, $E) : J.JSArray_JSArray$fixed($length, $E);
+ if ($length !== 0 && fill != null)
+ for (i = 0; i < result.length; ++i)
+ result[i] = fill;
+ return result;
+ },
+ List_List$from(elements, growable, $E) {
+ var t1,
+ list = A._setArrayType([], $E._eval$1("JSArray<0>"));
+ for (t1 = J.get$iterator$ax(elements); t1.moveNext$0();)
+ B.JSArray_methods.add$1(list, $E._as(t1.get$current(t1)));
+ if (growable)
+ return list;
+ return J.JSArray_markFixedList(list, $E);
+ },
+ List_List$of(elements, growable, $E) {
+ var t1;
+ if (growable)
+ return A.List_List$_of(elements, $E);
+ t1 = J.JSArray_markFixedList(A.List_List$_of(elements, $E), $E);
+ return t1;
+ },
+ List_List$_of(elements, $E) {
+ var list, t1;
+ if (Array.isArray(elements))
+ return A._setArrayType(elements.slice(0), $E._eval$1("JSArray<0>"));
+ list = A._setArrayType([], $E._eval$1("JSArray<0>"));
+ for (t1 = J.get$iterator$ax(elements); t1.moveNext$0();)
+ B.JSArray_methods.add$1(list, t1.get$current(t1));
+ return list;
+ },
+ List_List$unmodifiable(elements, $E) {
+ return J.JSArray_markUnmodifiableList(A.List_List$from(elements, false, $E));
+ },
+ String_String$fromCharCodes(charCodes, start, end) {
+ var array, len;
+ if (Array.isArray(charCodes)) {
+ array = charCodes;
+ len = array.length;
+ end = A.RangeError_checkValidRange(start, end, len);
+ return A.Primitives_stringFromCharCodes(start > 0 || end < len ? array.slice(start, end) : array);
+ }
+ if (type$.NativeUint8List._is(charCodes))
+ return A.Primitives_stringFromNativeUint8List(charCodes, start, A.RangeError_checkValidRange(start, end, charCodes.length));
+ return A.String__stringFromIterable(charCodes, start, end);
+ },
+ String_String$fromCharCode(charCode) {
+ return A.Primitives_stringFromCharCode(charCode);
+ },
+ String__stringFromIterable(charCodes, start, end) {
+ var t1, it, i, list, _null = null;
+ if (start < 0)
+ throw A.wrapException(A.RangeError$range(start, 0, J.get$length$asx(charCodes), _null, _null));
+ t1 = end == null;
+ if (!t1 && end < start)
+ throw A.wrapException(A.RangeError$range(end, start, J.get$length$asx(charCodes), _null, _null));
+ it = J.get$iterator$ax(charCodes);
+ for (i = 0; i < start; ++i)
+ if (!it.moveNext$0())
+ throw A.wrapException(A.RangeError$range(start, 0, i, _null, _null));
+ list = [];
+ if (t1)
+ for (; it.moveNext$0();)
+ list.push(it.get$current(it));
+ else
+ for (i = start; i < end; ++i) {
+ if (!it.moveNext$0())
+ throw A.wrapException(A.RangeError$range(end, start, i, _null, _null));
+ list.push(it.get$current(it));
+ }
+ return A.Primitives_stringFromCharCodes(list);
+ },
+ RegExp_RegExp(source, multiLine) {
+ return new A.JSSyntaxRegExp(source, A.JSSyntaxRegExp_makeNative(source, multiLine, true, false, false, false));
+ },
+ StringBuffer__writeAll(string, objects, separator) {
+ var iterator = J.get$iterator$ax(objects);
+ if (!iterator.moveNext$0())
+ return string;
+ if (separator.length === 0) {
+ do
+ string += A.S(iterator.get$current(iterator));
+ while (iterator.moveNext$0());
+ } else {
+ string += A.S(iterator.get$current(iterator));
+ for (; iterator.moveNext$0();)
+ string = string + separator + A.S(iterator.get$current(iterator));
+ }
+ return string;
+ },
+ NoSuchMethodError_NoSuchMethodError$withInvocation(receiver, invocation) {
+ return new A.NoSuchMethodError(receiver, invocation.get$memberName(), invocation.get$positionalArguments(), invocation.get$namedArguments());
+ },
+ Uri_base() {
+ var cachedUri, uri,
+ current = A.Primitives_currentUri();
+ if (current == null)
+ throw A.wrapException(A.UnsupportedError$("'Uri.base' is not supported"));
+ cachedUri = $.Uri__cachedBaseUri;
+ if (cachedUri != null && current === $.Uri__cachedBaseString)
+ return cachedUri;
+ uri = A.Uri_parse(current);
+ $.Uri__cachedBaseUri = uri;
+ $.Uri__cachedBaseString = current;
+ return uri;
+ },
+ _Uri__uriEncode(canonicalTable, text, encoding, spaceToPlus) {
+ var t1, bytes, i, t2, byte, t3,
+ _s16_ = "0123456789ABCDEF";
+ if (encoding === B.C_Utf8Codec) {
+ t1 = $.$get$_Uri__needsNoEncoding();
+ t1 = t1._nativeRegExp.test(text);
+ } else
+ t1 = false;
+ if (t1)
+ return text;
+ bytes = B.C_Utf8Encoder.convert$1(text);
+ for (t1 = bytes.length, i = 0, t2 = ""; i < t1; ++i) {
+ byte = bytes[i];
+ if (byte < 128) {
+ t3 = byte >>> 4;
+ if (!(t3 < 8))
+ return A.ioore(canonicalTable, t3);
+ t3 = (canonicalTable[t3] & 1 << (byte & 15)) !== 0;
+ } else
+ t3 = false;
+ if (t3)
+ t2 += A.Primitives_stringFromCharCode(byte);
+ else
+ t2 = spaceToPlus && byte === 32 ? t2 + "+" : t2 + "%" + _s16_[byte >>> 4 & 15] + _s16_[byte & 15];
+ }
+ return t2.charCodeAt(0) == 0 ? t2 : t2;
+ },
+ DateTime__fourDigits(n) {
+ var absN = Math.abs(n),
+ sign = n < 0 ? "-" : "";
+ if (absN >= 1000)
+ return "" + n;
+ if (absN >= 100)
+ return sign + "0" + absN;
+ if (absN >= 10)
+ return sign + "00" + absN;
+ return sign + "000" + absN;
+ },
+ DateTime__threeDigits(n) {
+ if (n >= 100)
+ return "" + n;
+ if (n >= 10)
+ return "0" + n;
+ return "00" + n;
+ },
+ DateTime__twoDigits(n) {
+ if (n >= 10)
+ return "" + n;
+ return "0" + n;
+ },
+ Error_safeToString(object) {
+ if (typeof object == "number" || A._isBool(object) || object == null)
+ return J.toString$0$(object);
+ if (typeof object == "string")
+ return JSON.stringify(object);
+ return A.Primitives_safeToString(object);
+ },
+ Error_throwWithStackTrace(error, stackTrace) {
+ A.checkNotNullable(error, "error", type$.Object);
+ A.checkNotNullable(stackTrace, "stackTrace", type$.StackTrace);
+ A.Error__throw(error, stackTrace);
+ },
+ AssertionError$(message) {
+ return new A.AssertionError(message);
+ },
+ ArgumentError$(message, $name) {
+ return new A.ArgumentError(false, null, $name, message);
+ },
+ ArgumentError$value(value, $name, message) {
+ return new A.ArgumentError(true, value, $name, message);
+ },
+ ArgumentError_checkNotNull(argument, $name, $T) {
+ return argument;
+ },
+ RangeError$value(value, $name) {
+ return new A.RangeError(null, null, true, value, $name, "Value not in range");
+ },
+ RangeError$range(invalidValue, minValue, maxValue, $name, message) {
+ return new A.RangeError(minValue, maxValue, true, invalidValue, $name, "Invalid value");
+ },
+ RangeError_checkValueInInterval(value, minValue, maxValue, $name) {
+ if (value < minValue || value > maxValue)
+ throw A.wrapException(A.RangeError$range(value, minValue, maxValue, $name, null));
+ return value;
+ },
+ RangeError_checkValidRange(start, end, $length) {
+ if (0 > start || start > $length)
+ throw A.wrapException(A.RangeError$range(start, 0, $length, "start", null));
+ if (end != null) {
+ if (start > end || end > $length)
+ throw A.wrapException(A.RangeError$range(end, start, $length, "end", null));
+ return end;
+ }
+ return $length;
+ },
+ RangeError_checkNotNegative(value, $name) {
+ if (value < 0)
+ throw A.wrapException(A.RangeError$range(value, 0, null, $name, null));
+ return value;
+ },
+ IndexError$withLength(invalidValue, $length, indexable, $name) {
+ return new A.IndexError($length, true, invalidValue, $name, "Index out of range");
+ },
+ UnsupportedError$(message) {
+ return new A.UnsupportedError(message);
+ },
+ UnimplementedError$(message) {
+ return new A.UnimplementedError(message);
+ },
+ StateError$(message) {
+ return new A.StateError(message);
+ },
+ ConcurrentModificationError$(modifiedObject) {
+ return new A.ConcurrentModificationError(modifiedObject);
+ },
+ FormatException$(message, source, offset) {
+ return new A.FormatException(message, source, offset);
+ },
+ Iterable_iterableToShortString(iterable, leftDelimiter, rightDelimiter) {
+ var parts, t1;
+ if (A.isToStringVisiting(iterable)) {
+ if (leftDelimiter === "(" && rightDelimiter === ")")
+ return "(...)";
+ return leftDelimiter + "..." + rightDelimiter;
+ }
+ parts = A._setArrayType([], type$.JSArray_String);
+ B.JSArray_methods.add$1($.toStringVisiting, iterable);
+ try {
+ A._iterablePartsToStrings(iterable, parts);
+ } finally {
+ if (0 >= $.toStringVisiting.length)
+ return A.ioore($.toStringVisiting, -1);
+ $.toStringVisiting.pop();
+ }
+ t1 = A.StringBuffer__writeAll(leftDelimiter, type$.Iterable_dynamic._as(parts), ", ") + rightDelimiter;
+ return t1.charCodeAt(0) == 0 ? t1 : t1;
+ },
+ Iterable_iterableToFullString(iterable, leftDelimiter, rightDelimiter) {
+ var buffer, t1;
+ if (A.isToStringVisiting(iterable))
+ return leftDelimiter + "..." + rightDelimiter;
+ buffer = new A.StringBuffer(leftDelimiter);
+ B.JSArray_methods.add$1($.toStringVisiting, iterable);
+ try {
+ t1 = buffer;
+ t1._contents = A.StringBuffer__writeAll(t1._contents, iterable, ", ");
+ } finally {
+ if (0 >= $.toStringVisiting.length)
+ return A.ioore($.toStringVisiting, -1);
+ $.toStringVisiting.pop();
+ }
+ buffer._contents += rightDelimiter;
+ t1 = buffer._contents;
+ return t1.charCodeAt(0) == 0 ? t1 : t1;
+ },
+ _iterablePartsToStrings(iterable, parts) {
+ var next, ultimateString, penultimateString, penultimate, ultimate, ultimate0, elision,
+ it = iterable.get$iterator(iterable),
+ $length = 0, count = 0;
+ while (true) {
+ if (!($length < 80 || count < 3))
+ break;
+ if (!it.moveNext$0())
+ return;
+ next = A.S(it.get$current(it));
+ B.JSArray_methods.add$1(parts, next);
+ $length += next.length + 2;
+ ++count;
+ }
+ if (!it.moveNext$0()) {
+ if (count <= 5)
+ return;
+ if (0 >= parts.length)
+ return A.ioore(parts, -1);
+ ultimateString = parts.pop();
+ if (0 >= parts.length)
+ return A.ioore(parts, -1);
+ penultimateString = parts.pop();
+ } else {
+ penultimate = it.get$current(it);
+ ++count;
+ if (!it.moveNext$0()) {
+ if (count <= 4) {
+ B.JSArray_methods.add$1(parts, A.S(penultimate));
+ return;
+ }
+ ultimateString = A.S(penultimate);
+ if (0 >= parts.length)
+ return A.ioore(parts, -1);
+ penultimateString = parts.pop();
+ $length += ultimateString.length + 2;
+ } else {
+ ultimate = it.get$current(it);
+ ++count;
+ for (; it.moveNext$0(); penultimate = ultimate, ultimate = ultimate0) {
+ ultimate0 = it.get$current(it);
+ ++count;
+ if (count > 100) {
+ while (true) {
+ if (!($length > 75 && count > 3))
+ break;
+ if (0 >= parts.length)
+ return A.ioore(parts, -1);
+ $length -= parts.pop().length + 2;
+ --count;
+ }
+ B.JSArray_methods.add$1(parts, "...");
+ return;
+ }
+ }
+ penultimateString = A.S(penultimate);
+ ultimateString = A.S(ultimate);
+ $length += ultimateString.length + penultimateString.length + 4;
+ }
+ }
+ if (count > parts.length + 2) {
+ $length += 5;
+ elision = "...";
+ } else
+ elision = null;
+ while (true) {
+ if (!($length > 80 && parts.length > 3))
+ break;
+ if (0 >= parts.length)
+ return A.ioore(parts, -1);
+ $length -= parts.pop().length + 2;
+ if (elision == null) {
+ $length += 5;
+ elision = "...";
+ }
+ }
+ if (elision != null)
+ B.JSArray_methods.add$1(parts, elision);
+ B.JSArray_methods.add$1(parts, penultimateString);
+ B.JSArray_methods.add$1(parts, ultimateString);
+ },
+ Object_hash(object1, object2, object3, object4) {
+ var t1;
+ if (B.C_SentinelValue === object3) {
+ t1 = J.get$hashCode$(object1);
+ object2 = J.get$hashCode$(object2);
+ return A.SystemHash_finish(A.SystemHash_combine(A.SystemHash_combine($.$get$_hashSeed(), t1), object2));
+ }
+ if (B.C_SentinelValue === object4) {
+ t1 = J.get$hashCode$(object1);
+ object2 = J.get$hashCode$(object2);
+ object3 = J.get$hashCode$(object3);
+ return A.SystemHash_finish(A.SystemHash_combine(A.SystemHash_combine(A.SystemHash_combine($.$get$_hashSeed(), t1), object2), object3));
+ }
+ t1 = J.get$hashCode$(object1);
+ object2 = J.get$hashCode$(object2);
+ object3 = J.get$hashCode$(object3);
+ object4 = J.get$hashCode$(object4);
+ object4 = A.SystemHash_finish(A.SystemHash_combine(A.SystemHash_combine(A.SystemHash_combine(A.SystemHash_combine($.$get$_hashSeed(), t1), object2), object3), object4));
+ return object4;
+ },
+ Uri_Uri$dataFromString($content) {
+ var t1, _null = null,
+ buffer = new A.StringBuffer(""),
+ indices = A._setArrayType([-1], type$.JSArray_int);
+ A.UriData__writeUri(_null, _null, _null, buffer, indices);
+ B.JSArray_methods.add$1(indices, buffer._contents.length);
+ buffer._contents += ",";
+ A.UriData__uriEncodeBytes(B.List_oFp, B.C_AsciiCodec.encode$1($content), buffer);
+ t1 = buffer._contents;
+ return new A.UriData(t1.charCodeAt(0) == 0 ? t1 : t1, indices, _null).get$uri();
+ },
+ Uri_parse(uri) {
+ var delta, indices, schemeEnd, hostStart, portStart, pathStart, queryStart, fragmentStart, isSimple, scheme, t1, t2, schemeAuth, queryStart0, pathStart0, userInfoStart, userInfo, host, portNumber, port, path, query, _null = null,
+ end = uri.length;
+ if (end >= 5) {
+ if (4 >= end)
+ return A.ioore(uri, 4);
+ delta = ((uri.charCodeAt(4) ^ 58) * 3 | uri.charCodeAt(0) ^ 100 | uri.charCodeAt(1) ^ 97 | uri.charCodeAt(2) ^ 116 | uri.charCodeAt(3) ^ 97) >>> 0;
+ if (delta === 0)
+ return A.UriData__parse(end < end ? B.JSString_methods.substring$2(uri, 0, end) : uri, 5, _null).get$uri();
+ else if (delta === 32)
+ return A.UriData__parse(B.JSString_methods.substring$2(uri, 5, end), 0, _null).get$uri();
+ }
+ indices = A.List_List$filled(8, 0, false, type$.int);
+ B.JSArray_methods.$indexSet(indices, 0, 0);
+ B.JSArray_methods.$indexSet(indices, 1, -1);
+ B.JSArray_methods.$indexSet(indices, 2, -1);
+ B.JSArray_methods.$indexSet(indices, 7, -1);
+ B.JSArray_methods.$indexSet(indices, 3, 0);
+ B.JSArray_methods.$indexSet(indices, 4, 0);
+ B.JSArray_methods.$indexSet(indices, 5, end);
+ B.JSArray_methods.$indexSet(indices, 6, end);
+ if (A._scan(uri, 0, end, 0, indices) >= 14)
+ B.JSArray_methods.$indexSet(indices, 7, end);
+ schemeEnd = indices[1];
+ if (schemeEnd >= 0)
+ if (A._scan(uri, 0, schemeEnd, 20, indices) === 20)
+ indices[7] = schemeEnd;
+ hostStart = indices[2] + 1;
+ portStart = indices[3];
+ pathStart = indices[4];
+ queryStart = indices[5];
+ fragmentStart = indices[6];
+ if (fragmentStart < queryStart)
+ queryStart = fragmentStart;
+ if (pathStart < hostStart)
+ pathStart = queryStart;
+ else if (pathStart <= schemeEnd)
+ pathStart = schemeEnd + 1;
+ if (portStart < hostStart)
+ portStart = pathStart;
+ isSimple = indices[7] < 0;
+ if (isSimple)
+ if (hostStart > schemeEnd + 3) {
+ scheme = _null;
+ isSimple = false;
+ } else {
+ t1 = portStart > 0;
+ if (t1 && portStart + 1 === pathStart) {
+ scheme = _null;
+ isSimple = false;
+ } else {
+ if (!B.JSString_methods.startsWith$2(uri, "\\", pathStart))
+ if (hostStart > 0)
+ t2 = B.JSString_methods.startsWith$2(uri, "\\", hostStart - 1) || B.JSString_methods.startsWith$2(uri, "\\", hostStart - 2);
+ else
+ t2 = false;
+ else
+ t2 = true;
+ if (t2) {
+ scheme = _null;
+ isSimple = false;
+ } else {
+ if (!(queryStart < end && queryStart === pathStart + 2 && B.JSString_methods.startsWith$2(uri, "..", pathStart)))
+ t2 = queryStart > pathStart + 2 && B.JSString_methods.startsWith$2(uri, "/..", queryStart - 3);
+ else
+ t2 = true;
+ if (t2) {
+ scheme = _null;
+ isSimple = false;
+ } else {
+ if (schemeEnd === 4)
+ if (B.JSString_methods.startsWith$2(uri, "file", 0)) {
+ if (hostStart <= 0) {
+ if (!B.JSString_methods.startsWith$2(uri, "/", pathStart)) {
+ schemeAuth = "file:///";
+ delta = 3;
+ } else {
+ schemeAuth = "file://";
+ delta = 2;
+ }
+ uri = schemeAuth + B.JSString_methods.substring$2(uri, pathStart, end);
+ schemeEnd -= 0;
+ t1 = delta - 0;
+ queryStart += t1;
+ fragmentStart += t1;
+ end = uri.length;
+ hostStart = 7;
+ portStart = 7;
+ pathStart = 7;
+ } else if (pathStart === queryStart) {
+ ++fragmentStart;
+ queryStart0 = queryStart + 1;
+ uri = B.JSString_methods.replaceRange$3(uri, pathStart, queryStart, "/");
+ ++end;
+ queryStart = queryStart0;
+ }
+ scheme = "file";
+ } else if (B.JSString_methods.startsWith$2(uri, "http", 0)) {
+ if (t1 && portStart + 3 === pathStart && B.JSString_methods.startsWith$2(uri, "80", portStart + 1)) {
+ fragmentStart -= 3;
+ pathStart0 = pathStart - 3;
+ queryStart -= 3;
+ uri = B.JSString_methods.replaceRange$3(uri, portStart, pathStart, "");
+ end -= 3;
+ pathStart = pathStart0;
+ }
+ scheme = "http";
+ } else
+ scheme = _null;
+ else if (schemeEnd === 5 && B.JSString_methods.startsWith$2(uri, "https", 0)) {
+ if (t1 && portStart + 4 === pathStart && B.JSString_methods.startsWith$2(uri, "443", portStart + 1)) {
+ fragmentStart -= 4;
+ pathStart0 = pathStart - 4;
+ queryStart -= 4;
+ uri = B.JSString_methods.replaceRange$3(uri, portStart, pathStart, "");
+ end -= 3;
+ pathStart = pathStart0;
+ }
+ scheme = "https";
+ } else
+ scheme = _null;
+ isSimple = true;
+ }
+ }
+ }
+ }
+ else
+ scheme = _null;
+ if (isSimple) {
+ if (end < uri.length) {
+ uri = B.JSString_methods.substring$2(uri, 0, end);
+ schemeEnd -= 0;
+ hostStart -= 0;
+ portStart -= 0;
+ pathStart -= 0;
+ queryStart -= 0;
+ fragmentStart -= 0;
+ }
+ return new A._SimpleUri(uri, schemeEnd, hostStart, portStart, pathStart, queryStart, fragmentStart, scheme);
+ }
+ if (scheme == null)
+ if (schemeEnd > 0)
+ scheme = A._Uri__makeScheme(uri, 0, schemeEnd);
+ else {
+ if (schemeEnd === 0)
+ A._Uri__fail(uri, 0, "Invalid empty scheme");
+ scheme = "";
+ }
+ if (hostStart > 0) {
+ userInfoStart = schemeEnd + 3;
+ userInfo = userInfoStart < hostStart ? A._Uri__makeUserInfo(uri, userInfoStart, hostStart - 1) : "";
+ host = A._Uri__makeHost(uri, hostStart, portStart, false);
+ t1 = portStart + 1;
+ if (t1 < pathStart) {
+ portNumber = A.Primitives_parseInt(B.JSString_methods.substring$2(uri, t1, pathStart), _null);
+ port = A._Uri__makePort(portNumber == null ? A.throwExpression(A.FormatException$("Invalid port", uri, t1)) : portNumber, scheme);
+ } else
+ port = _null;
+ } else {
+ port = _null;
+ host = port;
+ userInfo = "";
+ }
+ path = A._Uri__makePath(uri, pathStart, queryStart, _null, scheme, host != null);
+ query = queryStart < fragmentStart ? A._Uri__makeQuery(uri, queryStart + 1, fragmentStart, _null) : _null;
+ return A._Uri$_internal(scheme, userInfo, host, port, path, query, fragmentStart < end ? A._Uri__makeFragment(uri, fragmentStart + 1, end) : _null);
+ },
+ Uri_decodeComponent(encodedComponent) {
+ A._asString(encodedComponent);
+ return A._Uri__uriDecode(encodedComponent, 0, encodedComponent.length, B.C_Utf8Codec, false);
+ },
+ Uri_splitQueryString(query) {
+ var t1 = type$.String;
+ return B.JSArray_methods.fold$1$2(A._setArrayType(query.split("&"), type$.JSArray_String), A.LinkedHashMap_LinkedHashMap$_empty(t1, t1), new A.Uri_splitQueryString_closure(B.C_Utf8Codec), type$.Map_String_String);
+ },
+ Uri__parseIPv4Address(host, start, end) {
+ var t1, i, partStart, partIndex, char, part, partIndex0,
+ _s43_ = "IPv4 address should contain exactly 4 parts",
+ _s37_ = "each part must be in the range 0..255",
+ error = new A.Uri__parseIPv4Address_error(host),
+ result = new Uint8Array(4);
+ for (t1 = host.length, i = start, partStart = i, partIndex = 0; i < end; ++i) {
+ if (!(i >= 0 && i < t1))
+ return A.ioore(host, i);
+ char = host.charCodeAt(i);
+ if (char !== 46) {
+ if ((char ^ 48) > 9)
+ error.call$2("invalid character", i);
+ } else {
+ if (partIndex === 3)
+ error.call$2(_s43_, i);
+ part = A.int_parse(B.JSString_methods.substring$2(host, partStart, i), null);
+ if (part > 255)
+ error.call$2(_s37_, partStart);
+ partIndex0 = partIndex + 1;
+ if (!(partIndex < 4))
+ return A.ioore(result, partIndex);
+ result[partIndex] = part;
+ partStart = i + 1;
+ partIndex = partIndex0;
+ }
+ }
+ if (partIndex !== 3)
+ error.call$2(_s43_, end);
+ part = A.int_parse(B.JSString_methods.substring$2(host, partStart, end), null);
+ if (part > 255)
+ error.call$2(_s37_, partStart);
+ if (!(partIndex < 4))
+ return A.ioore(result, partIndex);
+ result[partIndex] = part;
+ return result;
+ },
+ Uri_parseIPv6Address(host, start, end) {
+ var parts, i, partStart, wildcardSeen, seenDot, char, atEnd, last, bytes, wildCardLength, index, value, j, t2, _null = null,
+ error = new A.Uri_parseIPv6Address_error(host),
+ parseHex = new A.Uri_parseIPv6Address_parseHex(error, host),
+ t1 = host.length;
+ if (t1 < 2)
+ error.call$2("address is too short", _null);
+ parts = A._setArrayType([], type$.JSArray_int);
+ for (i = start, partStart = i, wildcardSeen = false, seenDot = false; i < end; ++i) {
+ if (!(i >= 0 && i < t1))
+ return A.ioore(host, i);
+ char = host.charCodeAt(i);
+ if (char === 58) {
+ if (i === start) {
+ ++i;
+ if (!(i < t1))
+ return A.ioore(host, i);
+ if (host.charCodeAt(i) !== 58)
+ error.call$2("invalid start colon.", i);
+ partStart = i;
+ }
+ if (i === partStart) {
+ if (wildcardSeen)
+ error.call$2("only one wildcard `::` is allowed", i);
+ B.JSArray_methods.add$1(parts, -1);
+ wildcardSeen = true;
+ } else
+ B.JSArray_methods.add$1(parts, parseHex.call$2(partStart, i));
+ partStart = i + 1;
+ } else if (char === 46)
+ seenDot = true;
+ }
+ if (parts.length === 0)
+ error.call$2("too few parts", _null);
+ atEnd = partStart === end;
+ t1 = B.JSArray_methods.get$last(parts);
+ if (atEnd && t1 !== -1)
+ error.call$2("expected a part after last `:`", end);
+ if (!atEnd)
+ if (!seenDot)
+ B.JSArray_methods.add$1(parts, parseHex.call$2(partStart, end));
+ else {
+ last = A.Uri__parseIPv4Address(host, partStart, end);
+ B.JSArray_methods.add$1(parts, (last[0] << 8 | last[1]) >>> 0);
+ B.JSArray_methods.add$1(parts, (last[2] << 8 | last[3]) >>> 0);
+ }
+ if (wildcardSeen) {
+ if (parts.length > 7)
+ error.call$2("an address with a wildcard must have less than 7 parts", _null);
+ } else if (parts.length !== 8)
+ error.call$2("an address without a wildcard must contain exactly 8 parts", _null);
+ bytes = new Uint8Array(16);
+ for (t1 = parts.length, wildCardLength = 9 - t1, i = 0, index = 0; i < t1; ++i) {
+ value = parts[i];
+ if (value === -1)
+ for (j = 0; j < wildCardLength; ++j) {
+ if (!(index >= 0 && index < 16))
+ return A.ioore(bytes, index);
+ bytes[index] = 0;
+ t2 = index + 1;
+ if (!(t2 < 16))
+ return A.ioore(bytes, t2);
+ bytes[t2] = 0;
+ index += 2;
+ }
+ else {
+ t2 = B.JSInt_methods._shrOtherPositive$1(value, 8);
+ if (!(index >= 0 && index < 16))
+ return A.ioore(bytes, index);
+ bytes[index] = t2;
+ t2 = index + 1;
+ if (!(t2 < 16))
+ return A.ioore(bytes, t2);
+ bytes[t2] = value & 255;
+ index += 2;
+ }
+ }
+ return bytes;
+ },
+ _Uri$_internal(scheme, _userInfo, _host, _port, path, _query, _fragment) {
+ return new A._Uri(scheme, _userInfo, _host, _port, path, _query, _fragment);
+ },
+ _Uri__Uri(host, path, pathSegments, scheme) {
+ var userInfo, query, fragment, port, isFile, t1, hasAuthority, t2, _null = null;
+ scheme = scheme == null ? "" : A._Uri__makeScheme(scheme, 0, scheme.length);
+ userInfo = A._Uri__makeUserInfo(_null, 0, 0);
+ host = A._Uri__makeHost(host, 0, host == null ? 0 : host.length, false);
+ query = A._Uri__makeQuery(_null, 0, 0, _null);
+ fragment = A._Uri__makeFragment(_null, 0, 0);
+ port = A._Uri__makePort(_null, scheme);
+ isFile = scheme === "file";
+ if (host == null)
+ t1 = userInfo.length !== 0 || port != null || isFile;
+ else
+ t1 = false;
+ if (t1)
+ host = "";
+ t1 = host == null;
+ hasAuthority = !t1;
+ path = A._Uri__makePath(path, 0, path == null ? 0 : path.length, pathSegments, scheme, hasAuthority);
+ t2 = scheme.length === 0;
+ if (t2 && t1 && !B.JSString_methods.startsWith$1(path, "/"))
+ path = A._Uri__normalizeRelativePath(path, !t2 || hasAuthority);
+ else
+ path = A._Uri__removeDotSegments(path);
+ return A._Uri$_internal(scheme, userInfo, t1 && B.JSString_methods.startsWith$1(path, "//") ? "" : host, port, path, query, fragment);
+ },
+ _Uri__defaultPort(scheme) {
+ if (scheme === "http")
+ return 80;
+ if (scheme === "https")
+ return 443;
+ return 0;
+ },
+ _Uri__fail(uri, index, message) {
+ throw A.wrapException(A.FormatException$(message, uri, index));
+ },
+ _Uri__Uri$file(path, windows) {
+ return windows ? A._Uri__makeWindowsFileUrl(path, false) : A._Uri__makeFileUri(path, false);
+ },
+ _Uri__checkNonWindowsPathReservedCharacters(segments, argumentError) {
+ var t1, _i, segment;
+ for (t1 = segments.length, _i = 0; _i < t1; ++_i) {
+ segment = segments[_i];
+ if (J.contains$1$asx(segment, "/")) {
+ t1 = A.UnsupportedError$("Illegal path character " + A.S(segment));
+ throw A.wrapException(t1);
+ }
+ }
+ },
+ _Uri__checkWindowsPathReservedCharacters(segments, argumentError, firstSegment) {
+ var t1, t2, t3;
+ for (t1 = A.SubListIterable$(segments, firstSegment, null, A._arrayInstanceType(segments)._precomputed1), t2 = t1.$ti, t1 = new A.ListIterator(t1, t1.get$length(t1), t2._eval$1("ListIterator<ListIterable.E>")), t2 = t2._eval$1("ListIterable.E"); t1.moveNext$0();) {
+ t3 = t1.__internal$_current;
+ if (t3 == null)
+ t3 = t2._as(t3);
+ if (B.JSString_methods.contains$1(t3, A.RegExp_RegExp('["*/:<>?\\\\|]', false)))
+ if (argumentError)
+ throw A.wrapException(A.ArgumentError$("Illegal character in path", null));
+ else
+ throw A.wrapException(A.UnsupportedError$("Illegal character in path: " + t3));
+ }
+ },
+ _Uri__checkWindowsDriveLetter(charCode, argumentError) {
+ var t1,
+ _s21_ = "Illegal drive letter ";
+ if (!(65 <= charCode && charCode <= 90))
+ t1 = 97 <= charCode && charCode <= 122;
+ else
+ t1 = true;
+ if (t1)
+ return;
+ if (argumentError)
+ throw A.wrapException(A.ArgumentError$(_s21_ + A.String_String$fromCharCode(charCode), null));
+ else
+ throw A.wrapException(A.UnsupportedError$(_s21_ + A.String_String$fromCharCode(charCode)));
+ },
+ _Uri__makeFileUri(path, slashTerminated) {
+ var _null = null,
+ segments = A._setArrayType(path.split("/"), type$.JSArray_String);
+ if (B.JSString_methods.startsWith$1(path, "/"))
+ return A._Uri__Uri(_null, _null, segments, "file");
+ else
+ return A._Uri__Uri(_null, _null, segments, _null);
+ },
+ _Uri__makeWindowsFileUrl(path, slashTerminated) {
+ var t1, pathSegments, pathStart, hostPart, _s1_ = "\\", _null = null, _s4_ = "file";
+ if (B.JSString_methods.startsWith$1(path, "\\\\?\\"))
+ if (B.JSString_methods.startsWith$2(path, "UNC\\", 4))
+ path = B.JSString_methods.replaceRange$3(path, 0, 7, _s1_);
+ else {
+ path = B.JSString_methods.substring$1(path, 4);
+ t1 = path.length;
+ if (t1 >= 3) {
+ if (1 >= t1)
+ return A.ioore(path, 1);
+ if (path.charCodeAt(1) === 58) {
+ if (2 >= t1)
+ return A.ioore(path, 2);
+ t1 = path.charCodeAt(2) !== 92;
+ } else
+ t1 = true;
+ } else
+ t1 = true;
+ if (t1)
+ throw A.wrapException(A.ArgumentError$value(path, "path", "Windows paths with \\\\?\\ prefix must be absolute"));
+ }
+ else
+ path = A.stringReplaceAllUnchecked(path, "/", _s1_);
+ t1 = path.length;
+ if (t1 > 1 && path.charCodeAt(1) === 58) {
+ if (0 >= t1)
+ return A.ioore(path, 0);
+ A._Uri__checkWindowsDriveLetter(path.charCodeAt(0), true);
+ if (t1 !== 2) {
+ if (2 >= t1)
+ return A.ioore(path, 2);
+ t1 = path.charCodeAt(2) !== 92;
+ } else
+ t1 = true;
+ if (t1)
+ throw A.wrapException(A.ArgumentError$value(path, "path", "Windows paths with drive letter must be absolute"));
+ pathSegments = A._setArrayType(path.split(_s1_), type$.JSArray_String);
+ A._Uri__checkWindowsPathReservedCharacters(pathSegments, true, 1);
+ return A._Uri__Uri(_null, _null, pathSegments, _s4_);
+ }
+ if (B.JSString_methods.startsWith$1(path, _s1_))
+ if (B.JSString_methods.startsWith$2(path, _s1_, 1)) {
+ pathStart = B.JSString_methods.indexOf$2(path, _s1_, 2);
+ t1 = pathStart < 0;
+ hostPart = t1 ? B.JSString_methods.substring$1(path, 2) : B.JSString_methods.substring$2(path, 2, pathStart);
+ pathSegments = A._setArrayType((t1 ? "" : B.JSString_methods.substring$1(path, pathStart + 1)).split(_s1_), type$.JSArray_String);
+ A._Uri__checkWindowsPathReservedCharacters(pathSegments, true, 0);
+ return A._Uri__Uri(hostPart, _null, pathSegments, _s4_);
+ } else {
+ pathSegments = A._setArrayType(path.split(_s1_), type$.JSArray_String);
+ A._Uri__checkWindowsPathReservedCharacters(pathSegments, true, 0);
+ return A._Uri__Uri(_null, _null, pathSegments, _s4_);
+ }
+ else {
+ pathSegments = A._setArrayType(path.split(_s1_), type$.JSArray_String);
+ A._Uri__checkWindowsPathReservedCharacters(pathSegments, true, 0);
+ return A._Uri__Uri(_null, _null, pathSegments, _null);
+ }
+ },
+ _Uri__makePort(port, scheme) {
+ if (port != null && port === A._Uri__defaultPort(scheme))
+ return null;
+ return port;
+ },
+ _Uri__makeHost(host, start, end, strictIPv6) {
+ var t1, t2, index, zoneIDstart, zoneID, i;
+ if (host == null)
+ return null;
+ if (start === end)
+ return "";
+ t1 = host.length;
+ if (!(start >= 0 && start < t1))
+ return A.ioore(host, start);
+ if (host.charCodeAt(start) === 91) {
+ t2 = end - 1;
+ if (!(t2 >= 0 && t2 < t1))
+ return A.ioore(host, t2);
+ if (host.charCodeAt(t2) !== 93)
+ A._Uri__fail(host, start, "Missing end `]` to match `[` in host");
+ t1 = start + 1;
+ index = A._Uri__checkZoneID(host, t1, t2);
+ if (index < t2) {
+ zoneIDstart = index + 1;
+ zoneID = A._Uri__normalizeZoneID(host, B.JSString_methods.startsWith$2(host, "25", zoneIDstart) ? index + 3 : zoneIDstart, t2, "%25");
+ } else
+ zoneID = "";
+ A.Uri_parseIPv6Address(host, t1, index);
+ return B.JSString_methods.substring$2(host, start, index).toLowerCase() + zoneID + "]";
+ }
+ for (i = start; i < end; ++i) {
+ if (!(i < t1))
+ return A.ioore(host, i);
+ if (host.charCodeAt(i) === 58) {
+ index = B.JSString_methods.indexOf$2(host, "%", start);
+ index = index >= start && index < end ? index : end;
+ if (index < end) {
+ zoneIDstart = index + 1;
+ zoneID = A._Uri__normalizeZoneID(host, B.JSString_methods.startsWith$2(host, "25", zoneIDstart) ? index + 3 : zoneIDstart, end, "%25");
+ } else
+ zoneID = "";
+ A.Uri_parseIPv6Address(host, start, index);
+ return "[" + B.JSString_methods.substring$2(host, start, index) + zoneID + "]";
+ }
+ }
+ return A._Uri__normalizeRegName(host, start, end);
+ },
+ _Uri__checkZoneID(host, start, end) {
+ var index = B.JSString_methods.indexOf$2(host, "%", start);
+ return index >= start && index < end ? index : end;
+ },
+ _Uri__normalizeZoneID(host, start, end, prefix) {
+ var t1, index, sectionStart, isNormalized, char, replacement, t2, t3, tail, sourceLength, slice,
+ buffer = prefix !== "" ? new A.StringBuffer(prefix) : null;
+ for (t1 = host.length, index = start, sectionStart = index, isNormalized = true; index < end;) {
+ if (!(index >= 0 && index < t1))
+ return A.ioore(host, index);
+ char = host.charCodeAt(index);
+ if (char === 37) {
+ replacement = A._Uri__normalizeEscape(host, index, true);
+ t2 = replacement == null;
+ if (t2 && isNormalized) {
+ index += 3;
+ continue;
+ }
+ if (buffer == null)
+ buffer = new A.StringBuffer("");
+ t3 = buffer._contents += B.JSString_methods.substring$2(host, sectionStart, index);
+ if (t2)
+ replacement = B.JSString_methods.substring$2(host, index, index + 3);
+ else if (replacement === "%")
+ A._Uri__fail(host, index, "ZoneID should not contain % anymore");
+ buffer._contents = t3 + replacement;
+ index += 3;
+ sectionStart = index;
+ isNormalized = true;
+ } else {
+ if (char < 127) {
+ t2 = char >>> 4;
+ if (!(t2 < 8))
+ return A.ioore(B.List_M1A, t2);
+ t2 = (B.List_M1A[t2] & 1 << (char & 15)) !== 0;
+ } else
+ t2 = false;
+ if (t2) {
+ if (isNormalized && 65 <= char && 90 >= char) {
+ if (buffer == null)
+ buffer = new A.StringBuffer("");
+ if (sectionStart < index) {
+ buffer._contents += B.JSString_methods.substring$2(host, sectionStart, index);
+ sectionStart = index;
+ }
+ isNormalized = false;
+ }
+ ++index;
+ } else {
+ if ((char & 64512) === 55296 && index + 1 < end) {
+ t2 = index + 1;
+ if (!(t2 < t1))
+ return A.ioore(host, t2);
+ tail = host.charCodeAt(t2);
+ if ((tail & 64512) === 56320) {
+ char = (char & 1023) << 10 | tail & 1023 | 65536;
+ sourceLength = 2;
+ } else
+ sourceLength = 1;
+ } else
+ sourceLength = 1;
+ slice = B.JSString_methods.substring$2(host, sectionStart, index);
+ if (buffer == null) {
+ buffer = new A.StringBuffer("");
+ t2 = buffer;
+ } else
+ t2 = buffer;
+ t2._contents += slice;
+ t2._contents += A._Uri__escapeChar(char);
+ index += sourceLength;
+ sectionStart = index;
+ }
+ }
+ }
+ if (buffer == null)
+ return B.JSString_methods.substring$2(host, start, end);
+ if (sectionStart < end)
+ buffer._contents += B.JSString_methods.substring$2(host, sectionStart, end);
+ t1 = buffer._contents;
+ return t1.charCodeAt(0) == 0 ? t1 : t1;
+ },
+ _Uri__normalizeRegName(host, start, end) {
+ var t1, index, sectionStart, buffer, isNormalized, char, replacement, t2, slice, t3, sourceLength, tail;
+ for (t1 = host.length, index = start, sectionStart = index, buffer = null, isNormalized = true; index < end;) {
+ if (!(index >= 0 && index < t1))
+ return A.ioore(host, index);
+ char = host.charCodeAt(index);
+ if (char === 37) {
+ replacement = A._Uri__normalizeEscape(host, index, true);
+ t2 = replacement == null;
+ if (t2 && isNormalized) {
+ index += 3;
+ continue;
+ }
+ if (buffer == null)
+ buffer = new A.StringBuffer("");
+ slice = B.JSString_methods.substring$2(host, sectionStart, index);
+ t3 = buffer._contents += !isNormalized ? slice.toLowerCase() : slice;
+ if (t2) {
+ replacement = B.JSString_methods.substring$2(host, index, index + 3);
+ sourceLength = 3;
+ } else if (replacement === "%") {
+ replacement = "%25";
+ sourceLength = 1;
+ } else
+ sourceLength = 3;
+ buffer._contents = t3 + replacement;
+ index += sourceLength;
+ sectionStart = index;
+ isNormalized = true;
+ } else {
+ if (char < 127) {
+ t2 = char >>> 4;
+ if (!(t2 < 8))
+ return A.ioore(B.List_ejq, t2);
+ t2 = (B.List_ejq[t2] & 1 << (char & 15)) !== 0;
+ } else
+ t2 = false;
+ if (t2) {
+ if (isNormalized && 65 <= char && 90 >= char) {
+ if (buffer == null)
+ buffer = new A.StringBuffer("");
+ if (sectionStart < index) {
+ buffer._contents += B.JSString_methods.substring$2(host, sectionStart, index);
+ sectionStart = index;
+ }
+ isNormalized = false;
+ }
+ ++index;
+ } else {
+ if (char <= 93) {
+ t2 = char >>> 4;
+ if (!(t2 < 8))
+ return A.ioore(B.List_YmH, t2);
+ t2 = (B.List_YmH[t2] & 1 << (char & 15)) !== 0;
+ } else
+ t2 = false;
+ if (t2)
+ A._Uri__fail(host, index, "Invalid character");
+ else {
+ if ((char & 64512) === 55296 && index + 1 < end) {
+ t2 = index + 1;
+ if (!(t2 < t1))
+ return A.ioore(host, t2);
+ tail = host.charCodeAt(t2);
+ if ((tail & 64512) === 56320) {
+ char = (char & 1023) << 10 | tail & 1023 | 65536;
+ sourceLength = 2;
+ } else
+ sourceLength = 1;
+ } else
+ sourceLength = 1;
+ slice = B.JSString_methods.substring$2(host, sectionStart, index);
+ if (!isNormalized)
+ slice = slice.toLowerCase();
+ if (buffer == null) {
+ buffer = new A.StringBuffer("");
+ t2 = buffer;
+ } else
+ t2 = buffer;
+ t2._contents += slice;
+ t2._contents += A._Uri__escapeChar(char);
+ index += sourceLength;
+ sectionStart = index;
+ }
+ }
+ }
+ }
+ if (buffer == null)
+ return B.JSString_methods.substring$2(host, start, end);
+ if (sectionStart < end) {
+ slice = B.JSString_methods.substring$2(host, sectionStart, end);
+ buffer._contents += !isNormalized ? slice.toLowerCase() : slice;
+ }
+ t1 = buffer._contents;
+ return t1.charCodeAt(0) == 0 ? t1 : t1;
+ },
+ _Uri__makeScheme(scheme, start, end) {
+ var t1, i, containsUpperCase, codeUnit, t2;
+ if (start === end)
+ return "";
+ t1 = scheme.length;
+ if (!(start < t1))
+ return A.ioore(scheme, start);
+ if (!A._Uri__isAlphabeticCharacter(scheme.charCodeAt(start)))
+ A._Uri__fail(scheme, start, "Scheme not starting with alphabetic character");
+ for (i = start, containsUpperCase = false; i < end; ++i) {
+ if (!(i < t1))
+ return A.ioore(scheme, i);
+ codeUnit = scheme.charCodeAt(i);
+ if (codeUnit < 128) {
+ t2 = codeUnit >>> 4;
+ if (!(t2 < 8))
+ return A.ioore(B.List_MMm, t2);
+ t2 = (B.List_MMm[t2] & 1 << (codeUnit & 15)) !== 0;
+ } else
+ t2 = false;
+ if (!t2)
+ A._Uri__fail(scheme, i, "Illegal scheme character");
+ if (65 <= codeUnit && codeUnit <= 90)
+ containsUpperCase = true;
+ }
+ scheme = B.JSString_methods.substring$2(scheme, start, end);
+ return A._Uri__canonicalizeScheme(containsUpperCase ? scheme.toLowerCase() : scheme);
+ },
+ _Uri__canonicalizeScheme(scheme) {
+ if (scheme === "http")
+ return "http";
+ if (scheme === "file")
+ return "file";
+ if (scheme === "https")
+ return "https";
+ if (scheme === "package")
+ return "package";
+ return scheme;
+ },
+ _Uri__makeUserInfo(userInfo, start, end) {
+ if (userInfo == null)
+ return "";
+ return A._Uri__normalizeOrSubstring(userInfo, start, end, B.List_OL3, false, false);
+ },
+ _Uri__makePath(path, start, end, pathSegments, scheme, hasAuthority) {
+ var t1, result,
+ isFile = scheme === "file",
+ ensureLeadingSlash = isFile || hasAuthority;
+ if (path == null) {
+ if (pathSegments == null)
+ return isFile ? "/" : "";
+ t1 = A._arrayInstanceType(pathSegments);
+ result = new A.MappedListIterable(pathSegments, t1._eval$1("String(1)")._as(new A._Uri__makePath_closure()), t1._eval$1("MappedListIterable<1,String>")).join$1(0, "/");
+ } else if (pathSegments != null)
+ throw A.wrapException(A.ArgumentError$("Both path and pathSegments specified", null));
+ else
+ result = A._Uri__normalizeOrSubstring(path, start, end, B.List_XRg, true, true);
+ if (result.length === 0) {
+ if (isFile)
+ return "/";
+ } else if (ensureLeadingSlash && !B.JSString_methods.startsWith$1(result, "/"))
+ result = "/" + result;
+ return A._Uri__normalizePath(result, scheme, hasAuthority);
+ },
+ _Uri__normalizePath(path, scheme, hasAuthority) {
+ var t1 = scheme.length === 0;
+ if (t1 && !hasAuthority && !B.JSString_methods.startsWith$1(path, "/") && !B.JSString_methods.startsWith$1(path, "\\"))
+ return A._Uri__normalizeRelativePath(path, !t1 || hasAuthority);
+ return A._Uri__removeDotSegments(path);
+ },
+ _Uri__makeQuery(query, start, end, queryParameters) {
+ if (query != null)
+ return A._Uri__normalizeOrSubstring(query, start, end, B.List_oFp, true, false);
+ return null;
+ },
+ _Uri__makeFragment(fragment, start, end) {
+ if (fragment == null)
+ return null;
+ return A._Uri__normalizeOrSubstring(fragment, start, end, B.List_oFp, true, false);
+ },
+ _Uri__normalizeEscape(source, index, lowerCase) {
+ var t3, firstDigit, secondDigit, firstDigitValue, secondDigitValue, value,
+ t1 = index + 2,
+ t2 = source.length;
+ if (t1 >= t2)
+ return "%";
+ t3 = index + 1;
+ if (!(t3 >= 0 && t3 < t2))
+ return A.ioore(source, t3);
+ firstDigit = source.charCodeAt(t3);
+ if (!(t1 >= 0))
+ return A.ioore(source, t1);
+ secondDigit = source.charCodeAt(t1);
+ firstDigitValue = A.hexDigitValue(firstDigit);
+ secondDigitValue = A.hexDigitValue(secondDigit);
+ if (firstDigitValue < 0 || secondDigitValue < 0)
+ return "%";
+ value = firstDigitValue * 16 + secondDigitValue;
+ if (value < 127) {
+ t1 = B.JSInt_methods._shrOtherPositive$1(value, 4);
+ if (!(t1 < 8))
+ return A.ioore(B.List_M1A, t1);
+ t1 = (B.List_M1A[t1] & 1 << (value & 15)) !== 0;
+ } else
+ t1 = false;
+ if (t1)
+ return A.Primitives_stringFromCharCode(lowerCase && 65 <= value && 90 >= value ? (value | 32) >>> 0 : value);
+ if (firstDigit >= 97 || secondDigit >= 97)
+ return B.JSString_methods.substring$2(source, index, index + 3).toUpperCase();
+ return null;
+ },
+ _Uri__escapeChar(char) {
+ var codeUnits, t1, flag, encodedBytes, index, byte, t2, t3,
+ _s16_ = "0123456789ABCDEF";
+ if (char < 128) {
+ codeUnits = new Uint8Array(3);
+ codeUnits[0] = 37;
+ t1 = char >>> 4;
+ if (!(t1 < 16))
+ return A.ioore(_s16_, t1);
+ codeUnits[1] = _s16_.charCodeAt(t1);
+ codeUnits[2] = _s16_.charCodeAt(char & 15);
+ } else {
+ if (char > 2047)
+ if (char > 65535) {
+ flag = 240;
+ encodedBytes = 4;
+ } else {
+ flag = 224;
+ encodedBytes = 3;
+ }
+ else {
+ flag = 192;
+ encodedBytes = 2;
+ }
+ t1 = 3 * encodedBytes;
+ codeUnits = new Uint8Array(t1);
+ for (index = 0; --encodedBytes, encodedBytes >= 0; flag = 128) {
+ byte = B.JSInt_methods._shrReceiverPositive$1(char, 6 * encodedBytes) & 63 | flag;
+ if (!(index < t1))
+ return A.ioore(codeUnits, index);
+ codeUnits[index] = 37;
+ t2 = index + 1;
+ t3 = byte >>> 4;
+ if (!(t3 < 16))
+ return A.ioore(_s16_, t3);
+ if (!(t2 < t1))
+ return A.ioore(codeUnits, t2);
+ codeUnits[t2] = _s16_.charCodeAt(t3);
+ t3 = index + 2;
+ if (!(t3 < t1))
+ return A.ioore(codeUnits, t3);
+ codeUnits[t3] = _s16_.charCodeAt(byte & 15);
+ index += 3;
+ }
+ }
+ return A.String_String$fromCharCodes(codeUnits, 0, null);
+ },
+ _Uri__normalizeOrSubstring(component, start, end, charTable, escapeDelimiters, replaceBackslash) {
+ var t1 = A._Uri__normalize(component, start, end, charTable, escapeDelimiters, replaceBackslash);
+ return t1 == null ? B.JSString_methods.substring$2(component, start, end) : t1;
+ },
+ _Uri__normalize(component, start, end, charTable, escapeDelimiters, replaceBackslash) {
+ var t1, t2, index, sectionStart, buffer, char, t3, replacement, sourceLength, tail, t4, _null = null;
+ for (t1 = !escapeDelimiters, t2 = component.length, index = start, sectionStart = index, buffer = _null; index < end;) {
+ if (!(index >= 0 && index < t2))
+ return A.ioore(component, index);
+ char = component.charCodeAt(index);
+ if (char < 127) {
+ t3 = char >>> 4;
+ if (!(t3 < 8))
+ return A.ioore(charTable, t3);
+ t3 = (charTable[t3] & 1 << (char & 15)) !== 0;
+ } else
+ t3 = false;
+ if (t3)
+ ++index;
+ else {
+ if (char === 37) {
+ replacement = A._Uri__normalizeEscape(component, index, false);
+ if (replacement == null) {
+ index += 3;
+ continue;
+ }
+ if ("%" === replacement) {
+ replacement = "%25";
+ sourceLength = 1;
+ } else
+ sourceLength = 3;
+ } else if (char === 92 && replaceBackslash) {
+ replacement = "/";
+ sourceLength = 1;
+ } else {
+ if (t1)
+ if (char <= 93) {
+ t3 = char >>> 4;
+ if (!(t3 < 8))
+ return A.ioore(B.List_YmH, t3);
+ t3 = (B.List_YmH[t3] & 1 << (char & 15)) !== 0;
+ } else
+ t3 = false;
+ else
+ t3 = false;
+ if (t3) {
+ A._Uri__fail(component, index, "Invalid character");
+ sourceLength = _null;
+ replacement = sourceLength;
+ } else {
+ if ((char & 64512) === 55296) {
+ t3 = index + 1;
+ if (t3 < end) {
+ if (!(t3 < t2))
+ return A.ioore(component, t3);
+ tail = component.charCodeAt(t3);
+ if ((tail & 64512) === 56320) {
+ char = (char & 1023) << 10 | tail & 1023 | 65536;
+ sourceLength = 2;
+ } else
+ sourceLength = 1;
+ } else
+ sourceLength = 1;
+ } else
+ sourceLength = 1;
+ replacement = A._Uri__escapeChar(char);
+ }
+ }
+ if (buffer == null) {
+ buffer = new A.StringBuffer("");
+ t3 = buffer;
+ } else
+ t3 = buffer;
+ t4 = t3._contents += B.JSString_methods.substring$2(component, sectionStart, index);
+ t3._contents = t4 + A.S(replacement);
+ if (typeof sourceLength !== "number")
+ return A.iae(sourceLength);
+ index += sourceLength;
+ sectionStart = index;
+ }
+ }
+ if (buffer == null)
+ return _null;
+ if (sectionStart < end)
+ buffer._contents += B.JSString_methods.substring$2(component, sectionStart, end);
+ t1 = buffer._contents;
+ return t1.charCodeAt(0) == 0 ? t1 : t1;
+ },
+ _Uri__mayContainDotSegments(path) {
+ if (B.JSString_methods.startsWith$1(path, "."))
+ return true;
+ return B.JSString_methods.indexOf$1(path, "/.") !== -1;
+ },
+ _Uri__removeDotSegments(path) {
+ var output, t1, t2, appendSlash, _i, segment, t3;
+ if (!A._Uri__mayContainDotSegments(path))
+ return path;
+ output = A._setArrayType([], type$.JSArray_String);
+ for (t1 = path.split("/"), t2 = t1.length, appendSlash = false, _i = 0; _i < t2; ++_i) {
+ segment = t1[_i];
+ if (J.$eq$(segment, "..")) {
+ t3 = output.length;
+ if (t3 !== 0) {
+ if (0 >= t3)
+ return A.ioore(output, -1);
+ output.pop();
+ if (output.length === 0)
+ B.JSArray_methods.add$1(output, "");
+ }
+ appendSlash = true;
+ } else if ("." === segment)
+ appendSlash = true;
+ else {
+ B.JSArray_methods.add$1(output, segment);
+ appendSlash = false;
+ }
+ }
+ if (appendSlash)
+ B.JSArray_methods.add$1(output, "");
+ return B.JSArray_methods.join$1(output, "/");
+ },
+ _Uri__normalizeRelativePath(path, allowScheme) {
+ var output, t1, t2, appendSlash, _i, segment;
+ if (!A._Uri__mayContainDotSegments(path))
+ return !allowScheme ? A._Uri__escapeScheme(path) : path;
+ output = A._setArrayType([], type$.JSArray_String);
+ for (t1 = path.split("/"), t2 = t1.length, appendSlash = false, _i = 0; _i < t2; ++_i) {
+ segment = t1[_i];
+ if (".." === segment)
+ if (output.length !== 0 && B.JSArray_methods.get$last(output) !== "..") {
+ if (0 >= output.length)
+ return A.ioore(output, -1);
+ output.pop();
+ appendSlash = true;
+ } else {
+ B.JSArray_methods.add$1(output, "..");
+ appendSlash = false;
+ }
+ else if ("." === segment)
+ appendSlash = true;
+ else {
+ B.JSArray_methods.add$1(output, segment);
+ appendSlash = false;
+ }
+ }
+ t1 = output.length;
+ if (t1 !== 0)
+ if (t1 === 1) {
+ if (0 >= t1)
+ return A.ioore(output, 0);
+ t1 = output[0].length === 0;
+ } else
+ t1 = false;
+ else
+ t1 = true;
+ if (t1)
+ return "./";
+ if (appendSlash || B.JSArray_methods.get$last(output) === "..")
+ B.JSArray_methods.add$1(output, "");
+ if (!allowScheme) {
+ if (0 >= output.length)
+ return A.ioore(output, 0);
+ B.JSArray_methods.$indexSet(output, 0, A._Uri__escapeScheme(output[0]));
+ }
+ return B.JSArray_methods.join$1(output, "/");
+ },
+ _Uri__escapeScheme(path) {
+ var i, char, t2,
+ t1 = path.length;
+ if (t1 >= 2 && A._Uri__isAlphabeticCharacter(path.charCodeAt(0)))
+ for (i = 1; i < t1; ++i) {
+ char = path.charCodeAt(i);
+ if (char === 58)
+ return B.JSString_methods.substring$2(path, 0, i) + "%3A" + B.JSString_methods.substring$1(path, i + 1);
+ if (char <= 127) {
+ t2 = char >>> 4;
+ if (!(t2 < 8))
+ return A.ioore(B.List_MMm, t2);
+ t2 = (B.List_MMm[t2] & 1 << (char & 15)) === 0;
+ } else
+ t2 = true;
+ if (t2)
+ break;
+ }
+ return path;
+ },
+ _Uri__packageNameEnd(uri, path) {
+ if (uri.isScheme$1("package") && uri._host == null)
+ return A._skipPackageNameChars(path, 0, path.length);
+ return -1;
+ },
+ _Uri__toWindowsFilePath(uri) {
+ var hasDriveLetter, t2, host,
+ segments = uri.get$pathSegments(),
+ t1 = segments.length;
+ if (t1 > 0 && J.get$length$asx(segments[0]) === 2 && J.codeUnitAt$1$s(segments[0], 1) === 58) {
+ if (0 >= t1)
+ return A.ioore(segments, 0);
+ A._Uri__checkWindowsDriveLetter(J.codeUnitAt$1$s(segments[0], 0), false);
+ A._Uri__checkWindowsPathReservedCharacters(segments, false, 1);
+ hasDriveLetter = true;
+ } else {
+ A._Uri__checkWindowsPathReservedCharacters(segments, false, 0);
+ hasDriveLetter = false;
+ }
+ t2 = uri.get$hasAbsolutePath() && !hasDriveLetter ? "" + "\\" : "";
+ if (uri.get$hasAuthority()) {
+ host = uri.get$host(uri);
+ if (host.length !== 0)
+ t2 = t2 + "\\" + host + "\\";
+ }
+ t2 = A.StringBuffer__writeAll(t2, segments, "\\");
+ t1 = hasDriveLetter && t1 === 1 ? t2 + "\\" : t2;
+ return t1.charCodeAt(0) == 0 ? t1 : t1;
+ },
+ _Uri__hexCharPairToByte(s, pos) {
+ var t1, byte, i, t2, charCode;
+ for (t1 = s.length, byte = 0, i = 0; i < 2; ++i) {
+ t2 = pos + i;
+ if (!(t2 < t1))
+ return A.ioore(s, t2);
+ charCode = s.charCodeAt(t2);
+ if (48 <= charCode && charCode <= 57)
+ byte = byte * 16 + charCode - 48;
+ else {
+ charCode |= 32;
+ if (97 <= charCode && charCode <= 102)
+ byte = byte * 16 + charCode - 87;
+ else
+ throw A.wrapException(A.ArgumentError$("Invalid URL encoding", null));
+ }
+ }
+ return byte;
+ },
+ _Uri__uriDecode(text, start, end, encoding, plusToSpace) {
+ var simple, codeUnit, t2, bytes,
+ t1 = text.length,
+ i = start;
+ while (true) {
+ if (!(i < end)) {
+ simple = true;
+ break;
+ }
+ if (!(i < t1))
+ return A.ioore(text, i);
+ codeUnit = text.charCodeAt(i);
+ if (codeUnit <= 127)
+ if (codeUnit !== 37)
+ t2 = plusToSpace && codeUnit === 43;
+ else
+ t2 = true;
+ else
+ t2 = true;
+ if (t2) {
+ simple = false;
+ break;
+ }
+ ++i;
+ }
+ if (simple) {
+ if (B.C_Utf8Codec !== encoding)
+ t1 = false;
+ else
+ t1 = true;
+ if (t1)
+ return B.JSString_methods.substring$2(text, start, end);
+ else
+ bytes = new A.CodeUnits(B.JSString_methods.substring$2(text, start, end));
+ } else {
+ bytes = A._setArrayType([], type$.JSArray_int);
+ for (i = start; i < end; ++i) {
+ if (!(i < t1))
+ return A.ioore(text, i);
+ codeUnit = text.charCodeAt(i);
+ if (codeUnit > 127)
+ throw A.wrapException(A.ArgumentError$("Illegal percent encoding in URI", null));
+ if (codeUnit === 37) {
+ if (i + 3 > t1)
+ throw A.wrapException(A.ArgumentError$("Truncated URI", null));
+ B.JSArray_methods.add$1(bytes, A._Uri__hexCharPairToByte(text, i + 1));
+ i += 2;
+ } else if (plusToSpace && codeUnit === 43)
+ B.JSArray_methods.add$1(bytes, 32);
+ else
+ B.JSArray_methods.add$1(bytes, codeUnit);
+ }
+ }
+ type$.List_int._as(bytes);
+ return B.Utf8Decoder_false.convert$1(bytes);
+ },
+ _Uri__isAlphabeticCharacter(codeUnit) {
+ var lowerCase = codeUnit | 32;
+ return 97 <= lowerCase && lowerCase <= 122;
+ },
+ UriData__writeUri(mimeType, charsetName, parameters, buffer, indices) {
+ var slashIndex, t1;
+ if (true)
+ buffer._contents = buffer._contents;
+ else {
+ slashIndex = A.UriData__validateMimeType("");
+ if (slashIndex < 0)
+ throw A.wrapException(A.ArgumentError$value("", "mimeType", "Invalid MIME type"));
+ t1 = buffer._contents += A._Uri__uriEncode(B.List_yzX, B.JSString_methods.substring$2("", 0, slashIndex), B.C_Utf8Codec, false);
+ buffer._contents = t1 + "/";
+ buffer._contents += A._Uri__uriEncode(B.List_yzX, B.JSString_methods.substring$1("", slashIndex + 1), B.C_Utf8Codec, false);
+ }
+ },
+ UriData__validateMimeType(mimeType) {
+ var t1, slashIndex, i;
+ for (t1 = mimeType.length, slashIndex = -1, i = 0; i < t1; ++i) {
+ if (mimeType.charCodeAt(i) !== 47)
+ continue;
+ if (slashIndex < 0) {
+ slashIndex = i;
+ continue;
+ }
+ return -1;
+ }
+ return slashIndex;
+ },
+ UriData__parse(text, start, sourceUri) {
+ var t1, i, slashIndex, char, equalsIndex, lastSeparator, t2, data,
+ _s17_ = "Invalid MIME type",
+ indices = A._setArrayType([start - 1], type$.JSArray_int);
+ for (t1 = text.length, i = start, slashIndex = -1, char = null; i < t1; ++i) {
+ char = text.charCodeAt(i);
+ if (char === 44 || char === 59)
+ break;
+ if (char === 47) {
+ if (slashIndex < 0) {
+ slashIndex = i;
+ continue;
+ }
+ throw A.wrapException(A.FormatException$(_s17_, text, i));
+ }
+ }
+ if (slashIndex < 0 && i > start)
+ throw A.wrapException(A.FormatException$(_s17_, text, i));
+ for (; char !== 44;) {
+ B.JSArray_methods.add$1(indices, i);
+ ++i;
+ for (equalsIndex = -1; i < t1; ++i) {
+ if (!(i >= 0))
+ return A.ioore(text, i);
+ char = text.charCodeAt(i);
+ if (char === 61) {
+ if (equalsIndex < 0)
+ equalsIndex = i;
+ } else if (char === 59 || char === 44)
+ break;
+ }
+ if (equalsIndex >= 0)
+ B.JSArray_methods.add$1(indices, equalsIndex);
+ else {
+ lastSeparator = B.JSArray_methods.get$last(indices);
+ if (char !== 44 || i !== lastSeparator + 7 || !B.JSString_methods.startsWith$2(text, "base64", lastSeparator + 1))
+ throw A.wrapException(A.FormatException$("Expecting '='", text, i));
+ break;
+ }
+ }
+ B.JSArray_methods.add$1(indices, i);
+ t2 = i + 1;
+ if ((indices.length & 1) === 1)
+ text = B.C_Base64Codec.normalize$3(0, text, t2, t1);
+ else {
+ data = A._Uri__normalize(text, t2, t1, B.List_oFp, true, false);
+ if (data != null)
+ text = B.JSString_methods.replaceRange$3(text, t2, t1, data);
+ }
+ return new A.UriData(text, indices, sourceUri);
+ },
+ UriData__uriEncodeBytes(canonicalTable, bytes, buffer) {
+ var t1, byteOr, i, byte, t2,
+ _s16_ = "0123456789ABCDEF";
+ for (t1 = bytes.length, byteOr = 0, i = 0; i < t1; ++i) {
+ byte = bytes[i];
+ byteOr |= byte;
+ if (byte < 128) {
+ t2 = byte >>> 4;
+ if (!(t2 < 8))
+ return A.ioore(canonicalTable, t2);
+ t2 = (canonicalTable[t2] & 1 << (byte & 15)) !== 0;
+ } else
+ t2 = false;
+ if (t2)
+ buffer._contents += A.Primitives_stringFromCharCode(byte);
+ else {
+ buffer._contents += A.Primitives_stringFromCharCode(37);
+ t2 = byte >>> 4;
+ if (!(t2 < 16))
+ return A.ioore(_s16_, t2);
+ buffer._contents += A.Primitives_stringFromCharCode(_s16_.charCodeAt(t2));
+ buffer._contents += A.Primitives_stringFromCharCode(_s16_.charCodeAt(byte & 15));
+ }
+ }
+ if ((byteOr & 4294967040) !== 0)
+ for (i = 0; i < t1; ++i) {
+ byte = bytes[i];
+ if (byte > 255)
+ throw A.wrapException(A.ArgumentError$value(byte, "non-byte value", null));
+ }
+ },
+ _createTables() {
+ var _i, t1, t2, t3, b,
+ _s77_ = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz-._~!$&'()*+,;=",
+ _s1_ = ".", _s1_0 = ":", _s1_1 = "/", _s1_2 = "\\", _s1_3 = "?", _s1_4 = "#", _s2_ = "/\\",
+ tables = A._setArrayType(new Array(22), type$.JSArray_Uint8List);
+ for (_i = 0; _i < 22; ++_i)
+ tables[_i] = new Uint8Array(96);
+ t1 = new A._createTables_build(tables);
+ t2 = new A._createTables_setChars();
+ t3 = new A._createTables_setRange();
+ b = t1.call$2(0, 225);
+ t2.call$3(b, _s77_, 1);
+ t2.call$3(b, _s1_, 14);
+ t2.call$3(b, _s1_0, 34);
+ t2.call$3(b, _s1_1, 3);
+ t2.call$3(b, _s1_2, 227);
+ t2.call$3(b, _s1_3, 172);
+ t2.call$3(b, _s1_4, 205);
+ b = t1.call$2(14, 225);
+ t2.call$3(b, _s77_, 1);
+ t2.call$3(b, _s1_, 15);
+ t2.call$3(b, _s1_0, 34);
+ t2.call$3(b, _s2_, 234);
+ t2.call$3(b, _s1_3, 172);
+ t2.call$3(b, _s1_4, 205);
+ b = t1.call$2(15, 225);
+ t2.call$3(b, _s77_, 1);
+ t2.call$3(b, "%", 225);
+ t2.call$3(b, _s1_0, 34);
+ t2.call$3(b, _s1_1, 9);
+ t2.call$3(b, _s1_2, 233);
+ t2.call$3(b, _s1_3, 172);
+ t2.call$3(b, _s1_4, 205);
+ b = t1.call$2(1, 225);
+ t2.call$3(b, _s77_, 1);
+ t2.call$3(b, _s1_0, 34);
+ t2.call$3(b, _s1_1, 10);
+ t2.call$3(b, _s1_2, 234);
+ t2.call$3(b, _s1_3, 172);
+ t2.call$3(b, _s1_4, 205);
+ b = t1.call$2(2, 235);
+ t2.call$3(b, _s77_, 139);
+ t2.call$3(b, _s1_1, 131);
+ t2.call$3(b, _s1_2, 131);
+ t2.call$3(b, _s1_, 146);
+ t2.call$3(b, _s1_3, 172);
+ t2.call$3(b, _s1_4, 205);
+ b = t1.call$2(3, 235);
+ t2.call$3(b, _s77_, 11);
+ t2.call$3(b, _s1_1, 68);
+ t2.call$3(b, _s1_2, 68);
+ t2.call$3(b, _s1_, 18);
+ t2.call$3(b, _s1_3, 172);
+ t2.call$3(b, _s1_4, 205);
+ b = t1.call$2(4, 229);
+ t2.call$3(b, _s77_, 5);
+ t3.call$3(b, "AZ", 229);
+ t2.call$3(b, _s1_0, 102);
+ t2.call$3(b, "@", 68);
+ t2.call$3(b, "[", 232);
+ t2.call$3(b, _s1_1, 138);
+ t2.call$3(b, _s1_2, 138);
+ t2.call$3(b, _s1_3, 172);
+ t2.call$3(b, _s1_4, 205);
+ b = t1.call$2(5, 229);
+ t2.call$3(b, _s77_, 5);
+ t3.call$3(b, "AZ", 229);
+ t2.call$3(b, _s1_0, 102);
+ t2.call$3(b, "@", 68);
+ t2.call$3(b, _s1_1, 138);
+ t2.call$3(b, _s1_2, 138);
+ t2.call$3(b, _s1_3, 172);
+ t2.call$3(b, _s1_4, 205);
+ b = t1.call$2(6, 231);
+ t3.call$3(b, "19", 7);
+ t2.call$3(b, "@", 68);
+ t2.call$3(b, _s1_1, 138);
+ t2.call$3(b, _s1_2, 138);
+ t2.call$3(b, _s1_3, 172);
+ t2.call$3(b, _s1_4, 205);
+ b = t1.call$2(7, 231);
+ t3.call$3(b, "09", 7);
+ t2.call$3(b, "@", 68);
+ t2.call$3(b, _s1_1, 138);
+ t2.call$3(b, _s1_2, 138);
+ t2.call$3(b, _s1_3, 172);
+ t2.call$3(b, _s1_4, 205);
+ t2.call$3(t1.call$2(8, 8), "]", 5);
+ b = t1.call$2(9, 235);
+ t2.call$3(b, _s77_, 11);
+ t2.call$3(b, _s1_, 16);
+ t2.call$3(b, _s2_, 234);
+ t2.call$3(b, _s1_3, 172);
+ t2.call$3(b, _s1_4, 205);
+ b = t1.call$2(16, 235);
+ t2.call$3(b, _s77_, 11);
+ t2.call$3(b, _s1_, 17);
+ t2.call$3(b, _s2_, 234);
+ t2.call$3(b, _s1_3, 172);
+ t2.call$3(b, _s1_4, 205);
+ b = t1.call$2(17, 235);
+ t2.call$3(b, _s77_, 11);
+ t2.call$3(b, _s1_1, 9);
+ t2.call$3(b, _s1_2, 233);
+ t2.call$3(b, _s1_3, 172);
+ t2.call$3(b, _s1_4, 205);
+ b = t1.call$2(10, 235);
+ t2.call$3(b, _s77_, 11);
+ t2.call$3(b, _s1_, 18);
+ t2.call$3(b, _s1_1, 10);
+ t2.call$3(b, _s1_2, 234);
+ t2.call$3(b, _s1_3, 172);
+ t2.call$3(b, _s1_4, 205);
+ b = t1.call$2(18, 235);
+ t2.call$3(b, _s77_, 11);
+ t2.call$3(b, _s1_, 19);
+ t2.call$3(b, _s2_, 234);
+ t2.call$3(b, _s1_3, 172);
+ t2.call$3(b, _s1_4, 205);
+ b = t1.call$2(19, 235);
+ t2.call$3(b, _s77_, 11);
+ t2.call$3(b, _s2_, 234);
+ t2.call$3(b, _s1_3, 172);
+ t2.call$3(b, _s1_4, 205);
+ b = t1.call$2(11, 235);
+ t2.call$3(b, _s77_, 11);
+ t2.call$3(b, _s1_1, 10);
+ t2.call$3(b, _s1_2, 234);
+ t2.call$3(b, _s1_3, 172);
+ t2.call$3(b, _s1_4, 205);
+ b = t1.call$2(12, 236);
+ t2.call$3(b, _s77_, 12);
+ t2.call$3(b, _s1_3, 12);
+ t2.call$3(b, _s1_4, 205);
+ b = t1.call$2(13, 237);
+ t2.call$3(b, _s77_, 13);
+ t2.call$3(b, _s1_3, 13);
+ t3.call$3(t1.call$2(20, 245), "az", 21);
+ b = t1.call$2(21, 245);
+ t3.call$3(b, "az", 21);
+ t3.call$3(b, "09", 21);
+ t2.call$3(b, "+-.", 21);
+ return tables;
+ },
+ _scan(uri, start, end, state, indices) {
+ var t1, i, table, char, transition,
+ tables = $.$get$_scannerTables();
+ for (t1 = uri.length, i = start; i < end; ++i) {
+ if (!(state >= 0 && state < tables.length))
+ return A.ioore(tables, state);
+ table = tables[state];
+ if (!(i < t1))
+ return A.ioore(uri, i);
+ char = uri.charCodeAt(i) ^ 96;
+ transition = table[char > 95 ? 31 : char];
+ state = transition & 31;
+ B.JSArray_methods.$indexSet(indices, transition >>> 5, i);
+ }
+ return state;
+ },
+ _SimpleUri__packageNameEnd(uri) {
+ if (uri._schemeEnd === 7 && B.JSString_methods.startsWith$1(uri._uri, "package") && uri._hostStart <= 0)
+ return A._skipPackageNameChars(uri._uri, uri._pathStart, uri._queryStart);
+ return -1;
+ },
+ _skipPackageNameChars(source, start, end) {
+ var t1, i, dots, char;
+ for (t1 = source.length, i = start, dots = 0; i < end; ++i) {
+ if (!(i >= 0 && i < t1))
+ return A.ioore(source, i);
+ char = source.charCodeAt(i);
+ if (char === 47)
+ return dots !== 0 ? i : -1;
+ if (char === 37 || char === 58)
+ return -1;
+ dots |= char ^ 46;
+ }
+ return -1;
+ },
+ _caseInsensitiveCompareStart(prefix, string, start) {
+ var t1, t2, result, i, t3, stringChar, delta, lowerChar;
+ for (t1 = prefix.length, t2 = string.length, result = 0, i = 0; i < t1; ++i) {
+ t3 = start + i;
+ if (!(t3 < t2))
+ return A.ioore(string, t3);
+ stringChar = string.charCodeAt(t3);
+ delta = prefix.charCodeAt(i) ^ stringChar;
+ if (delta !== 0) {
+ if (delta === 32) {
+ lowerChar = stringChar | delta;
+ if (97 <= lowerChar && lowerChar <= 122) {
+ result = 32;
+ continue;
+ }
+ }
+ return -1;
+ }
+ }
+ return result;
+ },
+ NoSuchMethodError_toString_closure: function NoSuchMethodError_toString_closure(t0, t1) {
+ this._box_0 = t0;
+ this.sb = t1;
+ },
+ DateTime: function DateTime(t0, t1) {
+ this._core$_value = t0;
+ this.isUtc = t1;
+ },
+ Duration: function Duration(t0) {
+ this._duration = t0;
+ },
+ Error: function Error() {
+ },
+ AssertionError: function AssertionError(t0) {
+ this.message = t0;
+ },
+ TypeError: function TypeError() {
+ },
+ ArgumentError: function ArgumentError(t0, t1, t2, t3) {
+ var _ = this;
+ _._hasValue = t0;
+ _.invalidValue = t1;
+ _.name = t2;
+ _.message = t3;
+ },
+ RangeError: function RangeError(t0, t1, t2, t3, t4, t5) {
+ var _ = this;
+ _.start = t0;
+ _.end = t1;
+ _._hasValue = t2;
+ _.invalidValue = t3;
+ _.name = t4;
+ _.message = t5;
+ },
+ IndexError: function IndexError(t0, t1, t2, t3, t4) {
+ var _ = this;
+ _.length = t0;
+ _._hasValue = t1;
+ _.invalidValue = t2;
+ _.name = t3;
+ _.message = t4;
+ },
+ NoSuchMethodError: function NoSuchMethodError(t0, t1, t2, t3) {
+ var _ = this;
+ _._core$_receiver = t0;
+ _._core$_memberName = t1;
+ _._core$_arguments = t2;
+ _._namedArguments = t3;
+ },
+ UnsupportedError: function UnsupportedError(t0) {
+ this.message = t0;
+ },
+ UnimplementedError: function UnimplementedError(t0) {
+ this.message = t0;
+ },
+ StateError: function StateError(t0) {
+ this.message = t0;
+ },
+ ConcurrentModificationError: function ConcurrentModificationError(t0) {
+ this.modifiedObject = t0;
+ },
+ OutOfMemoryError: function OutOfMemoryError() {
+ },
+ StackOverflowError: function StackOverflowError() {
+ },
+ _Exception: function _Exception(t0) {
+ this.message = t0;
+ },
+ FormatException: function FormatException(t0, t1, t2) {
+ this.message = t0;
+ this.source = t1;
+ this.offset = t2;
+ },
+ Iterable: function Iterable() {
+ },
+ Null: function Null() {
+ },
+ Object: function Object() {
+ },
+ _StringStackTrace: function _StringStackTrace(t0) {
+ this._stackTrace = t0;
+ },
+ StringBuffer: function StringBuffer(t0) {
+ this._contents = t0;
+ },
+ Uri_splitQueryString_closure: function Uri_splitQueryString_closure(t0) {
+ this.encoding = t0;
+ },
+ Uri__parseIPv4Address_error: function Uri__parseIPv4Address_error(t0) {
+ this.host = t0;
+ },
+ Uri_parseIPv6Address_error: function Uri_parseIPv6Address_error(t0) {
+ this.host = t0;
+ },
+ Uri_parseIPv6Address_parseHex: function Uri_parseIPv6Address_parseHex(t0, t1) {
+ this.error = t0;
+ this.host = t1;
+ },
+ _Uri: function _Uri(t0, t1, t2, t3, t4, t5, t6) {
+ var _ = this;
+ _.scheme = t0;
+ _._userInfo = t1;
+ _._host = t2;
+ _._port = t3;
+ _.path = t4;
+ _._query = t5;
+ _._fragment = t6;
+ _.___Uri_queryParameters_FI = _.___Uri_hashCode_FI = _.___Uri_pathSegments_FI = _.___Uri__text_FI = $;
+ },
+ _Uri__makePath_closure: function _Uri__makePath_closure() {
+ },
+ UriData: function UriData(t0, t1, t2) {
+ this._text = t0;
+ this._separatorIndices = t1;
+ this._uriCache = t2;
+ },
+ _createTables_build: function _createTables_build(t0) {
+ this.tables = t0;
+ },
+ _createTables_setChars: function _createTables_setChars() {
+ },
+ _createTables_setRange: function _createTables_setRange() {
+ },
+ _SimpleUri: function _SimpleUri(t0, t1, t2, t3, t4, t5, t6, t7) {
+ var _ = this;
+ _._uri = t0;
+ _._schemeEnd = t1;
+ _._hostStart = t2;
+ _._portStart = t3;
+ _._pathStart = t4;
+ _._queryStart = t5;
+ _._fragmentStart = t6;
+ _._schemeCache = t7;
+ _._hashCodeCache = null;
+ },
+ _DataUri: function _DataUri(t0, t1, t2, t3, t4, t5, t6) {
+ var _ = this;
+ _.scheme = t0;
+ _._userInfo = t1;
+ _._host = t2;
+ _._port = t3;
+ _.path = t4;
+ _._query = t5;
+ _._fragment = t6;
+ _.___Uri_queryParameters_FI = _.___Uri_hashCode_FI = _.___Uri_pathSegments_FI = _.___Uri__text_FI = $;
+ },
+ HtmlElement: function HtmlElement() {
+ },
+ AccessibleNodeList: function AccessibleNodeList() {
+ },
+ AnchorElement: function AnchorElement() {
+ },
+ AreaElement: function AreaElement() {
+ },
+ Blob: function Blob() {
+ },
+ CharacterData: function CharacterData() {
+ },
+ CssPerspective: function CssPerspective() {
+ },
+ CssRule: function CssRule() {
+ },
+ CssStyleDeclaration: function CssStyleDeclaration() {
+ },
+ CssStyleDeclarationBase: function CssStyleDeclarationBase() {
+ },
+ CssStyleValue: function CssStyleValue() {
+ },
+ CssTransformComponent: function CssTransformComponent() {
+ },
+ CssTransformValue: function CssTransformValue() {
+ },
+ CssUnparsedValue: function CssUnparsedValue() {
+ },
+ DataTransferItemList: function DataTransferItemList() {
+ },
+ DomException: function DomException() {
+ },
+ DomRectList: function DomRectList() {
+ },
+ DomRectReadOnly: function DomRectReadOnly() {
+ },
+ DomStringList: function DomStringList() {
+ },
+ DomTokenList: function DomTokenList() {
+ },
+ Element: function Element() {
+ },
+ EventTarget: function EventTarget() {
+ },
+ File: function File() {
+ },
+ FileList: function FileList() {
+ },
+ FileWriter: function FileWriter() {
+ },
+ FormElement: function FormElement() {
+ },
+ Gamepad: function Gamepad() {
+ },
+ History: function History() {
+ },
+ HtmlCollection: function HtmlCollection() {
+ },
+ Location: function Location() {
+ },
+ MediaList: function MediaList() {
+ },
+ MidiInputMap: function MidiInputMap() {
+ },
+ MidiInputMap_keys_closure: function MidiInputMap_keys_closure(t0) {
+ this.keys = t0;
+ },
+ MidiOutputMap: function MidiOutputMap() {
+ },
+ MidiOutputMap_keys_closure: function MidiOutputMap_keys_closure(t0) {
+ this.keys = t0;
+ },
+ MimeType: function MimeType() {
+ },
+ MimeTypeArray: function MimeTypeArray() {
+ },
+ Node: function Node() {
+ },
+ NodeList: function NodeList() {
+ },
+ Plugin: function Plugin() {
+ },
+ PluginArray: function PluginArray() {
+ },
+ RtcStatsReport: function RtcStatsReport() {
+ },
+ RtcStatsReport_keys_closure: function RtcStatsReport_keys_closure(t0) {
+ this.keys = t0;
+ },
+ SelectElement: function SelectElement() {
+ },
+ SourceBuffer: function SourceBuffer() {
+ },
+ SourceBufferList: function SourceBufferList() {
+ },
+ SpeechGrammar: function SpeechGrammar() {
+ },
+ SpeechGrammarList: function SpeechGrammarList() {
+ },
+ SpeechRecognitionResult: function SpeechRecognitionResult() {
+ },
+ Storage: function Storage() {
+ },
+ Storage_keys_closure: function Storage_keys_closure(t0) {
+ this.keys = t0;
+ },
+ StyleSheet: function StyleSheet() {
+ },
+ TextTrack: function TextTrack() {
+ },
+ TextTrackCue: function TextTrackCue() {
+ },
+ TextTrackCueList: function TextTrackCueList() {
+ },
+ TextTrackList: function TextTrackList() {
+ },
+ TimeRanges: function TimeRanges() {
+ },
+ Touch: function Touch() {
+ },
+ TouchList: function TouchList() {
+ },
+ TrackDefaultList: function TrackDefaultList() {
+ },
+ Url: function Url() {
+ },
+ VideoTrackList: function VideoTrackList() {
+ },
+ _CssRuleList: function _CssRuleList() {
+ },
+ _DomRect: function _DomRect() {
+ },
+ _GamepadList: function _GamepadList() {
+ },
+ _NamedNodeMap: function _NamedNodeMap() {
+ },
+ _SpeechRecognitionResultList: function _SpeechRecognitionResultList() {
+ },
+ _StyleSheetList: function _StyleSheetList() {
+ },
+ ImmutableListMixin: function ImmutableListMixin() {
+ },
+ FixedSizeListIterator: function FixedSizeListIterator(t0, t1, t2) {
+ var _ = this;
+ _._array = t0;
+ _._html$_length = t1;
+ _._position = -1;
+ _._html$_current = null;
+ _.$ti = t2;
+ },
+ _CssStyleDeclaration_JavaScriptObject_CssStyleDeclarationBase: function _CssStyleDeclaration_JavaScriptObject_CssStyleDeclarationBase() {
+ },
+ _DomRectList_JavaScriptObject_ListMixin: function _DomRectList_JavaScriptObject_ListMixin() {
+ },
+ _DomRectList_JavaScriptObject_ListMixin_ImmutableListMixin: function _DomRectList_JavaScriptObject_ListMixin_ImmutableListMixin() {
+ },
+ _DomStringList_JavaScriptObject_ListMixin: function _DomStringList_JavaScriptObject_ListMixin() {
+ },
+ _DomStringList_JavaScriptObject_ListMixin_ImmutableListMixin: function _DomStringList_JavaScriptObject_ListMixin_ImmutableListMixin() {
+ },
+ _FileList_JavaScriptObject_ListMixin: function _FileList_JavaScriptObject_ListMixin() {
+ },
+ _FileList_JavaScriptObject_ListMixin_ImmutableListMixin: function _FileList_JavaScriptObject_ListMixin_ImmutableListMixin() {
+ },
+ _HtmlCollection_JavaScriptObject_ListMixin: function _HtmlCollection_JavaScriptObject_ListMixin() {
+ },
+ _HtmlCollection_JavaScriptObject_ListMixin_ImmutableListMixin: function _HtmlCollection_JavaScriptObject_ListMixin_ImmutableListMixin() {
+ },
+ _MidiInputMap_JavaScriptObject_MapMixin: function _MidiInputMap_JavaScriptObject_MapMixin() {
+ },
+ _MidiOutputMap_JavaScriptObject_MapMixin: function _MidiOutputMap_JavaScriptObject_MapMixin() {
+ },
+ _MimeTypeArray_JavaScriptObject_ListMixin: function _MimeTypeArray_JavaScriptObject_ListMixin() {
+ },
+ _MimeTypeArray_JavaScriptObject_ListMixin_ImmutableListMixin: function _MimeTypeArray_JavaScriptObject_ListMixin_ImmutableListMixin() {
+ },
+ _NodeList_JavaScriptObject_ListMixin: function _NodeList_JavaScriptObject_ListMixin() {
+ },
+ _NodeList_JavaScriptObject_ListMixin_ImmutableListMixin: function _NodeList_JavaScriptObject_ListMixin_ImmutableListMixin() {
+ },
+ _PluginArray_JavaScriptObject_ListMixin: function _PluginArray_JavaScriptObject_ListMixin() {
+ },
+ _PluginArray_JavaScriptObject_ListMixin_ImmutableListMixin: function _PluginArray_JavaScriptObject_ListMixin_ImmutableListMixin() {
+ },
+ _RtcStatsReport_JavaScriptObject_MapMixin: function _RtcStatsReport_JavaScriptObject_MapMixin() {
+ },
+ _SourceBufferList_EventTarget_ListMixin: function _SourceBufferList_EventTarget_ListMixin() {
+ },
+ _SourceBufferList_EventTarget_ListMixin_ImmutableListMixin: function _SourceBufferList_EventTarget_ListMixin_ImmutableListMixin() {
+ },
+ _SpeechGrammarList_JavaScriptObject_ListMixin: function _SpeechGrammarList_JavaScriptObject_ListMixin() {
+ },
+ _SpeechGrammarList_JavaScriptObject_ListMixin_ImmutableListMixin: function _SpeechGrammarList_JavaScriptObject_ListMixin_ImmutableListMixin() {
+ },
+ _Storage_JavaScriptObject_MapMixin: function _Storage_JavaScriptObject_MapMixin() {
+ },
+ _TextTrackCueList_JavaScriptObject_ListMixin: function _TextTrackCueList_JavaScriptObject_ListMixin() {
+ },
+ _TextTrackCueList_JavaScriptObject_ListMixin_ImmutableListMixin: function _TextTrackCueList_JavaScriptObject_ListMixin_ImmutableListMixin() {
+ },
+ _TextTrackList_EventTarget_ListMixin: function _TextTrackList_EventTarget_ListMixin() {
+ },
+ _TextTrackList_EventTarget_ListMixin_ImmutableListMixin: function _TextTrackList_EventTarget_ListMixin_ImmutableListMixin() {
+ },
+ _TouchList_JavaScriptObject_ListMixin: function _TouchList_JavaScriptObject_ListMixin() {
+ },
+ _TouchList_JavaScriptObject_ListMixin_ImmutableListMixin: function _TouchList_JavaScriptObject_ListMixin_ImmutableListMixin() {
+ },
+ __CssRuleList_JavaScriptObject_ListMixin: function __CssRuleList_JavaScriptObject_ListMixin() {
+ },
+ __CssRuleList_JavaScriptObject_ListMixin_ImmutableListMixin: function __CssRuleList_JavaScriptObject_ListMixin_ImmutableListMixin() {
+ },
+ __GamepadList_JavaScriptObject_ListMixin: function __GamepadList_JavaScriptObject_ListMixin() {
+ },
+ __GamepadList_JavaScriptObject_ListMixin_ImmutableListMixin: function __GamepadList_JavaScriptObject_ListMixin_ImmutableListMixin() {
+ },
+ __NamedNodeMap_JavaScriptObject_ListMixin: function __NamedNodeMap_JavaScriptObject_ListMixin() {
+ },
+ __NamedNodeMap_JavaScriptObject_ListMixin_ImmutableListMixin: function __NamedNodeMap_JavaScriptObject_ListMixin_ImmutableListMixin() {
+ },
+ __SpeechRecognitionResultList_JavaScriptObject_ListMixin: function __SpeechRecognitionResultList_JavaScriptObject_ListMixin() {
+ },
+ __SpeechRecognitionResultList_JavaScriptObject_ListMixin_ImmutableListMixin: function __SpeechRecognitionResultList_JavaScriptObject_ListMixin_ImmutableListMixin() {
+ },
+ __StyleSheetList_JavaScriptObject_ListMixin: function __StyleSheetList_JavaScriptObject_ListMixin() {
+ },
+ __StyleSheetList_JavaScriptObject_ListMixin_ImmutableListMixin: function __StyleSheetList_JavaScriptObject_ListMixin_ImmutableListMixin() {
+ },
+ _convertDartFunctionFast(f) {
+ var ret,
+ existing = f.$dart_jsFunction;
+ if (existing != null)
+ return existing;
+ ret = function(_call, f) {
+ return function() {
+ return _call(f, Array.prototype.slice.apply(arguments));
+ };
+ }(A._callDartFunctionFast, f);
+ ret[$.$get$DART_CLOSURE_PROPERTY_NAME()] = f;
+ f.$dart_jsFunction = ret;
+ return ret;
+ },
+ _callDartFunctionFast(callback, $arguments) {
+ type$.List_dynamic._as($arguments);
+ type$.Function._as(callback);
+ return A.Primitives_applyFunction(callback, $arguments, null);
+ },
+ allowInterop(f, $F) {
+ if (typeof f == "function")
+ return f;
+ else
+ return $F._as(A._convertDartFunctionFast(f));
+ },
+ _noJsifyRequired(o) {
+ return o == null || A._isBool(o) || typeof o == "number" || typeof o == "string" || type$.Int8List._is(o) || type$.Uint8List._is(o) || type$.Uint8ClampedList._is(o) || type$.Int16List._is(o) || type$.Uint16List._is(o) || type$.Int32List._is(o) || type$.Uint32List._is(o) || type$.Float32List._is(o) || type$.Float64List._is(o) || type$.ByteBuffer._is(o) || type$.ByteData._is(o);
+ },
+ jsify(object) {
+ if (A._noJsifyRequired(object))
+ return object;
+ return new A.jsify__convert(new A._IdentityHashMap(type$._IdentityHashMap_of_nullable_Object_and_nullable_Object)).call$1(object);
+ },
+ getProperty(o, $name, $T) {
+ return $T._as(o[$name]);
+ },
+ callMethod(o, method, args, $T) {
+ return $T._as(o[method].apply(o, args));
+ },
+ callConstructor(constr, $arguments, $T) {
+ var args, factoryFunction;
+ if ($arguments instanceof Array)
+ switch ($arguments.length) {
+ case 0:
+ return $T._as(new constr());
+ case 1:
+ return $T._as(new constr($arguments[0]));
+ case 2:
+ return $T._as(new constr($arguments[0], $arguments[1]));
+ case 3:
+ return $T._as(new constr($arguments[0], $arguments[1], $arguments[2]));
+ case 4:
+ return $T._as(new constr($arguments[0], $arguments[1], $arguments[2], $arguments[3]));
+ }
+ args = [null];
+ B.JSArray_methods.addAll$1(args, $arguments);
+ factoryFunction = constr.bind.apply(constr, args);
+ String(factoryFunction);
+ return $T._as(new factoryFunction());
+ },
+ promiseToFuture(jsPromise, $T) {
+ var t1 = new A._Future($.Zone__current, $T._eval$1("_Future<0>")),
+ completer = new A._AsyncCompleter(t1, $T._eval$1("_AsyncCompleter<0>"));
+ jsPromise.then(A.convertDartClosureToJS(new A.promiseToFuture_closure(completer, $T), 1), A.convertDartClosureToJS(new A.promiseToFuture_closure0(completer), 1));
+ return t1;
+ },
+ _noDartifyRequired(o) {
+ return o == null || typeof o === "boolean" || typeof o === "number" || typeof o === "string" || o instanceof Int8Array || o instanceof Uint8Array || o instanceof Uint8ClampedArray || o instanceof Int16Array || o instanceof Uint16Array || o instanceof Int32Array || o instanceof Uint32Array || o instanceof Float32Array || o instanceof Float64Array || o instanceof ArrayBuffer || o instanceof DataView;
+ },
+ dartify(o) {
+ if (A._noDartifyRequired(o))
+ return o;
+ return new A.dartify_convert(new A._IdentityHashMap(type$._IdentityHashMap_of_nullable_Object_and_nullable_Object)).call$1(o);
+ },
+ jsify__convert: function jsify__convert(t0) {
+ this._convertedObjects = t0;
+ },
+ promiseToFuture_closure: function promiseToFuture_closure(t0, t1) {
+ this.completer = t0;
+ this.T = t1;
+ },
+ promiseToFuture_closure0: function promiseToFuture_closure0(t0) {
+ this.completer = t0;
+ },
+ dartify_convert: function dartify_convert(t0) {
+ this._convertedObjects = t0;
+ },
+ NullRejectionException: function NullRejectionException(t0) {
+ this.isUndefined = t0;
+ },
+ Length: function Length() {
+ },
+ LengthList: function LengthList() {
+ },
+ Number: function Number() {
+ },
+ NumberList: function NumberList() {
+ },
+ PointList: function PointList() {
+ },
+ StringList: function StringList() {
+ },
+ Transform: function Transform() {
+ },
+ TransformList: function TransformList() {
+ },
+ _LengthList_JavaScriptObject_ListMixin: function _LengthList_JavaScriptObject_ListMixin() {
+ },
+ _LengthList_JavaScriptObject_ListMixin_ImmutableListMixin: function _LengthList_JavaScriptObject_ListMixin_ImmutableListMixin() {
+ },
+ _NumberList_JavaScriptObject_ListMixin: function _NumberList_JavaScriptObject_ListMixin() {
+ },
+ _NumberList_JavaScriptObject_ListMixin_ImmutableListMixin: function _NumberList_JavaScriptObject_ListMixin_ImmutableListMixin() {
+ },
+ _StringList_JavaScriptObject_ListMixin: function _StringList_JavaScriptObject_ListMixin() {
+ },
+ _StringList_JavaScriptObject_ListMixin_ImmutableListMixin: function _StringList_JavaScriptObject_ListMixin_ImmutableListMixin() {
+ },
+ _TransformList_JavaScriptObject_ListMixin: function _TransformList_JavaScriptObject_ListMixin() {
+ },
+ _TransformList_JavaScriptObject_ListMixin_ImmutableListMixin: function _TransformList_JavaScriptObject_ListMixin_ImmutableListMixin() {
+ },
+ AudioBuffer: function AudioBuffer() {
+ },
+ AudioParamMap: function AudioParamMap() {
+ },
+ AudioParamMap_keys_closure: function AudioParamMap_keys_closure(t0) {
+ this.keys = t0;
+ },
+ AudioTrackList: function AudioTrackList() {
+ },
+ BaseAudioContext: function BaseAudioContext() {
+ },
+ OfflineAudioContext: function OfflineAudioContext() {
+ },
+ _AudioParamMap_JavaScriptObject_MapMixin: function _AudioParamMap_JavaScriptObject_MapMixin() {
+ },
+ NullStreamSink: function NullStreamSink(t0, t1) {
+ var _ = this;
+ _.done = t0;
+ _._addingStream = _._null_stream_sink$_closed = false;
+ _.$ti = t1;
+ },
+ NullStreamSink_addStream_closure: function NullStreamSink_addStream_closure(t0) {
+ this.$this = t0;
+ },
+ Context_Context(style) {
+ return new A.Context(style, ".");
+ },
+ _parseUri(uri) {
+ return uri;
+ },
+ _validateArgList(method, args) {
+ var numArgs, i, numArgs0, message, t1, t2, t3, t4;
+ for (numArgs = args.length, i = 1; i < numArgs; ++i) {
+ if (args[i] == null || args[i - 1] != null)
+ continue;
+ for (; numArgs >= 1; numArgs = numArgs0) {
+ numArgs0 = numArgs - 1;
+ if (args[numArgs0] != null)
+ break;
+ }
+ message = new A.StringBuffer("");
+ t1 = "" + (method + "(");
+ message._contents = t1;
+ t2 = A._arrayInstanceType(args);
+ t3 = t2._eval$1("SubListIterable<1>");
+ t4 = new A.SubListIterable(args, 0, numArgs, t3);
+ t4.SubListIterable$3(args, 0, numArgs, t2._precomputed1);
+ t3 = t1 + new A.MappedListIterable(t4, t3._eval$1("String(ListIterable.E)")._as(new A._validateArgList_closure()), t3._eval$1("MappedListIterable<ListIterable.E,String>")).join$1(0, ", ");
+ message._contents = t3;
+ message._contents = t3 + ("): part " + (i - 1) + " was null, but part " + i + " was not.");
+ throw A.wrapException(A.ArgumentError$(message.toString$0(0), null));
+ }
+ },
+ Context: function Context(t0, t1) {
+ this.style = t0;
+ this._context$_current = t1;
+ },
+ Context_joinAll_closure: function Context_joinAll_closure() {
+ },
+ Context_split_closure: function Context_split_closure() {
+ },
+ _validateArgList_closure: function _validateArgList_closure() {
+ },
+ InternalStyle: function InternalStyle() {
+ },
+ ParsedPath_ParsedPath$parse(path, style) {
+ var t1, parts, separators, t2, start, i,
+ root = style.getRoot$1(path);
+ style.isRootRelative$1(path);
+ if (root != null)
+ path = B.JSString_methods.substring$1(path, root.length);
+ t1 = type$.JSArray_String;
+ parts = A._setArrayType([], t1);
+ separators = A._setArrayType([], t1);
+ t1 = path.length;
+ if (t1 !== 0) {
+ if (0 >= t1)
+ return A.ioore(path, 0);
+ t2 = style.isSeparator$1(path.charCodeAt(0));
+ } else
+ t2 = false;
+ if (t2) {
+ if (0 >= t1)
+ return A.ioore(path, 0);
+ B.JSArray_methods.add$1(separators, path[0]);
+ start = 1;
+ } else {
+ B.JSArray_methods.add$1(separators, "");
+ start = 0;
+ }
+ for (i = start; i < t1; ++i)
+ if (style.isSeparator$1(path.charCodeAt(i))) {
+ B.JSArray_methods.add$1(parts, B.JSString_methods.substring$2(path, start, i));
+ B.JSArray_methods.add$1(separators, path[i]);
+ start = i + 1;
+ }
+ if (start < t1) {
+ B.JSArray_methods.add$1(parts, B.JSString_methods.substring$1(path, start));
+ B.JSArray_methods.add$1(separators, "");
+ }
+ return new A.ParsedPath(style, root, parts, separators);
+ },
+ ParsedPath: function ParsedPath(t0, t1, t2, t3) {
+ var _ = this;
+ _.style = t0;
+ _.root = t1;
+ _.parts = t2;
+ _.separators = t3;
+ },
+ PathException$(message) {
+ return new A.PathException(message);
+ },
+ PathException: function PathException(t0) {
+ this.message = t0;
+ },
+ Style__getPlatformStyle() {
+ if (A.Uri_base().get$scheme() !== "file")
+ return $.$get$Style_url();
+ var t1 = A.Uri_base();
+ if (!B.JSString_methods.endsWith$1(t1.get$path(t1), "/"))
+ return $.$get$Style_url();
+ if (A._Uri__Uri(null, "a/b", null, null).toFilePath$0() === "a\\b")
+ return $.$get$Style_windows();
+ return $.$get$Style_posix();
+ },
+ Style: function Style() {
+ },
+ PosixStyle: function PosixStyle(t0, t1, t2) {
+ this.separatorPattern = t0;
+ this.needsSeparatorPattern = t1;
+ this.rootPattern = t2;
+ },
+ UrlStyle: function UrlStyle(t0, t1, t2, t3) {
+ var _ = this;
+ _.separatorPattern = t0;
+ _.needsSeparatorPattern = t1;
+ _.rootPattern = t2;
+ _.relativeRootPattern = t3;
+ },
+ WindowsStyle: function WindowsStyle(t0, t1, t2, t3) {
+ var _ = this;
+ _.separatorPattern = t0;
+ _.needsSeparatorPattern = t1;
+ _.rootPattern = t2;
+ _.relativeRootPattern = t3;
+ },
+ WindowsStyle_absolutePathToUri_closure: function WindowsStyle_absolutePathToUri_closure() {
+ },
+ Chain_Chain$parse(chain) {
+ var t1, t2,
+ _s51_ = string$.x3d_____;
+ if (chain.length === 0)
+ return new A.Chain(A.List_List$unmodifiable(A._setArrayType([], type$.JSArray_Trace), type$.Trace));
+ t1 = $.$get$vmChainGap();
+ if (B.JSString_methods.contains$1(chain, t1)) {
+ t1 = B.JSString_methods.split$1(chain, t1);
+ t2 = A._arrayInstanceType(t1);
+ return new A.Chain(A.List_List$unmodifiable(new A.MappedIterable(new A.WhereIterable(t1, t2._eval$1("bool(1)")._as(new A.Chain_Chain$parse_closure()), t2._eval$1("WhereIterable<1>")), t2._eval$1("Trace(1)")._as(A.trace_Trace___parseVM_tearOff$closure()), t2._eval$1("MappedIterable<1,Trace>")), type$.Trace));
+ }
+ if (!B.JSString_methods.contains$1(chain, _s51_))
+ return new A.Chain(A.List_List$unmodifiable(A._setArrayType([A.Trace_Trace$parse(chain)], type$.JSArray_Trace), type$.Trace));
+ return new A.Chain(A.List_List$unmodifiable(new A.MappedListIterable(A._setArrayType(chain.split(_s51_), type$.JSArray_String), type$.Trace_Function_String._as(A.trace_Trace___parseFriendly_tearOff$closure()), type$.MappedListIterable_String_Trace), type$.Trace));
+ },
+ Chain: function Chain(t0) {
+ this.traces = t0;
+ },
+ Chain_Chain$parse_closure: function Chain_Chain$parse_closure() {
+ },
+ Chain_toTrace_closure: function Chain_toTrace_closure() {
+ },
+ Chain_toString_closure0: function Chain_toString_closure0() {
+ },
+ Chain_toString__closure0: function Chain_toString__closure0() {
+ },
+ Chain_toString_closure: function Chain_toString_closure(t0) {
+ this.longest = t0;
+ },
+ Chain_toString__closure: function Chain_toString__closure(t0) {
+ this.longest = t0;
+ },
+ Frame___parseVM_tearOff(frame) {
+ return A.Frame_Frame$parseVM(A._asString(frame));
+ },
+ Frame_Frame$parseVM(frame) {
+ return A.Frame__catchFormatException(frame, new A.Frame_Frame$parseVM_closure(frame));
+ },
+ Frame___parseV8_tearOff(frame) {
+ return A.Frame_Frame$parseV8(A._asString(frame));
+ },
+ Frame_Frame$parseV8(frame) {
+ return A.Frame__catchFormatException(frame, new A.Frame_Frame$parseV8_closure(frame));
+ },
+ Frame_Frame$_parseFirefoxEval(frame) {
+ return A.Frame__catchFormatException(frame, new A.Frame_Frame$_parseFirefoxEval_closure(frame));
+ },
+ Frame___parseFirefox_tearOff(frame) {
+ return A.Frame_Frame$parseFirefox(A._asString(frame));
+ },
+ Frame_Frame$parseFirefox(frame) {
+ return A.Frame__catchFormatException(frame, new A.Frame_Frame$parseFirefox_closure(frame));
+ },
+ Frame___parseFriendly_tearOff(frame) {
+ return A.Frame_Frame$parseFriendly(A._asString(frame));
+ },
+ Frame_Frame$parseFriendly(frame) {
+ return A.Frame__catchFormatException(frame, new A.Frame_Frame$parseFriendly_closure(frame));
+ },
+ Frame__uriOrPathToUri(uriOrPath) {
+ if (B.JSString_methods.contains$1(uriOrPath, $.$get$Frame__uriRegExp()))
+ return A.Uri_parse(uriOrPath);
+ else if (B.JSString_methods.contains$1(uriOrPath, $.$get$Frame__windowsRegExp()))
+ return A._Uri__Uri$file(uriOrPath, true);
+ else if (B.JSString_methods.startsWith$1(uriOrPath, "/"))
+ return A._Uri__Uri$file(uriOrPath, false);
+ if (B.JSString_methods.contains$1(uriOrPath, "\\"))
+ return $.$get$windows().toUri$1(uriOrPath);
+ return A.Uri_parse(uriOrPath);
+ },
+ Frame__catchFormatException(text, body) {
+ var t1, exception;
+ try {
+ t1 = body.call$0();
+ return t1;
+ } catch (exception) {
+ if (A.unwrapException(exception) instanceof A.FormatException)
+ return new A.UnparsedFrame(A._Uri__Uri(null, "unparsed", null, null), text);
+ else
+ throw exception;
+ }
+ },
+ Frame: function Frame(t0, t1, t2, t3) {
+ var _ = this;
+ _.uri = t0;
+ _.line = t1;
+ _.column = t2;
+ _.member = t3;
+ },
+ Frame_Frame$parseVM_closure: function Frame_Frame$parseVM_closure(t0) {
+ this.frame = t0;
+ },
+ Frame_Frame$parseV8_closure: function Frame_Frame$parseV8_closure(t0) {
+ this.frame = t0;
+ },
+ Frame_Frame$parseV8_closure_parseLocation: function Frame_Frame$parseV8_closure_parseLocation(t0) {
+ this.frame = t0;
+ },
+ Frame_Frame$_parseFirefoxEval_closure: function Frame_Frame$_parseFirefoxEval_closure(t0) {
+ this.frame = t0;
+ },
+ Frame_Frame$parseFirefox_closure: function Frame_Frame$parseFirefox_closure(t0) {
+ this.frame = t0;
+ },
+ Frame_Frame$parseFriendly_closure: function Frame_Frame$parseFriendly_closure(t0) {
+ this.frame = t0;
+ },
+ LazyTrace: function LazyTrace(t0) {
+ this._thunk = t0;
+ this.__LazyTrace__trace_FI = $;
+ },
+ LazyTrace_terse_closure: function LazyTrace_terse_closure(t0) {
+ this.$this = t0;
+ },
+ Trace_Trace$from(trace) {
+ if (type$.Trace._is(trace))
+ return trace;
+ if (trace instanceof A.Chain)
+ return trace.toTrace$0();
+ return new A.LazyTrace(new A.Trace_Trace$from_closure(trace));
+ },
+ Trace_Trace$parse(trace) {
+ var error, t1, exception;
+ try {
+ if (trace.length === 0) {
+ t1 = A.Trace$(A._setArrayType([], type$.JSArray_Frame), null);
+ return t1;
+ }
+ if (B.JSString_methods.contains$1(trace, $.$get$_v8Trace())) {
+ t1 = A.Trace$parseV8(trace);
+ return t1;
+ }
+ if (B.JSString_methods.contains$1(trace, "\tat ")) {
+ t1 = A.Trace$parseJSCore(trace);
+ return t1;
+ }
+ if (B.JSString_methods.contains$1(trace, $.$get$_firefoxSafariTrace()) || B.JSString_methods.contains$1(trace, $.$get$_firefoxEvalTrace())) {
+ t1 = A.Trace$parseFirefox(trace);
+ return t1;
+ }
+ if (B.JSString_methods.contains$1(trace, string$.x3d_____)) {
+ t1 = A.Chain_Chain$parse(trace).toTrace$0();
+ return t1;
+ }
+ if (B.JSString_methods.contains$1(trace, $.$get$_friendlyTrace())) {
+ t1 = A.Trace$parseFriendly(trace);
+ return t1;
+ }
+ t1 = A.Trace$parseVM(trace);
+ return t1;
+ } catch (exception) {
+ t1 = A.unwrapException(exception);
+ if (t1 instanceof A.FormatException) {
+ error = t1;
+ throw A.wrapException(A.FormatException$(error.message + "\nStack trace:\n" + trace, null, null));
+ } else
+ throw exception;
+ }
+ },
+ Trace___parseVM_tearOff(trace) {
+ return A.Trace$parseVM(A._asString(trace));
+ },
+ Trace$parseVM(trace) {
+ var t1 = A.List_List$unmodifiable(A.Trace__parseVM(trace), type$.Frame);
+ return new A.Trace(t1, new A._StringStackTrace(trace));
+ },
+ Trace__parseVM(trace) {
+ var $frames,
+ t1 = B.JSString_methods.trim$0(trace),
+ t2 = $.$get$vmChainGap(),
+ t3 = type$.WhereIterable_String,
+ lines = new A.WhereIterable(A._setArrayType(A.stringReplaceAllUnchecked(t1, t2, "").split("\n"), type$.JSArray_String), type$.bool_Function_String._as(new A.Trace__parseVM_closure()), t3);
+ if (!lines.get$iterator(lines).moveNext$0())
+ return A._setArrayType([], type$.JSArray_Frame);
+ t1 = A.TakeIterable_TakeIterable(lines, lines.get$length(lines) - 1, t3._eval$1("Iterable.E"));
+ t2 = A._instanceType(t1);
+ t2 = A.MappedIterable_MappedIterable(t1, t2._eval$1("Frame(Iterable.E)")._as(A.frame_Frame___parseVM_tearOff$closure()), t2._eval$1("Iterable.E"), type$.Frame);
+ $frames = A.List_List$of(t2, true, A._instanceType(t2)._eval$1("Iterable.E"));
+ if (!J.endsWith$1$s(lines.get$last(lines), ".da"))
+ B.JSArray_methods.add$1($frames, A.Frame_Frame$parseVM(lines.get$last(lines)));
+ return $frames;
+ },
+ Trace$parseV8(trace) {
+ var t2, t3,
+ t1 = A.SubListIterable$(A._setArrayType(trace.split("\n"), type$.JSArray_String), 1, null, type$.String);
+ t1 = t1.super$Iterable$skipWhile(0, t1.$ti._eval$1("bool(ListIterable.E)")._as(new A.Trace$parseV8_closure()));
+ t2 = type$.Frame;
+ t3 = t1.$ti;
+ t2 = A.List_List$unmodifiable(A.MappedIterable_MappedIterable(t1, t3._eval$1("Frame(Iterable.E)")._as(A.frame_Frame___parseV8_tearOff$closure()), t3._eval$1("Iterable.E"), t2), t2);
+ return new A.Trace(t2, new A._StringStackTrace(trace));
+ },
+ Trace$parseJSCore(trace) {
+ var t1 = A.List_List$unmodifiable(new A.MappedIterable(new A.WhereIterable(A._setArrayType(trace.split("\n"), type$.JSArray_String), type$.bool_Function_String._as(new A.Trace$parseJSCore_closure()), type$.WhereIterable_String), type$.Frame_Function_String._as(A.frame_Frame___parseV8_tearOff$closure()), type$.MappedIterable_String_Frame), type$.Frame);
+ return new A.Trace(t1, new A._StringStackTrace(trace));
+ },
+ Trace$parseFirefox(trace) {
+ var t1 = A.List_List$unmodifiable(new A.MappedIterable(new A.WhereIterable(A._setArrayType(B.JSString_methods.trim$0(trace).split("\n"), type$.JSArray_String), type$.bool_Function_String._as(new A.Trace$parseFirefox_closure()), type$.WhereIterable_String), type$.Frame_Function_String._as(A.frame_Frame___parseFirefox_tearOff$closure()), type$.MappedIterable_String_Frame), type$.Frame);
+ return new A.Trace(t1, new A._StringStackTrace(trace));
+ },
+ Trace___parseFriendly_tearOff(trace) {
+ return A.Trace$parseFriendly(A._asString(trace));
+ },
+ Trace$parseFriendly(trace) {
+ var t1 = trace.length === 0 ? A._setArrayType([], type$.JSArray_Frame) : new A.MappedIterable(new A.WhereIterable(A._setArrayType(B.JSString_methods.trim$0(trace).split("\n"), type$.JSArray_String), type$.bool_Function_String._as(new A.Trace$parseFriendly_closure()), type$.WhereIterable_String), type$.Frame_Function_String._as(A.frame_Frame___parseFriendly_tearOff$closure()), type$.MappedIterable_String_Frame);
+ t1 = A.List_List$unmodifiable(t1, type$.Frame);
+ return new A.Trace(t1, new A._StringStackTrace(trace));
+ },
+ Trace$($frames, original) {
+ var t1 = A.List_List$unmodifiable($frames, type$.Frame);
+ return new A.Trace(t1, new A._StringStackTrace(original == null ? "" : original));
+ },
+ Trace: function Trace(t0, t1) {
+ this.frames = t0;
+ this.original = t1;
+ },
+ Trace_Trace$from_closure: function Trace_Trace$from_closure(t0) {
+ this.trace = t0;
+ },
+ Trace__parseVM_closure: function Trace__parseVM_closure() {
+ },
+ Trace$parseV8_closure: function Trace$parseV8_closure() {
+ },
+ Trace$parseJSCore_closure: function Trace$parseJSCore_closure() {
+ },
+ Trace$parseFirefox_closure: function Trace$parseFirefox_closure() {
+ },
+ Trace$parseFriendly_closure: function Trace$parseFriendly_closure() {
+ },
+ Trace_terse_closure: function Trace_terse_closure() {
+ },
+ Trace_foldFrames_closure: function Trace_foldFrames_closure(t0) {
+ this.oldPredicate = t0;
+ },
+ Trace_foldFrames_closure0: function Trace_foldFrames_closure0(t0) {
+ this._box_0 = t0;
+ },
+ Trace_toString_closure0: function Trace_toString_closure0() {
+ },
+ Trace_toString_closure: function Trace_toString_closure(t0) {
+ this.longest = t0;
+ },
+ UnparsedFrame: function UnparsedFrame(t0, t1) {
+ this.uri = t0;
+ this.member = t1;
+ },
+ GuaranteeChannel$(innerStream, innerSink, allowSinkErrors, $T) {
+ var t2, t1 = {};
+ t1.innerStream = innerStream;
+ t2 = new A.GuaranteeChannel($T._eval$1("GuaranteeChannel<0>"));
+ t2.GuaranteeChannel$3$allowSinkErrors(innerSink, true, t1, $T);
+ return t2;
+ },
+ GuaranteeChannel: function GuaranteeChannel(t0) {
+ var _ = this;
+ _.__GuaranteeChannel__streamController_F = _.__GuaranteeChannel__sink_F = $;
+ _._subscription = null;
+ _._disconnected = false;
+ _.$ti = t0;
+ },
+ GuaranteeChannel_closure: function GuaranteeChannel_closure(t0, t1, t2) {
+ this._box_0 = t0;
+ this.$this = t1;
+ this.T = t2;
+ },
+ GuaranteeChannel__closure: function GuaranteeChannel__closure(t0) {
+ this.$this = t0;
+ },
+ _GuaranteeSink: function _GuaranteeSink(t0, t1, t2, t3, t4) {
+ var _ = this;
+ _._inner = t0;
+ _._channel = t1;
+ _._doneCompleter = t2;
+ _._closed = _._disconnected = false;
+ _._addStreamCompleter = _._addStreamSubscription = null;
+ _._allowErrors = t3;
+ _.$ti = t4;
+ },
+ _GuaranteeSink_addStream_closure: function _GuaranteeSink_addStream_closure(t0) {
+ this.$this = t0;
+ },
+ _MultiChannel$(inner, $T) {
+ var t1 = type$.int;
+ t1 = new A._MultiChannel(inner, A.StreamChannelController$(true, $T), A.LinkedHashMap_LinkedHashMap$_empty(t1, $T._eval$1("StreamChannelController<0>")), A.LinkedHashSet_LinkedHashSet$_empty(t1), A.LinkedHashSet_LinkedHashSet$_empty(t1), $T._eval$1("_MultiChannel<0>"));
+ t1._MultiChannel$1(inner, $T);
+ return t1;
+ },
+ _MultiChannel: function _MultiChannel(t0, t1, t2, t3, t4, t5) {
+ var _ = this;
+ _._multi_channel$_inner = t0;
+ _._innerStreamSubscription = null;
+ _._mainController = t1;
+ _._controllers = t2;
+ _._pendingIds = t3;
+ _._closedIds = t4;
+ _._nextId = 1;
+ _.$ti = t5;
+ },
+ _MultiChannel_closure: function _MultiChannel_closure(t0, t1) {
+ this.$this = t0;
+ this.T = t1;
+ },
+ _MultiChannel_closure0: function _MultiChannel_closure0(t0) {
+ this.$this = t0;
+ },
+ _MultiChannel_closure1: function _MultiChannel_closure1(t0, t1) {
+ this.$this = t0;
+ this.T = t1;
+ },
+ _MultiChannel__closure: function _MultiChannel__closure(t0, t1, t2) {
+ this.$this = t0;
+ this.id = t1;
+ this.T = t2;
+ },
+ _MultiChannel_virtualChannel_closure: function _MultiChannel_virtualChannel_closure(t0, t1) {
+ this._box_0 = t0;
+ this.$this = t1;
+ },
+ _MultiChannel_virtualChannel_closure0: function _MultiChannel_virtualChannel_closure0(t0, t1) {
+ this._box_0 = t0;
+ this.$this = t1;
+ },
+ VirtualChannel: function VirtualChannel(t0, t1, t2, t3) {
+ var _ = this;
+ _._parent = t0;
+ _.stream = t1;
+ _.sink = t2;
+ _.$ti = t3;
+ },
+ StreamChannelController$(sync, $T) {
+ var _null = null,
+ t1 = new A.StreamChannelController($T._eval$1("StreamChannelController<0>")),
+ localToForeignController = A.StreamController_StreamController(_null, _null, true, $T),
+ foreignToLocalController = A.StreamController_StreamController(_null, _null, true, $T),
+ t2 = A._instanceType(foreignToLocalController),
+ t3 = A._instanceType(localToForeignController),
+ t4 = $T._eval$1("StreamChannel<0>");
+ t1.set$__StreamChannelController__local_F(t4._as(A.GuaranteeChannel$(new A._ControllerStream(foreignToLocalController, t2._eval$1("_ControllerStream<1>")), new A._StreamSinkWrapper(localToForeignController, t3._eval$1("_StreamSinkWrapper<1>")), true, $T)));
+ t2 = t4._as(A.GuaranteeChannel$(new A._ControllerStream(localToForeignController, t3._eval$1("_ControllerStream<1>")), new A._StreamSinkWrapper(foreignToLocalController, t2._eval$1("_StreamSinkWrapper<1>")), true, $T));
+ t1.__StreamChannelController__foreign_F !== $ && A.throwLateFieldAI("_foreign");
+ t1.set$__StreamChannelController__foreign_F(t2);
+ return t1;
+ },
+ StreamChannelController: function StreamChannelController(t0) {
+ this.__StreamChannelController__foreign_F = this.__StreamChannelController__local_F = $;
+ this.$ti = t0;
+ },
+ StreamChannelMixin: function StreamChannelMixin() {
+ },
+ EventTargetExtension_addEventListener(_this, type, listener) {
+ var t1 = A._setArrayType([type, listener], type$.JSArray_Object);
+ A.callMethod(_this, "addEventListener", t1, type$.dynamic);
+ },
+ EventTargetExtension_removeEventListener(_this, type, listener) {
+ var t1 = A._setArrayType([type, listener], type$.JSArray_Object);
+ A.callMethod(_this, "removeEventListener", t1, type$.dynamic);
+ },
+ MessagePortExtension_get_postMessage(_this) {
+ return new A.MessagePortExtension_get_postMessage_closure(_this);
+ },
+ _callConstructor(constructorName, args) {
+ var $constructor = self.window[constructorName];
+ if ($constructor == null)
+ return null;
+ return A.callConstructor($constructor, args, type$.nullable_Object);
+ },
+ Subscription$(target, type, listener) {
+ A.EventTargetExtension_addEventListener(target, type, listener);
+ return new A.Subscription(type, target, listener);
+ },
+ MessagePortExtension_get_postMessage_closure: function MessagePortExtension_get_postMessage_closure(t0) {
+ this._this = t0;
+ },
+ Subscription: function Subscription(t0, t1, t2) {
+ this.type = t0;
+ this.target = t1;
+ this.listener = t2;
+ },
+ main() {
+ var t1 = type$.JavaScriptObject;
+ t1._as(self.window.console).log("Dart test runner browser host running");
+ if (J.$eq$($.$get$_currentUrl().get$queryParameters().$index(0, "debug"), "true"))
+ t1._as(type$.nullable_JavaScriptObject._as(self.document.body).classList).add("debug");
+ A.runZonedGuarded(new A.main_closure(), new A.main_closure0(), type$.Null);
+ },
+ _connectToServer() {
+ var t2, controller, t3,
+ t1 = $.$get$_currentUrl().get$queryParameters().$index(0, "managerUrl");
+ t1.toString;
+ t1 = A._callConstructor("WebSocket", A._setArrayType([t1], type$.JSArray_Object));
+ t1.toString;
+ type$.JavaScriptObject._as(t1);
+ t2 = type$.dynamic;
+ controller = A.StreamChannelController$(true, t2);
+ A.EventTargetExtension_addEventListener(t1, "message", A.allowInterop(new A._connectToServer_closure(controller), type$.void_Function_JavaScriptObject));
+ t3 = controller.__StreamChannelController__local_F;
+ t3 === $ && A.throwLateFieldNI("_local");
+ t3 = t3.__GuaranteeChannel__streamController_F;
+ t3 === $ && A.throwLateFieldNI("_streamController");
+ new A._ControllerStream(t3, A._instanceType(t3)._eval$1("_ControllerStream<1>")).listen$1(new A._connectToServer_closure0(t1));
+ t1 = controller.__StreamChannelController__foreign_F;
+ t1 === $ && A.throwLateFieldNI("_foreign");
+ return A._MultiChannel$(t1, t2);
+ },
+ _connectToIframe(url, id) {
+ var t2, t3, t4, iframe, controller, windowSubscription,
+ suiteUrl = A.Uri_parse(url).removeFragment$0(),
+ t1 = type$.JavaScriptObject;
+ t1._as(self.window.console).log("Starting suite " + suiteUrl.toString$0(0));
+ t2 = self.document;
+ t3 = A._setArrayType(["iframe"], type$.JSArray_Object);
+ t4 = type$.dynamic;
+ iframe = t1._as(A.callMethod(t2, "createElement", t3, t4));
+ $._iframes.$indexSet(0, id, iframe);
+ controller = A.StreamChannelController$(true, t4);
+ windowSubscription = A._Cell$named("windowSubscription");
+ windowSubscription._value = A.Subscription$(self.window, "message", A.allowInterop(new A._connectToIframe_closure(iframe, windowSubscription, suiteUrl, id, controller), type$.void_Function_JavaScriptObject));
+ iframe.src = url;
+ t1._as(type$.nullable_JavaScriptObject._as(self.document.body).appendChild(iframe));
+ t1 = controller.__StreamChannelController__foreign_F;
+ t1 === $ && A.throwLateFieldNI("_foreign");
+ return t1;
+ },
+ main_closure: function main_closure() {
+ },
+ main__closure: function main__closure(t0) {
+ this.serverChannel = t0;
+ },
+ main___closure: function main___closure(t0) {
+ this._0_0 = t0;
+ },
+ main___closure0: function main___closure0(t0) {
+ this._0_0 = t0;
+ },
+ main___closure1: function main___closure1(t0) {
+ this._0_0 = t0;
+ },
+ main___closure2: function main___closure2(t0) {
+ this._0_0 = t0;
+ },
+ main___closure3: function main___closure3(t0) {
+ this._0_0 = t0;
+ },
+ main___closure4: function main___closure4(t0) {
+ this._0_0 = t0;
+ },
+ main__closure0: function main__closure0(t0) {
+ this.serverChannel = t0;
+ },
+ main__closure1: function main__closure1(t0) {
+ this.serverChannel = t0;
+ },
+ main__closure2: function main__closure2(t0) {
+ this.serverChannel = t0;
+ },
+ main__closure3: function main__closure3(t0) {
+ this.serverChannel = t0;
+ },
+ main_closure0: function main_closure0() {
+ },
+ _connectToServer_closure: function _connectToServer_closure(t0) {
+ this.controller = t0;
+ },
+ _connectToServer_closure0: function _connectToServer_closure0(t0) {
+ this.webSocket = t0;
+ },
+ _connectToIframe_closure: function _connectToIframe_closure(t0, t1, t2, t3, t4) {
+ var _ = this;
+ _.iframe = t0;
+ _.windowSubscription = t1;
+ _.suiteUrl = t2;
+ _.id = t3;
+ _.controller = t4;
+ },
+ _connectToIframe__closure1: function _connectToIframe__closure1(t0) {
+ this.controller = t0;
+ },
+ _connectToIframe__closure: function _connectToIframe__closure(t0) {
+ this._0_0 = t0;
+ },
+ _connectToIframe__closure0: function _connectToIframe__closure0(t0) {
+ this._0_0 = t0;
+ },
+ max(a, b, $T) {
+ A.checkTypeBound($T, type$.num, "T", "max");
+ return Math.max($T._as(a), $T._as(b));
+ },
+ printString(string) {
+ if (typeof dartPrint == "function") {
+ dartPrint(string);
+ return;
+ }
+ if (typeof console == "object" && typeof console.log != "undefined") {
+ console.log(string);
+ return;
+ }
+ if (typeof print == "function") {
+ print(string);
+ return;
+ }
+ throw "Unable to print message: " + String(string);
+ },
+ _convertNativeToDart_Value(value) {
+ var proto, t1, values, i;
+ if (value == null)
+ return value;
+ if (typeof value == "string" || typeof value == "number" || A._isBool(value))
+ return value;
+ proto = Object.getPrototypeOf(value);
+ t1 = proto === Object.prototype;
+ t1.toString;
+ if (!t1) {
+ t1 = proto === null;
+ t1.toString;
+ } else
+ t1 = true;
+ if (t1)
+ return A.convertNativeToDart_Dictionary(value);
+ t1 = Array.isArray(value);
+ t1.toString;
+ if (t1) {
+ values = [];
+ i = 0;
+ while (true) {
+ t1 = value.length;
+ t1.toString;
+ if (!(i < t1))
+ break;
+ values.push(A._convertNativeToDart_Value(value[i]));
+ ++i;
+ }
+ return values;
+ }
+ return value;
+ },
+ convertNativeToDart_Dictionary(object) {
+ var dict, keys, t1, _i, key, t2;
+ if (object == null)
+ return null;
+ dict = A.LinkedHashMap_LinkedHashMap$_empty(type$.String, type$.dynamic);
+ keys = Object.getOwnPropertyNames(object);
+ for (t1 = keys.length, _i = 0; _i < keys.length; keys.length === t1 || (0, A.throwConcurrentModificationError)(keys), ++_i) {
+ key = keys[_i];
+ t2 = key;
+ t2.toString;
+ dict.$indexSet(0, t2, A._convertNativeToDart_Value(object[key]));
+ }
+ return dict;
+ },
+ current() {
+ var exception, t1, path, lastIndex, uri = null;
+ try {
+ uri = A.Uri_base();
+ } catch (exception) {
+ if (type$.Exception._is(A.unwrapException(exception))) {
+ t1 = $._current;
+ if (t1 != null)
+ return t1;
+ throw exception;
+ } else
+ throw exception;
+ }
+ if (J.$eq$(uri, $._currentUriBase)) {
+ t1 = $._current;
+ t1.toString;
+ return t1;
+ }
+ $._currentUriBase = uri;
+ if ($.$get$Style_platform() === $.$get$Style_url())
+ t1 = $._current = uri.resolve$1(".").toString$0(0);
+ else {
+ path = uri.toFilePath$0();
+ lastIndex = path.length - 1;
+ t1 = $._current = lastIndex === 0 ? path : B.JSString_methods.substring$2(path, 0, lastIndex);
+ }
+ return t1;
+ },
+ isAlphabetic(char) {
+ var t1;
+ if (!(char >= 65 && char <= 90))
+ t1 = char >= 97 && char <= 122;
+ else
+ t1 = true;
+ return t1;
+ },
+ isDriveLetter(path, index) {
+ var t3,
+ t1 = path.length,
+ t2 = index + 2;
+ if (t1 < t2)
+ return false;
+ if (!(index >= 0 && index < t1))
+ return A.ioore(path, index);
+ if (!A.isAlphabetic(path.charCodeAt(index)))
+ return false;
+ t3 = index + 1;
+ if (!(t3 < t1))
+ return A.ioore(path, t3);
+ if (path.charCodeAt(t3) !== 58)
+ return false;
+ if (t1 === t2)
+ return true;
+ if (!(t2 >= 0 && t2 < t1))
+ return A.ioore(path, t2);
+ return path.charCodeAt(t2) === 47;
+ }
+ },
+ B = {};
+ var holders = [A, J, B];
+ var $ = {};
+ A.JS_CONST.prototype = {};
+ J.Interceptor.prototype = {
+ $eq(receiver, other) {
+ return receiver === other;
+ },
+ get$hashCode(receiver) {
+ return A.Primitives_objectHashCode(receiver);
+ },
+ toString$0(receiver) {
+ return "Instance of '" + A.Primitives_objectTypeName(receiver) + "'";
+ },
+ noSuchMethod$1(receiver, invocation) {
+ throw A.wrapException(A.NoSuchMethodError_NoSuchMethodError$withInvocation(receiver, type$.Invocation._as(invocation)));
+ },
+ get$runtimeType(receiver) {
+ return A.createRuntimeType(A._instanceTypeFromConstructor(this));
+ }
+ };
+ J.JSBool.prototype = {
+ toString$0(receiver) {
+ return String(receiver);
+ },
+ get$hashCode(receiver) {
+ return receiver ? 519018 : 218159;
+ },
+ get$runtimeType(receiver) {
+ return A.createRuntimeType(type$.bool);
+ },
+ $isTrustedGetRuntimeType: 1,
+ $isbool: 1
+ };
+ J.JSNull.prototype = {
+ $eq(receiver, other) {
+ return null == other;
+ },
+ toString$0(receiver) {
+ return "null";
+ },
+ get$hashCode(receiver) {
+ return 0;
+ },
+ $isTrustedGetRuntimeType: 1,
+ $isNull: 1
+ };
+ J.JavaScriptObject.prototype = {};
+ J.LegacyJavaScriptObject.prototype = {
+ get$hashCode(receiver) {
+ return 0;
+ },
+ toString$0(receiver) {
+ return String(receiver);
+ }
+ };
+ J.PlainJavaScriptObject.prototype = {};
+ J.UnknownJavaScriptObject.prototype = {};
+ J.JavaScriptFunction.prototype = {
+ toString$0(receiver) {
+ var dartClosure = receiver[$.$get$DART_CLOSURE_PROPERTY_NAME()];
+ if (dartClosure == null)
+ return this.super$LegacyJavaScriptObject$toString(receiver);
+ return "JavaScript function for " + J.toString$0$(dartClosure);
+ },
+ $isFunction: 1
+ };
+ J.JavaScriptBigInt.prototype = {
+ get$hashCode(receiver) {
+ return 0;
+ },
+ toString$0(receiver) {
+ return String(receiver);
+ }
+ };
+ J.JavaScriptSymbol.prototype = {
+ get$hashCode(receiver) {
+ return 0;
+ },
+ toString$0(receiver) {
+ return String(receiver);
+ }
+ };
+ J.JSArray.prototype = {
+ cast$1$0(receiver, $R) {
+ return new A.CastList(receiver, A._arrayInstanceType(receiver)._eval$1("@<1>")._bind$1($R)._eval$1("CastList<1,2>"));
+ },
+ add$1(receiver, value) {
+ A._arrayInstanceType(receiver)._precomputed1._as(value);
+ if (!!receiver.fixed$length)
+ A.throwExpression(A.UnsupportedError$("add"));
+ receiver.push(value);
+ },
+ removeAt$1(receiver, index) {
+ var t1;
+ if (!!receiver.fixed$length)
+ A.throwExpression(A.UnsupportedError$("removeAt"));
+ t1 = receiver.length;
+ if (index >= t1)
+ throw A.wrapException(A.RangeError$value(index, null));
+ return receiver.splice(index, 1)[0];
+ },
+ insert$2(receiver, index, value) {
+ var t1;
+ A._arrayInstanceType(receiver)._precomputed1._as(value);
+ if (!!receiver.fixed$length)
+ A.throwExpression(A.UnsupportedError$("insert"));
+ t1 = receiver.length;
+ if (index > t1)
+ throw A.wrapException(A.RangeError$value(index, null));
+ receiver.splice(index, 0, value);
+ },
+ insertAll$2(receiver, index, iterable) {
+ var insertionLength, end;
+ A._arrayInstanceType(receiver)._eval$1("Iterable<1>")._as(iterable);
+ if (!!receiver.fixed$length)
+ A.throwExpression(A.UnsupportedError$("insertAll"));
+ A.RangeError_checkValueInInterval(index, 0, receiver.length, "index");
+ if (!type$.EfficientLengthIterable_dynamic._is(iterable))
+ iterable = J.toList$0$ax(iterable);
+ insertionLength = J.get$length$asx(iterable);
+ receiver.length = receiver.length + insertionLength;
+ end = index + insertionLength;
+ this.setRange$4(receiver, end, receiver.length, receiver, index);
+ this.setRange$3(receiver, index, end, iterable);
+ },
+ removeLast$0(receiver) {
+ if (!!receiver.fixed$length)
+ A.throwExpression(A.UnsupportedError$("removeLast"));
+ if (receiver.length === 0)
+ throw A.wrapException(A.diagnoseIndexError(receiver, -1));
+ return receiver.pop();
+ },
+ addAll$1(receiver, collection) {
+ var t1;
+ A._arrayInstanceType(receiver)._eval$1("Iterable<1>")._as(collection);
+ if (!!receiver.fixed$length)
+ A.throwExpression(A.UnsupportedError$("addAll"));
+ if (Array.isArray(collection)) {
+ this._addAllFromArray$1(receiver, collection);
+ return;
+ }
+ for (t1 = J.get$iterator$ax(collection); t1.moveNext$0();)
+ receiver.push(t1.get$current(t1));
+ },
+ _addAllFromArray$1(receiver, array) {
+ var len, i;
+ type$.JSArray_dynamic._as(array);
+ len = array.length;
+ if (len === 0)
+ return;
+ if (receiver === array)
+ throw A.wrapException(A.ConcurrentModificationError$(receiver));
+ for (i = 0; i < len; ++i)
+ receiver.push(array[i]);
+ },
+ clear$0(receiver) {
+ if (!!receiver.fixed$length)
+ A.throwExpression(A.UnsupportedError$("clear"));
+ receiver.length = 0;
+ },
+ map$1$1(receiver, f, $T) {
+ var t1 = A._arrayInstanceType(receiver);
+ return new A.MappedListIterable(receiver, t1._bind$1($T)._eval$1("1(2)")._as(f), t1._eval$1("@<1>")._bind$1($T)._eval$1("MappedListIterable<1,2>"));
+ },
+ join$1(receiver, separator) {
+ var i,
+ list = A.List_List$filled(receiver.length, "", false, type$.String);
+ for (i = 0; i < receiver.length; ++i)
+ this.$indexSet(list, i, A.S(receiver[i]));
+ return list.join(separator);
+ },
+ join$0($receiver) {
+ return this.join$1($receiver, "");
+ },
+ skip$1(receiver, n) {
+ return A.SubListIterable$(receiver, n, null, A._arrayInstanceType(receiver)._precomputed1);
+ },
+ fold$1$2(receiver, initialValue, combine, $T) {
+ var $length, value, i;
+ $T._as(initialValue);
+ A._arrayInstanceType(receiver)._bind$1($T)._eval$1("1(1,2)")._as(combine);
+ $length = receiver.length;
+ for (value = initialValue, i = 0; i < $length; ++i) {
+ value = combine.call$2(value, receiver[i]);
+ if (receiver.length !== $length)
+ throw A.wrapException(A.ConcurrentModificationError$(receiver));
+ }
+ return value;
+ },
+ elementAt$1(receiver, index) {
+ if (!(index >= 0 && index < receiver.length))
+ return A.ioore(receiver, index);
+ return receiver[index];
+ },
+ get$first(receiver) {
+ if (receiver.length > 0)
+ return receiver[0];
+ throw A.wrapException(A.IterableElementError_noElement());
+ },
+ get$last(receiver) {
+ var t1 = receiver.length;
+ if (t1 > 0)
+ return receiver[t1 - 1];
+ throw A.wrapException(A.IterableElementError_noElement());
+ },
+ setRange$4(receiver, start, end, iterable, skipCount) {
+ var $length, otherList, otherStart, t1, i;
+ A._arrayInstanceType(receiver)._eval$1("Iterable<1>")._as(iterable);
+ if (!!receiver.immutable$list)
+ A.throwExpression(A.UnsupportedError$("setRange"));
+ A.RangeError_checkValidRange(start, end, receiver.length);
+ $length = end - start;
+ if ($length === 0)
+ return;
+ A.RangeError_checkNotNegative(skipCount, "skipCount");
+ if (type$.List_dynamic._is(iterable)) {
+ otherList = iterable;
+ otherStart = skipCount;
+ } else {
+ otherList = J.skip$1$ax(iterable, skipCount).toList$1$growable(0, false);
+ otherStart = 0;
+ }
+ t1 = J.getInterceptor$asx(otherList);
+ if (otherStart + $length > t1.get$length(otherList))
+ throw A.wrapException(A.IterableElementError_tooFew());
+ if (otherStart < start)
+ for (i = $length - 1; i >= 0; --i)
+ receiver[start + i] = t1.$index(otherList, otherStart + i);
+ else
+ for (i = 0; i < $length; ++i)
+ receiver[start + i] = t1.$index(otherList, otherStart + i);
+ },
+ setRange$3($receiver, start, end, iterable) {
+ return this.setRange$4($receiver, start, end, iterable, 0);
+ },
+ contains$1(receiver, other) {
+ var i;
+ for (i = 0; i < receiver.length; ++i)
+ if (J.$eq$(receiver[i], other))
+ return true;
+ return false;
+ },
+ get$isEmpty(receiver) {
+ return receiver.length === 0;
+ },
+ get$isNotEmpty(receiver) {
+ return receiver.length !== 0;
+ },
+ toString$0(receiver) {
+ return A.Iterable_iterableToFullString(receiver, "[", "]");
+ },
+ toList$1$growable(receiver, growable) {
+ var t1 = A._setArrayType(receiver.slice(0), A._arrayInstanceType(receiver));
+ return t1;
+ },
+ toList$0($receiver) {
+ return this.toList$1$growable($receiver, true);
+ },
+ get$iterator(receiver) {
+ return new J.ArrayIterator(receiver, receiver.length, A._arrayInstanceType(receiver)._eval$1("ArrayIterator<1>"));
+ },
+ get$hashCode(receiver) {
+ return A.Primitives_objectHashCode(receiver);
+ },
+ get$length(receiver) {
+ return receiver.length;
+ },
+ $index(receiver, index) {
+ if (!(index >= 0 && index < receiver.length))
+ throw A.wrapException(A.diagnoseIndexError(receiver, index));
+ return receiver[index];
+ },
+ $indexSet(receiver, index, value) {
+ A._arrayInstanceType(receiver)._precomputed1._as(value);
+ if (!!receiver.immutable$list)
+ A.throwExpression(A.UnsupportedError$("indexed set"));
+ if (!(index >= 0 && index < receiver.length))
+ throw A.wrapException(A.diagnoseIndexError(receiver, index));
+ receiver[index] = value;
+ },
+ $isEfficientLengthIterable: 1,
+ $isIterable: 1,
+ $isList: 1
+ };
+ J.JSUnmodifiableArray.prototype = {};
+ J.ArrayIterator.prototype = {
+ get$current(_) {
+ var t1 = this._current;
+ return t1 == null ? this.$ti._precomputed1._as(t1) : t1;
+ },
+ moveNext$0() {
+ var t2, _this = this,
+ t1 = _this._iterable,
+ $length = t1.length;
+ if (_this.__interceptors$_length !== $length) {
+ t1 = A.throwConcurrentModificationError(t1);
+ throw A.wrapException(t1);
+ }
+ t2 = _this._index;
+ if (t2 >= $length) {
+ _this.set$_current(null);
+ return false;
+ }
+ _this.set$_current(t1[t2]);
+ ++_this._index;
+ return true;
+ },
+ set$_current(_current) {
+ this._current = this.$ti._eval$1("1?")._as(_current);
+ },
+ $isIterator: 1
+ };
+ J.JSNumber.prototype = {
+ toInt$0(receiver) {
+ var t1;
+ if (receiver >= -2147483648 && receiver <= 2147483647)
+ return receiver | 0;
+ if (isFinite(receiver)) {
+ t1 = receiver < 0 ? Math.ceil(receiver) : Math.floor(receiver);
+ return t1 + 0;
+ }
+ throw A.wrapException(A.UnsupportedError$("" + receiver + ".toInt()"));
+ },
+ toString$0(receiver) {
+ if (receiver === 0 && 1 / receiver < 0)
+ return "-0.0";
+ else
+ return "" + receiver;
+ },
+ get$hashCode(receiver) {
+ var absolute, floorLog2, factor, scaled,
+ intValue = receiver | 0;
+ if (receiver === intValue)
+ return intValue & 536870911;
+ absolute = Math.abs(receiver);
+ floorLog2 = Math.log(absolute) / 0.6931471805599453 | 0;
+ factor = Math.pow(2, floorLog2);
+ scaled = absolute < 1 ? absolute / factor : factor / absolute;
+ return ((scaled * 9007199254740992 | 0) + (scaled * 3542243181176521 | 0)) * 599197 + floorLog2 * 1259 & 536870911;
+ },
+ $mod(receiver, other) {
+ var result = receiver % other;
+ if (result === 0)
+ return 0;
+ if (result > 0)
+ return result;
+ return result + other;
+ },
+ $tdiv(receiver, other) {
+ if ((receiver | 0) === receiver)
+ if (other >= 1 || false)
+ return receiver / other | 0;
+ return this._tdivSlow$1(receiver, other);
+ },
+ _tdivFast$1(receiver, other) {
+ return (receiver | 0) === receiver ? receiver / other | 0 : this._tdivSlow$1(receiver, other);
+ },
+ _tdivSlow$1(receiver, other) {
+ var quotient = receiver / other;
+ if (quotient >= -2147483648 && quotient <= 2147483647)
+ return quotient | 0;
+ if (quotient > 0) {
+ if (quotient !== 1 / 0)
+ return Math.floor(quotient);
+ } else if (quotient > -1 / 0)
+ return Math.ceil(quotient);
+ throw A.wrapException(A.UnsupportedError$("Result of truncating division is " + A.S(quotient) + ": " + A.S(receiver) + " ~/ " + other));
+ },
+ _shrOtherPositive$1(receiver, other) {
+ var t1;
+ if (receiver > 0)
+ t1 = this._shrBothPositive$1(receiver, other);
+ else {
+ t1 = other > 31 ? 31 : other;
+ t1 = receiver >> t1 >>> 0;
+ }
+ return t1;
+ },
+ _shrReceiverPositive$1(receiver, other) {
+ if (0 > other)
+ throw A.wrapException(A.argumentErrorValue(other));
+ return this._shrBothPositive$1(receiver, other);
+ },
+ _shrBothPositive$1(receiver, other) {
+ return other > 31 ? 0 : receiver >>> other;
+ },
+ get$runtimeType(receiver) {
+ return A.createRuntimeType(type$.num);
+ },
+ $isdouble: 1,
+ $isnum: 1
+ };
+ J.JSInt.prototype = {
+ get$runtimeType(receiver) {
+ return A.createRuntimeType(type$.int);
+ },
+ $isTrustedGetRuntimeType: 1,
+ $isint: 1
+ };
+ J.JSNumNotInt.prototype = {
+ get$runtimeType(receiver) {
+ return A.createRuntimeType(type$.double);
+ },
+ $isTrustedGetRuntimeType: 1
+ };
+ J.JSString.prototype = {
+ codeUnitAt$1(receiver, index) {
+ if (index < 0)
+ throw A.wrapException(A.diagnoseIndexError(receiver, index));
+ if (index >= receiver.length)
+ A.throwExpression(A.diagnoseIndexError(receiver, index));
+ return receiver.charCodeAt(index);
+ },
+ allMatches$2(receiver, string, start) {
+ var t1 = string.length;
+ if (start > t1)
+ throw A.wrapException(A.RangeError$range(start, 0, t1, null, null));
+ return new A._StringAllMatchesIterable(string, receiver, start);
+ },
+ allMatches$1($receiver, string) {
+ return this.allMatches$2($receiver, string, 0);
+ },
+ matchAsPrefix$2(receiver, string, start) {
+ var t1, t2, i, t3, _null = null;
+ if (start < 0 || start > string.length)
+ throw A.wrapException(A.RangeError$range(start, 0, string.length, _null, _null));
+ t1 = receiver.length;
+ t2 = string.length;
+ if (start + t1 > t2)
+ return _null;
+ for (i = 0; i < t1; ++i) {
+ t3 = start + i;
+ if (!(t3 >= 0 && t3 < t2))
+ return A.ioore(string, t3);
+ if (string.charCodeAt(t3) !== receiver.charCodeAt(i))
+ return _null;
+ }
+ return new A.StringMatch(start, receiver);
+ },
+ $add(receiver, other) {
+ return receiver + other;
+ },
+ endsWith$1(receiver, other) {
+ var otherLength = other.length,
+ t1 = receiver.length;
+ if (otherLength > t1)
+ return false;
+ return other === this.substring$1(receiver, t1 - otherLength);
+ },
+ replaceFirst$2(receiver, from, to) {
+ A.RangeError_checkValueInInterval(0, 0, receiver.length, "startIndex");
+ return A.stringReplaceFirstUnchecked(receiver, from, to, 0);
+ },
+ split$1(receiver, pattern) {
+ if (typeof pattern == "string")
+ return A._setArrayType(receiver.split(pattern), type$.JSArray_String);
+ else if (pattern instanceof A.JSSyntaxRegExp && pattern.get$_nativeAnchoredVersion().exec("").length - 2 === 0)
+ return A._setArrayType(receiver.split(pattern._nativeRegExp), type$.JSArray_String);
+ else
+ return this._defaultSplit$1(receiver, pattern);
+ },
+ replaceRange$3(receiver, start, end, replacement) {
+ var e = A.RangeError_checkValidRange(start, end, receiver.length);
+ return A.stringReplaceRangeUnchecked(receiver, start, e, replacement);
+ },
+ _defaultSplit$1(receiver, pattern) {
+ var t1, start, $length, match, matchStart, matchEnd,
+ result = A._setArrayType([], type$.JSArray_String);
+ for (t1 = J.allMatches$1$s(pattern, receiver), t1 = t1.get$iterator(t1), start = 0, $length = 1; t1.moveNext$0();) {
+ match = t1.get$current(t1);
+ matchStart = match.get$start(match);
+ matchEnd = match.get$end(match);
+ $length = matchEnd - matchStart;
+ if ($length === 0 && start === matchStart)
+ continue;
+ B.JSArray_methods.add$1(result, this.substring$2(receiver, start, matchStart));
+ start = matchEnd;
+ }
+ if (start < receiver.length || $length > 0)
+ B.JSArray_methods.add$1(result, this.substring$1(receiver, start));
+ return result;
+ },
+ startsWith$2(receiver, pattern, index) {
+ var endIndex;
+ if (index < 0 || index > receiver.length)
+ throw A.wrapException(A.RangeError$range(index, 0, receiver.length, null, null));
+ if (typeof pattern == "string") {
+ endIndex = index + pattern.length;
+ if (endIndex > receiver.length)
+ return false;
+ return pattern === receiver.substring(index, endIndex);
+ }
+ return J.matchAsPrefix$2$s(pattern, receiver, index) != null;
+ },
+ startsWith$1($receiver, pattern) {
+ return this.startsWith$2($receiver, pattern, 0);
+ },
+ substring$2(receiver, start, end) {
+ return receiver.substring(start, A.RangeError_checkValidRange(start, end, receiver.length));
+ },
+ substring$1($receiver, start) {
+ return this.substring$2($receiver, start, null);
+ },
+ trim$0(receiver) {
+ var startIndex, t1, endIndex0,
+ result = receiver.trim(),
+ endIndex = result.length;
+ if (endIndex === 0)
+ return result;
+ if (0 >= endIndex)
+ return A.ioore(result, 0);
+ if (result.charCodeAt(0) === 133) {
+ startIndex = J.JSString__skipLeadingWhitespace(result, 1);
+ if (startIndex === endIndex)
+ return "";
+ } else
+ startIndex = 0;
+ t1 = endIndex - 1;
+ if (!(t1 >= 0))
+ return A.ioore(result, t1);
+ endIndex0 = result.charCodeAt(t1) === 133 ? J.JSString__skipTrailingWhitespace(result, t1) : endIndex;
+ if (startIndex === 0 && endIndex0 === endIndex)
+ return result;
+ return result.substring(startIndex, endIndex0);
+ },
+ $mul(receiver, times) {
+ var s, result;
+ if (0 >= times)
+ return "";
+ if (times === 1 || receiver.length === 0)
+ return receiver;
+ if (times !== times >>> 0)
+ throw A.wrapException(B.C_OutOfMemoryError);
+ for (s = receiver, result = ""; true;) {
+ if ((times & 1) === 1)
+ result = s + result;
+ times = times >>> 1;
+ if (times === 0)
+ break;
+ s += s;
+ }
+ return result;
+ },
+ padLeft$2(receiver, width, padding) {
+ var delta = width - receiver.length;
+ if (delta <= 0)
+ return receiver;
+ return this.$mul(padding, delta) + receiver;
+ },
+ padRight$1(receiver, width) {
+ var delta = width - receiver.length;
+ if (delta <= 0)
+ return receiver;
+ return receiver + this.$mul(" ", delta);
+ },
+ indexOf$2(receiver, pattern, start) {
+ var t1;
+ if (start < 0 || start > receiver.length)
+ throw A.wrapException(A.RangeError$range(start, 0, receiver.length, null, null));
+ t1 = receiver.indexOf(pattern, start);
+ return t1;
+ },
+ indexOf$1($receiver, pattern) {
+ return this.indexOf$2($receiver, pattern, 0);
+ },
+ lastIndexOf$2(receiver, pattern, start) {
+ var t1, t2;
+ if (start == null)
+ start = receiver.length;
+ else if (start < 0 || start > receiver.length)
+ throw A.wrapException(A.RangeError$range(start, 0, receiver.length, null, null));
+ t1 = pattern.length;
+ t2 = receiver.length;
+ if (start + t1 > t2)
+ start = t2 - t1;
+ return receiver.lastIndexOf(pattern, start);
+ },
+ lastIndexOf$1($receiver, pattern) {
+ return this.lastIndexOf$2($receiver, pattern, null);
+ },
+ contains$1(receiver, other) {
+ return A.stringContainsUnchecked(receiver, other, 0);
+ },
+ toString$0(receiver) {
+ return receiver;
+ },
+ get$hashCode(receiver) {
+ var t1, hash, i;
+ for (t1 = receiver.length, hash = 0, i = 0; i < t1; ++i) {
+ hash = hash + receiver.charCodeAt(i) & 536870911;
+ hash = hash + ((hash & 524287) << 10) & 536870911;
+ hash ^= hash >> 6;
+ }
+ hash = hash + ((hash & 67108863) << 3) & 536870911;
+ hash ^= hash >> 11;
+ return hash + ((hash & 16383) << 15) & 536870911;
+ },
+ get$runtimeType(receiver) {
+ return A.createRuntimeType(type$.String);
+ },
+ get$length(receiver) {
+ return receiver.length;
+ },
+ $isTrustedGetRuntimeType: 1,
+ $isPattern: 1,
+ $isString: 1
+ };
+ A.CastStream.prototype = {
+ listen$4$cancelOnError$onDone$onError(onData, cancelOnError, onDone, onError) {
+ var t2,
+ t1 = this.$ti;
+ t1._eval$1("~(2)?")._as(onData);
+ t2 = this._source.listen$3$cancelOnError$onDone(null, cancelOnError, type$.nullable_void_Function._as(onDone));
+ t1 = new A.CastStreamSubscription(t2, $.Zone__current, t1._eval$1("@<1>")._bind$1(t1._rest[1])._eval$1("CastStreamSubscription<1,2>"));
+ t2.onData$1(t1.get$__internal$_onData());
+ t1.onData$1(onData);
+ t1.onError$1(0, onError);
+ return t1;
+ },
+ listen$1(onData) {
+ return this.listen$4$cancelOnError$onDone$onError(onData, null, null, null);
+ },
+ listen$3$onDone$onError(onData, onDone, onError) {
+ return this.listen$4$cancelOnError$onDone$onError(onData, null, onDone, onError);
+ },
+ listen$3$cancelOnError$onDone(onData, cancelOnError, onDone) {
+ return this.listen$4$cancelOnError$onDone$onError(onData, cancelOnError, onDone, null);
+ }
+ };
+ A.CastStreamSubscription.prototype = {
+ cancel$0(_) {
+ return this._source.cancel$0(0);
+ },
+ onData$1(handleData) {
+ var t1 = this.$ti;
+ t1._eval$1("~(2)?")._as(handleData);
+ this.set$_handleData(handleData == null ? null : this.__internal$_zone.registerUnaryCallback$2$1(handleData, type$.dynamic, t1._rest[1]));
+ },
+ onError$1(_, handleError) {
+ var _this = this;
+ _this._source.onError$1(0, handleError);
+ if (handleError == null)
+ _this._handleError = null;
+ else if (type$.void_Function_Object_StackTrace._is(handleError))
+ _this._handleError = _this.__internal$_zone.registerBinaryCallback$3$1(handleError, type$.dynamic, type$.Object, type$.StackTrace);
+ else if (type$.void_Function_Object._is(handleError))
+ _this._handleError = _this.__internal$_zone.registerUnaryCallback$2$1(handleError, type$.dynamic, type$.Object);
+ else
+ throw A.wrapException(A.ArgumentError$(string$.handle, null));
+ },
+ __internal$_onData$1(data) {
+ var targetData, error, stack, handleError, t2, exception, _this = this,
+ t1 = _this.$ti;
+ t1._precomputed1._as(data);
+ t2 = _this._handleData;
+ if (t2 == null)
+ return;
+ targetData = null;
+ try {
+ targetData = t1._rest[1]._as(data);
+ } catch (exception) {
+ error = A.unwrapException(exception);
+ stack = A.getTraceFromException(exception);
+ handleError = _this._handleError;
+ if (handleError == null)
+ _this.__internal$_zone.handleUncaughtError$2(error, stack);
+ else {
+ t1 = type$.Object;
+ t2 = _this.__internal$_zone;
+ if (type$.void_Function_Object_StackTrace._is(handleError))
+ t2.runBinaryGuarded$2$3(handleError, error, stack, t1, type$.StackTrace);
+ else
+ t2.runUnaryGuarded$1$2(type$.void_Function_Object._as(handleError), error, t1);
+ }
+ return;
+ }
+ _this.__internal$_zone.runUnaryGuarded$1$2(t2, targetData, t1._rest[1]);
+ },
+ set$_handleData(_handleData) {
+ this._handleData = this.$ti._eval$1("~(2)?")._as(_handleData);
+ },
+ $isStreamSubscription: 1
+ };
+ A._CastIterableBase.prototype = {
+ get$iterator(_) {
+ var t1 = A._instanceType(this);
+ return new A.CastIterator(J.get$iterator$ax(this.get$_source()), t1._eval$1("@<1>")._bind$1(t1._rest[1])._eval$1("CastIterator<1,2>"));
+ },
+ get$length(_) {
+ return J.get$length$asx(this.get$_source());
+ },
+ get$isEmpty(_) {
+ return J.get$isEmpty$asx(this.get$_source());
+ },
+ get$isNotEmpty(_) {
+ return J.get$isNotEmpty$asx(this.get$_source());
+ },
+ skip$1(_, count) {
+ var t1 = A._instanceType(this);
+ return A.CastIterable_CastIterable(J.skip$1$ax(this.get$_source(), count), t1._precomputed1, t1._rest[1]);
+ },
+ elementAt$1(_, index) {
+ return A._instanceType(this)._rest[1]._as(J.elementAt$1$ax(this.get$_source(), index));
+ },
+ toString$0(_) {
+ return J.toString$0$(this.get$_source());
+ }
+ };
+ A.CastIterator.prototype = {
+ moveNext$0() {
+ return this._source.moveNext$0();
+ },
+ get$current(_) {
+ var t1 = this._source;
+ return this.$ti._rest[1]._as(t1.get$current(t1));
+ },
+ $isIterator: 1
+ };
+ A.CastIterable.prototype = {
+ get$_source() {
+ return this._source;
+ }
+ };
+ A._EfficientLengthCastIterable.prototype = {$isEfficientLengthIterable: 1};
+ A._CastListBase.prototype = {
+ $index(_, index) {
+ return this.$ti._rest[1]._as(J.$index$asx(this._source, index));
+ },
+ $indexSet(_, index, value) {
+ var t1 = this.$ti;
+ J.$indexSet$ax(this._source, index, t1._precomputed1._as(t1._rest[1]._as(value)));
+ },
+ $isEfficientLengthIterable: 1,
+ $isList: 1
+ };
+ A.CastList.prototype = {
+ cast$1$0(_, $R) {
+ return new A.CastList(this._source, this.$ti._eval$1("@<1>")._bind$1($R)._eval$1("CastList<1,2>"));
+ },
+ get$_source() {
+ return this._source;
+ }
+ };
+ A.LateError.prototype = {
+ toString$0(_) {
+ return "LateInitializationError: " + this._message;
+ }
+ };
+ A.CodeUnits.prototype = {
+ get$length(_) {
+ return this._string.length;
+ },
+ $index(_, i) {
+ var t1 = this._string;
+ if (!(i >= 0 && i < t1.length))
+ return A.ioore(t1, i);
+ return t1.charCodeAt(i);
+ }
+ };
+ A.nullFuture_closure.prototype = {
+ call$0() {
+ return A.Future_Future$value(null, type$.Null);
+ },
+ $signature: 60
+ };
+ A.SentinelValue.prototype = {};
+ A.EfficientLengthIterable.prototype = {};
+ A.ListIterable.prototype = {
+ get$iterator(_) {
+ var _this = this;
+ return new A.ListIterator(_this, _this.get$length(_this), A._instanceType(_this)._eval$1("ListIterator<ListIterable.E>"));
+ },
+ get$isEmpty(_) {
+ return this.get$length(this) === 0;
+ },
+ join$1(_, separator) {
+ var first, t1, i, _this = this,
+ $length = _this.get$length(_this);
+ if (separator.length !== 0) {
+ if ($length === 0)
+ return "";
+ first = A.S(_this.elementAt$1(0, 0));
+ if ($length !== _this.get$length(_this))
+ throw A.wrapException(A.ConcurrentModificationError$(_this));
+ for (t1 = first, i = 1; i < $length; ++i) {
+ t1 = t1 + separator + A.S(_this.elementAt$1(0, i));
+ if ($length !== _this.get$length(_this))
+ throw A.wrapException(A.ConcurrentModificationError$(_this));
+ }
+ return t1.charCodeAt(0) == 0 ? t1 : t1;
+ } else {
+ for (i = 0, t1 = ""; i < $length; ++i) {
+ t1 += A.S(_this.elementAt$1(0, i));
+ if ($length !== _this.get$length(_this))
+ throw A.wrapException(A.ConcurrentModificationError$(_this));
+ }
+ return t1.charCodeAt(0) == 0 ? t1 : t1;
+ }
+ },
+ join$0($receiver) {
+ return this.join$1($receiver, "");
+ },
+ map$1$1(_, toElement, $T) {
+ var t1 = A._instanceType(this);
+ return new A.MappedListIterable(this, t1._bind$1($T)._eval$1("1(ListIterable.E)")._as(toElement), t1._eval$1("@<ListIterable.E>")._bind$1($T)._eval$1("MappedListIterable<1,2>"));
+ },
+ fold$1$2(_, initialValue, combine, $T) {
+ var $length, value, i, _this = this;
+ $T._as(initialValue);
+ A._instanceType(_this)._bind$1($T)._eval$1("1(1,ListIterable.E)")._as(combine);
+ $length = _this.get$length(_this);
+ for (value = initialValue, i = 0; i < $length; ++i) {
+ value = combine.call$2(value, _this.elementAt$1(0, i));
+ if ($length !== _this.get$length(_this))
+ throw A.wrapException(A.ConcurrentModificationError$(_this));
+ }
+ return value;
+ },
+ skip$1(_, count) {
+ return A.SubListIterable$(this, count, null, A._instanceType(this)._eval$1("ListIterable.E"));
+ }
+ };
+ A.SubListIterable.prototype = {
+ SubListIterable$3(_iterable, _start, _endOrLength, $E) {
+ var endOrLength,
+ t1 = this._start;
+ A.RangeError_checkNotNegative(t1, "start");
+ endOrLength = this._endOrLength;
+ if (endOrLength != null) {
+ A.RangeError_checkNotNegative(endOrLength, "end");
+ if (t1 > endOrLength)
+ throw A.wrapException(A.RangeError$range(t1, 0, endOrLength, "start", null));
+ }
+ },
+ get$_endIndex() {
+ var $length = J.get$length$asx(this.__internal$_iterable),
+ endOrLength = this._endOrLength;
+ if (endOrLength == null || endOrLength > $length)
+ return $length;
+ return endOrLength;
+ },
+ get$_startIndex() {
+ var $length = J.get$length$asx(this.__internal$_iterable),
+ t1 = this._start;
+ if (t1 > $length)
+ return $length;
+ return t1;
+ },
+ get$length(_) {
+ var endOrLength,
+ $length = J.get$length$asx(this.__internal$_iterable),
+ t1 = this._start;
+ if (t1 >= $length)
+ return 0;
+ endOrLength = this._endOrLength;
+ if (endOrLength == null || endOrLength >= $length)
+ return $length - t1;
+ if (typeof endOrLength !== "number")
+ return endOrLength.$sub();
+ return endOrLength - t1;
+ },
+ elementAt$1(_, index) {
+ var _this = this,
+ realIndex = _this.get$_startIndex() + index;
+ if (index < 0 || realIndex >= _this.get$_endIndex())
+ throw A.wrapException(A.IndexError$withLength(index, _this.get$length(_this), _this, "index"));
+ return J.elementAt$1$ax(_this.__internal$_iterable, realIndex);
+ },
+ skip$1(_, count) {
+ var newStart, endOrLength, _this = this;
+ A.RangeError_checkNotNegative(count, "count");
+ newStart = _this._start + count;
+ endOrLength = _this._endOrLength;
+ if (endOrLength != null && newStart >= endOrLength)
+ return new A.EmptyIterable(_this.$ti._eval$1("EmptyIterable<1>"));
+ return A.SubListIterable$(_this.__internal$_iterable, newStart, endOrLength, _this.$ti._precomputed1);
+ },
+ toList$1$growable(_, growable) {
+ var $length, result, i, _this = this,
+ start = _this._start,
+ t1 = _this.__internal$_iterable,
+ t2 = J.getInterceptor$asx(t1),
+ end = t2.get$length(t1),
+ endOrLength = _this._endOrLength;
+ if (endOrLength != null && endOrLength < end)
+ end = endOrLength;
+ $length = end - start;
+ if ($length <= 0) {
+ t1 = J.JSArray_JSArray$fixed(0, _this.$ti._precomputed1);
+ return t1;
+ }
+ result = A.List_List$filled($length, t2.elementAt$1(t1, start), false, _this.$ti._precomputed1);
+ for (i = 1; i < $length; ++i) {
+ B.JSArray_methods.$indexSet(result, i, t2.elementAt$1(t1, start + i));
+ if (t2.get$length(t1) < end)
+ throw A.wrapException(A.ConcurrentModificationError$(_this));
+ }
+ return result;
+ }
+ };
+ A.ListIterator.prototype = {
+ get$current(_) {
+ var t1 = this.__internal$_current;
+ return t1 == null ? this.$ti._precomputed1._as(t1) : t1;
+ },
+ moveNext$0() {
+ var t3, _this = this,
+ t1 = _this.__internal$_iterable,
+ t2 = J.getInterceptor$asx(t1),
+ $length = t2.get$length(t1);
+ if (_this.__internal$_length !== $length)
+ throw A.wrapException(A.ConcurrentModificationError$(t1));
+ t3 = _this.__internal$_index;
+ if (t3 >= $length) {
+ _this.set$__internal$_current(null);
+ return false;
+ }
+ _this.set$__internal$_current(t2.elementAt$1(t1, t3));
+ ++_this.__internal$_index;
+ return true;
+ },
+ set$__internal$_current(_current) {
+ this.__internal$_current = this.$ti._eval$1("1?")._as(_current);
+ },
+ $isIterator: 1
+ };
+ A.MappedIterable.prototype = {
+ get$iterator(_) {
+ var t1 = A._instanceType(this);
+ return new A.MappedIterator(J.get$iterator$ax(this.__internal$_iterable), this._f, t1._eval$1("@<1>")._bind$1(t1._rest[1])._eval$1("MappedIterator<1,2>"));
+ },
+ get$length(_) {
+ return J.get$length$asx(this.__internal$_iterable);
+ },
+ get$isEmpty(_) {
+ return J.get$isEmpty$asx(this.__internal$_iterable);
+ },
+ elementAt$1(_, index) {
+ return this._f.call$1(J.elementAt$1$ax(this.__internal$_iterable, index));
+ }
+ };
+ A.EfficientLengthMappedIterable.prototype = {$isEfficientLengthIterable: 1};
+ A.MappedIterator.prototype = {
+ moveNext$0() {
+ var _this = this,
+ t1 = _this._iterator;
+ if (t1.moveNext$0()) {
+ _this.set$__internal$_current(_this._f.call$1(t1.get$current(t1)));
+ return true;
+ }
+ _this.set$__internal$_current(null);
+ return false;
+ },
+ get$current(_) {
+ var t1 = this.__internal$_current;
+ return t1 == null ? this.$ti._rest[1]._as(t1) : t1;
+ },
+ set$__internal$_current(_current) {
+ this.__internal$_current = this.$ti._eval$1("2?")._as(_current);
+ },
+ $isIterator: 1
+ };
+ A.MappedListIterable.prototype = {
+ get$length(_) {
+ return J.get$length$asx(this._source);
+ },
+ elementAt$1(_, index) {
+ return this._f.call$1(J.elementAt$1$ax(this._source, index));
+ }
+ };
+ A.WhereIterable.prototype = {
+ get$iterator(_) {
+ return new A.WhereIterator(J.get$iterator$ax(this.__internal$_iterable), this._f, this.$ti._eval$1("WhereIterator<1>"));
+ },
+ map$1$1(_, toElement, $T) {
+ var t1 = this.$ti;
+ return new A.MappedIterable(this, t1._bind$1($T)._eval$1("1(2)")._as(toElement), t1._eval$1("@<1>")._bind$1($T)._eval$1("MappedIterable<1,2>"));
+ }
+ };
+ A.WhereIterator.prototype = {
+ moveNext$0() {
+ var t1, t2;
+ for (t1 = this._iterator, t2 = this._f; t1.moveNext$0();)
+ if (A.boolConversionCheck(t2.call$1(t1.get$current(t1))))
+ return true;
+ return false;
+ },
+ get$current(_) {
+ var t1 = this._iterator;
+ return t1.get$current(t1);
+ },
+ $isIterator: 1
+ };
+ A.ExpandIterable.prototype = {
+ get$iterator(_) {
+ var t1 = this.$ti;
+ return new A.ExpandIterator(J.get$iterator$ax(this.__internal$_iterable), this._f, B.C_EmptyIterator, t1._eval$1("@<1>")._bind$1(t1._rest[1])._eval$1("ExpandIterator<1,2>"));
+ }
+ };
+ A.ExpandIterator.prototype = {
+ get$current(_) {
+ var t1 = this.__internal$_current;
+ return t1 == null ? this.$ti._rest[1]._as(t1) : t1;
+ },
+ moveNext$0() {
+ var t1, t2, _this = this;
+ if (_this._currentExpansion == null)
+ return false;
+ for (t1 = _this._iterator, t2 = _this._f; !_this._currentExpansion.moveNext$0();) {
+ _this.set$__internal$_current(null);
+ if (t1.moveNext$0()) {
+ _this.set$_currentExpansion(null);
+ _this.set$_currentExpansion(J.get$iterator$ax(t2.call$1(t1.get$current(t1))));
+ } else
+ return false;
+ }
+ t1 = _this._currentExpansion;
+ _this.set$__internal$_current(t1.get$current(t1));
+ return true;
+ },
+ set$_currentExpansion(_currentExpansion) {
+ this._currentExpansion = this.$ti._eval$1("Iterator<2>?")._as(_currentExpansion);
+ },
+ set$__internal$_current(_current) {
+ this.__internal$_current = this.$ti._eval$1("2?")._as(_current);
+ },
+ $isIterator: 1
+ };
+ A.TakeIterable.prototype = {
+ get$iterator(_) {
+ return new A.TakeIterator(J.get$iterator$ax(this.__internal$_iterable), this._takeCount, A._instanceType(this)._eval$1("TakeIterator<1>"));
+ }
+ };
+ A.EfficientLengthTakeIterable.prototype = {
+ get$length(_) {
+ var iterableLength = J.get$length$asx(this.__internal$_iterable),
+ t1 = this._takeCount;
+ if (iterableLength > t1)
+ return t1;
+ return iterableLength;
+ },
+ $isEfficientLengthIterable: 1
+ };
+ A.TakeIterator.prototype = {
+ moveNext$0() {
+ if (--this._remaining >= 0)
+ return this._iterator.moveNext$0();
+ this._remaining = -1;
+ return false;
+ },
+ get$current(_) {
+ var t1;
+ if (this._remaining < 0) {
+ this.$ti._precomputed1._as(null);
+ return null;
+ }
+ t1 = this._iterator;
+ return t1.get$current(t1);
+ },
+ $isIterator: 1
+ };
+ A.SkipIterable.prototype = {
+ skip$1(_, count) {
+ A.ArgumentError_checkNotNull(count, "count", type$.int);
+ A.RangeError_checkNotNegative(count, "count");
+ return new A.SkipIterable(this.__internal$_iterable, this._skipCount + count, A._instanceType(this)._eval$1("SkipIterable<1>"));
+ },
+ get$iterator(_) {
+ return new A.SkipIterator(J.get$iterator$ax(this.__internal$_iterable), this._skipCount, A._instanceType(this)._eval$1("SkipIterator<1>"));
+ }
+ };
+ A.EfficientLengthSkipIterable.prototype = {
+ get$length(_) {
+ var $length = J.get$length$asx(this.__internal$_iterable) - this._skipCount;
+ if ($length >= 0)
+ return $length;
+ return 0;
+ },
+ skip$1(_, count) {
+ A.ArgumentError_checkNotNull(count, "count", type$.int);
+ A.RangeError_checkNotNegative(count, "count");
+ return new A.EfficientLengthSkipIterable(this.__internal$_iterable, this._skipCount + count, this.$ti);
+ },
+ $isEfficientLengthIterable: 1
+ };
+ A.SkipIterator.prototype = {
+ moveNext$0() {
+ var t1, i;
+ for (t1 = this._iterator, i = 0; i < this._skipCount; ++i)
+ t1.moveNext$0();
+ this._skipCount = 0;
+ return t1.moveNext$0();
+ },
+ get$current(_) {
+ var t1 = this._iterator;
+ return t1.get$current(t1);
+ },
+ $isIterator: 1
+ };
+ A.SkipWhileIterable.prototype = {
+ get$iterator(_) {
+ return new A.SkipWhileIterator(J.get$iterator$ax(this.__internal$_iterable), this._f, this.$ti._eval$1("SkipWhileIterator<1>"));
+ }
+ };
+ A.SkipWhileIterator.prototype = {
+ moveNext$0() {
+ var t1, t2, _this = this;
+ if (!_this._hasSkipped) {
+ _this._hasSkipped = true;
+ for (t1 = _this._iterator, t2 = _this._f; t1.moveNext$0();)
+ if (!A.boolConversionCheck(t2.call$1(t1.get$current(t1))))
+ return true;
+ }
+ return _this._iterator.moveNext$0();
+ },
+ get$current(_) {
+ var t1 = this._iterator;
+ return t1.get$current(t1);
+ },
+ $isIterator: 1
+ };
+ A.EmptyIterable.prototype = {
+ get$iterator(_) {
+ return B.C_EmptyIterator;
+ },
+ get$isEmpty(_) {
+ return true;
+ },
+ get$length(_) {
+ return 0;
+ },
+ elementAt$1(_, index) {
+ throw A.wrapException(A.RangeError$range(index, 0, 0, "index", null));
+ },
+ map$1$1(_, toElement, $T) {
+ this.$ti._bind$1($T)._eval$1("1(2)")._as(toElement);
+ return new A.EmptyIterable($T._eval$1("EmptyIterable<0>"));
+ },
+ skip$1(_, count) {
+ A.RangeError_checkNotNegative(count, "count");
+ return this;
+ }
+ };
+ A.EmptyIterator.prototype = {
+ moveNext$0() {
+ return false;
+ },
+ get$current(_) {
+ throw A.wrapException(A.IterableElementError_noElement());
+ },
+ $isIterator: 1
+ };
+ A.WhereTypeIterable.prototype = {
+ get$iterator(_) {
+ return new A.WhereTypeIterator(J.get$iterator$ax(this._source), this.$ti._eval$1("WhereTypeIterator<1>"));
+ }
+ };
+ A.WhereTypeIterator.prototype = {
+ moveNext$0() {
+ var t1, t2;
+ for (t1 = this._source, t2 = this.$ti._precomputed1; t1.moveNext$0();)
+ if (t2._is(t1.get$current(t1)))
+ return true;
+ return false;
+ },
+ get$current(_) {
+ var t1 = this._source;
+ return this.$ti._precomputed1._as(t1.get$current(t1));
+ },
+ $isIterator: 1
+ };
+ A.FixedLengthListMixin.prototype = {};
+ A.UnmodifiableListMixin.prototype = {
+ $indexSet(_, index, value) {
+ A._instanceType(this)._eval$1("UnmodifiableListMixin.E")._as(value);
+ throw A.wrapException(A.UnsupportedError$("Cannot modify an unmodifiable list"));
+ }
+ };
+ A.UnmodifiableListBase.prototype = {};
+ A.ReversedListIterable.prototype = {
+ get$length(_) {
+ return J.get$length$asx(this._source);
+ },
+ elementAt$1(_, index) {
+ var t1 = this._source,
+ t2 = J.getInterceptor$asx(t1);
+ return t2.elementAt$1(t1, t2.get$length(t1) - 1 - index);
+ }
+ };
+ A.Symbol.prototype = {
+ get$hashCode(_) {
+ var hash = this._hashCode;
+ if (hash != null)
+ return hash;
+ hash = 664597 * B.JSString_methods.get$hashCode(this._name) & 536870911;
+ this._hashCode = hash;
+ return hash;
+ },
+ toString$0(_) {
+ return 'Symbol("' + this._name + '")';
+ },
+ $eq(_, other) {
+ if (other == null)
+ return false;
+ return other instanceof A.Symbol && this._name === other._name;
+ },
+ $isSymbol0: 1
+ };
+ A.__CastListBase__CastIterableBase_ListMixin.prototype = {};
+ A.ConstantMapView.prototype = {};
+ A.ConstantMap.prototype = {
+ get$isEmpty(_) {
+ return this.get$length(this) === 0;
+ },
+ toString$0(_) {
+ return A.MapBase_mapToString(this);
+ },
+ $indexSet(_, key, value) {
+ var t1 = A._instanceType(this);
+ t1._precomputed1._as(key);
+ t1._rest[1]._as(value);
+ A.ConstantMap__throwUnmodifiable();
+ },
+ $isMap: 1
+ };
+ A.ConstantStringMap.prototype = {
+ get$length(_) {
+ return this._values.length;
+ },
+ get$__js_helper$_keys() {
+ var keys = this.$keys;
+ if (keys == null) {
+ keys = Object.keys(this._jsIndex);
+ this.$keys = keys;
+ }
+ return keys;
+ },
+ containsKey$1(_, key) {
+ if (typeof key != "string")
+ return false;
+ if ("__proto__" === key)
+ return false;
+ return this._jsIndex.hasOwnProperty(key);
+ },
+ $index(_, key) {
+ if (!this.containsKey$1(0, key))
+ return null;
+ return this._values[this._jsIndex[key]];
+ },
+ forEach$1(_, f) {
+ var keys, values, t1, i;
+ this.$ti._eval$1("~(1,2)")._as(f);
+ keys = this.get$__js_helper$_keys();
+ values = this._values;
+ for (t1 = keys.length, i = 0; i < t1; ++i)
+ f.call$2(keys[i], values[i]);
+ },
+ get$keys(_) {
+ return new A._KeysOrValues(this.get$__js_helper$_keys(), this.$ti._eval$1("_KeysOrValues<1>"));
+ }
+ };
+ A._KeysOrValues.prototype = {
+ get$length(_) {
+ return this._elements.length;
+ },
+ get$isEmpty(_) {
+ return 0 === this._elements.length;
+ },
+ get$isNotEmpty(_) {
+ return 0 !== this._elements.length;
+ },
+ get$iterator(_) {
+ var t1 = this._elements;
+ return new A._KeysOrValuesOrElementsIterator(t1, t1.length, this.$ti._eval$1("_KeysOrValuesOrElementsIterator<1>"));
+ }
+ };
+ A._KeysOrValuesOrElementsIterator.prototype = {
+ get$current(_) {
+ var t1 = this.__js_helper$_current;
+ return t1 == null ? this.$ti._precomputed1._as(t1) : t1;
+ },
+ moveNext$0() {
+ var _this = this,
+ t1 = _this.__js_helper$_index;
+ if (t1 >= _this._length) {
+ _this.set$__js_helper$_current(null);
+ return false;
+ }
+ _this.set$__js_helper$_current(_this._elements[t1]);
+ ++_this.__js_helper$_index;
+ return true;
+ },
+ set$__js_helper$_current(_current) {
+ this.__js_helper$_current = this.$ti._eval$1("1?")._as(_current);
+ },
+ $isIterator: 1
+ };
+ A.Instantiation.prototype = {
+ $eq(_, other) {
+ if (other == null)
+ return false;
+ return other instanceof A.Instantiation1 && this._genericClosure.$eq(0, other._genericClosure) && A.getRuntimeTypeOfClosure(this) === A.getRuntimeTypeOfClosure(other);
+ },
+ get$hashCode(_) {
+ return A.Object_hash(this._genericClosure, A.getRuntimeTypeOfClosure(this), B.C_SentinelValue, B.C_SentinelValue);
+ },
+ toString$0(_) {
+ var t1 = B.JSArray_methods.join$1([A.createRuntimeType(this.$ti._precomputed1)], ", ");
+ return this._genericClosure.toString$0(0) + " with " + ("<" + t1 + ">");
+ }
+ };
+ A.Instantiation1.prototype = {
+ call$2(a0, a1) {
+ return this._genericClosure.call$1$2(a0, a1, this.$ti._rest[0]);
+ },
+ call$4(a0, a1, a2, a3) {
+ return this._genericClosure.call$1$4(a0, a1, a2, a3, this.$ti._rest[0]);
+ },
+ $signature() {
+ return A.instantiatedGenericFunctionType(A.closureFunctionType(this._genericClosure), this.$ti);
+ }
+ };
+ A.JSInvocationMirror.prototype = {
+ get$memberName() {
+ var t1 = this._memberName;
+ return t1;
+ },
+ get$positionalArguments() {
+ var t1, argumentCount, list, index, _this = this;
+ if (_this.__js_helper$_kind === 1)
+ return B.List_empty0;
+ t1 = _this._arguments;
+ argumentCount = t1.length - _this._namedArgumentNames.length - _this._typeArgumentCount;
+ if (argumentCount === 0)
+ return B.List_empty0;
+ list = [];
+ for (index = 0; index < argumentCount; ++index) {
+ if (!(index < t1.length))
+ return A.ioore(t1, index);
+ list.push(t1[index]);
+ }
+ return J.JSArray_markUnmodifiableList(list);
+ },
+ get$namedArguments() {
+ var t1, namedArgumentCount, t2, namedArgumentsStartIndex, map, i, t3, t4, _this = this;
+ if (_this.__js_helper$_kind !== 0)
+ return B.Map_empty0;
+ t1 = _this._namedArgumentNames;
+ namedArgumentCount = t1.length;
+ t2 = _this._arguments;
+ namedArgumentsStartIndex = t2.length - namedArgumentCount - _this._typeArgumentCount;
+ if (namedArgumentCount === 0)
+ return B.Map_empty0;
+ map = new A.JsLinkedHashMap(type$.JsLinkedHashMap_Symbol_dynamic);
+ for (i = 0; i < namedArgumentCount; ++i) {
+ if (!(i < t1.length))
+ return A.ioore(t1, i);
+ t3 = t1[i];
+ t4 = namedArgumentsStartIndex + i;
+ if (!(t4 >= 0 && t4 < t2.length))
+ return A.ioore(t2, t4);
+ map.$indexSet(0, new A.Symbol(t3), t2[t4]);
+ }
+ return new A.ConstantMapView(map, type$.ConstantMapView_Symbol_dynamic);
+ },
+ $isInvocation: 1
+ };
+ A.Primitives_functionNoSuchMethod_closure.prototype = {
+ call$2($name, argument) {
+ var t1;
+ A._asString($name);
+ t1 = this._box_0;
+ t1.names = t1.names + "$" + $name;
+ B.JSArray_methods.add$1(this.namedArgumentList, $name);
+ B.JSArray_methods.add$1(this.$arguments, argument);
+ ++t1.argumentCount;
+ },
+ $signature: 4
+ };
+ A.TypeErrorDecoder.prototype = {
+ matchTypeError$1(message) {
+ var result, t1, _this = this,
+ match = new RegExp(_this._pattern).exec(message);
+ if (match == null)
+ return null;
+ result = Object.create(null);
+ t1 = _this._arguments;
+ if (t1 !== -1)
+ result.arguments = match[t1 + 1];
+ t1 = _this._argumentsExpr;
+ if (t1 !== -1)
+ result.argumentsExpr = match[t1 + 1];
+ t1 = _this._expr;
+ if (t1 !== -1)
+ result.expr = match[t1 + 1];
+ t1 = _this._method;
+ if (t1 !== -1)
+ result.method = match[t1 + 1];
+ t1 = _this._receiver;
+ if (t1 !== -1)
+ result.receiver = match[t1 + 1];
+ return result;
+ }
+ };
+ A.NullError.prototype = {
+ toString$0(_) {
+ return "Null check operator used on a null value";
+ }
+ };
+ A.JsNoSuchMethodError.prototype = {
+ toString$0(_) {
+ var t2, _this = this,
+ _s38_ = "NoSuchMethodError: method not found: '",
+ t1 = _this._method;
+ if (t1 == null)
+ return "NoSuchMethodError: " + _this.__js_helper$_message;
+ t2 = _this._receiver;
+ if (t2 == null)
+ return _s38_ + t1 + "' (" + _this.__js_helper$_message + ")";
+ return _s38_ + t1 + "' on '" + t2 + "' (" + _this.__js_helper$_message + ")";
+ }
+ };
+ A.UnknownJsTypeError.prototype = {
+ toString$0(_) {
+ var t1 = this.__js_helper$_message;
+ return t1.length === 0 ? "Error" : "Error: " + t1;
+ }
+ };
+ A.NullThrownFromJavaScriptException.prototype = {
+ toString$0(_) {
+ return "Throw of null ('" + (this._irritant === null ? "null" : "undefined") + "' from JavaScript)";
+ },
+ $isException: 1
+ };
+ A._StackTrace.prototype = {
+ toString$0(_) {
+ var trace,
+ t1 = this._trace;
+ if (t1 != null)
+ return t1;
+ t1 = this._exception;
+ trace = t1 !== null && typeof t1 === "object" ? t1.stack : null;
+ return this._trace = trace == null ? "" : trace;
+ },
+ $isStackTrace: 1
+ };
+ A.Closure.prototype = {
+ toString$0(_) {
+ var $constructor = this.constructor,
+ $name = $constructor == null ? null : $constructor.name;
+ return "Closure '" + A.unminifyOrTag($name == null ? "unknown" : $name) + "'";
+ },
+ $isFunction: 1,
+ get$$call() {
+ return this;
+ },
+ "call*": "call$1",
+ $requiredArgCount: 1,
+ $defaultValues: null
+ };
+ A.Closure0Args.prototype = {"call*": "call$0", $requiredArgCount: 0};
+ A.Closure2Args.prototype = {"call*": "call$2", $requiredArgCount: 2};
+ A.TearOffClosure.prototype = {};
+ A.StaticClosure.prototype = {
+ toString$0(_) {
+ var $name = this.$static_name;
+ if ($name == null)
+ return "Closure of unknown static method";
+ return "Closure '" + A.unminifyOrTag($name) + "'";
+ }
+ };
+ A.BoundClosure.prototype = {
+ $eq(_, other) {
+ if (other == null)
+ return false;
+ if (this === other)
+ return true;
+ if (!(other instanceof A.BoundClosure))
+ return false;
+ return this.$_target === other.$_target && this._receiver === other._receiver;
+ },
+ get$hashCode(_) {
+ return (A.objectHashCode(this._receiver) ^ A.Primitives_objectHashCode(this.$_target)) >>> 0;
+ },
+ toString$0(_) {
+ return "Closure '" + this.$_name + "' of " + ("Instance of '" + A.Primitives_objectTypeName(this._receiver) + "'");
+ }
+ };
+ A._CyclicInitializationError.prototype = {
+ toString$0(_) {
+ return "Reading static variable '" + this.variableName + "' during its initialization";
+ }
+ };
+ A.RuntimeError.prototype = {
+ toString$0(_) {
+ return "RuntimeError: " + this.message;
+ }
+ };
+ A._AssertionError.prototype = {
+ toString$0(_) {
+ return "Assertion failed: " + A.Error_safeToString(this.message);
+ }
+ };
+ A._Required.prototype = {};
+ A.JsLinkedHashMap.prototype = {
+ get$length(_) {
+ return this._length;
+ },
+ get$isEmpty(_) {
+ return this._length === 0;
+ },
+ get$keys(_) {
+ return new A.LinkedHashMapKeyIterable(this, A._instanceType(this)._eval$1("LinkedHashMapKeyIterable<1>"));
+ },
+ get$values(_) {
+ var t1 = A._instanceType(this);
+ return A.MappedIterable_MappedIterable(new A.LinkedHashMapKeyIterable(this, t1._eval$1("LinkedHashMapKeyIterable<1>")), new A.JsLinkedHashMap_values_closure(this), t1._precomputed1, t1._rest[1]);
+ },
+ containsKey$1(_, key) {
+ var strings, nums;
+ if (typeof key == "string") {
+ strings = this._strings;
+ if (strings == null)
+ return false;
+ return strings[key] != null;
+ } else if (typeof key == "number" && (key & 0x3fffffff) === key) {
+ nums = this._nums;
+ if (nums == null)
+ return false;
+ return nums[key] != null;
+ } else
+ return this.internalContainsKey$1(key);
+ },
+ internalContainsKey$1(key) {
+ var rest = this.__js_helper$_rest;
+ if (rest == null)
+ return false;
+ return this.internalFindBucketIndex$2(rest[this.internalComputeHashCode$1(key)], key) >= 0;
+ },
+ $index(_, key) {
+ var strings, cell, t1, nums, _null = null;
+ if (typeof key == "string") {
+ strings = this._strings;
+ if (strings == null)
+ return _null;
+ cell = strings[key];
+ t1 = cell == null ? _null : cell.hashMapCellValue;
+ return t1;
+ } else if (typeof key == "number" && (key & 0x3fffffff) === key) {
+ nums = this._nums;
+ if (nums == null)
+ return _null;
+ cell = nums[key];
+ t1 = cell == null ? _null : cell.hashMapCellValue;
+ return t1;
+ } else
+ return this.internalGet$1(key);
+ },
+ internalGet$1(key) {
+ var bucket, index,
+ rest = this.__js_helper$_rest;
+ if (rest == null)
+ return null;
+ bucket = rest[this.internalComputeHashCode$1(key)];
+ index = this.internalFindBucketIndex$2(bucket, key);
+ if (index < 0)
+ return null;
+ return bucket[index].hashMapCellValue;
+ },
+ $indexSet(_, key, value) {
+ var strings, nums, rest, hash, bucket, index, _this = this,
+ t1 = A._instanceType(_this);
+ t1._precomputed1._as(key);
+ t1._rest[1]._as(value);
+ if (typeof key == "string") {
+ strings = _this._strings;
+ _this._addHashTableEntry$3(strings == null ? _this._strings = _this._newHashTable$0() : strings, key, value);
+ } else if (typeof key == "number" && (key & 0x3fffffff) === key) {
+ nums = _this._nums;
+ _this._addHashTableEntry$3(nums == null ? _this._nums = _this._newHashTable$0() : nums, key, value);
+ } else {
+ rest = _this.__js_helper$_rest;
+ if (rest == null)
+ rest = _this.__js_helper$_rest = _this._newHashTable$0();
+ hash = _this.internalComputeHashCode$1(key);
+ bucket = rest[hash];
+ if (bucket == null)
+ rest[hash] = [_this._newLinkedCell$2(key, value)];
+ else {
+ index = _this.internalFindBucketIndex$2(bucket, key);
+ if (index >= 0)
+ bucket[index].hashMapCellValue = value;
+ else
+ bucket.push(_this._newLinkedCell$2(key, value));
+ }
+ }
+ },
+ putIfAbsent$2(_, key, ifAbsent) {
+ var t2, value, _this = this,
+ t1 = A._instanceType(_this);
+ t1._precomputed1._as(key);
+ t1._eval$1("2()")._as(ifAbsent);
+ if (_this.containsKey$1(0, key)) {
+ t2 = _this.$index(0, key);
+ return t2 == null ? t1._rest[1]._as(t2) : t2;
+ }
+ value = ifAbsent.call$0();
+ _this.$indexSet(0, key, value);
+ return value;
+ },
+ remove$1(_, key) {
+ var _this = this;
+ if (typeof key == "string")
+ return _this._removeHashTableEntry$2(_this._strings, key);
+ else if (typeof key == "number" && (key & 0x3fffffff) === key)
+ return _this._removeHashTableEntry$2(_this._nums, key);
+ else
+ return _this.internalRemove$1(key);
+ },
+ internalRemove$1(key) {
+ var hash, bucket, index, cell, _this = this,
+ rest = _this.__js_helper$_rest;
+ if (rest == null)
+ return null;
+ hash = _this.internalComputeHashCode$1(key);
+ bucket = rest[hash];
+ index = _this.internalFindBucketIndex$2(bucket, key);
+ if (index < 0)
+ return null;
+ cell = bucket.splice(index, 1)[0];
+ _this._unlinkCell$1(cell);
+ if (bucket.length === 0)
+ delete rest[hash];
+ return cell.hashMapCellValue;
+ },
+ clear$0(_) {
+ var _this = this;
+ if (_this._length > 0) {
+ _this._strings = _this._nums = _this.__js_helper$_rest = _this._first = _this._last = null;
+ _this._length = 0;
+ _this._modified$0();
+ }
+ },
+ forEach$1(_, action) {
+ var cell, modifications, _this = this;
+ A._instanceType(_this)._eval$1("~(1,2)")._as(action);
+ cell = _this._first;
+ modifications = _this._modifications;
+ for (; cell != null;) {
+ action.call$2(cell.hashMapCellKey, cell.hashMapCellValue);
+ if (modifications !== _this._modifications)
+ throw A.wrapException(A.ConcurrentModificationError$(_this));
+ cell = cell._next;
+ }
+ },
+ _addHashTableEntry$3(table, key, value) {
+ var cell,
+ t1 = A._instanceType(this);
+ t1._precomputed1._as(key);
+ t1._rest[1]._as(value);
+ cell = table[key];
+ if (cell == null)
+ table[key] = this._newLinkedCell$2(key, value);
+ else
+ cell.hashMapCellValue = value;
+ },
+ _removeHashTableEntry$2(table, key) {
+ var cell;
+ if (table == null)
+ return null;
+ cell = table[key];
+ if (cell == null)
+ return null;
+ this._unlinkCell$1(cell);
+ delete table[key];
+ return cell.hashMapCellValue;
+ },
+ _modified$0() {
+ this._modifications = this._modifications + 1 & 1073741823;
+ },
+ _newLinkedCell$2(key, value) {
+ var _this = this,
+ t1 = A._instanceType(_this),
+ cell = new A.LinkedHashMapCell(t1._precomputed1._as(key), t1._rest[1]._as(value));
+ if (_this._first == null)
+ _this._first = _this._last = cell;
+ else {
+ t1 = _this._last;
+ t1.toString;
+ cell._previous = t1;
+ _this._last = t1._next = cell;
+ }
+ ++_this._length;
+ _this._modified$0();
+ return cell;
+ },
+ _unlinkCell$1(cell) {
+ var _this = this,
+ previous = cell._previous,
+ next = cell._next;
+ if (previous == null)
+ _this._first = next;
+ else
+ previous._next = next;
+ if (next == null)
+ _this._last = previous;
+ else
+ next._previous = previous;
+ --_this._length;
+ _this._modified$0();
+ },
+ internalComputeHashCode$1(key) {
+ return J.get$hashCode$(key) & 1073741823;
+ },
+ internalFindBucketIndex$2(bucket, key) {
+ var $length, i;
+ if (bucket == null)
+ return -1;
+ $length = bucket.length;
+ for (i = 0; i < $length; ++i)
+ if (J.$eq$(bucket[i].hashMapCellKey, key))
+ return i;
+ return -1;
+ },
+ toString$0(_) {
+ return A.MapBase_mapToString(this);
+ },
+ _newHashTable$0() {
+ var table = Object.create(null);
+ table["<non-identifier-key>"] = table;
+ delete table["<non-identifier-key>"];
+ return table;
+ },
+ $isLinkedHashMap: 1
+ };
+ A.JsLinkedHashMap_values_closure.prototype = {
+ call$1(each) {
+ var t1 = this.$this,
+ t2 = A._instanceType(t1);
+ t1 = t1.$index(0, t2._precomputed1._as(each));
+ return t1 == null ? t2._rest[1]._as(t1) : t1;
+ },
+ $signature() {
+ return A._instanceType(this.$this)._eval$1("2(1)");
+ }
+ };
+ A.LinkedHashMapCell.prototype = {};
+ A.LinkedHashMapKeyIterable.prototype = {
+ get$length(_) {
+ return this._map._length;
+ },
+ get$isEmpty(_) {
+ return this._map._length === 0;
+ },
+ get$iterator(_) {
+ var t1 = this._map,
+ t2 = new A.LinkedHashMapKeyIterator(t1, t1._modifications, this.$ti._eval$1("LinkedHashMapKeyIterator<1>"));
+ t2._cell = t1._first;
+ return t2;
+ },
+ contains$1(_, element) {
+ return this._map.containsKey$1(0, element);
+ }
+ };
+ A.LinkedHashMapKeyIterator.prototype = {
+ get$current(_) {
+ return this.__js_helper$_current;
+ },
+ moveNext$0() {
+ var cell, _this = this,
+ t1 = _this._map;
+ if (_this._modifications !== t1._modifications)
+ throw A.wrapException(A.ConcurrentModificationError$(t1));
+ cell = _this._cell;
+ if (cell == null) {
+ _this.set$__js_helper$_current(null);
+ return false;
+ } else {
+ _this.set$__js_helper$_current(cell.hashMapCellKey);
+ _this._cell = cell._next;
+ return true;
+ }
+ },
+ set$__js_helper$_current(_current) {
+ this.__js_helper$_current = this.$ti._eval$1("1?")._as(_current);
+ },
+ $isIterator: 1
+ };
+ A.initHooks_closure.prototype = {
+ call$1(o) {
+ return this.getTag(o);
+ },
+ $signature: 15
+ };
+ A.initHooks_closure0.prototype = {
+ call$2(o, tag) {
+ return this.getUnknownTag(o, tag);
+ },
+ $signature: 36
+ };
+ A.initHooks_closure1.prototype = {
+ call$1(tag) {
+ return this.prototypeForTag(A._asString(tag));
+ },
+ $signature: 37
+ };
+ A.JSSyntaxRegExp.prototype = {
+ toString$0(_) {
+ return "RegExp/" + this.pattern + "/" + this._nativeRegExp.flags;
+ },
+ get$_nativeGlobalVersion() {
+ var _this = this,
+ t1 = _this._nativeGlobalRegExp;
+ if (t1 != null)
+ return t1;
+ t1 = _this._nativeRegExp;
+ return _this._nativeGlobalRegExp = A.JSSyntaxRegExp_makeNative(_this.pattern, t1.multiline, !t1.ignoreCase, t1.unicode, t1.dotAll, true);
+ },
+ get$_nativeAnchoredVersion() {
+ var _this = this,
+ t1 = _this._nativeAnchoredRegExp;
+ if (t1 != null)
+ return t1;
+ t1 = _this._nativeRegExp;
+ return _this._nativeAnchoredRegExp = A.JSSyntaxRegExp_makeNative(_this.pattern + "|()", t1.multiline, !t1.ignoreCase, t1.unicode, t1.dotAll, true);
+ },
+ firstMatch$1(string) {
+ var m = this._nativeRegExp.exec(string);
+ if (m == null)
+ return null;
+ return new A._MatchImplementation(m);
+ },
+ allMatches$2(_, string, start) {
+ var t1 = string.length;
+ if (start > t1)
+ throw A.wrapException(A.RangeError$range(start, 0, t1, null, null));
+ return new A._AllMatchesIterable(this, string, start);
+ },
+ allMatches$1($receiver, string) {
+ return this.allMatches$2($receiver, string, 0);
+ },
+ _execGlobal$2(string, start) {
+ var match,
+ regexp = this.get$_nativeGlobalVersion();
+ if (regexp == null)
+ regexp = type$.Object._as(regexp);
+ regexp.lastIndex = start;
+ match = regexp.exec(string);
+ if (match == null)
+ return null;
+ return new A._MatchImplementation(match);
+ },
+ _execAnchored$2(string, start) {
+ var match,
+ regexp = this.get$_nativeAnchoredVersion();
+ if (regexp == null)
+ regexp = type$.Object._as(regexp);
+ regexp.lastIndex = start;
+ match = regexp.exec(string);
+ if (match == null)
+ return null;
+ if (0 >= match.length)
+ return A.ioore(match, -1);
+ if (match.pop() != null)
+ return null;
+ return new A._MatchImplementation(match);
+ },
+ matchAsPrefix$2(_, string, start) {
+ if (start < 0 || start > string.length)
+ throw A.wrapException(A.RangeError$range(start, 0, string.length, null, null));
+ return this._execAnchored$2(string, start);
+ },
+ $isPattern: 1,
+ $isRegExp: 1
+ };
+ A._MatchImplementation.prototype = {
+ get$start(_) {
+ return this._match.index;
+ },
+ get$end(_) {
+ var t1 = this._match;
+ return t1.index + t1[0].length;
+ },
+ $isMatch: 1,
+ $isRegExpMatch: 1
+ };
+ A._AllMatchesIterable.prototype = {
+ get$iterator(_) {
+ return new A._AllMatchesIterator(this._re, this.__js_helper$_string, this.__js_helper$_start);
+ }
+ };
+ A._AllMatchesIterator.prototype = {
+ get$current(_) {
+ var t1 = this.__js_helper$_current;
+ return t1 == null ? type$.RegExpMatch._as(t1) : t1;
+ },
+ moveNext$0() {
+ var t1, t2, t3, match, nextIndex, _this = this,
+ string = _this.__js_helper$_string;
+ if (string == null)
+ return false;
+ t1 = _this._nextIndex;
+ t2 = string.length;
+ if (t1 <= t2) {
+ t3 = _this._regExp;
+ match = t3._execGlobal$2(string, t1);
+ if (match != null) {
+ _this.__js_helper$_current = match;
+ nextIndex = match.get$end(match);
+ if (match._match.index === nextIndex) {
+ if (t3._nativeRegExp.unicode) {
+ t1 = _this._nextIndex;
+ t3 = t1 + 1;
+ if (t3 < t2) {
+ if (!(t1 >= 0 && t1 < t2))
+ return A.ioore(string, t1);
+ t1 = string.charCodeAt(t1);
+ if (t1 >= 55296 && t1 <= 56319) {
+ if (!(t3 >= 0))
+ return A.ioore(string, t3);
+ t1 = string.charCodeAt(t3);
+ t1 = t1 >= 56320 && t1 <= 57343;
+ } else
+ t1 = false;
+ } else
+ t1 = false;
+ } else
+ t1 = false;
+ nextIndex = (t1 ? nextIndex + 1 : nextIndex) + 1;
+ }
+ _this._nextIndex = nextIndex;
+ return true;
+ }
+ }
+ _this.__js_helper$_string = _this.__js_helper$_current = null;
+ return false;
+ },
+ $isIterator: 1
+ };
+ A.StringMatch.prototype = {
+ get$end(_) {
+ return this.start + this.pattern.length;
+ },
+ $isMatch: 1,
+ get$start(receiver) {
+ return this.start;
+ }
+ };
+ A._StringAllMatchesIterable.prototype = {
+ get$iterator(_) {
+ return new A._StringAllMatchesIterator(this._input, this._pattern, this.__js_helper$_index);
+ }
+ };
+ A._StringAllMatchesIterator.prototype = {
+ moveNext$0() {
+ var index, end, _this = this,
+ t1 = _this.__js_helper$_index,
+ t2 = _this._pattern,
+ t3 = t2.length,
+ t4 = _this._input,
+ t5 = t4.length;
+ if (t1 + t3 > t5) {
+ _this.__js_helper$_current = null;
+ return false;
+ }
+ index = t4.indexOf(t2, t1);
+ if (index < 0) {
+ _this.__js_helper$_index = t5 + 1;
+ _this.__js_helper$_current = null;
+ return false;
+ }
+ end = index + t3;
+ _this.__js_helper$_current = new A.StringMatch(index, t2);
+ _this.__js_helper$_index = end === _this.__js_helper$_index ? end + 1 : end;
+ return true;
+ },
+ get$current(_) {
+ var t1 = this.__js_helper$_current;
+ t1.toString;
+ return t1;
+ },
+ $isIterator: 1
+ };
+ A._Cell.prototype = {
+ _readLocal$0() {
+ var t1 = this._value;
+ if (t1 === this)
+ throw A.wrapException(new A.LateError("Local '" + this.__late_helper$_name + "' has not been initialized."));
+ return t1;
+ }
+ };
+ A._InitializedCell.prototype = {
+ _readFinal$0() {
+ var result, _this = this,
+ t1 = _this._value;
+ if (t1 === _this) {
+ result = _this._initializer.call$0();
+ if (_this._value !== _this)
+ throw A.wrapException(new A.LateError("Local '" + _this.__late_helper$_name + string$.x27_has_));
+ _this._value = result;
+ t1 = result;
+ }
+ return t1;
+ }
+ };
+ A.NativeByteBuffer.prototype = {
+ get$runtimeType(receiver) {
+ return B.Type_ByteBuffer_RkP;
+ },
+ $isTrustedGetRuntimeType: 1,
+ $isByteBuffer: 1
+ };
+ A.NativeTypedData.prototype = {};
+ A.NativeByteData.prototype = {
+ get$runtimeType(receiver) {
+ return B.Type_ByteData_zNC;
+ },
+ $isTrustedGetRuntimeType: 1,
+ $isByteData: 1
+ };
+ A.NativeTypedArray.prototype = {
+ get$length(receiver) {
+ return receiver.length;
+ },
+ $isJavaScriptIndexingBehavior: 1
+ };
+ A.NativeTypedArrayOfDouble.prototype = {
+ $index(receiver, index) {
+ A._checkValidIndex(index, receiver, receiver.length);
+ return receiver[index];
+ },
+ $indexSet(receiver, index, value) {
+ A._asDouble(value);
+ A._checkValidIndex(index, receiver, receiver.length);
+ receiver[index] = value;
+ },
+ $isEfficientLengthIterable: 1,
+ $isIterable: 1,
+ $isList: 1
+ };
+ A.NativeTypedArrayOfInt.prototype = {
+ $indexSet(receiver, index, value) {
+ A._asInt(value);
+ A._checkValidIndex(index, receiver, receiver.length);
+ receiver[index] = value;
+ },
+ $isEfficientLengthIterable: 1,
+ $isIterable: 1,
+ $isList: 1
+ };
+ A.NativeFloat32List.prototype = {
+ get$runtimeType(receiver) {
+ return B.Type_Float32List_LB7;
+ },
+ $isTrustedGetRuntimeType: 1,
+ $isFloat32List: 1
+ };
+ A.NativeFloat64List.prototype = {
+ get$runtimeType(receiver) {
+ return B.Type_Float64List_LB7;
+ },
+ $isTrustedGetRuntimeType: 1,
+ $isFloat64List: 1
+ };
+ A.NativeInt16List.prototype = {
+ get$runtimeType(receiver) {
+ return B.Type_Int16List_uXf;
+ },
+ $index(receiver, index) {
+ A._checkValidIndex(index, receiver, receiver.length);
+ return receiver[index];
+ },
+ $isTrustedGetRuntimeType: 1,
+ $isInt16List: 1
+ };
+ A.NativeInt32List.prototype = {
+ get$runtimeType(receiver) {
+ return B.Type_Int32List_O50;
+ },
+ $index(receiver, index) {
+ A._checkValidIndex(index, receiver, receiver.length);
+ return receiver[index];
+ },
+ $isTrustedGetRuntimeType: 1,
+ $isInt32List: 1
+ };
+ A.NativeInt8List.prototype = {
+ get$runtimeType(receiver) {
+ return B.Type_Int8List_ekJ;
+ },
+ $index(receiver, index) {
+ A._checkValidIndex(index, receiver, receiver.length);
+ return receiver[index];
+ },
+ $isTrustedGetRuntimeType: 1,
+ $isInt8List: 1
+ };
+ A.NativeUint16List.prototype = {
+ get$runtimeType(receiver) {
+ return B.Type_Uint16List_2bx;
+ },
+ $index(receiver, index) {
+ A._checkValidIndex(index, receiver, receiver.length);
+ return receiver[index];
+ },
+ $isTrustedGetRuntimeType: 1,
+ $isUint16List: 1
+ };
+ A.NativeUint32List.prototype = {
+ get$runtimeType(receiver) {
+ return B.Type_Uint32List_2bx;
+ },
+ $index(receiver, index) {
+ A._checkValidIndex(index, receiver, receiver.length);
+ return receiver[index];
+ },
+ $isTrustedGetRuntimeType: 1,
+ $isUint32List: 1
+ };
+ A.NativeUint8ClampedList.prototype = {
+ get$runtimeType(receiver) {
+ return B.Type_Uint8ClampedList_Jik;
+ },
+ get$length(receiver) {
+ return receiver.length;
+ },
+ $index(receiver, index) {
+ A._checkValidIndex(index, receiver, receiver.length);
+ return receiver[index];
+ },
+ $isTrustedGetRuntimeType: 1,
+ $isUint8ClampedList: 1
+ };
+ A.NativeUint8List.prototype = {
+ get$runtimeType(receiver) {
+ return B.Type_Uint8List_WLA;
+ },
+ get$length(receiver) {
+ return receiver.length;
+ },
+ $index(receiver, index) {
+ A._checkValidIndex(index, receiver, receiver.length);
+ return receiver[index];
+ },
+ sublist$2(receiver, start, end) {
+ return new Uint8Array(receiver.subarray(start, A._checkValidRange(start, end, receiver.length)));
+ },
+ $isTrustedGetRuntimeType: 1,
+ $isNativeUint8List: 1,
+ $isUint8List: 1
+ };
+ A._NativeTypedArrayOfDouble_NativeTypedArray_ListMixin.prototype = {};
+ A._NativeTypedArrayOfDouble_NativeTypedArray_ListMixin_FixedLengthListMixin.prototype = {};
+ A._NativeTypedArrayOfInt_NativeTypedArray_ListMixin.prototype = {};
+ A._NativeTypedArrayOfInt_NativeTypedArray_ListMixin_FixedLengthListMixin.prototype = {};
+ A.Rti.prototype = {
+ _eval$1(recipe) {
+ return A._Universe_evalInEnvironment(init.typeUniverse, this, recipe);
+ },
+ _bind$1(typeOrTuple) {
+ return A._Universe_bind(init.typeUniverse, this, typeOrTuple);
+ }
+ };
+ A._FunctionParameters.prototype = {};
+ A._Type.prototype = {
+ toString$0(_) {
+ return A._rtiToString(this._rti, null);
+ }
+ };
+ A._Error.prototype = {
+ toString$0(_) {
+ return this.__rti$_message;
+ }
+ };
+ A._TypeError.prototype = {$isTypeError: 1};
+ A._AsyncRun__initializeScheduleImmediate_internalCallback.prototype = {
+ call$1(_) {
+ var t1 = this._box_0,
+ f = t1.storedCallback;
+ t1.storedCallback = null;
+ f.call$0();
+ },
+ $signature: 10
+ };
+ A._AsyncRun__initializeScheduleImmediate_closure.prototype = {
+ call$1(callback) {
+ var t1, t2;
+ this._box_0.storedCallback = type$.void_Function._as(callback);
+ t1 = this.div;
+ t2 = this.span;
+ t1.firstChild ? t1.removeChild(t2) : t1.appendChild(t2);
+ },
+ $signature: 30
+ };
+ A._AsyncRun__scheduleImmediateJsOverride_internalCallback.prototype = {
+ call$0() {
+ this.callback.call$0();
+ },
+ $signature: 3
+ };
+ A._AsyncRun__scheduleImmediateWithSetImmediate_internalCallback.prototype = {
+ call$0() {
+ this.callback.call$0();
+ },
+ $signature: 3
+ };
+ A._TimerImpl.prototype = {
+ _TimerImpl$2(milliseconds, callback) {
+ if (self.setTimeout != null)
+ self.setTimeout(A.convertDartClosureToJS(new A._TimerImpl_internalCallback(this, callback), 0), milliseconds);
+ else
+ throw A.wrapException(A.UnsupportedError$("`setTimeout()` not found."));
+ },
+ _TimerImpl$periodic$2(milliseconds, callback) {
+ if (self.setTimeout != null)
+ self.setInterval(A.convertDartClosureToJS(new A._TimerImpl$periodic_closure(this, milliseconds, Date.now(), callback), 0), milliseconds);
+ else
+ throw A.wrapException(A.UnsupportedError$("Periodic timer."));
+ },
+ $isTimer: 1
+ };
+ A._TimerImpl_internalCallback.prototype = {
+ call$0() {
+ this.$this._tick = 1;
+ this.callback.call$0();
+ },
+ $signature: 0
+ };
+ A._TimerImpl$periodic_closure.prototype = {
+ call$0() {
+ var duration, _this = this,
+ t1 = _this.$this,
+ tick = t1._tick + 1,
+ t2 = _this.milliseconds;
+ if (t2 > 0) {
+ duration = Date.now() - _this.start;
+ if (duration > (tick + 1) * t2)
+ tick = B.JSInt_methods.$tdiv(duration, t2);
+ }
+ t1._tick = tick;
+ _this.callback.call$1(t1);
+ },
+ $signature: 3
+ };
+ A.AsyncError.prototype = {
+ toString$0(_) {
+ return A.S(this.error);
+ },
+ $isError: 1,
+ get$stackTrace() {
+ return this.stackTrace;
+ }
+ };
+ A._Completer.prototype = {
+ completeError$2(error, stackTrace) {
+ var replacement;
+ A.checkNotNullable(error, "error", type$.Object);
+ if ((this.future._async$_state & 30) !== 0)
+ throw A.wrapException(A.StateError$("Future already completed"));
+ replacement = $.Zone__current.errorCallback$2(error, stackTrace);
+ if (replacement != null) {
+ error = replacement.error;
+ stackTrace = replacement.stackTrace;
+ } else if (stackTrace == null)
+ stackTrace = A.AsyncError_defaultStackTrace(error);
+ this._completeError$2(error, stackTrace);
+ },
+ completeError$1(error) {
+ return this.completeError$2(error, null);
+ },
+ $isCompleter: 1
+ };
+ A._AsyncCompleter.prototype = {
+ complete$1(_, value) {
+ var t2,
+ t1 = this.$ti;
+ t1._eval$1("1/?")._as(value);
+ t2 = this.future;
+ if ((t2._async$_state & 30) !== 0)
+ throw A.wrapException(A.StateError$("Future already completed"));
+ t2._asyncComplete$1(t1._eval$1("1/")._as(value));
+ },
+ complete$0($receiver) {
+ return this.complete$1($receiver, null);
+ },
+ _completeError$2(error, stackTrace) {
+ this.future._asyncCompleteError$2(error, stackTrace);
+ }
+ };
+ A._SyncCompleter.prototype = {
+ complete$1(_, value) {
+ var t2,
+ t1 = this.$ti;
+ t1._eval$1("1/?")._as(value);
+ t2 = this.future;
+ if ((t2._async$_state & 30) !== 0)
+ throw A.wrapException(A.StateError$("Future already completed"));
+ t2._complete$1(t1._eval$1("1/")._as(value));
+ },
+ complete$0($receiver) {
+ return this.complete$1($receiver, null);
+ },
+ _completeError$2(error, stackTrace) {
+ this.future._completeError$2(error, stackTrace);
+ }
+ };
+ A._FutureListener.prototype = {
+ matchesErrorTest$1(asyncError) {
+ if ((this.state & 15) !== 6)
+ return true;
+ return this.result._zone.runUnary$2$2(type$.bool_Function_Object._as(this.callback), asyncError.error, type$.bool, type$.Object);
+ },
+ handleError$1(asyncError) {
+ var exception, _this = this,
+ errorCallback = _this.errorCallback,
+ result = null,
+ t1 = type$.dynamic,
+ t2 = type$.Object,
+ t3 = asyncError.error,
+ t4 = _this.result._zone;
+ if (type$.dynamic_Function_Object_StackTrace._is(errorCallback))
+ result = t4.runBinary$3$3(errorCallback, t3, asyncError.stackTrace, t1, t2, type$.StackTrace);
+ else
+ result = t4.runUnary$2$2(type$.dynamic_Function_Object._as(errorCallback), t3, t1, t2);
+ try {
+ t1 = _this.$ti._eval$1("2/")._as(result);
+ return t1;
+ } catch (exception) {
+ if (type$.TypeError._is(A.unwrapException(exception))) {
+ if ((_this.state & 1) !== 0)
+ throw A.wrapException(A.ArgumentError$("The error handler of Future.then must return a value of the returned future's type", "onError"));
+ throw A.wrapException(A.ArgumentError$("The error handler of Future.catchError must return a value of the future's type", "onError"));
+ } else
+ throw exception;
+ }
+ }
+ };
+ A._Future.prototype = {
+ _setChained$1(source) {
+ this._async$_state = this._async$_state & 1 | 4;
+ this._resultOrListeners = source;
+ },
+ then$1$2$onError(f, onError, $R) {
+ var currentZone, result, t2,
+ t1 = this.$ti;
+ t1._bind$1($R)._eval$1("1/(2)")._as(f);
+ currentZone = $.Zone__current;
+ if (currentZone === B.C__RootZone) {
+ if (onError != null && !type$.dynamic_Function_Object_StackTrace._is(onError) && !type$.dynamic_Function_Object._is(onError))
+ throw A.wrapException(A.ArgumentError$value(onError, "onError", string$.Error_));
+ } else {
+ f = currentZone.registerUnaryCallback$2$1(f, $R._eval$1("0/"), t1._precomputed1);
+ if (onError != null)
+ onError = A._registerErrorHandler(onError, currentZone);
+ }
+ result = new A._Future($.Zone__current, $R._eval$1("_Future<0>"));
+ t2 = onError == null ? 1 : 3;
+ this._addListener$1(new A._FutureListener(result, t2, f, onError, t1._eval$1("@<1>")._bind$1($R)._eval$1("_FutureListener<1,2>")));
+ return result;
+ },
+ then$1$1(f, $R) {
+ return this.then$1$2$onError(f, null, $R);
+ },
+ whenComplete$1(action) {
+ var t1, t2, result;
+ type$.dynamic_Function._as(action);
+ t1 = this.$ti;
+ t2 = $.Zone__current;
+ result = new A._Future(t2, t1);
+ if (t2 !== B.C__RootZone)
+ action = t2.registerCallback$1$1(action, type$.dynamic);
+ this._addListener$1(new A._FutureListener(result, 8, action, null, t1._eval$1("@<1>")._bind$1(t1._precomputed1)._eval$1("_FutureListener<1,2>")));
+ return result;
+ },
+ _setErrorObject$1(error) {
+ this._async$_state = this._async$_state & 1 | 16;
+ this._resultOrListeners = error;
+ },
+ _cloneResult$1(source) {
+ this._async$_state = source._async$_state & 30 | this._async$_state & 1;
+ this._resultOrListeners = source._resultOrListeners;
+ },
+ _addListener$1(listener) {
+ var source, _this = this,
+ t1 = _this._async$_state;
+ if (t1 <= 3) {
+ listener._nextListener = type$.nullable__FutureListener_dynamic_dynamic._as(_this._resultOrListeners);
+ _this._resultOrListeners = listener;
+ } else {
+ if ((t1 & 4) !== 0) {
+ source = type$._Future_dynamic._as(_this._resultOrListeners);
+ if ((source._async$_state & 24) === 0) {
+ source._addListener$1(listener);
+ return;
+ }
+ _this._cloneResult$1(source);
+ }
+ _this._zone.scheduleMicrotask$1(new A._Future__addListener_closure(_this, listener));
+ }
+ },
+ _prependListeners$1(listeners) {
+ var t1, existingListeners, next, cursor, next0, source, _this = this, _box_0 = {};
+ _box_0.listeners = listeners;
+ if (listeners == null)
+ return;
+ t1 = _this._async$_state;
+ if (t1 <= 3) {
+ existingListeners = type$.nullable__FutureListener_dynamic_dynamic._as(_this._resultOrListeners);
+ _this._resultOrListeners = listeners;
+ if (existingListeners != null) {
+ next = listeners._nextListener;
+ for (cursor = listeners; next != null; cursor = next, next = next0)
+ next0 = next._nextListener;
+ cursor._nextListener = existingListeners;
+ }
+ } else {
+ if ((t1 & 4) !== 0) {
+ source = type$._Future_dynamic._as(_this._resultOrListeners);
+ if ((source._async$_state & 24) === 0) {
+ source._prependListeners$1(listeners);
+ return;
+ }
+ _this._cloneResult$1(source);
+ }
+ _box_0.listeners = _this._reverseListeners$1(listeners);
+ _this._zone.scheduleMicrotask$1(new A._Future__prependListeners_closure(_box_0, _this));
+ }
+ },
+ _removeListeners$0() {
+ var current = type$.nullable__FutureListener_dynamic_dynamic._as(this._resultOrListeners);
+ this._resultOrListeners = null;
+ return this._reverseListeners$1(current);
+ },
+ _reverseListeners$1(listeners) {
+ var current, prev, next;
+ for (current = listeners, prev = null; current != null; prev = current, current = next) {
+ next = current._nextListener;
+ current._nextListener = prev;
+ }
+ return prev;
+ },
+ _chainForeignFuture$1(source) {
+ var e, s, exception, _this = this;
+ _this._async$_state ^= 2;
+ try {
+ source.then$1$2$onError(new A._Future__chainForeignFuture_closure(_this), new A._Future__chainForeignFuture_closure0(_this), type$.Null);
+ } catch (exception) {
+ e = A.unwrapException(exception);
+ s = A.getTraceFromException(exception);
+ A.scheduleMicrotask(new A._Future__chainForeignFuture_closure1(_this, e, s));
+ }
+ },
+ _complete$1(value) {
+ var listeners, _this = this,
+ t1 = _this.$ti;
+ t1._eval$1("1/")._as(value);
+ if (t1._eval$1("Future<1>")._is(value))
+ if (t1._is(value))
+ A._Future__chainCoreFutureSync(value, _this);
+ else
+ _this._chainForeignFuture$1(value);
+ else {
+ listeners = _this._removeListeners$0();
+ t1._precomputed1._as(value);
+ _this._async$_state = 8;
+ _this._resultOrListeners = value;
+ A._Future__propagateToListeners(_this, listeners);
+ }
+ },
+ _completeWithValue$1(value) {
+ var listeners, _this = this;
+ _this.$ti._precomputed1._as(value);
+ listeners = _this._removeListeners$0();
+ _this._async$_state = 8;
+ _this._resultOrListeners = value;
+ A._Future__propagateToListeners(_this, listeners);
+ },
+ _completeError$2(error, stackTrace) {
+ var listeners;
+ type$.Object._as(error);
+ type$.StackTrace._as(stackTrace);
+ listeners = this._removeListeners$0();
+ this._setErrorObject$1(A.AsyncError$(error, stackTrace));
+ A._Future__propagateToListeners(this, listeners);
+ },
+ _asyncComplete$1(value) {
+ var t1 = this.$ti;
+ t1._eval$1("1/")._as(value);
+ if (t1._eval$1("Future<1>")._is(value)) {
+ this._chainFuture$1(value);
+ return;
+ }
+ this._asyncCompleteWithValue$1(value);
+ },
+ _asyncCompleteWithValue$1(value) {
+ var _this = this;
+ _this.$ti._precomputed1._as(value);
+ _this._async$_state ^= 2;
+ _this._zone.scheduleMicrotask$1(new A._Future__asyncCompleteWithValue_closure(_this, value));
+ },
+ _chainFuture$1(value) {
+ var t1 = this.$ti;
+ t1._eval$1("Future<1>")._as(value);
+ if (t1._is(value)) {
+ A._Future__chainCoreFutureAsync(value, this);
+ return;
+ }
+ this._chainForeignFuture$1(value);
+ },
+ _asyncCompleteError$2(error, stackTrace) {
+ type$.StackTrace._as(stackTrace);
+ this._async$_state ^= 2;
+ this._zone.scheduleMicrotask$1(new A._Future__asyncCompleteError_closure(this, error, stackTrace));
+ },
+ $isFuture: 1
+ };
+ A._Future__addListener_closure.prototype = {
+ call$0() {
+ A._Future__propagateToListeners(this.$this, this.listener);
+ },
+ $signature: 0
+ };
+ A._Future__prependListeners_closure.prototype = {
+ call$0() {
+ A._Future__propagateToListeners(this.$this, this._box_0.listeners);
+ },
+ $signature: 0
+ };
+ A._Future__chainForeignFuture_closure.prototype = {
+ call$1(value) {
+ var error, stackTrace, exception,
+ t1 = this.$this;
+ t1._async$_state ^= 2;
+ try {
+ t1._completeWithValue$1(t1.$ti._precomputed1._as(value));
+ } catch (exception) {
+ error = A.unwrapException(exception);
+ stackTrace = A.getTraceFromException(exception);
+ t1._completeError$2(error, stackTrace);
+ }
+ },
+ $signature: 10
+ };
+ A._Future__chainForeignFuture_closure0.prototype = {
+ call$2(error, stackTrace) {
+ this.$this._completeError$2(type$.Object._as(error), type$.StackTrace._as(stackTrace));
+ },
+ $signature: 26
+ };
+ A._Future__chainForeignFuture_closure1.prototype = {
+ call$0() {
+ this.$this._completeError$2(this.e, this.s);
+ },
+ $signature: 0
+ };
+ A._Future__chainCoreFutureAsync_closure.prototype = {
+ call$0() {
+ A._Future__chainCoreFutureSync(this._box_0.source, this.target);
+ },
+ $signature: 0
+ };
+ A._Future__asyncCompleteWithValue_closure.prototype = {
+ call$0() {
+ this.$this._completeWithValue$1(this.value);
+ },
+ $signature: 0
+ };
+ A._Future__asyncCompleteError_closure.prototype = {
+ call$0() {
+ this.$this._completeError$2(this.error, this.stackTrace);
+ },
+ $signature: 0
+ };
+ A._Future__propagateToListeners_handleWhenCompleteCallback.prototype = {
+ call$0() {
+ var e, s, t1, exception, t2, originalSource, _this = this, completeResult = null;
+ try {
+ t1 = _this._box_0.listener;
+ completeResult = t1.result._zone.run$1$1(type$.dynamic_Function._as(t1.callback), type$.dynamic);
+ } catch (exception) {
+ e = A.unwrapException(exception);
+ s = A.getTraceFromException(exception);
+ t1 = _this.hasError && type$.AsyncError._as(_this._box_1.source._resultOrListeners).error === e;
+ t2 = _this._box_0;
+ if (t1)
+ t2.listenerValueOrError = type$.AsyncError._as(_this._box_1.source._resultOrListeners);
+ else
+ t2.listenerValueOrError = A.AsyncError$(e, s);
+ t2.listenerHasError = true;
+ return;
+ }
+ if (completeResult instanceof A._Future && (completeResult._async$_state & 24) !== 0) {
+ if ((completeResult._async$_state & 16) !== 0) {
+ t1 = _this._box_0;
+ t1.listenerValueOrError = type$.AsyncError._as(completeResult._resultOrListeners);
+ t1.listenerHasError = true;
+ }
+ return;
+ }
+ if (completeResult instanceof A._Future) {
+ originalSource = _this._box_1.source;
+ t1 = _this._box_0;
+ t1.listenerValueOrError = completeResult.then$1$1(new A._Future__propagateToListeners_handleWhenCompleteCallback_closure(originalSource), type$.dynamic);
+ t1.listenerHasError = false;
+ }
+ },
+ $signature: 0
+ };
+ A._Future__propagateToListeners_handleWhenCompleteCallback_closure.prototype = {
+ call$1(_) {
+ return this.originalSource;
+ },
+ $signature: 28
+ };
+ A._Future__propagateToListeners_handleValueCallback.prototype = {
+ call$0() {
+ var e, s, t1, t2, t3, t4, t5, exception;
+ try {
+ t1 = this._box_0;
+ t2 = t1.listener;
+ t3 = t2.$ti;
+ t4 = t3._precomputed1;
+ t5 = t4._as(this.sourceResult);
+ t1.listenerValueOrError = t2.result._zone.runUnary$2$2(t3._eval$1("2/(1)")._as(t2.callback), t5, t3._eval$1("2/"), t4);
+ } catch (exception) {
+ e = A.unwrapException(exception);
+ s = A.getTraceFromException(exception);
+ t1 = this._box_0;
+ t1.listenerValueOrError = A.AsyncError$(e, s);
+ t1.listenerHasError = true;
+ }
+ },
+ $signature: 0
+ };
+ A._Future__propagateToListeners_handleError.prototype = {
+ call$0() {
+ var asyncError, e, s, t1, exception, t2, _this = this;
+ try {
+ asyncError = type$.AsyncError._as(_this._box_1.source._resultOrListeners);
+ t1 = _this._box_0;
+ if (t1.listener.matchesErrorTest$1(asyncError) && t1.listener.errorCallback != null) {
+ t1.listenerValueOrError = t1.listener.handleError$1(asyncError);
+ t1.listenerHasError = false;
+ }
+ } catch (exception) {
+ e = A.unwrapException(exception);
+ s = A.getTraceFromException(exception);
+ t1 = type$.AsyncError._as(_this._box_1.source._resultOrListeners);
+ t2 = _this._box_0;
+ if (t1.error === e)
+ t2.listenerValueOrError = t1;
+ else
+ t2.listenerValueOrError = A.AsyncError$(e, s);
+ t2.listenerHasError = true;
+ }
+ },
+ $signature: 0
+ };
+ A._AsyncCallbackEntry.prototype = {};
+ A.Stream.prototype = {
+ pipe$1(streamConsumer) {
+ A._instanceType(this)._eval$1("StreamConsumer<Stream.T>")._as(streamConsumer);
+ return streamConsumer.addStream$1(0, this).then$1$1(new A.Stream_pipe_closure(streamConsumer), type$.dynamic);
+ },
+ get$length(_) {
+ var t1 = {},
+ future = new A._Future($.Zone__current, type$._Future_int);
+ t1.count = 0;
+ this.listen$4$cancelOnError$onDone$onError(new A.Stream_length_closure(t1, this), true, new A.Stream_length_closure0(t1, future), future.get$_completeError());
+ return future;
+ }
+ };
+ A.Stream_pipe_closure.prototype = {
+ call$1(_) {
+ return this.streamConsumer.close$0(0);
+ },
+ $signature: 29
+ };
+ A.Stream_length_closure.prototype = {
+ call$1(_) {
+ A._instanceType(this.$this)._eval$1("Stream.T")._as(_);
+ ++this._box_0.count;
+ },
+ $signature() {
+ return A._instanceType(this.$this)._eval$1("~(Stream.T)");
+ }
+ };
+ A.Stream_length_closure0.prototype = {
+ call$0() {
+ this.future._complete$1(this._box_0.count);
+ },
+ $signature: 0
+ };
+ A._StreamController.prototype = {
+ get$_pendingEvents() {
+ var t1, _this = this;
+ if ((_this._async$_state & 8) === 0)
+ return A._instanceType(_this)._eval$1("_PendingEvents<1>?")._as(_this._varData);
+ t1 = A._instanceType(_this);
+ return t1._eval$1("_PendingEvents<1>?")._as(t1._eval$1("_StreamControllerAddStreamState<1>")._as(_this._varData).varData);
+ },
+ _ensurePendingEvents$0() {
+ var events, t1, state, _this = this;
+ if ((_this._async$_state & 8) === 0) {
+ events = _this._varData;
+ if (events == null)
+ events = _this._varData = new A._PendingEvents(A._instanceType(_this)._eval$1("_PendingEvents<1>"));
+ return A._instanceType(_this)._eval$1("_PendingEvents<1>")._as(events);
+ }
+ t1 = A._instanceType(_this);
+ state = t1._eval$1("_StreamControllerAddStreamState<1>")._as(_this._varData);
+ events = state.varData;
+ if (events == null)
+ events = state.varData = new A._PendingEvents(t1._eval$1("_PendingEvents<1>"));
+ return t1._eval$1("_PendingEvents<1>")._as(events);
+ },
+ get$_async$_subscription() {
+ var varData = this._varData;
+ if ((this._async$_state & 8) !== 0)
+ varData = type$._StreamControllerAddStreamState_nullable_Object._as(varData).varData;
+ return A._instanceType(this)._eval$1("_ControllerSubscription<1>")._as(varData);
+ },
+ _badEventState$0() {
+ if ((this._async$_state & 4) !== 0)
+ return new A.StateError("Cannot add event after closing");
+ return new A.StateError("Cannot add event while adding a stream");
+ },
+ _ensureDoneFuture$0() {
+ var t1 = this._doneFuture;
+ if (t1 == null)
+ t1 = this._doneFuture = (this._async$_state & 2) !== 0 ? $.$get$Future__nullFuture() : new A._Future($.Zone__current, type$._Future_void);
+ return t1;
+ },
+ add$1(_, value) {
+ var _this = this;
+ A._instanceType(_this)._precomputed1._as(value);
+ if (_this._async$_state >= 4)
+ throw A.wrapException(_this._badEventState$0());
+ _this._add$1(0, value);
+ },
+ addError$2(error, stackTrace) {
+ var replacement,
+ t1 = type$.Object;
+ t1._as(error);
+ type$.nullable_StackTrace._as(stackTrace);
+ A.checkNotNullable(error, "error", t1);
+ if (this._async$_state >= 4)
+ throw A.wrapException(this._badEventState$0());
+ replacement = $.Zone__current.errorCallback$2(error, stackTrace);
+ if (replacement != null) {
+ error = replacement.error;
+ stackTrace = replacement.stackTrace;
+ } else if (stackTrace == null)
+ stackTrace = A.AsyncError_defaultStackTrace(error);
+ this._async$_addError$2(error, stackTrace);
+ },
+ addError$1(error) {
+ return this.addError$2(error, null);
+ },
+ close$0(_) {
+ var _this = this,
+ t1 = _this._async$_state;
+ if ((t1 & 4) !== 0)
+ return _this._ensureDoneFuture$0();
+ if (t1 >= 4)
+ throw A.wrapException(_this._badEventState$0());
+ t1 = _this._async$_state = t1 | 4;
+ if ((t1 & 1) !== 0)
+ _this._sendDone$0();
+ else if ((t1 & 3) === 0)
+ _this._ensurePendingEvents$0().add$1(0, B.C__DelayedDone);
+ return _this._ensureDoneFuture$0();
+ },
+ _add$1(_, value) {
+ var t2, _this = this,
+ t1 = A._instanceType(_this);
+ t1._precomputed1._as(value);
+ t2 = _this._async$_state;
+ if ((t2 & 1) !== 0)
+ _this._sendData$1(value);
+ else if ((t2 & 3) === 0)
+ _this._ensurePendingEvents$0().add$1(0, new A._DelayedData(value, t1._eval$1("_DelayedData<1>")));
+ },
+ _async$_addError$2(error, stackTrace) {
+ var t1 = this._async$_state;
+ if ((t1 & 1) !== 0)
+ this._sendError$2(error, stackTrace);
+ else if ((t1 & 3) === 0)
+ this._ensurePendingEvents$0().add$1(0, new A._DelayedError(error, stackTrace));
+ },
+ _subscribe$4(onData, onError, onDone, cancelOnError) {
+ var t2, t3, t4, t5, t6, subscription, pendingEvents, addState, _this = this,
+ t1 = A._instanceType(_this);
+ t1._eval$1("~(1)?")._as(onData);
+ type$.nullable_void_Function._as(onDone);
+ if ((_this._async$_state & 3) !== 0)
+ throw A.wrapException(A.StateError$("Stream has already been listened to."));
+ t2 = $.Zone__current;
+ t3 = cancelOnError ? 1 : 0;
+ t4 = A._BufferingStreamSubscription__registerDataHandler(t2, onData, t1._precomputed1);
+ t5 = A._BufferingStreamSubscription__registerErrorHandler(t2, onError);
+ t6 = onDone == null ? A.async___nullDoneHandler$closure() : onDone;
+ subscription = new A._ControllerSubscription(_this, t4, t5, t2.registerCallback$1$1(t6, type$.void), t2, t3, t1._eval$1("_ControllerSubscription<1>"));
+ pendingEvents = _this.get$_pendingEvents();
+ t3 = _this._async$_state |= 1;
+ if ((t3 & 8) !== 0) {
+ addState = t1._eval$1("_StreamControllerAddStreamState<1>")._as(_this._varData);
+ addState.varData = subscription;
+ addState.addSubscription.resume$0(0);
+ } else
+ _this._varData = subscription;
+ subscription._setPendingEvents$1(pendingEvents);
+ subscription._guardCallback$1(new A._StreamController__subscribe_closure(_this));
+ return subscription;
+ },
+ _recordCancel$1(subscription) {
+ var result, onCancel, cancelResult, e, s, exception, result0, _this = this,
+ t1 = A._instanceType(_this);
+ t1._eval$1("StreamSubscription<1>")._as(subscription);
+ result = null;
+ if ((_this._async$_state & 8) !== 0)
+ result = t1._eval$1("_StreamControllerAddStreamState<1>")._as(_this._varData).cancel$0(0);
+ _this._varData = null;
+ _this._async$_state = _this._async$_state & 4294967286 | 2;
+ onCancel = _this.onCancel;
+ if (onCancel != null)
+ if (result == null)
+ try {
+ cancelResult = onCancel.call$0();
+ if (cancelResult instanceof A._Future)
+ result = cancelResult;
+ } catch (exception) {
+ e = A.unwrapException(exception);
+ s = A.getTraceFromException(exception);
+ result0 = new A._Future($.Zone__current, type$._Future_void);
+ result0._asyncCompleteError$2(e, s);
+ result = result0;
+ }
+ else
+ result = result.whenComplete$1(onCancel);
+ t1 = new A._StreamController__recordCancel_complete(_this);
+ if (result != null)
+ result = result.whenComplete$1(t1);
+ else
+ t1.call$0();
+ return result;
+ },
+ $isStreamConsumer: 1,
+ $isStreamSink: 1,
+ $isStreamController: 1,
+ $is_StreamControllerLifecycle: 1,
+ $is_EventDispatch: 1
+ };
+ A._StreamController__subscribe_closure.prototype = {
+ call$0() {
+ A._runGuarded(this.$this.onListen);
+ },
+ $signature: 0
+ };
+ A._StreamController__recordCancel_complete.prototype = {
+ call$0() {
+ var doneFuture = this.$this._doneFuture;
+ if (doneFuture != null && (doneFuture._async$_state & 30) === 0)
+ doneFuture._asyncComplete$1(null);
+ },
+ $signature: 0
+ };
+ A._SyncStreamControllerDispatch.prototype = {
+ _sendData$1(data) {
+ this.$ti._precomputed1._as(data);
+ this.get$_async$_subscription()._add$1(0, data);
+ },
+ _sendError$2(error, stackTrace) {
+ this.get$_async$_subscription()._async$_addError$2(error, stackTrace);
+ },
+ _sendDone$0() {
+ this.get$_async$_subscription()._close$0();
+ }
+ };
+ A._SyncStreamController.prototype = {};
+ A._ControllerStream.prototype = {
+ get$hashCode(_) {
+ return (A.Primitives_objectHashCode(this._controller) ^ 892482866) >>> 0;
+ },
+ $eq(_, other) {
+ if (other == null)
+ return false;
+ if (this === other)
+ return true;
+ return other instanceof A._ControllerStream && other._controller === this._controller;
+ }
+ };
+ A._ControllerSubscription.prototype = {
+ _onCancel$0() {
+ return this._controller._recordCancel$1(this);
+ },
+ _onPause$0() {
+ var t1 = this._controller,
+ t2 = A._instanceType(t1);
+ t2._eval$1("StreamSubscription<1>")._as(this);
+ if ((t1._async$_state & 8) !== 0)
+ t2._eval$1("_StreamControllerAddStreamState<1>")._as(t1._varData).addSubscription.pause$0(0);
+ A._runGuarded(t1.onPause);
+ },
+ _onResume$0() {
+ var t1 = this._controller,
+ t2 = A._instanceType(t1);
+ t2._eval$1("StreamSubscription<1>")._as(this);
+ if ((t1._async$_state & 8) !== 0)
+ t2._eval$1("_StreamControllerAddStreamState<1>")._as(t1._varData).addSubscription.resume$0(0);
+ A._runGuarded(t1.onResume);
+ }
+ };
+ A._StreamSinkWrapper.prototype = {
+ add$1(_, data) {
+ this._target.add$1(0, this.$ti._precomputed1._as(data));
+ },
+ $isStreamConsumer: 1,
+ $isStreamSink: 1
+ };
+ A._AddStreamState_cancel_closure.prototype = {
+ call$0() {
+ this.$this.addStreamFuture._asyncComplete$1(null);
+ },
+ $signature: 3
+ };
+ A._BufferingStreamSubscription.prototype = {
+ _setPendingEvents$1(pendingEvents) {
+ var _this = this;
+ A._instanceType(_this)._eval$1("_PendingEvents<_BufferingStreamSubscription.T>?")._as(pendingEvents);
+ if (pendingEvents == null)
+ return;
+ _this.set$_pending(pendingEvents);
+ if (pendingEvents.lastPendingEvent != null) {
+ _this._async$_state = (_this._async$_state | 64) >>> 0;
+ pendingEvents.schedule$1(_this);
+ }
+ },
+ onData$1(handleData) {
+ var t1 = A._instanceType(this);
+ this.set$_onData(A._BufferingStreamSubscription__registerDataHandler(this._zone, t1._eval$1("~(_BufferingStreamSubscription.T)?")._as(handleData), t1._eval$1("_BufferingStreamSubscription.T")));
+ },
+ onError$1(_, handleError) {
+ this._onError = A._BufferingStreamSubscription__registerErrorHandler(this._zone, handleError);
+ },
+ cancel$0(_) {
+ var _this = this,
+ t1 = (_this._async$_state & 4294967279) >>> 0;
+ _this._async$_state = t1;
+ if ((t1 & 8) === 0)
+ _this._cancel$0();
+ t1 = _this._cancelFuture;
+ return t1 == null ? $.$get$Future__nullFuture() : t1;
+ },
+ _cancel$0() {
+ var t2, _this = this,
+ t1 = _this._async$_state = (_this._async$_state | 8) >>> 0;
+ if ((t1 & 64) !== 0) {
+ t2 = _this._pending;
+ if (t2._async$_state === 1)
+ t2._async$_state = 3;
+ }
+ if ((t1 & 32) === 0)
+ _this.set$_pending(null);
+ _this._cancelFuture = _this._onCancel$0();
+ },
+ _add$1(_, data) {
+ var t2, _this = this,
+ t1 = A._instanceType(_this);
+ t1._eval$1("_BufferingStreamSubscription.T")._as(data);
+ t2 = _this._async$_state;
+ if ((t2 & 8) !== 0)
+ return;
+ if (t2 < 32)
+ _this._sendData$1(data);
+ else
+ _this._addPending$1(new A._DelayedData(data, t1._eval$1("_DelayedData<_BufferingStreamSubscription.T>")));
+ },
+ _async$_addError$2(error, stackTrace) {
+ var t1 = this._async$_state;
+ if ((t1 & 8) !== 0)
+ return;
+ if (t1 < 32)
+ this._sendError$2(error, stackTrace);
+ else
+ this._addPending$1(new A._DelayedError(error, stackTrace));
+ },
+ _close$0() {
+ var _this = this,
+ t1 = _this._async$_state;
+ if ((t1 & 8) !== 0)
+ return;
+ t1 = (t1 | 2) >>> 0;
+ _this._async$_state = t1;
+ if (t1 < 32)
+ _this._sendDone$0();
+ else
+ _this._addPending$1(B.C__DelayedDone);
+ },
+ _onPause$0() {
+ },
+ _onResume$0() {
+ },
+ _onCancel$0() {
+ return null;
+ },
+ _addPending$1($event) {
+ var t1, _this = this,
+ pending = _this._pending;
+ if (pending == null) {
+ pending = new A._PendingEvents(A._instanceType(_this)._eval$1("_PendingEvents<_BufferingStreamSubscription.T>"));
+ _this.set$_pending(pending);
+ }
+ pending.add$1(0, $event);
+ t1 = _this._async$_state;
+ if ((t1 & 64) === 0) {
+ t1 = (t1 | 64) >>> 0;
+ _this._async$_state = t1;
+ if (t1 < 128)
+ pending.schedule$1(_this);
+ }
+ },
+ _sendData$1(data) {
+ var t2, _this = this,
+ t1 = A._instanceType(_this)._eval$1("_BufferingStreamSubscription.T");
+ t1._as(data);
+ t2 = _this._async$_state;
+ _this._async$_state = (t2 | 32) >>> 0;
+ _this._zone.runUnaryGuarded$1$2(_this._onData, data, t1);
+ _this._async$_state = (_this._async$_state & 4294967263) >>> 0;
+ _this._checkState$1((t2 & 4) !== 0);
+ },
+ _sendError$2(error, stackTrace) {
+ var cancelFuture, _this = this,
+ t1 = _this._async$_state,
+ t2 = new A._BufferingStreamSubscription__sendError_sendError(_this, error, stackTrace);
+ if ((t1 & 1) !== 0) {
+ _this._async$_state = (t1 | 16) >>> 0;
+ _this._cancel$0();
+ cancelFuture = _this._cancelFuture;
+ if (cancelFuture != null && cancelFuture !== $.$get$Future__nullFuture())
+ cancelFuture.whenComplete$1(t2);
+ else
+ t2.call$0();
+ } else {
+ t2.call$0();
+ _this._checkState$1((t1 & 4) !== 0);
+ }
+ },
+ _sendDone$0() {
+ var cancelFuture, _this = this,
+ t1 = new A._BufferingStreamSubscription__sendDone_sendDone(_this);
+ _this._cancel$0();
+ _this._async$_state = (_this._async$_state | 16) >>> 0;
+ cancelFuture = _this._cancelFuture;
+ if (cancelFuture != null && cancelFuture !== $.$get$Future__nullFuture())
+ cancelFuture.whenComplete$1(t1);
+ else
+ t1.call$0();
+ },
+ _guardCallback$1(callback) {
+ var t1, _this = this;
+ type$.void_Function._as(callback);
+ t1 = _this._async$_state;
+ _this._async$_state = (t1 | 32) >>> 0;
+ callback.call$0();
+ _this._async$_state = (_this._async$_state & 4294967263) >>> 0;
+ _this._checkState$1((t1 & 4) !== 0);
+ },
+ _checkState$1(wasInputPaused) {
+ var t2, isInputPaused, _this = this,
+ t1 = _this._async$_state;
+ if ((t1 & 64) !== 0 && _this._pending.lastPendingEvent == null) {
+ t1 = _this._async$_state = (t1 & 4294967231) >>> 0;
+ if ((t1 & 4) !== 0)
+ if (t1 < 128) {
+ t2 = _this._pending;
+ t2 = t2 == null ? null : t2.lastPendingEvent == null;
+ t2 = t2 !== false;
+ } else
+ t2 = false;
+ else
+ t2 = false;
+ if (t2) {
+ t1 = (t1 & 4294967291) >>> 0;
+ _this._async$_state = t1;
+ }
+ }
+ for (; true; wasInputPaused = isInputPaused) {
+ if ((t1 & 8) !== 0) {
+ _this.set$_pending(null);
+ return;
+ }
+ isInputPaused = (t1 & 4) !== 0;
+ if (wasInputPaused === isInputPaused)
+ break;
+ _this._async$_state = (t1 ^ 32) >>> 0;
+ if (isInputPaused)
+ _this._onPause$0();
+ else
+ _this._onResume$0();
+ t1 = (_this._async$_state & 4294967263) >>> 0;
+ _this._async$_state = t1;
+ }
+ if ((t1 & 64) !== 0 && t1 < 128)
+ _this._pending.schedule$1(_this);
+ },
+ set$_onData(_onData) {
+ this._onData = A._instanceType(this)._eval$1("~(_BufferingStreamSubscription.T)")._as(_onData);
+ },
+ set$_pending(_pending) {
+ this._pending = A._instanceType(this)._eval$1("_PendingEvents<_BufferingStreamSubscription.T>?")._as(_pending);
+ },
+ $isStreamSubscription: 1,
+ $is_EventDispatch: 1
+ };
+ A._BufferingStreamSubscription__sendError_sendError.prototype = {
+ call$0() {
+ var onError, t3, t4,
+ t1 = this.$this,
+ t2 = t1._async$_state;
+ if ((t2 & 8) !== 0 && (t2 & 16) === 0)
+ return;
+ t1._async$_state = (t2 | 32) >>> 0;
+ onError = t1._onError;
+ t2 = this.error;
+ t3 = type$.Object;
+ t4 = t1._zone;
+ if (type$.void_Function_Object_StackTrace._is(onError))
+ t4.runBinaryGuarded$2$3(onError, t2, this.stackTrace, t3, type$.StackTrace);
+ else
+ t4.runUnaryGuarded$1$2(type$.void_Function_Object._as(onError), t2, t3);
+ t1._async$_state = (t1._async$_state & 4294967263) >>> 0;
+ },
+ $signature: 0
+ };
+ A._BufferingStreamSubscription__sendDone_sendDone.prototype = {
+ call$0() {
+ var t1 = this.$this,
+ t2 = t1._async$_state;
+ if ((t2 & 16) === 0)
+ return;
+ t1._async$_state = (t2 | 42) >>> 0;
+ t1._zone.runGuarded$1(t1._onDone);
+ t1._async$_state = (t1._async$_state & 4294967263) >>> 0;
+ },
+ $signature: 0
+ };
+ A._StreamImpl.prototype = {
+ listen$4$cancelOnError$onDone$onError(onData, cancelOnError, onDone, onError) {
+ var t1 = this.$ti;
+ t1._eval$1("~(1)?")._as(onData);
+ type$.nullable_void_Function._as(onDone);
+ return this._controller._subscribe$4(t1._eval$1("~(1)?")._as(onData), onError, onDone, cancelOnError === true);
+ },
+ listen$1(onData) {
+ return this.listen$4$cancelOnError$onDone$onError(onData, null, null, null);
+ },
+ listen$3$onDone$onError(onData, onDone, onError) {
+ return this.listen$4$cancelOnError$onDone$onError(onData, null, onDone, onError);
+ },
+ listen$2$onDone(onData, onDone) {
+ return this.listen$4$cancelOnError$onDone$onError(onData, null, onDone, null);
+ },
+ listen$3$cancelOnError$onDone(onData, cancelOnError, onDone) {
+ return this.listen$4$cancelOnError$onDone$onError(onData, cancelOnError, onDone, null);
+ }
+ };
+ A._DelayedEvent.prototype = {
+ set$next(_, next) {
+ this.next = type$.nullable__DelayedEvent_dynamic._as(next);
+ },
+ get$next(receiver) {
+ return this.next;
+ }
+ };
+ A._DelayedData.prototype = {
+ perform$1(dispatch) {
+ this.$ti._eval$1("_EventDispatch<1>")._as(dispatch)._sendData$1(this.value);
+ }
+ };
+ A._DelayedError.prototype = {
+ perform$1(dispatch) {
+ dispatch._sendError$2(this.error, this.stackTrace);
+ }
+ };
+ A._DelayedDone.prototype = {
+ perform$1(dispatch) {
+ dispatch._sendDone$0();
+ },
+ get$next(_) {
+ return null;
+ },
+ set$next(_, _0) {
+ throw A.wrapException(A.StateError$("No events after a done."));
+ },
+ $is_DelayedEvent: 1
+ };
+ A._PendingEvents.prototype = {
+ schedule$1(dispatch) {
+ var t1, _this = this;
+ _this.$ti._eval$1("_EventDispatch<1>")._as(dispatch);
+ t1 = _this._async$_state;
+ if (t1 === 1)
+ return;
+ if (t1 >= 1) {
+ _this._async$_state = 1;
+ return;
+ }
+ A.scheduleMicrotask(new A._PendingEvents_schedule_closure(_this, dispatch));
+ _this._async$_state = 1;
+ },
+ add$1(_, $event) {
+ var _this = this,
+ lastEvent = _this.lastPendingEvent;
+ if (lastEvent == null)
+ _this.firstPendingEvent = _this.lastPendingEvent = $event;
+ else {
+ lastEvent.set$next(0, $event);
+ _this.lastPendingEvent = $event;
+ }
+ }
+ };
+ A._PendingEvents_schedule_closure.prototype = {
+ call$0() {
+ var t2, $event, nextEvent,
+ t1 = this.$this,
+ oldState = t1._async$_state;
+ t1._async$_state = 0;
+ if (oldState === 3)
+ return;
+ t2 = t1.$ti._eval$1("_EventDispatch<1>")._as(this.dispatch);
+ $event = t1.firstPendingEvent;
+ nextEvent = $event.get$next($event);
+ t1.firstPendingEvent = nextEvent;
+ if (nextEvent == null)
+ t1.lastPendingEvent = null;
+ $event.perform$1(t2);
+ },
+ $signature: 0
+ };
+ A._DoneStreamSubscription.prototype = {
+ onData$1(handleData) {
+ this.$ti._eval$1("~(1)?")._as(handleData);
+ },
+ onError$1(_, handleError) {
+ },
+ cancel$0(_) {
+ this._async$_state = -1;
+ this.set$_onDone(null);
+ return $.$get$Future__nullFuture();
+ },
+ _onMicrotask$0() {
+ var _0_0, doneHandler, t1, _this = this,
+ unscheduledState = _this._async$_state - 1;
+ if (unscheduledState === 0) {
+ _this._async$_state = -1;
+ _0_0 = _this._onDone;
+ if (_0_0 != null) {
+ doneHandler = _0_0;
+ t1 = true;
+ } else {
+ doneHandler = null;
+ t1 = false;
+ }
+ if (t1) {
+ _this.set$_onDone(null);
+ _this._zone.runGuarded$1(doneHandler);
+ }
+ } else
+ _this._async$_state = unscheduledState;
+ },
+ set$_onDone(_onDone) {
+ this._onDone = type$.nullable_void_Function._as(_onDone);
+ },
+ $isStreamSubscription: 1
+ };
+ A._EmptyStream.prototype = {
+ listen$4$cancelOnError$onDone$onError(onData, cancelOnError, onDone, onError) {
+ var t2,
+ t1 = this.$ti;
+ t1._eval$1("~(1)?")._as(onData);
+ type$.nullable_void_Function._as(onDone);
+ t2 = $.Zone__current;
+ t1 = new A._DoneStreamSubscription(t2, t1._eval$1("_DoneStreamSubscription<1>"));
+ A.scheduleMicrotask(t1.get$_onMicrotask());
+ if (onDone != null)
+ t1.set$_onDone(t2.registerCallback$1$1(onDone, type$.void));
+ return t1;
+ },
+ listen$1(onData) {
+ return this.listen$4$cancelOnError$onDone$onError(onData, null, null, null);
+ },
+ listen$3$onDone$onError(onData, onDone, onError) {
+ return this.listen$4$cancelOnError$onDone$onError(onData, null, onDone, onError);
+ },
+ listen$3$cancelOnError$onDone(onData, cancelOnError, onDone) {
+ return this.listen$4$cancelOnError$onDone$onError(onData, cancelOnError, onDone, null);
+ }
+ };
+ A._ZoneFunction.prototype = {};
+ A._ZoneSpecification.prototype = {$isZoneSpecification: 1};
+ A._ZoneDelegate.prototype = {$isZoneDelegate: 1};
+ A._Zone.prototype = {
+ _processUncaughtError$3(zone, error, stackTrace) {
+ var implZone, handler, parentDelegate, parentZone, currentZone, e, s, implementation, t1, exception;
+ type$.StackTrace._as(stackTrace);
+ implementation = this.get$_handleUncaughtError();
+ implZone = implementation.zone;
+ if (implZone === B.C__RootZone) {
+ A._rootHandleError(error, stackTrace);
+ return;
+ }
+ handler = implementation.$function;
+ parentDelegate = implZone.get$_parentDelegate();
+ t1 = J.get$parent$z(implZone);
+ t1.toString;
+ parentZone = t1;
+ currentZone = $.Zone__current;
+ try {
+ $.Zone__current = parentZone;
+ handler.call$5(implZone, parentDelegate, zone, error, stackTrace);
+ $.Zone__current = currentZone;
+ } catch (exception) {
+ e = A.unwrapException(exception);
+ s = A.getTraceFromException(exception);
+ $.Zone__current = currentZone;
+ t1 = error === e ? stackTrace : s;
+ parentZone._processUncaughtError$3(implZone, e, t1);
+ }
+ },
+ $isZone: 1
+ };
+ A._CustomZone.prototype = {
+ get$_delegate() {
+ var t1 = this._delegateCache;
+ return t1 == null ? this._delegateCache = new A._ZoneDelegate(this) : t1;
+ },
+ get$_parentDelegate() {
+ return this.parent.get$_delegate();
+ },
+ get$errorZone() {
+ return this._handleUncaughtError.zone;
+ },
+ runGuarded$1(f) {
+ var e, s, exception;
+ type$.void_Function._as(f);
+ try {
+ this.run$1$1(f, type$.void);
+ } catch (exception) {
+ e = A.unwrapException(exception);
+ s = A.getTraceFromException(exception);
+ this._processUncaughtError$3(this, type$.Object._as(e), type$.StackTrace._as(s));
+ }
+ },
+ runUnaryGuarded$1$2(f, arg, $T) {
+ var e, s, exception;
+ $T._eval$1("~(0)")._as(f);
+ $T._as(arg);
+ try {
+ this.runUnary$2$2(f, arg, type$.void, $T);
+ } catch (exception) {
+ e = A.unwrapException(exception);
+ s = A.getTraceFromException(exception);
+ this._processUncaughtError$3(this, type$.Object._as(e), type$.StackTrace._as(s));
+ }
+ },
+ runBinaryGuarded$2$3(f, arg1, arg2, T1, T2) {
+ var e, s, exception;
+ T1._eval$1("@<0>")._bind$1(T2)._eval$1("~(1,2)")._as(f);
+ T1._as(arg1);
+ T2._as(arg2);
+ try {
+ this.runBinary$3$3(f, arg1, arg2, type$.void, T1, T2);
+ } catch (exception) {
+ e = A.unwrapException(exception);
+ s = A.getTraceFromException(exception);
+ this._processUncaughtError$3(this, type$.Object._as(e), type$.StackTrace._as(s));
+ }
+ },
+ bindCallback$1$1(f, $R) {
+ return new A._CustomZone_bindCallback_closure(this, this.registerCallback$1$1($R._eval$1("0()")._as(f), $R), $R);
+ },
+ bindUnaryCallback$2$1(f, $R, $T) {
+ return new A._CustomZone_bindUnaryCallback_closure(this, this.registerUnaryCallback$2$1($R._eval$1("@<0>")._bind$1($T)._eval$1("1(2)")._as(f), $R, $T), $T, $R);
+ },
+ bindCallbackGuarded$1(f) {
+ return new A._CustomZone_bindCallbackGuarded_closure(this, this.registerCallback$1$1(type$.void_Function._as(f), type$.void));
+ },
+ bindUnaryCallbackGuarded$1$1(f, $T) {
+ return new A._CustomZone_bindUnaryCallbackGuarded_closure(this, this.registerUnaryCallback$2$1($T._eval$1("~(0)")._as(f), type$.void, $T), $T);
+ },
+ handleUncaughtError$2(error, stackTrace) {
+ this._processUncaughtError$3(this, error, type$.StackTrace._as(stackTrace));
+ },
+ fork$2$specification$zoneValues(specification, zoneValues) {
+ var implementation = this._fork,
+ t1 = implementation.zone;
+ return implementation.$function.call$5(t1, t1.get$_parentDelegate(), this, specification, zoneValues);
+ },
+ run$1$1(f, $R) {
+ var implementation, t1;
+ $R._eval$1("0()")._as(f);
+ implementation = this._run;
+ t1 = implementation.zone;
+ return implementation.$function.call$1$4(t1, t1.get$_parentDelegate(), this, f, $R);
+ },
+ runUnary$2$2(f, arg, $R, $T) {
+ var implementation, t1;
+ $R._eval$1("@<0>")._bind$1($T)._eval$1("1(2)")._as(f);
+ $T._as(arg);
+ implementation = this._runUnary;
+ t1 = implementation.zone;
+ return implementation.$function.call$2$5(t1, t1.get$_parentDelegate(), this, f, arg, $R, $T);
+ },
+ runBinary$3$3(f, arg1, arg2, $R, T1, T2) {
+ var implementation, t1;
+ $R._eval$1("@<0>")._bind$1(T1)._bind$1(T2)._eval$1("1(2,3)")._as(f);
+ T1._as(arg1);
+ T2._as(arg2);
+ implementation = this._runBinary;
+ t1 = implementation.zone;
+ return implementation.$function.call$3$6(t1, t1.get$_parentDelegate(), this, f, arg1, arg2, $R, T1, T2);
+ },
+ registerCallback$1$1(callback, $R) {
+ var implementation, t1;
+ $R._eval$1("0()")._as(callback);
+ implementation = this._registerCallback;
+ t1 = implementation.zone;
+ return implementation.$function.call$1$4(t1, t1.get$_parentDelegate(), this, callback, $R);
+ },
+ registerUnaryCallback$2$1(callback, $R, $T) {
+ var implementation, t1;
+ $R._eval$1("@<0>")._bind$1($T)._eval$1("1(2)")._as(callback);
+ implementation = this._registerUnaryCallback;
+ t1 = implementation.zone;
+ return implementation.$function.call$2$4(t1, t1.get$_parentDelegate(), this, callback, $R, $T);
+ },
+ registerBinaryCallback$3$1(callback, $R, T1, T2) {
+ var implementation, t1;
+ $R._eval$1("@<0>")._bind$1(T1)._bind$1(T2)._eval$1("1(2,3)")._as(callback);
+ implementation = this._registerBinaryCallback;
+ t1 = implementation.zone;
+ return implementation.$function.call$3$4(t1, t1.get$_parentDelegate(), this, callback, $R, T1, T2);
+ },
+ errorCallback$2(error, stackTrace) {
+ var implementation, implementationZone;
+ A.checkNotNullable(error, "error", type$.Object);
+ implementation = this._errorCallback;
+ implementationZone = implementation.zone;
+ if (implementationZone === B.C__RootZone)
+ return null;
+ return implementation.$function.call$5(implementationZone, implementationZone.get$_parentDelegate(), this, error, stackTrace);
+ },
+ scheduleMicrotask$1(f) {
+ var implementation, t1;
+ type$.void_Function._as(f);
+ implementation = this._scheduleMicrotask;
+ t1 = implementation.zone;
+ return implementation.$function.call$4(t1, t1.get$_parentDelegate(), this, f);
+ },
+ createPeriodicTimer$2(duration, f) {
+ var implementation, t1;
+ type$.void_Function_Timer._as(f);
+ implementation = this._createPeriodicTimer;
+ t1 = implementation.zone;
+ return implementation.$function.call$5(t1, t1.get$_parentDelegate(), this, duration, f);
+ },
+ set$_handleUncaughtError(_handleUncaughtError) {
+ this._handleUncaughtError = type$._ZoneFunction_of_void_Function_Zone_ZoneDelegate_Zone_Object_StackTrace._as(_handleUncaughtError);
+ },
+ get$_run() {
+ return this._run;
+ },
+ get$_runUnary() {
+ return this._runUnary;
+ },
+ get$_runBinary() {
+ return this._runBinary;
+ },
+ get$_registerCallback() {
+ return this._registerCallback;
+ },
+ get$_registerUnaryCallback() {
+ return this._registerUnaryCallback;
+ },
+ get$_registerBinaryCallback() {
+ return this._registerBinaryCallback;
+ },
+ get$_errorCallback() {
+ return this._errorCallback;
+ },
+ get$_scheduleMicrotask() {
+ return this._scheduleMicrotask;
+ },
+ get$_createTimer() {
+ return this._createTimer;
+ },
+ get$_createPeriodicTimer() {
+ return this._createPeriodicTimer;
+ },
+ get$_print() {
+ return this._print;
+ },
+ get$_fork() {
+ return this._fork;
+ },
+ get$_handleUncaughtError() {
+ return this._handleUncaughtError;
+ },
+ get$parent(receiver) {
+ return this.parent;
+ },
+ get$_async$_map() {
+ return this._async$_map;
+ }
+ };
+ A._CustomZone_bindCallback_closure.prototype = {
+ call$0() {
+ return this.$this.run$1$1(this.registered, this.R);
+ },
+ $signature() {
+ return this.R._eval$1("0()");
+ }
+ };
+ A._CustomZone_bindUnaryCallback_closure.prototype = {
+ call$1(arg) {
+ var _this = this,
+ t1 = _this.T;
+ return _this.$this.runUnary$2$2(_this.registered, t1._as(arg), _this.R, t1);
+ },
+ $signature() {
+ return this.R._eval$1("@<0>")._bind$1(this.T)._eval$1("1(2)");
+ }
+ };
+ A._CustomZone_bindCallbackGuarded_closure.prototype = {
+ call$0() {
+ return this.$this.runGuarded$1(this.registered);
+ },
+ $signature: 0
+ };
+ A._CustomZone_bindUnaryCallbackGuarded_closure.prototype = {
+ call$1(arg) {
+ var t1 = this.T;
+ return this.$this.runUnaryGuarded$1$2(this.registered, t1._as(arg), t1);
+ },
+ $signature() {
+ return this.T._eval$1("~(0)");
+ }
+ };
+ A._rootHandleError_closure.prototype = {
+ call$0() {
+ A.Error_throwWithStackTrace(this.error, this.stackTrace);
+ },
+ $signature: 0
+ };
+ A._RootZone.prototype = {
+ get$_run() {
+ return B._ZoneFunction__RootZone__rootRun;
+ },
+ get$_runUnary() {
+ return B._ZoneFunction__RootZone__rootRunUnary;
+ },
+ get$_runBinary() {
+ return B._ZoneFunction__RootZone__rootRunBinary;
+ },
+ get$_registerCallback() {
+ return B._ZoneFunction__RootZone__rootRegisterCallback;
+ },
+ get$_registerUnaryCallback() {
+ return B._ZoneFunction_Eeh;
+ },
+ get$_registerBinaryCallback() {
+ return B._ZoneFunction_7G2;
+ },
+ get$_errorCallback() {
+ return B._ZoneFunction__RootZone__rootErrorCallback;
+ },
+ get$_scheduleMicrotask() {
+ return B._ZoneFunction__RootZone__rootScheduleMicrotask;
+ },
+ get$_createTimer() {
+ return B._ZoneFunction__RootZone__rootCreateTimer;
+ },
+ get$_createPeriodicTimer() {
+ return B._ZoneFunction_3bB;
+ },
+ get$_print() {
+ return B._ZoneFunction__RootZone__rootPrint;
+ },
+ get$_fork() {
+ return B._ZoneFunction__RootZone__rootFork;
+ },
+ get$_handleUncaughtError() {
+ return B._ZoneFunction_NMc;
+ },
+ get$parent(_) {
+ return null;
+ },
+ get$_async$_map() {
+ return $.$get$_RootZone__rootMap();
+ },
+ get$_delegate() {
+ var t1 = $._RootZone__rootDelegate;
+ return t1 == null ? $._RootZone__rootDelegate = new A._ZoneDelegate(this) : t1;
+ },
+ get$_parentDelegate() {
+ var t1 = $._RootZone__rootDelegate;
+ return t1 == null ? $._RootZone__rootDelegate = new A._ZoneDelegate(this) : t1;
+ },
+ get$errorZone() {
+ return this;
+ },
+ runGuarded$1(f) {
+ var e, s, exception;
+ type$.void_Function._as(f);
+ try {
+ if (B.C__RootZone === $.Zone__current) {
+ f.call$0();
+ return;
+ }
+ A._rootRun(null, null, this, f, type$.void);
+ } catch (exception) {
+ e = A.unwrapException(exception);
+ s = A.getTraceFromException(exception);
+ A._rootHandleError(type$.Object._as(e), type$.StackTrace._as(s));
+ }
+ },
+ runUnaryGuarded$1$2(f, arg, $T) {
+ var e, s, exception;
+ $T._eval$1("~(0)")._as(f);
+ $T._as(arg);
+ try {
+ if (B.C__RootZone === $.Zone__current) {
+ f.call$1(arg);
+ return;
+ }
+ A._rootRunUnary(null, null, this, f, arg, type$.void, $T);
+ } catch (exception) {
+ e = A.unwrapException(exception);
+ s = A.getTraceFromException(exception);
+ A._rootHandleError(type$.Object._as(e), type$.StackTrace._as(s));
+ }
+ },
+ runBinaryGuarded$2$3(f, arg1, arg2, T1, T2) {
+ var e, s, exception;
+ T1._eval$1("@<0>")._bind$1(T2)._eval$1("~(1,2)")._as(f);
+ T1._as(arg1);
+ T2._as(arg2);
+ try {
+ if (B.C__RootZone === $.Zone__current) {
+ f.call$2(arg1, arg2);
+ return;
+ }
+ A._rootRunBinary(null, null, this, f, arg1, arg2, type$.void, T1, T2);
+ } catch (exception) {
+ e = A.unwrapException(exception);
+ s = A.getTraceFromException(exception);
+ A._rootHandleError(type$.Object._as(e), type$.StackTrace._as(s));
+ }
+ },
+ bindCallback$1$1(f, $R) {
+ return new A._RootZone_bindCallback_closure(this, $R._eval$1("0()")._as(f), $R);
+ },
+ bindUnaryCallback$2$1(f, $R, $T) {
+ return new A._RootZone_bindUnaryCallback_closure(this, $R._eval$1("@<0>")._bind$1($T)._eval$1("1(2)")._as(f), $T, $R);
+ },
+ bindCallbackGuarded$1(f) {
+ return new A._RootZone_bindCallbackGuarded_closure(this, type$.void_Function._as(f));
+ },
+ bindUnaryCallbackGuarded$1$1(f, $T) {
+ return new A._RootZone_bindUnaryCallbackGuarded_closure(this, $T._eval$1("~(0)")._as(f), $T);
+ },
+ handleUncaughtError$2(error, stackTrace) {
+ A._rootHandleError(error, type$.StackTrace._as(stackTrace));
+ },
+ fork$2$specification$zoneValues(specification, zoneValues) {
+ return A._rootFork(null, null, this, specification, zoneValues);
+ },
+ run$1$1(f, $R) {
+ $R._eval$1("0()")._as(f);
+ if ($.Zone__current === B.C__RootZone)
+ return f.call$0();
+ return A._rootRun(null, null, this, f, $R);
+ },
+ runUnary$2$2(f, arg, $R, $T) {
+ $R._eval$1("@<0>")._bind$1($T)._eval$1("1(2)")._as(f);
+ $T._as(arg);
+ if ($.Zone__current === B.C__RootZone)
+ return f.call$1(arg);
+ return A._rootRunUnary(null, null, this, f, arg, $R, $T);
+ },
+ runBinary$3$3(f, arg1, arg2, $R, T1, T2) {
+ $R._eval$1("@<0>")._bind$1(T1)._bind$1(T2)._eval$1("1(2,3)")._as(f);
+ T1._as(arg1);
+ T2._as(arg2);
+ if ($.Zone__current === B.C__RootZone)
+ return f.call$2(arg1, arg2);
+ return A._rootRunBinary(null, null, this, f, arg1, arg2, $R, T1, T2);
+ },
+ registerCallback$1$1(f, $R) {
+ return $R._eval$1("0()")._as(f);
+ },
+ registerUnaryCallback$2$1(f, $R, $T) {
+ return $R._eval$1("@<0>")._bind$1($T)._eval$1("1(2)")._as(f);
+ },
+ registerBinaryCallback$3$1(f, $R, T1, T2) {
+ return $R._eval$1("@<0>")._bind$1(T1)._bind$1(T2)._eval$1("1(2,3)")._as(f);
+ },
+ errorCallback$2(error, stackTrace) {
+ return null;
+ },
+ scheduleMicrotask$1(f) {
+ A._rootScheduleMicrotask(null, null, this, type$.void_Function._as(f));
+ },
+ createPeriodicTimer$2(duration, f) {
+ return A.Timer__createPeriodicTimer(duration, type$.void_Function_Timer._as(f));
+ }
+ };
+ A._RootZone_bindCallback_closure.prototype = {
+ call$0() {
+ return this.$this.run$1$1(this.f, this.R);
+ },
+ $signature() {
+ return this.R._eval$1("0()");
+ }
+ };
+ A._RootZone_bindUnaryCallback_closure.prototype = {
+ call$1(arg) {
+ var _this = this,
+ t1 = _this.T;
+ return _this.$this.runUnary$2$2(_this.f, t1._as(arg), _this.R, t1);
+ },
+ $signature() {
+ return this.R._eval$1("@<0>")._bind$1(this.T)._eval$1("1(2)");
+ }
+ };
+ A._RootZone_bindCallbackGuarded_closure.prototype = {
+ call$0() {
+ return this.$this.runGuarded$1(this.f);
+ },
+ $signature: 0
+ };
+ A._RootZone_bindUnaryCallbackGuarded_closure.prototype = {
+ call$1(arg) {
+ var t1 = this.T;
+ return this.$this.runUnaryGuarded$1$2(this.f, t1._as(arg), t1);
+ },
+ $signature() {
+ return this.T._eval$1("~(0)");
+ }
+ };
+ A.runZonedGuarded_closure.prototype = {
+ call$5($self, $parent, zone, error, stackTrace) {
+ var e, s, exception, t2,
+ t1 = type$.StackTrace;
+ t1._as(stackTrace);
+ try {
+ this.parentZone.runBinary$3$3(this.onError, error, stackTrace, type$.void, type$.Object, t1);
+ } catch (exception) {
+ e = A.unwrapException(exception);
+ s = A.getTraceFromException(exception);
+ t2 = $parent._delegationTarget;
+ if (e === error)
+ t2._processUncaughtError$3(zone, error, stackTrace);
+ else
+ t2._processUncaughtError$3(zone, type$.Object._as(e), t1._as(s));
+ }
+ },
+ $signature: 34
+ };
+ A._HashMap.prototype = {
+ get$length(_) {
+ return this._collection$_length;
+ },
+ get$isEmpty(_) {
+ return this._collection$_length === 0;
+ },
+ get$keys(_) {
+ return new A._HashMapKeyIterable(this, A._instanceType(this)._eval$1("_HashMapKeyIterable<1>"));
+ },
+ containsKey$1(_, key) {
+ var strings, nums;
+ if (typeof key == "string" && key !== "__proto__") {
+ strings = this._collection$_strings;
+ return strings == null ? false : strings[key] != null;
+ } else if (typeof key == "number" && (key & 1073741823) === key) {
+ nums = this._collection$_nums;
+ return nums == null ? false : nums[key] != null;
+ } else
+ return this._containsKey$1(key);
+ },
+ _containsKey$1(key) {
+ var rest = this._collection$_rest;
+ if (rest == null)
+ return false;
+ return this._findBucketIndex$2(this._getBucket$2(rest, key), key) >= 0;
+ },
+ $index(_, key) {
+ var strings, t1, nums;
+ if (typeof key == "string" && key !== "__proto__") {
+ strings = this._collection$_strings;
+ t1 = strings == null ? null : A._HashMap__getTableEntry(strings, key);
+ return t1;
+ } else if (typeof key == "number" && (key & 1073741823) === key) {
+ nums = this._collection$_nums;
+ t1 = nums == null ? null : A._HashMap__getTableEntry(nums, key);
+ return t1;
+ } else
+ return this._get$1(0, key);
+ },
+ _get$1(_, key) {
+ var bucket, index,
+ rest = this._collection$_rest;
+ if (rest == null)
+ return null;
+ bucket = this._getBucket$2(rest, key);
+ index = this._findBucketIndex$2(bucket, key);
+ return index < 0 ? null : bucket[index + 1];
+ },
+ $indexSet(_, key, value) {
+ var strings, nums, _this = this,
+ t1 = A._instanceType(_this);
+ t1._precomputed1._as(key);
+ t1._rest[1]._as(value);
+ if (typeof key == "string" && key !== "__proto__") {
+ strings = _this._collection$_strings;
+ _this._collection$_addHashTableEntry$3(strings == null ? _this._collection$_strings = A._HashMap__newHashTable() : strings, key, value);
+ } else if (typeof key == "number" && (key & 1073741823) === key) {
+ nums = _this._collection$_nums;
+ _this._collection$_addHashTableEntry$3(nums == null ? _this._collection$_nums = A._HashMap__newHashTable() : nums, key, value);
+ } else
+ _this._set$2(key, value);
+ },
+ _set$2(key, value) {
+ var rest, hash, bucket, index, _this = this,
+ t1 = A._instanceType(_this);
+ t1._precomputed1._as(key);
+ t1._rest[1]._as(value);
+ rest = _this._collection$_rest;
+ if (rest == null)
+ rest = _this._collection$_rest = A._HashMap__newHashTable();
+ hash = _this._computeHashCode$1(key);
+ bucket = rest[hash];
+ if (bucket == null) {
+ A._HashMap__setTableEntry(rest, hash, [key, value]);
+ ++_this._collection$_length;
+ _this._keys = null;
+ } else {
+ index = _this._findBucketIndex$2(bucket, key);
+ if (index >= 0)
+ bucket[index + 1] = value;
+ else {
+ bucket.push(key, value);
+ ++_this._collection$_length;
+ _this._keys = null;
+ }
+ }
+ },
+ forEach$1(_, action) {
+ var keys, $length, t2, i, key, t3, _this = this,
+ t1 = A._instanceType(_this);
+ t1._eval$1("~(1,2)")._as(action);
+ keys = _this._computeKeys$0();
+ for ($length = keys.length, t2 = t1._precomputed1, t1 = t1._rest[1], i = 0; i < $length; ++i) {
+ key = keys[i];
+ t2._as(key);
+ t3 = _this.$index(0, key);
+ action.call$2(key, t3 == null ? t1._as(t3) : t3);
+ if (keys !== _this._keys)
+ throw A.wrapException(A.ConcurrentModificationError$(_this));
+ }
+ },
+ _computeKeys$0() {
+ var strings, names, entries, index, i, nums, rest, bucket, $length, i0, _this = this,
+ result = _this._keys;
+ if (result != null)
+ return result;
+ result = A.List_List$filled(_this._collection$_length, null, false, type$.dynamic);
+ strings = _this._collection$_strings;
+ if (strings != null) {
+ names = Object.getOwnPropertyNames(strings);
+ entries = names.length;
+ for (index = 0, i = 0; i < entries; ++i) {
+ result[index] = names[i];
+ ++index;
+ }
+ } else
+ index = 0;
+ nums = _this._collection$_nums;
+ if (nums != null) {
+ names = Object.getOwnPropertyNames(nums);
+ entries = names.length;
+ for (i = 0; i < entries; ++i) {
+ result[index] = +names[i];
+ ++index;
+ }
+ }
+ rest = _this._collection$_rest;
+ if (rest != null) {
+ names = Object.getOwnPropertyNames(rest);
+ entries = names.length;
+ for (i = 0; i < entries; ++i) {
+ bucket = rest[names[i]];
+ $length = bucket.length;
+ for (i0 = 0; i0 < $length; i0 += 2) {
+ result[index] = bucket[i0];
+ ++index;
+ }
+ }
+ }
+ return _this._keys = result;
+ },
+ _collection$_addHashTableEntry$3(table, key, value) {
+ var t1 = A._instanceType(this);
+ t1._precomputed1._as(key);
+ t1._rest[1]._as(value);
+ if (table[key] == null) {
+ ++this._collection$_length;
+ this._keys = null;
+ }
+ A._HashMap__setTableEntry(table, key, value);
+ },
+ _computeHashCode$1(key) {
+ return J.get$hashCode$(key) & 1073741823;
+ },
+ _getBucket$2(table, key) {
+ return table[this._computeHashCode$1(key)];
+ },
+ _findBucketIndex$2(bucket, key) {
+ var $length, i;
+ if (bucket == null)
+ return -1;
+ $length = bucket.length;
+ for (i = 0; i < $length; i += 2)
+ if (J.$eq$(bucket[i], key))
+ return i;
+ return -1;
+ }
+ };
+ A._IdentityHashMap.prototype = {
+ _computeHashCode$1(key) {
+ return A.objectHashCode(key) & 1073741823;
+ },
+ _findBucketIndex$2(bucket, key) {
+ var $length, i, t1;
+ if (bucket == null)
+ return -1;
+ $length = bucket.length;
+ for (i = 0; i < $length; i += 2) {
+ t1 = bucket[i];
+ if (t1 == null ? key == null : t1 === key)
+ return i;
+ }
+ return -1;
+ }
+ };
+ A._HashMapKeyIterable.prototype = {
+ get$length(_) {
+ return this._collection$_map._collection$_length;
+ },
+ get$isEmpty(_) {
+ return this._collection$_map._collection$_length === 0;
+ },
+ get$isNotEmpty(_) {
+ return this._collection$_map._collection$_length !== 0;
+ },
+ get$iterator(_) {
+ var t1 = this._collection$_map;
+ return new A._HashMapKeyIterator(t1, t1._computeKeys$0(), this.$ti._eval$1("_HashMapKeyIterator<1>"));
+ },
+ contains$1(_, element) {
+ return this._collection$_map.containsKey$1(0, element);
+ }
+ };
+ A._HashMapKeyIterator.prototype = {
+ get$current(_) {
+ var t1 = this._collection$_current;
+ return t1 == null ? this.$ti._precomputed1._as(t1) : t1;
+ },
+ moveNext$0() {
+ var _this = this,
+ keys = _this._keys,
+ offset = _this._offset,
+ t1 = _this._collection$_map;
+ if (keys !== t1._keys)
+ throw A.wrapException(A.ConcurrentModificationError$(t1));
+ else if (offset >= keys.length) {
+ _this.set$_collection$_current(null);
+ return false;
+ } else {
+ _this.set$_collection$_current(keys[offset]);
+ _this._offset = offset + 1;
+ return true;
+ }
+ },
+ set$_collection$_current(_current) {
+ this._collection$_current = this.$ti._eval$1("1?")._as(_current);
+ },
+ $isIterator: 1
+ };
+ A._LinkedHashSet.prototype = {
+ get$iterator(_) {
+ var _this = this,
+ t1 = new A._LinkedHashSetIterator(_this, _this._collection$_modifications, _this.$ti._eval$1("_LinkedHashSetIterator<1>"));
+ t1._collection$_cell = _this._collection$_first;
+ return t1;
+ },
+ get$length(_) {
+ return this._collection$_length;
+ },
+ get$isEmpty(_) {
+ return this._collection$_length === 0;
+ },
+ get$isNotEmpty(_) {
+ return this._collection$_length !== 0;
+ },
+ contains$1(_, object) {
+ var nums;
+ if ((object & 1073741823) === object) {
+ nums = this._collection$_nums;
+ if (nums == null)
+ return false;
+ return type$.nullable__LinkedHashSetCell._as(nums[object]) != null;
+ } else
+ return this._contains$1(object);
+ },
+ _contains$1(object) {
+ var rest = this._collection$_rest;
+ if (rest == null)
+ return false;
+ return this._findBucketIndex$2(rest[B.JSInt_methods.get$hashCode(object) & 1073741823], object) >= 0;
+ },
+ add$1(_, element) {
+ var strings, nums, _this = this;
+ _this.$ti._precomputed1._as(element);
+ if (typeof element == "string" && element !== "__proto__") {
+ strings = _this._collection$_strings;
+ return _this._collection$_addHashTableEntry$2(strings == null ? _this._collection$_strings = A._LinkedHashSet__newHashTable() : strings, element);
+ } else if (typeof element == "number" && (element & 1073741823) === element) {
+ nums = _this._collection$_nums;
+ return _this._collection$_addHashTableEntry$2(nums == null ? _this._collection$_nums = A._LinkedHashSet__newHashTable() : nums, element);
+ } else
+ return _this._collection$_add$1(0, element);
+ },
+ _collection$_add$1(_, element) {
+ var rest, hash, bucket, _this = this;
+ _this.$ti._precomputed1._as(element);
+ rest = _this._collection$_rest;
+ if (rest == null)
+ rest = _this._collection$_rest = A._LinkedHashSet__newHashTable();
+ hash = J.get$hashCode$(element) & 1073741823;
+ bucket = rest[hash];
+ if (bucket == null)
+ rest[hash] = [_this._collection$_newLinkedCell$1(element)];
+ else {
+ if (_this._findBucketIndex$2(bucket, element) >= 0)
+ return false;
+ bucket.push(_this._collection$_newLinkedCell$1(element));
+ }
+ return true;
+ },
+ remove$1(_, object) {
+ if ((object & 1073741823) === object)
+ return this._collection$_removeHashTableEntry$2(this._collection$_nums, object);
+ else
+ return this._remove$1(0, object);
+ },
+ _remove$1(_, object) {
+ var hash, bucket, index, cell,
+ rest = this._collection$_rest;
+ if (rest == null)
+ return false;
+ hash = B.JSInt_methods.get$hashCode(object) & 1073741823;
+ bucket = rest[hash];
+ index = this._findBucketIndex$2(bucket, object);
+ if (index < 0)
+ return false;
+ cell = bucket.splice(index, 1)[0];
+ if (0 === bucket.length)
+ delete rest[hash];
+ this._collection$_unlinkCell$1(cell);
+ return true;
+ },
+ _collection$_addHashTableEntry$2(table, element) {
+ this.$ti._precomputed1._as(element);
+ if (type$.nullable__LinkedHashSetCell._as(table[element]) != null)
+ return false;
+ table[element] = this._collection$_newLinkedCell$1(element);
+ return true;
+ },
+ _collection$_removeHashTableEntry$2(table, element) {
+ var cell;
+ if (table == null)
+ return false;
+ cell = type$.nullable__LinkedHashSetCell._as(table[element]);
+ if (cell == null)
+ return false;
+ this._collection$_unlinkCell$1(cell);
+ delete table[element];
+ return true;
+ },
+ _collection$_modified$0() {
+ this._collection$_modifications = this._collection$_modifications + 1 & 1073741823;
+ },
+ _collection$_newLinkedCell$1(element) {
+ var t1, _this = this,
+ cell = new A._LinkedHashSetCell(_this.$ti._precomputed1._as(element));
+ if (_this._collection$_first == null)
+ _this._collection$_first = _this._collection$_last = cell;
+ else {
+ t1 = _this._collection$_last;
+ t1.toString;
+ cell._collection$_previous = t1;
+ _this._collection$_last = t1._collection$_next = cell;
+ }
+ ++_this._collection$_length;
+ _this._collection$_modified$0();
+ return cell;
+ },
+ _collection$_unlinkCell$1(cell) {
+ var _this = this,
+ previous = cell._collection$_previous,
+ next = cell._collection$_next;
+ if (previous == null)
+ _this._collection$_first = next;
+ else
+ previous._collection$_next = next;
+ if (next == null)
+ _this._collection$_last = previous;
+ else
+ next._collection$_previous = previous;
+ --_this._collection$_length;
+ _this._collection$_modified$0();
+ },
+ _findBucketIndex$2(bucket, element) {
+ var $length, i;
+ if (bucket == null)
+ return -1;
+ $length = bucket.length;
+ for (i = 0; i < $length; ++i)
+ if (J.$eq$(bucket[i]._element, element))
+ return i;
+ return -1;
+ }
+ };
+ A._LinkedHashSetCell.prototype = {};
+ A._LinkedHashSetIterator.prototype = {
+ get$current(_) {
+ var t1 = this._collection$_current;
+ return t1 == null ? this.$ti._precomputed1._as(t1) : t1;
+ },
+ moveNext$0() {
+ var _this = this,
+ cell = _this._collection$_cell,
+ t1 = _this._set;
+ if (_this._collection$_modifications !== t1._collection$_modifications)
+ throw A.wrapException(A.ConcurrentModificationError$(t1));
+ else if (cell == null) {
+ _this.set$_collection$_current(null);
+ return false;
+ } else {
+ _this.set$_collection$_current(_this.$ti._eval$1("1?")._as(cell._element));
+ _this._collection$_cell = cell._collection$_next;
+ return true;
+ }
+ },
+ set$_collection$_current(_current) {
+ this._collection$_current = this.$ti._eval$1("1?")._as(_current);
+ },
+ $isIterator: 1
+ };
+ A.ListBase.prototype = {
+ get$iterator(receiver) {
+ return new A.ListIterator(receiver, this.get$length(receiver), A.instanceType(receiver)._eval$1("ListIterator<ListBase.E>"));
+ },
+ elementAt$1(receiver, index) {
+ return this.$index(receiver, index);
+ },
+ get$isEmpty(receiver) {
+ return this.get$length(receiver) === 0;
+ },
+ get$isNotEmpty(receiver) {
+ return !this.get$isEmpty(receiver);
+ },
+ get$first(receiver) {
+ if (this.get$length(receiver) === 0)
+ throw A.wrapException(A.IterableElementError_noElement());
+ return this.$index(receiver, 0);
+ },
+ map$1$1(receiver, f, $T) {
+ var t1 = A.instanceType(receiver);
+ return new A.MappedListIterable(receiver, t1._bind$1($T)._eval$1("1(ListBase.E)")._as(f), t1._eval$1("@<ListBase.E>")._bind$1($T)._eval$1("MappedListIterable<1,2>"));
+ },
+ skip$1(receiver, count) {
+ return A.SubListIterable$(receiver, count, null, A.instanceType(receiver)._eval$1("ListBase.E"));
+ },
+ cast$1$0(receiver, $R) {
+ return new A.CastList(receiver, A.instanceType(receiver)._eval$1("@<ListBase.E>")._bind$1($R)._eval$1("CastList<1,2>"));
+ },
+ fillRange$3(receiver, start, end, fill) {
+ var i;
+ A.instanceType(receiver)._eval$1("ListBase.E?")._as(fill);
+ A.RangeError_checkValidRange(start, end, this.get$length(receiver));
+ for (i = start; i < end; ++i)
+ this.$indexSet(receiver, i, fill);
+ },
+ toString$0(receiver) {
+ return A.Iterable_iterableToFullString(receiver, "[", "]");
+ },
+ $isEfficientLengthIterable: 1,
+ $isIterable: 1,
+ $isList: 1
+ };
+ A.MapBase.prototype = {
+ forEach$1(receiver, action) {
+ var t2, key, t3,
+ t1 = A.instanceType(receiver);
+ t1._eval$1("~(MapBase.K,MapBase.V)")._as(action);
+ for (t2 = J.get$iterator$ax(this.get$keys(receiver)), t1 = t1._eval$1("MapBase.V"); t2.moveNext$0();) {
+ key = t2.get$current(t2);
+ t3 = this.$index(receiver, key);
+ action.call$2(key, t3 == null ? t1._as(t3) : t3);
+ }
+ },
+ containsKey$1(receiver, key) {
+ return J.contains$1$asx(this.get$keys(receiver), key);
+ },
+ get$length(receiver) {
+ return J.get$length$asx(this.get$keys(receiver));
+ },
+ get$isEmpty(receiver) {
+ return J.get$isEmpty$asx(this.get$keys(receiver));
+ },
+ toString$0(receiver) {
+ return A.MapBase_mapToString(receiver);
+ },
+ $isMap: 1
+ };
+ A.MapBase_mapToString_closure.prototype = {
+ call$2(k, v) {
+ var t2,
+ t1 = this._box_0;
+ if (!t1.first)
+ this.result._contents += ", ";
+ t1.first = false;
+ t1 = this.result;
+ t2 = t1._contents += A.S(k);
+ t1._contents = t2 + ": ";
+ t1._contents += A.S(v);
+ },
+ $signature: 16
+ };
+ A._UnmodifiableMapMixin.prototype = {
+ $indexSet(_, key, value) {
+ var t1 = A._instanceType(this);
+ t1._precomputed1._as(key);
+ t1._rest[1]._as(value);
+ throw A.wrapException(A.UnsupportedError$("Cannot modify unmodifiable map"));
+ }
+ };
+ A.MapView.prototype = {
+ $index(_, key) {
+ return J.$index$asx(this._collection$_map, key);
+ },
+ $indexSet(_, key, value) {
+ var t1 = A._instanceType(this);
+ J.$indexSet$ax(this._collection$_map, t1._precomputed1._as(key), t1._rest[1]._as(value));
+ },
+ containsKey$1(_, key) {
+ return J.containsKey$1$x(this._collection$_map, key);
+ },
+ forEach$1(_, action) {
+ J.forEach$1$x(this._collection$_map, A._instanceType(this)._eval$1("~(1,2)")._as(action));
+ },
+ get$isEmpty(_) {
+ return J.get$isEmpty$asx(this._collection$_map);
+ },
+ get$length(_) {
+ return J.get$length$asx(this._collection$_map);
+ },
+ get$keys(_) {
+ return J.get$keys$x(this._collection$_map);
+ },
+ toString$0(_) {
+ return J.toString$0$(this._collection$_map);
+ },
+ $isMap: 1
+ };
+ A.UnmodifiableMapView.prototype = {};
+ A.SetBase.prototype = {
+ get$isEmpty(_) {
+ return this._collection$_length === 0;
+ },
+ get$isNotEmpty(_) {
+ return this._collection$_length !== 0;
+ },
+ map$1$1(_, f, $T) {
+ var t1 = this.$ti;
+ return new A.EfficientLengthMappedIterable(this, t1._bind$1($T)._eval$1("1(2)")._as(f), t1._eval$1("@<1>")._bind$1($T)._eval$1("EfficientLengthMappedIterable<1,2>"));
+ },
+ toString$0(_) {
+ return A.Iterable_iterableToFullString(this, "{", "}");
+ },
+ skip$1(_, n) {
+ return A.SkipIterable_SkipIterable(this, n, this.$ti._precomputed1);
+ },
+ elementAt$1(_, index) {
+ var iterator, skipCount, t1, _this = this;
+ A.RangeError_checkNotNegative(index, "index");
+ iterator = A._LinkedHashSetIterator$(_this, _this._collection$_modifications, _this.$ti._precomputed1);
+ for (skipCount = index; iterator.moveNext$0();) {
+ if (skipCount === 0) {
+ t1 = iterator._collection$_current;
+ return t1 == null ? iterator.$ti._precomputed1._as(t1) : t1;
+ }
+ --skipCount;
+ }
+ throw A.wrapException(A.IndexError$withLength(index, index - skipCount, _this, "index"));
+ },
+ $isEfficientLengthIterable: 1,
+ $isIterable: 1,
+ $isSet: 1
+ };
+ A._SetBase.prototype = {};
+ A._UnmodifiableMapView_MapView__UnmodifiableMapMixin.prototype = {};
+ A._JsonMap.prototype = {
+ $index(_, key) {
+ var result,
+ t1 = this._processed;
+ if (t1 == null)
+ return this._data.$index(0, key);
+ else if (typeof key != "string")
+ return null;
+ else {
+ result = t1[key];
+ return typeof result == "undefined" ? this._process$1(key) : result;
+ }
+ },
+ get$length(_) {
+ return this._processed == null ? this._data._length : this._convert$_computeKeys$0().length;
+ },
+ get$isEmpty(_) {
+ return this.get$length(this) === 0;
+ },
+ get$keys(_) {
+ var t1;
+ if (this._processed == null) {
+ t1 = this._data;
+ return new A.LinkedHashMapKeyIterable(t1, A._instanceType(t1)._eval$1("LinkedHashMapKeyIterable<1>"));
+ }
+ return new A._JsonMapKeyIterable(this);
+ },
+ $indexSet(_, key, value) {
+ var processed, original, _this = this;
+ if (_this._processed == null)
+ _this._data.$indexSet(0, key, value);
+ else if (_this.containsKey$1(0, key)) {
+ processed = _this._processed;
+ processed[key] = value;
+ original = _this._original;
+ if (original == null ? processed != null : original !== processed)
+ original[key] = null;
+ } else
+ _this._upgrade$0().$indexSet(0, key, value);
+ },
+ containsKey$1(_, key) {
+ if (this._processed == null)
+ return this._data.containsKey$1(0, key);
+ return Object.prototype.hasOwnProperty.call(this._original, key);
+ },
+ forEach$1(_, f) {
+ var keys, i, key, value, _this = this;
+ type$.void_Function_String_dynamic._as(f);
+ if (_this._processed == null)
+ return _this._data.forEach$1(0, f);
+ keys = _this._convert$_computeKeys$0();
+ for (i = 0; i < keys.length; ++i) {
+ key = keys[i];
+ value = _this._processed[key];
+ if (typeof value == "undefined") {
+ value = A._convertJsonToDartLazy(_this._original[key]);
+ _this._processed[key] = value;
+ }
+ f.call$2(key, value);
+ if (keys !== _this._data)
+ throw A.wrapException(A.ConcurrentModificationError$(_this));
+ }
+ },
+ _convert$_computeKeys$0() {
+ var keys = type$.nullable_List_dynamic._as(this._data);
+ if (keys == null)
+ keys = this._data = A._setArrayType(Object.keys(this._original), type$.JSArray_String);
+ return keys;
+ },
+ _upgrade$0() {
+ var result, keys, i, t1, key, _this = this;
+ if (_this._processed == null)
+ return _this._data;
+ result = A.LinkedHashMap_LinkedHashMap$_empty(type$.String, type$.dynamic);
+ keys = _this._convert$_computeKeys$0();
+ for (i = 0; t1 = keys.length, i < t1; ++i) {
+ key = keys[i];
+ result.$indexSet(0, key, _this.$index(0, key));
+ }
+ if (t1 === 0)
+ B.JSArray_methods.add$1(keys, "");
+ else
+ B.JSArray_methods.clear$0(keys);
+ _this._original = _this._processed = null;
+ return _this._data = result;
+ },
+ _process$1(key) {
+ var result;
+ if (!Object.prototype.hasOwnProperty.call(this._original, key))
+ return null;
+ result = A._convertJsonToDartLazy(this._original[key]);
+ return this._processed[key] = result;
+ }
+ };
+ A._JsonMapKeyIterable.prototype = {
+ get$length(_) {
+ var t1 = this._convert$_parent;
+ return t1.get$length(t1);
+ },
+ elementAt$1(_, index) {
+ var t1 = this._convert$_parent;
+ if (t1._processed == null)
+ t1 = t1.get$keys(t1).elementAt$1(0, index);
+ else {
+ t1 = t1._convert$_computeKeys$0();
+ if (!(index >= 0 && index < t1.length))
+ return A.ioore(t1, index);
+ t1 = t1[index];
+ }
+ return t1;
+ },
+ get$iterator(_) {
+ var t1 = this._convert$_parent;
+ if (t1._processed == null) {
+ t1 = t1.get$keys(t1);
+ t1 = t1.get$iterator(t1);
+ } else {
+ t1 = t1._convert$_computeKeys$0();
+ t1 = new J.ArrayIterator(t1, t1.length, A._arrayInstanceType(t1)._eval$1("ArrayIterator<1>"));
+ }
+ return t1;
+ },
+ contains$1(_, key) {
+ return this._convert$_parent.containsKey$1(0, key);
+ }
+ };
+ A.Utf8Decoder__decoder_closure.prototype = {
+ call$0() {
+ var t1, exception;
+ try {
+ t1 = new TextDecoder("utf-8", {fatal: true});
+ return t1;
+ } catch (exception) {
+ }
+ return null;
+ },
+ $signature: 2
+ };
+ A.Utf8Decoder__decoderNonfatal_closure.prototype = {
+ call$0() {
+ var t1, exception;
+ try {
+ t1 = new TextDecoder("utf-8", {fatal: false});
+ return t1;
+ } catch (exception) {
+ }
+ return null;
+ },
+ $signature: 2
+ };
+ A.AsciiCodec.prototype = {
+ encode$1(source) {
+ return B.AsciiEncoder_127.convert$1(source);
+ }
+ };
+ A._UnicodeSubsetEncoder.prototype = {
+ convert$1(string) {
+ var stringLength, $length, result, t1, i, codeUnit;
+ A._asString(string);
+ stringLength = string.length;
+ $length = A.RangeError_checkValidRange(0, null, stringLength) - 0;
+ result = new Uint8Array($length);
+ for (t1 = ~this._subsetMask, i = 0; i < $length; ++i) {
+ if (!(i < stringLength))
+ return A.ioore(string, i);
+ codeUnit = string.charCodeAt(i);
+ if ((codeUnit & t1) !== 0)
+ throw A.wrapException(A.ArgumentError$value(string, "string", "Contains invalid characters."));
+ if (!(i < $length))
+ return A.ioore(result, i);
+ result[i] = codeUnit;
+ }
+ return result;
+ }
+ };
+ A.AsciiEncoder.prototype = {};
+ A.Base64Codec.prototype = {
+ normalize$3(_, source, start, end) {
+ var inverseAlphabet, t2, i, sliceStart, buffer, firstPadding, firstPaddingSourceIndex, paddingCount, i0, char, i1, digit1, t3, digit2, char0, value, endLength, $length,
+ _s64_ = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/",
+ _s31_ = "Invalid base64 encoding length ",
+ t1 = source.length;
+ end = A.RangeError_checkValidRange(start, end, t1);
+ inverseAlphabet = $.$get$_Base64Decoder__inverseAlphabet();
+ for (t2 = inverseAlphabet.length, i = start, sliceStart = i, buffer = null, firstPadding = -1, firstPaddingSourceIndex = -1, paddingCount = 0; i < end; i = i0) {
+ i0 = i + 1;
+ if (!(i < t1))
+ return A.ioore(source, i);
+ char = source.charCodeAt(i);
+ if (char === 37) {
+ i1 = i0 + 2;
+ if (i1 <= end) {
+ if (!(i0 < t1))
+ return A.ioore(source, i0);
+ digit1 = A.hexDigitValue(source.charCodeAt(i0));
+ t3 = i0 + 1;
+ if (!(t3 < t1))
+ return A.ioore(source, t3);
+ digit2 = A.hexDigitValue(source.charCodeAt(t3));
+ char0 = digit1 * 16 + digit2 - (digit2 & 256);
+ if (char0 === 37)
+ char0 = -1;
+ i0 = i1;
+ } else
+ char0 = -1;
+ } else
+ char0 = char;
+ if (0 <= char0 && char0 <= 127) {
+ if (!(char0 >= 0 && char0 < t2))
+ return A.ioore(inverseAlphabet, char0);
+ value = inverseAlphabet[char0];
+ if (value >= 0) {
+ if (!(value < 64))
+ return A.ioore(_s64_, value);
+ char0 = _s64_.charCodeAt(value);
+ if (char0 === char)
+ continue;
+ char = char0;
+ } else {
+ if (value === -1) {
+ if (firstPadding < 0) {
+ t3 = buffer == null ? null : buffer._contents.length;
+ if (t3 == null)
+ t3 = 0;
+ firstPadding = t3 + (i - sliceStart);
+ firstPaddingSourceIndex = i;
+ }
+ ++paddingCount;
+ if (char === 61)
+ continue;
+ }
+ char = char0;
+ }
+ if (value !== -2) {
+ if (buffer == null) {
+ buffer = new A.StringBuffer("");
+ t3 = buffer;
+ } else
+ t3 = buffer;
+ t3._contents += B.JSString_methods.substring$2(source, sliceStart, i);
+ t3._contents += A.Primitives_stringFromCharCode(char);
+ sliceStart = i0;
+ continue;
+ }
+ }
+ throw A.wrapException(A.FormatException$("Invalid base64 data", source, i));
+ }
+ if (buffer != null) {
+ t1 = buffer._contents += B.JSString_methods.substring$2(source, sliceStart, end);
+ t2 = t1.length;
+ if (firstPadding >= 0)
+ A.Base64Codec__checkPadding(source, firstPaddingSourceIndex, end, firstPadding, paddingCount, t2);
+ else {
+ endLength = B.JSInt_methods.$mod(t2 - 1, 4) + 1;
+ if (endLength === 1)
+ throw A.wrapException(A.FormatException$(_s31_, source, end));
+ for (; endLength < 4;) {
+ t1 += "=";
+ buffer._contents = t1;
+ ++endLength;
+ }
+ }
+ t1 = buffer._contents;
+ return B.JSString_methods.replaceRange$3(source, start, end, t1.charCodeAt(0) == 0 ? t1 : t1);
+ }
+ $length = end - start;
+ if (firstPadding >= 0)
+ A.Base64Codec__checkPadding(source, firstPaddingSourceIndex, end, firstPadding, paddingCount, $length);
+ else {
+ endLength = B.JSInt_methods.$mod($length, 4);
+ if (endLength === 1)
+ throw A.wrapException(A.FormatException$(_s31_, source, end));
+ if (endLength > 1)
+ source = B.JSString_methods.replaceRange$3(source, end, end, endLength === 2 ? "==" : "=");
+ }
+ return source;
+ }
+ };
+ A.Base64Encoder.prototype = {};
+ A.Codec.prototype = {};
+ A._FusedCodec.prototype = {};
+ A.Converter.prototype = {$isStreamTransformer: 1};
+ A.Encoding.prototype = {};
+ A.JsonUnsupportedObjectError.prototype = {
+ toString$0(_) {
+ var safeString = A.Error_safeToString(this.unsupportedObject);
+ return (this.cause != null ? "Converting object to an encodable object failed:" : "Converting object did not return an encodable object:") + " " + safeString;
+ }
+ };
+ A.JsonCyclicError.prototype = {
+ toString$0(_) {
+ return "Cyclic error in JSON stringify";
+ }
+ };
+ A.JsonCodec.prototype = {
+ decode$2$reviver(_, source, reviver) {
+ var t1 = A._parseJson(source, this.get$decoder()._reviver);
+ return t1;
+ },
+ encode$2$toEncodable(value, toEncodable) {
+ var t1 = A._JsonStringStringifier_stringify(value, this.get$encoder()._toEncodable, null);
+ return t1;
+ },
+ get$encoder() {
+ return B.JsonEncoder_null;
+ },
+ get$decoder() {
+ return B.JsonDecoder_null;
+ }
+ };
+ A.JsonEncoder.prototype = {};
+ A.JsonDecoder.prototype = {};
+ A._JsonStringifier.prototype = {
+ writeStringContent$1(s) {
+ var offset, i, charCode, t1, t2, _this = this,
+ $length = s.length;
+ for (offset = 0, i = 0; i < $length; ++i) {
+ charCode = s.charCodeAt(i);
+ if (charCode > 92) {
+ if (charCode >= 55296) {
+ t1 = charCode & 64512;
+ if (t1 === 55296) {
+ t2 = i + 1;
+ t2 = !(t2 < $length && (s.charCodeAt(t2) & 64512) === 56320);
+ } else
+ t2 = false;
+ if (!t2)
+ if (t1 === 56320) {
+ t1 = i - 1;
+ t1 = !(t1 >= 0 && (s.charCodeAt(t1) & 64512) === 55296);
+ } else
+ t1 = false;
+ else
+ t1 = true;
+ if (t1) {
+ if (i > offset)
+ _this.writeStringSlice$3(s, offset, i);
+ offset = i + 1;
+ _this.writeCharCode$1(92);
+ _this.writeCharCode$1(117);
+ _this.writeCharCode$1(100);
+ t1 = charCode >>> 8 & 15;
+ _this.writeCharCode$1(t1 < 10 ? 48 + t1 : 87 + t1);
+ t1 = charCode >>> 4 & 15;
+ _this.writeCharCode$1(t1 < 10 ? 48 + t1 : 87 + t1);
+ t1 = charCode & 15;
+ _this.writeCharCode$1(t1 < 10 ? 48 + t1 : 87 + t1);
+ }
+ }
+ continue;
+ }
+ if (charCode < 32) {
+ if (i > offset)
+ _this.writeStringSlice$3(s, offset, i);
+ offset = i + 1;
+ _this.writeCharCode$1(92);
+ switch (charCode) {
+ case 8:
+ _this.writeCharCode$1(98);
+ break;
+ case 9:
+ _this.writeCharCode$1(116);
+ break;
+ case 10:
+ _this.writeCharCode$1(110);
+ break;
+ case 12:
+ _this.writeCharCode$1(102);
+ break;
+ case 13:
+ _this.writeCharCode$1(114);
+ break;
+ default:
+ _this.writeCharCode$1(117);
+ _this.writeCharCode$1(48);
+ _this.writeCharCode$1(48);
+ t1 = charCode >>> 4 & 15;
+ _this.writeCharCode$1(t1 < 10 ? 48 + t1 : 87 + t1);
+ t1 = charCode & 15;
+ _this.writeCharCode$1(t1 < 10 ? 48 + t1 : 87 + t1);
+ break;
+ }
+ } else if (charCode === 34 || charCode === 92) {
+ if (i > offset)
+ _this.writeStringSlice$3(s, offset, i);
+ offset = i + 1;
+ _this.writeCharCode$1(92);
+ _this.writeCharCode$1(charCode);
+ }
+ }
+ if (offset === 0)
+ _this.writeString$1(s);
+ else if (offset < $length)
+ _this.writeStringSlice$3(s, offset, $length);
+ },
+ _checkCycle$1(object) {
+ var t1, t2, i, t3;
+ for (t1 = this._seen, t2 = t1.length, i = 0; i < t2; ++i) {
+ t3 = t1[i];
+ if (object == null ? t3 == null : object === t3)
+ throw A.wrapException(new A.JsonCyclicError(object, null));
+ }
+ B.JSArray_methods.add$1(t1, object);
+ },
+ writeObject$1(object) {
+ var customJson, e, t1, exception, _this = this;
+ if (_this.writeJsonValue$1(object))
+ return;
+ _this._checkCycle$1(object);
+ try {
+ customJson = _this._toEncodable.call$1(object);
+ if (!_this.writeJsonValue$1(customJson)) {
+ t1 = A.JsonUnsupportedObjectError$(object, null, _this.get$_partialResult());
+ throw A.wrapException(t1);
+ }
+ t1 = _this._seen;
+ if (0 >= t1.length)
+ return A.ioore(t1, -1);
+ t1.pop();
+ } catch (exception) {
+ e = A.unwrapException(exception);
+ t1 = A.JsonUnsupportedObjectError$(object, e, _this.get$_partialResult());
+ throw A.wrapException(t1);
+ }
+ },
+ writeJsonValue$1(object) {
+ var t1, success, _this = this;
+ if (typeof object == "number") {
+ if (!isFinite(object))
+ return false;
+ _this.writeNumber$1(object);
+ return true;
+ } else if (object === true) {
+ _this.writeString$1("true");
+ return true;
+ } else if (object === false) {
+ _this.writeString$1("false");
+ return true;
+ } else if (object == null) {
+ _this.writeString$1("null");
+ return true;
+ } else if (typeof object == "string") {
+ _this.writeString$1('"');
+ _this.writeStringContent$1(object);
+ _this.writeString$1('"');
+ return true;
+ } else if (type$.List_dynamic._is(object)) {
+ _this._checkCycle$1(object);
+ _this.writeList$1(object);
+ t1 = _this._seen;
+ if (0 >= t1.length)
+ return A.ioore(t1, -1);
+ t1.pop();
+ return true;
+ } else if (type$.Map_dynamic_dynamic._is(object)) {
+ _this._checkCycle$1(object);
+ success = _this.writeMap$1(object);
+ t1 = _this._seen;
+ if (0 >= t1.length)
+ return A.ioore(t1, -1);
+ t1.pop();
+ return success;
+ } else
+ return false;
+ },
+ writeList$1(list) {
+ var t1, i, _this = this;
+ _this.writeString$1("[");
+ t1 = J.getInterceptor$asx(list);
+ if (t1.get$isNotEmpty(list)) {
+ _this.writeObject$1(t1.$index(list, 0));
+ for (i = 1; i < t1.get$length(list); ++i) {
+ _this.writeString$1(",");
+ _this.writeObject$1(t1.$index(list, i));
+ }
+ }
+ _this.writeString$1("]");
+ },
+ writeMap$1(map) {
+ var t2, keyValueList, i, separator, _this = this, _box_0 = {},
+ t1 = J.getInterceptor$asx(map);
+ if (t1.get$isEmpty(map)) {
+ _this.writeString$1("{}");
+ return true;
+ }
+ t2 = t1.get$length(map) * 2;
+ keyValueList = A.List_List$filled(t2, null, false, type$.nullable_Object);
+ i = _box_0.i = 0;
+ _box_0.allStringKeys = true;
+ t1.forEach$1(map, new A._JsonStringifier_writeMap_closure(_box_0, keyValueList));
+ if (!_box_0.allStringKeys)
+ return false;
+ _this.writeString$1("{");
+ for (separator = '"'; i < t2; i += 2, separator = ',"') {
+ _this.writeString$1(separator);
+ _this.writeStringContent$1(A._asString(keyValueList[i]));
+ _this.writeString$1('":');
+ t1 = i + 1;
+ if (!(t1 < t2))
+ return A.ioore(keyValueList, t1);
+ _this.writeObject$1(keyValueList[t1]);
+ }
+ _this.writeString$1("}");
+ return true;
+ }
+ };
+ A._JsonStringifier_writeMap_closure.prototype = {
+ call$2(key, value) {
+ var t1, t2;
+ if (typeof key != "string")
+ this._box_0.allStringKeys = false;
+ t1 = this.keyValueList;
+ t2 = this._box_0;
+ B.JSArray_methods.$indexSet(t1, t2.i++, key);
+ B.JSArray_methods.$indexSet(t1, t2.i++, value);
+ },
+ $signature: 16
+ };
+ A._JsonStringStringifier.prototype = {
+ get$_partialResult() {
+ var t1 = this._sink;
+ return t1 instanceof A.StringBuffer ? t1.toString$0(0) : null;
+ },
+ writeNumber$1(number) {
+ this._sink.write$1(0, B.JSNumber_methods.toString$0(number));
+ },
+ writeString$1(string) {
+ this._sink.write$1(0, string);
+ },
+ writeStringSlice$3(string, start, end) {
+ this._sink.write$1(0, B.JSString_methods.substring$2(string, start, end));
+ },
+ writeCharCode$1(charCode) {
+ this._sink.writeCharCode$1(charCode);
+ }
+ };
+ A.Utf8Codec.prototype = {};
+ A.Utf8Encoder.prototype = {
+ convert$1(string) {
+ var stringLength, end, $length, t1, encoder, t2;
+ A._asString(string);
+ stringLength = string.length;
+ end = A.RangeError_checkValidRange(0, null, stringLength);
+ $length = end - 0;
+ if ($length === 0)
+ return new Uint8Array(0);
+ t1 = new Uint8Array($length * 3);
+ encoder = new A._Utf8Encoder(t1);
+ if (encoder._fillBuffer$3(string, 0, end) !== end) {
+ t2 = end - 1;
+ if (!(t2 >= 0 && t2 < stringLength))
+ return A.ioore(string, t2);
+ encoder._writeReplacementCharacter$0();
+ }
+ return B.NativeUint8List_methods.sublist$2(t1, 0, encoder._bufferIndex);
+ }
+ };
+ A._Utf8Encoder.prototype = {
+ _writeReplacementCharacter$0() {
+ var _this = this,
+ t1 = _this._buffer,
+ t2 = _this._bufferIndex,
+ t3 = _this._bufferIndex = t2 + 1,
+ t4 = t1.length;
+ if (!(t2 < t4))
+ return A.ioore(t1, t2);
+ t1[t2] = 239;
+ t2 = _this._bufferIndex = t3 + 1;
+ if (!(t3 < t4))
+ return A.ioore(t1, t3);
+ t1[t3] = 191;
+ _this._bufferIndex = t2 + 1;
+ if (!(t2 < t4))
+ return A.ioore(t1, t2);
+ t1[t2] = 189;
+ },
+ _writeSurrogate$2(leadingSurrogate, nextCodeUnit) {
+ var rune, t1, t2, t3, t4, _this = this;
+ if ((nextCodeUnit & 64512) === 56320) {
+ rune = 65536 + ((leadingSurrogate & 1023) << 10) | nextCodeUnit & 1023;
+ t1 = _this._buffer;
+ t2 = _this._bufferIndex;
+ t3 = _this._bufferIndex = t2 + 1;
+ t4 = t1.length;
+ if (!(t2 < t4))
+ return A.ioore(t1, t2);
+ t1[t2] = rune >>> 18 | 240;
+ t2 = _this._bufferIndex = t3 + 1;
+ if (!(t3 < t4))
+ return A.ioore(t1, t3);
+ t1[t3] = rune >>> 12 & 63 | 128;
+ t3 = _this._bufferIndex = t2 + 1;
+ if (!(t2 < t4))
+ return A.ioore(t1, t2);
+ t1[t2] = rune >>> 6 & 63 | 128;
+ _this._bufferIndex = t3 + 1;
+ if (!(t3 < t4))
+ return A.ioore(t1, t3);
+ t1[t3] = rune & 63 | 128;
+ return true;
+ } else {
+ _this._writeReplacementCharacter$0();
+ return false;
+ }
+ },
+ _fillBuffer$3(str, start, end) {
+ var t1, t2, t3, stringIndex, codeUnit, t4, t5, _this = this;
+ if (start !== end) {
+ t1 = end - 1;
+ if (!(t1 >= 0 && t1 < str.length))
+ return A.ioore(str, t1);
+ t1 = (str.charCodeAt(t1) & 64512) === 55296;
+ } else
+ t1 = false;
+ if (t1)
+ --end;
+ for (t1 = _this._buffer, t2 = t1.length, t3 = str.length, stringIndex = start; stringIndex < end; ++stringIndex) {
+ if (!(stringIndex < t3))
+ return A.ioore(str, stringIndex);
+ codeUnit = str.charCodeAt(stringIndex);
+ if (codeUnit <= 127) {
+ t4 = _this._bufferIndex;
+ if (t4 >= t2)
+ break;
+ _this._bufferIndex = t4 + 1;
+ t1[t4] = codeUnit;
+ } else {
+ t4 = codeUnit & 64512;
+ if (t4 === 55296) {
+ if (_this._bufferIndex + 4 > t2)
+ break;
+ t4 = stringIndex + 1;
+ if (!(t4 < t3))
+ return A.ioore(str, t4);
+ if (_this._writeSurrogate$2(codeUnit, str.charCodeAt(t4)))
+ stringIndex = t4;
+ } else if (t4 === 56320) {
+ if (_this._bufferIndex + 3 > t2)
+ break;
+ _this._writeReplacementCharacter$0();
+ } else if (codeUnit <= 2047) {
+ t4 = _this._bufferIndex;
+ t5 = t4 + 1;
+ if (t5 >= t2)
+ break;
+ _this._bufferIndex = t5;
+ if (!(t4 < t2))
+ return A.ioore(t1, t4);
+ t1[t4] = codeUnit >>> 6 | 192;
+ _this._bufferIndex = t5 + 1;
+ t1[t5] = codeUnit & 63 | 128;
+ } else {
+ t4 = _this._bufferIndex;
+ if (t4 + 2 >= t2)
+ break;
+ t5 = _this._bufferIndex = t4 + 1;
+ if (!(t4 < t2))
+ return A.ioore(t1, t4);
+ t1[t4] = codeUnit >>> 12 | 224;
+ t4 = _this._bufferIndex = t5 + 1;
+ if (!(t5 < t2))
+ return A.ioore(t1, t5);
+ t1[t5] = codeUnit >>> 6 & 63 | 128;
+ _this._bufferIndex = t4 + 1;
+ if (!(t4 < t2))
+ return A.ioore(t1, t4);
+ t1[t4] = codeUnit & 63 | 128;
+ }
+ }
+ }
+ return stringIndex;
+ }
+ };
+ A.Utf8Decoder.prototype = {
+ convert$1(codeUnits) {
+ var t1, result;
+ type$.List_int._as(codeUnits);
+ t1 = this._allowMalformed;
+ result = A.Utf8Decoder__convertIntercepted(t1, codeUnits, 0, null);
+ if (result != null)
+ return result;
+ return new A._Utf8Decoder(t1).convertGeneral$4(codeUnits, 0, null, true);
+ }
+ };
+ A._Utf8Decoder.prototype = {
+ convertGeneral$4(codeUnits, start, maybeEnd, single) {
+ var end, bytes, errorOffset, result, t1, message, _this = this;
+ type$.List_int._as(codeUnits);
+ end = A.RangeError_checkValidRange(start, maybeEnd, J.get$length$asx(codeUnits));
+ if (start === end)
+ return "";
+ if (type$.Uint8List._is(codeUnits)) {
+ bytes = codeUnits;
+ errorOffset = 0;
+ } else {
+ bytes = A._Utf8Decoder__makeUint8List(codeUnits, start, end);
+ end -= start;
+ errorOffset = start;
+ start = 0;
+ }
+ result = _this._convertRecursive$4(bytes, start, end, single);
+ t1 = _this._state;
+ if ((t1 & 1) !== 0) {
+ message = A._Utf8Decoder_errorDescription(t1);
+ _this._state = 0;
+ throw A.wrapException(A.FormatException$(message, codeUnits, errorOffset + _this._charOrIndex));
+ }
+ return result;
+ },
+ _convertRecursive$4(bytes, start, end, single) {
+ var mid, s1, _this = this;
+ if (end - start > 1000) {
+ mid = B.JSInt_methods._tdivFast$1(start + end, 2);
+ s1 = _this._convertRecursive$4(bytes, start, mid, false);
+ if ((_this._state & 1) !== 0)
+ return s1;
+ return s1 + _this._convertRecursive$4(bytes, mid, end, single);
+ }
+ return _this.decodeGeneral$4(bytes, start, end, single);
+ },
+ decodeGeneral$4(bytes, start, end, single) {
+ var byte, t2, type, t3, i0, markEnd, i1, m, _this = this,
+ _s256_ = "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAFFFFFFFFFFFFFFFFGGGGGGGGGGGGGGGGHHHHHHHHHHHHHHHHHHHHHHHHHHHIHHHJEEBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBKCCCCCCCCCCCCDCLONNNMEEEEEEEEEEE",
+ _s144_ = " \x000:XECCCCCN:lDb \x000:XECCCCCNvlDb \x000:XECCCCCN:lDb AAAAA\x00\x00\x00\x00\x00AAAAA00000AAAAA:::::AAAAAGG000AAAAA00KKKAAAAAG::::AAAAA:IIIIAAAAA000\x800AAAAA\x00\x00\x00\x00 AAAAA",
+ _65533 = 65533,
+ state = _this._state,
+ char = _this._charOrIndex,
+ buffer = new A.StringBuffer(""),
+ i = start + 1,
+ t1 = bytes.length;
+ if (!(start >= 0 && start < t1))
+ return A.ioore(bytes, start);
+ byte = bytes[start];
+ $label0$0:
+ for (t2 = _this.allowMalformed; true;) {
+ for (; true; i = i0) {
+ if (!(byte >= 0 && byte < 256))
+ return A.ioore(_s256_, byte);
+ type = _s256_.charCodeAt(byte) & 31;
+ char = state <= 32 ? byte & 61694 >>> type : (byte & 63 | char << 6) >>> 0;
+ t3 = state + type;
+ if (!(t3 >= 0 && t3 < 144))
+ return A.ioore(_s144_, t3);
+ state = _s144_.charCodeAt(t3);
+ if (state === 0) {
+ buffer._contents += A.Primitives_stringFromCharCode(char);
+ if (i === end)
+ break $label0$0;
+ break;
+ } else if ((state & 1) !== 0) {
+ if (t2)
+ switch (state) {
+ case 69:
+ case 67:
+ buffer._contents += A.Primitives_stringFromCharCode(_65533);
+ break;
+ case 65:
+ buffer._contents += A.Primitives_stringFromCharCode(_65533);
+ --i;
+ break;
+ default:
+ t3 = buffer._contents += A.Primitives_stringFromCharCode(_65533);
+ buffer._contents = t3 + A.Primitives_stringFromCharCode(_65533);
+ break;
+ }
+ else {
+ _this._state = state;
+ _this._charOrIndex = i - 1;
+ return "";
+ }
+ state = 0;
+ }
+ if (i === end)
+ break $label0$0;
+ i0 = i + 1;
+ if (!(i >= 0 && i < t1))
+ return A.ioore(bytes, i);
+ byte = bytes[i];
+ }
+ i0 = i + 1;
+ if (!(i >= 0 && i < t1))
+ return A.ioore(bytes, i);
+ byte = bytes[i];
+ if (byte < 128) {
+ while (true) {
+ if (!(i0 < end)) {
+ markEnd = end;
+ break;
+ }
+ i1 = i0 + 1;
+ if (!(i0 >= 0 && i0 < t1))
+ return A.ioore(bytes, i0);
+ byte = bytes[i0];
+ if (byte >= 128) {
+ markEnd = i1 - 1;
+ i0 = i1;
+ break;
+ }
+ i0 = i1;
+ }
+ if (markEnd - i < 20)
+ for (m = i; m < markEnd; ++m) {
+ if (!(m < t1))
+ return A.ioore(bytes, m);
+ buffer._contents += A.Primitives_stringFromCharCode(bytes[m]);
+ }
+ else
+ buffer._contents += A.String_String$fromCharCodes(bytes, i, markEnd);
+ if (markEnd === end)
+ break $label0$0;
+ i = i0;
+ } else
+ i = i0;
+ }
+ if (single && state > 32)
+ if (t2)
+ buffer._contents += A.Primitives_stringFromCharCode(_65533);
+ else {
+ _this._state = 77;
+ _this._charOrIndex = end;
+ return "";
+ }
+ _this._state = state;
+ _this._charOrIndex = char;
+ t1 = buffer._contents;
+ return t1.charCodeAt(0) == 0 ? t1 : t1;
+ }
+ };
+ A.NoSuchMethodError_toString_closure.prototype = {
+ call$2(key, value) {
+ var t1, t2, t3;
+ type$.Symbol._as(key);
+ t1 = this.sb;
+ t2 = this._box_0;
+ t3 = t1._contents += t2.comma;
+ t3 += key._name;
+ t1._contents = t3;
+ t1._contents = t3 + ": ";
+ t1._contents += A.Error_safeToString(value);
+ t2.comma = ", ";
+ },
+ $signature: 39
+ };
+ A.DateTime.prototype = {
+ $eq(_, other) {
+ if (other == null)
+ return false;
+ return other instanceof A.DateTime && this._core$_value === other._core$_value && true;
+ },
+ get$hashCode(_) {
+ var t1 = this._core$_value;
+ return (t1 ^ B.JSInt_methods._shrOtherPositive$1(t1, 30)) & 1073741823;
+ },
+ toString$0(_) {
+ var _this = this,
+ y = A.DateTime__fourDigits(A.Primitives_getYear(_this)),
+ m = A.DateTime__twoDigits(A.Primitives_getMonth(_this)),
+ d = A.DateTime__twoDigits(A.Primitives_getDay(_this)),
+ h = A.DateTime__twoDigits(A.Primitives_getHours(_this)),
+ min = A.DateTime__twoDigits(A.Primitives_getMinutes(_this)),
+ sec = A.DateTime__twoDigits(A.Primitives_getSeconds(_this)),
+ ms = A.DateTime__threeDigits(A.Primitives_getMilliseconds(_this));
+ return y + "-" + m + "-" + d + " " + h + ":" + min + ":" + sec + "." + ms + "Z";
+ }
+ };
+ A.Duration.prototype = {
+ $eq(_, other) {
+ if (other == null)
+ return false;
+ return other instanceof A.Duration && this._duration === other._duration;
+ },
+ get$hashCode(_) {
+ return B.JSInt_methods.get$hashCode(this._duration);
+ },
+ toString$0(_) {
+ var minutes, minutesPadding, seconds, secondsPadding,
+ microseconds = this._duration,
+ hours = B.JSInt_methods._tdivFast$1(microseconds, 3600000000);
+ microseconds %= 3600000000;
+ minutes = B.JSInt_methods._tdivFast$1(microseconds, 60000000);
+ microseconds %= 60000000;
+ minutesPadding = minutes < 10 ? "0" : "";
+ seconds = B.JSInt_methods._tdivFast$1(microseconds, 1000000);
+ secondsPadding = seconds < 10 ? "0" : "";
+ return "" + hours + ":" + minutesPadding + minutes + ":" + secondsPadding + seconds + "." + B.JSString_methods.padLeft$2(B.JSInt_methods.toString$0(microseconds % 1000000), 6, "0");
+ }
+ };
+ A.Error.prototype = {
+ get$stackTrace() {
+ return A.getTraceFromException(this.$thrownJsError);
+ }
+ };
+ A.AssertionError.prototype = {
+ toString$0(_) {
+ var t1 = this.message;
+ if (t1 != null)
+ return "Assertion failed: " + A.Error_safeToString(t1);
+ return "Assertion failed";
+ }
+ };
+ A.TypeError.prototype = {};
+ A.ArgumentError.prototype = {
+ get$_errorName() {
+ return "Invalid argument" + (!this._hasValue ? "(s)" : "");
+ },
+ get$_errorExplanation() {
+ return "";
+ },
+ toString$0(_) {
+ var _this = this,
+ $name = _this.name,
+ nameString = $name == null ? "" : " (" + $name + ")",
+ message = _this.message,
+ messageString = message == null ? "" : ": " + A.S(message),
+ prefix = _this.get$_errorName() + nameString + messageString;
+ if (!_this._hasValue)
+ return prefix;
+ return prefix + _this.get$_errorExplanation() + ": " + A.Error_safeToString(_this.get$invalidValue());
+ },
+ get$invalidValue() {
+ return this.invalidValue;
+ }
+ };
+ A.RangeError.prototype = {
+ get$invalidValue() {
+ return A._asNumQ(this.invalidValue);
+ },
+ get$_errorName() {
+ return "RangeError";
+ },
+ get$_errorExplanation() {
+ var explanation,
+ start = this.start,
+ end = this.end;
+ if (start == null)
+ explanation = end != null ? ": Not less than or equal to " + A.S(end) : "";
+ else if (end == null)
+ explanation = ": Not greater than or equal to " + A.S(start);
+ else if (end > start)
+ explanation = ": Not in inclusive range " + A.S(start) + ".." + A.S(end);
+ else
+ explanation = end < start ? ": Valid value range is empty" : ": Only valid value is " + A.S(start);
+ return explanation;
+ }
+ };
+ A.IndexError.prototype = {
+ get$invalidValue() {
+ return A._asInt(this.invalidValue);
+ },
+ get$_errorName() {
+ return "RangeError";
+ },
+ get$_errorExplanation() {
+ if (A._asInt(this.invalidValue) < 0)
+ return ": index must not be negative";
+ var t1 = this.length;
+ if (t1 === 0)
+ return ": no indices are valid";
+ return ": index should be less than " + t1;
+ },
+ get$length(receiver) {
+ return this.length;
+ }
+ };
+ A.NoSuchMethodError.prototype = {
+ toString$0(_) {
+ var $arguments, t1, _i, t2, t3, argument, receiverText, actualParameters, _this = this, _box_0 = {},
+ sb = new A.StringBuffer("");
+ _box_0.comma = "";
+ $arguments = _this._core$_arguments;
+ for (t1 = $arguments.length, _i = 0, t2 = "", t3 = ""; _i < t1; ++_i, t3 = ", ") {
+ argument = $arguments[_i];
+ sb._contents = t2 + t3;
+ t2 = sb._contents += A.Error_safeToString(argument);
+ _box_0.comma = ", ";
+ }
+ _this._namedArguments.forEach$1(0, new A.NoSuchMethodError_toString_closure(_box_0, sb));
+ receiverText = A.Error_safeToString(_this._core$_receiver);
+ actualParameters = sb.toString$0(0);
+ return "NoSuchMethodError: method not found: '" + _this._core$_memberName._name + "'\nReceiver: " + receiverText + "\nArguments: [" + actualParameters + "]";
+ }
+ };
+ A.UnsupportedError.prototype = {
+ toString$0(_) {
+ return "Unsupported operation: " + this.message;
+ }
+ };
+ A.UnimplementedError.prototype = {
+ toString$0(_) {
+ return "UnimplementedError: " + this.message;
+ }
+ };
+ A.StateError.prototype = {
+ toString$0(_) {
+ return "Bad state: " + this.message;
+ }
+ };
+ A.ConcurrentModificationError.prototype = {
+ toString$0(_) {
+ var t1 = this.modifiedObject;
+ if (t1 == null)
+ return "Concurrent modification during iteration.";
+ return "Concurrent modification during iteration: " + A.Error_safeToString(t1) + ".";
+ }
+ };
+ A.OutOfMemoryError.prototype = {
+ toString$0(_) {
+ return "Out of Memory";
+ },
+ get$stackTrace() {
+ return null;
+ },
+ $isError: 1
+ };
+ A.StackOverflowError.prototype = {
+ toString$0(_) {
+ return "Stack Overflow";
+ },
+ get$stackTrace() {
+ return null;
+ },
+ $isError: 1
+ };
+ A._Exception.prototype = {
+ toString$0(_) {
+ return "Exception: " + this.message;
+ },
+ $isException: 1
+ };
+ A.FormatException.prototype = {
+ toString$0(_) {
+ var t1, lineEnd, lineNum, lineStart, previousCharWasCR, i, char, end, start, prefix, postfix,
+ message = this.message,
+ report = "" !== message ? "FormatException: " + message : "FormatException",
+ offset = this.offset,
+ source = this.source;
+ if (typeof source == "string") {
+ if (offset != null)
+ t1 = offset < 0 || offset > source.length;
+ else
+ t1 = false;
+ if (t1)
+ offset = null;
+ if (offset == null) {
+ if (source.length > 78)
+ source = B.JSString_methods.substring$2(source, 0, 75) + "...";
+ return report + "\n" + source;
+ }
+ for (lineEnd = source.length, lineNum = 1, lineStart = 0, previousCharWasCR = false, i = 0; i < offset; ++i) {
+ if (!(i < lineEnd))
+ return A.ioore(source, i);
+ char = source.charCodeAt(i);
+ if (char === 10) {
+ if (lineStart !== i || !previousCharWasCR)
+ ++lineNum;
+ lineStart = i + 1;
+ previousCharWasCR = false;
+ } else if (char === 13) {
+ ++lineNum;
+ lineStart = i + 1;
+ previousCharWasCR = true;
+ }
+ }
+ report = lineNum > 1 ? report + (" (at line " + lineNum + ", character " + (offset - lineStart + 1) + ")\n") : report + (" (at character " + (offset + 1) + ")\n");
+ for (i = offset; i < lineEnd; ++i) {
+ if (!(i >= 0))
+ return A.ioore(source, i);
+ char = source.charCodeAt(i);
+ if (char === 10 || char === 13) {
+ lineEnd = i;
+ break;
+ }
+ }
+ if (lineEnd - lineStart > 78)
+ if (offset - lineStart < 75) {
+ end = lineStart + 75;
+ start = lineStart;
+ prefix = "";
+ postfix = "...";
+ } else {
+ if (lineEnd - offset < 75) {
+ start = lineEnd - 75;
+ end = lineEnd;
+ postfix = "";
+ } else {
+ start = offset - 36;
+ end = offset + 36;
+ postfix = "...";
+ }
+ prefix = "...";
+ }
+ else {
+ end = lineEnd;
+ start = lineStart;
+ prefix = "";
+ postfix = "";
+ }
+ return report + prefix + B.JSString_methods.substring$2(source, start, end) + postfix + "\n" + B.JSString_methods.$mul(" ", offset - start + prefix.length) + "^\n";
+ } else
+ return offset != null ? report + (" (at offset " + A.S(offset) + ")") : report;
+ },
+ $isException: 1
+ };
+ A.Iterable.prototype = {
+ cast$1$0(_, $R) {
+ return A.CastIterable_CastIterable(this, A._instanceType(this)._eval$1("Iterable.E"), $R);
+ },
+ map$1$1(_, toElement, $T) {
+ var t1 = A._instanceType(this);
+ return A.MappedIterable_MappedIterable(this, t1._bind$1($T)._eval$1("1(Iterable.E)")._as(toElement), t1._eval$1("Iterable.E"), $T);
+ },
+ toList$1$growable(_, growable) {
+ return A.List_List$of(this, growable, A._instanceType(this)._eval$1("Iterable.E"));
+ },
+ toList$0($receiver) {
+ return this.toList$1$growable($receiver, true);
+ },
+ get$length(_) {
+ var count,
+ it = this.get$iterator(this);
+ for (count = 0; it.moveNext$0();)
+ ++count;
+ return count;
+ },
+ get$isEmpty(_) {
+ return !this.get$iterator(this).moveNext$0();
+ },
+ get$isNotEmpty(_) {
+ return !this.get$isEmpty(this);
+ },
+ skip$1(_, count) {
+ return A.SkipIterable_SkipIterable(this, count, A._instanceType(this)._eval$1("Iterable.E"));
+ },
+ skipWhile$1(_, test) {
+ var t1 = A._instanceType(this);
+ return new A.SkipWhileIterable(this, t1._eval$1("bool(Iterable.E)")._as(test), t1._eval$1("SkipWhileIterable<Iterable.E>"));
+ },
+ get$first(_) {
+ var it = this.get$iterator(this);
+ if (!it.moveNext$0())
+ throw A.wrapException(A.IterableElementError_noElement());
+ return it.get$current(it);
+ },
+ get$last(_) {
+ var result,
+ it = this.get$iterator(this);
+ if (!it.moveNext$0())
+ throw A.wrapException(A.IterableElementError_noElement());
+ do
+ result = it.get$current(it);
+ while (it.moveNext$0());
+ return result;
+ },
+ elementAt$1(_, index) {
+ var iterator, skipCount;
+ A.RangeError_checkNotNegative(index, "index");
+ iterator = this.get$iterator(this);
+ for (skipCount = index; iterator.moveNext$0();) {
+ if (skipCount === 0)
+ return iterator.get$current(iterator);
+ --skipCount;
+ }
+ throw A.wrapException(A.IndexError$withLength(index, index - skipCount, this, "index"));
+ },
+ toString$0(_) {
+ return A.Iterable_iterableToShortString(this, "(", ")");
+ }
+ };
+ A.Null.prototype = {
+ get$hashCode(_) {
+ return A.Object.prototype.get$hashCode.call(this, this);
+ },
+ toString$0(_) {
+ return "null";
+ }
+ };
+ A.Object.prototype = {$isObject: 1,
+ $eq(_, other) {
+ return this === other;
+ },
+ get$hashCode(_) {
+ return A.Primitives_objectHashCode(this);
+ },
+ toString$0(_) {
+ return "Instance of '" + A.Primitives_objectTypeName(this) + "'";
+ },
+ noSuchMethod$1(_, invocation) {
+ throw A.wrapException(A.NoSuchMethodError_NoSuchMethodError$withInvocation(this, type$.Invocation._as(invocation)));
+ },
+ get$runtimeType(_) {
+ return A.getRuntimeTypeOfDartObject(this);
+ },
+ toString() {
+ return this.toString$0(this);
+ }
+ };
+ A._StringStackTrace.prototype = {
+ toString$0(_) {
+ return this._stackTrace;
+ },
+ $isStackTrace: 1
+ };
+ A.StringBuffer.prototype = {
+ get$length(_) {
+ return this._contents.length;
+ },
+ write$1(_, obj) {
+ this._contents += A.S(obj);
+ },
+ writeCharCode$1(charCode) {
+ this._contents += A.Primitives_stringFromCharCode(charCode);
+ },
+ toString$0(_) {
+ var t1 = this._contents;
+ return t1.charCodeAt(0) == 0 ? t1 : t1;
+ },
+ $isStringSink: 1
+ };
+ A.Uri_splitQueryString_closure.prototype = {
+ call$2(map, element) {
+ var index, key, value, t1;
+ type$.Map_String_String._as(map);
+ A._asString(element);
+ index = B.JSString_methods.indexOf$1(element, "=");
+ if (index === -1) {
+ if (element !== "")
+ J.$indexSet$ax(map, A._Uri__uriDecode(element, 0, element.length, this.encoding, true), "");
+ } else if (index !== 0) {
+ key = B.JSString_methods.substring$2(element, 0, index);
+ value = B.JSString_methods.substring$1(element, index + 1);
+ t1 = this.encoding;
+ J.$indexSet$ax(map, A._Uri__uriDecode(key, 0, key.length, t1, true), A._Uri__uriDecode(value, 0, value.length, t1, true));
+ }
+ return map;
+ },
+ $signature: 40
+ };
+ A.Uri__parseIPv4Address_error.prototype = {
+ call$2(msg, position) {
+ throw A.wrapException(A.FormatException$("Illegal IPv4 address, " + msg, this.host, position));
+ },
+ $signature: 25
+ };
+ A.Uri_parseIPv6Address_error.prototype = {
+ call$2(msg, position) {
+ throw A.wrapException(A.FormatException$("Illegal IPv6 address, " + msg, this.host, position));
+ },
+ $signature: 45
+ };
+ A.Uri_parseIPv6Address_parseHex.prototype = {
+ call$2(start, end) {
+ var value;
+ if (end - start > 4)
+ this.error.call$2("an IPv6 part can only contain a maximum of 4 hex digits", start);
+ value = A.int_parse(B.JSString_methods.substring$2(this.host, start, end), 16);
+ if (value < 0 || value > 65535)
+ this.error.call$2("each part must be in the range of `0x0..0xFFFF`", start);
+ return value;
+ },
+ $signature: 46
+ };
+ A._Uri.prototype = {
+ get$_text() {
+ var t1, t2, t3, t4, _this = this,
+ value = _this.___Uri__text_FI;
+ if (value === $) {
+ t1 = _this.scheme;
+ t2 = t1.length !== 0 ? "" + t1 + ":" : "";
+ t3 = _this._host;
+ t4 = t3 == null;
+ if (!t4 || t1 === "file") {
+ t1 = t2 + "//";
+ t2 = _this._userInfo;
+ if (t2.length !== 0)
+ t1 = t1 + t2 + "@";
+ if (!t4)
+ t1 += t3;
+ t2 = _this._port;
+ if (t2 != null)
+ t1 = t1 + ":" + A.S(t2);
+ } else
+ t1 = t2;
+ t1 += _this.path;
+ t2 = _this._query;
+ if (t2 != null)
+ t1 = t1 + "?" + t2;
+ t2 = _this._fragment;
+ if (t2 != null)
+ t1 = t1 + "#" + t2;
+ value !== $ && A.throwLateFieldADI("_text");
+ value = _this.___Uri__text_FI = t1.charCodeAt(0) == 0 ? t1 : t1;
+ }
+ return value;
+ },
+ get$pathSegments() {
+ var pathToSplit, t1, result, _this = this,
+ value = _this.___Uri_pathSegments_FI;
+ if (value === $) {
+ pathToSplit = _this.path;
+ t1 = pathToSplit.length;
+ if (t1 !== 0) {
+ if (0 >= t1)
+ return A.ioore(pathToSplit, 0);
+ t1 = pathToSplit.charCodeAt(0) === 47;
+ } else
+ t1 = false;
+ if (t1)
+ pathToSplit = B.JSString_methods.substring$1(pathToSplit, 1);
+ result = pathToSplit.length === 0 ? B.List_empty : A.List_List$unmodifiable(new A.MappedListIterable(A._setArrayType(pathToSplit.split("/"), type$.JSArray_String), type$.dynamic_Function_String._as(A.core_Uri_decodeComponent$closure()), type$.MappedListIterable_String_dynamic), type$.String);
+ _this.___Uri_pathSegments_FI !== $ && A.throwLateFieldADI("pathSegments");
+ _this.set$___Uri_pathSegments_FI(result);
+ value = result;
+ }
+ return value;
+ },
+ get$hashCode(_) {
+ var result, _this = this,
+ value = _this.___Uri_hashCode_FI;
+ if (value === $) {
+ result = B.JSString_methods.get$hashCode(_this.get$_text());
+ _this.___Uri_hashCode_FI !== $ && A.throwLateFieldADI("hashCode");
+ _this.___Uri_hashCode_FI = result;
+ value = result;
+ }
+ return value;
+ },
+ get$queryParameters() {
+ var t1, result, _this = this,
+ value = _this.___Uri_queryParameters_FI;
+ if (value === $) {
+ t1 = _this._query;
+ result = new A.UnmodifiableMapView(A.Uri_splitQueryString(t1 == null ? "" : t1), type$.UnmodifiableMapView_String_String);
+ _this.___Uri_queryParameters_FI !== $ && A.throwLateFieldADI("queryParameters");
+ _this.set$___Uri_queryParameters_FI(result);
+ value = result;
+ }
+ return value;
+ },
+ get$userInfo() {
+ return this._userInfo;
+ },
+ get$host(_) {
+ var host = this._host;
+ if (host == null)
+ return "";
+ if (B.JSString_methods.startsWith$1(host, "["))
+ return B.JSString_methods.substring$2(host, 1, host.length - 1);
+ return host;
+ },
+ get$port(_) {
+ var t1 = this._port;
+ return t1 == null ? A._Uri__defaultPort(this.scheme) : t1;
+ },
+ get$query(_) {
+ var t1 = this._query;
+ return t1 == null ? "" : t1;
+ },
+ get$fragment() {
+ var t1 = this._fragment;
+ return t1 == null ? "" : t1;
+ },
+ isScheme$1(scheme) {
+ var thisScheme = this.scheme;
+ if (scheme.length !== thisScheme.length)
+ return false;
+ return A._caseInsensitiveCompareStart(scheme, thisScheme, 0) >= 0;
+ },
+ removeFragment$0() {
+ var _this = this;
+ if (_this._fragment == null)
+ return _this;
+ return A._Uri$_internal(_this.scheme, _this._userInfo, _this._host, _this._port, _this.path, _this._query, null);
+ },
+ _mergePaths$2(base, reference) {
+ var backCount, refStart, baseEnd, t1, newEnd, delta, t2, t3;
+ for (backCount = 0, refStart = 0; B.JSString_methods.startsWith$2(reference, "../", refStart);) {
+ refStart += 3;
+ ++backCount;
+ }
+ baseEnd = B.JSString_methods.lastIndexOf$1(base, "/");
+ t1 = base.length;
+ while (true) {
+ if (!(baseEnd > 0 && backCount > 0))
+ break;
+ newEnd = B.JSString_methods.lastIndexOf$2(base, "/", baseEnd - 1);
+ if (newEnd < 0)
+ break;
+ delta = baseEnd - newEnd;
+ t2 = delta !== 2;
+ if (!t2 || delta === 3) {
+ t3 = newEnd + 1;
+ if (!(t3 < t1))
+ return A.ioore(base, t3);
+ if (base.charCodeAt(t3) === 46)
+ if (t2) {
+ t2 = newEnd + 2;
+ if (!(t2 < t1))
+ return A.ioore(base, t2);
+ t2 = base.charCodeAt(t2) === 46;
+ } else
+ t2 = true;
+ else
+ t2 = false;
+ } else
+ t2 = false;
+ if (t2)
+ break;
+ --backCount;
+ baseEnd = newEnd;
+ }
+ return B.JSString_methods.replaceRange$3(base, baseEnd + 1, null, B.JSString_methods.substring$1(reference, refStart - 3 * backCount));
+ },
+ resolve$1(reference) {
+ return this.resolveUri$1(A.Uri_parse(reference));
+ },
+ resolveUri$1(reference) {
+ var targetScheme, targetUserInfo, targetHost, targetPort, targetPath, targetQuery, packageNameEnd, packageName, mergedPath, t1, _this = this, _null = null;
+ if (reference.get$scheme().length !== 0) {
+ targetScheme = reference.get$scheme();
+ if (reference.get$hasAuthority()) {
+ targetUserInfo = reference.get$userInfo();
+ targetHost = reference.get$host(reference);
+ targetPort = reference.get$hasPort() ? reference.get$port(reference) : _null;
+ } else {
+ targetPort = _null;
+ targetHost = targetPort;
+ targetUserInfo = "";
+ }
+ targetPath = A._Uri__removeDotSegments(reference.get$path(reference));
+ targetQuery = reference.get$hasQuery() ? reference.get$query(reference) : _null;
+ } else {
+ targetScheme = _this.scheme;
+ if (reference.get$hasAuthority()) {
+ targetUserInfo = reference.get$userInfo();
+ targetHost = reference.get$host(reference);
+ targetPort = A._Uri__makePort(reference.get$hasPort() ? reference.get$port(reference) : _null, targetScheme);
+ targetPath = A._Uri__removeDotSegments(reference.get$path(reference));
+ targetQuery = reference.get$hasQuery() ? reference.get$query(reference) : _null;
+ } else {
+ targetUserInfo = _this._userInfo;
+ targetHost = _this._host;
+ targetPort = _this._port;
+ targetPath = _this.path;
+ if (reference.get$path(reference) === "")
+ targetQuery = reference.get$hasQuery() ? reference.get$query(reference) : _this._query;
+ else {
+ packageNameEnd = A._Uri__packageNameEnd(_this, targetPath);
+ if (packageNameEnd > 0) {
+ packageName = B.JSString_methods.substring$2(targetPath, 0, packageNameEnd);
+ targetPath = reference.get$hasAbsolutePath() ? packageName + A._Uri__removeDotSegments(reference.get$path(reference)) : packageName + A._Uri__removeDotSegments(_this._mergePaths$2(B.JSString_methods.substring$1(targetPath, packageName.length), reference.get$path(reference)));
+ } else if (reference.get$hasAbsolutePath())
+ targetPath = A._Uri__removeDotSegments(reference.get$path(reference));
+ else if (targetPath.length === 0)
+ if (targetHost == null)
+ targetPath = targetScheme.length === 0 ? reference.get$path(reference) : A._Uri__removeDotSegments(reference.get$path(reference));
+ else
+ targetPath = A._Uri__removeDotSegments("/" + reference.get$path(reference));
+ else {
+ mergedPath = _this._mergePaths$2(targetPath, reference.get$path(reference));
+ t1 = targetScheme.length === 0;
+ if (!t1 || targetHost != null || B.JSString_methods.startsWith$1(targetPath, "/"))
+ targetPath = A._Uri__removeDotSegments(mergedPath);
+ else
+ targetPath = A._Uri__normalizeRelativePath(mergedPath, !t1 || targetHost != null);
+ }
+ targetQuery = reference.get$hasQuery() ? reference.get$query(reference) : _null;
+ }
+ }
+ }
+ return A._Uri$_internal(targetScheme, targetUserInfo, targetHost, targetPort, targetPath, targetQuery, reference.get$hasFragment() ? reference.get$fragment() : _null);
+ },
+ get$hasAuthority() {
+ return this._host != null;
+ },
+ get$hasPort() {
+ return this._port != null;
+ },
+ get$hasQuery() {
+ return this._query != null;
+ },
+ get$hasFragment() {
+ return this._fragment != null;
+ },
+ get$hasAbsolutePath() {
+ return B.JSString_methods.startsWith$1(this.path, "/");
+ },
+ toFilePath$0() {
+ var pathSegments, _this = this,
+ t1 = _this.scheme;
+ if (t1 !== "" && t1 !== "file")
+ throw A.wrapException(A.UnsupportedError$("Cannot extract a file path from a " + t1 + " URI"));
+ t1 = _this._query;
+ if ((t1 == null ? "" : t1) !== "")
+ throw A.wrapException(A.UnsupportedError$(string$.Cannotfq));
+ t1 = _this._fragment;
+ if ((t1 == null ? "" : t1) !== "")
+ throw A.wrapException(A.UnsupportedError$(string$.Cannotff));
+ t1 = $.$get$_Uri__isWindowsCached();
+ if (t1)
+ t1 = A._Uri__toWindowsFilePath(_this);
+ else {
+ if (_this._host != null && _this.get$host(_this) !== "")
+ A.throwExpression(A.UnsupportedError$(string$.Cannotn));
+ pathSegments = _this.get$pathSegments();
+ A._Uri__checkNonWindowsPathReservedCharacters(pathSegments, false);
+ t1 = A.StringBuffer__writeAll(B.JSString_methods.startsWith$1(_this.path, "/") ? "" + "/" : "", pathSegments, "/");
+ t1 = t1.charCodeAt(0) == 0 ? t1 : t1;
+ }
+ return t1;
+ },
+ toString$0(_) {
+ return this.get$_text();
+ },
+ $eq(_, other) {
+ var t1, t2, _this = this;
+ if (other == null)
+ return false;
+ if (_this === other)
+ return true;
+ if (type$.Uri._is(other))
+ if (_this.scheme === other.get$scheme())
+ if (_this._host != null === other.get$hasAuthority())
+ if (_this._userInfo === other.get$userInfo())
+ if (_this.get$host(_this) === other.get$host(other))
+ if (_this.get$port(_this) === other.get$port(other))
+ if (_this.path === other.get$path(other)) {
+ t1 = _this._query;
+ t2 = t1 == null;
+ if (!t2 === other.get$hasQuery()) {
+ if (t2)
+ t1 = "";
+ if (t1 === other.get$query(other)) {
+ t1 = _this._fragment;
+ t2 = t1 == null;
+ if (!t2 === other.get$hasFragment()) {
+ if (t2)
+ t1 = "";
+ t1 = t1 === other.get$fragment();
+ } else
+ t1 = false;
+ } else
+ t1 = false;
+ } else
+ t1 = false;
+ } else
+ t1 = false;
+ else
+ t1 = false;
+ else
+ t1 = false;
+ else
+ t1 = false;
+ else
+ t1 = false;
+ else
+ t1 = false;
+ else
+ t1 = false;
+ return t1;
+ },
+ set$___Uri_pathSegments_FI(___Uri_pathSegments_FI) {
+ this.___Uri_pathSegments_FI = type$.List_String._as(___Uri_pathSegments_FI);
+ },
+ set$___Uri_queryParameters_FI(___Uri_queryParameters_FI) {
+ this.___Uri_queryParameters_FI = type$.Map_String_String._as(___Uri_queryParameters_FI);
+ },
+ $isUri: 1,
+ get$scheme() {
+ return this.scheme;
+ },
+ get$path(receiver) {
+ return this.path;
+ }
+ };
+ A._Uri__makePath_closure.prototype = {
+ call$1(s) {
+ return A._Uri__uriEncode(B.List_XRg0, A._asString(s), B.C_Utf8Codec, false);
+ },
+ $signature: 17
+ };
+ A.UriData.prototype = {
+ get$uri() {
+ var t2, queryIndex, end, query, _this = this, _null = null,
+ t1 = _this._uriCache;
+ if (t1 == null) {
+ t1 = _this._separatorIndices;
+ if (0 >= t1.length)
+ return A.ioore(t1, 0);
+ t2 = _this._text;
+ t1 = t1[0] + 1;
+ queryIndex = B.JSString_methods.indexOf$2(t2, "?", t1);
+ end = t2.length;
+ if (queryIndex >= 0) {
+ query = A._Uri__normalizeOrSubstring(t2, queryIndex + 1, end, B.List_oFp, false, false);
+ end = queryIndex;
+ } else
+ query = _null;
+ t1 = _this._uriCache = new A._DataUri("data", "", _null, _null, A._Uri__normalizeOrSubstring(t2, t1, end, B.List_XRg, false, false), query, _null);
+ }
+ return t1;
+ },
+ toString$0(_) {
+ var t2,
+ t1 = this._separatorIndices;
+ if (0 >= t1.length)
+ return A.ioore(t1, 0);
+ t2 = this._text;
+ return t1[0] === -1 ? "data:" + t2 : t2;
+ }
+ };
+ A._createTables_build.prototype = {
+ call$2(state, defaultTransition) {
+ var t1 = this.tables;
+ if (!(state < t1.length))
+ return A.ioore(t1, state);
+ t1 = t1[state];
+ B.NativeUint8List_methods.fillRange$3(t1, 0, 96, defaultTransition);
+ return t1;
+ },
+ $signature: 61
+ };
+ A._createTables_setChars.prototype = {
+ call$3(target, chars, transition) {
+ var t1, i, t2;
+ for (t1 = chars.length, i = 0; i < t1; ++i) {
+ t2 = chars.charCodeAt(i) ^ 96;
+ if (!(t2 < 96))
+ return A.ioore(target, t2);
+ target[t2] = transition;
+ }
+ },
+ $signature: 18
+ };
+ A._createTables_setRange.prototype = {
+ call$3(target, range, transition) {
+ var i, n,
+ t1 = range.length;
+ if (0 >= t1)
+ return A.ioore(range, 0);
+ i = range.charCodeAt(0);
+ if (1 >= t1)
+ return A.ioore(range, 1);
+ n = range.charCodeAt(1);
+ for (; i <= n; ++i) {
+ t1 = (i ^ 96) >>> 0;
+ if (!(t1 < 96))
+ return A.ioore(target, t1);
+ target[t1] = transition;
+ }
+ },
+ $signature: 18
+ };
+ A._SimpleUri.prototype = {
+ get$hasAuthority() {
+ return this._hostStart > 0;
+ },
+ get$hasPort() {
+ return this._hostStart > 0 && this._portStart + 1 < this._pathStart;
+ },
+ get$hasQuery() {
+ return this._queryStart < this._fragmentStart;
+ },
+ get$hasFragment() {
+ return this._fragmentStart < this._uri.length;
+ },
+ get$hasAbsolutePath() {
+ return B.JSString_methods.startsWith$2(this._uri, "/", this._pathStart);
+ },
+ get$scheme() {
+ var t1 = this._schemeCache;
+ return t1 == null ? this._schemeCache = this._computeScheme$0() : t1;
+ },
+ _computeScheme$0() {
+ var t2, _this = this,
+ t1 = _this._schemeEnd;
+ if (t1 <= 0)
+ return "";
+ t2 = t1 === 4;
+ if (t2 && B.JSString_methods.startsWith$1(_this._uri, "http"))
+ return "http";
+ if (t1 === 5 && B.JSString_methods.startsWith$1(_this._uri, "https"))
+ return "https";
+ if (t2 && B.JSString_methods.startsWith$1(_this._uri, "file"))
+ return "file";
+ if (t1 === 7 && B.JSString_methods.startsWith$1(_this._uri, "package"))
+ return "package";
+ return B.JSString_methods.substring$2(_this._uri, 0, t1);
+ },
+ get$userInfo() {
+ var t1 = this._hostStart,
+ t2 = this._schemeEnd + 3;
+ return t1 > t2 ? B.JSString_methods.substring$2(this._uri, t2, t1 - 1) : "";
+ },
+ get$host(_) {
+ var t1 = this._hostStart;
+ return t1 > 0 ? B.JSString_methods.substring$2(this._uri, t1, this._portStart) : "";
+ },
+ get$port(_) {
+ var t1, _this = this;
+ if (_this.get$hasPort())
+ return A.int_parse(B.JSString_methods.substring$2(_this._uri, _this._portStart + 1, _this._pathStart), null);
+ t1 = _this._schemeEnd;
+ if (t1 === 4 && B.JSString_methods.startsWith$1(_this._uri, "http"))
+ return 80;
+ if (t1 === 5 && B.JSString_methods.startsWith$1(_this._uri, "https"))
+ return 443;
+ return 0;
+ },
+ get$path(_) {
+ return B.JSString_methods.substring$2(this._uri, this._pathStart, this._queryStart);
+ },
+ get$query(_) {
+ var t1 = this._queryStart,
+ t2 = this._fragmentStart;
+ return t1 < t2 ? B.JSString_methods.substring$2(this._uri, t1 + 1, t2) : "";
+ },
+ get$fragment() {
+ var t1 = this._fragmentStart,
+ t2 = this._uri;
+ return t1 < t2.length ? B.JSString_methods.substring$1(t2, t1 + 1) : "";
+ },
+ get$pathSegments() {
+ var parts, t2, i,
+ start = this._pathStart,
+ end = this._queryStart,
+ t1 = this._uri;
+ if (B.JSString_methods.startsWith$2(t1, "/", start))
+ ++start;
+ if (start === end)
+ return B.List_empty;
+ parts = A._setArrayType([], type$.JSArray_String);
+ for (t2 = t1.length, i = start; i < end; ++i) {
+ if (!(i >= 0 && i < t2))
+ return A.ioore(t1, i);
+ if (t1.charCodeAt(i) === 47) {
+ B.JSArray_methods.add$1(parts, B.JSString_methods.substring$2(t1, start, i));
+ start = i + 1;
+ }
+ }
+ B.JSArray_methods.add$1(parts, B.JSString_methods.substring$2(t1, start, end));
+ return A.List_List$unmodifiable(parts, type$.String);
+ },
+ get$queryParameters() {
+ var _this = this;
+ if (_this._queryStart >= _this._fragmentStart)
+ return B.Map_empty;
+ return new A.UnmodifiableMapView(A.Uri_splitQueryString(_this.get$query(_this)), type$.UnmodifiableMapView_String_String);
+ },
+ _isPort$1(port) {
+ var portDigitStart = this._portStart + 1;
+ return portDigitStart + port.length === this._pathStart && B.JSString_methods.startsWith$2(this._uri, port, portDigitStart);
+ },
+ removeFragment$0() {
+ var _this = this,
+ t1 = _this._fragmentStart,
+ t2 = _this._uri;
+ if (t1 >= t2.length)
+ return _this;
+ return new A._SimpleUri(B.JSString_methods.substring$2(t2, 0, t1), _this._schemeEnd, _this._hostStart, _this._portStart, _this._pathStart, _this._queryStart, t1, _this._schemeCache);
+ },
+ resolve$1(reference) {
+ return this.resolveUri$1(A.Uri_parse(reference));
+ },
+ resolveUri$1(reference) {
+ if (reference instanceof A._SimpleUri)
+ return this._simpleMerge$2(this, reference);
+ return this._toNonSimple$0().resolveUri$1(reference);
+ },
+ _simpleMerge$2(base, ref) {
+ var t2, t3, t4, isSimple, delta, refStart, basePathStart, packageNameEnd, basePathStart0, baseStart, baseEnd, baseUri, baseStart0, backCount, refStart0, insert,
+ t1 = ref._schemeEnd;
+ if (t1 > 0)
+ return ref;
+ t2 = ref._hostStart;
+ if (t2 > 0) {
+ t3 = base._schemeEnd;
+ if (t3 <= 0)
+ return ref;
+ t4 = t3 === 4;
+ if (t4 && B.JSString_methods.startsWith$1(base._uri, "file"))
+ isSimple = ref._pathStart !== ref._queryStart;
+ else if (t4 && B.JSString_methods.startsWith$1(base._uri, "http"))
+ isSimple = !ref._isPort$1("80");
+ else
+ isSimple = !(t3 === 5 && B.JSString_methods.startsWith$1(base._uri, "https")) || !ref._isPort$1("443");
+ if (isSimple) {
+ delta = t3 + 1;
+ return new A._SimpleUri(B.JSString_methods.substring$2(base._uri, 0, delta) + B.JSString_methods.substring$1(ref._uri, t1 + 1), t3, t2 + delta, ref._portStart + delta, ref._pathStart + delta, ref._queryStart + delta, ref._fragmentStart + delta, base._schemeCache);
+ } else
+ return this._toNonSimple$0().resolveUri$1(ref);
+ }
+ refStart = ref._pathStart;
+ t1 = ref._queryStart;
+ if (refStart === t1) {
+ t2 = ref._fragmentStart;
+ if (t1 < t2) {
+ t3 = base._queryStart;
+ delta = t3 - t1;
+ return new A._SimpleUri(B.JSString_methods.substring$2(base._uri, 0, t3) + B.JSString_methods.substring$1(ref._uri, t1), base._schemeEnd, base._hostStart, base._portStart, base._pathStart, t1 + delta, t2 + delta, base._schemeCache);
+ }
+ t1 = ref._uri;
+ if (t2 < t1.length) {
+ t3 = base._fragmentStart;
+ return new A._SimpleUri(B.JSString_methods.substring$2(base._uri, 0, t3) + B.JSString_methods.substring$1(t1, t2), base._schemeEnd, base._hostStart, base._portStart, base._pathStart, base._queryStart, t2 + (t3 - t2), base._schemeCache);
+ }
+ return base.removeFragment$0();
+ }
+ t2 = ref._uri;
+ if (B.JSString_methods.startsWith$2(t2, "/", refStart)) {
+ basePathStart = base._pathStart;
+ packageNameEnd = A._SimpleUri__packageNameEnd(this);
+ basePathStart0 = packageNameEnd > 0 ? packageNameEnd : basePathStart;
+ delta = basePathStart0 - refStart;
+ return new A._SimpleUri(B.JSString_methods.substring$2(base._uri, 0, basePathStart0) + B.JSString_methods.substring$1(t2, refStart), base._schemeEnd, base._hostStart, base._portStart, basePathStart, t1 + delta, ref._fragmentStart + delta, base._schemeCache);
+ }
+ baseStart = base._pathStart;
+ baseEnd = base._queryStart;
+ if (baseStart === baseEnd && base._hostStart > 0) {
+ for (; B.JSString_methods.startsWith$2(t2, "../", refStart);)
+ refStart += 3;
+ delta = baseStart - refStart + 1;
+ return new A._SimpleUri(B.JSString_methods.substring$2(base._uri, 0, baseStart) + "/" + B.JSString_methods.substring$1(t2, refStart), base._schemeEnd, base._hostStart, base._portStart, baseStart, t1 + delta, ref._fragmentStart + delta, base._schemeCache);
+ }
+ baseUri = base._uri;
+ packageNameEnd = A._SimpleUri__packageNameEnd(this);
+ if (packageNameEnd >= 0)
+ baseStart0 = packageNameEnd;
+ else
+ for (baseStart0 = baseStart; B.JSString_methods.startsWith$2(baseUri, "../", baseStart0);)
+ baseStart0 += 3;
+ backCount = 0;
+ while (true) {
+ refStart0 = refStart + 3;
+ if (!(refStart0 <= t1 && B.JSString_methods.startsWith$2(t2, "../", refStart)))
+ break;
+ ++backCount;
+ refStart = refStart0;
+ }
+ for (t3 = baseUri.length, insert = ""; baseEnd > baseStart0;) {
+ --baseEnd;
+ if (!(baseEnd >= 0 && baseEnd < t3))
+ return A.ioore(baseUri, baseEnd);
+ if (baseUri.charCodeAt(baseEnd) === 47) {
+ if (backCount === 0) {
+ insert = "/";
+ break;
+ }
+ --backCount;
+ insert = "/";
+ }
+ }
+ if (baseEnd === baseStart0 && base._schemeEnd <= 0 && !B.JSString_methods.startsWith$2(baseUri, "/", baseStart)) {
+ refStart -= backCount * 3;
+ insert = "";
+ }
+ delta = baseEnd - refStart + insert.length;
+ return new A._SimpleUri(B.JSString_methods.substring$2(baseUri, 0, baseEnd) + insert + B.JSString_methods.substring$1(t2, refStart), base._schemeEnd, base._hostStart, base._portStart, baseStart, t1 + delta, ref._fragmentStart + delta, base._schemeCache);
+ },
+ toFilePath$0() {
+ var t2, t3, _this = this,
+ t1 = _this._schemeEnd;
+ if (t1 >= 0) {
+ t2 = !(t1 === 4 && B.JSString_methods.startsWith$1(_this._uri, "file"));
+ t1 = t2;
+ } else
+ t1 = false;
+ if (t1)
+ throw A.wrapException(A.UnsupportedError$("Cannot extract a file path from a " + _this.get$scheme() + " URI"));
+ t1 = _this._queryStart;
+ t2 = _this._uri;
+ if (t1 < t2.length) {
+ if (t1 < _this._fragmentStart)
+ throw A.wrapException(A.UnsupportedError$(string$.Cannotfq));
+ throw A.wrapException(A.UnsupportedError$(string$.Cannotff));
+ }
+ t3 = $.$get$_Uri__isWindowsCached();
+ if (t3)
+ t1 = A._Uri__toWindowsFilePath(_this);
+ else {
+ if (_this._hostStart < _this._portStart)
+ A.throwExpression(A.UnsupportedError$(string$.Cannotn));
+ t1 = B.JSString_methods.substring$2(t2, _this._pathStart, t1);
+ }
+ return t1;
+ },
+ get$hashCode(_) {
+ var t1 = this._hashCodeCache;
+ return t1 == null ? this._hashCodeCache = B.JSString_methods.get$hashCode(this._uri) : t1;
+ },
+ $eq(_, other) {
+ if (other == null)
+ return false;
+ if (this === other)
+ return true;
+ return type$.Uri._is(other) && this._uri === other.toString$0(0);
+ },
+ _toNonSimple$0() {
+ var _this = this, _null = null,
+ t1 = _this.get$scheme(),
+ t2 = _this.get$userInfo(),
+ t3 = _this._hostStart > 0 ? _this.get$host(_this) : _null,
+ t4 = _this.get$hasPort() ? _this.get$port(_this) : _null,
+ t5 = _this._uri,
+ t6 = _this._queryStart,
+ t7 = B.JSString_methods.substring$2(t5, _this._pathStart, t6),
+ t8 = _this._fragmentStart;
+ t6 = t6 < t8 ? _this.get$query(_this) : _null;
+ return A._Uri$_internal(t1, t2, t3, t4, t7, t6, t8 < t5.length ? _this.get$fragment() : _null);
+ },
+ toString$0(_) {
+ return this._uri;
+ },
+ $isUri: 1
+ };
+ A._DataUri.prototype = {};
+ A.HtmlElement.prototype = {};
+ A.AccessibleNodeList.prototype = {
+ get$length(receiver) {
+ return receiver.length;
+ }
+ };
+ A.AnchorElement.prototype = {
+ toString$0(receiver) {
+ var t1 = String(receiver);
+ t1.toString;
+ return t1;
+ }
+ };
+ A.AreaElement.prototype = {
+ toString$0(receiver) {
+ var t1 = String(receiver);
+ t1.toString;
+ return t1;
+ }
+ };
+ A.Blob.prototype = {};
+ A.CharacterData.prototype = {
+ get$length(receiver) {
+ return receiver.length;
+ }
+ };
+ A.CssPerspective.prototype = {
+ get$length(receiver) {
+ return receiver.length;
+ }
+ };
+ A.CssRule.prototype = {$isCssRule: 1};
+ A.CssStyleDeclaration.prototype = {
+ get$length(receiver) {
+ var t1 = receiver.length;
+ t1.toString;
+ return t1;
+ }
+ };
+ A.CssStyleDeclarationBase.prototype = {};
+ A.CssStyleValue.prototype = {};
+ A.CssTransformComponent.prototype = {};
+ A.CssTransformValue.prototype = {
+ get$length(receiver) {
+ return receiver.length;
+ }
+ };
+ A.CssUnparsedValue.prototype = {
+ get$length(receiver) {
+ return receiver.length;
+ }
+ };
+ A.DataTransferItemList.prototype = {
+ get$length(receiver) {
+ return receiver.length;
+ }
+ };
+ A.DomException.prototype = {
+ toString$0(receiver) {
+ var t1 = String(receiver);
+ t1.toString;
+ return t1;
+ }
+ };
+ A.DomRectList.prototype = {
+ get$length(receiver) {
+ var t1 = receiver.length;
+ t1.toString;
+ return t1;
+ },
+ $index(receiver, index) {
+ var t1 = receiver.length,
+ t2 = index >>> 0 !== index || index >= t1;
+ t2.toString;
+ if (t2)
+ throw A.wrapException(A.IndexError$withLength(index, t1, receiver, null));
+ t1 = receiver[index];
+ t1.toString;
+ return t1;
+ },
+ $indexSet(receiver, index, value) {
+ type$.Rectangle_num._as(value);
+ throw A.wrapException(A.UnsupportedError$("Cannot assign element of immutable List."));
+ },
+ elementAt$1(receiver, index) {
+ if (!(index >= 0 && index < receiver.length))
+ return A.ioore(receiver, index);
+ return receiver[index];
+ },
+ $isEfficientLengthIterable: 1,
+ $isJavaScriptIndexingBehavior: 1,
+ $isIterable: 1,
+ $isList: 1
+ };
+ A.DomRectReadOnly.prototype = {
+ toString$0(receiver) {
+ var t2,
+ t1 = receiver.left;
+ t1.toString;
+ t2 = receiver.top;
+ t2.toString;
+ return "Rectangle (" + A.S(t1) + ", " + A.S(t2) + ") " + A.S(this.get$width(receiver)) + " x " + A.S(this.get$height(receiver));
+ },
+ $eq(receiver, other) {
+ var t1, t2;
+ if (other == null)
+ return false;
+ if (type$.Rectangle_num._is(other)) {
+ t1 = receiver.left;
+ t1.toString;
+ t2 = other.left;
+ t2.toString;
+ if (t1 === t2) {
+ t1 = receiver.top;
+ t1.toString;
+ t2 = other.top;
+ t2.toString;
+ if (t1 === t2) {
+ t1 = J.getInterceptor$x(other);
+ t1 = this.get$width(receiver) === t1.get$width(other) && this.get$height(receiver) === t1.get$height(other);
+ } else
+ t1 = false;
+ } else
+ t1 = false;
+ } else
+ t1 = false;
+ return t1;
+ },
+ get$hashCode(receiver) {
+ var t2,
+ t1 = receiver.left;
+ t1.toString;
+ t2 = receiver.top;
+ t2.toString;
+ return A.Object_hash(t1, t2, this.get$width(receiver), this.get$height(receiver));
+ },
+ get$_height(receiver) {
+ return receiver.height;
+ },
+ get$height(receiver) {
+ var t1 = this.get$_height(receiver);
+ t1.toString;
+ return t1;
+ },
+ get$_width(receiver) {
+ return receiver.width;
+ },
+ get$width(receiver) {
+ var t1 = this.get$_width(receiver);
+ t1.toString;
+ return t1;
+ },
+ $isRectangle: 1
+ };
+ A.DomStringList.prototype = {
+ get$length(receiver) {
+ var t1 = receiver.length;
+ t1.toString;
+ return t1;
+ },
+ $index(receiver, index) {
+ var t1 = receiver.length,
+ t2 = index >>> 0 !== index || index >= t1;
+ t2.toString;
+ if (t2)
+ throw A.wrapException(A.IndexError$withLength(index, t1, receiver, null));
+ t1 = receiver[index];
+ t1.toString;
+ return t1;
+ },
+ $indexSet(receiver, index, value) {
+ A._asString(value);
+ throw A.wrapException(A.UnsupportedError$("Cannot assign element of immutable List."));
+ },
+ elementAt$1(receiver, index) {
+ if (!(index >= 0 && index < receiver.length))
+ return A.ioore(receiver, index);
+ return receiver[index];
+ },
+ $isEfficientLengthIterable: 1,
+ $isJavaScriptIndexingBehavior: 1,
+ $isIterable: 1,
+ $isList: 1
+ };
+ A.DomTokenList.prototype = {
+ get$length(receiver) {
+ var t1 = receiver.length;
+ t1.toString;
+ return t1;
+ }
+ };
+ A.Element.prototype = {
+ toString$0(receiver) {
+ var t1 = receiver.localName;
+ t1.toString;
+ return t1;
+ }
+ };
+ A.EventTarget.prototype = {};
+ A.File.prototype = {$isFile: 1};
+ A.FileList.prototype = {
+ get$length(receiver) {
+ var t1 = receiver.length;
+ t1.toString;
+ return t1;
+ },
+ $index(receiver, index) {
+ var t1 = receiver.length,
+ t2 = index >>> 0 !== index || index >= t1;
+ t2.toString;
+ if (t2)
+ throw A.wrapException(A.IndexError$withLength(index, t1, receiver, null));
+ t1 = receiver[index];
+ t1.toString;
+ return t1;
+ },
+ $indexSet(receiver, index, value) {
+ type$.File._as(value);
+ throw A.wrapException(A.UnsupportedError$("Cannot assign element of immutable List."));
+ },
+ elementAt$1(receiver, index) {
+ if (!(index >= 0 && index < receiver.length))
+ return A.ioore(receiver, index);
+ return receiver[index];
+ },
+ $isEfficientLengthIterable: 1,
+ $isJavaScriptIndexingBehavior: 1,
+ $isIterable: 1,
+ $isList: 1
+ };
+ A.FileWriter.prototype = {
+ get$length(receiver) {
+ return receiver.length;
+ }
+ };
+ A.FormElement.prototype = {
+ get$length(receiver) {
+ return receiver.length;
+ }
+ };
+ A.Gamepad.prototype = {$isGamepad: 1};
+ A.History.prototype = {
+ get$length(receiver) {
+ var t1 = receiver.length;
+ t1.toString;
+ return t1;
+ }
+ };
+ A.HtmlCollection.prototype = {
+ get$length(receiver) {
+ var t1 = receiver.length;
+ t1.toString;
+ return t1;
+ },
+ $index(receiver, index) {
+ var t1 = receiver.length,
+ t2 = index >>> 0 !== index || index >= t1;
+ t2.toString;
+ if (t2)
+ throw A.wrapException(A.IndexError$withLength(index, t1, receiver, null));
+ t1 = receiver[index];
+ t1.toString;
+ return t1;
+ },
+ $indexSet(receiver, index, value) {
+ type$.Node._as(value);
+ throw A.wrapException(A.UnsupportedError$("Cannot assign element of immutable List."));
+ },
+ elementAt$1(receiver, index) {
+ if (!(index >= 0 && index < receiver.length))
+ return A.ioore(receiver, index);
+ return receiver[index];
+ },
+ $isEfficientLengthIterable: 1,
+ $isJavaScriptIndexingBehavior: 1,
+ $isIterable: 1,
+ $isList: 1
+ };
+ A.Location.prototype = {
+ toString$0(receiver) {
+ var t1 = String(receiver);
+ t1.toString;
+ return t1;
+ }
+ };
+ A.MediaList.prototype = {
+ get$length(receiver) {
+ return receiver.length;
+ }
+ };
+ A.MidiInputMap.prototype = {
+ containsKey$1(receiver, key) {
+ return A.convertNativeToDart_Dictionary(receiver.get(key)) != null;
+ },
+ $index(receiver, key) {
+ return A.convertNativeToDart_Dictionary(receiver.get(A._asString(key)));
+ },
+ forEach$1(receiver, f) {
+ var entries, entry, t1;
+ type$.void_Function_String_dynamic._as(f);
+ entries = receiver.entries();
+ for (; true;) {
+ entry = entries.next();
+ t1 = entry.done;
+ t1.toString;
+ if (t1)
+ return;
+ t1 = entry.value[0];
+ t1.toString;
+ f.call$2(t1, A.convertNativeToDart_Dictionary(entry.value[1]));
+ }
+ },
+ get$keys(receiver) {
+ var keys = A._setArrayType([], type$.JSArray_String);
+ this.forEach$1(receiver, new A.MidiInputMap_keys_closure(keys));
+ return keys;
+ },
+ get$length(receiver) {
+ var t1 = receiver.size;
+ t1.toString;
+ return t1;
+ },
+ get$isEmpty(receiver) {
+ var t1 = receiver.size;
+ t1.toString;
+ return t1 === 0;
+ },
+ $indexSet(receiver, key, value) {
+ throw A.wrapException(A.UnsupportedError$("Not supported"));
+ },
+ $isMap: 1
+ };
+ A.MidiInputMap_keys_closure.prototype = {
+ call$2(k, v) {
+ return B.JSArray_methods.add$1(this.keys, k);
+ },
+ $signature: 4
+ };
+ A.MidiOutputMap.prototype = {
+ containsKey$1(receiver, key) {
+ return A.convertNativeToDart_Dictionary(receiver.get(key)) != null;
+ },
+ $index(receiver, key) {
+ return A.convertNativeToDart_Dictionary(receiver.get(A._asString(key)));
+ },
+ forEach$1(receiver, f) {
+ var entries, entry, t1;
+ type$.void_Function_String_dynamic._as(f);
+ entries = receiver.entries();
+ for (; true;) {
+ entry = entries.next();
+ t1 = entry.done;
+ t1.toString;
+ if (t1)
+ return;
+ t1 = entry.value[0];
+ t1.toString;
+ f.call$2(t1, A.convertNativeToDart_Dictionary(entry.value[1]));
+ }
+ },
+ get$keys(receiver) {
+ var keys = A._setArrayType([], type$.JSArray_String);
+ this.forEach$1(receiver, new A.MidiOutputMap_keys_closure(keys));
+ return keys;
+ },
+ get$length(receiver) {
+ var t1 = receiver.size;
+ t1.toString;
+ return t1;
+ },
+ get$isEmpty(receiver) {
+ var t1 = receiver.size;
+ t1.toString;
+ return t1 === 0;
+ },
+ $indexSet(receiver, key, value) {
+ throw A.wrapException(A.UnsupportedError$("Not supported"));
+ },
+ $isMap: 1
+ };
+ A.MidiOutputMap_keys_closure.prototype = {
+ call$2(k, v) {
+ return B.JSArray_methods.add$1(this.keys, k);
+ },
+ $signature: 4
+ };
+ A.MimeType.prototype = {$isMimeType: 1};
+ A.MimeTypeArray.prototype = {
+ get$length(receiver) {
+ var t1 = receiver.length;
+ t1.toString;
+ return t1;
+ },
+ $index(receiver, index) {
+ var t1 = receiver.length,
+ t2 = index >>> 0 !== index || index >= t1;
+ t2.toString;
+ if (t2)
+ throw A.wrapException(A.IndexError$withLength(index, t1, receiver, null));
+ t1 = receiver[index];
+ t1.toString;
+ return t1;
+ },
+ $indexSet(receiver, index, value) {
+ type$.MimeType._as(value);
+ throw A.wrapException(A.UnsupportedError$("Cannot assign element of immutable List."));
+ },
+ elementAt$1(receiver, index) {
+ if (!(index >= 0 && index < receiver.length))
+ return A.ioore(receiver, index);
+ return receiver[index];
+ },
+ $isEfficientLengthIterable: 1,
+ $isJavaScriptIndexingBehavior: 1,
+ $isIterable: 1,
+ $isList: 1
+ };
+ A.Node.prototype = {
+ toString$0(receiver) {
+ var value = receiver.nodeValue;
+ return value == null ? this.super$Interceptor$toString(receiver) : value;
+ },
+ $isNode: 1
+ };
+ A.NodeList.prototype = {
+ get$length(receiver) {
+ var t1 = receiver.length;
+ t1.toString;
+ return t1;
+ },
+ $index(receiver, index) {
+ var t1 = receiver.length,
+ t2 = index >>> 0 !== index || index >= t1;
+ t2.toString;
+ if (t2)
+ throw A.wrapException(A.IndexError$withLength(index, t1, receiver, null));
+ t1 = receiver[index];
+ t1.toString;
+ return t1;
+ },
+ $indexSet(receiver, index, value) {
+ type$.Node._as(value);
+ throw A.wrapException(A.UnsupportedError$("Cannot assign element of immutable List."));
+ },
+ elementAt$1(receiver, index) {
+ if (!(index >= 0 && index < receiver.length))
+ return A.ioore(receiver, index);
+ return receiver[index];
+ },
+ $isEfficientLengthIterable: 1,
+ $isJavaScriptIndexingBehavior: 1,
+ $isIterable: 1,
+ $isList: 1
+ };
+ A.Plugin.prototype = {
+ get$length(receiver) {
+ return receiver.length;
+ },
+ $isPlugin: 1
+ };
+ A.PluginArray.prototype = {
+ get$length(receiver) {
+ var t1 = receiver.length;
+ t1.toString;
+ return t1;
+ },
+ $index(receiver, index) {
+ var t1 = receiver.length,
+ t2 = index >>> 0 !== index || index >= t1;
+ t2.toString;
+ if (t2)
+ throw A.wrapException(A.IndexError$withLength(index, t1, receiver, null));
+ t1 = receiver[index];
+ t1.toString;
+ return t1;
+ },
+ $indexSet(receiver, index, value) {
+ type$.Plugin._as(value);
+ throw A.wrapException(A.UnsupportedError$("Cannot assign element of immutable List."));
+ },
+ elementAt$1(receiver, index) {
+ if (!(index >= 0 && index < receiver.length))
+ return A.ioore(receiver, index);
+ return receiver[index];
+ },
+ $isEfficientLengthIterable: 1,
+ $isJavaScriptIndexingBehavior: 1,
+ $isIterable: 1,
+ $isList: 1
+ };
+ A.RtcStatsReport.prototype = {
+ containsKey$1(receiver, key) {
+ return A.convertNativeToDart_Dictionary(receiver.get(key)) != null;
+ },
+ $index(receiver, key) {
+ return A.convertNativeToDart_Dictionary(receiver.get(A._asString(key)));
+ },
+ forEach$1(receiver, f) {
+ var entries, entry, t1;
+ type$.void_Function_String_dynamic._as(f);
+ entries = receiver.entries();
+ for (; true;) {
+ entry = entries.next();
+ t1 = entry.done;
+ t1.toString;
+ if (t1)
+ return;
+ t1 = entry.value[0];
+ t1.toString;
+ f.call$2(t1, A.convertNativeToDart_Dictionary(entry.value[1]));
+ }
+ },
+ get$keys(receiver) {
+ var keys = A._setArrayType([], type$.JSArray_String);
+ this.forEach$1(receiver, new A.RtcStatsReport_keys_closure(keys));
+ return keys;
+ },
+ get$length(receiver) {
+ var t1 = receiver.size;
+ t1.toString;
+ return t1;
+ },
+ get$isEmpty(receiver) {
+ var t1 = receiver.size;
+ t1.toString;
+ return t1 === 0;
+ },
+ $indexSet(receiver, key, value) {
+ throw A.wrapException(A.UnsupportedError$("Not supported"));
+ },
+ $isMap: 1
+ };
+ A.RtcStatsReport_keys_closure.prototype = {
+ call$2(k, v) {
+ return B.JSArray_methods.add$1(this.keys, k);
+ },
+ $signature: 4
+ };
+ A.SelectElement.prototype = {
+ get$length(receiver) {
+ return receiver.length;
+ }
+ };
+ A.SourceBuffer.prototype = {$isSourceBuffer: 1};
+ A.SourceBufferList.prototype = {
+ get$length(receiver) {
+ var t1 = receiver.length;
+ t1.toString;
+ return t1;
+ },
+ $index(receiver, index) {
+ var t1 = receiver.length,
+ t2 = index >>> 0 !== index || index >= t1;
+ t2.toString;
+ if (t2)
+ throw A.wrapException(A.IndexError$withLength(index, t1, receiver, null));
+ t1 = receiver[index];
+ t1.toString;
+ return t1;
+ },
+ $indexSet(receiver, index, value) {
+ type$.SourceBuffer._as(value);
+ throw A.wrapException(A.UnsupportedError$("Cannot assign element of immutable List."));
+ },
+ elementAt$1(receiver, index) {
+ if (!(index >= 0 && index < receiver.length))
+ return A.ioore(receiver, index);
+ return receiver[index];
+ },
+ $isEfficientLengthIterable: 1,
+ $isJavaScriptIndexingBehavior: 1,
+ $isIterable: 1,
+ $isList: 1
+ };
+ A.SpeechGrammar.prototype = {$isSpeechGrammar: 1};
+ A.SpeechGrammarList.prototype = {
+ get$length(receiver) {
+ var t1 = receiver.length;
+ t1.toString;
+ return t1;
+ },
+ $index(receiver, index) {
+ var t1 = receiver.length,
+ t2 = index >>> 0 !== index || index >= t1;
+ t2.toString;
+ if (t2)
+ throw A.wrapException(A.IndexError$withLength(index, t1, receiver, null));
+ t1 = receiver[index];
+ t1.toString;
+ return t1;
+ },
+ $indexSet(receiver, index, value) {
+ type$.SpeechGrammar._as(value);
+ throw A.wrapException(A.UnsupportedError$("Cannot assign element of immutable List."));
+ },
+ elementAt$1(receiver, index) {
+ if (!(index >= 0 && index < receiver.length))
+ return A.ioore(receiver, index);
+ return receiver[index];
+ },
+ $isEfficientLengthIterable: 1,
+ $isJavaScriptIndexingBehavior: 1,
+ $isIterable: 1,
+ $isList: 1
+ };
+ A.SpeechRecognitionResult.prototype = {
+ get$length(receiver) {
+ return receiver.length;
+ },
+ $isSpeechRecognitionResult: 1
+ };
+ A.Storage.prototype = {
+ containsKey$1(receiver, key) {
+ return receiver.getItem(key) != null;
+ },
+ $index(receiver, key) {
+ return receiver.getItem(A._asString(key));
+ },
+ $indexSet(receiver, key, value) {
+ receiver.setItem(key, value);
+ },
+ forEach$1(receiver, f) {
+ var i, key, t1;
+ type$.void_Function_String_String._as(f);
+ for (i = 0; true; ++i) {
+ key = receiver.key(i);
+ if (key == null)
+ return;
+ t1 = receiver.getItem(key);
+ t1.toString;
+ f.call$2(key, t1);
+ }
+ },
+ get$keys(receiver) {
+ var keys = A._setArrayType([], type$.JSArray_String);
+ this.forEach$1(receiver, new A.Storage_keys_closure(keys));
+ return keys;
+ },
+ get$length(receiver) {
+ var t1 = receiver.length;
+ t1.toString;
+ return t1;
+ },
+ get$isEmpty(receiver) {
+ return receiver.key(0) == null;
+ },
+ $isMap: 1
+ };
+ A.Storage_keys_closure.prototype = {
+ call$2(k, v) {
+ return B.JSArray_methods.add$1(this.keys, k);
+ },
+ $signature: 27
+ };
+ A.StyleSheet.prototype = {$isStyleSheet: 1};
+ A.TextTrack.prototype = {$isTextTrack: 1};
+ A.TextTrackCue.prototype = {$isTextTrackCue: 1};
+ A.TextTrackCueList.prototype = {
+ get$length(receiver) {
+ var t1 = receiver.length;
+ t1.toString;
+ return t1;
+ },
+ $index(receiver, index) {
+ var t1 = receiver.length,
+ t2 = index >>> 0 !== index || index >= t1;
+ t2.toString;
+ if (t2)
+ throw A.wrapException(A.IndexError$withLength(index, t1, receiver, null));
+ t1 = receiver[index];
+ t1.toString;
+ return t1;
+ },
+ $indexSet(receiver, index, value) {
+ type$.TextTrackCue._as(value);
+ throw A.wrapException(A.UnsupportedError$("Cannot assign element of immutable List."));
+ },
+ elementAt$1(receiver, index) {
+ if (!(index >= 0 && index < receiver.length))
+ return A.ioore(receiver, index);
+ return receiver[index];
+ },
+ $isEfficientLengthIterable: 1,
+ $isJavaScriptIndexingBehavior: 1,
+ $isIterable: 1,
+ $isList: 1
+ };
+ A.TextTrackList.prototype = {
+ get$length(receiver) {
+ var t1 = receiver.length;
+ t1.toString;
+ return t1;
+ },
+ $index(receiver, index) {
+ var t1 = receiver.length,
+ t2 = index >>> 0 !== index || index >= t1;
+ t2.toString;
+ if (t2)
+ throw A.wrapException(A.IndexError$withLength(index, t1, receiver, null));
+ t1 = receiver[index];
+ t1.toString;
+ return t1;
+ },
+ $indexSet(receiver, index, value) {
+ type$.TextTrack._as(value);
+ throw A.wrapException(A.UnsupportedError$("Cannot assign element of immutable List."));
+ },
+ elementAt$1(receiver, index) {
+ if (!(index >= 0 && index < receiver.length))
+ return A.ioore(receiver, index);
+ return receiver[index];
+ },
+ $isEfficientLengthIterable: 1,
+ $isJavaScriptIndexingBehavior: 1,
+ $isIterable: 1,
+ $isList: 1
+ };
+ A.TimeRanges.prototype = {
+ get$length(receiver) {
+ var t1 = receiver.length;
+ t1.toString;
+ return t1;
+ }
+ };
+ A.Touch.prototype = {$isTouch: 1};
+ A.TouchList.prototype = {
+ get$length(receiver) {
+ var t1 = receiver.length;
+ t1.toString;
+ return t1;
+ },
+ $index(receiver, index) {
+ var t1 = receiver.length,
+ t2 = index >>> 0 !== index || index >= t1;
+ t2.toString;
+ if (t2)
+ throw A.wrapException(A.IndexError$withLength(index, t1, receiver, null));
+ t1 = receiver[index];
+ t1.toString;
+ return t1;
+ },
+ $indexSet(receiver, index, value) {
+ type$.Touch._as(value);
+ throw A.wrapException(A.UnsupportedError$("Cannot assign element of immutable List."));
+ },
+ elementAt$1(receiver, index) {
+ if (!(index >= 0 && index < receiver.length))
+ return A.ioore(receiver, index);
+ return receiver[index];
+ },
+ $isEfficientLengthIterable: 1,
+ $isJavaScriptIndexingBehavior: 1,
+ $isIterable: 1,
+ $isList: 1
+ };
+ A.TrackDefaultList.prototype = {
+ get$length(receiver) {
+ return receiver.length;
+ }
+ };
+ A.Url.prototype = {
+ toString$0(receiver) {
+ var t1 = String(receiver);
+ t1.toString;
+ return t1;
+ }
+ };
+ A.VideoTrackList.prototype = {
+ get$length(receiver) {
+ return receiver.length;
+ }
+ };
+ A._CssRuleList.prototype = {
+ get$length(receiver) {
+ var t1 = receiver.length;
+ t1.toString;
+ return t1;
+ },
+ $index(receiver, index) {
+ var t1 = receiver.length,
+ t2 = index >>> 0 !== index || index >= t1;
+ t2.toString;
+ if (t2)
+ throw A.wrapException(A.IndexError$withLength(index, t1, receiver, null));
+ t1 = receiver[index];
+ t1.toString;
+ return t1;
+ },
+ $indexSet(receiver, index, value) {
+ type$.CssRule._as(value);
+ throw A.wrapException(A.UnsupportedError$("Cannot assign element of immutable List."));
+ },
+ elementAt$1(receiver, index) {
+ if (!(index >= 0 && index < receiver.length))
+ return A.ioore(receiver, index);
+ return receiver[index];
+ },
+ $isEfficientLengthIterable: 1,
+ $isJavaScriptIndexingBehavior: 1,
+ $isIterable: 1,
+ $isList: 1
+ };
+ A._DomRect.prototype = {
+ toString$0(receiver) {
+ var t2, t3, t4,
+ t1 = receiver.left;
+ t1.toString;
+ t2 = receiver.top;
+ t2.toString;
+ t3 = receiver.width;
+ t3.toString;
+ t4 = receiver.height;
+ t4.toString;
+ return "Rectangle (" + A.S(t1) + ", " + A.S(t2) + ") " + A.S(t3) + " x " + A.S(t4);
+ },
+ $eq(receiver, other) {
+ var t1, t2;
+ if (other == null)
+ return false;
+ if (type$.Rectangle_num._is(other)) {
+ t1 = receiver.left;
+ t1.toString;
+ t2 = other.left;
+ t2.toString;
+ if (t1 === t2) {
+ t1 = receiver.top;
+ t1.toString;
+ t2 = other.top;
+ t2.toString;
+ if (t1 === t2) {
+ t1 = receiver.width;
+ t1.toString;
+ t2 = J.getInterceptor$x(other);
+ if (t1 === t2.get$width(other)) {
+ t1 = receiver.height;
+ t1.toString;
+ t2 = t1 === t2.get$height(other);
+ t1 = t2;
+ } else
+ t1 = false;
+ } else
+ t1 = false;
+ } else
+ t1 = false;
+ } else
+ t1 = false;
+ return t1;
+ },
+ get$hashCode(receiver) {
+ var t2, t3, t4,
+ t1 = receiver.left;
+ t1.toString;
+ t2 = receiver.top;
+ t2.toString;
+ t3 = receiver.width;
+ t3.toString;
+ t4 = receiver.height;
+ t4.toString;
+ return A.Object_hash(t1, t2, t3, t4);
+ },
+ get$_height(receiver) {
+ return receiver.height;
+ },
+ get$height(receiver) {
+ var t1 = receiver.height;
+ t1.toString;
+ return t1;
+ },
+ get$_width(receiver) {
+ return receiver.width;
+ },
+ get$width(receiver) {
+ var t1 = receiver.width;
+ t1.toString;
+ return t1;
+ }
+ };
+ A._GamepadList.prototype = {
+ get$length(receiver) {
+ var t1 = receiver.length;
+ t1.toString;
+ return t1;
+ },
+ $index(receiver, index) {
+ var t1 = receiver.length,
+ t2 = index >>> 0 !== index || index >= t1;
+ t2.toString;
+ if (t2)
+ throw A.wrapException(A.IndexError$withLength(index, t1, receiver, null));
+ return receiver[index];
+ },
+ $indexSet(receiver, index, value) {
+ type$.nullable_Gamepad._as(value);
+ throw A.wrapException(A.UnsupportedError$("Cannot assign element of immutable List."));
+ },
+ elementAt$1(receiver, index) {
+ if (!(index >= 0 && index < receiver.length))
+ return A.ioore(receiver, index);
+ return receiver[index];
+ },
+ $isEfficientLengthIterable: 1,
+ $isJavaScriptIndexingBehavior: 1,
+ $isIterable: 1,
+ $isList: 1
+ };
+ A._NamedNodeMap.prototype = {
+ get$length(receiver) {
+ var t1 = receiver.length;
+ t1.toString;
+ return t1;
+ },
+ $index(receiver, index) {
+ var t1 = receiver.length,
+ t2 = index >>> 0 !== index || index >= t1;
+ t2.toString;
+ if (t2)
+ throw A.wrapException(A.IndexError$withLength(index, t1, receiver, null));
+ t1 = receiver[index];
+ t1.toString;
+ return t1;
+ },
+ $indexSet(receiver, index, value) {
+ type$.Node._as(value);
+ throw A.wrapException(A.UnsupportedError$("Cannot assign element of immutable List."));
+ },
+ elementAt$1(receiver, index) {
+ if (!(index >= 0 && index < receiver.length))
+ return A.ioore(receiver, index);
+ return receiver[index];
+ },
+ $isEfficientLengthIterable: 1,
+ $isJavaScriptIndexingBehavior: 1,
+ $isIterable: 1,
+ $isList: 1
+ };
+ A._SpeechRecognitionResultList.prototype = {
+ get$length(receiver) {
+ var t1 = receiver.length;
+ t1.toString;
+ return t1;
+ },
+ $index(receiver, index) {
+ var t1 = receiver.length,
+ t2 = index >>> 0 !== index || index >= t1;
+ t2.toString;
+ if (t2)
+ throw A.wrapException(A.IndexError$withLength(index, t1, receiver, null));
+ t1 = receiver[index];
+ t1.toString;
+ return t1;
+ },
+ $indexSet(receiver, index, value) {
+ type$.SpeechRecognitionResult._as(value);
+ throw A.wrapException(A.UnsupportedError$("Cannot assign element of immutable List."));
+ },
+ elementAt$1(receiver, index) {
+ if (!(index >= 0 && index < receiver.length))
+ return A.ioore(receiver, index);
+ return receiver[index];
+ },
+ $isEfficientLengthIterable: 1,
+ $isJavaScriptIndexingBehavior: 1,
+ $isIterable: 1,
+ $isList: 1
+ };
+ A._StyleSheetList.prototype = {
+ get$length(receiver) {
+ var t1 = receiver.length;
+ t1.toString;
+ return t1;
+ },
+ $index(receiver, index) {
+ var t1 = receiver.length,
+ t2 = index >>> 0 !== index || index >= t1;
+ t2.toString;
+ if (t2)
+ throw A.wrapException(A.IndexError$withLength(index, t1, receiver, null));
+ t1 = receiver[index];
+ t1.toString;
+ return t1;
+ },
+ $indexSet(receiver, index, value) {
+ type$.StyleSheet._as(value);
+ throw A.wrapException(A.UnsupportedError$("Cannot assign element of immutable List."));
+ },
+ elementAt$1(receiver, index) {
+ if (!(index >= 0 && index < receiver.length))
+ return A.ioore(receiver, index);
+ return receiver[index];
+ },
+ $isEfficientLengthIterable: 1,
+ $isJavaScriptIndexingBehavior: 1,
+ $isIterable: 1,
+ $isList: 1
+ };
+ A.ImmutableListMixin.prototype = {
+ get$iterator(receiver) {
+ return new A.FixedSizeListIterator(receiver, this.get$length(receiver), A.instanceType(receiver)._eval$1("FixedSizeListIterator<ImmutableListMixin.E>"));
+ }
+ };
+ A.FixedSizeListIterator.prototype = {
+ moveNext$0() {
+ var _this = this,
+ nextPosition = _this._position + 1,
+ t1 = _this._html$_length;
+ if (nextPosition < t1) {
+ _this.set$_html$_current(J.$index$asx(_this._array, nextPosition));
+ _this._position = nextPosition;
+ return true;
+ }
+ _this.set$_html$_current(null);
+ _this._position = t1;
+ return false;
+ },
+ get$current(_) {
+ var t1 = this._html$_current;
+ return t1 == null ? this.$ti._precomputed1._as(t1) : t1;
+ },
+ set$_html$_current(_current) {
+ this._html$_current = this.$ti._eval$1("1?")._as(_current);
+ },
+ $isIterator: 1
+ };
+ A._CssStyleDeclaration_JavaScriptObject_CssStyleDeclarationBase.prototype = {};
+ A._DomRectList_JavaScriptObject_ListMixin.prototype = {};
+ A._DomRectList_JavaScriptObject_ListMixin_ImmutableListMixin.prototype = {};
+ A._DomStringList_JavaScriptObject_ListMixin.prototype = {};
+ A._DomStringList_JavaScriptObject_ListMixin_ImmutableListMixin.prototype = {};
+ A._FileList_JavaScriptObject_ListMixin.prototype = {};
+ A._FileList_JavaScriptObject_ListMixin_ImmutableListMixin.prototype = {};
+ A._HtmlCollection_JavaScriptObject_ListMixin.prototype = {};
+ A._HtmlCollection_JavaScriptObject_ListMixin_ImmutableListMixin.prototype = {};
+ A._MidiInputMap_JavaScriptObject_MapMixin.prototype = {};
+ A._MidiOutputMap_JavaScriptObject_MapMixin.prototype = {};
+ A._MimeTypeArray_JavaScriptObject_ListMixin.prototype = {};
+ A._MimeTypeArray_JavaScriptObject_ListMixin_ImmutableListMixin.prototype = {};
+ A._NodeList_JavaScriptObject_ListMixin.prototype = {};
+ A._NodeList_JavaScriptObject_ListMixin_ImmutableListMixin.prototype = {};
+ A._PluginArray_JavaScriptObject_ListMixin.prototype = {};
+ A._PluginArray_JavaScriptObject_ListMixin_ImmutableListMixin.prototype = {};
+ A._RtcStatsReport_JavaScriptObject_MapMixin.prototype = {};
+ A._SourceBufferList_EventTarget_ListMixin.prototype = {};
+ A._SourceBufferList_EventTarget_ListMixin_ImmutableListMixin.prototype = {};
+ A._SpeechGrammarList_JavaScriptObject_ListMixin.prototype = {};
+ A._SpeechGrammarList_JavaScriptObject_ListMixin_ImmutableListMixin.prototype = {};
+ A._Storage_JavaScriptObject_MapMixin.prototype = {};
+ A._TextTrackCueList_JavaScriptObject_ListMixin.prototype = {};
+ A._TextTrackCueList_JavaScriptObject_ListMixin_ImmutableListMixin.prototype = {};
+ A._TextTrackList_EventTarget_ListMixin.prototype = {};
+ A._TextTrackList_EventTarget_ListMixin_ImmutableListMixin.prototype = {};
+ A._TouchList_JavaScriptObject_ListMixin.prototype = {};
+ A._TouchList_JavaScriptObject_ListMixin_ImmutableListMixin.prototype = {};
+ A.__CssRuleList_JavaScriptObject_ListMixin.prototype = {};
+ A.__CssRuleList_JavaScriptObject_ListMixin_ImmutableListMixin.prototype = {};
+ A.__GamepadList_JavaScriptObject_ListMixin.prototype = {};
+ A.__GamepadList_JavaScriptObject_ListMixin_ImmutableListMixin.prototype = {};
+ A.__NamedNodeMap_JavaScriptObject_ListMixin.prototype = {};
+ A.__NamedNodeMap_JavaScriptObject_ListMixin_ImmutableListMixin.prototype = {};
+ A.__SpeechRecognitionResultList_JavaScriptObject_ListMixin.prototype = {};
+ A.__SpeechRecognitionResultList_JavaScriptObject_ListMixin_ImmutableListMixin.prototype = {};
+ A.__StyleSheetList_JavaScriptObject_ListMixin.prototype = {};
+ A.__StyleSheetList_JavaScriptObject_ListMixin_ImmutableListMixin.prototype = {};
+ A.jsify__convert.prototype = {
+ call$1(o) {
+ var t1, convertedMap, t2, key, convertedList;
+ if (A._noJsifyRequired(o))
+ return o;
+ t1 = this._convertedObjects;
+ if (t1.containsKey$1(0, o))
+ return t1.$index(0, o);
+ if (type$.Map_of_nullable_Object_and_nullable_Object._is(o)) {
+ convertedMap = {};
+ t1.$indexSet(0, o, convertedMap);
+ for (t1 = J.getInterceptor$x(o), t2 = J.get$iterator$ax(t1.get$keys(o)); t2.moveNext$0();) {
+ key = t2.get$current(t2);
+ convertedMap[key] = this.call$1(t1.$index(o, key));
+ }
+ return convertedMap;
+ } else if (type$.Iterable_nullable_Object._is(o)) {
+ convertedList = [];
+ t1.$indexSet(0, o, convertedList);
+ B.JSArray_methods.addAll$1(convertedList, J.map$1$1$ax(o, this, type$.dynamic));
+ return convertedList;
+ } else
+ return o;
+ },
+ $signature: 19
+ };
+ A.promiseToFuture_closure.prototype = {
+ call$1(r) {
+ return this.completer.complete$1(0, this.T._eval$1("0/?")._as(r));
+ },
+ $signature: 5
+ };
+ A.promiseToFuture_closure0.prototype = {
+ call$1(e) {
+ if (e == null)
+ return this.completer.completeError$1(new A.NullRejectionException(e === undefined));
+ return this.completer.completeError$1(e);
+ },
+ $signature: 5
+ };
+ A.dartify_convert.prototype = {
+ call$1(o) {
+ var t1, millisSinceEpoch, proto, t2, dartObject, originalKeys, dartKeys, i, jsKey, dartKey, l, $length;
+ if (A._noDartifyRequired(o))
+ return o;
+ t1 = this._convertedObjects;
+ o.toString;
+ if (t1.containsKey$1(0, o))
+ return t1.$index(0, o);
+ if (o instanceof Date) {
+ millisSinceEpoch = o.getTime();
+ if (Math.abs(millisSinceEpoch) <= 864e13)
+ t1 = false;
+ else
+ t1 = true;
+ if (t1)
+ A.throwExpression(A.ArgumentError$("DateTime is outside valid range: " + millisSinceEpoch, null));
+ A.checkNotNullable(true, "isUtc", type$.bool);
+ return new A.DateTime(millisSinceEpoch, true);
+ }
+ if (o instanceof RegExp)
+ throw A.wrapException(A.ArgumentError$("structured clone of RegExp", null));
+ if (typeof Promise != "undefined" && o instanceof Promise)
+ return A.promiseToFuture(o, type$.nullable_Object);
+ proto = Object.getPrototypeOf(o);
+ if (proto === Object.prototype || proto === null) {
+ t2 = type$.nullable_Object;
+ dartObject = A.LinkedHashMap_LinkedHashMap$_empty(t2, t2);
+ t1.$indexSet(0, o, dartObject);
+ originalKeys = Object.keys(o);
+ dartKeys = [];
+ for (t1 = J.getInterceptor$ax(originalKeys), t2 = t1.get$iterator(originalKeys); t2.moveNext$0();)
+ dartKeys.push(A.dartify(t2.get$current(t2)));
+ for (i = 0; i < t1.get$length(originalKeys); ++i) {
+ jsKey = t1.$index(originalKeys, i);
+ if (!(i < dartKeys.length))
+ return A.ioore(dartKeys, i);
+ dartKey = dartKeys[i];
+ if (jsKey != null)
+ dartObject.$indexSet(0, dartKey, this.call$1(o[jsKey]));
+ }
+ return dartObject;
+ }
+ if (o instanceof Array) {
+ l = o;
+ dartObject = [];
+ t1.$indexSet(0, o, dartObject);
+ $length = A._asInt(o.length);
+ for (t1 = J.getInterceptor$asx(l), i = 0; i < $length; ++i)
+ dartObject.push(this.call$1(t1.$index(l, i)));
+ return dartObject;
+ }
+ return o;
+ },
+ $signature: 19
+ };
+ A.NullRejectionException.prototype = {
+ toString$0(_) {
+ return "Promise was rejected with a value of `" + (this.isUndefined ? "undefined" : "null") + "`.";
+ },
+ $isException: 1
+ };
+ A.Length.prototype = {$isLength: 1};
+ A.LengthList.prototype = {
+ get$length(receiver) {
+ var t1 = receiver.length;
+ t1.toString;
+ return t1;
+ },
+ $index(receiver, index) {
+ var t1 = receiver.length;
+ t1.toString;
+ t1 = index >>> 0 !== index || index >= t1;
+ t1.toString;
+ if (t1)
+ throw A.wrapException(A.IndexError$withLength(index, this.get$length(receiver), receiver, null));
+ t1 = receiver.getItem(index);
+ t1.toString;
+ return t1;
+ },
+ $indexSet(receiver, index, value) {
+ type$.Length._as(value);
+ throw A.wrapException(A.UnsupportedError$("Cannot assign element of immutable List."));
+ },
+ elementAt$1(receiver, index) {
+ return this.$index(receiver, index);
+ },
+ $isEfficientLengthIterable: 1,
+ $isIterable: 1,
+ $isList: 1
+ };
+ A.Number.prototype = {$isNumber: 1};
+ A.NumberList.prototype = {
+ get$length(receiver) {
+ var t1 = receiver.length;
+ t1.toString;
+ return t1;
+ },
+ $index(receiver, index) {
+ var t1 = receiver.length;
+ t1.toString;
+ t1 = index >>> 0 !== index || index >= t1;
+ t1.toString;
+ if (t1)
+ throw A.wrapException(A.IndexError$withLength(index, this.get$length(receiver), receiver, null));
+ t1 = receiver.getItem(index);
+ t1.toString;
+ return t1;
+ },
+ $indexSet(receiver, index, value) {
+ type$.Number._as(value);
+ throw A.wrapException(A.UnsupportedError$("Cannot assign element of immutable List."));
+ },
+ elementAt$1(receiver, index) {
+ return this.$index(receiver, index);
+ },
+ $isEfficientLengthIterable: 1,
+ $isIterable: 1,
+ $isList: 1
+ };
+ A.PointList.prototype = {
+ get$length(receiver) {
+ return receiver.length;
+ }
+ };
+ A.StringList.prototype = {
+ get$length(receiver) {
+ var t1 = receiver.length;
+ t1.toString;
+ return t1;
+ },
+ $index(receiver, index) {
+ var t1 = receiver.length;
+ t1.toString;
+ t1 = index >>> 0 !== index || index >= t1;
+ t1.toString;
+ if (t1)
+ throw A.wrapException(A.IndexError$withLength(index, this.get$length(receiver), receiver, null));
+ t1 = receiver.getItem(index);
+ t1.toString;
+ return t1;
+ },
+ $indexSet(receiver, index, value) {
+ A._asString(value);
+ throw A.wrapException(A.UnsupportedError$("Cannot assign element of immutable List."));
+ },
+ elementAt$1(receiver, index) {
+ return this.$index(receiver, index);
+ },
+ $isEfficientLengthIterable: 1,
+ $isIterable: 1,
+ $isList: 1
+ };
+ A.Transform.prototype = {$isTransform: 1};
+ A.TransformList.prototype = {
+ get$length(receiver) {
+ var t1 = receiver.length;
+ t1.toString;
+ return t1;
+ },
+ $index(receiver, index) {
+ var t1 = receiver.length;
+ t1.toString;
+ t1 = index >>> 0 !== index || index >= t1;
+ t1.toString;
+ if (t1)
+ throw A.wrapException(A.IndexError$withLength(index, this.get$length(receiver), receiver, null));
+ t1 = receiver.getItem(index);
+ t1.toString;
+ return t1;
+ },
+ $indexSet(receiver, index, value) {
+ type$.Transform._as(value);
+ throw A.wrapException(A.UnsupportedError$("Cannot assign element of immutable List."));
+ },
+ elementAt$1(receiver, index) {
+ return this.$index(receiver, index);
+ },
+ $isEfficientLengthIterable: 1,
+ $isIterable: 1,
+ $isList: 1
+ };
+ A._LengthList_JavaScriptObject_ListMixin.prototype = {};
+ A._LengthList_JavaScriptObject_ListMixin_ImmutableListMixin.prototype = {};
+ A._NumberList_JavaScriptObject_ListMixin.prototype = {};
+ A._NumberList_JavaScriptObject_ListMixin_ImmutableListMixin.prototype = {};
+ A._StringList_JavaScriptObject_ListMixin.prototype = {};
+ A._StringList_JavaScriptObject_ListMixin_ImmutableListMixin.prototype = {};
+ A._TransformList_JavaScriptObject_ListMixin.prototype = {};
+ A._TransformList_JavaScriptObject_ListMixin_ImmutableListMixin.prototype = {};
+ A.AudioBuffer.prototype = {
+ get$length(receiver) {
+ return receiver.length;
+ }
+ };
+ A.AudioParamMap.prototype = {
+ containsKey$1(receiver, key) {
+ return A.convertNativeToDart_Dictionary(receiver.get(key)) != null;
+ },
+ $index(receiver, key) {
+ return A.convertNativeToDart_Dictionary(receiver.get(A._asString(key)));
+ },
+ forEach$1(receiver, f) {
+ var entries, entry, t1;
+ type$.void_Function_String_dynamic._as(f);
+ entries = receiver.entries();
+ for (; true;) {
+ entry = entries.next();
+ t1 = entry.done;
+ t1.toString;
+ if (t1)
+ return;
+ t1 = entry.value[0];
+ t1.toString;
+ f.call$2(t1, A.convertNativeToDart_Dictionary(entry.value[1]));
+ }
+ },
+ get$keys(receiver) {
+ var keys = A._setArrayType([], type$.JSArray_String);
+ this.forEach$1(receiver, new A.AudioParamMap_keys_closure(keys));
+ return keys;
+ },
+ get$length(receiver) {
+ var t1 = receiver.size;
+ t1.toString;
+ return t1;
+ },
+ get$isEmpty(receiver) {
+ var t1 = receiver.size;
+ t1.toString;
+ return t1 === 0;
+ },
+ $indexSet(receiver, key, value) {
+ throw A.wrapException(A.UnsupportedError$("Not supported"));
+ },
+ $isMap: 1
+ };
+ A.AudioParamMap_keys_closure.prototype = {
+ call$2(k, v) {
+ return B.JSArray_methods.add$1(this.keys, k);
+ },
+ $signature: 4
+ };
+ A.AudioTrackList.prototype = {
+ get$length(receiver) {
+ return receiver.length;
+ }
+ };
+ A.BaseAudioContext.prototype = {};
+ A.OfflineAudioContext.prototype = {
+ get$length(receiver) {
+ return receiver.length;
+ }
+ };
+ A._AudioParamMap_JavaScriptObject_MapMixin.prototype = {};
+ A.NullStreamSink.prototype = {
+ addStream$1(_, stream) {
+ var _this = this;
+ _this.$ti._eval$1("Stream<1>")._as(stream);
+ _this._checkEventAllowed$0();
+ _this._addingStream = true;
+ return stream.listen$1(null).cancel$0(0).whenComplete$1(new A.NullStreamSink_addStream_closure(_this));
+ },
+ _checkEventAllowed$0() {
+ if (this._null_stream_sink$_closed)
+ throw A.wrapException(A.StateError$("Cannot add to a closed sink."));
+ if (this._addingStream)
+ throw A.wrapException(A.StateError$("Cannot add to a sink while adding a stream."));
+ },
+ close$0(_) {
+ this._null_stream_sink$_closed = true;
+ return this.done;
+ },
+ $isStreamConsumer: 1,
+ $isStreamSink: 1
+ };
+ A.NullStreamSink_addStream_closure.prototype = {
+ call$0() {
+ this.$this._addingStream = false;
+ },
+ $signature: 3
+ };
+ A.Context.prototype = {
+ absolute$15(_, part1, part2, part3, part4, part5, part6, part7, part8, part9, part10, part11, part12, part13, part14, part15) {
+ var t1;
+ A._validateArgList("absolute", A._setArrayType([part1, part2, part3, part4, part5, part6, part7, part8, part9, part10, part11, part12, part13, part14, part15], type$.JSArray_nullable_String));
+ t1 = this.style;
+ t1 = t1.rootLength$1(part1) > 0 && !t1.isRootRelative$1(part1);
+ if (t1)
+ return part1;
+ t1 = this._context$_current;
+ return this.join$16(0, t1 == null ? A.current() : t1, part1, part2, part3, part4, part5, part6, part7, part8, part9, part10, part11, part12, part13, part14, part15);
+ },
+ absolute$1($receiver, part1) {
+ return this.absolute$15($receiver, part1, null, null, null, null, null, null, null, null, null, null, null, null, null, null);
+ },
+ join$16(_, part1, part2, part3, part4, part5, part6, part7, part8, part9, part10, part11, part12, part13, part14, part15, part16) {
+ var parts = A._setArrayType([part1, part2, part3, part4, part5, part6, part7, part8, part9, part10, part11, part12, part13, part14, part15, part16], type$.JSArray_nullable_String);
+ A._validateArgList("join", parts);
+ return this.joinAll$1(new A.WhereTypeIterable(parts, type$.WhereTypeIterable_String));
+ },
+ join$2($receiver, part1, part2) {
+ return this.join$16($receiver, part1, part2, null, null, null, null, null, null, null, null, null, null, null, null, null, null);
+ },
+ joinAll$1(parts) {
+ var t1, t2, t3, needsSeparator, isAbsoluteAndNotRootRelative, t4, t5, parsed, path, t6;
+ type$.Iterable_String._as(parts);
+ for (t1 = parts.$ti, t2 = t1._eval$1("bool(Iterable.E)")._as(new A.Context_joinAll_closure()), t3 = parts.get$iterator(parts), t1 = new A.WhereIterator(t3, t2, t1._eval$1("WhereIterator<Iterable.E>")), t2 = this.style, needsSeparator = false, isAbsoluteAndNotRootRelative = false, t4 = ""; t1.moveNext$0();) {
+ t5 = t3.get$current(t3);
+ if (t2.isRootRelative$1(t5) && isAbsoluteAndNotRootRelative) {
+ parsed = A.ParsedPath_ParsedPath$parse(t5, t2);
+ path = t4.charCodeAt(0) == 0 ? t4 : t4;
+ t4 = B.JSString_methods.substring$2(path, 0, t2.rootLength$2$withDrive(path, true));
+ parsed.root = t4;
+ if (t2.needsSeparator$1(t4))
+ B.JSArray_methods.$indexSet(parsed.separators, 0, t2.get$separator());
+ t4 = "" + parsed.toString$0(0);
+ } else if (t2.rootLength$1(t5) > 0) {
+ isAbsoluteAndNotRootRelative = !t2.isRootRelative$1(t5);
+ t4 = "" + t5;
+ } else {
+ t6 = t5.length;
+ if (t6 !== 0) {
+ if (0 >= t6)
+ return A.ioore(t5, 0);
+ t6 = t2.containsSeparator$1(t5[0]);
+ } else
+ t6 = false;
+ if (!t6)
+ if (needsSeparator)
+ t4 += t2.get$separator();
+ t4 += t5;
+ }
+ needsSeparator = t2.needsSeparator$1(t5);
+ }
+ return t4.charCodeAt(0) == 0 ? t4 : t4;
+ },
+ split$1(_, path) {
+ var parsed = A.ParsedPath_ParsedPath$parse(path, this.style),
+ t1 = parsed.parts,
+ t2 = A._arrayInstanceType(t1),
+ t3 = t2._eval$1("WhereIterable<1>");
+ parsed.set$parts(A.List_List$of(new A.WhereIterable(t1, t2._eval$1("bool(1)")._as(new A.Context_split_closure()), t3), true, t3._eval$1("Iterable.E")));
+ t1 = parsed.root;
+ if (t1 != null)
+ B.JSArray_methods.insert$2(parsed.parts, 0, t1);
+ return parsed.parts;
+ },
+ normalize$1(_, path) {
+ var parsed;
+ if (!this._needsNormalization$1(path))
+ return path;
+ parsed = A.ParsedPath_ParsedPath$parse(path, this.style);
+ parsed.normalize$0(0);
+ return parsed.toString$0(0);
+ },
+ _needsNormalization$1(path) {
+ var t2, i, start, previous, t3, previousPrevious, codeUnit, t4,
+ t1 = this.style,
+ root = t1.rootLength$1(path);
+ if (root !== 0) {
+ if (t1 === $.$get$Style_windows())
+ for (t2 = path.length, i = 0; i < root; ++i) {
+ if (!(i < t2))
+ return A.ioore(path, i);
+ if (path.charCodeAt(i) === 47)
+ return true;
+ }
+ start = root;
+ previous = 47;
+ } else {
+ start = 0;
+ previous = null;
+ }
+ for (t2 = new A.CodeUnits(path)._string, t3 = t2.length, i = start, previousPrevious = null; i < t3; ++i, previousPrevious = previous, previous = codeUnit) {
+ if (!(i >= 0))
+ return A.ioore(t2, i);
+ codeUnit = t2.charCodeAt(i);
+ if (t1.isSeparator$1(codeUnit)) {
+ if (t1 === $.$get$Style_windows() && codeUnit === 47)
+ return true;
+ if (previous != null && t1.isSeparator$1(previous))
+ return true;
+ if (previous === 46)
+ t4 = previousPrevious == null || previousPrevious === 46 || t1.isSeparator$1(previousPrevious);
+ else
+ t4 = false;
+ if (t4)
+ return true;
+ }
+ }
+ if (previous == null)
+ return true;
+ if (t1.isSeparator$1(previous))
+ return true;
+ if (previous === 46)
+ t1 = previousPrevious == null || t1.isSeparator$1(previousPrevious) || previousPrevious === 46;
+ else
+ t1 = false;
+ if (t1)
+ return true;
+ return false;
+ },
+ relative$1(path) {
+ var from, fromParsed, pathParsed, t3, t4, t5, _this = this,
+ _s26_ = 'Unable to find a path to "',
+ t1 = _this.style,
+ t2 = t1.rootLength$1(path);
+ if (t2 <= 0)
+ return _this.normalize$1(0, path);
+ t2 = _this._context$_current;
+ from = t2 == null ? A.current() : t2;
+ if (t1.rootLength$1(from) <= 0 && t1.rootLength$1(path) > 0)
+ return _this.normalize$1(0, path);
+ if (t1.rootLength$1(path) <= 0 || t1.isRootRelative$1(path))
+ path = _this.absolute$1(0, path);
+ if (t1.rootLength$1(path) <= 0 && t1.rootLength$1(from) > 0)
+ throw A.wrapException(A.PathException$(_s26_ + path + '" from "' + from + '".'));
+ fromParsed = A.ParsedPath_ParsedPath$parse(from, t1);
+ fromParsed.normalize$0(0);
+ pathParsed = A.ParsedPath_ParsedPath$parse(path, t1);
+ pathParsed.normalize$0(0);
+ t2 = fromParsed.parts;
+ t3 = t2.length;
+ if (t3 !== 0) {
+ if (0 >= t3)
+ return A.ioore(t2, 0);
+ t2 = J.$eq$(t2[0], ".");
+ } else
+ t2 = false;
+ if (t2)
+ return pathParsed.toString$0(0);
+ t2 = fromParsed.root;
+ t3 = pathParsed.root;
+ if (t2 != t3)
+ t2 = t2 == null || t3 == null || !t1.pathsEqual$2(t2, t3);
+ else
+ t2 = false;
+ if (t2)
+ return pathParsed.toString$0(0);
+ while (true) {
+ t2 = fromParsed.parts;
+ t3 = t2.length;
+ if (t3 !== 0) {
+ t4 = pathParsed.parts;
+ t5 = t4.length;
+ if (t5 !== 0) {
+ if (0 >= t3)
+ return A.ioore(t2, 0);
+ t2 = t2[0];
+ if (0 >= t5)
+ return A.ioore(t4, 0);
+ t4 = t1.pathsEqual$2(t2, t4[0]);
+ t2 = t4;
+ } else
+ t2 = false;
+ } else
+ t2 = false;
+ if (!t2)
+ break;
+ B.JSArray_methods.removeAt$1(fromParsed.parts, 0);
+ B.JSArray_methods.removeAt$1(fromParsed.separators, 1);
+ B.JSArray_methods.removeAt$1(pathParsed.parts, 0);
+ B.JSArray_methods.removeAt$1(pathParsed.separators, 1);
+ }
+ t2 = fromParsed.parts;
+ t3 = t2.length;
+ if (t3 !== 0) {
+ if (0 >= t3)
+ return A.ioore(t2, 0);
+ t2 = J.$eq$(t2[0], "..");
+ } else
+ t2 = false;
+ if (t2)
+ throw A.wrapException(A.PathException$(_s26_ + path + '" from "' + from + '".'));
+ t2 = type$.String;
+ B.JSArray_methods.insertAll$2(pathParsed.parts, 0, A.List_List$filled(fromParsed.parts.length, "..", false, t2));
+ B.JSArray_methods.$indexSet(pathParsed.separators, 0, "");
+ B.JSArray_methods.insertAll$2(pathParsed.separators, 1, A.List_List$filled(fromParsed.parts.length, t1.get$separator(), false, t2));
+ t1 = pathParsed.parts;
+ t2 = t1.length;
+ if (t2 === 0)
+ return ".";
+ if (t2 > 1 && J.$eq$(B.JSArray_methods.get$last(t1), ".")) {
+ B.JSArray_methods.removeLast$0(pathParsed.parts);
+ t1 = pathParsed.separators;
+ if (0 >= t1.length)
+ return A.ioore(t1, -1);
+ t1.pop();
+ if (0 >= t1.length)
+ return A.ioore(t1, -1);
+ t1.pop();
+ B.JSArray_methods.add$1(t1, "");
+ }
+ pathParsed.root = "";
+ pathParsed.removeTrailingSeparators$0();
+ return pathParsed.toString$0(0);
+ },
+ toUri$1(path) {
+ var t2,
+ t1 = this.style;
+ if (t1.rootLength$1(path) <= 0)
+ return t1.relativePathToUri$1(path);
+ else {
+ t2 = this._context$_current;
+ return t1.absolutePathToUri$1(this.join$2(0, t2 == null ? A.current() : t2, path));
+ }
+ },
+ prettyUri$1(uri) {
+ var path, rel, _this = this,
+ typedUri = A._parseUri(uri);
+ if (typedUri.get$scheme() === "file" && _this.style === $.$get$Style_url())
+ return typedUri.toString$0(0);
+ else if (typedUri.get$scheme() !== "file" && typedUri.get$scheme() !== "" && _this.style !== $.$get$Style_url())
+ return typedUri.toString$0(0);
+ path = _this.normalize$1(0, _this.style.pathFromUri$1(A._parseUri(typedUri)));
+ rel = _this.relative$1(path);
+ return _this.split$1(0, rel).length > _this.split$1(0, path).length ? path : rel;
+ }
+ };
+ A.Context_joinAll_closure.prototype = {
+ call$1(part) {
+ return A._asString(part) !== "";
+ },
+ $signature: 1
+ };
+ A.Context_split_closure.prototype = {
+ call$1(part) {
+ return A._asString(part).length !== 0;
+ },
+ $signature: 1
+ };
+ A._validateArgList_closure.prototype = {
+ call$1(arg) {
+ A._asStringQ(arg);
+ return arg == null ? "null" : '"' + arg + '"';
+ },
+ $signature: 31
+ };
+ A.InternalStyle.prototype = {
+ getRoot$1(path) {
+ var t1,
+ $length = this.rootLength$1(path);
+ if ($length > 0)
+ return B.JSString_methods.substring$2(path, 0, $length);
+ if (this.isRootRelative$1(path)) {
+ if (0 >= path.length)
+ return A.ioore(path, 0);
+ t1 = path[0];
+ } else
+ t1 = null;
+ return t1;
+ },
+ relativePathToUri$1(path) {
+ var segments, t2, _null = null,
+ t1 = path.length;
+ if (t1 === 0)
+ return A._Uri__Uri(_null, _null, _null, _null);
+ segments = A.Context_Context(this).split$1(0, path);
+ t2 = t1 - 1;
+ if (!(t2 >= 0))
+ return A.ioore(path, t2);
+ if (this.isSeparator$1(path.charCodeAt(t2)))
+ B.JSArray_methods.add$1(segments, "");
+ return A._Uri__Uri(_null, _null, segments, _null);
+ },
+ pathsEqual$2(path1, path2) {
+ return path1 === path2;
+ }
+ };
+ A.ParsedPath.prototype = {
+ get$hasTrailingSeparator() {
+ var t1 = this.parts;
+ if (t1.length !== 0)
+ t1 = J.$eq$(B.JSArray_methods.get$last(t1), "") || !J.$eq$(B.JSArray_methods.get$last(this.separators), "");
+ else
+ t1 = false;
+ return t1;
+ },
+ removeTrailingSeparators$0() {
+ var t1, t2, _this = this;
+ while (true) {
+ t1 = _this.parts;
+ if (!(t1.length !== 0 && J.$eq$(B.JSArray_methods.get$last(t1), "")))
+ break;
+ B.JSArray_methods.removeLast$0(_this.parts);
+ t1 = _this.separators;
+ if (0 >= t1.length)
+ return A.ioore(t1, -1);
+ t1.pop();
+ }
+ t1 = _this.separators;
+ t2 = t1.length;
+ if (t2 !== 0)
+ B.JSArray_methods.$indexSet(t1, t2 - 1, "");
+ },
+ normalize$0(_) {
+ var t1, t2, leadingDoubles, _i, part, t3, _this = this,
+ newParts = A._setArrayType([], type$.JSArray_String);
+ for (t1 = _this.parts, t2 = t1.length, leadingDoubles = 0, _i = 0; _i < t1.length; t1.length === t2 || (0, A.throwConcurrentModificationError)(t1), ++_i) {
+ part = t1[_i];
+ t3 = J.getInterceptor$(part);
+ if (!(t3.$eq(part, ".") || t3.$eq(part, "")))
+ if (t3.$eq(part, "..")) {
+ t3 = newParts.length;
+ if (t3 !== 0) {
+ if (0 >= t3)
+ return A.ioore(newParts, -1);
+ newParts.pop();
+ } else
+ ++leadingDoubles;
+ } else
+ B.JSArray_methods.add$1(newParts, part);
+ }
+ if (_this.root == null)
+ B.JSArray_methods.insertAll$2(newParts, 0, A.List_List$filled(leadingDoubles, "..", false, type$.String));
+ if (newParts.length === 0 && _this.root == null)
+ B.JSArray_methods.add$1(newParts, ".");
+ _this.set$parts(newParts);
+ t1 = _this.style;
+ _this.set$separators(A.List_List$filled(newParts.length + 1, t1.get$separator(), true, type$.String));
+ t2 = _this.root;
+ if (t2 == null || newParts.length === 0 || !t1.needsSeparator$1(t2))
+ B.JSArray_methods.$indexSet(_this.separators, 0, "");
+ t2 = _this.root;
+ if (t2 != null && t1 === $.$get$Style_windows()) {
+ t2.toString;
+ _this.root = A.stringReplaceAllUnchecked(t2, "/", "\\");
+ }
+ _this.removeTrailingSeparators$0();
+ },
+ toString$0(_) {
+ var i, t2, t3, _this = this,
+ t1 = _this.root;
+ t1 = t1 != null ? "" + t1 : "";
+ for (i = 0; i < _this.parts.length; ++i, t1 = t3) {
+ t2 = _this.separators;
+ if (!(i < t2.length))
+ return A.ioore(t2, i);
+ t2 = A.S(t2[i]);
+ t3 = _this.parts;
+ if (!(i < t3.length))
+ return A.ioore(t3, i);
+ t3 = t1 + t2 + A.S(t3[i]);
+ }
+ t1 += A.S(B.JSArray_methods.get$last(_this.separators));
+ return t1.charCodeAt(0) == 0 ? t1 : t1;
+ },
+ set$parts(parts) {
+ this.parts = type$.List_String._as(parts);
+ },
+ set$separators(separators) {
+ this.separators = type$.List_String._as(separators);
+ }
+ };
+ A.PathException.prototype = {
+ toString$0(_) {
+ return "PathException: " + this.message;
+ },
+ $isException: 1
+ };
+ A.Style.prototype = {
+ toString$0(_) {
+ return this.get$name(this);
+ }
+ };
+ A.PosixStyle.prototype = {
+ containsSeparator$1(path) {
+ return B.JSString_methods.contains$1(path, "/");
+ },
+ isSeparator$1(codeUnit) {
+ return codeUnit === 47;
+ },
+ needsSeparator$1(path) {
+ var t2,
+ t1 = path.length;
+ if (t1 !== 0) {
+ t2 = t1 - 1;
+ if (!(t2 >= 0))
+ return A.ioore(path, t2);
+ t2 = path.charCodeAt(t2) !== 47;
+ t1 = t2;
+ } else
+ t1 = false;
+ return t1;
+ },
+ rootLength$2$withDrive(path, withDrive) {
+ var t1 = path.length;
+ if (t1 !== 0) {
+ if (0 >= t1)
+ return A.ioore(path, 0);
+ t1 = path.charCodeAt(0) === 47;
+ } else
+ t1 = false;
+ if (t1)
+ return 1;
+ return 0;
+ },
+ rootLength$1(path) {
+ return this.rootLength$2$withDrive(path, false);
+ },
+ isRootRelative$1(path) {
+ return false;
+ },
+ pathFromUri$1(uri) {
+ var t1;
+ if (uri.get$scheme() === "" || uri.get$scheme() === "file") {
+ t1 = uri.get$path(uri);
+ return A._Uri__uriDecode(t1, 0, t1.length, B.C_Utf8Codec, false);
+ }
+ throw A.wrapException(A.ArgumentError$("Uri " + uri.toString$0(0) + " must have scheme 'file:'.", null));
+ },
+ absolutePathToUri$1(path) {
+ var parsed = A.ParsedPath_ParsedPath$parse(path, this),
+ t1 = parsed.parts;
+ if (t1.length === 0)
+ B.JSArray_methods.addAll$1(t1, A._setArrayType(["", ""], type$.JSArray_String));
+ else if (parsed.get$hasTrailingSeparator())
+ B.JSArray_methods.add$1(parsed.parts, "");
+ return A._Uri__Uri(null, null, parsed.parts, "file");
+ },
+ get$name() {
+ return "posix";
+ },
+ get$separator() {
+ return "/";
+ }
+ };
+ A.UrlStyle.prototype = {
+ containsSeparator$1(path) {
+ return B.JSString_methods.contains$1(path, "/");
+ },
+ isSeparator$1(codeUnit) {
+ return codeUnit === 47;
+ },
+ needsSeparator$1(path) {
+ var t2,
+ t1 = path.length;
+ if (t1 === 0)
+ return false;
+ t2 = t1 - 1;
+ if (!(t2 >= 0))
+ return A.ioore(path, t2);
+ if (path.charCodeAt(t2) !== 47)
+ return true;
+ return B.JSString_methods.endsWith$1(path, "://") && this.rootLength$1(path) === t1;
+ },
+ rootLength$2$withDrive(path, withDrive) {
+ var i, codeUnit, index, t2,
+ t1 = path.length;
+ if (t1 === 0)
+ return 0;
+ if (0 >= t1)
+ return A.ioore(path, 0);
+ if (path.charCodeAt(0) === 47)
+ return 1;
+ for (i = 0; i < t1; ++i) {
+ codeUnit = path.charCodeAt(i);
+ if (codeUnit === 47)
+ return 0;
+ if (codeUnit === 58) {
+ if (i === 0)
+ return 0;
+ index = B.JSString_methods.indexOf$2(path, "/", B.JSString_methods.startsWith$2(path, "//", i + 1) ? i + 3 : i);
+ if (index <= 0)
+ return t1;
+ if (!withDrive || t1 < index + 3)
+ return index;
+ if (!B.JSString_methods.startsWith$1(path, "file://"))
+ return index;
+ if (!A.isDriveLetter(path, index + 1))
+ return index;
+ t2 = index + 3;
+ return t1 === t2 ? t2 : index + 4;
+ }
+ }
+ return 0;
+ },
+ rootLength$1(path) {
+ return this.rootLength$2$withDrive(path, false);
+ },
+ isRootRelative$1(path) {
+ var t1 = path.length;
+ if (t1 !== 0) {
+ if (0 >= t1)
+ return A.ioore(path, 0);
+ t1 = path.charCodeAt(0) === 47;
+ } else
+ t1 = false;
+ return t1;
+ },
+ pathFromUri$1(uri) {
+ return uri.toString$0(0);
+ },
+ relativePathToUri$1(path) {
+ return A.Uri_parse(path);
+ },
+ absolutePathToUri$1(path) {
+ return A.Uri_parse(path);
+ },
+ get$name() {
+ return "url";
+ },
+ get$separator() {
+ return "/";
+ }
+ };
+ A.WindowsStyle.prototype = {
+ containsSeparator$1(path) {
+ return B.JSString_methods.contains$1(path, "/");
+ },
+ isSeparator$1(codeUnit) {
+ return codeUnit === 47 || codeUnit === 92;
+ },
+ needsSeparator$1(path) {
+ var t2,
+ t1 = path.length;
+ if (t1 === 0)
+ return false;
+ t2 = t1 - 1;
+ if (!(t2 >= 0))
+ return A.ioore(path, t2);
+ t2 = path.charCodeAt(t2);
+ return !(t2 === 47 || t2 === 92);
+ },
+ rootLength$2$withDrive(path, withDrive) {
+ var t2, index,
+ t1 = path.length;
+ if (t1 === 0)
+ return 0;
+ if (0 >= t1)
+ return A.ioore(path, 0);
+ if (path.charCodeAt(0) === 47)
+ return 1;
+ if (path.charCodeAt(0) === 92) {
+ if (t1 >= 2) {
+ if (1 >= t1)
+ return A.ioore(path, 1);
+ t2 = path.charCodeAt(1) !== 92;
+ } else
+ t2 = true;
+ if (t2)
+ return 1;
+ index = B.JSString_methods.indexOf$2(path, "\\", 2);
+ if (index > 0) {
+ index = B.JSString_methods.indexOf$2(path, "\\", index + 1);
+ if (index > 0)
+ return index;
+ }
+ return t1;
+ }
+ if (t1 < 3)
+ return 0;
+ if (!A.isAlphabetic(path.charCodeAt(0)))
+ return 0;
+ if (path.charCodeAt(1) !== 58)
+ return 0;
+ t1 = path.charCodeAt(2);
+ if (!(t1 === 47 || t1 === 92))
+ return 0;
+ return 3;
+ },
+ rootLength$1(path) {
+ return this.rootLength$2$withDrive(path, false);
+ },
+ isRootRelative$1(path) {
+ return this.rootLength$1(path) === 1;
+ },
+ pathFromUri$1(uri) {
+ var path, t1;
+ if (uri.get$scheme() !== "" && uri.get$scheme() !== "file")
+ throw A.wrapException(A.ArgumentError$("Uri " + uri.toString$0(0) + " must have scheme 'file:'.", null));
+ path = uri.get$path(uri);
+ if (uri.get$host(uri) === "") {
+ if (path.length >= 3 && B.JSString_methods.startsWith$1(path, "/") && A.isDriveLetter(path, 1))
+ path = B.JSString_methods.replaceFirst$2(path, "/", "");
+ } else
+ path = "\\\\" + uri.get$host(uri) + path;
+ t1 = A.stringReplaceAllUnchecked(path, "/", "\\");
+ return A._Uri__uriDecode(t1, 0, t1.length, B.C_Utf8Codec, false);
+ },
+ absolutePathToUri$1(path) {
+ var rootParts, t2,
+ parsed = A.ParsedPath_ParsedPath$parse(path, this),
+ t1 = parsed.root;
+ t1.toString;
+ if (B.JSString_methods.startsWith$1(t1, "\\\\")) {
+ rootParts = new A.WhereIterable(A._setArrayType(t1.split("\\"), type$.JSArray_String), type$.bool_Function_String._as(new A.WindowsStyle_absolutePathToUri_closure()), type$.WhereIterable_String);
+ B.JSArray_methods.insert$2(parsed.parts, 0, rootParts.get$last(rootParts));
+ if (parsed.get$hasTrailingSeparator())
+ B.JSArray_methods.add$1(parsed.parts, "");
+ return A._Uri__Uri(rootParts.get$first(rootParts), null, parsed.parts, "file");
+ } else {
+ if (parsed.parts.length === 0 || parsed.get$hasTrailingSeparator())
+ B.JSArray_methods.add$1(parsed.parts, "");
+ t1 = parsed.parts;
+ t2 = parsed.root;
+ t2.toString;
+ t2 = A.stringReplaceAllUnchecked(t2, "/", "");
+ B.JSArray_methods.insert$2(t1, 0, A.stringReplaceAllUnchecked(t2, "\\", ""));
+ return A._Uri__Uri(null, null, parsed.parts, "file");
+ }
+ },
+ codeUnitsEqual$2(codeUnit1, codeUnit2) {
+ var upperCase1;
+ if (codeUnit1 === codeUnit2)
+ return true;
+ if (codeUnit1 === 47)
+ return codeUnit2 === 92;
+ if (codeUnit1 === 92)
+ return codeUnit2 === 47;
+ if ((codeUnit1 ^ codeUnit2) !== 32)
+ return false;
+ upperCase1 = codeUnit1 | 32;
+ return upperCase1 >= 97 && upperCase1 <= 122;
+ },
+ pathsEqual$2(path1, path2) {
+ var t1, t2, i;
+ if (path1 === path2)
+ return true;
+ t1 = path1.length;
+ t2 = path2.length;
+ if (t1 !== t2)
+ return false;
+ for (i = 0; i < t1; ++i) {
+ if (!(i < t2))
+ return A.ioore(path2, i);
+ if (!this.codeUnitsEqual$2(path1.charCodeAt(i), path2.charCodeAt(i)))
+ return false;
+ }
+ return true;
+ },
+ get$name() {
+ return "windows";
+ },
+ get$separator() {
+ return "\\";
+ }
+ };
+ A.WindowsStyle_absolutePathToUri_closure.prototype = {
+ call$1(part) {
+ return A._asString(part) !== "";
+ },
+ $signature: 1
+ };
+ A.Chain.prototype = {
+ toTrace$0() {
+ var t1 = this.traces,
+ t2 = A._arrayInstanceType(t1);
+ return A.Trace$(new A.ExpandIterable(t1, t2._eval$1("Iterable<Frame>(1)")._as(new A.Chain_toTrace_closure()), t2._eval$1("ExpandIterable<1,Frame>")), null);
+ },
+ toString$0(_) {
+ var t1 = this.traces,
+ t2 = A._arrayInstanceType(t1);
+ return new A.MappedListIterable(t1, t2._eval$1("String(1)")._as(new A.Chain_toString_closure(new A.MappedListIterable(t1, t2._eval$1("int(1)")._as(new A.Chain_toString_closure0()), t2._eval$1("MappedListIterable<1,int>")).fold$1$2(0, 0, B.CONSTANT, type$.int))), t2._eval$1("MappedListIterable<1,String>")).join$1(0, string$.x3d_____);
+ },
+ $isStackTrace: 1
+ };
+ A.Chain_Chain$parse_closure.prototype = {
+ call$1(line) {
+ return A._asString(line).length !== 0;
+ },
+ $signature: 1
+ };
+ A.Chain_toTrace_closure.prototype = {
+ call$1(trace) {
+ return type$.Trace._as(trace).get$frames();
+ },
+ $signature: 32
+ };
+ A.Chain_toString_closure0.prototype = {
+ call$1(trace) {
+ var t1 = type$.Trace._as(trace).get$frames(),
+ t2 = A._arrayInstanceType(t1);
+ return new A.MappedListIterable(t1, t2._eval$1("int(1)")._as(new A.Chain_toString__closure0()), t2._eval$1("MappedListIterable<1,int>")).fold$1$2(0, 0, B.CONSTANT, type$.int);
+ },
+ $signature: 33
+ };
+ A.Chain_toString__closure0.prototype = {
+ call$1(frame) {
+ type$.Frame._as(frame);
+ return frame.get$location(frame).length;
+ },
+ $signature: 20
+ };
+ A.Chain_toString_closure.prototype = {
+ call$1(trace) {
+ var t1 = type$.Trace._as(trace).get$frames(),
+ t2 = A._arrayInstanceType(t1);
+ return new A.MappedListIterable(t1, t2._eval$1("String(1)")._as(new A.Chain_toString__closure(this.longest)), t2._eval$1("MappedListIterable<1,String>")).join$0(0);
+ },
+ $signature: 35
+ };
+ A.Chain_toString__closure.prototype = {
+ call$1(frame) {
+ type$.Frame._as(frame);
+ return B.JSString_methods.padRight$1(frame.get$location(frame), this.longest) + " " + A.S(frame.get$member()) + "\n";
+ },
+ $signature: 21
+ };
+ A.Frame.prototype = {
+ get$isCore() {
+ return this.uri.get$scheme() === "dart";
+ },
+ get$library() {
+ var t1 = this.uri;
+ if (t1.get$scheme() === "data")
+ return "data:...";
+ return $.$get$context().prettyUri$1(t1);
+ },
+ get$$package() {
+ var t1 = this.uri;
+ if (t1.get$scheme() !== "package")
+ return null;
+ return B.JSArray_methods.get$first(t1.get$path(t1).split("/"));
+ },
+ get$location(_) {
+ var t2, _this = this,
+ t1 = _this.line;
+ if (t1 == null)
+ return _this.get$library();
+ t2 = _this.column;
+ if (t2 == null)
+ return _this.get$library() + " " + A.S(t1);
+ return _this.get$library() + " " + A.S(t1) + ":" + A.S(t2);
+ },
+ toString$0(_) {
+ return this.get$location(this) + " in " + A.S(this.member);
+ },
+ get$uri() {
+ return this.uri;
+ },
+ get$line(receiver) {
+ return this.line;
+ },
+ get$column() {
+ return this.column;
+ },
+ get$member() {
+ return this.member;
+ }
+ };
+ A.Frame_Frame$parseVM_closure.prototype = {
+ call$0() {
+ var match, t2, t3, member, uri, lineAndColumn, line, _null = null,
+ t1 = this.frame;
+ if (t1 === "...")
+ return new A.Frame(A._Uri__Uri(_null, _null, _null, _null), _null, _null, "...");
+ match = $.$get$_vmFrame().firstMatch$1(t1);
+ if (match == null)
+ return new A.UnparsedFrame(A._Uri__Uri(_null, "unparsed", _null, _null), t1);
+ t1 = match._match;
+ if (1 >= t1.length)
+ return A.ioore(t1, 1);
+ t2 = t1[1];
+ t2.toString;
+ t3 = $.$get$_asyncBody();
+ t2 = A.stringReplaceAllUnchecked(t2, t3, "<async>");
+ member = A.stringReplaceAllUnchecked(t2, "<anonymous closure>", "<fn>");
+ if (2 >= t1.length)
+ return A.ioore(t1, 2);
+ t2 = t1[2];
+ t3 = t2;
+ t3.toString;
+ if (B.JSString_methods.startsWith$1(t3, "<data:"))
+ uri = A.Uri_Uri$dataFromString("");
+ else {
+ t2 = t2;
+ t2.toString;
+ uri = A.Uri_parse(t2);
+ }
+ if (3 >= t1.length)
+ return A.ioore(t1, 3);
+ lineAndColumn = t1[3].split(":");
+ t1 = lineAndColumn.length;
+ line = t1 > 1 ? A.int_parse(lineAndColumn[1], _null) : _null;
+ return new A.Frame(uri, line, t1 > 2 ? A.int_parse(lineAndColumn[2], _null) : _null, member);
+ },
+ $signature: 6
+ };
+ A.Frame_Frame$parseV8_closure.prototype = {
+ call$0() {
+ var t2, t3, t4, _s4_ = "<fn>",
+ t1 = this.frame,
+ match = $.$get$_v8Frame().firstMatch$1(t1);
+ if (match == null)
+ return new A.UnparsedFrame(A._Uri__Uri(null, "unparsed", null, null), t1);
+ t1 = new A.Frame_Frame$parseV8_closure_parseLocation(t1);
+ t2 = match._match;
+ t3 = t2.length;
+ if (2 >= t3)
+ return A.ioore(t2, 2);
+ t4 = t2[2];
+ if (t4 != null) {
+ t3 = t4;
+ t3.toString;
+ t2 = t2[1];
+ t2.toString;
+ t2 = A.stringReplaceAllUnchecked(t2, "<anonymous>", _s4_);
+ t2 = A.stringReplaceAllUnchecked(t2, "Anonymous function", _s4_);
+ return t1.call$2(t3, A.stringReplaceAllUnchecked(t2, "(anonymous function)", _s4_));
+ } else {
+ if (3 >= t3)
+ return A.ioore(t2, 3);
+ t2 = t2[3];
+ t2.toString;
+ return t1.call$2(t2, _s4_);
+ }
+ },
+ $signature: 6
+ };
+ A.Frame_Frame$parseV8_closure_parseLocation.prototype = {
+ call$2($location, member) {
+ var t2, urlMatch, uri, line, columnMatch, _null = null,
+ t1 = $.$get$_v8EvalLocation(),
+ evalMatch = t1.firstMatch$1($location);
+ for (; evalMatch != null; $location = t2) {
+ t2 = evalMatch._match;
+ if (1 >= t2.length)
+ return A.ioore(t2, 1);
+ t2 = t2[1];
+ t2.toString;
+ evalMatch = t1.firstMatch$1(t2);
+ }
+ if ($location === "native")
+ return new A.Frame(A.Uri_parse("native"), _null, _null, member);
+ urlMatch = $.$get$_v8UrlLocation().firstMatch$1($location);
+ if (urlMatch == null)
+ return new A.UnparsedFrame(A._Uri__Uri(_null, "unparsed", _null, _null), this.frame);
+ t1 = urlMatch._match;
+ if (1 >= t1.length)
+ return A.ioore(t1, 1);
+ t2 = t1[1];
+ t2.toString;
+ uri = A.Frame__uriOrPathToUri(t2);
+ if (2 >= t1.length)
+ return A.ioore(t1, 2);
+ t2 = t1[2];
+ t2.toString;
+ line = A.int_parse(t2, _null);
+ if (3 >= t1.length)
+ return A.ioore(t1, 3);
+ columnMatch = t1[3];
+ return new A.Frame(uri, line, columnMatch != null ? A.int_parse(columnMatch, _null) : _null, member);
+ },
+ $signature: 38
+ };
+ A.Frame_Frame$_parseFirefoxEval_closure.prototype = {
+ call$0() {
+ var t2, member, uri, line, _null = null,
+ t1 = this.frame,
+ match = $.$get$_firefoxEvalLocation().firstMatch$1(t1);
+ if (match == null)
+ return new A.UnparsedFrame(A._Uri__Uri(_null, "unparsed", _null, _null), t1);
+ t1 = match._match;
+ if (1 >= t1.length)
+ return A.ioore(t1, 1);
+ t2 = t1[1];
+ t2.toString;
+ member = A.stringReplaceAllUnchecked(t2, "/<", "");
+ if (2 >= t1.length)
+ return A.ioore(t1, 2);
+ t2 = t1[2];
+ t2.toString;
+ uri = A.Frame__uriOrPathToUri(t2);
+ if (3 >= t1.length)
+ return A.ioore(t1, 3);
+ t1 = t1[3];
+ t1.toString;
+ line = A.int_parse(t1, _null);
+ return new A.Frame(uri, line, _null, member.length === 0 || member === "anonymous" ? "<fn>" : member);
+ },
+ $signature: 6
+ };
+ A.Frame_Frame$parseFirefox_closure.prototype = {
+ call$0() {
+ var t2, t3, t4, uri, member, line, column, _null = null,
+ t1 = this.frame,
+ match = $.$get$_firefoxSafariFrame().firstMatch$1(t1);
+ if (match == null)
+ return new A.UnparsedFrame(A._Uri__Uri(_null, "unparsed", _null, _null), t1);
+ t2 = match._match;
+ if (3 >= t2.length)
+ return A.ioore(t2, 3);
+ t3 = t2[3];
+ t4 = t3;
+ t4.toString;
+ if (B.JSString_methods.contains$1(t4, " line "))
+ return A.Frame_Frame$_parseFirefoxEval(t1);
+ t1 = t3;
+ t1.toString;
+ uri = A.Frame__uriOrPathToUri(t1);
+ t1 = t2.length;
+ if (1 >= t1)
+ return A.ioore(t2, 1);
+ member = t2[1];
+ if (member != null) {
+ if (2 >= t1)
+ return A.ioore(t2, 2);
+ t1 = t2[2];
+ t1.toString;
+ t1 = B.JSString_methods.allMatches$1("/", t1);
+ member += B.JSArray_methods.join$0(A.List_List$filled(t1.get$length(t1), ".<fn>", false, type$.String));
+ if (member === "")
+ member = "<fn>";
+ member = B.JSString_methods.replaceFirst$2(member, $.$get$_initialDot(), "");
+ } else
+ member = "<fn>";
+ if (4 >= t2.length)
+ return A.ioore(t2, 4);
+ t1 = t2[4];
+ if (t1 === "")
+ line = _null;
+ else {
+ t1 = t1;
+ t1.toString;
+ line = A.int_parse(t1, _null);
+ }
+ if (5 >= t2.length)
+ return A.ioore(t2, 5);
+ t1 = t2[5];
+ if (t1 == null || t1 === "")
+ column = _null;
+ else {
+ t1 = t1;
+ t1.toString;
+ column = A.int_parse(t1, _null);
+ }
+ return new A.Frame(uri, line, column, member);
+ },
+ $signature: 6
+ };
+ A.Frame_Frame$parseFriendly_closure.prototype = {
+ call$0() {
+ var t2, uri, line, column, _null = null,
+ t1 = this.frame,
+ match = $.$get$_friendlyFrame().firstMatch$1(t1);
+ if (match == null)
+ throw A.wrapException(A.FormatException$("Couldn't parse package:stack_trace stack trace line '" + t1 + "'.", _null, _null));
+ t1 = match._match;
+ if (1 >= t1.length)
+ return A.ioore(t1, 1);
+ t2 = t1[1];
+ if (t2 === "data:...")
+ uri = A.Uri_Uri$dataFromString("");
+ else {
+ t2 = t2;
+ t2.toString;
+ uri = A.Uri_parse(t2);
+ }
+ if (uri.get$scheme() === "") {
+ t2 = $.$get$context();
+ uri = t2.toUri$1(t2.absolute$15(0, t2.style.pathFromUri$1(A._parseUri(uri)), _null, _null, _null, _null, _null, _null, _null, _null, _null, _null, _null, _null, _null, _null));
+ }
+ if (2 >= t1.length)
+ return A.ioore(t1, 2);
+ t2 = t1[2];
+ if (t2 == null)
+ line = _null;
+ else {
+ t2 = t2;
+ t2.toString;
+ line = A.int_parse(t2, _null);
+ }
+ if (3 >= t1.length)
+ return A.ioore(t1, 3);
+ t2 = t1[3];
+ if (t2 == null)
+ column = _null;
+ else {
+ t2 = t2;
+ t2.toString;
+ column = A.int_parse(t2, _null);
+ }
+ if (4 >= t1.length)
+ return A.ioore(t1, 4);
+ return new A.Frame(uri, line, column, t1[4]);
+ },
+ $signature: 6
+ };
+ A.LazyTrace.prototype = {
+ get$_lazy_trace$_trace() {
+ var result, _this = this,
+ value = _this.__LazyTrace__trace_FI;
+ if (value === $) {
+ result = _this._thunk.call$0();
+ _this.__LazyTrace__trace_FI !== $ && A.throwLateFieldADI("_trace");
+ _this.__LazyTrace__trace_FI = result;
+ value = result;
+ }
+ return value;
+ },
+ get$frames() {
+ return this.get$_lazy_trace$_trace().get$frames();
+ },
+ get$terse() {
+ return new A.LazyTrace(new A.LazyTrace_terse_closure(this));
+ },
+ toString$0(_) {
+ return this.get$_lazy_trace$_trace().toString$0(0);
+ },
+ $isStackTrace: 1,
+ $isTrace: 1
+ };
+ A.LazyTrace_terse_closure.prototype = {
+ call$0() {
+ return this.$this.get$_lazy_trace$_trace().get$terse();
+ },
+ $signature: 22
+ };
+ A.Trace.prototype = {
+ get$terse() {
+ return this.foldFrames$2$terse(new A.Trace_terse_closure(), true);
+ },
+ foldFrames$2$terse(predicate, terse) {
+ var newFrames, t1, t2, t3, _box_0 = {};
+ _box_0.predicate = predicate;
+ type$.bool_Function_Frame._as(predicate);
+ _box_0.predicate = predicate;
+ _box_0.predicate = new A.Trace_foldFrames_closure(predicate);
+ newFrames = A._setArrayType([], type$.JSArray_Frame);
+ for (t1 = this.frames, t2 = A._arrayInstanceType(t1)._eval$1("ReversedListIterable<1>"), t1 = new A.ReversedListIterable(t1, t2), t1 = new A.ListIterator(t1, t1.get$length(t1), t2._eval$1("ListIterator<ListIterable.E>")), t2 = t2._eval$1("ListIterable.E"); t1.moveNext$0();) {
+ t3 = t1.__internal$_current;
+ if (t3 == null)
+ t3 = t2._as(t3);
+ if (t3 instanceof A.UnparsedFrame || !A.boolConversionCheck(_box_0.predicate.call$1(t3)))
+ B.JSArray_methods.add$1(newFrames, t3);
+ else if (newFrames.length === 0 || !A.boolConversionCheck(_box_0.predicate.call$1(B.JSArray_methods.get$last(newFrames))))
+ B.JSArray_methods.add$1(newFrames, new A.Frame(t3.get$uri(), t3.get$line(t3), t3.get$column(), t3.get$member()));
+ }
+ t1 = type$.MappedListIterable_Frame_Frame;
+ newFrames = A.List_List$of(new A.MappedListIterable(newFrames, type$.Frame_Function_Frame._as(new A.Trace_foldFrames_closure0(_box_0)), t1), true, t1._eval$1("ListIterable.E"));
+ if (newFrames.length > 1 && A.boolConversionCheck(_box_0.predicate.call$1(B.JSArray_methods.get$first(newFrames))))
+ B.JSArray_methods.removeAt$1(newFrames, 0);
+ return A.Trace$(new A.ReversedListIterable(newFrames, A._arrayInstanceType(newFrames)._eval$1("ReversedListIterable<1>")), this.original._stackTrace);
+ },
+ toString$0(_) {
+ var t1 = this.frames,
+ t2 = A._arrayInstanceType(t1);
+ return new A.MappedListIterable(t1, t2._eval$1("String(1)")._as(new A.Trace_toString_closure(new A.MappedListIterable(t1, t2._eval$1("int(1)")._as(new A.Trace_toString_closure0()), t2._eval$1("MappedListIterable<1,int>")).fold$1$2(0, 0, B.CONSTANT, type$.int))), t2._eval$1("MappedListIterable<1,String>")).join$0(0);
+ },
+ $isStackTrace: 1,
+ get$frames() {
+ return this.frames;
+ }
+ };
+ A.Trace_Trace$from_closure.prototype = {
+ call$0() {
+ return A.Trace_Trace$parse(this.trace.toString$0(0));
+ },
+ $signature: 22
+ };
+ A.Trace__parseVM_closure.prototype = {
+ call$1(line) {
+ return A._asString(line).length !== 0;
+ },
+ $signature: 1
+ };
+ A.Trace$parseV8_closure.prototype = {
+ call$1(line) {
+ return !B.JSString_methods.startsWith$1(A._asString(line), $.$get$_v8TraceLine());
+ },
+ $signature: 1
+ };
+ A.Trace$parseJSCore_closure.prototype = {
+ call$1(line) {
+ return A._asString(line) !== "\tat ";
+ },
+ $signature: 1
+ };
+ A.Trace$parseFirefox_closure.prototype = {
+ call$1(line) {
+ A._asString(line);
+ return line.length !== 0 && line !== "[native code]";
+ },
+ $signature: 1
+ };
+ A.Trace$parseFriendly_closure.prototype = {
+ call$1(line) {
+ return !B.JSString_methods.startsWith$1(A._asString(line), "=====");
+ },
+ $signature: 1
+ };
+ A.Trace_terse_closure.prototype = {
+ call$1(_) {
+ return false;
+ },
+ $signature: 23
+ };
+ A.Trace_foldFrames_closure.prototype = {
+ call$1(frame) {
+ var t1;
+ if (A.boolConversionCheck(this.oldPredicate.call$1(frame)))
+ return true;
+ if (frame.get$isCore())
+ return true;
+ if (frame.get$$package() === "stack_trace")
+ return true;
+ t1 = frame.get$member();
+ t1.toString;
+ if (!B.JSString_methods.contains$1(t1, "<async>"))
+ return false;
+ return frame.get$line(frame) == null;
+ },
+ $signature: 23
+ };
+ A.Trace_foldFrames_closure0.prototype = {
+ call$1(frame) {
+ var t1, t2;
+ type$.Frame._as(frame);
+ if (frame instanceof A.UnparsedFrame || !A.boolConversionCheck(this._box_0.predicate.call$1(frame)))
+ return frame;
+ t1 = frame.get$library();
+ t2 = $.$get$_terseRegExp();
+ return new A.Frame(A.Uri_parse(A.stringReplaceAllUnchecked(t1, t2, "")), null, null, frame.get$member());
+ },
+ $signature: 62
+ };
+ A.Trace_toString_closure0.prototype = {
+ call$1(frame) {
+ type$.Frame._as(frame);
+ return frame.get$location(frame).length;
+ },
+ $signature: 20
+ };
+ A.Trace_toString_closure.prototype = {
+ call$1(frame) {
+ type$.Frame._as(frame);
+ if (frame instanceof A.UnparsedFrame)
+ return frame.toString$0(0) + "\n";
+ return B.JSString_methods.padRight$1(frame.get$location(frame), this.longest) + " " + A.S(frame.get$member()) + "\n";
+ },
+ $signature: 21
+ };
+ A.UnparsedFrame.prototype = {
+ toString$0(_) {
+ return this.member;
+ },
+ $isFrame: 1,
+ get$uri() {
+ return this.uri;
+ },
+ get$line() {
+ return null;
+ },
+ get$column() {
+ return null;
+ },
+ get$isCore() {
+ return false;
+ },
+ get$library() {
+ return "unparsed";
+ },
+ get$$package() {
+ return null;
+ },
+ get$location() {
+ return "unparsed";
+ },
+ get$member() {
+ return this.member;
+ }
+ };
+ A.GuaranteeChannel.prototype = {
+ GuaranteeChannel$3$allowSinkErrors(innerSink, allowSinkErrors, _box_0, $T) {
+ var _this = this,
+ t1 = _this.$ti,
+ t2 = t1._eval$1("_GuaranteeSink<1>")._as(new A._GuaranteeSink(innerSink, _this, new A._AsyncCompleter(new A._Future($.Zone__current, type$._Future_dynamic), type$._AsyncCompleter_dynamic), true, $T._eval$1("_GuaranteeSink<0>")));
+ _this.__GuaranteeChannel__sink_F !== $ && A.throwLateFieldAI("_sink");
+ _this.set$__GuaranteeChannel__sink_F(t2);
+ t1 = t1._eval$1("StreamController<1>")._as(A.StreamController_StreamController(null, new A.GuaranteeChannel_closure(_box_0, _this, $T), true, $T));
+ _this.__GuaranteeChannel__streamController_F !== $ && A.throwLateFieldAI("_streamController");
+ _this.set$__GuaranteeChannel__streamController_F(t1);
+ },
+ _onSinkDisconnected$0() {
+ var subscription, t1;
+ this._disconnected = true;
+ subscription = this._subscription;
+ if (subscription != null)
+ subscription.cancel$0(0);
+ t1 = this.__GuaranteeChannel__streamController_F;
+ t1 === $ && A.throwLateFieldNI("_streamController");
+ t1.close$0(0);
+ },
+ set$__GuaranteeChannel__sink_F(__GuaranteeChannel__sink_F) {
+ this.__GuaranteeChannel__sink_F = this.$ti._eval$1("_GuaranteeSink<1>")._as(__GuaranteeChannel__sink_F);
+ },
+ set$__GuaranteeChannel__streamController_F(__GuaranteeChannel__streamController_F) {
+ this.__GuaranteeChannel__streamController_F = this.$ti._eval$1("StreamController<1>")._as(__GuaranteeChannel__streamController_F);
+ },
+ set$_subscription(_subscription) {
+ this._subscription = this.$ti._eval$1("StreamSubscription<1>?")._as(_subscription);
+ }
+ };
+ A.GuaranteeChannel_closure.prototype = {
+ call$0() {
+ var t2, t3,
+ t1 = this.$this;
+ if (t1._disconnected)
+ return;
+ t2 = this._box_0.innerStream;
+ t3 = t1.__GuaranteeChannel__streamController_F;
+ t3 === $ && A.throwLateFieldNI("_streamController");
+ t1.set$_subscription(t2.listen$3$onDone$onError(this.T._eval$1("~(0)")._as(t3.get$add(t3)), new A.GuaranteeChannel__closure(t1), t3.get$addError()));
+ },
+ $signature: 0
+ };
+ A.GuaranteeChannel__closure.prototype = {
+ call$0() {
+ var t1 = this.$this,
+ t2 = t1.__GuaranteeChannel__sink_F;
+ t2 === $ && A.throwLateFieldNI("_sink");
+ t2._onStreamDisconnected$0();
+ t1 = t1.__GuaranteeChannel__streamController_F;
+ t1 === $ && A.throwLateFieldNI("_streamController");
+ t1.close$0(0);
+ },
+ $signature: 0
+ };
+ A._GuaranteeSink.prototype = {
+ add$1(_, data) {
+ var t1, _this = this;
+ _this.$ti._precomputed1._as(data);
+ if (_this._closed)
+ throw A.wrapException(A.StateError$("Cannot add event after closing."));
+ if (_this._addStreamSubscription != null)
+ throw A.wrapException(A.StateError$("Cannot add event while adding stream."));
+ if (_this._disconnected)
+ return;
+ t1 = _this._inner;
+ t1._target.add$1(0, t1.$ti._precomputed1._as(data));
+ },
+ addError$2(error, stackTrace) {
+ var _this = this;
+ type$.Object._as(error);
+ type$.nullable_StackTrace._as(stackTrace);
+ if (_this._closed)
+ throw A.wrapException(A.StateError$("Cannot add event after closing."));
+ if (_this._addStreamSubscription != null)
+ throw A.wrapException(A.StateError$("Cannot add event while adding stream."));
+ if (_this._disconnected)
+ return;
+ _this._addError$2(error, stackTrace);
+ },
+ addError$1(error) {
+ return this.addError$2(error, null);
+ },
+ _addError$2(error, stackTrace) {
+ this._inner._target.addError$2(type$.Object._as(error), type$.nullable_StackTrace._as(stackTrace));
+ return;
+ },
+ _addError$1(error) {
+ return this._addError$2(error, null);
+ },
+ addStream$1(_, stream) {
+ var t2, t3, _this = this,
+ t1 = _this.$ti;
+ t1._eval$1("Stream<1>")._as(stream);
+ if (_this._closed)
+ throw A.wrapException(A.StateError$("Cannot add stream after closing."));
+ if (_this._addStreamSubscription != null)
+ throw A.wrapException(A.StateError$("Cannot add stream while adding stream."));
+ if (_this._disconnected)
+ return A.Future_Future$value(null, type$.void);
+ t2 = _this._addStreamCompleter = new A._SyncCompleter(new A._Future($.Zone__current, type$._Future_dynamic), type$._SyncCompleter_dynamic);
+ t3 = _this._inner;
+ _this.set$_addStreamSubscription(stream.listen$3$onDone$onError(t1._eval$1("~(1)")._as(t3.get$add(t3)), type$.void_Function_$opt_dynamic._as(t2.get$complete(t2)), _this.get$_addError()));
+ return _this._addStreamCompleter.future.then$1$1(new A._GuaranteeSink_addStream_closure(_this), type$.void);
+ },
+ close$0(_) {
+ var _this = this;
+ if (_this._addStreamSubscription != null)
+ throw A.wrapException(A.StateError$("Cannot close sink while adding stream."));
+ if (_this._closed)
+ return _this._doneCompleter.future;
+ _this._closed = true;
+ if (!_this._disconnected) {
+ _this._channel._onSinkDisconnected$0();
+ _this._doneCompleter.complete$1(0, _this._inner._target.close$0(0));
+ }
+ return _this._doneCompleter.future;
+ },
+ _onStreamDisconnected$0() {
+ var t1, t2, _this = this;
+ _this._disconnected = true;
+ t1 = _this._doneCompleter;
+ if ((t1.future._async$_state & 30) === 0)
+ t1.complete$0(0);
+ t1 = _this._addStreamSubscription;
+ if (t1 == null)
+ return;
+ t2 = _this._addStreamCompleter;
+ t2.toString;
+ t2.complete$1(0, t1.cancel$0(0));
+ _this._addStreamCompleter = null;
+ _this.set$_addStreamSubscription(null);
+ },
+ set$_addStreamSubscription(_addStreamSubscription) {
+ this._addStreamSubscription = this.$ti._eval$1("StreamSubscription<1>?")._as(_addStreamSubscription);
+ },
+ $isStreamConsumer: 1,
+ $isStreamSink: 1
+ };
+ A._GuaranteeSink_addStream_closure.prototype = {
+ call$1(_) {
+ var t1 = this.$this;
+ t1._addStreamCompleter = null;
+ t1.set$_addStreamSubscription(null);
+ },
+ $signature: 10
+ };
+ A._MultiChannel.prototype = {
+ _MultiChannel$1(inner, $T) {
+ var t2, t3, _this = this,
+ _s17_ = "_streamController",
+ t1 = _this._mainController;
+ _this._controllers.$indexSet(0, 0, t1);
+ t1 = t1.__StreamChannelController__local_F;
+ t1 === $ && A.throwLateFieldNI("_local");
+ t2 = t1.__GuaranteeChannel__streamController_F;
+ t2 === $ && A.throwLateFieldNI(_s17_);
+ new A._ControllerStream(t2, A._instanceType(t2)._eval$1("_ControllerStream<1>")).listen$2$onDone(new A._MultiChannel_closure(_this, $T), new A._MultiChannel_closure0(_this));
+ t2 = _this._multi_channel$_inner.__GuaranteeChannel__streamController_F;
+ t2 === $ && A.throwLateFieldNI(_s17_);
+ t3 = A._instanceType(t2)._eval$1("_ControllerStream<1>");
+ t1 = t1.__GuaranteeChannel__sink_F;
+ t1 === $ && A.throwLateFieldNI("_sink");
+ _this._innerStreamSubscription = new A.CastStream(new A._ControllerStream(t2, t3), t3._eval$1("CastStream<Stream.T,List<@>>")).listen$3$onDone$onError(new A._MultiChannel_closure1(_this, $T), _this.get$_closeInnerChannel(), t1.get$addError());
+ },
+ virtualChannel$1(id) {
+ var t2, controller, _this = this,
+ _s17_ = "_streamController",
+ _s8_ = "_foreign",
+ t1 = {};
+ t1.outputId = t1.inputId = null;
+ t1.inputId = id;
+ t1.outputId = id + 1;
+ if (_this._multi_channel$_inner == null) {
+ t1 = _this.$ti;
+ t2 = A.Future_Future$value(null, type$.dynamic);
+ return new A.VirtualChannel(_this, new A._EmptyStream(t1._eval$1("_EmptyStream<1>")), new A.NullStreamSink(t2, t1._eval$1("NullStreamSink<1>")), t1._eval$1("VirtualChannel<1>"));
+ }
+ controller = A._Cell$named("controller");
+ if (_this._pendingIds.remove$1(0, id)) {
+ t2 = _this._controllers.$index(0, id);
+ t2.toString;
+ controller._value = t2;
+ } else {
+ t2 = _this._controllers;
+ if (t2.containsKey$1(0, id) || _this._closedIds.contains$1(0, id))
+ throw A.wrapException(A.ArgumentError$("A virtual channel with id " + id + " already exists.", null));
+ else {
+ controller._value = A.StreamChannelController$(true, _this.$ti._precomputed1);
+ t2.$indexSet(0, id, controller._readLocal$0());
+ }
+ }
+ t2 = controller._readLocal$0().__StreamChannelController__local_F;
+ t2 === $ && A.throwLateFieldNI("_local");
+ t2 = t2.__GuaranteeChannel__streamController_F;
+ t2 === $ && A.throwLateFieldNI(_s17_);
+ new A._ControllerStream(t2, A._instanceType(t2)._eval$1("_ControllerStream<1>")).listen$2$onDone(new A._MultiChannel_virtualChannel_closure(t1, _this), new A._MultiChannel_virtualChannel_closure0(t1, _this));
+ t1 = controller._readLocal$0().__StreamChannelController__foreign_F;
+ t1 === $ && A.throwLateFieldNI(_s8_);
+ t1 = t1.__GuaranteeChannel__streamController_F;
+ t1 === $ && A.throwLateFieldNI(_s17_);
+ t2 = controller._readLocal$0().__StreamChannelController__foreign_F;
+ t2 === $ && A.throwLateFieldNI(_s8_);
+ t2 = t2.__GuaranteeChannel__sink_F;
+ t2 === $ && A.throwLateFieldNI("_sink");
+ return new A.VirtualChannel(_this, new A._ControllerStream(t1, A._instanceType(t1)._eval$1("_ControllerStream<1>")), t2, _this.$ti._eval$1("VirtualChannel<1>"));
+ },
+ _closeChannel$2(inputId, outputId) {
+ var t1, t2, _this = this;
+ _this._closedIds.add$1(0, inputId);
+ t1 = _this._controllers;
+ t2 = t1.remove$1(0, inputId);
+ t2.toString;
+ t2 = t2.__StreamChannelController__local_F;
+ t2 === $ && A.throwLateFieldNI("_local");
+ t2 = t2.__GuaranteeChannel__sink_F;
+ t2 === $ && A.throwLateFieldNI("_sink");
+ t2.close$0(0);
+ t2 = _this._multi_channel$_inner;
+ if (t2 == null)
+ return;
+ t2 = t2.__GuaranteeChannel__sink_F;
+ t2 === $ && A.throwLateFieldNI("_sink");
+ t2.add$1(0, A._setArrayType([outputId], type$.JSArray_int));
+ if (t1._length === 0)
+ _this._closeInnerChannel$0();
+ },
+ _closeInnerChannel$0() {
+ var t2, t3, _i, t4, _this = this,
+ t1 = _this._multi_channel$_inner.__GuaranteeChannel__sink_F;
+ t1 === $ && A.throwLateFieldNI("_sink");
+ t1.close$0(0);
+ _this._innerStreamSubscription._source.cancel$0(0);
+ _this._multi_channel$_inner = null;
+ for (t1 = _this._controllers, t2 = t1.get$values(t1), t2 = A.List_List$of(t2, false, A._instanceType(t2)._eval$1("Iterable.E")), t3 = t2.length, _i = 0; _i < t3; ++_i) {
+ t4 = t2[_i].__StreamChannelController__local_F;
+ t4 === $ && A.throwLateFieldNI("_local");
+ t4 = t4.__GuaranteeChannel__sink_F;
+ t4 === $ && A.throwLateFieldNI("_sink");
+ t4.close$0(0);
+ }
+ t1.clear$0(0);
+ },
+ $isMultiChannel: 1
+ };
+ A._MultiChannel_closure.prototype = {
+ call$1(message) {
+ var t1;
+ this.T._as(message);
+ t1 = this.$this._multi_channel$_inner.__GuaranteeChannel__sink_F;
+ t1 === $ && A.throwLateFieldNI("_sink");
+ return t1.add$1(0, [0, message]);
+ },
+ $signature() {
+ return this.T._eval$1("~(0)");
+ }
+ };
+ A._MultiChannel_closure0.prototype = {
+ call$0() {
+ return this.$this._closeChannel$2(0, 0);
+ },
+ $signature: 0
+ };
+ A._MultiChannel_closure1.prototype = {
+ call$1(message) {
+ var t1, id, t2, t3, controller, t4;
+ type$.List_dynamic._as(message);
+ t1 = J.getInterceptor$asx(message);
+ id = B.JSNumber_methods.toInt$0(A._asNum(t1.$index(message, 0)));
+ t2 = this.$this;
+ if (t2._closedIds.contains$1(0, id))
+ return;
+ t3 = this.T;
+ controller = t2._controllers.putIfAbsent$2(0, id, new A._MultiChannel__closure(t2, id, t3));
+ t2 = t1.get$length(message);
+ t4 = controller.__StreamChannelController__local_F;
+ if (t2 > 1) {
+ t4 === $ && A.throwLateFieldNI("_local");
+ t2 = t4.__GuaranteeChannel__sink_F;
+ t2 === $ && A.throwLateFieldNI("_sink");
+ t2.add$1(0, t3._as(t1.$index(message, 1)));
+ } else {
+ t4 === $ && A.throwLateFieldNI("_local");
+ t1 = t4.__GuaranteeChannel__sink_F;
+ t1 === $ && A.throwLateFieldNI("_sink");
+ t1.close$0(0);
+ }
+ },
+ $signature: 42
+ };
+ A._MultiChannel__closure.prototype = {
+ call$0() {
+ this.$this._pendingIds.add$1(0, this.id);
+ return A.StreamChannelController$(true, this.T);
+ },
+ $signature() {
+ return this.T._eval$1("StreamChannelController<0>()");
+ }
+ };
+ A._MultiChannel_virtualChannel_closure.prototype = {
+ call$1(message) {
+ var t1 = this.$this;
+ t1.$ti._precomputed1._as(message);
+ t1 = t1._multi_channel$_inner.__GuaranteeChannel__sink_F;
+ t1 === $ && A.throwLateFieldNI("_sink");
+ return t1.add$1(0, [this._box_0.outputId, message]);
+ },
+ $signature() {
+ return this.$this.$ti._eval$1("~(1)");
+ }
+ };
+ A._MultiChannel_virtualChannel_closure0.prototype = {
+ call$0() {
+ var t1 = this._box_0;
+ return this.$this._closeChannel$2(t1.inputId, t1.outputId);
+ },
+ $signature: 0
+ };
+ A.VirtualChannel.prototype = {$isMultiChannel: 1};
+ A.StreamChannelController.prototype = {
+ set$__StreamChannelController__local_F(__StreamChannelController__local_F) {
+ this.__StreamChannelController__local_F = this.$ti._eval$1("StreamChannel<1>")._as(__StreamChannelController__local_F);
+ },
+ set$__StreamChannelController__foreign_F(__StreamChannelController__foreign_F) {
+ this.__StreamChannelController__foreign_F = this.$ti._eval$1("StreamChannel<1>")._as(__StreamChannelController__foreign_F);
+ }
+ };
+ A.StreamChannelMixin.prototype = {$isStreamChannel: 1};
+ A.MessagePortExtension_get_postMessage_closure.prototype = {
+ call$1(message) {
+ var t2,
+ t1 = A._setArrayType([], type$.JSArray_Object);
+ if (message != null) {
+ t2 = A.jsify(message);
+ t1.push(t2 == null ? type$.Object._as(t2) : t2);
+ }
+ return A.callMethod(this._this, "postMessage", t1, type$.void);
+ },
+ $signature: 7
+ };
+ A.Subscription.prototype = {};
+ A.main_closure.prototype = {
+ call$0() {
+ var play,
+ serverChannel = A._connectToServer(),
+ t1 = serverChannel._mainController.__StreamChannelController__foreign_F;
+ t1 === $ && A.throwLateFieldNI("_foreign");
+ t1 = t1.__GuaranteeChannel__streamController_F;
+ t1 === $ && A.throwLateFieldNI("_streamController");
+ new A._ControllerStream(t1, A._instanceType(t1)._eval$1("_ControllerStream<1>")).listen$1(new A.main__closure(serverChannel));
+ A.Timer_Timer$periodic(new A.Duration(1000000), new A.main__closure0(serverChannel));
+ play = type$.nullable_JavaScriptObject._as(self.document.querySelector("#play"));
+ play.toString;
+ A.EventTargetExtension_addEventListener(play, "click", A.allowInterop(new A.main__closure1(serverChannel), type$.void_Function_JavaScriptObject));
+ t1 = type$.void_Function;
+ self.dartTest = type$.JavaScriptObject._as({resume: A.allowInterop(new A.main__closure2(serverChannel), t1), restartCurrent: A.allowInterop(new A.main__closure3(serverChannel), t1)});
+ },
+ $signature: 3
+ };
+ A.main__closure.prototype = {
+ call$1(message) {
+ var _0_4, _0_3, _0_9, _0_12, _0_15, _0_14, t1, t2, channel, url, id, suiteChannel, _null = null;
+ $label0$0: {
+ _0_4 = A._InitializedCell$named("#0#4", new A.main___closure(message));
+ _0_3 = A._InitializedCell$named("#0#3", new A.main___closure0(message));
+ _0_9 = A._InitializedCell$named("#0#9", new A.main___closure1(message));
+ _0_12 = A._InitializedCell$named("#0#12", new A.main___closure2(message));
+ _0_15 = A._InitializedCell$named("#0#15", new A.main___closure3(message));
+ _0_14 = A._InitializedCell$named("#0#14", new A.main___closure4(message));
+ t1 = type$.Map_dynamic_dynamic._is(message);
+ if (t1) {
+ if (_0_4._readFinal$0() == null)
+ t2 = A.boolConversionCheck(_0_3._readFinal$0());
+ else
+ t2 = true;
+ if (t2)
+ if ("loadSuite" === _0_4._readFinal$0()) {
+ if (_0_9._readFinal$0() == null)
+ t2 = J.containsKey$1$x(message, "channel");
+ else
+ t2 = true;
+ if (t2)
+ if (typeof _0_9._readFinal$0() == "number") {
+ channel = _0_9._readFinal$0();
+ if (_0_12._readFinal$0() == null)
+ t2 = J.containsKey$1$x(message, "url");
+ else
+ t2 = true;
+ if (t2)
+ if (typeof _0_12._readFinal$0() == "string") {
+ url = _0_12._readFinal$0();
+ if (_0_15._readFinal$0() == null)
+ t2 = A.boolConversionCheck(_0_14._readFinal$0());
+ else
+ t2 = true;
+ if (t2)
+ if (typeof _0_15._readFinal$0() == "number") {
+ id = _0_15._readFinal$0();
+ t2 = true;
+ } else {
+ id = _null;
+ t2 = false;
+ }
+ else {
+ id = _null;
+ t2 = false;
+ }
+ } else {
+ id = _null;
+ url = id;
+ t2 = false;
+ }
+ else {
+ id = _null;
+ url = id;
+ t2 = false;
+ }
+ } else {
+ id = _null;
+ url = id;
+ channel = url;
+ t2 = false;
+ }
+ else {
+ id = _null;
+ url = id;
+ channel = url;
+ t2 = false;
+ }
+ } else {
+ id = _null;
+ url = id;
+ channel = url;
+ t2 = false;
+ }
+ else {
+ id = _null;
+ url = id;
+ channel = url;
+ t2 = false;
+ }
+ } else {
+ id = _null;
+ url = id;
+ channel = url;
+ t2 = false;
+ }
+ if (t2) {
+ suiteChannel = this.serverChannel.virtualChannel$1(J.toInt$0$n(channel));
+ t1 = suiteChannel.$ti._eval$1("StreamChannel<1>")._as(A._connectToIframe(url, J.toInt$0$n(id)));
+ t2 = t1.__GuaranteeChannel__sink_F;
+ t2 === $ && A.throwLateFieldNI("_sink");
+ suiteChannel.stream.pipe$1(t2);
+ t1 = t1.__GuaranteeChannel__streamController_F;
+ t1 === $ && A.throwLateFieldNI("_streamController");
+ new A._ControllerStream(t1, A._instanceType(t1)._eval$1("_ControllerStream<1>")).pipe$1(suiteChannel.sink);
+ break $label0$0;
+ }
+ if (t1) {
+ if (_0_4._readFinal$0() == null)
+ t2 = A.boolConversionCheck(_0_3._readFinal$0());
+ else
+ t2 = true;
+ t2 = t2 && "displayPause" === _0_4._readFinal$0();
+ } else
+ t2 = false;
+ if (t2) {
+ type$.JavaScriptObject._as(type$.nullable_JavaScriptObject._as(self.document.body).classList).add("paused");
+ break $label0$0;
+ }
+ if (t1) {
+ if (_0_4._readFinal$0() == null)
+ t2 = A.boolConversionCheck(_0_3._readFinal$0());
+ else
+ t2 = true;
+ t2 = t2 && "resume" === _0_4._readFinal$0();
+ } else
+ t2 = false;
+ if (t2) {
+ type$.JavaScriptObject._as(type$.nullable_JavaScriptObject._as(self.document.body).classList).remove("paused");
+ break $label0$0;
+ }
+ if (t1) {
+ if (_0_4._readFinal$0() == null)
+ t1 = A.boolConversionCheck(_0_3._readFinal$0());
+ else
+ t1 = true;
+ if (t1)
+ if ("closeSuite" === _0_4._readFinal$0()) {
+ if (_0_15._readFinal$0() == null)
+ t1 = A.boolConversionCheck(_0_14._readFinal$0());
+ else
+ t1 = true;
+ if (t1) {
+ id = _0_15._readFinal$0();
+ t1 = true;
+ } else {
+ id = _null;
+ t1 = false;
+ }
+ } else {
+ id = _null;
+ t1 = false;
+ }
+ else {
+ id = _null;
+ t1 = false;
+ }
+ } else {
+ id = _null;
+ t1 = false;
+ }
+ if (t1) {
+ t1 = $._iframes.remove$1(0, id);
+ t2 = type$.nullable_JavaScriptObject;
+ if (t2._as(t1.parentNode) != null)
+ type$.JavaScriptObject._as(t2._as(t1.parentNode).removeChild(t1));
+ t1 = $._subscriptions.remove$1(0, id);
+ if (t1 != null)
+ J.cancel$0$z(t1);
+ t1 = $._domSubscriptions.remove$1(0, id);
+ if (t1 != null)
+ A.EventTargetExtension_removeEventListener(t1.target, t1.type, t1.listener);
+ break $label0$0;
+ }
+ type$.JavaScriptObject._as(self.window.console).warn("Unhandled message from test runner: " + A.S(message));
+ }
+ },
+ $signature: 5
+ };
+ A.main___closure.prototype = {
+ call$0() {
+ return J.$index$asx(type$.Map_dynamic_dynamic._as(this._0_0), "command");
+ },
+ $signature: 2
+ };
+ A.main___closure0.prototype = {
+ call$0() {
+ return J.containsKey$1$x(type$.Map_dynamic_dynamic._as(this._0_0), "command");
+ },
+ $signature: 24
+ };
+ A.main___closure1.prototype = {
+ call$0() {
+ return J.$index$asx(type$.Map_dynamic_dynamic._as(this._0_0), "channel");
+ },
+ $signature: 2
+ };
+ A.main___closure2.prototype = {
+ call$0() {
+ return J.$index$asx(type$.Map_dynamic_dynamic._as(this._0_0), "url");
+ },
+ $signature: 2
+ };
+ A.main___closure3.prototype = {
+ call$0() {
+ return J.$index$asx(type$.Map_dynamic_dynamic._as(this._0_0), "id");
+ },
+ $signature: 2
+ };
+ A.main___closure4.prototype = {
+ call$0() {
+ return J.containsKey$1$x(type$.Map_dynamic_dynamic._as(this._0_0), "id");
+ },
+ $signature: 24
+ };
+ A.main__closure0.prototype = {
+ call$1(_) {
+ var t1, t2;
+ type$.Timer._as(_);
+ t1 = this.serverChannel._mainController.__StreamChannelController__foreign_F;
+ t1 === $ && A.throwLateFieldNI("_foreign");
+ t1 = t1.__GuaranteeChannel__sink_F;
+ t1 === $ && A.throwLateFieldNI("_sink");
+ t2 = type$.String;
+ return t1.add$1(0, A.LinkedHashMap_LinkedHashMap$_literal(["command", "ping"], t2, t2));
+ },
+ $signature: 44
+ };
+ A.main__closure1.prototype = {
+ call$1(_) {
+ var t2,
+ t1 = type$.JavaScriptObject;
+ t1._as(_);
+ t2 = type$.nullable_JavaScriptObject;
+ if (!A._asBool(t1._as(t2._as(self.document.body).classList).contains("paused")))
+ return;
+ t1._as(t2._as(self.document.body).classList).remove("paused");
+ t1 = this.serverChannel._mainController.__StreamChannelController__foreign_F;
+ t1 === $ && A.throwLateFieldNI("_foreign");
+ t1 = t1.__GuaranteeChannel__sink_F;
+ t1 === $ && A.throwLateFieldNI("_sink");
+ t2 = type$.String;
+ t1.add$1(0, A.LinkedHashMap_LinkedHashMap$_literal(["command", "resume"], t2, t2));
+ },
+ $signature: 8
+ };
+ A.main__closure2.prototype = {
+ call$0() {
+ var t1 = type$.nullable_JavaScriptObject,
+ t2 = type$.JavaScriptObject;
+ if (!A._asBool(t2._as(t1._as(self.document.body).classList).contains("paused")))
+ return;
+ t2._as(t1._as(self.document.body).classList).remove("paused");
+ t1 = this.serverChannel._mainController.__StreamChannelController__foreign_F;
+ t1 === $ && A.throwLateFieldNI("_foreign");
+ t1 = t1.__GuaranteeChannel__sink_F;
+ t1 === $ && A.throwLateFieldNI("_sink");
+ t2 = type$.String;
+ t1.add$1(0, A.LinkedHashMap_LinkedHashMap$_literal(["command", "resume"], t2, t2));
+ },
+ $signature: 0
+ };
+ A.main__closure3.prototype = {
+ call$0() {
+ var t2,
+ t1 = this.serverChannel._mainController.__StreamChannelController__foreign_F;
+ t1 === $ && A.throwLateFieldNI("_foreign");
+ t1 = t1.__GuaranteeChannel__sink_F;
+ t1 === $ && A.throwLateFieldNI("_sink");
+ t2 = type$.String;
+ t1.add$1(0, A.LinkedHashMap_LinkedHashMap$_literal(["command", "restart"], t2, t2));
+ },
+ $signature: 0
+ };
+ A.main_closure0.prototype = {
+ call$2(error, stackTrace) {
+ type$.Object._as(error);
+ type$.StackTrace._as(stackTrace);
+ type$.JavaScriptObject._as(self.window.console).warn(A.S(error) + "\n" + A.Trace_Trace$from(stackTrace).get$terse().toString$0(0));
+ },
+ $signature: 11
+ };
+ A._connectToServer_closure.prototype = {
+ call$1(message) {
+ var t1;
+ type$.JavaScriptObject._as(message);
+ t1 = this.controller.__StreamChannelController__local_F;
+ t1 === $ && A.throwLateFieldNI("_local");
+ t1 = t1.__GuaranteeChannel__sink_F;
+ t1 === $ && A.throwLateFieldNI("_sink");
+ t1.add$1(0, B.C_JsonCodec.decode$2$reviver(0, A._asString(A.dartify(message.data)), null));
+ },
+ $signature: 8
+ };
+ A._connectToServer_closure0.prototype = {
+ call$1(message) {
+ return this.webSocket.send(B.C_JsonCodec.encode$2$toEncodable(message, null));
+ },
+ $signature: 5
+ };
+ A._connectToIframe_closure.prototype = {
+ call$1($event) {
+ var t2, _0_0, _0_6, _0_11, port, data, _this = this, _null = null,
+ t1 = type$.JavaScriptObject;
+ t1._as($event);
+ if (A._asString($event.origin) !== A._asString(t1._as(self.window.location).origin))
+ return;
+ t2 = $event.source.location;
+ t2 = t2 == null ? _null : A._asStringQ(t2.href);
+ if (t2 != A._asStringQ(_this.iframe.src))
+ return;
+ $event.stopPropagation();
+ t2 = _this.windowSubscription._readLocal$0();
+ A.EventTargetExtension_removeEventListener(t2.target, t2.type, t2.listener);
+ $label0$0: {
+ _0_0 = A.dartify($event.data);
+ _0_6 = A._InitializedCell$named("#0#6", new A._connectToIframe__closure(_0_0));
+ _0_11 = A._InitializedCell$named("#0#11", new A._connectToIframe__closure0(_0_0));
+ if ("port" === _0_0) {
+ t1._as(self.window.console).log("Connecting channel for suite " + _this.suiteUrl.toString$0(0));
+ t1 = J.cast$1$0$ax(type$.List_dynamic._as($event.ports), t1);
+ port = t1.get$first(t1);
+ t1 = _this.id;
+ t2 = _this.controller;
+ $._domSubscriptions.$indexSet(0, t1, A.Subscription$(port, "message", A.allowInterop(new A._connectToIframe__closure1(t2), type$.void_Function_JavaScriptObject)));
+ port.start();
+ t2 = t2.__StreamChannelController__local_F;
+ t2 === $ && A.throwLateFieldNI("_local");
+ t2 = t2.__GuaranteeChannel__streamController_F;
+ t2 === $ && A.throwLateFieldNI("_streamController");
+ $._subscriptions.$indexSet(0, t1, new A._ControllerStream(t2, A._instanceType(t2)._eval$1("_ControllerStream<1>")).listen$1(A.MessagePortExtension_get_postMessage(port)));
+ break $label0$0;
+ }
+ if (type$.Map_dynamic_dynamic._is(_0_0)) {
+ if (_0_6._readFinal$0() == null)
+ t1 = J.containsKey$1$x(_0_0, "exception");
+ else
+ t1 = true;
+ if (t1)
+ if (true === _0_6._readFinal$0()) {
+ if (_0_11._readFinal$0() == null)
+ t1 = J.containsKey$1$x(_0_0, "data");
+ else
+ t1 = true;
+ if (t1) {
+ data = _0_11._readFinal$0();
+ t1 = true;
+ } else {
+ data = _null;
+ t1 = false;
+ }
+ } else {
+ data = _null;
+ t1 = false;
+ }
+ else {
+ data = _null;
+ t1 = false;
+ }
+ } else {
+ data = _null;
+ t1 = false;
+ }
+ if (t1) {
+ t1 = _this.controller.__StreamChannelController__local_F;
+ t1 === $ && A.throwLateFieldNI("_local");
+ t1 = t1.__GuaranteeChannel__sink_F;
+ t1 === $ && A.throwLateFieldNI("_sink");
+ t1.add$1(0, data);
+ }
+ }
+ },
+ $signature: 8
+ };
+ A._connectToIframe__closure1.prototype = {
+ call$1($event) {
+ var t1;
+ type$.JavaScriptObject._as($event);
+ t1 = this.controller.__StreamChannelController__local_F;
+ t1 === $ && A.throwLateFieldNI("_local");
+ t1 = t1.__GuaranteeChannel__sink_F;
+ t1 === $ && A.throwLateFieldNI("_sink");
+ t1.add$1(0, A.dartify($event.data));
+ },
+ $signature: 8
+ };
+ A._connectToIframe__closure.prototype = {
+ call$0() {
+ return J.$index$asx(type$.Map_dynamic_dynamic._as(this._0_0), "exception");
+ },
+ $signature: 2
+ };
+ A._connectToIframe__closure0.prototype = {
+ call$0() {
+ return J.$index$asx(type$.Map_dynamic_dynamic._as(this._0_0), "data");
+ },
+ $signature: 2
+ };
+ (function aliases() {
+ var _ = J.Interceptor.prototype;
+ _.super$Interceptor$toString = _.toString$0;
+ _ = J.LegacyJavaScriptObject.prototype;
+ _.super$LegacyJavaScriptObject$toString = _.toString$0;
+ _ = A.Iterable.prototype;
+ _.super$Iterable$skipWhile = _.skipWhile$1;
+ })();
+ (function installTearOffs() {
+ var _instance_1_u = hunkHelpers._instance_1u,
+ _static_1 = hunkHelpers._static_1,
+ _static_0 = hunkHelpers._static_0,
+ _static_2 = hunkHelpers._static_2,
+ _static = hunkHelpers.installStaticTearOff,
+ _instance = hunkHelpers.installInstanceTearOff,
+ _instance_2_u = hunkHelpers._instance_2u,
+ _instance_1_i = hunkHelpers._instance_1i,
+ _instance_0_u = hunkHelpers._instance_0u;
+ _instance_1_u(A.CastStreamSubscription.prototype, "get$__internal$_onData", "__internal$_onData$1", 7);
+ _static_1(A, "async__AsyncRun__scheduleImmediateJsOverride$closure", "_AsyncRun__scheduleImmediateJsOverride", 13);
+ _static_1(A, "async__AsyncRun__scheduleImmediateWithSetImmediate$closure", "_AsyncRun__scheduleImmediateWithSetImmediate", 13);
+ _static_1(A, "async__AsyncRun__scheduleImmediateWithTimer$closure", "_AsyncRun__scheduleImmediateWithTimer", 13);
+ _static_0(A, "async___startMicrotaskLoop$closure", "_startMicrotaskLoop", 0);
+ _static_1(A, "async___nullDataHandler$closure", "_nullDataHandler", 5);
+ _static_2(A, "async___nullErrorHandler$closure", "_nullErrorHandler", 11);
+ _static_0(A, "async___nullDoneHandler$closure", "_nullDoneHandler", 0);
+ _static(A, "async___rootHandleUncaughtError$closure", 5, null, ["call$5"], ["_rootHandleUncaughtError"], 47, 0);
+ _static(A, "async___rootRun$closure", 4, null, ["call$1$4", "call$4"], ["_rootRun", function($self, $parent, zone, f) {
+ return A._rootRun($self, $parent, zone, f, type$.dynamic);
+ }], 48, 1);
+ _static(A, "async___rootRunUnary$closure", 5, null, ["call$2$5", "call$5"], ["_rootRunUnary", function($self, $parent, zone, f, arg) {
+ return A._rootRunUnary($self, $parent, zone, f, arg, type$.dynamic, type$.dynamic);
+ }], 49, 1);
+ _static(A, "async___rootRunBinary$closure", 6, null, ["call$3$6", "call$6"], ["_rootRunBinary", function($self, $parent, zone, f, arg1, arg2) {
+ return A._rootRunBinary($self, $parent, zone, f, arg1, arg2, type$.dynamic, type$.dynamic, type$.dynamic);
+ }], 50, 1);
+ _static(A, "async___rootRegisterCallback$closure", 4, null, ["call$1$4", "call$4"], ["_rootRegisterCallback", function($self, $parent, zone, f) {
+ return A._rootRegisterCallback($self, $parent, zone, f, type$.dynamic);
+ }], 51, 0);
+ _static(A, "async___rootRegisterUnaryCallback$closure", 4, null, ["call$2$4", "call$4"], ["_rootRegisterUnaryCallback", function($self, $parent, zone, f) {
+ return A._rootRegisterUnaryCallback($self, $parent, zone, f, type$.dynamic, type$.dynamic);
+ }], 52, 0);
+ _static(A, "async___rootRegisterBinaryCallback$closure", 4, null, ["call$3$4", "call$4"], ["_rootRegisterBinaryCallback", function($self, $parent, zone, f) {
+ return A._rootRegisterBinaryCallback($self, $parent, zone, f, type$.dynamic, type$.dynamic, type$.dynamic);
+ }], 53, 0);
+ _static(A, "async___rootErrorCallback$closure", 5, null, ["call$5"], ["_rootErrorCallback"], 54, 0);
+ _static(A, "async___rootScheduleMicrotask$closure", 4, null, ["call$4"], ["_rootScheduleMicrotask"], 55, 0);
+ _static(A, "async___rootCreateTimer$closure", 5, null, ["call$5"], ["_rootCreateTimer"], 56, 0);
+ _static(A, "async___rootCreatePeriodicTimer$closure", 5, null, ["call$5"], ["_rootCreatePeriodicTimer"], 57, 0);
+ _static(A, "async___rootPrint$closure", 4, null, ["call$4"], ["_rootPrint"], 58, 0);
+ _static(A, "async___rootFork$closure", 5, null, ["call$5"], ["_rootFork"], 59, 0);
+ _instance(A._SyncCompleter.prototype, "get$complete", 1, 0, function() {
+ return [null];
+ }, ["call$1", "call$0"], ["complete$1", "complete$0"], 43, 0, 0);
+ _instance_2_u(A._Future.prototype, "get$_completeError", "_completeError$2", 11);
+ var _;
+ _instance_1_i(_ = A._StreamController.prototype, "get$add", "add$1", 7);
+ _instance(_, "get$addError", 0, 1, function() {
+ return [null];
+ }, ["call$2", "call$1"], ["addError$2", "addError$1"], 12, 0, 0);
+ _instance_1_i(A._StreamSinkWrapper.prototype, "get$add", "add$1", 7);
+ _instance_0_u(A._DoneStreamSubscription.prototype, "get$_onMicrotask", "_onMicrotask$0", 0);
+ _static_1(A, "convert___defaultToEncodable$closure", "_defaultToEncodable", 15);
+ _static_1(A, "core_Uri_decodeComponent$closure", "Uri_decodeComponent", 17);
+ _static_1(A, "frame_Frame___parseVM_tearOff$closure", "Frame___parseVM_tearOff", 9);
+ _static_1(A, "frame_Frame___parseV8_tearOff$closure", "Frame___parseV8_tearOff", 9);
+ _static_1(A, "frame_Frame___parseFirefox_tearOff$closure", "Frame___parseFirefox_tearOff", 9);
+ _static_1(A, "frame_Frame___parseFriendly_tearOff$closure", "Frame___parseFriendly_tearOff", 9);
+ _static_1(A, "trace_Trace___parseVM_tearOff$closure", "Trace___parseVM_tearOff", 14);
+ _static_1(A, "trace_Trace___parseFriendly_tearOff$closure", "Trace___parseFriendly_tearOff", 14);
+ _instance(_ = A._GuaranteeSink.prototype, "get$addError", 0, 1, function() {
+ return [null];
+ }, ["call$2", "call$1"], ["addError$2", "addError$1"], 12, 0, 0);
+ _instance(_, "get$_addError", 0, 1, function() {
+ return [null];
+ }, ["call$2", "call$1"], ["_addError$2", "_addError$1"], 12, 0, 0);
+ _instance_0_u(A._MultiChannel.prototype, "get$_closeInnerChannel", "_closeInnerChannel$0", 0);
+ _static(A, "math__max$closure", 2, null, ["call$1$2", "call$2"], ["max", function(a, b) {
+ return A.max(a, b, type$.num);
+ }], 41, 0);
+ })();
+ (function inheritance() {
+ var _mixin = hunkHelpers.mixin,
+ _inherit = hunkHelpers.inherit,
+ _inheritMany = hunkHelpers.inheritMany;
+ _inherit(A.Object, null);
+ _inheritMany(A.Object, [A.JS_CONST, J.Interceptor, J.ArrayIterator, A.Stream, A.CastStreamSubscription, A.Iterable, A.CastIterator, A.Error, A.ListBase, A.Closure, A.SentinelValue, A.ListIterator, A.MappedIterator, A.WhereIterator, A.ExpandIterator, A.TakeIterator, A.SkipIterator, A.SkipWhileIterator, A.EmptyIterator, A.WhereTypeIterator, A.FixedLengthListMixin, A.UnmodifiableListMixin, A.Symbol, A.MapView, A.ConstantMap, A._KeysOrValuesOrElementsIterator, A.JSInvocationMirror, A.TypeErrorDecoder, A.NullThrownFromJavaScriptException, A._StackTrace, A._Required, A.MapBase, A.LinkedHashMapCell, A.LinkedHashMapKeyIterator, A.JSSyntaxRegExp, A._MatchImplementation, A._AllMatchesIterator, A.StringMatch, A._StringAllMatchesIterator, A._Cell, A._InitializedCell, A.Rti, A._FunctionParameters, A._Type, A._TimerImpl, A.AsyncError, A._Completer, A._FutureListener, A._Future, A._AsyncCallbackEntry, A._StreamController, A._SyncStreamControllerDispatch, A._BufferingStreamSubscription, A._StreamSinkWrapper, A._DelayedEvent, A._DelayedDone, A._PendingEvents, A._DoneStreamSubscription, A._ZoneFunction, A._ZoneSpecification, A._ZoneDelegate, A._Zone, A._HashMapKeyIterator, A.SetBase, A._LinkedHashSetCell, A._LinkedHashSetIterator, A._UnmodifiableMapMixin, A.Codec, A.Converter, A._JsonStringifier, A._Utf8Encoder, A._Utf8Decoder, A.DateTime, A.Duration, A.OutOfMemoryError, A.StackOverflowError, A._Exception, A.FormatException, A.Null, A._StringStackTrace, A.StringBuffer, A._Uri, A.UriData, A._SimpleUri, A.CssStyleDeclarationBase, A.ImmutableListMixin, A.FixedSizeListIterator, A.NullRejectionException, A.NullStreamSink, A.Context, A.Style, A.ParsedPath, A.PathException, A.Chain, A.Frame, A.LazyTrace, A.Trace, A.UnparsedFrame, A.StreamChannelMixin, A._GuaranteeSink, A.StreamChannelController, A.Subscription]);
+ _inheritMany(J.Interceptor, [J.JSBool, J.JSNull, J.JavaScriptObject, J.JavaScriptBigInt, J.JavaScriptSymbol, J.JSNumber, J.JSString]);
+ _inheritMany(J.JavaScriptObject, [J.LegacyJavaScriptObject, J.JSArray, A.NativeByteBuffer, A.NativeTypedData, A.EventTarget, A.AccessibleNodeList, A.Blob, A.CssTransformComponent, A.CssRule, A._CssStyleDeclaration_JavaScriptObject_CssStyleDeclarationBase, A.CssStyleValue, A.DataTransferItemList, A.DomException, A._DomRectList_JavaScriptObject_ListMixin, A.DomRectReadOnly, A._DomStringList_JavaScriptObject_ListMixin, A.DomTokenList, A._FileList_JavaScriptObject_ListMixin, A.Gamepad, A.History, A._HtmlCollection_JavaScriptObject_ListMixin, A.Location, A.MediaList, A._MidiInputMap_JavaScriptObject_MapMixin, A._MidiOutputMap_JavaScriptObject_MapMixin, A.MimeType, A._MimeTypeArray_JavaScriptObject_ListMixin, A._NodeList_JavaScriptObject_ListMixin, A.Plugin, A._PluginArray_JavaScriptObject_ListMixin, A._RtcStatsReport_JavaScriptObject_MapMixin, A.SpeechGrammar, A._SpeechGrammarList_JavaScriptObject_ListMixin, A.SpeechRecognitionResult, A._Storage_JavaScriptObject_MapMixin, A.StyleSheet, A._TextTrackCueList_JavaScriptObject_ListMixin, A.TimeRanges, A.Touch, A._TouchList_JavaScriptObject_ListMixin, A.TrackDefaultList, A.Url, A.__CssRuleList_JavaScriptObject_ListMixin, A.__GamepadList_JavaScriptObject_ListMixin, A.__NamedNodeMap_JavaScriptObject_ListMixin, A.__SpeechRecognitionResultList_JavaScriptObject_ListMixin, A.__StyleSheetList_JavaScriptObject_ListMixin, A.Length, A._LengthList_JavaScriptObject_ListMixin, A.Number, A._NumberList_JavaScriptObject_ListMixin, A.PointList, A._StringList_JavaScriptObject_ListMixin, A.Transform, A._TransformList_JavaScriptObject_ListMixin, A.AudioBuffer, A._AudioParamMap_JavaScriptObject_MapMixin]);
+ _inheritMany(J.LegacyJavaScriptObject, [J.PlainJavaScriptObject, J.UnknownJavaScriptObject, J.JavaScriptFunction]);
+ _inherit(J.JSUnmodifiableArray, J.JSArray);
+ _inheritMany(J.JSNumber, [J.JSInt, J.JSNumNotInt]);
+ _inheritMany(A.Stream, [A.CastStream, A._StreamImpl, A._EmptyStream]);
+ _inheritMany(A.Iterable, [A._CastIterableBase, A.EfficientLengthIterable, A.MappedIterable, A.WhereIterable, A.ExpandIterable, A.TakeIterable, A.SkipIterable, A.SkipWhileIterable, A.WhereTypeIterable, A._KeysOrValues, A._AllMatchesIterable, A._StringAllMatchesIterable]);
+ _inheritMany(A._CastIterableBase, [A.CastIterable, A.__CastListBase__CastIterableBase_ListMixin]);
+ _inherit(A._EfficientLengthCastIterable, A.CastIterable);
+ _inherit(A._CastListBase, A.__CastListBase__CastIterableBase_ListMixin);
+ _inherit(A.CastList, A._CastListBase);
+ _inheritMany(A.Error, [A.LateError, A.TypeError, A.JsNoSuchMethodError, A.UnknownJsTypeError, A._CyclicInitializationError, A.RuntimeError, A.AssertionError, A._Error, A.JsonUnsupportedObjectError, A.ArgumentError, A.NoSuchMethodError, A.UnsupportedError, A.UnimplementedError, A.StateError, A.ConcurrentModificationError]);
+ _inherit(A.UnmodifiableListBase, A.ListBase);
+ _inherit(A.CodeUnits, A.UnmodifiableListBase);
+ _inheritMany(A.Closure, [A.Closure0Args, A.Instantiation, A.Closure2Args, A.TearOffClosure, A.JsLinkedHashMap_values_closure, A.initHooks_closure, A.initHooks_closure1, A._AsyncRun__initializeScheduleImmediate_internalCallback, A._AsyncRun__initializeScheduleImmediate_closure, A._Future__chainForeignFuture_closure, A._Future__propagateToListeners_handleWhenCompleteCallback_closure, A.Stream_pipe_closure, A.Stream_length_closure, A._CustomZone_bindUnaryCallback_closure, A._CustomZone_bindUnaryCallbackGuarded_closure, A._RootZone_bindUnaryCallback_closure, A._RootZone_bindUnaryCallbackGuarded_closure, A.runZonedGuarded_closure, A._Uri__makePath_closure, A._createTables_setChars, A._createTables_setRange, A.jsify__convert, A.promiseToFuture_closure, A.promiseToFuture_closure0, A.dartify_convert, A.Context_joinAll_closure, A.Context_split_closure, A._validateArgList_closure, A.WindowsStyle_absolutePathToUri_closure, A.Chain_Chain$parse_closure, A.Chain_toTrace_closure, A.Chain_toString_closure0, A.Chain_toString__closure0, A.Chain_toString_closure, A.Chain_toString__closure, A.Trace__parseVM_closure, A.Trace$parseV8_closure, A.Trace$parseJSCore_closure, A.Trace$parseFirefox_closure, A.Trace$parseFriendly_closure, A.Trace_terse_closure, A.Trace_foldFrames_closure, A.Trace_foldFrames_closure0, A.Trace_toString_closure0, A.Trace_toString_closure, A._GuaranteeSink_addStream_closure, A._MultiChannel_closure, A._MultiChannel_closure1, A._MultiChannel_virtualChannel_closure, A.MessagePortExtension_get_postMessage_closure, A.main__closure, A.main__closure0, A.main__closure1, A._connectToServer_closure, A._connectToServer_closure0, A._connectToIframe_closure, A._connectToIframe__closure1]);
+ _inheritMany(A.Closure0Args, [A.nullFuture_closure, A._AsyncRun__scheduleImmediateJsOverride_internalCallback, A._AsyncRun__scheduleImmediateWithSetImmediate_internalCallback, A._TimerImpl_internalCallback, A._TimerImpl$periodic_closure, A._Future__addListener_closure, A._Future__prependListeners_closure, A._Future__chainForeignFuture_closure1, A._Future__chainCoreFutureAsync_closure, A._Future__asyncCompleteWithValue_closure, A._Future__asyncCompleteError_closure, A._Future__propagateToListeners_handleWhenCompleteCallback, A._Future__propagateToListeners_handleValueCallback, A._Future__propagateToListeners_handleError, A.Stream_length_closure0, A._StreamController__subscribe_closure, A._StreamController__recordCancel_complete, A._AddStreamState_cancel_closure, A._BufferingStreamSubscription__sendError_sendError, A._BufferingStreamSubscription__sendDone_sendDone, A._PendingEvents_schedule_closure, A._CustomZone_bindCallback_closure, A._CustomZone_bindCallbackGuarded_closure, A._rootHandleError_closure, A._RootZone_bindCallback_closure, A._RootZone_bindCallbackGuarded_closure, A.Utf8Decoder__decoder_closure, A.Utf8Decoder__decoderNonfatal_closure, A.NullStreamSink_addStream_closure, A.Frame_Frame$parseVM_closure, A.Frame_Frame$parseV8_closure, A.Frame_Frame$_parseFirefoxEval_closure, A.Frame_Frame$parseFirefox_closure, A.Frame_Frame$parseFriendly_closure, A.LazyTrace_terse_closure, A.Trace_Trace$from_closure, A.GuaranteeChannel_closure, A.GuaranteeChannel__closure, A._MultiChannel_closure0, A._MultiChannel__closure, A._MultiChannel_virtualChannel_closure0, A.main_closure, A.main___closure, A.main___closure0, A.main___closure1, A.main___closure2, A.main___closure3, A.main___closure4, A.main__closure2, A.main__closure3, A._connectToIframe__closure, A._connectToIframe__closure0]);
+ _inheritMany(A.EfficientLengthIterable, [A.ListIterable, A.EmptyIterable, A.LinkedHashMapKeyIterable, A._HashMapKeyIterable]);
+ _inheritMany(A.ListIterable, [A.SubListIterable, A.MappedListIterable, A.ReversedListIterable, A._JsonMapKeyIterable]);
+ _inherit(A.EfficientLengthMappedIterable, A.MappedIterable);
+ _inherit(A.EfficientLengthTakeIterable, A.TakeIterable);
+ _inherit(A.EfficientLengthSkipIterable, A.SkipIterable);
+ _inherit(A._UnmodifiableMapView_MapView__UnmodifiableMapMixin, A.MapView);
+ _inherit(A.UnmodifiableMapView, A._UnmodifiableMapView_MapView__UnmodifiableMapMixin);
+ _inherit(A.ConstantMapView, A.UnmodifiableMapView);
+ _inherit(A.ConstantStringMap, A.ConstantMap);
+ _inherit(A.Instantiation1, A.Instantiation);
+ _inheritMany(A.Closure2Args, [A.Primitives_functionNoSuchMethod_closure, A.initHooks_closure0, A._Future__chainForeignFuture_closure0, A.MapBase_mapToString_closure, A._JsonStringifier_writeMap_closure, A.NoSuchMethodError_toString_closure, A.Uri_splitQueryString_closure, A.Uri__parseIPv4Address_error, A.Uri_parseIPv6Address_error, A.Uri_parseIPv6Address_parseHex, A._createTables_build, A.MidiInputMap_keys_closure, A.MidiOutputMap_keys_closure, A.RtcStatsReport_keys_closure, A.Storage_keys_closure, A.AudioParamMap_keys_closure, A.Frame_Frame$parseV8_closure_parseLocation, A.main_closure0]);
+ _inherit(A.NullError, A.TypeError);
+ _inheritMany(A.TearOffClosure, [A.StaticClosure, A.BoundClosure]);
+ _inherit(A._AssertionError, A.AssertionError);
+ _inheritMany(A.MapBase, [A.JsLinkedHashMap, A._HashMap, A._JsonMap]);
+ _inheritMany(A.NativeTypedData, [A.NativeByteData, A.NativeTypedArray]);
+ _inheritMany(A.NativeTypedArray, [A._NativeTypedArrayOfDouble_NativeTypedArray_ListMixin, A._NativeTypedArrayOfInt_NativeTypedArray_ListMixin]);
+ _inherit(A._NativeTypedArrayOfDouble_NativeTypedArray_ListMixin_FixedLengthListMixin, A._NativeTypedArrayOfDouble_NativeTypedArray_ListMixin);
+ _inherit(A.NativeTypedArrayOfDouble, A._NativeTypedArrayOfDouble_NativeTypedArray_ListMixin_FixedLengthListMixin);
+ _inherit(A._NativeTypedArrayOfInt_NativeTypedArray_ListMixin_FixedLengthListMixin, A._NativeTypedArrayOfInt_NativeTypedArray_ListMixin);
+ _inherit(A.NativeTypedArrayOfInt, A._NativeTypedArrayOfInt_NativeTypedArray_ListMixin_FixedLengthListMixin);
+ _inheritMany(A.NativeTypedArrayOfDouble, [A.NativeFloat32List, A.NativeFloat64List]);
+ _inheritMany(A.NativeTypedArrayOfInt, [A.NativeInt16List, A.NativeInt32List, A.NativeInt8List, A.NativeUint16List, A.NativeUint32List, A.NativeUint8ClampedList, A.NativeUint8List]);
+ _inherit(A._TypeError, A._Error);
+ _inheritMany(A._Completer, [A._AsyncCompleter, A._SyncCompleter]);
+ _inherit(A._SyncStreamController, A._StreamController);
+ _inherit(A._ControllerStream, A._StreamImpl);
+ _inherit(A._ControllerSubscription, A._BufferingStreamSubscription);
+ _inheritMany(A._DelayedEvent, [A._DelayedData, A._DelayedError]);
+ _inheritMany(A._Zone, [A._CustomZone, A._RootZone]);
+ _inherit(A._IdentityHashMap, A._HashMap);
+ _inherit(A._SetBase, A.SetBase);
+ _inherit(A._LinkedHashSet, A._SetBase);
+ _inheritMany(A.Codec, [A.Encoding, A.Base64Codec, A._FusedCodec, A.JsonCodec]);
+ _inheritMany(A.Encoding, [A.AsciiCodec, A.Utf8Codec]);
+ _inheritMany(A.Converter, [A._UnicodeSubsetEncoder, A.Base64Encoder, A.JsonEncoder, A.JsonDecoder, A.Utf8Encoder, A.Utf8Decoder]);
+ _inherit(A.AsciiEncoder, A._UnicodeSubsetEncoder);
+ _inherit(A.JsonCyclicError, A.JsonUnsupportedObjectError);
+ _inherit(A._JsonStringStringifier, A._JsonStringifier);
+ _inheritMany(A.ArgumentError, [A.RangeError, A.IndexError]);
+ _inherit(A._DataUri, A._Uri);
+ _inheritMany(A.EventTarget, [A.Node, A.FileWriter, A.SourceBuffer, A._SourceBufferList_EventTarget_ListMixin, A.TextTrack, A.TextTrackCue, A._TextTrackList_EventTarget_ListMixin, A.VideoTrackList, A.AudioTrackList, A.BaseAudioContext]);
+ _inheritMany(A.Node, [A.Element, A.CharacterData]);
+ _inherit(A.HtmlElement, A.Element);
+ _inheritMany(A.HtmlElement, [A.AnchorElement, A.AreaElement, A.FormElement, A.SelectElement]);
+ _inherit(A.CssPerspective, A.CssTransformComponent);
+ _inherit(A.CssStyleDeclaration, A._CssStyleDeclaration_JavaScriptObject_CssStyleDeclarationBase);
+ _inheritMany(A.CssStyleValue, [A.CssTransformValue, A.CssUnparsedValue]);
+ _inherit(A._DomRectList_JavaScriptObject_ListMixin_ImmutableListMixin, A._DomRectList_JavaScriptObject_ListMixin);
+ _inherit(A.DomRectList, A._DomRectList_JavaScriptObject_ListMixin_ImmutableListMixin);
+ _inherit(A._DomStringList_JavaScriptObject_ListMixin_ImmutableListMixin, A._DomStringList_JavaScriptObject_ListMixin);
+ _inherit(A.DomStringList, A._DomStringList_JavaScriptObject_ListMixin_ImmutableListMixin);
+ _inherit(A.File, A.Blob);
+ _inherit(A._FileList_JavaScriptObject_ListMixin_ImmutableListMixin, A._FileList_JavaScriptObject_ListMixin);
+ _inherit(A.FileList, A._FileList_JavaScriptObject_ListMixin_ImmutableListMixin);
+ _inherit(A._HtmlCollection_JavaScriptObject_ListMixin_ImmutableListMixin, A._HtmlCollection_JavaScriptObject_ListMixin);
+ _inherit(A.HtmlCollection, A._HtmlCollection_JavaScriptObject_ListMixin_ImmutableListMixin);
+ _inherit(A.MidiInputMap, A._MidiInputMap_JavaScriptObject_MapMixin);
+ _inherit(A.MidiOutputMap, A._MidiOutputMap_JavaScriptObject_MapMixin);
+ _inherit(A._MimeTypeArray_JavaScriptObject_ListMixin_ImmutableListMixin, A._MimeTypeArray_JavaScriptObject_ListMixin);
+ _inherit(A.MimeTypeArray, A._MimeTypeArray_JavaScriptObject_ListMixin_ImmutableListMixin);
+ _inherit(A._NodeList_JavaScriptObject_ListMixin_ImmutableListMixin, A._NodeList_JavaScriptObject_ListMixin);
+ _inherit(A.NodeList, A._NodeList_JavaScriptObject_ListMixin_ImmutableListMixin);
+ _inherit(A._PluginArray_JavaScriptObject_ListMixin_ImmutableListMixin, A._PluginArray_JavaScriptObject_ListMixin);
+ _inherit(A.PluginArray, A._PluginArray_JavaScriptObject_ListMixin_ImmutableListMixin);
+ _inherit(A.RtcStatsReport, A._RtcStatsReport_JavaScriptObject_MapMixin);
+ _inherit(A._SourceBufferList_EventTarget_ListMixin_ImmutableListMixin, A._SourceBufferList_EventTarget_ListMixin);
+ _inherit(A.SourceBufferList, A._SourceBufferList_EventTarget_ListMixin_ImmutableListMixin);
+ _inherit(A._SpeechGrammarList_JavaScriptObject_ListMixin_ImmutableListMixin, A._SpeechGrammarList_JavaScriptObject_ListMixin);
+ _inherit(A.SpeechGrammarList, A._SpeechGrammarList_JavaScriptObject_ListMixin_ImmutableListMixin);
+ _inherit(A.Storage, A._Storage_JavaScriptObject_MapMixin);
+ _inherit(A._TextTrackCueList_JavaScriptObject_ListMixin_ImmutableListMixin, A._TextTrackCueList_JavaScriptObject_ListMixin);
+ _inherit(A.TextTrackCueList, A._TextTrackCueList_JavaScriptObject_ListMixin_ImmutableListMixin);
+ _inherit(A._TextTrackList_EventTarget_ListMixin_ImmutableListMixin, A._TextTrackList_EventTarget_ListMixin);
+ _inherit(A.TextTrackList, A._TextTrackList_EventTarget_ListMixin_ImmutableListMixin);
+ _inherit(A._TouchList_JavaScriptObject_ListMixin_ImmutableListMixin, A._TouchList_JavaScriptObject_ListMixin);
+ _inherit(A.TouchList, A._TouchList_JavaScriptObject_ListMixin_ImmutableListMixin);
+ _inherit(A.__CssRuleList_JavaScriptObject_ListMixin_ImmutableListMixin, A.__CssRuleList_JavaScriptObject_ListMixin);
+ _inherit(A._CssRuleList, A.__CssRuleList_JavaScriptObject_ListMixin_ImmutableListMixin);
+ _inherit(A._DomRect, A.DomRectReadOnly);
+ _inherit(A.__GamepadList_JavaScriptObject_ListMixin_ImmutableListMixin, A.__GamepadList_JavaScriptObject_ListMixin);
+ _inherit(A._GamepadList, A.__GamepadList_JavaScriptObject_ListMixin_ImmutableListMixin);
+ _inherit(A.__NamedNodeMap_JavaScriptObject_ListMixin_ImmutableListMixin, A.__NamedNodeMap_JavaScriptObject_ListMixin);
+ _inherit(A._NamedNodeMap, A.__NamedNodeMap_JavaScriptObject_ListMixin_ImmutableListMixin);
+ _inherit(A.__SpeechRecognitionResultList_JavaScriptObject_ListMixin_ImmutableListMixin, A.__SpeechRecognitionResultList_JavaScriptObject_ListMixin);
+ _inherit(A._SpeechRecognitionResultList, A.__SpeechRecognitionResultList_JavaScriptObject_ListMixin_ImmutableListMixin);
+ _inherit(A.__StyleSheetList_JavaScriptObject_ListMixin_ImmutableListMixin, A.__StyleSheetList_JavaScriptObject_ListMixin);
+ _inherit(A._StyleSheetList, A.__StyleSheetList_JavaScriptObject_ListMixin_ImmutableListMixin);
+ _inherit(A._LengthList_JavaScriptObject_ListMixin_ImmutableListMixin, A._LengthList_JavaScriptObject_ListMixin);
+ _inherit(A.LengthList, A._LengthList_JavaScriptObject_ListMixin_ImmutableListMixin);
+ _inherit(A._NumberList_JavaScriptObject_ListMixin_ImmutableListMixin, A._NumberList_JavaScriptObject_ListMixin);
+ _inherit(A.NumberList, A._NumberList_JavaScriptObject_ListMixin_ImmutableListMixin);
+ _inherit(A._StringList_JavaScriptObject_ListMixin_ImmutableListMixin, A._StringList_JavaScriptObject_ListMixin);
+ _inherit(A.StringList, A._StringList_JavaScriptObject_ListMixin_ImmutableListMixin);
+ _inherit(A._TransformList_JavaScriptObject_ListMixin_ImmutableListMixin, A._TransformList_JavaScriptObject_ListMixin);
+ _inherit(A.TransformList, A._TransformList_JavaScriptObject_ListMixin_ImmutableListMixin);
+ _inherit(A.AudioParamMap, A._AudioParamMap_JavaScriptObject_MapMixin);
+ _inherit(A.OfflineAudioContext, A.BaseAudioContext);
+ _inherit(A.InternalStyle, A.Style);
+ _inheritMany(A.InternalStyle, [A.PosixStyle, A.UrlStyle, A.WindowsStyle]);
+ _inheritMany(A.StreamChannelMixin, [A.GuaranteeChannel, A._MultiChannel, A.VirtualChannel]);
+ _mixin(A.UnmodifiableListBase, A.UnmodifiableListMixin);
+ _mixin(A.__CastListBase__CastIterableBase_ListMixin, A.ListBase);
+ _mixin(A._NativeTypedArrayOfDouble_NativeTypedArray_ListMixin, A.ListBase);
+ _mixin(A._NativeTypedArrayOfDouble_NativeTypedArray_ListMixin_FixedLengthListMixin, A.FixedLengthListMixin);
+ _mixin(A._NativeTypedArrayOfInt_NativeTypedArray_ListMixin, A.ListBase);
+ _mixin(A._NativeTypedArrayOfInt_NativeTypedArray_ListMixin_FixedLengthListMixin, A.FixedLengthListMixin);
+ _mixin(A._SyncStreamController, A._SyncStreamControllerDispatch);
+ _mixin(A._UnmodifiableMapView_MapView__UnmodifiableMapMixin, A._UnmodifiableMapMixin);
+ _mixin(A._CssStyleDeclaration_JavaScriptObject_CssStyleDeclarationBase, A.CssStyleDeclarationBase);
+ _mixin(A._DomRectList_JavaScriptObject_ListMixin, A.ListBase);
+ _mixin(A._DomRectList_JavaScriptObject_ListMixin_ImmutableListMixin, A.ImmutableListMixin);
+ _mixin(A._DomStringList_JavaScriptObject_ListMixin, A.ListBase);
+ _mixin(A._DomStringList_JavaScriptObject_ListMixin_ImmutableListMixin, A.ImmutableListMixin);
+ _mixin(A._FileList_JavaScriptObject_ListMixin, A.ListBase);
+ _mixin(A._FileList_JavaScriptObject_ListMixin_ImmutableListMixin, A.ImmutableListMixin);
+ _mixin(A._HtmlCollection_JavaScriptObject_ListMixin, A.ListBase);
+ _mixin(A._HtmlCollection_JavaScriptObject_ListMixin_ImmutableListMixin, A.ImmutableListMixin);
+ _mixin(A._MidiInputMap_JavaScriptObject_MapMixin, A.MapBase);
+ _mixin(A._MidiOutputMap_JavaScriptObject_MapMixin, A.MapBase);
+ _mixin(A._MimeTypeArray_JavaScriptObject_ListMixin, A.ListBase);
+ _mixin(A._MimeTypeArray_JavaScriptObject_ListMixin_ImmutableListMixin, A.ImmutableListMixin);
+ _mixin(A._NodeList_JavaScriptObject_ListMixin, A.ListBase);
+ _mixin(A._NodeList_JavaScriptObject_ListMixin_ImmutableListMixin, A.ImmutableListMixin);
+ _mixin(A._PluginArray_JavaScriptObject_ListMixin, A.ListBase);
+ _mixin(A._PluginArray_JavaScriptObject_ListMixin_ImmutableListMixin, A.ImmutableListMixin);
+ _mixin(A._RtcStatsReport_JavaScriptObject_MapMixin, A.MapBase);
+ _mixin(A._SourceBufferList_EventTarget_ListMixin, A.ListBase);
+ _mixin(A._SourceBufferList_EventTarget_ListMixin_ImmutableListMixin, A.ImmutableListMixin);
+ _mixin(A._SpeechGrammarList_JavaScriptObject_ListMixin, A.ListBase);
+ _mixin(A._SpeechGrammarList_JavaScriptObject_ListMixin_ImmutableListMixin, A.ImmutableListMixin);
+ _mixin(A._Storage_JavaScriptObject_MapMixin, A.MapBase);
+ _mixin(A._TextTrackCueList_JavaScriptObject_ListMixin, A.ListBase);
+ _mixin(A._TextTrackCueList_JavaScriptObject_ListMixin_ImmutableListMixin, A.ImmutableListMixin);
+ _mixin(A._TextTrackList_EventTarget_ListMixin, A.ListBase);
+ _mixin(A._TextTrackList_EventTarget_ListMixin_ImmutableListMixin, A.ImmutableListMixin);
+ _mixin(A._TouchList_JavaScriptObject_ListMixin, A.ListBase);
+ _mixin(A._TouchList_JavaScriptObject_ListMixin_ImmutableListMixin, A.ImmutableListMixin);
+ _mixin(A.__CssRuleList_JavaScriptObject_ListMixin, A.ListBase);
+ _mixin(A.__CssRuleList_JavaScriptObject_ListMixin_ImmutableListMixin, A.ImmutableListMixin);
+ _mixin(A.__GamepadList_JavaScriptObject_ListMixin, A.ListBase);
+ _mixin(A.__GamepadList_JavaScriptObject_ListMixin_ImmutableListMixin, A.ImmutableListMixin);
+ _mixin(A.__NamedNodeMap_JavaScriptObject_ListMixin, A.ListBase);
+ _mixin(A.__NamedNodeMap_JavaScriptObject_ListMixin_ImmutableListMixin, A.ImmutableListMixin);
+ _mixin(A.__SpeechRecognitionResultList_JavaScriptObject_ListMixin, A.ListBase);
+ _mixin(A.__SpeechRecognitionResultList_JavaScriptObject_ListMixin_ImmutableListMixin, A.ImmutableListMixin);
+ _mixin(A.__StyleSheetList_JavaScriptObject_ListMixin, A.ListBase);
+ _mixin(A.__StyleSheetList_JavaScriptObject_ListMixin_ImmutableListMixin, A.ImmutableListMixin);
+ _mixin(A._LengthList_JavaScriptObject_ListMixin, A.ListBase);
+ _mixin(A._LengthList_JavaScriptObject_ListMixin_ImmutableListMixin, A.ImmutableListMixin);
+ _mixin(A._NumberList_JavaScriptObject_ListMixin, A.ListBase);
+ _mixin(A._NumberList_JavaScriptObject_ListMixin_ImmutableListMixin, A.ImmutableListMixin);
+ _mixin(A._StringList_JavaScriptObject_ListMixin, A.ListBase);
+ _mixin(A._StringList_JavaScriptObject_ListMixin_ImmutableListMixin, A.ImmutableListMixin);
+ _mixin(A._TransformList_JavaScriptObject_ListMixin, A.ListBase);
+ _mixin(A._TransformList_JavaScriptObject_ListMixin_ImmutableListMixin, A.ImmutableListMixin);
+ _mixin(A._AudioParamMap_JavaScriptObject_MapMixin, A.MapBase);
+ })();
+ var init = {
+ typeUniverse: {eC: new Map(), tR: {}, eT: {}, tPV: {}, sEA: []},
+ mangledGlobalNames: {int: "int", double: "double", num: "num", String: "String", bool: "bool", Null: "Null", List: "List"},
+ mangledNames: {},
+ types: ["~()", "bool(String)", "@()", "Null()", "~(String,@)", "~(@)", "Frame()", "~(Object?)", "~(JavaScriptObject)", "Frame(String)", "Null(@)", "~(Object,StackTrace)", "~(Object[StackTrace?])", "~(~())", "Trace(String)", "@(@)", "~(Object?,Object?)", "String(String)", "~(Uint8List,String,int)", "Object?(Object?)", "int(Frame)", "String(Frame)", "Trace()", "bool(Frame)", "bool()", "~(String,int)", "Null(Object,StackTrace)", "~(String,String)", "_Future<@>(@)", "Future<@>(@)", "Null(~())", "String(String?)", "List<Frame>(Trace)", "int(Trace)", "~(Zone,ZoneDelegate,Zone,Object,StackTrace)", "String(Trace)", "@(@,String)", "@(String)", "Frame(String,String)", "~(Symbol0,@)", "Map<String,String>(Map<String,String>,String)", "0^(0^,0^)<num>", "~(List<@>)", "~([Object?])", "~(Timer)", "~(String,int?)", "int(int,int)", "~(Zone?,ZoneDelegate?,Zone,Object,StackTrace)", "0^(Zone?,ZoneDelegate?,Zone,0^())<Object?>", "0^(Zone?,ZoneDelegate?,Zone,0^(1^),1^)<Object?,Object?>", "0^(Zone?,ZoneDelegate?,Zone,0^(1^,2^),1^,2^)<Object?,Object?,Object?>", "0^()(Zone,ZoneDelegate,Zone,0^())<Object?>", "0^(1^)(Zone,ZoneDelegate,Zone,0^(1^))<Object?,Object?>", "0^(1^,2^)(Zone,ZoneDelegate,Zone,0^(1^,2^))<Object?,Object?,Object?>", "AsyncError?(Zone,ZoneDelegate,Zone,Object,StackTrace?)", "~(Zone?,ZoneDelegate?,Zone,~())", "Timer(Zone,ZoneDelegate,Zone,Duration,~())", "Timer(Zone,ZoneDelegate,Zone,Duration,~(Timer))", "~(Zone,ZoneDelegate,Zone,String)", "Zone(Zone?,ZoneDelegate?,Zone,ZoneSpecification?,Map<Object?,Object?>?)", "Future<Null>()", "Uint8List(@,@)", "Frame(Frame)"],
+ interceptorsByTag: null,
+ leafTags: null,
+ arrayRti: Symbol("$ti")
+ };
+ A._Universe_addRules(init.typeUniverse, JSON.parse('{"PlainJavaScriptObject":"LegacyJavaScriptObject","UnknownJavaScriptObject":"LegacyJavaScriptObject","JavaScriptFunction":"LegacyJavaScriptObject","AbortPaymentEvent":"JavaScriptObject","ExtendableEvent":"JavaScriptObject","Event":"JavaScriptObject","AudioContext":"BaseAudioContext","AbsoluteOrientationSensor":"EventTarget","OrientationSensor":"EventTarget","Sensor":"EventTarget","MathMLElement":"Element","AudioElement":"HtmlElement","MediaElement":"HtmlElement","HtmlDocument":"Node","Document":"Node","VttCue":"TextTrackCue","CDataSection":"CharacterData","Text":"CharacterData","HtmlFormControlsCollection":"HtmlCollection","CssCharsetRule":"CssRule","CssMatrixComponent":"CssTransformComponent","CssStyleSheet":"StyleSheet","CssurlImageValue":"CssStyleValue","CssImageValue":"CssStyleValue","CssResourceValue":"CssStyleValue","JSBool":{"bool":[],"TrustedGetRuntimeType":[]},"JSNull":{"Null":[],"TrustedGetRuntimeType":[]},"LegacyJavaScriptObject":{"JavaScriptObject":[]},"JSArray":{"List":["1"],"JavaScriptObject":[],"EfficientLengthIterable":["1"],"Iterable":["1"]},"JSUnmodifiableArray":{"JSArray":["1"],"List":["1"],"JavaScriptObject":[],"EfficientLengthIterable":["1"],"Iterable":["1"]},"ArrayIterator":{"Iterator":["1"]},"JSNumber":{"double":[],"num":[]},"JSInt":{"double":[],"int":[],"num":[],"TrustedGetRuntimeType":[]},"JSNumNotInt":{"double":[],"num":[],"TrustedGetRuntimeType":[]},"JSString":{"String":[],"Pattern":[],"TrustedGetRuntimeType":[]},"CastStream":{"Stream":["2"],"Stream.T":"2"},"CastStreamSubscription":{"StreamSubscription":["2"]},"_CastIterableBase":{"Iterable":["2"]},"CastIterator":{"Iterator":["2"]},"CastIterable":{"_CastIterableBase":["1","2"],"Iterable":["2"],"Iterable.E":"2"},"_EfficientLengthCastIterable":{"CastIterable":["1","2"],"_CastIterableBase":["1","2"],"EfficientLengthIterable":["2"],"Iterable":["2"],"Iterable.E":"2"},"_CastListBase":{"ListBase":["2"],"List":["2"],"_CastIterableBase":["1","2"],"EfficientLengthIterable":["2"],"Iterable":["2"]},"CastList":{"_CastListBase":["1","2"],"ListBase":["2"],"List":["2"],"_CastIterableBase":["1","2"],"EfficientLengthIterable":["2"],"Iterable":["2"],"ListBase.E":"2","Iterable.E":"2"},"LateError":{"Error":[]},"CodeUnits":{"ListBase":["int"],"UnmodifiableListMixin":["int"],"List":["int"],"EfficientLengthIterable":["int"],"Iterable":["int"],"ListBase.E":"int","UnmodifiableListMixin.E":"int"},"EfficientLengthIterable":{"Iterable":["1"]},"ListIterable":{"EfficientLengthIterable":["1"],"Iterable":["1"]},"SubListIterable":{"ListIterable":["1"],"EfficientLengthIterable":["1"],"Iterable":["1"],"ListIterable.E":"1","Iterable.E":"1"},"ListIterator":{"Iterator":["1"]},"MappedIterable":{"Iterable":["2"],"Iterable.E":"2"},"EfficientLengthMappedIterable":{"MappedIterable":["1","2"],"EfficientLengthIterable":["2"],"Iterable":["2"],"Iterable.E":"2"},"MappedIterator":{"Iterator":["2"]},"MappedListIterable":{"ListIterable":["2"],"EfficientLengthIterable":["2"],"Iterable":["2"],"ListIterable.E":"2","Iterable.E":"2"},"WhereIterable":{"Iterable":["1"],"Iterable.E":"1"},"WhereIterator":{"Iterator":["1"]},"ExpandIterable":{"Iterable":["2"],"Iterable.E":"2"},"ExpandIterator":{"Iterator":["2"]},"TakeIterable":{"Iterable":["1"],"Iterable.E":"1"},"EfficientLengthTakeIterable":{"TakeIterable":["1"],"EfficientLengthIterable":["1"],"Iterable":["1"],"Iterable.E":"1"},"TakeIterator":{"Iterator":["1"]},"SkipIterable":{"Iterable":["1"],"Iterable.E":"1"},"EfficientLengthSkipIterable":{"SkipIterable":["1"],"EfficientLengthIterable":["1"],"Iterable":["1"],"Iterable.E":"1"},"SkipIterator":{"Iterator":["1"]},"SkipWhileIterable":{"Iterable":["1"],"Iterable.E":"1"},"SkipWhileIterator":{"Iterator":["1"]},"EmptyIterable":{"EfficientLengthIterable":["1"],"Iterable":["1"],"Iterable.E":"1"},"EmptyIterator":{"Iterator":["1"]},"WhereTypeIterable":{"Iterable":["1"],"Iterable.E":"1"},"WhereTypeIterator":{"Iterator":["1"]},"UnmodifiableListBase":{"ListBase":["1"],"UnmodifiableListMixin":["1"],"List":["1"],"EfficientLengthIterable":["1"],"Iterable":["1"]},"ReversedListIterable":{"ListIterable":["1"],"EfficientLengthIterable":["1"],"Iterable":["1"],"ListIterable.E":"1","Iterable.E":"1"},"Symbol":{"Symbol0":[]},"ConstantMapView":{"UnmodifiableMapView":["1","2"],"_UnmodifiableMapView_MapView__UnmodifiableMapMixin":["1","2"],"MapView":["1","2"],"_UnmodifiableMapMixin":["1","2"],"Map":["1","2"]},"ConstantMap":{"Map":["1","2"]},"ConstantStringMap":{"ConstantMap":["1","2"],"Map":["1","2"]},"_KeysOrValues":{"Iterable":["1"],"Iterable.E":"1"},"_KeysOrValuesOrElementsIterator":{"Iterator":["1"]},"Instantiation":{"Closure":[],"Function":[]},"Instantiation1":{"Closure":[],"Function":[]},"JSInvocationMirror":{"Invocation":[]},"NullError":{"TypeError":[],"Error":[]},"JsNoSuchMethodError":{"Error":[]},"UnknownJsTypeError":{"Error":[]},"NullThrownFromJavaScriptException":{"Exception":[]},"_StackTrace":{"StackTrace":[]},"Closure":{"Function":[]},"Closure0Args":{"Closure":[],"Function":[]},"Closure2Args":{"Closure":[],"Function":[]},"TearOffClosure":{"Closure":[],"Function":[]},"StaticClosure":{"Closure":[],"Function":[]},"BoundClosure":{"Closure":[],"Function":[]},"_CyclicInitializationError":{"Error":[]},"RuntimeError":{"Error":[]},"_AssertionError":{"Error":[]},"JsLinkedHashMap":{"MapBase":["1","2"],"LinkedHashMap":["1","2"],"Map":["1","2"],"MapBase.K":"1","MapBase.V":"2"},"LinkedHashMapKeyIterable":{"EfficientLengthIterable":["1"],"Iterable":["1"],"Iterable.E":"1"},"LinkedHashMapKeyIterator":{"Iterator":["1"]},"JSSyntaxRegExp":{"RegExp":[],"Pattern":[]},"_MatchImplementation":{"RegExpMatch":[],"Match":[]},"_AllMatchesIterable":{"Iterable":["RegExpMatch"],"Iterable.E":"RegExpMatch"},"_AllMatchesIterator":{"Iterator":["RegExpMatch"]},"StringMatch":{"Match":[]},"_StringAllMatchesIterable":{"Iterable":["Match"],"Iterable.E":"Match"},"_StringAllMatchesIterator":{"Iterator":["Match"]},"NativeByteBuffer":{"JavaScriptObject":[],"ByteBuffer":[],"TrustedGetRuntimeType":[]},"NativeTypedData":{"JavaScriptObject":[]},"NativeByteData":{"JavaScriptObject":[],"ByteData":[],"TrustedGetRuntimeType":[]},"NativeTypedArray":{"JavaScriptIndexingBehavior":["1"],"JavaScriptObject":[]},"NativeTypedArrayOfDouble":{"ListBase":["double"],"List":["double"],"JavaScriptIndexingBehavior":["double"],"JavaScriptObject":[],"EfficientLengthIterable":["double"],"Iterable":["double"],"FixedLengthListMixin":["double"]},"NativeTypedArrayOfInt":{"ListBase":["int"],"List":["int"],"JavaScriptIndexingBehavior":["int"],"JavaScriptObject":[],"EfficientLengthIterable":["int"],"Iterable":["int"],"FixedLengthListMixin":["int"]},"NativeFloat32List":{"ListBase":["double"],"Float32List":[],"List":["double"],"JavaScriptIndexingBehavior":["double"],"JavaScriptObject":[],"EfficientLengthIterable":["double"],"Iterable":["double"],"FixedLengthListMixin":["double"],"TrustedGetRuntimeType":[],"ListBase.E":"double"},"NativeFloat64List":{"ListBase":["double"],"Float64List":[],"List":["double"],"JavaScriptIndexingBehavior":["double"],"JavaScriptObject":[],"EfficientLengthIterable":["double"],"Iterable":["double"],"FixedLengthListMixin":["double"],"TrustedGetRuntimeType":[],"ListBase.E":"double"},"NativeInt16List":{"ListBase":["int"],"Int16List":[],"List":["int"],"JavaScriptIndexingBehavior":["int"],"JavaScriptObject":[],"EfficientLengthIterable":["int"],"Iterable":["int"],"FixedLengthListMixin":["int"],"TrustedGetRuntimeType":[],"ListBase.E":"int"},"NativeInt32List":{"ListBase":["int"],"Int32List":[],"List":["int"],"JavaScriptIndexingBehavior":["int"],"JavaScriptObject":[],"EfficientLengthIterable":["int"],"Iterable":["int"],"FixedLengthListMixin":["int"],"TrustedGetRuntimeType":[],"ListBase.E":"int"},"NativeInt8List":{"ListBase":["int"],"Int8List":[],"List":["int"],"JavaScriptIndexingBehavior":["int"],"JavaScriptObject":[],"EfficientLengthIterable":["int"],"Iterable":["int"],"FixedLengthListMixin":["int"],"TrustedGetRuntimeType":[],"ListBase.E":"int"},"NativeUint16List":{"ListBase":["int"],"Uint16List":[],"List":["int"],"JavaScriptIndexingBehavior":["int"],"JavaScriptObject":[],"EfficientLengthIterable":["int"],"Iterable":["int"],"FixedLengthListMixin":["int"],"TrustedGetRuntimeType":[],"ListBase.E":"int"},"NativeUint32List":{"ListBase":["int"],"Uint32List":[],"List":["int"],"JavaScriptIndexingBehavior":["int"],"JavaScriptObject":[],"EfficientLengthIterable":["int"],"Iterable":["int"],"FixedLengthListMixin":["int"],"TrustedGetRuntimeType":[],"ListBase.E":"int"},"NativeUint8ClampedList":{"ListBase":["int"],"Uint8ClampedList":[],"List":["int"],"JavaScriptIndexingBehavior":["int"],"JavaScriptObject":[],"EfficientLengthIterable":["int"],"Iterable":["int"],"FixedLengthListMixin":["int"],"TrustedGetRuntimeType":[],"ListBase.E":"int"},"NativeUint8List":{"ListBase":["int"],"Uint8List":[],"List":["int"],"JavaScriptIndexingBehavior":["int"],"JavaScriptObject":[],"EfficientLengthIterable":["int"],"Iterable":["int"],"FixedLengthListMixin":["int"],"TrustedGetRuntimeType":[],"ListBase.E":"int"},"_Error":{"Error":[]},"_TypeError":{"TypeError":[],"Error":[]},"AsyncError":{"Error":[]},"_Future":{"Future":["1"]},"_TimerImpl":{"Timer":[]},"_Completer":{"Completer":["1"]},"_AsyncCompleter":{"_Completer":["1"],"Completer":["1"]},"_SyncCompleter":{"_Completer":["1"],"Completer":["1"]},"_StreamController":{"StreamController":["1"],"StreamSink":["1"],"StreamConsumer":["1"],"_StreamControllerLifecycle":["1"],"_EventDispatch":["1"]},"_SyncStreamController":{"_SyncStreamControllerDispatch":["1"],"_StreamController":["1"],"StreamController":["1"],"StreamSink":["1"],"StreamConsumer":["1"],"_StreamControllerLifecycle":["1"],"_EventDispatch":["1"]},"_ControllerStream":{"_StreamImpl":["1"],"Stream":["1"],"Stream.T":"1"},"_ControllerSubscription":{"_BufferingStreamSubscription":["1"],"StreamSubscription":["1"],"_EventDispatch":["1"],"_BufferingStreamSubscription.T":"1"},"_StreamSinkWrapper":{"StreamSink":["1"],"StreamConsumer":["1"]},"_BufferingStreamSubscription":{"StreamSubscription":["1"],"_EventDispatch":["1"],"_BufferingStreamSubscription.T":"1"},"_StreamImpl":{"Stream":["1"]},"_DelayedData":{"_DelayedEvent":["1"]},"_DelayedError":{"_DelayedEvent":["@"]},"_DelayedDone":{"_DelayedEvent":["@"]},"_DoneStreamSubscription":{"StreamSubscription":["1"]},"_EmptyStream":{"Stream":["1"],"Stream.T":"1"},"_ZoneSpecification":{"ZoneSpecification":[]},"_ZoneDelegate":{"ZoneDelegate":[]},"_Zone":{"Zone":[]},"_CustomZone":{"_Zone":[],"Zone":[]},"_RootZone":{"_Zone":[],"Zone":[]},"_HashMap":{"MapBase":["1","2"],"Map":["1","2"],"MapBase.K":"1","MapBase.V":"2"},"_IdentityHashMap":{"_HashMap":["1","2"],"MapBase":["1","2"],"Map":["1","2"],"MapBase.K":"1","MapBase.V":"2"},"_HashMapKeyIterable":{"EfficientLengthIterable":["1"],"Iterable":["1"],"Iterable.E":"1"},"_HashMapKeyIterator":{"Iterator":["1"]},"_LinkedHashSet":{"SetBase":["1"],"Set":["1"],"EfficientLengthIterable":["1"],"Iterable":["1"]},"_LinkedHashSetIterator":{"Iterator":["1"]},"ListBase":{"List":["1"],"EfficientLengthIterable":["1"],"Iterable":["1"]},"MapBase":{"Map":["1","2"]},"MapView":{"Map":["1","2"]},"UnmodifiableMapView":{"_UnmodifiableMapView_MapView__UnmodifiableMapMixin":["1","2"],"MapView":["1","2"],"_UnmodifiableMapMixin":["1","2"],"Map":["1","2"]},"SetBase":{"Set":["1"],"EfficientLengthIterable":["1"],"Iterable":["1"]},"_SetBase":{"SetBase":["1"],"Set":["1"],"EfficientLengthIterable":["1"],"Iterable":["1"]},"_JsonMap":{"MapBase":["String","@"],"Map":["String","@"],"MapBase.K":"String","MapBase.V":"@"},"_JsonMapKeyIterable":{"ListIterable":["String"],"EfficientLengthIterable":["String"],"Iterable":["String"],"ListIterable.E":"String","Iterable.E":"String"},"AsciiCodec":{"Codec":["String","List<int>"]},"_UnicodeSubsetEncoder":{"Converter":["String","List<int>"],"StreamTransformer":["String","List<int>"]},"AsciiEncoder":{"Converter":["String","List<int>"],"StreamTransformer":["String","List<int>"]},"Base64Codec":{"Codec":["List<int>","String"]},"Base64Encoder":{"Converter":["List<int>","String"],"StreamTransformer":["List<int>","String"]},"_FusedCodec":{"Codec":["1","3"]},"Converter":{"StreamTransformer":["1","2"]},"Encoding":{"Codec":["String","List<int>"]},"JsonUnsupportedObjectError":{"Error":[]},"JsonCyclicError":{"Error":[]},"JsonCodec":{"Codec":["Object?","String"]},"JsonEncoder":{"Converter":["Object?","String"],"StreamTransformer":["Object?","String"]},"JsonDecoder":{"Converter":["String","Object?"],"StreamTransformer":["String","Object?"]},"Utf8Codec":{"Codec":["String","List<int>"]},"Utf8Encoder":{"Converter":["String","List<int>"],"StreamTransformer":["String","List<int>"]},"Utf8Decoder":{"Converter":["List<int>","String"],"StreamTransformer":["List<int>","String"]},"double":{"num":[]},"int":{"num":[]},"List":{"EfficientLengthIterable":["1"],"Iterable":["1"]},"RegExpMatch":{"Match":[]},"String":{"Pattern":[]},"AssertionError":{"Error":[]},"TypeError":{"Error":[]},"ArgumentError":{"Error":[]},"RangeError":{"Error":[]},"IndexError":{"Error":[]},"NoSuchMethodError":{"Error":[]},"UnsupportedError":{"Error":[]},"UnimplementedError":{"Error":[]},"StateError":{"Error":[]},"ConcurrentModificationError":{"Error":[]},"OutOfMemoryError":{"Error":[]},"StackOverflowError":{"Error":[]},"_Exception":{"Exception":[]},"FormatException":{"Exception":[]},"_StringStackTrace":{"StackTrace":[]},"StringBuffer":{"StringSink":[]},"_Uri":{"Uri":[]},"_SimpleUri":{"Uri":[]},"_DataUri":{"Uri":[]},"CssRule":{"JavaScriptObject":[]},"File":{"JavaScriptObject":[]},"Gamepad":{"JavaScriptObject":[]},"MimeType":{"JavaScriptObject":[]},"Node":{"JavaScriptObject":[]},"Plugin":{"JavaScriptObject":[]},"SourceBuffer":{"JavaScriptObject":[]},"SpeechGrammar":{"JavaScriptObject":[]},"SpeechRecognitionResult":{"JavaScriptObject":[]},"StyleSheet":{"JavaScriptObject":[]},"TextTrack":{"JavaScriptObject":[]},"TextTrackCue":{"JavaScriptObject":[]},"Touch":{"JavaScriptObject":[]},"HtmlElement":{"Node":[],"JavaScriptObject":[]},"AccessibleNodeList":{"JavaScriptObject":[]},"AnchorElement":{"Node":[],"JavaScriptObject":[]},"AreaElement":{"Node":[],"JavaScriptObject":[]},"Blob":{"JavaScriptObject":[]},"CharacterData":{"Node":[],"JavaScriptObject":[]},"CssPerspective":{"JavaScriptObject":[]},"CssStyleDeclaration":{"JavaScriptObject":[]},"CssStyleValue":{"JavaScriptObject":[]},"CssTransformComponent":{"JavaScriptObject":[]},"CssTransformValue":{"JavaScriptObject":[]},"CssUnparsedValue":{"JavaScriptObject":[]},"DataTransferItemList":{"JavaScriptObject":[]},"DomException":{"JavaScriptObject":[]},"DomRectList":{"ListBase":["Rectangle<num>"],"ImmutableListMixin":["Rectangle<num>"],"List":["Rectangle<num>"],"JavaScriptIndexingBehavior":["Rectangle<num>"],"JavaScriptObject":[],"EfficientLengthIterable":["Rectangle<num>"],"Iterable":["Rectangle<num>"],"ImmutableListMixin.E":"Rectangle<num>","ListBase.E":"Rectangle<num>"},"DomRectReadOnly":{"JavaScriptObject":[],"Rectangle":["num"]},"DomStringList":{"ListBase":["String"],"ImmutableListMixin":["String"],"List":["String"],"JavaScriptIndexingBehavior":["String"],"JavaScriptObject":[],"EfficientLengthIterable":["String"],"Iterable":["String"],"ImmutableListMixin.E":"String","ListBase.E":"String"},"DomTokenList":{"JavaScriptObject":[]},"Element":{"Node":[],"JavaScriptObject":[]},"EventTarget":{"JavaScriptObject":[]},"FileList":{"ListBase":["File"],"ImmutableListMixin":["File"],"List":["File"],"JavaScriptIndexingBehavior":["File"],"JavaScriptObject":[],"EfficientLengthIterable":["File"],"Iterable":["File"],"ImmutableListMixin.E":"File","ListBase.E":"File"},"FileWriter":{"JavaScriptObject":[]},"FormElement":{"Node":[],"JavaScriptObject":[]},"History":{"JavaScriptObject":[]},"HtmlCollection":{"ListBase":["Node"],"ImmutableListMixin":["Node"],"List":["Node"],"JavaScriptIndexingBehavior":["Node"],"JavaScriptObject":[],"EfficientLengthIterable":["Node"],"Iterable":["Node"],"ImmutableListMixin.E":"Node","ListBase.E":"Node"},"Location":{"JavaScriptObject":[]},"MediaList":{"JavaScriptObject":[]},"MidiInputMap":{"JavaScriptObject":[],"MapBase":["String","@"],"Map":["String","@"],"MapBase.K":"String","MapBase.V":"@"},"MidiOutputMap":{"JavaScriptObject":[],"MapBase":["String","@"],"Map":["String","@"],"MapBase.K":"String","MapBase.V":"@"},"MimeTypeArray":{"ListBase":["MimeType"],"ImmutableListMixin":["MimeType"],"List":["MimeType"],"JavaScriptIndexingBehavior":["MimeType"],"JavaScriptObject":[],"EfficientLengthIterable":["MimeType"],"Iterable":["MimeType"],"ImmutableListMixin.E":"MimeType","ListBase.E":"MimeType"},"NodeList":{"ListBase":["Node"],"ImmutableListMixin":["Node"],"List":["Node"],"JavaScriptIndexingBehavior":["Node"],"JavaScriptObject":[],"EfficientLengthIterable":["Node"],"Iterable":["Node"],"ImmutableListMixin.E":"Node","ListBase.E":"Node"},"PluginArray":{"ListBase":["Plugin"],"ImmutableListMixin":["Plugin"],"List":["Plugin"],"JavaScriptIndexingBehavior":["Plugin"],"JavaScriptObject":[],"EfficientLengthIterable":["Plugin"],"Iterable":["Plugin"],"ImmutableListMixin.E":"Plugin","ListBase.E":"Plugin"},"RtcStatsReport":{"JavaScriptObject":[],"MapBase":["String","@"],"Map":["String","@"],"MapBase.K":"String","MapBase.V":"@"},"SelectElement":{"Node":[],"JavaScriptObject":[]},"SourceBufferList":{"ListBase":["SourceBuffer"],"ImmutableListMixin":["SourceBuffer"],"List":["SourceBuffer"],"JavaScriptIndexingBehavior":["SourceBuffer"],"JavaScriptObject":[],"EfficientLengthIterable":["SourceBuffer"],"Iterable":["SourceBuffer"],"ImmutableListMixin.E":"SourceBuffer","ListBase.E":"SourceBuffer"},"SpeechGrammarList":{"ListBase":["SpeechGrammar"],"ImmutableListMixin":["SpeechGrammar"],"List":["SpeechGrammar"],"JavaScriptIndexingBehavior":["SpeechGrammar"],"JavaScriptObject":[],"EfficientLengthIterable":["SpeechGrammar"],"Iterable":["SpeechGrammar"],"ImmutableListMixin.E":"SpeechGrammar","ListBase.E":"SpeechGrammar"},"Storage":{"JavaScriptObject":[],"MapBase":["String","String"],"Map":["String","String"],"MapBase.K":"String","MapBase.V":"String"},"TextTrackCueList":{"ListBase":["TextTrackCue"],"ImmutableListMixin":["TextTrackCue"],"List":["TextTrackCue"],"JavaScriptIndexingBehavior":["TextTrackCue"],"JavaScriptObject":[],"EfficientLengthIterable":["TextTrackCue"],"Iterable":["TextTrackCue"],"ImmutableListMixin.E":"TextTrackCue","ListBase.E":"TextTrackCue"},"TextTrackList":{"ListBase":["TextTrack"],"ImmutableListMixin":["TextTrack"],"List":["TextTrack"],"JavaScriptIndexingBehavior":["TextTrack"],"JavaScriptObject":[],"EfficientLengthIterable":["TextTrack"],"Iterable":["TextTrack"],"ImmutableListMixin.E":"TextTrack","ListBase.E":"TextTrack"},"TimeRanges":{"JavaScriptObject":[]},"TouchList":{"ListBase":["Touch"],"ImmutableListMixin":["Touch"],"List":["Touch"],"JavaScriptIndexingBehavior":["Touch"],"JavaScriptObject":[],"EfficientLengthIterable":["Touch"],"Iterable":["Touch"],"ImmutableListMixin.E":"Touch","ListBase.E":"Touch"},"TrackDefaultList":{"JavaScriptObject":[]},"Url":{"JavaScriptObject":[]},"VideoTrackList":{"JavaScriptObject":[]},"_CssRuleList":{"ListBase":["CssRule"],"ImmutableListMixin":["CssRule"],"List":["CssRule"],"JavaScriptIndexingBehavior":["CssRule"],"JavaScriptObject":[],"EfficientLengthIterable":["CssRule"],"Iterable":["CssRule"],"ImmutableListMixin.E":"CssRule","ListBase.E":"CssRule"},"_DomRect":{"JavaScriptObject":[],"Rectangle":["num"]},"_GamepadList":{"ListBase":["Gamepad?"],"ImmutableListMixin":["Gamepad?"],"List":["Gamepad?"],"JavaScriptIndexingBehavior":["Gamepad?"],"JavaScriptObject":[],"EfficientLengthIterable":["Gamepad?"],"Iterable":["Gamepad?"],"ImmutableListMixin.E":"Gamepad?","ListBase.E":"Gamepad?"},"_NamedNodeMap":{"ListBase":["Node"],"ImmutableListMixin":["Node"],"List":["Node"],"JavaScriptIndexingBehavior":["Node"],"JavaScriptObject":[],"EfficientLengthIterable":["Node"],"Iterable":["Node"],"ImmutableListMixin.E":"Node","ListBase.E":"Node"},"_SpeechRecognitionResultList":{"ListBase":["SpeechRecognitionResult"],"ImmutableListMixin":["SpeechRecognitionResult"],"List":["SpeechRecognitionResult"],"JavaScriptIndexingBehavior":["SpeechRecognitionResult"],"JavaScriptObject":[],"EfficientLengthIterable":["SpeechRecognitionResult"],"Iterable":["SpeechRecognitionResult"],"ImmutableListMixin.E":"SpeechRecognitionResult","ListBase.E":"SpeechRecognitionResult"},"_StyleSheetList":{"ListBase":["StyleSheet"],"ImmutableListMixin":["StyleSheet"],"List":["StyleSheet"],"JavaScriptIndexingBehavior":["StyleSheet"],"JavaScriptObject":[],"EfficientLengthIterable":["StyleSheet"],"Iterable":["StyleSheet"],"ImmutableListMixin.E":"StyleSheet","ListBase.E":"StyleSheet"},"FixedSizeListIterator":{"Iterator":["1"]},"NullRejectionException":{"Exception":[]},"Length":{"JavaScriptObject":[]},"Number":{"JavaScriptObject":[]},"Transform":{"JavaScriptObject":[]},"LengthList":{"ListBase":["Length"],"ImmutableListMixin":["Length"],"List":["Length"],"JavaScriptObject":[],"EfficientLengthIterable":["Length"],"Iterable":["Length"],"ImmutableListMixin.E":"Length","ListBase.E":"Length"},"NumberList":{"ListBase":["Number"],"ImmutableListMixin":["Number"],"List":["Number"],"JavaScriptObject":[],"EfficientLengthIterable":["Number"],"Iterable":["Number"],"ImmutableListMixin.E":"Number","ListBase.E":"Number"},"PointList":{"JavaScriptObject":[]},"StringList":{"ListBase":["String"],"ImmutableListMixin":["String"],"List":["String"],"JavaScriptObject":[],"EfficientLengthIterable":["String"],"Iterable":["String"],"ImmutableListMixin.E":"String","ListBase.E":"String"},"TransformList":{"ListBase":["Transform"],"ImmutableListMixin":["Transform"],"List":["Transform"],"JavaScriptObject":[],"EfficientLengthIterable":["Transform"],"Iterable":["Transform"],"ImmutableListMixin.E":"Transform","ListBase.E":"Transform"},"AudioBuffer":{"JavaScriptObject":[]},"AudioParamMap":{"JavaScriptObject":[],"MapBase":["String","@"],"Map":["String","@"],"MapBase.K":"String","MapBase.V":"@"},"AudioTrackList":{"JavaScriptObject":[]},"BaseAudioContext":{"JavaScriptObject":[]},"OfflineAudioContext":{"JavaScriptObject":[]},"NullStreamSink":{"StreamSink":["1"],"StreamConsumer":["1"]},"PathException":{"Exception":[]},"PosixStyle":{"InternalStyle":[]},"UrlStyle":{"InternalStyle":[]},"WindowsStyle":{"InternalStyle":[]},"Chain":{"StackTrace":[]},"LazyTrace":{"Trace":[],"StackTrace":[]},"Trace":{"StackTrace":[]},"UnparsedFrame":{"Frame":[]},"GuaranteeChannel":{"StreamChannelMixin":["1"],"StreamChannel":["1"]},"_GuaranteeSink":{"StreamSink":["1"],"StreamConsumer":["1"]},"_MultiChannel":{"StreamChannelMixin":["1"],"MultiChannel":["1"],"StreamChannel":["1"]},"VirtualChannel":{"StreamChannelMixin":["1"],"MultiChannel":["1"],"StreamChannel":["1"]},"StreamChannelMixin":{"StreamChannel":["1"]},"Int8List":{"List":["int"],"EfficientLengthIterable":["int"],"Iterable":["int"]},"Uint8List":{"List":["int"],"EfficientLengthIterable":["int"],"Iterable":["int"]},"Uint8ClampedList":{"List":["int"],"EfficientLengthIterable":["int"],"Iterable":["int"]},"Int16List":{"List":["int"],"EfficientLengthIterable":["int"],"Iterable":["int"]},"Uint16List":{"List":["int"],"EfficientLengthIterable":["int"],"Iterable":["int"]},"Int32List":{"List":["int"],"EfficientLengthIterable":["int"],"Iterable":["int"]},"Uint32List":{"List":["int"],"EfficientLengthIterable":["int"],"Iterable":["int"]},"Float32List":{"List":["double"],"EfficientLengthIterable":["double"],"Iterable":["double"]},"Float64List":{"List":["double"],"EfficientLengthIterable":["double"],"Iterable":["double"]}}'));
+ A._Universe_addErasedTypes(init.typeUniverse, JSON.parse('{"UnmodifiableListBase":1,"__CastListBase__CastIterableBase_ListMixin":2,"NativeTypedArray":1,"_DelayedEvent":1,"_SetBase":1}'));
+ var string$ = {
+ x27_has_: "' has been assigned during initialization.",
+ x3d_____: "===== asynchronous gap ===========================\n",
+ Cannotff: "Cannot extract a file path from a URI with a fragment component",
+ Cannotfq: "Cannot extract a file path from a URI with a query component",
+ Cannotn: "Cannot extract a non-Windows file path from a file URI with an authority",
+ Error_: "Error handler must accept one Object or one Object and a StackTrace as arguments, and return a value of the returned future's type",
+ handle: "handleError callback must take either an Object (the error), or both an Object (the error) and a StackTrace."
+ };
+ var type$ = (function rtii() {
+ var findType = A.findType;
+ return {
+ AsyncError: findType("AsyncError"),
+ ByteBuffer: findType("ByteBuffer"),
+ ByteData: findType("ByteData"),
+ ConstantMapView_Symbol_dynamic: findType("ConstantMapView<Symbol0,@>"),
+ CssRule: findType("CssRule"),
+ Duration: findType("Duration"),
+ EfficientLengthIterable_dynamic: findType("EfficientLengthIterable<@>"),
+ Error: findType("Error"),
+ Exception: findType("Exception"),
+ File: findType("File"),
+ Float32List: findType("Float32List"),
+ Float64List: findType("Float64List"),
+ Frame: findType("Frame"),
+ Frame_Function_Frame: findType("Frame(Frame)"),
+ Frame_Function_String: findType("Frame(String)"),
+ Function: findType("Function"),
+ Future_dynamic: findType("Future<@>"),
+ Int16List: findType("Int16List"),
+ Int32List: findType("Int32List"),
+ Int8List: findType("Int8List"),
+ Invocation: findType("Invocation"),
+ Iterable_String: findType("Iterable<String>"),
+ Iterable_dynamic: findType("Iterable<@>"),
+ Iterable_nullable_Object: findType("Iterable<Object?>"),
+ JSArray_Frame: findType("JSArray<Frame>"),
+ JSArray_Object: findType("JSArray<Object>"),
+ JSArray_String: findType("JSArray<String>"),
+ JSArray_Trace: findType("JSArray<Trace>"),
+ JSArray_Uint8List: findType("JSArray<Uint8List>"),
+ JSArray_dynamic: findType("JSArray<@>"),
+ JSArray_int: findType("JSArray<int>"),
+ JSArray_nullable_String: findType("JSArray<String?>"),
+ JSNull: findType("JSNull"),
+ JavaScriptFunction: findType("JavaScriptFunction"),
+ JavaScriptIndexingBehavior_dynamic: findType("JavaScriptIndexingBehavior<@>"),
+ JavaScriptObject: findType("JavaScriptObject"),
+ JsLinkedHashMap_Symbol_dynamic: findType("JsLinkedHashMap<Symbol0,@>"),
+ Length: findType("Length"),
+ List_String: findType("List<String>"),
+ List_dynamic: findType("List<@>"),
+ List_int: findType("List<int>"),
+ Map_String_String: findType("Map<String,String>"),
+ Map_dynamic_dynamic: findType("Map<@,@>"),
+ Map_of_nullable_Object_and_nullable_Object: findType("Map<Object?,Object?>"),
+ MappedIterable_String_Frame: findType("MappedIterable<String,Frame>"),
+ MappedListIterable_Frame_Frame: findType("MappedListIterable<Frame,Frame>"),
+ MappedListIterable_String_Trace: findType("MappedListIterable<String,Trace>"),
+ MappedListIterable_String_dynamic: findType("MappedListIterable<String,@>"),
+ MimeType: findType("MimeType"),
+ NativeUint8List: findType("NativeUint8List"),
+ Node: findType("Node"),
+ Null: findType("Null"),
+ Number: findType("Number"),
+ Object: findType("Object"),
+ Plugin: findType("Plugin"),
+ Record: findType("Record"),
+ Rectangle_num: findType("Rectangle<num>"),
+ RegExpMatch: findType("RegExpMatch"),
+ SourceBuffer: findType("SourceBuffer"),
+ SpeechGrammar: findType("SpeechGrammar"),
+ SpeechRecognitionResult: findType("SpeechRecognitionResult"),
+ StackTrace: findType("StackTrace"),
+ String: findType("String"),
+ StyleSheet: findType("StyleSheet"),
+ Symbol: findType("Symbol0"),
+ TextTrack: findType("TextTrack"),
+ TextTrackCue: findType("TextTrackCue"),
+ Timer: findType("Timer"),
+ Touch: findType("Touch"),
+ Trace: findType("Trace"),
+ Trace_Function_String: findType("Trace(String)"),
+ Transform: findType("Transform"),
+ TrustedGetRuntimeType: findType("TrustedGetRuntimeType"),
+ TypeError: findType("TypeError"),
+ Uint16List: findType("Uint16List"),
+ Uint32List: findType("Uint32List"),
+ Uint8ClampedList: findType("Uint8ClampedList"),
+ Uint8List: findType("Uint8List"),
+ UnknownJavaScriptObject: findType("UnknownJavaScriptObject"),
+ UnmodifiableMapView_String_String: findType("UnmodifiableMapView<String,String>"),
+ Uri: findType("Uri"),
+ WhereIterable_String: findType("WhereIterable<String>"),
+ WhereTypeIterable_String: findType("WhereTypeIterable<String>"),
+ Zone: findType("Zone"),
+ _AsyncCompleter_dynamic: findType("_AsyncCompleter<@>"),
+ _Future_dynamic: findType("_Future<@>"),
+ _Future_int: findType("_Future<int>"),
+ _Future_void: findType("_Future<~>"),
+ _IdentityHashMap_of_nullable_Object_and_nullable_Object: findType("_IdentityHashMap<Object?,Object?>"),
+ _StreamControllerAddStreamState_nullable_Object: findType("_StreamControllerAddStreamState<Object?>"),
+ _SyncCompleter_dynamic: findType("_SyncCompleter<@>"),
+ _ZoneFunction_of_void_Function_Zone_ZoneDelegate_Zone_Object_StackTrace: findType("_ZoneFunction<~(Zone,ZoneDelegate,Zone,Object,StackTrace)>"),
+ bool: findType("bool"),
+ bool_Function_Frame: findType("bool(Frame)"),
+ bool_Function_Object: findType("bool(Object)"),
+ bool_Function_String: findType("bool(String)"),
+ double: findType("double"),
+ dynamic: findType("@"),
+ dynamic_Function: findType("@()"),
+ dynamic_Function_Object: findType("@(Object)"),
+ dynamic_Function_Object_StackTrace: findType("@(Object,StackTrace)"),
+ dynamic_Function_String: findType("@(String)"),
+ int: findType("int"),
+ legacy_Never: findType("0&*"),
+ legacy_Object: findType("Object*"),
+ nullable_Future_Null: findType("Future<Null>?"),
+ nullable_Gamepad: findType("Gamepad?"),
+ nullable_JavaScriptObject: findType("JavaScriptObject?"),
+ nullable_List_dynamic: findType("List<@>?"),
+ nullable_Map_of_nullable_Object_and_nullable_Object: findType("Map<Object?,Object?>?"),
+ nullable_Object: findType("Object?"),
+ nullable_StackTrace: findType("StackTrace?"),
+ nullable_Zone: findType("Zone?"),
+ nullable_ZoneDelegate: findType("ZoneDelegate?"),
+ nullable_ZoneSpecification: findType("ZoneSpecification?"),
+ nullable__DelayedEvent_dynamic: findType("_DelayedEvent<@>?"),
+ nullable__FutureListener_dynamic_dynamic: findType("_FutureListener<@,@>?"),
+ nullable__LinkedHashSetCell: findType("_LinkedHashSetCell?"),
+ nullable_void_Function: findType("~()?"),
+ num: findType("num"),
+ void: findType("~"),
+ void_Function: findType("~()"),
+ void_Function_$opt_dynamic: findType("~([@])"),
+ void_Function_JavaScriptObject: findType("~(JavaScriptObject)"),
+ void_Function_Object: findType("~(Object)"),
+ void_Function_Object_StackTrace: findType("~(Object,StackTrace)"),
+ void_Function_String_String: findType("~(String,String)"),
+ void_Function_String_dynamic: findType("~(String,@)"),
+ void_Function_Timer: findType("~(Timer)")
+ };
+ })();
+ (function constants() {
+ var makeConstList = hunkHelpers.makeConstList;
+ B.Interceptor_methods = J.Interceptor.prototype;
+ B.JSArray_methods = J.JSArray.prototype;
+ B.JSInt_methods = J.JSInt.prototype;
+ B.JSNumber_methods = J.JSNumber.prototype;
+ B.JSString_methods = J.JSString.prototype;
+ B.JavaScriptFunction_methods = J.JavaScriptFunction.prototype;
+ B.JavaScriptObject_methods = J.JavaScriptObject.prototype;
+ B.NativeUint8List_methods = A.NativeUint8List.prototype;
+ B.PlainJavaScriptObject_methods = J.PlainJavaScriptObject.prototype;
+ B.UnknownJavaScriptObject_methods = J.UnknownJavaScriptObject.prototype;
+ B.AsciiEncoder_127 = new A.AsciiEncoder(127);
+ B.CONSTANT = new A.Instantiation1(A.math__max$closure(), A.findType("Instantiation1<int>"));
+ B.C_AsciiCodec = new A.AsciiCodec();
+ B.C_Base64Encoder = new A.Base64Encoder();
+ B.C_Base64Codec = new A.Base64Codec();
+ B.C_EmptyIterator = new A.EmptyIterator(A.findType("EmptyIterator<0&>"));
+ B.C_JS_CONST = function getTagFallback(o) {
+ var s = Object.prototype.toString.call(o);
+ return s.substring(8, s.length - 1);
+};
+ B.C_JS_CONST0 = function() {
+ var toStringFunction = Object.prototype.toString;
+ function getTag(o) {
+ var s = toStringFunction.call(o);
+ return s.substring(8, s.length - 1);
+ }
+ function getUnknownTag(object, tag) {
+ if (/^HTML[A-Z].*Element$/.test(tag)) {
+ var name = toStringFunction.call(object);
+ if (name == "[object Object]") return null;
+ return "HTMLElement";
+ }
+ }
+ function getUnknownTagGenericBrowser(object, tag) {
+ if (self.HTMLElement && object instanceof HTMLElement) return "HTMLElement";
+ return getUnknownTag(object, tag);
+ }
+ function prototypeForTag(tag) {
+ if (typeof window == "undefined") return null;
+ if (typeof window[tag] == "undefined") return null;
+ var constructor = window[tag];
+ if (typeof constructor != "function") return null;
+ return constructor.prototype;
+ }
+ function discriminator(tag) { return null; }
+ var isBrowser = typeof navigator == "object";
+ return {
+ getTag: getTag,
+ getUnknownTag: isBrowser ? getUnknownTagGenericBrowser : getUnknownTag,
+ prototypeForTag: prototypeForTag,
+ discriminator: discriminator };
+};
+ B.C_JS_CONST6 = function(getTagFallback) {
+ return function(hooks) {
+ if (typeof navigator != "object") return hooks;
+ var ua = navigator.userAgent;
+ if (ua.indexOf("DumpRenderTree") >= 0) return hooks;
+ if (ua.indexOf("Chrome") >= 0) {
+ function confirm(p) {
+ return typeof window == "object" && window[p] && window[p].name == p;
+ }
+ if (confirm("Window") && confirm("HTMLElement")) return hooks;
+ }
+ hooks.getTag = getTagFallback;
+ };
+};
+ B.C_JS_CONST1 = function(hooks) {
+ if (typeof dartExperimentalFixupGetTag != "function") return hooks;
+ hooks.getTag = dartExperimentalFixupGetTag(hooks.getTag);
+};
+ B.C_JS_CONST2 = function(hooks) {
+ var getTag = hooks.getTag;
+ var prototypeForTag = hooks.prototypeForTag;
+ function getTagFixed(o) {
+ var tag = getTag(o);
+ if (tag == "Document") {
+ if (!!o.xmlVersion) return "!Document";
+ return "!HTMLDocument";
+ }
+ return tag;
+ }
+ function prototypeForTagFixed(tag) {
+ if (tag == "Document") return null;
+ return prototypeForTag(tag);
+ }
+ hooks.getTag = getTagFixed;
+ hooks.prototypeForTag = prototypeForTagFixed;
+};
+ B.C_JS_CONST5 = function(hooks) {
+ var userAgent = typeof navigator == "object" ? navigator.userAgent : "";
+ if (userAgent.indexOf("Firefox") == -1) return hooks;
+ var getTag = hooks.getTag;
+ var quickMap = {
+ "BeforeUnloadEvent": "Event",
+ "DataTransfer": "Clipboard",
+ "GeoGeolocation": "Geolocation",
+ "Location": "!Location",
+ "WorkerMessageEvent": "MessageEvent",
+ "XMLDocument": "!Document"};
+ function getTagFirefox(o) {
+ var tag = getTag(o);
+ return quickMap[tag] || tag;
+ }
+ hooks.getTag = getTagFirefox;
+};
+ B.C_JS_CONST4 = function(hooks) {
+ var userAgent = typeof navigator == "object" ? navigator.userAgent : "";
+ if (userAgent.indexOf("Trident/") == -1) return hooks;
+ var getTag = hooks.getTag;
+ var quickMap = {
+ "BeforeUnloadEvent": "Event",
+ "DataTransfer": "Clipboard",
+ "HTMLDDElement": "HTMLElement",
+ "HTMLDTElement": "HTMLElement",
+ "HTMLPhraseElement": "HTMLElement",
+ "Position": "Geoposition"
+ };
+ function getTagIE(o) {
+ var tag = getTag(o);
+ var newTag = quickMap[tag];
+ if (newTag) return newTag;
+ if (tag == "Object") {
+ if (window.DataView && (o instanceof window.DataView)) return "DataView";
+ }
+ return tag;
+ }
+ function prototypeForTagIE(tag) {
+ var constructor = window[tag];
+ if (constructor == null) return null;
+ return constructor.prototype;
+ }
+ hooks.getTag = getTagIE;
+ hooks.prototypeForTag = prototypeForTagIE;
+};
+ B.C_JS_CONST3 = function(hooks) { return hooks; }
+;
+ B.C_JsonCodec = new A.JsonCodec();
+ B.C_OutOfMemoryError = new A.OutOfMemoryError();
+ B.C_SentinelValue = new A.SentinelValue();
+ B.C_Utf8Codec = new A.Utf8Codec();
+ B.C_Utf8Encoder = new A.Utf8Encoder();
+ B.C__DelayedDone = new A._DelayedDone();
+ B.C__Required = new A._Required();
+ B.C__RootZone = new A._RootZone();
+ B.Duration_0 = new A.Duration(0);
+ B.JsonDecoder_null = new A.JsonDecoder(null);
+ B.JsonEncoder_null = new A.JsonEncoder(null);
+ B.List_M1A = A._setArrayType(makeConstList([0, 0, 24576, 1023, 65534, 34815, 65534, 18431]), type$.JSArray_int);
+ B.List_MMm = A._setArrayType(makeConstList([0, 0, 26624, 1023, 65534, 2047, 65534, 2047]), type$.JSArray_int);
+ B.List_OL3 = A._setArrayType(makeConstList([0, 0, 32722, 12287, 65534, 34815, 65534, 18431]), type$.JSArray_int);
+ B.List_XRg0 = A._setArrayType(makeConstList([0, 0, 32722, 12287, 65535, 34815, 65534, 18431]), type$.JSArray_int);
+ B.List_XRg = A._setArrayType(makeConstList([0, 0, 65490, 12287, 65535, 34815, 65534, 18431]), type$.JSArray_int);
+ B.List_YmH = A._setArrayType(makeConstList([0, 0, 32776, 33792, 1, 10240, 0, 0]), type$.JSArray_int);
+ B.List_ejq = A._setArrayType(makeConstList([0, 0, 32754, 11263, 65534, 34815, 65534, 18431]), type$.JSArray_int);
+ B.List_empty = A._setArrayType(makeConstList([]), type$.JSArray_String);
+ B.List_empty0 = A._setArrayType(makeConstList([]), type$.JSArray_dynamic);
+ B.List_oFp = A._setArrayType(makeConstList([0, 0, 65490, 45055, 65535, 34815, 65534, 18431]), type$.JSArray_int);
+ B.List_yzX = A._setArrayType(makeConstList([0, 0, 27858, 1023, 65534, 51199, 65535, 32767]), type$.JSArray_int);
+ B.Object_empty = {};
+ B.Map_empty = new A.ConstantStringMap(B.Object_empty, [], A.findType("ConstantStringMap<String,String>"));
+ B.Map_empty0 = new A.ConstantStringMap(B.Object_empty, [], A.findType("ConstantStringMap<Symbol0,@>"));
+ B.Symbol_call = new A.Symbol("call");
+ B.Type_ByteBuffer_RkP = A.typeLiteral("ByteBuffer");
+ B.Type_ByteData_zNC = A.typeLiteral("ByteData");
+ B.Type_Float32List_LB7 = A.typeLiteral("Float32List");
+ B.Type_Float64List_LB7 = A.typeLiteral("Float64List");
+ B.Type_Int16List_uXf = A.typeLiteral("Int16List");
+ B.Type_Int32List_O50 = A.typeLiteral("Int32List");
+ B.Type_Int8List_ekJ = A.typeLiteral("Int8List");
+ B.Type_Object_xQ6 = A.typeLiteral("Object");
+ B.Type_Uint16List_2bx = A.typeLiteral("Uint16List");
+ B.Type_Uint32List_2bx = A.typeLiteral("Uint32List");
+ B.Type_Uint8ClampedList_Jik = A.typeLiteral("Uint8ClampedList");
+ B.Type_Uint8List_WLA = A.typeLiteral("Uint8List");
+ B.Utf8Decoder_false = new A.Utf8Decoder(false);
+ B._StringStackTrace_3uE = new A._StringStackTrace("");
+ B._ZoneFunction_3bB = new A._ZoneFunction(B.C__RootZone, A.async___rootCreatePeriodicTimer$closure(), A.findType("_ZoneFunction<Timer(Zone,ZoneDelegate,Zone,Duration,~(Timer))>"));
+ B._ZoneFunction_7G2 = new A._ZoneFunction(B.C__RootZone, A.async___rootRegisterBinaryCallback$closure(), A.findType("_ZoneFunction<0^(1^,2^)(Zone,ZoneDelegate,Zone,0^(1^,2^))<Object?,Object?,Object?>>"));
+ B._ZoneFunction_Eeh = new A._ZoneFunction(B.C__RootZone, A.async___rootRegisterUnaryCallback$closure(), A.findType("_ZoneFunction<0^(1^)(Zone,ZoneDelegate,Zone,0^(1^))<Object?,Object?>>"));
+ B._ZoneFunction_NMc = new A._ZoneFunction(B.C__RootZone, A.async___rootHandleUncaughtError$closure(), type$._ZoneFunction_of_void_Function_Zone_ZoneDelegate_Zone_Object_StackTrace);
+ B._ZoneFunction__RootZone__rootCreateTimer = new A._ZoneFunction(B.C__RootZone, A.async___rootCreateTimer$closure(), A.findType("_ZoneFunction<Timer(Zone,ZoneDelegate,Zone,Duration,~())>"));
+ B._ZoneFunction__RootZone__rootErrorCallback = new A._ZoneFunction(B.C__RootZone, A.async___rootErrorCallback$closure(), A.findType("_ZoneFunction<AsyncError?(Zone,ZoneDelegate,Zone,Object,StackTrace?)>"));
+ B._ZoneFunction__RootZone__rootFork = new A._ZoneFunction(B.C__RootZone, A.async___rootFork$closure(), A.findType("_ZoneFunction<Zone(Zone,ZoneDelegate,Zone,ZoneSpecification?,Map<Object?,Object?>?)>"));
+ B._ZoneFunction__RootZone__rootPrint = new A._ZoneFunction(B.C__RootZone, A.async___rootPrint$closure(), A.findType("_ZoneFunction<~(Zone,ZoneDelegate,Zone,String)>"));
+ B._ZoneFunction__RootZone__rootRegisterCallback = new A._ZoneFunction(B.C__RootZone, A.async___rootRegisterCallback$closure(), A.findType("_ZoneFunction<0^()(Zone,ZoneDelegate,Zone,0^())<Object?>>"));
+ B._ZoneFunction__RootZone__rootRun = new A._ZoneFunction(B.C__RootZone, A.async___rootRun$closure(), A.findType("_ZoneFunction<0^(Zone,ZoneDelegate,Zone,0^())<Object?>>"));
+ B._ZoneFunction__RootZone__rootRunBinary = new A._ZoneFunction(B.C__RootZone, A.async___rootRunBinary$closure(), A.findType("_ZoneFunction<0^(Zone,ZoneDelegate,Zone,0^(1^,2^),1^,2^)<Object?,Object?,Object?>>"));
+ B._ZoneFunction__RootZone__rootRunUnary = new A._ZoneFunction(B.C__RootZone, A.async___rootRunUnary$closure(), A.findType("_ZoneFunction<0^(Zone,ZoneDelegate,Zone,0^(1^),1^)<Object?,Object?>>"));
+ B._ZoneFunction__RootZone__rootScheduleMicrotask = new A._ZoneFunction(B.C__RootZone, A.async___rootScheduleMicrotask$closure(), A.findType("_ZoneFunction<~(Zone,ZoneDelegate,Zone,~())>"));
+ })();
+ (function staticFields() {
+ $._JS_INTEROP_INTERCEPTOR_TAG = null;
+ $.toStringVisiting = A._setArrayType([], type$.JSArray_Object);
+ $.Primitives__identityHashCodeProperty = null;
+ $.BoundClosure__receiverFieldNameCache = null;
+ $.BoundClosure__interceptorFieldNameCache = null;
+ $.getTagFunction = null;
+ $.alternateTagFunction = null;
+ $.prototypeForTagFunction = null;
+ $.dispatchRecordsForInstanceTags = null;
+ $.interceptorsForUncacheableTags = null;
+ $.initNativeDispatchFlag = null;
+ $._nextCallback = null;
+ $._lastCallback = null;
+ $._lastPriorityCallback = null;
+ $._isInCallbackLoop = false;
+ $.Zone__current = B.C__RootZone;
+ $._RootZone__rootDelegate = null;
+ $.Uri__cachedBaseString = "";
+ $.Uri__cachedBaseUri = null;
+ $._currentUriBase = null;
+ $._current = null;
+ $._iframes = A.LinkedHashMap_LinkedHashMap$_empty(type$.int, type$.JavaScriptObject);
+ $._subscriptions = A.LinkedHashMap_LinkedHashMap$_empty(type$.int, A.findType("StreamSubscription<~>"));
+ $._domSubscriptions = A.LinkedHashMap_LinkedHashMap$_empty(type$.int, A.findType("Subscription"));
+ })();
+ (function lazyInitializers() {
+ var _lazyFinal = hunkHelpers.lazyFinal;
+ _lazyFinal($, "DART_CLOSURE_PROPERTY_NAME", "$get$DART_CLOSURE_PROPERTY_NAME", () => A.getIsolateAffinityTag("_$dart_dartClosure"));
+ _lazyFinal($, "nullFuture", "$get$nullFuture", () => B.C__RootZone.run$1$1(new A.nullFuture_closure(), A.findType("Future<Null>")));
+ _lazyFinal($, "TypeErrorDecoder_noSuchMethodPattern", "$get$TypeErrorDecoder_noSuchMethodPattern", () => A.TypeErrorDecoder_extractPattern(A.TypeErrorDecoder_provokeCallErrorOn({
+ toString: function() {
+ return "$receiver$";
+ }
+ })));
+ _lazyFinal($, "TypeErrorDecoder_notClosurePattern", "$get$TypeErrorDecoder_notClosurePattern", () => A.TypeErrorDecoder_extractPattern(A.TypeErrorDecoder_provokeCallErrorOn({$method$: null,
+ toString: function() {
+ return "$receiver$";
+ }
+ })));
+ _lazyFinal($, "TypeErrorDecoder_nullCallPattern", "$get$TypeErrorDecoder_nullCallPattern", () => A.TypeErrorDecoder_extractPattern(A.TypeErrorDecoder_provokeCallErrorOn(null)));
+ _lazyFinal($, "TypeErrorDecoder_nullLiteralCallPattern", "$get$TypeErrorDecoder_nullLiteralCallPattern", () => A.TypeErrorDecoder_extractPattern(function() {
+ var $argumentsExpr$ = "$arguments$";
+ try {
+ null.$method$($argumentsExpr$);
+ } catch (e) {
+ return e.message;
+ }
+ }()));
+ _lazyFinal($, "TypeErrorDecoder_undefinedCallPattern", "$get$TypeErrorDecoder_undefinedCallPattern", () => A.TypeErrorDecoder_extractPattern(A.TypeErrorDecoder_provokeCallErrorOn(void 0)));
+ _lazyFinal($, "TypeErrorDecoder_undefinedLiteralCallPattern", "$get$TypeErrorDecoder_undefinedLiteralCallPattern", () => A.TypeErrorDecoder_extractPattern(function() {
+ var $argumentsExpr$ = "$arguments$";
+ try {
+ (void 0).$method$($argumentsExpr$);
+ } catch (e) {
+ return e.message;
+ }
+ }()));
+ _lazyFinal($, "TypeErrorDecoder_nullPropertyPattern", "$get$TypeErrorDecoder_nullPropertyPattern", () => A.TypeErrorDecoder_extractPattern(A.TypeErrorDecoder_provokePropertyErrorOn(null)));
+ _lazyFinal($, "TypeErrorDecoder_nullLiteralPropertyPattern", "$get$TypeErrorDecoder_nullLiteralPropertyPattern", () => A.TypeErrorDecoder_extractPattern(function() {
+ try {
+ null.$method$;
+ } catch (e) {
+ return e.message;
+ }
+ }()));
+ _lazyFinal($, "TypeErrorDecoder_undefinedPropertyPattern", "$get$TypeErrorDecoder_undefinedPropertyPattern", () => A.TypeErrorDecoder_extractPattern(A.TypeErrorDecoder_provokePropertyErrorOn(void 0)));
+ _lazyFinal($, "TypeErrorDecoder_undefinedLiteralPropertyPattern", "$get$TypeErrorDecoder_undefinedLiteralPropertyPattern", () => A.TypeErrorDecoder_extractPattern(function() {
+ try {
+ (void 0).$method$;
+ } catch (e) {
+ return e.message;
+ }
+ }()));
+ _lazyFinal($, "_AsyncRun__scheduleImmediateClosure", "$get$_AsyncRun__scheduleImmediateClosure", () => A._AsyncRun__initializeScheduleImmediate());
+ _lazyFinal($, "Future__nullFuture", "$get$Future__nullFuture", () => A.findType("_Future<Null>")._as($.$get$nullFuture()));
+ _lazyFinal($, "_RootZone__rootMap", "$get$_RootZone__rootMap", () => {
+ var t1 = type$.dynamic;
+ return A.HashMap_HashMap(t1, t1);
+ });
+ _lazyFinal($, "Utf8Decoder__decoder", "$get$Utf8Decoder__decoder", () => new A.Utf8Decoder__decoder_closure().call$0());
+ _lazyFinal($, "Utf8Decoder__decoderNonfatal", "$get$Utf8Decoder__decoderNonfatal", () => new A.Utf8Decoder__decoderNonfatal_closure().call$0());
+ _lazyFinal($, "_Base64Decoder__inverseAlphabet", "$get$_Base64Decoder__inverseAlphabet", () => A.NativeInt8List__create1(A._ensureNativeList(A._setArrayType([-2, -2, -2, -2, -2, -2, -2, -2, -2, -2, -2, -2, -2, -2, -2, -2, -2, -2, -2, -2, -2, -2, -2, -2, -2, -2, -2, -2, -2, -2, -2, -2, -2, -2, -2, -2, -2, -1, -2, -2, -2, -2, -2, 62, -2, 62, -2, 63, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, -2, -2, -2, -1, -2, -2, -2, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, -2, -2, -2, -2, 63, -2, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, -2, -2, -2, -2, -2], type$.JSArray_int))));
+ _lazyFinal($, "_Uri__isWindowsCached", "$get$_Uri__isWindowsCached", () => typeof process != "undefined" && Object.prototype.toString.call(process) == "[object process]" && process.platform == "win32");
+ _lazyFinal($, "_Uri__needsNoEncoding", "$get$_Uri__needsNoEncoding", () => A.RegExp_RegExp("^[\\-\\.0-9A-Z_a-z~]*$", false));
+ _lazyFinal($, "_hashSeed", "$get$_hashSeed", () => A.objectHashCode(B.Type_Object_xQ6));
+ _lazyFinal($, "_scannerTables", "$get$_scannerTables", () => A._createTables());
+ _lazyFinal($, "windows", "$get$windows", () => A.Context_Context($.$get$Style_windows()));
+ _lazyFinal($, "context", "$get$context", () => new A.Context($.$get$Style_platform(), null));
+ _lazyFinal($, "Style_posix", "$get$Style_posix", () => new A.PosixStyle(A.RegExp_RegExp("/", false), A.RegExp_RegExp("[^/]$", false), A.RegExp_RegExp("^/", false)));
+ _lazyFinal($, "Style_windows", "$get$Style_windows", () => new A.WindowsStyle(A.RegExp_RegExp("[/\\\\]", false), A.RegExp_RegExp("[^/\\\\]$", false), A.RegExp_RegExp("^(\\\\\\\\[^\\\\]+\\\\[^\\\\/]+|[a-zA-Z]:[/\\\\])", false), A.RegExp_RegExp("^[/\\\\](?![/\\\\])", false)));
+ _lazyFinal($, "Style_url", "$get$Style_url", () => new A.UrlStyle(A.RegExp_RegExp("/", false), A.RegExp_RegExp("(^[a-zA-Z][-+.a-zA-Z\\d]*://|[^/])$", false), A.RegExp_RegExp("[a-zA-Z][-+.a-zA-Z\\d]*://[^/]*", false), A.RegExp_RegExp("^/", false)));
+ _lazyFinal($, "Style_platform", "$get$Style_platform", () => A.Style__getPlatformStyle());
+ _lazyFinal($, "_vmFrame", "$get$_vmFrame", () => A.RegExp_RegExp("^#\\d+\\s+(\\S.*) \\((.+?)((?::\\d+){0,2})\\)$", false));
+ _lazyFinal($, "_v8Frame", "$get$_v8Frame", () => A.RegExp_RegExp("^\\s*at (?:(\\S.*?)(?: \\[as [^\\]]+\\])? \\((.*)\\)|(.*))$", false));
+ _lazyFinal($, "_v8UrlLocation", "$get$_v8UrlLocation", () => A.RegExp_RegExp("^(.*?):(\\d+)(?::(\\d+))?$|native$", false));
+ _lazyFinal($, "_v8EvalLocation", "$get$_v8EvalLocation", () => A.RegExp_RegExp("^eval at (?:\\S.*?) \\((.*)\\)(?:, .*?:\\d+:\\d+)?$", false));
+ _lazyFinal($, "_firefoxEvalLocation", "$get$_firefoxEvalLocation", () => A.RegExp_RegExp("(\\S+)@(\\S+) line (\\d+) >.* (Function|eval):\\d+:\\d+", false));
+ _lazyFinal($, "_firefoxSafariFrame", "$get$_firefoxSafariFrame", () => A.RegExp_RegExp("^(?:([^@(/]*)(?:\\(.*\\))?((?:/[^/]*)*)(?:\\(.*\\))?@)?(.*?):(\\d*)(?::(\\d*))?$", false));
+ _lazyFinal($, "_friendlyFrame", "$get$_friendlyFrame", () => A.RegExp_RegExp("^(\\S+)(?: (\\d+)(?::(\\d+))?)?\\s+([^\\d].*)$", false));
+ _lazyFinal($, "_asyncBody", "$get$_asyncBody", () => A.RegExp_RegExp("<(<anonymous closure>|[^>]+)_async_body>", false));
+ _lazyFinal($, "_initialDot", "$get$_initialDot", () => A.RegExp_RegExp("^\\.", false));
+ _lazyFinal($, "Frame__uriRegExp", "$get$Frame__uriRegExp", () => A.RegExp_RegExp("^[a-zA-Z][-+.a-zA-Z\\d]*://", false));
+ _lazyFinal($, "Frame__windowsRegExp", "$get$Frame__windowsRegExp", () => A.RegExp_RegExp("^([a-zA-Z]:[\\\\/]|\\\\\\\\)", false));
+ _lazyFinal($, "_terseRegExp", "$get$_terseRegExp", () => A.RegExp_RegExp("(-patch)?([/\\\\].*)?$", false));
+ _lazyFinal($, "_v8Trace", "$get$_v8Trace", () => A.RegExp_RegExp("\\n ?at ", false));
+ _lazyFinal($, "_v8TraceLine", "$get$_v8TraceLine", () => A.RegExp_RegExp(" ?at ", false));
+ _lazyFinal($, "_firefoxEvalTrace", "$get$_firefoxEvalTrace", () => A.RegExp_RegExp("@\\S+ line \\d+ >.* (Function|eval):\\d+:\\d+", false));
+ _lazyFinal($, "_firefoxSafariTrace", "$get$_firefoxSafariTrace", () => A.RegExp_RegExp("^(([.0-9A-Za-z_$/<]|\\(.*\\))*@)?[^\\s]*:\\d*$", true));
+ _lazyFinal($, "_friendlyTrace", "$get$_friendlyTrace", () => A.RegExp_RegExp("^[^\\s<][^\\s]*( \\d+(:\\d+)?)?[ \\t]+[^\\s]+$", true));
+ _lazyFinal($, "vmChainGap", "$get$vmChainGap", () => A.RegExp_RegExp("^<asynchronous suspension>\\n?$", true));
+ _lazyFinal($, "_currentUrl", "$get$_currentUrl", () => A.Uri_parse(A.getProperty(A.getProperty(self.window, "location", type$.JavaScriptObject), "href", type$.String)));
+ })();
+ (function nativeSupport() {
+ !function() {
+ var intern = function(s) {
+ var o = {};
+ o[s] = 1;
+ return Object.keys(hunkHelpers.convertToFastObject(o))[0];
+ };
+ init.getIsolateTag = function(name) {
+ return intern("___dart_" + name + init.isolateTag);
+ };
+ var tableProperty = "___dart_isolate_tags_";
+ var usedProperties = Object[tableProperty] || (Object[tableProperty] = Object.create(null));
+ var rootProperty = "_ZxYxX";
+ for (var i = 0;; i++) {
+ var property = intern(rootProperty + "_" + i + "_");
+ if (!(property in usedProperties)) {
+ usedProperties[property] = 1;
+ init.isolateTag = property;
+ break;
+ }
+ }
+ init.dispatchPropertyName = init.getIsolateTag("dispatch_record");
+ }();
+ hunkHelpers.setOrUpdateInterceptorsByTag({WebGL: J.Interceptor, AbortPaymentEvent: J.JavaScriptObject, AnimationEffectReadOnly: J.JavaScriptObject, AnimationEffectTiming: J.JavaScriptObject, AnimationEffectTimingReadOnly: J.JavaScriptObject, AnimationEvent: J.JavaScriptObject, AnimationPlaybackEvent: J.JavaScriptObject, AnimationTimeline: J.JavaScriptObject, AnimationWorkletGlobalScope: J.JavaScriptObject, ApplicationCacheErrorEvent: J.JavaScriptObject, AuthenticatorAssertionResponse: J.JavaScriptObject, AuthenticatorAttestationResponse: J.JavaScriptObject, AuthenticatorResponse: J.JavaScriptObject, BackgroundFetchClickEvent: J.JavaScriptObject, BackgroundFetchEvent: J.JavaScriptObject, BackgroundFetchFailEvent: J.JavaScriptObject, BackgroundFetchFetch: J.JavaScriptObject, BackgroundFetchManager: J.JavaScriptObject, BackgroundFetchSettledFetch: J.JavaScriptObject, BackgroundFetchedEvent: J.JavaScriptObject, BarProp: J.JavaScriptObject, BarcodeDetector: J.JavaScriptObject, BeforeInstallPromptEvent: J.JavaScriptObject, BeforeUnloadEvent: J.JavaScriptObject, BlobEvent: J.JavaScriptObject, BluetoothRemoteGATTDescriptor: J.JavaScriptObject, Body: J.JavaScriptObject, BudgetState: J.JavaScriptObject, CacheStorage: J.JavaScriptObject, CanMakePaymentEvent: J.JavaScriptObject, CanvasGradient: J.JavaScriptObject, CanvasPattern: J.JavaScriptObject, CanvasRenderingContext2D: J.JavaScriptObject, Client: J.JavaScriptObject, Clients: J.JavaScriptObject, ClipboardEvent: J.JavaScriptObject, CloseEvent: J.JavaScriptObject, CompositionEvent: J.JavaScriptObject, CookieStore: J.JavaScriptObject, Coordinates: J.JavaScriptObject, Credential: J.JavaScriptObject, CredentialUserData: J.JavaScriptObject, CredentialsContainer: J.JavaScriptObject, Crypto: J.JavaScriptObject, CryptoKey: J.JavaScriptObject, CSS: J.JavaScriptObject, CSSVariableReferenceValue: J.JavaScriptObject, CustomElementRegistry: J.JavaScriptObject, CustomEvent: J.JavaScriptObject, DataTransfer: J.JavaScriptObject, DataTransferItem: J.JavaScriptObject, DeprecatedStorageInfo: J.JavaScriptObject, DeprecatedStorageQuota: J.JavaScriptObject, DeprecationReport: J.JavaScriptObject, DetectedBarcode: J.JavaScriptObject, DetectedFace: J.JavaScriptObject, DetectedText: J.JavaScriptObject, DeviceAcceleration: J.JavaScriptObject, DeviceMotionEvent: J.JavaScriptObject, DeviceOrientationEvent: J.JavaScriptObject, DeviceRotationRate: J.JavaScriptObject, DirectoryEntry: J.JavaScriptObject, webkitFileSystemDirectoryEntry: J.JavaScriptObject, FileSystemDirectoryEntry: J.JavaScriptObject, DirectoryReader: J.JavaScriptObject, WebKitDirectoryReader: J.JavaScriptObject, webkitFileSystemDirectoryReader: J.JavaScriptObject, FileSystemDirectoryReader: J.JavaScriptObject, DocumentOrShadowRoot: J.JavaScriptObject, DocumentTimeline: J.JavaScriptObject, DOMError: J.JavaScriptObject, DOMImplementation: J.JavaScriptObject, Iterator: J.JavaScriptObject, DOMMatrix: J.JavaScriptObject, DOMMatrixReadOnly: J.JavaScriptObject, DOMParser: J.JavaScriptObject, DOMPoint: J.JavaScriptObject, DOMPointReadOnly: J.JavaScriptObject, DOMQuad: J.JavaScriptObject, DOMStringMap: J.JavaScriptObject, Entry: J.JavaScriptObject, webkitFileSystemEntry: J.JavaScriptObject, FileSystemEntry: J.JavaScriptObject, ErrorEvent: J.JavaScriptObject, Event: J.JavaScriptObject, InputEvent: J.JavaScriptObject, SubmitEvent: J.JavaScriptObject, ExtendableEvent: J.JavaScriptObject, ExtendableMessageEvent: J.JavaScriptObject, External: J.JavaScriptObject, FaceDetector: J.JavaScriptObject, FederatedCredential: J.JavaScriptObject, FetchEvent: J.JavaScriptObject, FileEntry: J.JavaScriptObject, webkitFileSystemFileEntry: J.JavaScriptObject, FileSystemFileEntry: J.JavaScriptObject, DOMFileSystem: J.JavaScriptObject, WebKitFileSystem: J.JavaScriptObject, webkitFileSystem: J.JavaScriptObject, FileSystem: J.JavaScriptObject, FocusEvent: J.JavaScriptObject, FontFace: J.JavaScriptObject, FontFaceSetLoadEvent: J.JavaScriptObject, FontFaceSource: J.JavaScriptObject, ForeignFetchEvent: J.JavaScriptObject, FormData: J.JavaScriptObject, GamepadButton: J.JavaScriptObject, GamepadEvent: J.JavaScriptObject, GamepadPose: J.JavaScriptObject, Geolocation: J.JavaScriptObject, Position: J.JavaScriptObject, GeolocationPosition: J.JavaScriptObject, HashChangeEvent: J.JavaScriptObject, Headers: J.JavaScriptObject, HTMLHyperlinkElementUtils: J.JavaScriptObject, IdleDeadline: J.JavaScriptObject, ImageBitmap: J.JavaScriptObject, ImageBitmapRenderingContext: J.JavaScriptObject, ImageCapture: J.JavaScriptObject, ImageData: J.JavaScriptObject, InputDeviceCapabilities: J.JavaScriptObject, InstallEvent: J.JavaScriptObject, IntersectionObserver: J.JavaScriptObject, IntersectionObserverEntry: J.JavaScriptObject, InterventionReport: J.JavaScriptObject, KeyboardEvent: J.JavaScriptObject, KeyframeEffect: J.JavaScriptObject, KeyframeEffectReadOnly: J.JavaScriptObject, MediaCapabilities: J.JavaScriptObject, MediaCapabilitiesInfo: J.JavaScriptObject, MediaDeviceInfo: J.JavaScriptObject, MediaEncryptedEvent: J.JavaScriptObject, MediaError: J.JavaScriptObject, MediaKeyMessageEvent: J.JavaScriptObject, MediaKeyStatusMap: J.JavaScriptObject, MediaKeySystemAccess: J.JavaScriptObject, MediaKeys: J.JavaScriptObject, MediaKeysPolicy: J.JavaScriptObject, MediaMetadata: J.JavaScriptObject, MediaQueryListEvent: J.JavaScriptObject, MediaSession: J.JavaScriptObject, MediaSettingsRange: J.JavaScriptObject, MediaStreamEvent: J.JavaScriptObject, MediaStreamTrackEvent: J.JavaScriptObject, MemoryInfo: J.JavaScriptObject, MessageChannel: J.JavaScriptObject, MessageEvent: J.JavaScriptObject, Metadata: J.JavaScriptObject, MIDIConnectionEvent: J.JavaScriptObject, MIDIMessageEvent: J.JavaScriptObject, MouseEvent: J.JavaScriptObject, DragEvent: J.JavaScriptObject, MutationEvent: J.JavaScriptObject, MutationObserver: J.JavaScriptObject, WebKitMutationObserver: J.JavaScriptObject, MutationRecord: J.JavaScriptObject, NavigationPreloadManager: J.JavaScriptObject, Navigator: J.JavaScriptObject, NavigatorAutomationInformation: J.JavaScriptObject, NavigatorConcurrentHardware: J.JavaScriptObject, NavigatorCookies: J.JavaScriptObject, NavigatorUserMediaError: J.JavaScriptObject, NodeFilter: J.JavaScriptObject, NodeIterator: J.JavaScriptObject, NonDocumentTypeChildNode: J.JavaScriptObject, NonElementParentNode: J.JavaScriptObject, NoncedElement: J.JavaScriptObject, NotificationEvent: J.JavaScriptObject, OffscreenCanvasRenderingContext2D: J.JavaScriptObject, OverconstrainedError: J.JavaScriptObject, PageTransitionEvent: J.JavaScriptObject, PaintRenderingContext2D: J.JavaScriptObject, PaintSize: J.JavaScriptObject, PaintWorkletGlobalScope: J.JavaScriptObject, PasswordCredential: J.JavaScriptObject, Path2D: J.JavaScriptObject, PaymentAddress: J.JavaScriptObject, PaymentInstruments: J.JavaScriptObject, PaymentManager: J.JavaScriptObject, PaymentRequestEvent: J.JavaScriptObject, PaymentRequestUpdateEvent: J.JavaScriptObject, PaymentResponse: J.JavaScriptObject, PerformanceEntry: J.JavaScriptObject, PerformanceLongTaskTiming: J.JavaScriptObject, PerformanceMark: J.JavaScriptObject, PerformanceMeasure: J.JavaScriptObject, PerformanceNavigation: J.JavaScriptObject, PerformanceNavigationTiming: J.JavaScriptObject, PerformanceObserver: J.JavaScriptObject, PerformanceObserverEntryList: J.JavaScriptObject, PerformancePaintTiming: J.JavaScriptObject, PerformanceResourceTiming: J.JavaScriptObject, PerformanceServerTiming: J.JavaScriptObject, PerformanceTiming: J.JavaScriptObject, Permissions: J.JavaScriptObject, PhotoCapabilities: J.JavaScriptObject, PointerEvent: J.JavaScriptObject, PopStateEvent: J.JavaScriptObject, PositionError: J.JavaScriptObject, GeolocationPositionError: J.JavaScriptObject, Presentation: J.JavaScriptObject, PresentationConnectionAvailableEvent: J.JavaScriptObject, PresentationConnectionCloseEvent: J.JavaScriptObject, PresentationReceiver: J.JavaScriptObject, ProgressEvent: J.JavaScriptObject, PromiseRejectionEvent: J.JavaScriptObject, PublicKeyCredential: J.JavaScriptObject, PushEvent: J.JavaScriptObject, PushManager: J.JavaScriptObject, PushMessageData: J.JavaScriptObject, PushSubscription: J.JavaScriptObject, PushSubscriptionOptions: J.JavaScriptObject, Range: J.JavaScriptObject, RelatedApplication: J.JavaScriptObject, ReportBody: J.JavaScriptObject, ReportingObserver: J.JavaScriptObject, ResizeObserver: J.JavaScriptObject, ResizeObserverEntry: J.JavaScriptObject, RTCCertificate: J.JavaScriptObject, RTCDataChannelEvent: J.JavaScriptObject, RTCDTMFToneChangeEvent: J.JavaScriptObject, RTCIceCandidate: J.JavaScriptObject, mozRTCIceCandidate: J.JavaScriptObject, RTCLegacyStatsReport: J.JavaScriptObject, RTCPeerConnectionIceEvent: J.JavaScriptObject, RTCRtpContributingSource: J.JavaScriptObject, RTCRtpReceiver: J.JavaScriptObject, RTCRtpSender: J.JavaScriptObject, RTCSessionDescription: J.JavaScriptObject, mozRTCSessionDescription: J.JavaScriptObject, RTCStatsResponse: J.JavaScriptObject, RTCTrackEvent: J.JavaScriptObject, Screen: J.JavaScriptObject, ScrollState: J.JavaScriptObject, ScrollTimeline: J.JavaScriptObject, SecurityPolicyViolationEvent: J.JavaScriptObject, Selection: J.JavaScriptObject, SensorErrorEvent: J.JavaScriptObject, SharedArrayBuffer: J.JavaScriptObject, SpeechRecognitionAlternative: J.JavaScriptObject, SpeechRecognitionError: J.JavaScriptObject, SpeechRecognitionEvent: J.JavaScriptObject, SpeechSynthesisEvent: J.JavaScriptObject, SpeechSynthesisVoice: J.JavaScriptObject, StaticRange: J.JavaScriptObject, StorageEvent: J.JavaScriptObject, StorageManager: J.JavaScriptObject, StyleMedia: J.JavaScriptObject, StylePropertyMap: J.JavaScriptObject, StylePropertyMapReadonly: J.JavaScriptObject, SyncEvent: J.JavaScriptObject, SyncManager: J.JavaScriptObject, TaskAttributionTiming: J.JavaScriptObject, TextDetector: J.JavaScriptObject, TextEvent: J.JavaScriptObject, TextMetrics: J.JavaScriptObject, TouchEvent: J.JavaScriptObject, TrackDefault: J.JavaScriptObject, TrackEvent: J.JavaScriptObject, TransitionEvent: J.JavaScriptObject, WebKitTransitionEvent: J.JavaScriptObject, TreeWalker: J.JavaScriptObject, TrustedHTML: J.JavaScriptObject, TrustedScriptURL: J.JavaScriptObject, TrustedURL: J.JavaScriptObject, UIEvent: J.JavaScriptObject, UnderlyingSourceBase: J.JavaScriptObject, URLSearchParams: J.JavaScriptObject, VRCoordinateSystem: J.JavaScriptObject, VRDeviceEvent: J.JavaScriptObject, VRDisplayCapabilities: J.JavaScriptObject, VRDisplayEvent: J.JavaScriptObject, VREyeParameters: J.JavaScriptObject, VRFrameData: J.JavaScriptObject, VRFrameOfReference: J.JavaScriptObject, VRPose: J.JavaScriptObject, VRSessionEvent: J.JavaScriptObject, VRStageBounds: J.JavaScriptObject, VRStageBoundsPoint: J.JavaScriptObject, VRStageParameters: J.JavaScriptObject, ValidityState: J.JavaScriptObject, VideoPlaybackQuality: J.JavaScriptObject, VideoTrack: J.JavaScriptObject, VTTRegion: J.JavaScriptObject, WheelEvent: J.JavaScriptObject, WindowClient: J.JavaScriptObject, WorkletAnimation: J.JavaScriptObject, WorkletGlobalScope: J.JavaScriptObject, XPathEvaluator: J.JavaScriptObject, XPathExpression: J.JavaScriptObject, XPathNSResolver: J.JavaScriptObject, XPathResult: J.JavaScriptObject, XMLSerializer: J.JavaScriptObject, XSLTProcessor: J.JavaScriptObject, Bluetooth: J.JavaScriptObject, BluetoothCharacteristicProperties: J.JavaScriptObject, BluetoothRemoteGATTServer: J.JavaScriptObject, BluetoothRemoteGATTService: J.JavaScriptObject, BluetoothUUID: J.JavaScriptObject, BudgetService: J.JavaScriptObject, Cache: J.JavaScriptObject, DOMFileSystemSync: J.JavaScriptObject, DirectoryEntrySync: J.JavaScriptObject, DirectoryReaderSync: J.JavaScriptObject, EntrySync: J.JavaScriptObject, FileEntrySync: J.JavaScriptObject, FileReaderSync: J.JavaScriptObject, FileWriterSync: J.JavaScriptObject, HTMLAllCollection: J.JavaScriptObject, Mojo: J.JavaScriptObject, MojoHandle: J.JavaScriptObject, MojoInterfaceRequestEvent: J.JavaScriptObject, MojoWatcher: J.JavaScriptObject, NFC: J.JavaScriptObject, PagePopupController: J.JavaScriptObject, Report: J.JavaScriptObject, Request: J.JavaScriptObject, ResourceProgressEvent: J.JavaScriptObject, Response: J.JavaScriptObject, SubtleCrypto: J.JavaScriptObject, USBAlternateInterface: J.JavaScriptObject, USBConfiguration: J.JavaScriptObject, USBConnectionEvent: J.JavaScriptObject, USBDevice: J.JavaScriptObject, USBEndpoint: J.JavaScriptObject, USBInTransferResult: J.JavaScriptObject, USBInterface: J.JavaScriptObject, USBIsochronousInTransferPacket: J.JavaScriptObject, USBIsochronousInTransferResult: J.JavaScriptObject, USBIsochronousOutTransferPacket: J.JavaScriptObject, USBIsochronousOutTransferResult: J.JavaScriptObject, USBOutTransferResult: J.JavaScriptObject, WorkerLocation: J.JavaScriptObject, WorkerNavigator: J.JavaScriptObject, Worklet: J.JavaScriptObject, IDBCursor: J.JavaScriptObject, IDBCursorWithValue: J.JavaScriptObject, IDBFactory: J.JavaScriptObject, IDBIndex: J.JavaScriptObject, IDBKeyRange: J.JavaScriptObject, IDBObjectStore: J.JavaScriptObject, IDBObservation: J.JavaScriptObject, IDBObserver: J.JavaScriptObject, IDBObserverChanges: J.JavaScriptObject, IDBVersionChangeEvent: J.JavaScriptObject, SVGAngle: J.JavaScriptObject, SVGAnimatedAngle: J.JavaScriptObject, SVGAnimatedBoolean: J.JavaScriptObject, SVGAnimatedEnumeration: J.JavaScriptObject, SVGAnimatedInteger: J.JavaScriptObject, SVGAnimatedLength: J.JavaScriptObject, SVGAnimatedLengthList: J.JavaScriptObject, SVGAnimatedNumber: J.JavaScriptObject, SVGAnimatedNumberList: J.JavaScriptObject, SVGAnimatedPreserveAspectRatio: J.JavaScriptObject, SVGAnimatedRect: J.JavaScriptObject, SVGAnimatedString: J.JavaScriptObject, SVGAnimatedTransformList: J.JavaScriptObject, SVGMatrix: J.JavaScriptObject, SVGPoint: J.JavaScriptObject, SVGPreserveAspectRatio: J.JavaScriptObject, SVGRect: J.JavaScriptObject, SVGUnitTypes: J.JavaScriptObject, AudioListener: J.JavaScriptObject, AudioParam: J.JavaScriptObject, AudioProcessingEvent: J.JavaScriptObject, AudioTrack: J.JavaScriptObject, AudioWorkletGlobalScope: J.JavaScriptObject, AudioWorkletProcessor: J.JavaScriptObject, OfflineAudioCompletionEvent: J.JavaScriptObject, PeriodicWave: J.JavaScriptObject, WebGLActiveInfo: J.JavaScriptObject, ANGLEInstancedArrays: J.JavaScriptObject, ANGLE_instanced_arrays: J.JavaScriptObject, WebGLBuffer: J.JavaScriptObject, WebGLCanvas: J.JavaScriptObject, WebGLColorBufferFloat: J.JavaScriptObject, WebGLCompressedTextureASTC: J.JavaScriptObject, WebGLCompressedTextureATC: J.JavaScriptObject, WEBGL_compressed_texture_atc: J.JavaScriptObject, WebGLCompressedTextureETC1: J.JavaScriptObject, WEBGL_compressed_texture_etc1: J.JavaScriptObject, WebGLCompressedTextureETC: J.JavaScriptObject, WebGLCompressedTexturePVRTC: J.JavaScriptObject, WEBGL_compressed_texture_pvrtc: J.JavaScriptObject, WebGLCompressedTextureS3TC: J.JavaScriptObject, WEBGL_compressed_texture_s3tc: J.JavaScriptObject, WebGLCompressedTextureS3TCsRGB: J.JavaScriptObject, WebGLContextEvent: J.JavaScriptObject, WebGLDebugRendererInfo: J.JavaScriptObject, WEBGL_debug_renderer_info: J.JavaScriptObject, WebGLDebugShaders: J.JavaScriptObject, WEBGL_debug_shaders: J.JavaScriptObject, WebGLDepthTexture: J.JavaScriptObject, WEBGL_depth_texture: J.JavaScriptObject, WebGLDrawBuffers: J.JavaScriptObject, WEBGL_draw_buffers: J.JavaScriptObject, EXTsRGB: J.JavaScriptObject, EXT_sRGB: J.JavaScriptObject, EXTBlendMinMax: J.JavaScriptObject, EXT_blend_minmax: J.JavaScriptObject, EXTColorBufferFloat: J.JavaScriptObject, EXTColorBufferHalfFloat: J.JavaScriptObject, EXTDisjointTimerQuery: J.JavaScriptObject, EXTDisjointTimerQueryWebGL2: J.JavaScriptObject, EXTFragDepth: J.JavaScriptObject, EXT_frag_depth: J.JavaScriptObject, EXTShaderTextureLOD: J.JavaScriptObject, EXT_shader_texture_lod: J.JavaScriptObject, EXTTextureFilterAnisotropic: J.JavaScriptObject, EXT_texture_filter_anisotropic: J.JavaScriptObject, WebGLFramebuffer: J.JavaScriptObject, WebGLGetBufferSubDataAsync: J.JavaScriptObject, WebGLLoseContext: J.JavaScriptObject, WebGLExtensionLoseContext: J.JavaScriptObject, WEBGL_lose_context: J.JavaScriptObject, OESElementIndexUint: J.JavaScriptObject, OES_element_index_uint: J.JavaScriptObject, OESStandardDerivatives: J.JavaScriptObject, OES_standard_derivatives: J.JavaScriptObject, OESTextureFloat: J.JavaScriptObject, OES_texture_float: J.JavaScriptObject, OESTextureFloatLinear: J.JavaScriptObject, OES_texture_float_linear: J.JavaScriptObject, OESTextureHalfFloat: J.JavaScriptObject, OES_texture_half_float: J.JavaScriptObject, OESTextureHalfFloatLinear: J.JavaScriptObject, OES_texture_half_float_linear: J.JavaScriptObject, OESVertexArrayObject: J.JavaScriptObject, OES_vertex_array_object: J.JavaScriptObject, WebGLProgram: J.JavaScriptObject, WebGLQuery: J.JavaScriptObject, WebGLRenderbuffer: J.JavaScriptObject, WebGLRenderingContext: J.JavaScriptObject, WebGL2RenderingContext: J.JavaScriptObject, WebGLSampler: J.JavaScriptObject, WebGLShader: J.JavaScriptObject, WebGLShaderPrecisionFormat: J.JavaScriptObject, WebGLSync: J.JavaScriptObject, WebGLTexture: J.JavaScriptObject, WebGLTimerQueryEXT: J.JavaScriptObject, WebGLTransformFeedback: J.JavaScriptObject, WebGLUniformLocation: J.JavaScriptObject, WebGLVertexArrayObject: J.JavaScriptObject, WebGLVertexArrayObjectOES: J.JavaScriptObject, WebGL2RenderingContextBase: J.JavaScriptObject, ArrayBuffer: A.NativeByteBuffer, ArrayBufferView: A.NativeTypedData, DataView: A.NativeByteData, Float32Array: A.NativeFloat32List, Float64Array: A.NativeFloat64List, Int16Array: A.NativeInt16List, Int32Array: A.NativeInt32List, Int8Array: A.NativeInt8List, Uint16Array: A.NativeUint16List, Uint32Array: A.NativeUint32List, Uint8ClampedArray: A.NativeUint8ClampedList, CanvasPixelArray: A.NativeUint8ClampedList, Uint8Array: A.NativeUint8List, HTMLAudioElement: A.HtmlElement, HTMLBRElement: A.HtmlElement, HTMLBaseElement: A.HtmlElement, HTMLBodyElement: A.HtmlElement, HTMLButtonElement: A.HtmlElement, HTMLCanvasElement: A.HtmlElement, HTMLContentElement: A.HtmlElement, HTMLDListElement: A.HtmlElement, HTMLDataElement: A.HtmlElement, HTMLDataListElement: A.HtmlElement, HTMLDetailsElement: A.HtmlElement, HTMLDialogElement: A.HtmlElement, HTMLDivElement: A.HtmlElement, HTMLEmbedElement: A.HtmlElement, HTMLFieldSetElement: A.HtmlElement, HTMLHRElement: A.HtmlElement, HTMLHeadElement: A.HtmlElement, HTMLHeadingElement: A.HtmlElement, HTMLHtmlElement: A.HtmlElement, HTMLIFrameElement: A.HtmlElement, HTMLImageElement: A.HtmlElement, HTMLInputElement: A.HtmlElement, HTMLLIElement: A.HtmlElement, HTMLLabelElement: A.HtmlElement, HTMLLegendElement: A.HtmlElement, HTMLLinkElement: A.HtmlElement, HTMLMapElement: A.HtmlElement, HTMLMediaElement: A.HtmlElement, HTMLMenuElement: A.HtmlElement, HTMLMetaElement: A.HtmlElement, HTMLMeterElement: A.HtmlElement, HTMLModElement: A.HtmlElement, HTMLOListElement: A.HtmlElement, HTMLObjectElement: A.HtmlElement, HTMLOptGroupElement: A.HtmlElement, HTMLOptionElement: A.HtmlElement, HTMLOutputElement: A.HtmlElement, HTMLParagraphElement: A.HtmlElement, HTMLParamElement: A.HtmlElement, HTMLPictureElement: A.HtmlElement, HTMLPreElement: A.HtmlElement, HTMLProgressElement: A.HtmlElement, HTMLQuoteElement: A.HtmlElement, HTMLScriptElement: A.HtmlElement, HTMLShadowElement: A.HtmlElement, HTMLSlotElement: A.HtmlElement, HTMLSourceElement: A.HtmlElement, HTMLSpanElement: A.HtmlElement, HTMLStyleElement: A.HtmlElement, HTMLTableCaptionElement: A.HtmlElement, HTMLTableCellElement: A.HtmlElement, HTMLTableDataCellElement: A.HtmlElement, HTMLTableHeaderCellElement: A.HtmlElement, HTMLTableColElement: A.HtmlElement, HTMLTableElement: A.HtmlElement, HTMLTableRowElement: A.HtmlElement, HTMLTableSectionElement: A.HtmlElement, HTMLTemplateElement: A.HtmlElement, HTMLTextAreaElement: A.HtmlElement, HTMLTimeElement: A.HtmlElement, HTMLTitleElement: A.HtmlElement, HTMLTrackElement: A.HtmlElement, HTMLUListElement: A.HtmlElement, HTMLUnknownElement: A.HtmlElement, HTMLVideoElement: A.HtmlElement, HTMLDirectoryElement: A.HtmlElement, HTMLFontElement: A.HtmlElement, HTMLFrameElement: A.HtmlElement, HTMLFrameSetElement: A.HtmlElement, HTMLMarqueeElement: A.HtmlElement, HTMLElement: A.HtmlElement, AccessibleNodeList: A.AccessibleNodeList, HTMLAnchorElement: A.AnchorElement, HTMLAreaElement: A.AreaElement, Blob: A.Blob, CDATASection: A.CharacterData, CharacterData: A.CharacterData, Comment: A.CharacterData, ProcessingInstruction: A.CharacterData, Text: A.CharacterData, CSSPerspective: A.CssPerspective, CSSCharsetRule: A.CssRule, CSSConditionRule: A.CssRule, CSSFontFaceRule: A.CssRule, CSSGroupingRule: A.CssRule, CSSImportRule: A.CssRule, CSSKeyframeRule: A.CssRule, MozCSSKeyframeRule: A.CssRule, WebKitCSSKeyframeRule: A.CssRule, CSSKeyframesRule: A.CssRule, MozCSSKeyframesRule: A.CssRule, WebKitCSSKeyframesRule: A.CssRule, CSSMediaRule: A.CssRule, CSSNamespaceRule: A.CssRule, CSSPageRule: A.CssRule, CSSRule: A.CssRule, CSSStyleRule: A.CssRule, CSSSupportsRule: A.CssRule, CSSViewportRule: A.CssRule, CSSStyleDeclaration: A.CssStyleDeclaration, MSStyleCSSProperties: A.CssStyleDeclaration, CSS2Properties: A.CssStyleDeclaration, CSSImageValue: A.CssStyleValue, CSSKeywordValue: A.CssStyleValue, CSSNumericValue: A.CssStyleValue, CSSPositionValue: A.CssStyleValue, CSSResourceValue: A.CssStyleValue, CSSUnitValue: A.CssStyleValue, CSSURLImageValue: A.CssStyleValue, CSSStyleValue: A.CssStyleValue, CSSMatrixComponent: A.CssTransformComponent, CSSRotation: A.CssTransformComponent, CSSScale: A.CssTransformComponent, CSSSkew: A.CssTransformComponent, CSSTranslation: A.CssTransformComponent, CSSTransformComponent: A.CssTransformComponent, CSSTransformValue: A.CssTransformValue, CSSUnparsedValue: A.CssUnparsedValue, DataTransferItemList: A.DataTransferItemList, DOMException: A.DomException, ClientRectList: A.DomRectList, DOMRectList: A.DomRectList, DOMRectReadOnly: A.DomRectReadOnly, DOMStringList: A.DomStringList, DOMTokenList: A.DomTokenList, MathMLElement: A.Element, SVGAElement: A.Element, SVGAnimateElement: A.Element, SVGAnimateMotionElement: A.Element, SVGAnimateTransformElement: A.Element, SVGAnimationElement: A.Element, SVGCircleElement: A.Element, SVGClipPathElement: A.Element, SVGDefsElement: A.Element, SVGDescElement: A.Element, SVGDiscardElement: A.Element, SVGEllipseElement: A.Element, SVGFEBlendElement: A.Element, SVGFEColorMatrixElement: A.Element, SVGFEComponentTransferElement: A.Element, SVGFECompositeElement: A.Element, SVGFEConvolveMatrixElement: A.Element, SVGFEDiffuseLightingElement: A.Element, SVGFEDisplacementMapElement: A.Element, SVGFEDistantLightElement: A.Element, SVGFEFloodElement: A.Element, SVGFEFuncAElement: A.Element, SVGFEFuncBElement: A.Element, SVGFEFuncGElement: A.Element, SVGFEFuncRElement: A.Element, SVGFEGaussianBlurElement: A.Element, SVGFEImageElement: A.Element, SVGFEMergeElement: A.Element, SVGFEMergeNodeElement: A.Element, SVGFEMorphologyElement: A.Element, SVGFEOffsetElement: A.Element, SVGFEPointLightElement: A.Element, SVGFESpecularLightingElement: A.Element, SVGFESpotLightElement: A.Element, SVGFETileElement: A.Element, SVGFETurbulenceElement: A.Element, SVGFilterElement: A.Element, SVGForeignObjectElement: A.Element, SVGGElement: A.Element, SVGGeometryElement: A.Element, SVGGraphicsElement: A.Element, SVGImageElement: A.Element, SVGLineElement: A.Element, SVGLinearGradientElement: A.Element, SVGMarkerElement: A.Element, SVGMaskElement: A.Element, SVGMetadataElement: A.Element, SVGPathElement: A.Element, SVGPatternElement: A.Element, SVGPolygonElement: A.Element, SVGPolylineElement: A.Element, SVGRadialGradientElement: A.Element, SVGRectElement: A.Element, SVGScriptElement: A.Element, SVGSetElement: A.Element, SVGStopElement: A.Element, SVGStyleElement: A.Element, SVGElement: A.Element, SVGSVGElement: A.Element, SVGSwitchElement: A.Element, SVGSymbolElement: A.Element, SVGTSpanElement: A.Element, SVGTextContentElement: A.Element, SVGTextElement: A.Element, SVGTextPathElement: A.Element, SVGTextPositioningElement: A.Element, SVGTitleElement: A.Element, SVGUseElement: A.Element, SVGViewElement: A.Element, SVGGradientElement: A.Element, SVGComponentTransferFunctionElement: A.Element, SVGFEDropShadowElement: A.Element, SVGMPathElement: A.Element, Element: A.Element, AbsoluteOrientationSensor: A.EventTarget, Accelerometer: A.EventTarget, AccessibleNode: A.EventTarget, AmbientLightSensor: A.EventTarget, Animation: A.EventTarget, ApplicationCache: A.EventTarget, DOMApplicationCache: A.EventTarget, OfflineResourceList: A.EventTarget, BackgroundFetchRegistration: A.EventTarget, BatteryManager: A.EventTarget, BroadcastChannel: A.EventTarget, CanvasCaptureMediaStreamTrack: A.EventTarget, DedicatedWorkerGlobalScope: A.EventTarget, EventSource: A.EventTarget, FileReader: A.EventTarget, FontFaceSet: A.EventTarget, Gyroscope: A.EventTarget, XMLHttpRequest: A.EventTarget, XMLHttpRequestEventTarget: A.EventTarget, XMLHttpRequestUpload: A.EventTarget, LinearAccelerationSensor: A.EventTarget, Magnetometer: A.EventTarget, MediaDevices: A.EventTarget, MediaKeySession: A.EventTarget, MediaQueryList: A.EventTarget, MediaRecorder: A.EventTarget, MediaSource: A.EventTarget, MediaStream: A.EventTarget, MediaStreamTrack: A.EventTarget, MessagePort: A.EventTarget, MIDIAccess: A.EventTarget, MIDIInput: A.EventTarget, MIDIOutput: A.EventTarget, MIDIPort: A.EventTarget, NetworkInformation: A.EventTarget, Notification: A.EventTarget, OffscreenCanvas: A.EventTarget, OrientationSensor: A.EventTarget, PaymentRequest: A.EventTarget, Performance: A.EventTarget, PermissionStatus: A.EventTarget, PresentationAvailability: A.EventTarget, PresentationConnection: A.EventTarget, PresentationConnectionList: A.EventTarget, PresentationRequest: A.EventTarget, RelativeOrientationSensor: A.EventTarget, RemotePlayback: A.EventTarget, RTCDataChannel: A.EventTarget, DataChannel: A.EventTarget, RTCDTMFSender: A.EventTarget, RTCPeerConnection: A.EventTarget, webkitRTCPeerConnection: A.EventTarget, mozRTCPeerConnection: A.EventTarget, ScreenOrientation: A.EventTarget, Sensor: A.EventTarget, ServiceWorker: A.EventTarget, ServiceWorkerContainer: A.EventTarget, ServiceWorkerGlobalScope: A.EventTarget, ServiceWorkerRegistration: A.EventTarget, SharedWorker: A.EventTarget, SharedWorkerGlobalScope: A.EventTarget, SpeechRecognition: A.EventTarget, webkitSpeechRecognition: A.EventTarget, SpeechSynthesis: A.EventTarget, SpeechSynthesisUtterance: A.EventTarget, VR: A.EventTarget, VRDevice: A.EventTarget, VRDisplay: A.EventTarget, VRSession: A.EventTarget, VisualViewport: A.EventTarget, WebSocket: A.EventTarget, Window: A.EventTarget, DOMWindow: A.EventTarget, Worker: A.EventTarget, WorkerGlobalScope: A.EventTarget, WorkerPerformance: A.EventTarget, BluetoothDevice: A.EventTarget, BluetoothRemoteGATTCharacteristic: A.EventTarget, Clipboard: A.EventTarget, MojoInterfaceInterceptor: A.EventTarget, USB: A.EventTarget, IDBDatabase: A.EventTarget, IDBOpenDBRequest: A.EventTarget, IDBVersionChangeRequest: A.EventTarget, IDBRequest: A.EventTarget, IDBTransaction: A.EventTarget, AnalyserNode: A.EventTarget, RealtimeAnalyserNode: A.EventTarget, AudioBufferSourceNode: A.EventTarget, AudioDestinationNode: A.EventTarget, AudioNode: A.EventTarget, AudioScheduledSourceNode: A.EventTarget, AudioWorkletNode: A.EventTarget, BiquadFilterNode: A.EventTarget, ChannelMergerNode: A.EventTarget, AudioChannelMerger: A.EventTarget, ChannelSplitterNode: A.EventTarget, AudioChannelSplitter: A.EventTarget, ConstantSourceNode: A.EventTarget, ConvolverNode: A.EventTarget, DelayNode: A.EventTarget, DynamicsCompressorNode: A.EventTarget, GainNode: A.EventTarget, AudioGainNode: A.EventTarget, IIRFilterNode: A.EventTarget, MediaElementAudioSourceNode: A.EventTarget, MediaStreamAudioDestinationNode: A.EventTarget, MediaStreamAudioSourceNode: A.EventTarget, OscillatorNode: A.EventTarget, Oscillator: A.EventTarget, PannerNode: A.EventTarget, AudioPannerNode: A.EventTarget, webkitAudioPannerNode: A.EventTarget, ScriptProcessorNode: A.EventTarget, JavaScriptAudioNode: A.EventTarget, StereoPannerNode: A.EventTarget, WaveShaperNode: A.EventTarget, EventTarget: A.EventTarget, File: A.File, FileList: A.FileList, FileWriter: A.FileWriter, HTMLFormElement: A.FormElement, Gamepad: A.Gamepad, History: A.History, HTMLCollection: A.HtmlCollection, HTMLFormControlsCollection: A.HtmlCollection, HTMLOptionsCollection: A.HtmlCollection, Location: A.Location, MediaList: A.MediaList, MIDIInputMap: A.MidiInputMap, MIDIOutputMap: A.MidiOutputMap, MimeType: A.MimeType, MimeTypeArray: A.MimeTypeArray, Document: A.Node, DocumentFragment: A.Node, HTMLDocument: A.Node, ShadowRoot: A.Node, XMLDocument: A.Node, Attr: A.Node, DocumentType: A.Node, Node: A.Node, NodeList: A.NodeList, RadioNodeList: A.NodeList, Plugin: A.Plugin, PluginArray: A.PluginArray, RTCStatsReport: A.RtcStatsReport, HTMLSelectElement: A.SelectElement, SourceBuffer: A.SourceBuffer, SourceBufferList: A.SourceBufferList, SpeechGrammar: A.SpeechGrammar, SpeechGrammarList: A.SpeechGrammarList, SpeechRecognitionResult: A.SpeechRecognitionResult, Storage: A.Storage, CSSStyleSheet: A.StyleSheet, StyleSheet: A.StyleSheet, TextTrack: A.TextTrack, TextTrackCue: A.TextTrackCue, VTTCue: A.TextTrackCue, TextTrackCueList: A.TextTrackCueList, TextTrackList: A.TextTrackList, TimeRanges: A.TimeRanges, Touch: A.Touch, TouchList: A.TouchList, TrackDefaultList: A.TrackDefaultList, URL: A.Url, VideoTrackList: A.VideoTrackList, CSSRuleList: A._CssRuleList, ClientRect: A._DomRect, DOMRect: A._DomRect, GamepadList: A._GamepadList, NamedNodeMap: A._NamedNodeMap, MozNamedAttrMap: A._NamedNodeMap, SpeechRecognitionResultList: A._SpeechRecognitionResultList, StyleSheetList: A._StyleSheetList, SVGLength: A.Length, SVGLengthList: A.LengthList, SVGNumber: A.Number, SVGNumberList: A.NumberList, SVGPointList: A.PointList, SVGStringList: A.StringList, SVGTransform: A.Transform, SVGTransformList: A.TransformList, AudioBuffer: A.AudioBuffer, AudioParamMap: A.AudioParamMap, AudioTrackList: A.AudioTrackList, AudioContext: A.BaseAudioContext, webkitAudioContext: A.BaseAudioContext, BaseAudioContext: A.BaseAudioContext, OfflineAudioContext: A.OfflineAudioContext});
+ hunkHelpers.setOrUpdateLeafTags({WebGL: true, AbortPaymentEvent: true, AnimationEffectReadOnly: true, AnimationEffectTiming: true, AnimationEffectTimingReadOnly: true, AnimationEvent: true, AnimationPlaybackEvent: true, AnimationTimeline: true, AnimationWorkletGlobalScope: true, ApplicationCacheErrorEvent: true, AuthenticatorAssertionResponse: true, AuthenticatorAttestationResponse: true, AuthenticatorResponse: true, BackgroundFetchClickEvent: true, BackgroundFetchEvent: true, BackgroundFetchFailEvent: true, BackgroundFetchFetch: true, BackgroundFetchManager: true, BackgroundFetchSettledFetch: true, BackgroundFetchedEvent: true, BarProp: true, BarcodeDetector: true, BeforeInstallPromptEvent: true, BeforeUnloadEvent: true, BlobEvent: true, BluetoothRemoteGATTDescriptor: true, Body: true, BudgetState: true, CacheStorage: true, CanMakePaymentEvent: true, CanvasGradient: true, CanvasPattern: true, CanvasRenderingContext2D: true, Client: true, Clients: true, ClipboardEvent: true, CloseEvent: true, CompositionEvent: true, CookieStore: true, Coordinates: true, Credential: true, CredentialUserData: true, CredentialsContainer: true, Crypto: true, CryptoKey: true, CSS: true, CSSVariableReferenceValue: true, CustomElementRegistry: true, CustomEvent: true, DataTransfer: true, DataTransferItem: true, DeprecatedStorageInfo: true, DeprecatedStorageQuota: true, DeprecationReport: true, DetectedBarcode: true, DetectedFace: true, DetectedText: true, DeviceAcceleration: true, DeviceMotionEvent: true, DeviceOrientationEvent: true, DeviceRotationRate: true, DirectoryEntry: true, webkitFileSystemDirectoryEntry: true, FileSystemDirectoryEntry: true, DirectoryReader: true, WebKitDirectoryReader: true, webkitFileSystemDirectoryReader: true, FileSystemDirectoryReader: true, DocumentOrShadowRoot: true, DocumentTimeline: true, DOMError: true, DOMImplementation: true, Iterator: true, DOMMatrix: true, DOMMatrixReadOnly: true, DOMParser: true, DOMPoint: true, DOMPointReadOnly: true, DOMQuad: true, DOMStringMap: true, Entry: true, webkitFileSystemEntry: true, FileSystemEntry: true, ErrorEvent: true, Event: true, InputEvent: true, SubmitEvent: true, ExtendableEvent: true, ExtendableMessageEvent: true, External: true, FaceDetector: true, FederatedCredential: true, FetchEvent: true, FileEntry: true, webkitFileSystemFileEntry: true, FileSystemFileEntry: true, DOMFileSystem: true, WebKitFileSystem: true, webkitFileSystem: true, FileSystem: true, FocusEvent: true, FontFace: true, FontFaceSetLoadEvent: true, FontFaceSource: true, ForeignFetchEvent: true, FormData: true, GamepadButton: true, GamepadEvent: true, GamepadPose: true, Geolocation: true, Position: true, GeolocationPosition: true, HashChangeEvent: true, Headers: true, HTMLHyperlinkElementUtils: true, IdleDeadline: true, ImageBitmap: true, ImageBitmapRenderingContext: true, ImageCapture: true, ImageData: true, InputDeviceCapabilities: true, InstallEvent: true, IntersectionObserver: true, IntersectionObserverEntry: true, InterventionReport: true, KeyboardEvent: true, KeyframeEffect: true, KeyframeEffectReadOnly: true, MediaCapabilities: true, MediaCapabilitiesInfo: true, MediaDeviceInfo: true, MediaEncryptedEvent: true, MediaError: true, MediaKeyMessageEvent: true, MediaKeyStatusMap: true, MediaKeySystemAccess: true, MediaKeys: true, MediaKeysPolicy: true, MediaMetadata: true, MediaQueryListEvent: true, MediaSession: true, MediaSettingsRange: true, MediaStreamEvent: true, MediaStreamTrackEvent: true, MemoryInfo: true, MessageChannel: true, MessageEvent: true, Metadata: true, MIDIConnectionEvent: true, MIDIMessageEvent: true, MouseEvent: true, DragEvent: true, MutationEvent: true, MutationObserver: true, WebKitMutationObserver: true, MutationRecord: true, NavigationPreloadManager: true, Navigator: true, NavigatorAutomationInformation: true, NavigatorConcurrentHardware: true, NavigatorCookies: true, NavigatorUserMediaError: true, NodeFilter: true, NodeIterator: true, NonDocumentTypeChildNode: true, NonElementParentNode: true, NoncedElement: true, NotificationEvent: true, OffscreenCanvasRenderingContext2D: true, OverconstrainedError: true, PageTransitionEvent: true, PaintRenderingContext2D: true, PaintSize: true, PaintWorkletGlobalScope: true, PasswordCredential: true, Path2D: true, PaymentAddress: true, PaymentInstruments: true, PaymentManager: true, PaymentRequestEvent: true, PaymentRequestUpdateEvent: true, PaymentResponse: true, PerformanceEntry: true, PerformanceLongTaskTiming: true, PerformanceMark: true, PerformanceMeasure: true, PerformanceNavigation: true, PerformanceNavigationTiming: true, PerformanceObserver: true, PerformanceObserverEntryList: true, PerformancePaintTiming: true, PerformanceResourceTiming: true, PerformanceServerTiming: true, PerformanceTiming: true, Permissions: true, PhotoCapabilities: true, PointerEvent: true, PopStateEvent: true, PositionError: true, GeolocationPositionError: true, Presentation: true, PresentationConnectionAvailableEvent: true, PresentationConnectionCloseEvent: true, PresentationReceiver: true, ProgressEvent: true, PromiseRejectionEvent: true, PublicKeyCredential: true, PushEvent: true, PushManager: true, PushMessageData: true, PushSubscription: true, PushSubscriptionOptions: true, Range: true, RelatedApplication: true, ReportBody: true, ReportingObserver: true, ResizeObserver: true, ResizeObserverEntry: true, RTCCertificate: true, RTCDataChannelEvent: true, RTCDTMFToneChangeEvent: true, RTCIceCandidate: true, mozRTCIceCandidate: true, RTCLegacyStatsReport: true, RTCPeerConnectionIceEvent: true, RTCRtpContributingSource: true, RTCRtpReceiver: true, RTCRtpSender: true, RTCSessionDescription: true, mozRTCSessionDescription: true, RTCStatsResponse: true, RTCTrackEvent: true, Screen: true, ScrollState: true, ScrollTimeline: true, SecurityPolicyViolationEvent: true, Selection: true, SensorErrorEvent: true, SharedArrayBuffer: true, SpeechRecognitionAlternative: true, SpeechRecognitionError: true, SpeechRecognitionEvent: true, SpeechSynthesisEvent: true, SpeechSynthesisVoice: true, StaticRange: true, StorageEvent: true, StorageManager: true, StyleMedia: true, StylePropertyMap: true, StylePropertyMapReadonly: true, SyncEvent: true, SyncManager: true, TaskAttributionTiming: true, TextDetector: true, TextEvent: true, TextMetrics: true, TouchEvent: true, TrackDefault: true, TrackEvent: true, TransitionEvent: true, WebKitTransitionEvent: true, TreeWalker: true, TrustedHTML: true, TrustedScriptURL: true, TrustedURL: true, UIEvent: true, UnderlyingSourceBase: true, URLSearchParams: true, VRCoordinateSystem: true, VRDeviceEvent: true, VRDisplayCapabilities: true, VRDisplayEvent: true, VREyeParameters: true, VRFrameData: true, VRFrameOfReference: true, VRPose: true, VRSessionEvent: true, VRStageBounds: true, VRStageBoundsPoint: true, VRStageParameters: true, ValidityState: true, VideoPlaybackQuality: true, VideoTrack: true, VTTRegion: true, WheelEvent: true, WindowClient: true, WorkletAnimation: true, WorkletGlobalScope: true, XPathEvaluator: true, XPathExpression: true, XPathNSResolver: true, XPathResult: true, XMLSerializer: true, XSLTProcessor: true, Bluetooth: true, BluetoothCharacteristicProperties: true, BluetoothRemoteGATTServer: true, BluetoothRemoteGATTService: true, BluetoothUUID: true, BudgetService: true, Cache: true, DOMFileSystemSync: true, DirectoryEntrySync: true, DirectoryReaderSync: true, EntrySync: true, FileEntrySync: true, FileReaderSync: true, FileWriterSync: true, HTMLAllCollection: true, Mojo: true, MojoHandle: true, MojoInterfaceRequestEvent: true, MojoWatcher: true, NFC: true, PagePopupController: true, Report: true, Request: true, ResourceProgressEvent: true, Response: true, SubtleCrypto: true, USBAlternateInterface: true, USBConfiguration: true, USBConnectionEvent: true, USBDevice: true, USBEndpoint: true, USBInTransferResult: true, USBInterface: true, USBIsochronousInTransferPacket: true, USBIsochronousInTransferResult: true, USBIsochronousOutTransferPacket: true, USBIsochronousOutTransferResult: true, USBOutTransferResult: true, WorkerLocation: true, WorkerNavigator: true, Worklet: true, IDBCursor: true, IDBCursorWithValue: true, IDBFactory: true, IDBIndex: true, IDBKeyRange: true, IDBObjectStore: true, IDBObservation: true, IDBObserver: true, IDBObserverChanges: true, IDBVersionChangeEvent: true, SVGAngle: true, SVGAnimatedAngle: true, SVGAnimatedBoolean: true, SVGAnimatedEnumeration: true, SVGAnimatedInteger: true, SVGAnimatedLength: true, SVGAnimatedLengthList: true, SVGAnimatedNumber: true, SVGAnimatedNumberList: true, SVGAnimatedPreserveAspectRatio: true, SVGAnimatedRect: true, SVGAnimatedString: true, SVGAnimatedTransformList: true, SVGMatrix: true, SVGPoint: true, SVGPreserveAspectRatio: true, SVGRect: true, SVGUnitTypes: true, AudioListener: true, AudioParam: true, AudioProcessingEvent: true, AudioTrack: true, AudioWorkletGlobalScope: true, AudioWorkletProcessor: true, OfflineAudioCompletionEvent: true, PeriodicWave: true, WebGLActiveInfo: true, ANGLEInstancedArrays: true, ANGLE_instanced_arrays: true, WebGLBuffer: true, WebGLCanvas: true, WebGLColorBufferFloat: true, WebGLCompressedTextureASTC: true, WebGLCompressedTextureATC: true, WEBGL_compressed_texture_atc: true, WebGLCompressedTextureETC1: true, WEBGL_compressed_texture_etc1: true, WebGLCompressedTextureETC: true, WebGLCompressedTexturePVRTC: true, WEBGL_compressed_texture_pvrtc: true, WebGLCompressedTextureS3TC: true, WEBGL_compressed_texture_s3tc: true, WebGLCompressedTextureS3TCsRGB: true, WebGLContextEvent: true, WebGLDebugRendererInfo: true, WEBGL_debug_renderer_info: true, WebGLDebugShaders: true, WEBGL_debug_shaders: true, WebGLDepthTexture: true, WEBGL_depth_texture: true, WebGLDrawBuffers: true, WEBGL_draw_buffers: true, EXTsRGB: true, EXT_sRGB: true, EXTBlendMinMax: true, EXT_blend_minmax: true, EXTColorBufferFloat: true, EXTColorBufferHalfFloat: true, EXTDisjointTimerQuery: true, EXTDisjointTimerQueryWebGL2: true, EXTFragDepth: true, EXT_frag_depth: true, EXTShaderTextureLOD: true, EXT_shader_texture_lod: true, EXTTextureFilterAnisotropic: true, EXT_texture_filter_anisotropic: true, WebGLFramebuffer: true, WebGLGetBufferSubDataAsync: true, WebGLLoseContext: true, WebGLExtensionLoseContext: true, WEBGL_lose_context: true, OESElementIndexUint: true, OES_element_index_uint: true, OESStandardDerivatives: true, OES_standard_derivatives: true, OESTextureFloat: true, OES_texture_float: true, OESTextureFloatLinear: true, OES_texture_float_linear: true, OESTextureHalfFloat: true, OES_texture_half_float: true, OESTextureHalfFloatLinear: true, OES_texture_half_float_linear: true, OESVertexArrayObject: true, OES_vertex_array_object: true, WebGLProgram: true, WebGLQuery: true, WebGLRenderbuffer: true, WebGLRenderingContext: true, WebGL2RenderingContext: true, WebGLSampler: true, WebGLShader: true, WebGLShaderPrecisionFormat: true, WebGLSync: true, WebGLTexture: true, WebGLTimerQueryEXT: true, WebGLTransformFeedback: true, WebGLUniformLocation: true, WebGLVertexArrayObject: true, WebGLVertexArrayObjectOES: true, WebGL2RenderingContextBase: true, ArrayBuffer: true, ArrayBufferView: false, DataView: true, Float32Array: true, Float64Array: true, Int16Array: true, Int32Array: true, Int8Array: true, Uint16Array: true, Uint32Array: true, Uint8ClampedArray: true, CanvasPixelArray: true, Uint8Array: false, HTMLAudioElement: true, HTMLBRElement: true, HTMLBaseElement: true, HTMLBodyElement: true, HTMLButtonElement: true, HTMLCanvasElement: true, HTMLContentElement: true, HTMLDListElement: true, HTMLDataElement: true, HTMLDataListElement: true, HTMLDetailsElement: true, HTMLDialogElement: true, HTMLDivElement: true, HTMLEmbedElement: true, HTMLFieldSetElement: true, HTMLHRElement: true, HTMLHeadElement: true, HTMLHeadingElement: true, HTMLHtmlElement: true, HTMLIFrameElement: true, HTMLImageElement: true, HTMLInputElement: true, HTMLLIElement: true, HTMLLabelElement: true, HTMLLegendElement: true, HTMLLinkElement: true, HTMLMapElement: true, HTMLMediaElement: true, HTMLMenuElement: true, HTMLMetaElement: true, HTMLMeterElement: true, HTMLModElement: true, HTMLOListElement: true, HTMLObjectElement: true, HTMLOptGroupElement: true, HTMLOptionElement: true, HTMLOutputElement: true, HTMLParagraphElement: true, HTMLParamElement: true, HTMLPictureElement: true, HTMLPreElement: true, HTMLProgressElement: true, HTMLQuoteElement: true, HTMLScriptElement: true, HTMLShadowElement: true, HTMLSlotElement: true, HTMLSourceElement: true, HTMLSpanElement: true, HTMLStyleElement: true, HTMLTableCaptionElement: true, HTMLTableCellElement: true, HTMLTableDataCellElement: true, HTMLTableHeaderCellElement: true, HTMLTableColElement: true, HTMLTableElement: true, HTMLTableRowElement: true, HTMLTableSectionElement: true, HTMLTemplateElement: true, HTMLTextAreaElement: true, HTMLTimeElement: true, HTMLTitleElement: true, HTMLTrackElement: true, HTMLUListElement: true, HTMLUnknownElement: true, HTMLVideoElement: true, HTMLDirectoryElement: true, HTMLFontElement: true, HTMLFrameElement: true, HTMLFrameSetElement: true, HTMLMarqueeElement: true, HTMLElement: false, AccessibleNodeList: true, HTMLAnchorElement: true, HTMLAreaElement: true, Blob: false, CDATASection: true, CharacterData: true, Comment: true, ProcessingInstruction: true, Text: true, CSSPerspective: true, CSSCharsetRule: true, CSSConditionRule: true, CSSFontFaceRule: true, CSSGroupingRule: true, CSSImportRule: true, CSSKeyframeRule: true, MozCSSKeyframeRule: true, WebKitCSSKeyframeRule: true, CSSKeyframesRule: true, MozCSSKeyframesRule: true, WebKitCSSKeyframesRule: true, CSSMediaRule: true, CSSNamespaceRule: true, CSSPageRule: true, CSSRule: true, CSSStyleRule: true, CSSSupportsRule: true, CSSViewportRule: true, CSSStyleDeclaration: true, MSStyleCSSProperties: true, CSS2Properties: true, CSSImageValue: true, CSSKeywordValue: true, CSSNumericValue: true, CSSPositionValue: true, CSSResourceValue: true, CSSUnitValue: true, CSSURLImageValue: true, CSSStyleValue: false, CSSMatrixComponent: true, CSSRotation: true, CSSScale: true, CSSSkew: true, CSSTranslation: true, CSSTransformComponent: false, CSSTransformValue: true, CSSUnparsedValue: true, DataTransferItemList: true, DOMException: true, ClientRectList: true, DOMRectList: true, DOMRectReadOnly: false, DOMStringList: true, DOMTokenList: true, MathMLElement: true, SVGAElement: true, SVGAnimateElement: true, SVGAnimateMotionElement: true, SVGAnimateTransformElement: true, SVGAnimationElement: true, SVGCircleElement: true, SVGClipPathElement: true, SVGDefsElement: true, SVGDescElement: true, SVGDiscardElement: true, SVGEllipseElement: true, SVGFEBlendElement: true, SVGFEColorMatrixElement: true, SVGFEComponentTransferElement: true, SVGFECompositeElement: true, SVGFEConvolveMatrixElement: true, SVGFEDiffuseLightingElement: true, SVGFEDisplacementMapElement: true, SVGFEDistantLightElement: true, SVGFEFloodElement: true, SVGFEFuncAElement: true, SVGFEFuncBElement: true, SVGFEFuncGElement: true, SVGFEFuncRElement: true, SVGFEGaussianBlurElement: true, SVGFEImageElement: true, SVGFEMergeElement: true, SVGFEMergeNodeElement: true, SVGFEMorphologyElement: true, SVGFEOffsetElement: true, SVGFEPointLightElement: true, SVGFESpecularLightingElement: true, SVGFESpotLightElement: true, SVGFETileElement: true, SVGFETurbulenceElement: true, SVGFilterElement: true, SVGForeignObjectElement: true, SVGGElement: true, SVGGeometryElement: true, SVGGraphicsElement: true, SVGImageElement: true, SVGLineElement: true, SVGLinearGradientElement: true, SVGMarkerElement: true, SVGMaskElement: true, SVGMetadataElement: true, SVGPathElement: true, SVGPatternElement: true, SVGPolygonElement: true, SVGPolylineElement: true, SVGRadialGradientElement: true, SVGRectElement: true, SVGScriptElement: true, SVGSetElement: true, SVGStopElement: true, SVGStyleElement: true, SVGElement: true, SVGSVGElement: true, SVGSwitchElement: true, SVGSymbolElement: true, SVGTSpanElement: true, SVGTextContentElement: true, SVGTextElement: true, SVGTextPathElement: true, SVGTextPositioningElement: true, SVGTitleElement: true, SVGUseElement: true, SVGViewElement: true, SVGGradientElement: true, SVGComponentTransferFunctionElement: true, SVGFEDropShadowElement: true, SVGMPathElement: true, Element: false, AbsoluteOrientationSensor: true, Accelerometer: true, AccessibleNode: true, AmbientLightSensor: true, Animation: true, ApplicationCache: true, DOMApplicationCache: true, OfflineResourceList: true, BackgroundFetchRegistration: true, BatteryManager: true, BroadcastChannel: true, CanvasCaptureMediaStreamTrack: true, DedicatedWorkerGlobalScope: true, EventSource: true, FileReader: true, FontFaceSet: true, Gyroscope: true, XMLHttpRequest: true, XMLHttpRequestEventTarget: true, XMLHttpRequestUpload: true, LinearAccelerationSensor: true, Magnetometer: true, MediaDevices: true, MediaKeySession: true, MediaQueryList: true, MediaRecorder: true, MediaSource: true, MediaStream: true, MediaStreamTrack: true, MessagePort: true, MIDIAccess: true, MIDIInput: true, MIDIOutput: true, MIDIPort: true, NetworkInformation: true, Notification: true, OffscreenCanvas: true, OrientationSensor: true, PaymentRequest: true, Performance: true, PermissionStatus: true, PresentationAvailability: true, PresentationConnection: true, PresentationConnectionList: true, PresentationRequest: true, RelativeOrientationSensor: true, RemotePlayback: true, RTCDataChannel: true, DataChannel: true, RTCDTMFSender: true, RTCPeerConnection: true, webkitRTCPeerConnection: true, mozRTCPeerConnection: true, ScreenOrientation: true, Sensor: true, ServiceWorker: true, ServiceWorkerContainer: true, ServiceWorkerGlobalScope: true, ServiceWorkerRegistration: true, SharedWorker: true, SharedWorkerGlobalScope: true, SpeechRecognition: true, webkitSpeechRecognition: true, SpeechSynthesis: true, SpeechSynthesisUtterance: true, VR: true, VRDevice: true, VRDisplay: true, VRSession: true, VisualViewport: true, WebSocket: true, Window: true, DOMWindow: true, Worker: true, WorkerGlobalScope: true, WorkerPerformance: true, BluetoothDevice: true, BluetoothRemoteGATTCharacteristic: true, Clipboard: true, MojoInterfaceInterceptor: true, USB: true, IDBDatabase: true, IDBOpenDBRequest: true, IDBVersionChangeRequest: true, IDBRequest: true, IDBTransaction: true, AnalyserNode: true, RealtimeAnalyserNode: true, AudioBufferSourceNode: true, AudioDestinationNode: true, AudioNode: true, AudioScheduledSourceNode: true, AudioWorkletNode: true, BiquadFilterNode: true, ChannelMergerNode: true, AudioChannelMerger: true, ChannelSplitterNode: true, AudioChannelSplitter: true, ConstantSourceNode: true, ConvolverNode: true, DelayNode: true, DynamicsCompressorNode: true, GainNode: true, AudioGainNode: true, IIRFilterNode: true, MediaElementAudioSourceNode: true, MediaStreamAudioDestinationNode: true, MediaStreamAudioSourceNode: true, OscillatorNode: true, Oscillator: true, PannerNode: true, AudioPannerNode: true, webkitAudioPannerNode: true, ScriptProcessorNode: true, JavaScriptAudioNode: true, StereoPannerNode: true, WaveShaperNode: true, EventTarget: false, File: true, FileList: true, FileWriter: true, HTMLFormElement: true, Gamepad: true, History: true, HTMLCollection: true, HTMLFormControlsCollection: true, HTMLOptionsCollection: true, Location: true, MediaList: true, MIDIInputMap: true, MIDIOutputMap: true, MimeType: true, MimeTypeArray: true, Document: true, DocumentFragment: true, HTMLDocument: true, ShadowRoot: true, XMLDocument: true, Attr: true, DocumentType: true, Node: false, NodeList: true, RadioNodeList: true, Plugin: true, PluginArray: true, RTCStatsReport: true, HTMLSelectElement: true, SourceBuffer: true, SourceBufferList: true, SpeechGrammar: true, SpeechGrammarList: true, SpeechRecognitionResult: true, Storage: true, CSSStyleSheet: true, StyleSheet: true, TextTrack: true, TextTrackCue: true, VTTCue: true, TextTrackCueList: true, TextTrackList: true, TimeRanges: true, Touch: true, TouchList: true, TrackDefaultList: true, URL: true, VideoTrackList: true, CSSRuleList: true, ClientRect: true, DOMRect: true, GamepadList: true, NamedNodeMap: true, MozNamedAttrMap: true, SpeechRecognitionResultList: true, StyleSheetList: true, SVGLength: true, SVGLengthList: true, SVGNumber: true, SVGNumberList: true, SVGPointList: true, SVGStringList: true, SVGTransform: true, SVGTransformList: true, AudioBuffer: true, AudioParamMap: true, AudioTrackList: true, AudioContext: true, webkitAudioContext: true, BaseAudioContext: false, OfflineAudioContext: true});
+ A.NativeTypedArray.$nativeSuperclassTag = "ArrayBufferView";
+ A._NativeTypedArrayOfDouble_NativeTypedArray_ListMixin.$nativeSuperclassTag = "ArrayBufferView";
+ A._NativeTypedArrayOfDouble_NativeTypedArray_ListMixin_FixedLengthListMixin.$nativeSuperclassTag = "ArrayBufferView";
+ A.NativeTypedArrayOfDouble.$nativeSuperclassTag = "ArrayBufferView";
+ A._NativeTypedArrayOfInt_NativeTypedArray_ListMixin.$nativeSuperclassTag = "ArrayBufferView";
+ A._NativeTypedArrayOfInt_NativeTypedArray_ListMixin_FixedLengthListMixin.$nativeSuperclassTag = "ArrayBufferView";
+ A.NativeTypedArrayOfInt.$nativeSuperclassTag = "ArrayBufferView";
+ A._SourceBufferList_EventTarget_ListMixin.$nativeSuperclassTag = "EventTarget";
+ A._SourceBufferList_EventTarget_ListMixin_ImmutableListMixin.$nativeSuperclassTag = "EventTarget";
+ A._TextTrackList_EventTarget_ListMixin.$nativeSuperclassTag = "EventTarget";
+ A._TextTrackList_EventTarget_ListMixin_ImmutableListMixin.$nativeSuperclassTag = "EventTarget";
+ })();
+ Function.prototype.call$1 = function(a) {
+ return this(a);
+ };
+ Function.prototype.call$2 = function(a, b) {
+ return this(a, b);
+ };
+ Function.prototype.call$0 = function() {
+ return this();
+ };
+ Function.prototype.call$1$1 = function(a) {
+ return this(a);
+ };
+ Function.prototype.call$3$3 = function(a, b, c) {
+ return this(a, b, c);
+ };
+ Function.prototype.call$5 = function(a, b, c, d, e) {
+ return this(a, b, c, d, e);
+ };
+ Function.prototype.call$3 = function(a, b, c) {
+ return this(a, b, c);
+ };
+ Function.prototype.call$3$6 = function(a, b, c, d, e, f) {
+ return this(a, b, c, d, e, f);
+ };
+ Function.prototype.call$1$4 = function(a, b, c, d) {
+ return this(a, b, c, d);
+ };
+ Function.prototype.call$2$1 = function(a) {
+ return this(a);
+ };
+ Function.prototype.call$2$5 = function(a, b, c, d, e) {
+ return this(a, b, c, d, e);
+ };
+ Function.prototype.call$2$4 = function(a, b, c, d) {
+ return this(a, b, c, d);
+ };
+ Function.prototype.call$4 = function(a, b, c, d) {
+ return this(a, b, c, d);
+ };
+ Function.prototype.call$2$2 = function(a, b) {
+ return this(a, b);
+ };
+ Function.prototype.call$3$1 = function(a) {
+ return this(a);
+ };
+ Function.prototype.call$3$4 = function(a, b, c, d) {
+ return this(a, b, c, d);
+ };
+ Function.prototype.call$1$2 = function(a, b) {
+ return this(a, b);
+ };
+ Function.prototype.call$1$0 = function() {
+ return this();
+ };
+ Function.prototype.call$2$3 = function(a, b, c) {
+ return this(a, b, c);
+ };
+ convertAllToFastObject(holders);
+ convertToFastObject($);
+ (function(callback) {
+ if (typeof document === "undefined") {
+ callback(null);
+ return;
+ }
+ if (typeof document.currentScript != "undefined") {
+ callback(document.currentScript);
+ return;
+ }
+ var scripts = document.scripts;
+ function onLoad(event) {
+ for (var i = 0; i < scripts.length; ++i)
+ scripts[i].removeEventListener("load", onLoad, false);
+ callback(event.target);
+ }
+ for (var i = 0; i < scripts.length; ++i)
+ scripts[i].addEventListener("load", onLoad, false);
+ })(function(currentScript) {
+ init.currentScript = currentScript;
+ var callMain = A.main;
+ if (typeof dartMainRunner === "function")
+ dartMainRunner(callMain, []);
+ else
+ callMain([]);
+ });
+})();
+
+//# sourceMappingURL=host.dart.js.map
diff --git a/pkgs/test/lib/src/runner/browser/static/index.html b/pkgs/test/lib/src/runner/browser/static/index.html
new file mode 100644
index 0000000..69617fa
--- /dev/null
+++ b/pkgs/test/lib/src/runner/browser/static/index.html
@@ -0,0 +1,24 @@
+<!DOCTYPE html>
+<html>
+<head>
+ <title>test Browser Host</title>
+ <link rel="stylesheet" type="text/css" href="host.css" />
+</head>
+<body>
+ <svg id="dart" version="1.1" x="0px" y="0px" width="400px" height="400px" viewBox="0 0 400 400">
+ <path id="right-flank" fill="#0083C9" d="M249.379,226.486l-6.676,15.572L166.174,166h58.82c0,0,2.807-0.409,3.645,1.966L249.379,226.486z"/>
+ <path id="right-ear" fill="#00D2B8" d="M201.84,141.906L166.174,166h58.82c0,0,2.168-0.25,2.645,0.566l-2.694-8.848l-15.024-14.68C207.555,140.329,203.578,140.744,201.84,141.906z"/>
+ <path id="left-flank" fill="#00D2B8" d="M242.616,241.856l-15.022,6.799l-60.493-21.429c-1.035-0.395-1.101-3.696-1.101-3.696v-57.932L242.616,241.856z"/>
+ <path id="left-paw" fill="#55DECA" d="M167.003,227.098l60.636,21.558l15.064-6.799L237.224,259h-43.856c0,0-14.077-13.929-18.141-17.993C171.162,236.943,169.162,233.989,167.003,227.098z"/>
+ <path id="right-paw" fill="#00A4E4" d="M227.676,166.365c0.963,1.401,1.361,2.473,1.361,2.473l20.352,57.648l-6.711,15.37L259,236.463v-44.854c0,0-13.678-13.965-17.741-17.882C237.193,169.811,231.466,166.319,227.676,166.365z"/>
+ <path id="left-ear" fill="#0083C9" d="M166.769,227.098c0,0-0.769-1.104-0.769-4.355v-57.144l-23.115,34.877c-1.626,1.774-1.567,6.538,1.595,9.755l13.636,13.892L166.769,227.098z"/>
+ </svg>
+ <div id="dark"></div>
+ <svg id="play" version="1.1" x="0px" y="0px" width="80px" height="80px" viewBox="0 0 25 25">
+ <defs><filter id="blur"><feGaussianBlur stdDeviation="0.3" id="feGaussianBlur5097" /></filter></defs>
+ <path d="M 3.777014,1.3715789 A 1.1838119,1.1838119 0 0 0 2.693923,2.5488509 V 22.444746 a 1.1838119,1.1838119 0 0 0 1.765908,1.035999 l 17.235259,-9.95972 a 1.1838119,1.1838119 0 0 0 0,-2.071998 L 4.459831,1.5128519 A 1.1838119,1.1838119 0 0 0 3.777014,1.3715789 z" style="opacity:0.5;stroke:#000000;stroke-width:1;filter:url(#blur)" />
+ <path style="fill:#ffffff;fill-opacity:1;stroke:#000000;stroke-width:1.32722104" d="M 3.4770491,1.0714664 A 1.1838119,1.1838119 0 0 0 2.3939589,2.2487382 V 22.144633 a 1.1838119,1.1838119 0 0 0 1.7659079,1.035999 l 17.2352602,-9.95972 a 1.1838119,1.1838119 0 0 0 0,-2.071998 L 4.1598668,1.2127389 A 1.1838119,1.1838119 0 0 0 3.4770491,1.0714664 z" />
+ </svg>
+ <script src="host.dart.js"></script>
+</body>
+</html>
diff --git a/pkgs/test/lib/src/runner/browser/static/run_wasm_chrome.js b/pkgs/test/lib/src/runner/browser/static/run_wasm_chrome.js
new file mode 100644
index 0000000..6e3bda0
--- /dev/null
+++ b/pkgs/test/lib/src/runner/browser/static/run_wasm_chrome.js
@@ -0,0 +1,47 @@
+// Copyright (c) 2022, 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.
+
+// TODO(joshualitt): Investigate making this a module. Currently, Dart2Wasm is
+// broken in D8 with modules because of an issue with async. This may or may not
+// affect chrome.
+(async () => {
+ // Fetch and compile Wasm binary.
+ let data = document.getElementById("WasmBootstrapInfo").dataset;
+
+ // Instantiate the Dart module, importing from the global scope.
+ let dart2wasmJsRuntime = await import("./" + data.jsruntimeurl);
+
+ // Support three versions of dart2wasm:
+ //
+ // (1) Versions before 3.6.0-167.0.dev require the user to compile using the
+ // browser's `WebAssembly` API, the compiled module needs to be instantiated
+ // using the JS runtime.
+ //
+ // (2) Versions starting with 3.6.0-167.0.dev added helpers for compiling and
+ // instantiating.
+ //
+ // (3) Versions starting with 3.6.0-212.0.dev made compilation functions
+ // return a new type that comes with instantiation and invoke methods.
+
+ if (dart2wasmJsRuntime.compileStreaming !== undefined) {
+ // Version (2) or (3).
+ let compiledModule = await dart2wasmJsRuntime.compileStreaming(
+ fetch(data.wasmurl),
+ );
+ if (compiledModule.instantiate !== undefined) {
+ // Version (3).
+ let instantiatedModule = await compiledModule.instantiate();
+ instantiatedModule.invokeMain();
+ } else {
+ // Version (2).
+ let dartInstance = await dart2wasmJsRuntime.instantiate(compiledModule, {});
+ await dart2wasmJsRuntime.invoke(dartInstance);
+ }
+ } else {
+ // Version (1).
+ let modulePromise = WebAssembly.compileStreaming(fetch(data.wasmurl));
+ let dartInstance = await dart2wasmJsRuntime.instantiate(modulePromise, {});
+ await dart2wasmJsRuntime.invoke(dartInstance);
+ }
+})();
diff --git a/pkgs/test/lib/src/runner/executable_settings.dart b/pkgs/test/lib/src/runner/executable_settings.dart
new file mode 100644
index 0000000..904dc51
--- /dev/null
+++ b/pkgs/test/lib/src/runner/executable_settings.dart
@@ -0,0 +1,224 @@
+// Copyright (c) 2017, 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:io';
+
+import 'package:io/io.dart';
+import 'package:path/path.dart' as p;
+import 'package:source_span/source_span.dart';
+import 'package:yaml/yaml.dart';
+
+/// User-provided settings for invoking an executable.
+class ExecutableSettings {
+ /// Additional arguments to pass to the executable.
+ final List<String> arguments;
+
+ /// The path to the executable on Linux.
+ ///
+ /// This may be an absolute path or a basename, in which case it will be
+ /// looked up on the system path. It may not be relative.
+ final String? _linuxExecutable;
+
+ /// Potential commands to execute on Mac OS to launch this executable.
+ ///
+ /// The values may be an absolute path, or a basename.
+ /// The chosen command will be the first value from this list which either is
+ /// a full path that exists, or is a basename. When a basename is included it
+ /// should always be at the end of the list because it will always terminate
+ /// the search through the list. Relative paths are not allowed.
+ final List<String>? _macOSExectuables;
+
+ /// The path to the executable on Windows.
+ ///
+ /// This may be an absolute path; a basename, in which case it will be looked
+ /// up on the system path; or a relative path, in which case it will be looked
+ /// up relative to the paths in the `LOCALAPPDATA`, `PROGRAMFILES`, and
+ /// `PROGRAMFILES(X64)` environment variables.
+ final String? _windowsExecutable;
+
+ /// The environment variable, if any, to use as an override for the default
+ /// path.
+ final String? _environmentOverride;
+
+ /// The path to the executable for the current operating system.
+ String get executable {
+ if (_environmentOverride != null) {
+ final envVariable = Platform.environment[_environmentOverride];
+ if (envVariable != null) return envVariable;
+ }
+
+ if (Platform.isMacOS) {
+ if (_macOSExectuables != null) {
+ for (final path in _macOSExectuables) {
+ if (p.basename(path) == path) return path;
+ if (p.isAbsolute(path)) {
+ if (File(path).existsSync()) return path;
+ } else {
+ throw ArgumentError(
+ 'Mac OS executable must be a basename or an absolute path.'
+ ' Got relative path: $path');
+ }
+ }
+ }
+ throw ArgumentError('Could not find a command basename or an existing '
+ 'path in $_macOSExectuables');
+ }
+ if (!Platform.isWindows) return _linuxExecutable!;
+ final windowsExecutable = _windowsExecutable!;
+ if (p.isAbsolute(windowsExecutable)) return windowsExecutable;
+ if (p.basename(windowsExecutable) == windowsExecutable) {
+ return windowsExecutable;
+ }
+
+ var prefixes = [
+ Platform.environment['LOCALAPPDATA'],
+ Platform.environment['PROGRAMFILES'],
+ Platform.environment['PROGRAMFILES(X86)']
+ ];
+
+ for (var prefix in prefixes) {
+ if (prefix == null) continue;
+
+ var path = p.join(prefix, windowsExecutable);
+ if (File(path).existsSync()) return path;
+ }
+
+ // If we can't find a path that works, return one that doesn't. This will
+ // cause an "executable not found" error to surface.
+ return p.join(
+ prefixes.firstWhere((prefix) => prefix != null, orElse: () => '.')!,
+ _windowsExecutable);
+ }
+
+ /// Whether to invoke the browser in headless mode.
+ ///
+ /// This is currently only supported by Chrome.
+ bool get headless => _headless ?? true;
+ final bool? _headless;
+
+ /// Parses settings from a user-provided YAML mapping.
+ factory ExecutableSettings.parse(YamlMap settings) {
+ List<String>? arguments;
+ var argumentsNode = settings.nodes['arguments'];
+ if (argumentsNode != null) {
+ var value = argumentsNode.value;
+ if (value is String) {
+ try {
+ arguments = shellSplit(value);
+ } on FormatException catch (error) {
+ throw SourceSpanFormatException(error.message, argumentsNode.span);
+ }
+ } else {
+ throw SourceSpanFormatException(
+ 'Must be a string.', argumentsNode.span);
+ }
+ }
+
+ String? linuxExecutable;
+ String? macOSExecutable;
+ String? windowsExecutable;
+ var executableNode = settings.nodes['executable'];
+ if (executableNode != null) {
+ var value = executableNode.value;
+ if (value is String) {
+ // Don't check this on Windows because people may want to set relative
+ // paths in their global config.
+ if (!Platform.isWindows) {
+ _assertNotRelative(executableNode as YamlScalar);
+ }
+
+ linuxExecutable = value;
+ macOSExecutable = value;
+ windowsExecutable = value;
+ } else if (executableNode is YamlMap) {
+ linuxExecutable = _getExecutable(executableNode.nodes['linux']);
+ macOSExecutable = _getExecutable(executableNode.nodes['mac_os']);
+ windowsExecutable = _getExecutable(executableNode.nodes['windows'],
+ allowRelative: true);
+ } else {
+ throw SourceSpanFormatException(
+ 'Must be a map or a string.', executableNode.span);
+ }
+ }
+
+ var headless = true;
+ var headlessNode = settings.nodes['headless'];
+ if (headlessNode != null) {
+ var value = headlessNode.value;
+ if (value is bool) {
+ headless = value;
+ } else {
+ throw SourceSpanFormatException(
+ 'Must be a boolean.', headlessNode.span);
+ }
+ }
+
+ return ExecutableSettings(
+ arguments: arguments,
+ linuxExecutable: linuxExecutable,
+ macOSExecutable: macOSExecutable,
+ windowsExecutable: windowsExecutable,
+ headless: headless);
+ }
+
+ /// Asserts that [executableNode] is a string or `null` and returns it.
+ ///
+ /// If [allowRelative] is `false` (the default), asserts that the value isn't
+ /// a relative path.
+ static String? _getExecutable(YamlNode? executableNode,
+ {bool allowRelative = false}) {
+ if (executableNode == null || executableNode.value == null) return null;
+ if (executableNode.value is! String) {
+ throw SourceSpanFormatException('Must be a string.', executableNode.span);
+ }
+ if (!allowRelative) _assertNotRelative(executableNode as YamlScalar);
+ return executableNode.value as String;
+ }
+
+ /// Throws a [SourceSpanFormatException] if [executableNode]'s value is a
+ /// relative POSIX path that's not just a plain basename.
+ ///
+ /// We loop up basenames on the PATH and we can resolve absolute paths, but we
+ /// have no way of interpreting relative paths.
+ static void _assertNotRelative(YamlScalar executableNode) {
+ var executable = executableNode.value as String;
+ if (!p.posix.isRelative(executable)) return;
+ if (p.posix.basename(executable) == executable) return;
+
+ throw SourceSpanFormatException(
+ 'Linux and Mac OS executables may not be relative paths.',
+ executableNode.span);
+ }
+
+ ExecutableSettings(
+ {Iterable<String>? arguments,
+ String? linuxExecutable,
+ String? macOSExecutable,
+ List<String>? macOSExecutables,
+ String? windowsExecutable,
+ String? environmentOverride,
+ bool? headless})
+ : arguments = arguments == null ? const [] : List.unmodifiable(arguments),
+ _linuxExecutable = linuxExecutable,
+ _macOSExectuables =
+ _normalizeMacExecutable(macOSExecutable, macOSExecutables),
+ _windowsExecutable = windowsExecutable,
+ _environmentOverride = environmentOverride,
+ _headless = headless;
+
+ /// Merges [this] with [other], with [other]'s settings taking priority.
+ ExecutableSettings merge(ExecutableSettings other) => ExecutableSettings(
+ arguments: arguments.toList()..addAll(other.arguments),
+ headless: other._headless ?? _headless,
+ linuxExecutable: other._linuxExecutable ?? _linuxExecutable,
+ macOSExecutables: other._macOSExectuables ?? _macOSExectuables,
+ windowsExecutable: other._windowsExecutable ?? _windowsExecutable);
+}
+
+List<String>? _normalizeMacExecutable(
+ String? singleArgument, List<String>? listArgument) {
+ if (listArgument != null) return listArgument;
+ if (singleArgument != null) return [singleArgument];
+ return null;
+}
diff --git a/pkgs/test/lib/src/runner/node/platform.dart b/pkgs/test/lib/src/runner/node/platform.dart
new file mode 100644
index 0000000..16cd9c6
--- /dev/null
+++ b/pkgs/test/lib/src/runner/node/platform.dart
@@ -0,0 +1,380 @@
+// Copyright (c) 2017, 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 'dart:convert';
+import 'dart:io';
+
+import 'package:async/async.dart';
+import 'package:node_preamble/preamble.dart' as preamble;
+import 'package:package_config/package_config.dart';
+import 'package:path/path.dart' as p;
+import 'package:stream_channel/stream_channel.dart';
+import 'package:test_api/backend.dart'
+ show Compiler, Runtime, StackTraceMapper, SuitePlatform;
+import 'package:test_core/src/runner/application_exception.dart'; // ignore: implementation_imports
+import 'package:test_core/src/runner/configuration.dart'; // ignore: implementation_imports
+import 'package:test_core/src/runner/dart2js_compiler_pool.dart'; // ignore: implementation_imports
+import 'package:test_core/src/runner/load_exception.dart'; // ignore: implementation_imports
+import 'package:test_core/src/runner/package_version.dart'; // ignore: implementation_imports
+import 'package:test_core/src/runner/platform.dart'; // ignore: implementation_imports
+import 'package:test_core/src/runner/plugin/customizable_platform.dart'; // ignore: implementation_imports
+import 'package:test_core/src/runner/plugin/environment.dart'; // ignore: implementation_imports
+import 'package:test_core/src/runner/plugin/platform_helpers.dart'; // ignore: implementation_imports
+import 'package:test_core/src/runner/runner_suite.dart'; // ignore: implementation_imports
+import 'package:test_core/src/runner/suite.dart'; // ignore: implementation_imports
+import 'package:test_core/src/runner/wasm_compiler_pool.dart'; // ignore: implementation_imports
+import 'package:test_core/src/util/errors.dart'; // ignore: implementation_imports
+import 'package:test_core/src/util/io.dart'; // ignore: implementation_imports
+import 'package:test_core/src/util/package_config.dart'; // ignore: implementation_imports
+import 'package:test_core/src/util/stack_trace_mapper.dart'; // ignore: implementation_imports
+import 'package:yaml/yaml.dart';
+
+import '../../util/package_map.dart';
+import '../executable_settings.dart';
+
+/// A platform that loads tests in Node.js processes.
+class NodePlatform extends PlatformPlugin
+ implements CustomizablePlatform<ExecutableSettings> {
+ /// The test runner configuration.
+ final Configuration _config;
+
+ /// The [Dart2JsCompilerPool] managing active instances of `dart2js`.
+ final _jsCompilers = Dart2JsCompilerPool(['-Dnode=true', '--server-mode']);
+ final _wasmCompilers = WasmCompilerPool(['-Dnode=true']);
+
+ /// The temporary directory in which compiled JS is emitted.
+ final _compiledDir = createTempDir();
+
+ /// Executable settings for [Runtime.nodeJS] and runtimes that extend
+ /// it.
+ final _settings = {
+ Runtime.nodeJS: ExecutableSettings(
+ linuxExecutable: 'node',
+ macOSExecutable: 'node',
+ windowsExecutable: 'node.exe')
+ };
+
+ NodePlatform() : _config = Configuration.current;
+
+ @override
+ ExecutableSettings parsePlatformSettings(YamlMap settings) =>
+ ExecutableSettings.parse(settings);
+
+ @override
+ ExecutableSettings mergePlatformSettings(
+ ExecutableSettings settings1, ExecutableSettings settings2) =>
+ settings1.merge(settings2);
+
+ @override
+ void customizePlatform(Runtime runtime, ExecutableSettings settings) {
+ var oldSettings = _settings[runtime] ?? _settings[runtime.root];
+ if (oldSettings != null) settings = oldSettings.merge(settings);
+ _settings[runtime] = settings;
+ }
+
+ @override
+ Future<RunnerSuite> load(String path, SuitePlatform platform,
+ SuiteConfiguration suiteConfig, Map<String, Object?> message) async {
+ if (platform.compiler != Compiler.dart2js &&
+ platform.compiler != Compiler.dart2wasm) {
+ throw StateError(
+ 'Unsupported compiler for the Node platform ${platform.compiler}.');
+ }
+ var (channel, stackMapper) =
+ await _loadChannel(path, platform, suiteConfig);
+ var controller = deserializeSuite(path, platform, suiteConfig,
+ const PluginEnvironment(), channel, message);
+
+ controller.channel('test.node.mapper').sink.add(stackMapper?.serialize());
+
+ return await controller.suite;
+ }
+
+ /// Loads a [StreamChannel] communicating with the test suite at [path].
+ ///
+ /// Returns that channel along with a [StackTraceMapper] representing the
+ /// source map for the compiled suite.
+ Future<(StreamChannel<Object?>, StackTraceMapper?)> _loadChannel(String path,
+ SuitePlatform platform, SuiteConfiguration suiteConfig) async {
+ final servers = await _loopback();
+
+ try {
+ var (process, stackMapper) =
+ await _spawnProcess(path, platform, suiteConfig, servers.first.port);
+
+ // Forward Node's standard IO to the print handler so it's associated with
+ // the load test.
+ //
+ // TODO(nweiz): Associate this with the current test being run, if any.
+ process.stdout.transform(lineSplitter).listen(print);
+ process.stderr.transform(lineSplitter).listen(print);
+
+ // Wait for the first connection (either over ipv4 or v6). If the proccess
+ // exits before it connects, throw instead of waiting for a connection
+ // indefinitely.
+ var socket = await Future.any([
+ StreamGroup.merge(servers).first,
+ process.exitCode.then((_) => null),
+ ]);
+
+ if (socket == null) {
+ throw LoadException(
+ path, 'Node exited before connecting to the test channel.');
+ }
+
+ var channel = StreamChannel(socket.cast<List<int>>(), socket)
+ .transform(StreamChannelTransformer.fromCodec(utf8))
+ .transform(_chunksToLines)
+ .transform(jsonDocument)
+ .transformStream(StreamTransformer.fromHandlers(handleDone: (sink) {
+ process.kill();
+ sink.close();
+ }));
+
+ return (channel, stackMapper);
+ } finally {
+ unawaited(Future.wait<void>(servers.map((s) =>
+ s.close().then<ServerSocket?>((v) => v).onError((_, __) => null))));
+ }
+ }
+
+ /// Spawns a Node.js process that loads the Dart test suite at [path].
+ ///
+ /// Returns that channel along with a [StackTraceMapper] representing the
+ /// source map for the compiled suite.
+ Future<(Process, StackTraceMapper?)> _spawnProcess(
+ String path,
+ SuitePlatform platform,
+ SuiteConfiguration suiteConfig,
+ int socketPort) async {
+ if (_config.suiteDefaults.precompiledPath != null) {
+ return _spawnPrecompiledProcess(path, platform.runtime, suiteConfig,
+ socketPort, _config.suiteDefaults.precompiledPath!);
+ } else {
+ return switch (platform.compiler) {
+ Compiler.dart2js => _spawnNormalJsProcess(
+ path, platform.runtime, suiteConfig, socketPort),
+ Compiler.dart2wasm => _spawnNormalWasmProcess(
+ path, platform.runtime, suiteConfig, socketPort),
+ _ => throw StateError('Unsupported compiler ${platform.compiler}'),
+ };
+ }
+ }
+
+ Future<String> _entrypointScriptForTest(
+ String testPath, SuiteConfiguration suiteConfig) async {
+ return '''
+ ${suiteConfig.metadata.languageVersionComment ?? await rootPackageLanguageVersionComment}
+ import "package:test/src/bootstrap/node.dart";
+
+ import "${p.toUri(p.absolute(testPath))}" as test;
+
+ void main() {
+ internalBootstrapNodeTest(() => test.main);
+ }
+ ''';
+ }
+
+ /// Compiles [testPath] with dart2js, adds the node preamble, and then spawns
+ /// a Node.js process that loads that Dart test suite.
+ Future<(Process, StackTraceMapper?)> _spawnNormalJsProcess(String testPath,
+ Runtime runtime, SuiteConfiguration suiteConfig, int socketPort) async {
+ var dir = Directory(_compiledDir).createTempSync('test_').path;
+ var jsPath = p.join(dir, '${p.basename(testPath)}.node_test.dart.js');
+ await _jsCompilers.compile(
+ await _entrypointScriptForTest(testPath, suiteConfig),
+ jsPath,
+ suiteConfig,
+ );
+
+ // Add the Node.js preamble to ensure that the dart2js output is
+ // compatible. Use the minified version so the source map remains valid.
+ var jsFile = File(jsPath);
+ await jsFile.writeAsString(
+ preamble.getPreamble(minified: true) + await jsFile.readAsString());
+
+ StackTraceMapper? mapper;
+ if (!suiteConfig.jsTrace) {
+ var mapPath = '$jsPath.map';
+ mapper = JSStackTraceMapper(await File(mapPath).readAsString(),
+ mapUrl: p.toUri(mapPath),
+ sdkRoot: Uri.parse('org-dartlang-sdk:///sdk'),
+ packageMap: (await currentPackageConfig).toPackageMap());
+ }
+
+ return (await _startProcess(runtime, jsPath, socketPort), mapper);
+ }
+
+ /// Compiles [testPath] with dart2wasm, adds a JS entrypoint and then spawns
+ /// a Node.js process loading the compiled test suite.
+ Future<(Process, StackTraceMapper?)> _spawnNormalWasmProcess(String testPath,
+ Runtime runtime, SuiteConfiguration suiteConfig, int socketPort) async {
+ var dir = Directory(_compiledDir).createTempSync('test_').path;
+ // dart2wasm will emit a .wasm file and a .mjs file responsible for loading
+ // that file.
+ var wasmPath = p.join(dir, '${p.basename(testPath)}.node_test.dart.wasm');
+ var loader = '${p.basename(testPath)}.node_test.dart.wasm.mjs';
+
+ // We need to create an additional entrypoint file loading the wasm module.
+ var jsPath = p.join(dir, '${p.basename(testPath)}.node_test.dart.js');
+
+ await _wasmCompilers.compile(
+ await _entrypointScriptForTest(testPath, suiteConfig),
+ wasmPath,
+ suiteConfig,
+ );
+
+ await File(jsPath).writeAsString('''
+const { createReadStream } = require('fs');
+const { once } = require('events');
+const { PassThrough } = require('stream');
+
+const main = async () => {
+ const { instantiate, invoke } = await import("./$loader");
+
+ const wasmContents = createReadStream("$wasmPath.wasm");
+ const stream = new PassThrough();
+ wasmContents.pipe(stream);
+
+ await once(wasmContents, 'open');
+ const response = new Response(
+ stream,
+ {
+ headers: {
+ "Content-Type": "application/wasm"
+ }
+ }
+ );
+ const instancePromise = WebAssembly.compileStreaming(response);
+ const module = await instantiate(instancePromise, {});
+ invoke(module);
+};
+
+main();
+''');
+
+ return (await _startProcess(runtime, jsPath, socketPort), null);
+ }
+
+ /// Spawns a Node.js process that loads the Dart test suite at [testPath]
+ /// under [precompiledPath].
+ Future<(Process, StackTraceMapper?)> _spawnPrecompiledProcess(
+ String testPath,
+ Runtime runtime,
+ SuiteConfiguration suiteConfig,
+ int socketPort,
+ String precompiledPath) async {
+ StackTraceMapper? mapper;
+ var jsPath = p.join(precompiledPath, '$testPath.node_test.dart.js');
+ if (!suiteConfig.jsTrace) {
+ var mapPath = '$jsPath.map';
+ mapper = JSStackTraceMapper(await File(mapPath).readAsString(),
+ mapUrl: p.toUri(mapPath),
+ sdkRoot: Uri.parse('org-dartlang-sdk:///sdk'),
+ packageMap: (await findPackageConfig(Directory(precompiledPath)))!
+ .toPackageMap());
+ }
+
+ return (await _startProcess(runtime, jsPath, socketPort), mapper);
+ }
+
+ /// Starts the Node.js process for [runtime] with [jsPath].
+ Future<Process> _startProcess(
+ Runtime runtime, String jsPath, int socketPort) async {
+ var settings = _settings[runtime]!;
+
+ var nodeModules = p.absolute('node_modules');
+ var nodePath = Platform.environment['NODE_PATH'];
+ nodePath = nodePath == null ? nodeModules : '$nodePath:$nodeModules';
+
+ try {
+ return await Process.start(
+ settings.executable,
+ settings.arguments.toList()
+ ..add(jsPath)
+ ..add(socketPort.toString()),
+ environment: {'NODE_PATH': nodePath});
+ } catch (error, stackTrace) {
+ await Future<Never>.error(
+ ApplicationException(
+ 'Failed to run ${runtime.name}: ${getErrorMessage(error)}'),
+ stackTrace);
+ }
+ }
+
+ @override
+ Future<void> close() => _closeMemo.runOnce(() async {
+ await _jsCompilers.close();
+ await _wasmCompilers.close();
+ await Directory(_compiledDir).deleteWithRetry();
+ });
+ final _closeMemo = AsyncMemoizer<void>();
+}
+
+Future<List<ServerSocket>> _loopback({int remainingRetries = 5}) async {
+ if (!await _supportsIPv4) {
+ return [await ServerSocket.bind(InternetAddress.loopbackIPv6, 0)];
+ }
+
+ var v4Server = await ServerSocket.bind(InternetAddress.loopbackIPv4, 0);
+ if (!await _supportsIPv6) return [v4Server];
+
+ try {
+ // Reuse the IPv4 server's port so that if [port] is 0, both servers use
+ // the same ephemeral port.
+ var v6Server =
+ await ServerSocket.bind(InternetAddress.loopbackIPv6, v4Server.port);
+ return [v4Server, v6Server];
+ } on SocketException catch (error) {
+ if (error.osError?.errorCode != _addressInUseErrno) rethrow;
+ if (remainingRetries == 0) rethrow;
+
+ // A port being available on IPv4 doesn't necessarily mean that the same
+ // port is available on IPv6. If it's not (which is rare in practice),
+ // we try again until we find one that's available on both.
+ unawaited(v4Server.close());
+ return await _loopback(remainingRetries: remainingRetries - 1);
+ }
+}
+
+/// Whether this computer supports binding to IPv6 addresses.
+final Future<bool> _supportsIPv6 = () async {
+ try {
+ var socket = await ServerSocket.bind(InternetAddress.loopbackIPv6, 0);
+ unawaited(socket.close());
+ return true;
+ } on SocketException catch (_) {
+ return false;
+ }
+}();
+
+/// Whether this computer supports binding to IPv4 addresses.
+final Future<bool> _supportsIPv4 = () async {
+ try {
+ var socket = await ServerSocket.bind(InternetAddress.loopbackIPv4, 0);
+ unawaited(socket.close());
+ return true;
+ } on SocketException catch (_) {
+ return false;
+ }
+}();
+
+/// The error code for an error caused by a port already being in use.
+final int _addressInUseErrno = () {
+ if (Platform.isWindows) return 10048;
+ if (Platform.isMacOS) return 48;
+ assert(Platform.isLinux);
+ return 98;
+}();
+
+/// A [StreamChannelTransformer] that converts a chunked string channel to a
+/// line-by-line channel.
+///
+/// Note that this is only safe for channels whose messages are guaranteed not
+/// to contain newlines.
+final _chunksToLines = StreamChannelTransformer<String, String>(
+ const LineSplitter(),
+ StreamSinkTransformer.fromHandlers(
+ handleData: (data, sink) => sink.add('$data\n')));
diff --git a/pkgs/test/lib/src/runner/node/socket_channel.dart b/pkgs/test/lib/src/runner/node/socket_channel.dart
new file mode 100644
index 0000000..95e81de
--- /dev/null
+++ b/pkgs/test/lib/src/runner/node/socket_channel.dart
@@ -0,0 +1,43 @@
+// Copyright (c) 2017, 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 'dart:convert';
+import 'dart:js_interop';
+
+import 'package:stream_channel/stream_channel.dart';
+
+@JS('process.argv')
+external JSArray<JSString> get _args;
+
+extension type _Net._(JSObject _) {
+ external _Socket connect(int port);
+}
+
+extension type _Socket._(JSObject _) {
+ external void setEncoding(JSString encoding);
+ external void on(JSString event, JSFunction callback);
+ external void write(JSString data);
+}
+
+/// Returns a [StreamChannel] of JSON-encodable objects that communicates over a
+/// socket whose port is given by `process.argv[2]`.
+Future<StreamChannel<Object?>> socketChannel() async {
+ final net = (await importModule('node:net'.toJS).toDart) as _Net;
+
+ var socket = net.connect(int.parse(_args.toDart[2].toDart));
+ socket.setEncoding('utf8'.toJS);
+
+ var socketSink = StreamController<Object?>(sync: true)
+ ..stream.listen((event) => socket.write('${jsonEncode(event)}\n'.toJS));
+
+ var socketStream = StreamController<String>(sync: true);
+ socket.on(
+ 'data'.toJS,
+ ((JSString chunk) => socketStream.add(chunk.toDart)).toJS,
+ );
+
+ return StreamChannel.withCloseGuarantee(
+ socketStream.stream.transform(const LineSplitter()).map(jsonDecode),
+ socketSink);
+}
diff --git a/pkgs/test/lib/src/util/math.dart b/pkgs/test/lib/src/util/math.dart
new file mode 100644
index 0000000..d6bbbc7
--- /dev/null
+++ b/pkgs/test/lib/src/util/math.dart
@@ -0,0 +1,20 @@
+// Copyright (c) 2021, 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:math' as math;
+
+final _rand = math.Random();
+
+/// Returns a random 32 character alphanumeric string ([a-zA-Z0-9]), which is
+/// suitable as a url secret.
+String randomUrlSecret() {
+ var buffer = StringBuffer();
+ while (buffer.length < 32) {
+ buffer.write(_alphaChars[_rand.nextInt(_alphaChars.length)]);
+ }
+ return buffer.toString();
+}
+
+const _alphaChars =
+ '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz';
diff --git a/pkgs/test/lib/src/util/one_off_handler.dart b/pkgs/test/lib/src/util/one_off_handler.dart
new file mode 100644
index 0000000..7667df3
--- /dev/null
+++ b/pkgs/test/lib/src/util/one_off_handler.dart
@@ -0,0 +1,46 @@
+// Copyright (c) 2015, 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:path/path.dart' as p;
+import 'package:shelf/shelf.dart' as shelf;
+
+/// A Shelf handler that provides support for one-time handlers.
+///
+/// This is useful for handlers that only expect to be hit once before becoming
+/// invalid and don't need to have a persistent URL.
+class OneOffHandler {
+ /// A map from URL paths to handlers.
+ final _handlers = <String, shelf.Handler>{};
+
+ /// The counter of handlers that have been activated.
+ var _counter = 0;
+
+ /// The actual [shelf.Handler] that dispatches requests.
+ shelf.Handler get handler => _onRequest;
+
+ /// Creates a new one-off handler that forwards to [handler].
+ ///
+ /// Returns a string that's the URL path for hitting this handler, relative to
+ /// the URL for the one-off handler itself.
+ ///
+ /// [handler] will be unmounted as soon as it receives a request.
+ String create(shelf.Handler handler) {
+ var path = _counter.toString();
+ _handlers[path] = handler;
+ _counter++;
+ return path;
+ }
+
+ /// Dispatches [request] to the appropriate handler.
+ FutureOr<shelf.Response> _onRequest(shelf.Request request) {
+ var components = p.url.split(request.url.path);
+ if (components.isEmpty) return shelf.Response.notFound(null);
+
+ var path = components.removeAt(0);
+ var handler = _handlers.remove(path);
+ if (handler == null) return shelf.Response.notFound(null);
+ return handler(request.change(path: path));
+ }
+}
diff --git a/pkgs/test/lib/src/util/package_map.dart b/pkgs/test/lib/src/util/package_map.dart
new file mode 100644
index 0000000..6b30afa
--- /dev/null
+++ b/pkgs/test/lib/src/util/package_map.dart
@@ -0,0 +1,19 @@
+// Copyright (c) 2020, 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 'package:package_config/package_config.dart';
+
+/// Adds methods to convert to a package map on [PackageConfig].
+extension PackageMap on PackageConfig {
+ /// A package map exactly matching the current package config
+ Map<String, Uri> toPackageMap() =>
+ {for (var package in packages) package.name: package.packageUriRoot};
+
+ /// A package map with all the current packages but where the uris are all
+ /// of the form 'packages/${package.name}'.
+ Map<String, Uri> toPackagesDirPackageMap() => {
+ for (var package in packages)
+ package.name: Uri.parse('packages/${package.name}')
+ };
+}
diff --git a/pkgs/test/lib/src/util/path_handler.dart b/pkgs/test/lib/src/util/path_handler.dart
new file mode 100644
index 0000000..10a8c4e
--- /dev/null
+++ b/pkgs/test/lib/src/util/path_handler.dart
@@ -0,0 +1,62 @@
+// Copyright (c) 2015, 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:path/path.dart' as p;
+import 'package:shelf/shelf.dart' as shelf;
+
+/// A handler that routes to sub-handlers based on exact path prefixes.
+class PathHandler {
+ /// A trie of path components to handlers.
+ final _paths = _Node();
+
+ /// The shelf handler.
+ shelf.Handler get handler => _onRequest;
+
+ /// Returns middleware that nests all requests beneath the URL prefix
+ /// [beneath].
+ static shelf.Middleware nestedIn(String beneath) {
+ return (handler) {
+ var pathHandler = PathHandler()..add(beneath, handler);
+ return pathHandler.handler;
+ };
+ }
+
+ /// Routes requests at or under [path] to [handler].
+ ///
+ /// If [path] is a parent or child directory of another path in this handler,
+ /// the longest matching prefix wins.
+ void add(String path, shelf.Handler handler) {
+ var node = _paths;
+ for (var component in p.url.split(path)) {
+ node = node.children.putIfAbsent(component, _Node.new);
+ }
+ node.handler = handler;
+ }
+
+ FutureOr<shelf.Response> _onRequest(shelf.Request request) {
+ shelf.Handler? handler;
+ int? handlerIndex;
+ _Node? node = _paths;
+ var components = p.url.split(request.url.path);
+ for (var i = 0; i < components.length; i++) {
+ node = node!.children[components[i]];
+ if (node == null) break;
+ if (node.handler == null) continue;
+ handler = node.handler;
+ handlerIndex = i;
+ }
+
+ if (handler == null) return shelf.Response.notFound('Not found.');
+
+ return handler(request.change(
+ path: p.url.joinAll(components.take(handlerIndex! + 1))));
+ }
+}
+
+/// A trie node.
+class _Node {
+ shelf.Handler? handler;
+ final children = <String, _Node>{};
+}
diff --git a/pkgs/test/lib/test.dart b/pkgs/test/lib/test.dart
new file mode 100644
index 0000000..7bcc673
--- /dev/null
+++ b/pkgs/test/lib/test.dart
@@ -0,0 +1,15 @@
+// Copyright (c) 2013, 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.
+
+export 'package:matcher/expect.dart';
+// Deprecated exports not surfaced through focused libraries.
+// ignore: deprecated_member_use
+export 'package:matcher/src/expect/expect.dart' show ErrorFormatter;
+// ignore: deprecated_member_use
+export 'package:matcher/src/expect/expect_async.dart' show expectAsync;
+// ignore: deprecated_member_use
+export 'package:matcher/src/expect/throws_matcher.dart' show Throws, throws;
+// The non-deprecated API (through a deprecated import).
+// ignore: deprecated_member_use
+export 'package:test_core/test_core.dart';
diff --git a/pkgs/test/mono_pkg.yaml b/pkgs/test/mono_pkg.yaml
new file mode 100644
index 0000000..2aaa4f9
--- /dev/null
+++ b/pkgs/test/mono_pkg.yaml
@@ -0,0 +1,51 @@
+# See https://pub.dev/packages/mono_repo
+
+sdk:
+- dev
+- pubspec
+
+stages:
+- analyze_and_format:
+ - group:
+ - format
+ - analyze: --fatal-infos
+ sdk:
+ - dev
+ os:
+ - linux
+- unit_test:
+ - command: xvfb-run -s "-screen 0 1024x768x24" dart test --preset travis --total-shards 5 --shard-index 0
+ - command: xvfb-run -s "-screen 0 1024x768x24" dart test --preset travis --total-shards 5 --shard-index 1
+ - command: xvfb-run -s "-screen 0 1024x768x24" dart test --preset travis --total-shards 5 --shard-index 2
+ - command: xvfb-run -s "-screen 0 1024x768x24" dart test --preset travis --total-shards 5 --shard-index 3
+ - command: xvfb-run -s "-screen 0 1024x768x24" dart test --preset travis --total-shards 5 --shard-index 4
+ - command: dart test --preset travis --total-shards 5 --shard-index 0
+ os:
+ - windows
+ - osx
+ sdk:
+ - pubspec
+ - command: dart test --preset travis --total-shards 5 --shard-index 1
+ os:
+ - windows
+ - osx
+ sdk:
+ - pubspec
+ - command: dart test --preset travis --total-shards 5 --shard-index 2
+ os:
+ - windows
+ - osx
+ sdk:
+ - pubspec
+ - command: dart test --preset travis --total-shards 5 --shard-index 3
+ os:
+ - windows
+ - osx
+ sdk:
+ - pubspec
+ - command: dart test --preset travis --total-shards 5 --shard-index 4
+ os:
+ - windows
+ - osx
+ sdk:
+ - pubspec
diff --git a/pkgs/test/pubspec.yaml b/pkgs/test/pubspec.yaml
new file mode 100644
index 0000000..0ab65ad
--- /dev/null
+++ b/pkgs/test/pubspec.yaml
@@ -0,0 +1,53 @@
+name: test
+version: 1.25.12
+description: >-
+ A full featured library for writing and running Dart tests across platforms.
+repository: https://github.com/dart-lang/test/tree/master/pkgs/test
+resolution: workspace
+
+environment:
+ sdk: ^3.5.0
+
+dependencies:
+ analyzer: '>=6.0.0 <8.0.0'
+ async: ^2.5.0
+ boolean_selector: ^2.1.0
+ collection: ^1.15.0
+ coverage: ^1.0.1
+ http_multi_server: ^3.0.0
+ io: ^1.0.0
+ js: '>=0.6.4 <0.8.0'
+
+ # Use a tight version constraint to ensure that a constraint on matcher
+ # properly constrains all features it provides.
+ matcher: '>=0.12.16 <0.12.17'
+
+ node_preamble: ^2.0.0
+ package_config: ^2.0.0
+ path: ^1.8.0
+ pool: ^1.5.0
+ shelf: ^1.0.0
+ shelf_packages_handler: ^3.0.0
+ shelf_static: ^1.0.0
+ shelf_web_socket: '>=1.0.0 <3.0.0'
+ source_span: ^1.8.0
+ stack_trace: ^1.10.0
+ stream_channel: ^2.1.0
+
+ # Use an exact version until the test_api and test_core package are stable.
+ test_api: 0.7.4
+ test_core: 0.6.8
+
+ typed_data: ^1.3.0
+ web_socket_channel: '>=2.0.0 <4.0.0'
+ webkit_inspection_protocol: ^1.0.0
+ yaml: ^3.0.0
+
+dev_dependencies:
+ fake_async: ^1.0.0
+ glob: ^2.0.0
+ test_descriptor: ^2.0.0
+ test_process: ^2.0.0
+
+topics:
+ - testing
diff --git a/pkgs/test/test/common.dart b/pkgs/test/test/common.dart
new file mode 100644
index 0000000..1cad23f
--- /dev/null
+++ b/pkgs/test/test/common.dart
@@ -0,0 +1,6 @@
+// Copyright (c) 2020, 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 'package:test/test.dart';
+
+void myTest(String name, void Function() testFn) => test(name, testFn);
diff --git a/pkgs/test/test/io.dart b/pkgs/test/test/io.dart
new file mode 100644
index 0000000..b13f8bd
--- /dev/null
+++ b/pkgs/test/test/io.dart
@@ -0,0 +1,158 @@
+// Copyright (c) 2015, 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 'dart:io';
+import 'dart:isolate';
+
+import 'package:path/path.dart' as p;
+import 'package:test/test.dart';
+import 'package:test_descriptor/test_descriptor.dart' as d;
+import 'package:test_process/test_process.dart';
+
+/// The path to the root directory of the `test` package.
+final Future<String> packageDir =
+ Isolate.resolvePackageUri(Uri(scheme: 'package', path: 'test/'))
+ .then((uri) {
+ var dir = p.dirname(uri!.path);
+ // If it starts with a `/C:` or other drive letter, remove the leading `/`.
+ if (dir[0] == '/' && dir[2] == ':') dir = dir.substring(1);
+ return dir;
+});
+
+/// The path to the `pub` executable in the current Dart SDK.
+final _pubPath = p.absolute(p.join(p.dirname(Platform.resolvedExecutable),
+ Platform.isWindows ? 'pub.bat' : 'pub'));
+
+/// The platform-specific message emitted when a nonexistent file is loaded.
+final String noSuchFileMessage = Platform.isWindows
+ ? 'The system cannot find the file specified.'
+ : 'No such file or directory';
+
+/// An operating system name that's different than the current operating system.
+final otherOS = Platform.isWindows ? 'mac-os' : 'windows';
+
+/// Expects that the entire stdout stream of [test] equals [expected].
+void expectStdoutEquals(TestProcess test, String expected) =>
+ _expectStreamEquals(test.stdoutStream(), expected);
+
+/// Expects that the entire stderr stream of [test] equals [expected].
+void expectStderrEquals(TestProcess test, String expected) =>
+ _expectStreamEquals(test.stderrStream(), expected);
+
+/// Expects that the entirety of the line stream [stream] equals [expected].
+void _expectStreamEquals(Stream<String> stream, String expected) {
+ expect((() async {
+ var lines = await stream.toList();
+ expect(lines.join('\n').trim(), equals(expected.trim()));
+ })(), completes);
+}
+
+/// Returns a [StreamMatcher] that asserts that the stream emits strings
+/// containing each string in [strings] in order.
+///
+/// This expects each string in [strings] to match a different string in the
+/// stream.
+StreamMatcher containsInOrder(Iterable<String> strings) =>
+ emitsInOrder(strings.map((string) => emitsThrough(contains(string))));
+
+/// Lazily compile the test package to kernel and re-use that, initialized with
+/// [precompileTestExecutable].
+String? _testExecutablePath;
+
+/// Must be invoked before any call to [runTests], should be invoked in a top
+/// level `setUpAll` for best caching results.
+Future<void> precompileTestExecutable() async {
+ if (_testExecutablePath != null) {
+ throw StateError('Test executable already precompiled');
+ }
+ var tmpDirectory = await Directory.systemTemp.createTemp('test');
+ var precompiledPath = p.join(tmpDirectory.path, 'test_runner.dill');
+ var result = await Process.run(Platform.executable, [
+ 'compile',
+ 'kernel',
+ p.url.join(await packageDir, 'bin', 'test.dart'),
+ '-o',
+ precompiledPath,
+ ]);
+ if (result.exitCode != 0) {
+ throw StateError(
+ 'Failed to compile test runner:\n${result.stdout}\n${result.stderr}');
+ }
+
+ addTearDown(() async {
+ await tmpDirectory.delete(recursive: true);
+ });
+ _testExecutablePath = precompiledPath;
+}
+
+/// Runs the test executable with the package root set properly.
+///
+/// You must invoke [precompileTestExecutable] before invoking this function.
+Future<TestProcess> runTest(Iterable<String> args,
+ {String? reporter,
+ String? fileReporter,
+ int? concurrency,
+ Map<String, String>? environment,
+ bool forwardStdio = false,
+ String? packageConfig,
+ Iterable<String>? vmArgs}) async {
+ concurrency ??= 1;
+ var testExecutablePath = _testExecutablePath;
+ if (testExecutablePath == null) {
+ throw StateError(
+ 'You must call `precompileTestExecutable` before calling `runTest`');
+ }
+
+ var allArgs = [
+ ...?vmArgs,
+ testExecutablePath,
+ '--concurrency=$concurrency',
+ if (reporter != null) '--reporter=$reporter',
+ if (fileReporter != null) '--file-reporter=$fileReporter',
+ ...args,
+ ];
+
+ environment ??= {};
+ environment.putIfAbsent('_DART_TEST_TESTING', () => 'true');
+
+ return await runDart(allArgs,
+ environment: environment,
+ description: 'dart bin/test.dart',
+ forwardStdio: forwardStdio,
+ packageConfig: packageConfig);
+}
+
+/// Runs Dart.
+///
+/// If [packageConfig] is provided then that is passed for the `--packages`
+/// arg, otherwise the current isolate config is passed.
+Future<TestProcess> runDart(Iterable<String> args,
+ {Map<String, String>? environment,
+ String? description,
+ bool forwardStdio = false,
+ String? packageConfig}) async {
+ var allArgs = <String>[
+ ...Platform.executableArguments.where((arg) =>
+ !arg.startsWith('--package-root=') && !arg.startsWith('--packages=')),
+ '--packages=${packageConfig ?? await Isolate.packageConfig}',
+ ...args
+ ];
+
+ return await TestProcess.start(
+ p.absolute(Platform.resolvedExecutable), allArgs,
+ workingDirectory: d.sandbox,
+ environment: environment,
+ description: description,
+ forwardStdio: forwardStdio);
+}
+
+/// Runs Pub.
+Future<TestProcess> runPub(Iterable<String> args,
+ {Map<String, String>? environment}) {
+ return TestProcess.start(_pubPath, args,
+ workingDirectory: d.sandbox,
+ environment: environment,
+ description: 'pub ${args.first}');
+}
diff --git a/pkgs/test/test/runner/browser/chrome_test.dart b/pkgs/test/test/runner/browser/chrome_test.dart
new file mode 100644
index 0000000..ffec227
--- /dev/null
+++ b/pkgs/test/test/runner/browser/chrome_test.dart
@@ -0,0 +1,100 @@
+// Copyright (c) 2015, 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.
+
+@TestOn('vm')
+@Tags(['chrome'])
+library;
+
+import 'package:test/src/runner/browser/chrome.dart';
+import 'package:test/src/runner/executable_settings.dart';
+import 'package:test/test.dart';
+import 'package:test_descriptor/test_descriptor.dart' as d;
+
+import '../../io.dart';
+import '../../utils.dart';
+import 'code_server.dart';
+
+void main() {
+ setUpAll(precompileTestExecutable);
+
+ test('starts Chrome with the given URL', () async {
+ var server = await CodeServer.start();
+
+ server.handleJavaScript('''
+var webSocket = new WebSocket(window.location.href.replace("http://", "ws://"));
+webSocket.addEventListener("open", function() {
+ webSocket.send("loaded!");
+});
+''');
+ var webSocket = server.handleWebSocket();
+
+ var chrome = Chrome(server.url, configuration());
+ addTearDown(() => chrome.close());
+
+ expect(await (await webSocket).stream.first, equals('loaded!'));
+ },
+ // It's not clear why, but this test in particular seems to time out
+ // when run in parallel with many other tests.
+ timeout: const Timeout.factor(2));
+
+ test("a process can be killed synchronously after it's started", () async {
+ var server = await CodeServer.start();
+ var chrome = Chrome(server.url, configuration());
+ await chrome.close();
+ });
+
+ test('reports an error in onExit', () {
+ var chrome = Chrome(Uri.https('dart.dev'), configuration(),
+ settings: ExecutableSettings(
+ linuxExecutable: '_does_not_exist',
+ macOSExecutable: '_does_not_exist',
+ windowsExecutable: '_does_not_exist'));
+ expect(
+ chrome.onExit,
+ throwsA(isApplicationException(
+ startsWith('Failed to run Chrome: $noSuchFileMessage'))));
+ });
+
+ test('can run successful tests', () async {
+ await d.file('test.dart', '''
+import 'package:test/test.dart';
+
+void main() {
+ test("success", () {});
+}
+''').create();
+
+ var test = await runTest(['-p', 'chrome', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ test('can run failing tests', () async {
+ await d.file('test.dart', '''
+import 'package:test/test.dart';
+
+void main() {
+ test("failure", () => throw TestFailure("oh no"));
+}
+''').create();
+
+ var test = await runTest(['-p', 'chrome', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains('-1: Some tests failed.')));
+ await test.shouldExit(1);
+ });
+
+ test('can override chrome location with CHROME_EXECUTABLE var', () async {
+ await d.file('test.dart', '''
+import 'package:test/test.dart';
+
+void main() {
+ test("success", () {});
+}
+''').create();
+ var test = await runTest(['-p', 'chrome', 'test.dart'],
+ environment: {'CHROME_EXECUTABLE': '/some/bad/path'});
+ expect(test.stdout, emitsThrough(contains('Failed to run Chrome:')));
+ await test.shouldExit(1);
+ });
+}
diff --git a/pkgs/test/test/runner/browser/code_server.dart b/pkgs/test/test/runner/browser/code_server.dart
new file mode 100644
index 0000000..1aba5de
--- /dev/null
+++ b/pkgs/test/test/runner/browser/code_server.dart
@@ -0,0 +1,145 @@
+// Copyright (c) 2015, 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 'dart:collection';
+
+import 'package:http_multi_server/http_multi_server.dart';
+import 'package:shelf/shelf.dart' as shelf;
+import 'package:shelf/shelf_io.dart' as shelf_io;
+import 'package:shelf_web_socket/shelf_web_socket.dart';
+import 'package:test/test.dart' show TestFailure, printOnFailure;
+import 'package:web_socket_channel/web_socket_channel.dart';
+
+/// A class that serves Dart and/or JS code and receives WebSocket connections.
+class CodeServer {
+ final _Handler _handler;
+
+ /// The URL of the server (including the port).
+ final Uri url;
+
+ static Future<CodeServer> start() async {
+ var server = await HttpMultiServer.loopback(0);
+ var handler = _Handler(Zone.current.handleUncaughtError);
+ shelf_io.serveRequests(server, (request) {
+ if (request.method == 'GET' && request.url.path == 'favicon.ico') {
+ return shelf.Response.notFound(null);
+ } else {
+ return handler(request);
+ }
+ });
+
+ return CodeServer._(handler, Uri.parse('http://localhost:${server.port}'));
+ }
+
+ CodeServer._(this._handler, this.url);
+
+ /// Sets up a handler for the root of the server, "/", that serves a basic
+ /// HTML page with a script tag that will run [javaScript].
+ void handleJavaScript(String javaScript) {
+ _handler.expect('GET', '/', (_) {
+ return shelf.Response.ok('''
+<!doctype html>
+<html>
+<head>
+ <script src="index.js"></script>
+</head>
+</html>
+''', headers: {'content-type': 'text/html'});
+ });
+
+ _handler.expect('GET', '/index.js', (_) {
+ return shelf.Response.ok(javaScript,
+ headers: {'content-type': 'application/javascript'});
+ });
+ }
+
+ /// Handles a WebSocket connection to the root of the server, and returns a
+ /// future that will complete to the WebSocket.
+ Future<WebSocketChannel> handleWebSocket() {
+ var completer = Completer<WebSocketChannel>();
+ // Note: the WebSocketChannel type below is needed for compatibility with
+ // package:shelf_web_socket v2.
+ _handler.expect('GET', '/', webSocketHandler((WebSocketChannel ws, _) {
+ completer.complete(ws);
+ }));
+ return completer.future;
+ }
+}
+
+/// A [shelf.Handler] that handles requests as specified by [expect].
+class _Handler {
+ /// A callback called whenever an unexpected exception is thrown.
+ ///
+ /// This is used over throwing errors directly since the request handler might
+ /// not be running in the same error zone as the test.
+ final void Function(Object, StackTrace) _onError;
+
+ /// The queue of expected requests to this handler.
+ final _expectations = Queue<_Expectation>();
+
+ /// Creates a new handler that handles requests using handlers provided by
+ /// [expect].
+ _Handler(this._onError);
+
+ /// Expects that a single HTTP request with the given [method] and [path] will
+ /// be made to [this].
+ ///
+ /// The [path] should be root-relative; that is, it should start with "/".
+ ///
+ /// When a matching request is made, [handler] is used to handle that request.
+ ///
+ /// If this is called multiple times, the requests are expected to occur in
+ /// the same order.
+ void expect(String method, String path, shelf.Handler handler) {
+ _expectations.add(_Expectation(method, path, handler));
+ }
+
+ /// The implementation of [shelf.Handler].
+ FutureOr<shelf.Response> call(shelf.Request request) async {
+ const description = 'ShelfTesthandler';
+ var requestInfo = '${request.method} /${request.url}';
+ printOnFailure('[$description] $requestInfo');
+
+ try {
+ if (_expectations.isEmpty) {
+ throw TestFailure(
+ '$description received unexpected request $requestInfo.');
+ }
+
+ var expectation = _expectations.removeFirst();
+ if ((expectation.method != null &&
+ expectation.method != request.method) ||
+ (expectation.path != '/${request.url.path}' &&
+ expectation.path != null)) {
+ var message = '$description received unexpected request $requestInfo.';
+ if (expectation.method != null) {
+ message += '\nExpected ${expectation.method} ${expectation.path}.';
+ }
+ throw TestFailure(message);
+ }
+
+ return await expectation.handler(request);
+ } on shelf.HijackException catch (_) {
+ rethrow;
+ } catch (error, stackTrace) {
+ _onError(error, stackTrace);
+ return shelf.Response.internalServerError(body: '$error');
+ }
+ }
+}
+
+/// A single expectation for an HTTP request sent to a [_Handler].
+class _Expectation {
+ /// The expected request method, or [null] if this allows any requests.
+ final String? method;
+
+ /// The expected request path, or [null] if this allows any requests.
+ final String? path;
+
+ /// The handler to use for requests that match this expectation.
+ final shelf.Handler handler;
+
+ _Expectation(this.method, this.path, this.handler);
+}
diff --git a/pkgs/test/test/runner/browser/compact_reporter_test.dart b/pkgs/test/test/runner/browser/compact_reporter_test.dart
new file mode 100644
index 0000000..753ffa1
--- /dev/null
+++ b/pkgs/test/test/runner/browser/compact_reporter_test.dart
@@ -0,0 +1,35 @@
+// Copyright (c) 2015, 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.
+
+@TestOn('vm')
+library;
+
+import 'package:test/test.dart';
+import 'package:test_descriptor/test_descriptor.dart' as d;
+
+import '../../io.dart';
+
+void main() {
+ setUpAll(precompileTestExecutable);
+
+ test('prints the platform name when running on multiple platforms', () async {
+ await d.file('test.dart', '''
+import 'dart:async';
+
+import 'package:path/path.dart' as p;
+import 'package:test/test.dart';
+
+void main() {
+ test("success", () {});
+}
+''').create();
+
+ var test = await runTest(
+ ['-p', 'chrome', '-p', 'vm', '-j', '1', 'test.dart'],
+ reporter: 'compact');
+
+ expect(test.stdout, containsInOrder(['[Chrome, Dart2Js]', '[VM, Kernel]']));
+ await test.shouldExit(0);
+ }, tags: 'chrome');
+}
diff --git a/pkgs/test/test/runner/browser/expanded_reporter_test.dart b/pkgs/test/test/runner/browser/expanded_reporter_test.dart
new file mode 100644
index 0000000..875aaba
--- /dev/null
+++ b/pkgs/test/test/runner/browser/expanded_reporter_test.dart
@@ -0,0 +1,36 @@
+// Copyright (c) 2015, 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.
+
+@TestOn('vm')
+library;
+
+import 'package:test/test.dart';
+import 'package:test_descriptor/test_descriptor.dart' as d;
+
+import '../../io.dart';
+
+void main() {
+ setUpAll(precompileTestExecutable);
+
+ test('prints the platform name when running on multiple platforms', () async {
+ await d.file('test.dart', '''
+import 'dart:async';
+
+import 'package:test/test.dart';
+
+void main() {
+ test("success", () {});
+}
+''').create();
+
+ var test = await runTest([
+ '-r', 'expanded', '-p', 'chrome', '-p', 'vm', '-j', '1', //
+ 'test.dart'
+ ]);
+
+ expect(test.stdoutStream(), emitsThrough(contains('[VM, Kernel]')));
+ expect(test.stdout, emitsThrough(contains('[Chrome, Dart2Js]')));
+ await test.shouldExit(0);
+ }, tags: ['chrome']);
+}
diff --git a/pkgs/test/test/runner/browser/firefox_html_test.dart b/pkgs/test/test/runner/browser/firefox_html_test.dart
new file mode 100644
index 0000000..c9a5302
--- /dev/null
+++ b/pkgs/test/test/runner/browser/firefox_html_test.dart
@@ -0,0 +1,18 @@
+// Copyright (c) 2015, 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.
+
+@TestOn('firefox')
+library;
+
+import 'package:test/src/runner/browser/dom.dart' as dom;
+import 'package:test/test.dart';
+
+void main() {
+ // Regression test for #274. Firefox doesn't compute styles within hidden
+ // iframes (https://bugzilla.mozilla.org/show_bug.cgi?id=548397), so we have
+ // to do some special stuff to make sure tests that care about that work.
+ test('getComputedStyle() works', () {
+ expect(dom.window.getComputedStyle(dom.document.body!), isNotNull);
+ });
+}
diff --git a/pkgs/test/test/runner/browser/firefox_test.dart b/pkgs/test/test/runner/browser/firefox_test.dart
new file mode 100644
index 0000000..864f49c
--- /dev/null
+++ b/pkgs/test/test/runner/browser/firefox_test.dart
@@ -0,0 +1,115 @@
+// Copyright (c) 2015, 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.
+@TestOn('vm')
+@Tags(['firefox'])
+library;
+
+import 'package:test/src/runner/browser/firefox.dart';
+import 'package:test/src/runner/executable_settings.dart';
+import 'package:test/test.dart';
+import 'package:test_descriptor/test_descriptor.dart' as d;
+
+import '../../io.dart';
+import '../../utils.dart';
+import 'code_server.dart';
+
+void main() {
+ setUpAll(precompileTestExecutable);
+
+ test('starts Firefox with the given URL', () async {
+ var server = await CodeServer.start();
+
+ server.handleJavaScript('''
+var webSocket = new WebSocket(window.location.href.replace("http://", "ws://"));
+webSocket.addEventListener("open", function() {
+ webSocket.send("loaded!");
+});
+''');
+ var webSocket = server.handleWebSocket();
+
+ var firefox = Firefox(server.url);
+ addTearDown(() => firefox.close());
+
+ expect(await (await webSocket).stream.first, equals('loaded!'));
+ });
+
+ test("a process can be killed synchronously after it's started", () async {
+ var server = await CodeServer.start();
+
+ var firefox = Firefox(server.url);
+ await firefox.close();
+ });
+
+ test('reports an error in onExit', () {
+ var firefox = Firefox(Uri.https('dart.dev'),
+ settings: ExecutableSettings(
+ linuxExecutable: '_does_not_exist',
+ macOSExecutable: '_does_not_exist',
+ windowsExecutable: '_does_not_exist'));
+ expect(
+ firefox.onExit,
+ throwsA(isApplicationException(
+ startsWith('Failed to run Firefox: $noSuchFileMessage'))));
+ });
+
+ test('can run successful tests', () async {
+ await d.file('test.dart', '''
+import 'package:test/test.dart';
+
+void main() {
+ test("success", () {});
+}
+''').create();
+
+ var test = await runTest(['-p', 'firefox', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ test('can run failing tests', () async {
+ await d.file('test.dart', '''
+import 'package:test/test.dart';
+
+void main() {
+ test("failure", () => throw TestFailure("oh no"));
+}
+''').create();
+
+ var test = await runTest(['-p', 'firefox', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains('-1: Some tests failed.')));
+ await test.shouldExit(1);
+ });
+
+ test('can override firefox location with FIREFOX_EXECUTABLE var', () async {
+ await d.file('test.dart', '''
+import 'package:test/test.dart';
+
+void main() {
+ test("success", () {});
+}
+''').create();
+ var test = await runTest(['-p', 'firefox', 'test.dart'],
+ environment: {'FIREFOX_EXECUTABLE': '/some/bad/path'});
+ expect(test.stdout, emitsThrough(contains('Failed to run Firefox:')));
+ await test.shouldExit(1);
+ });
+
+ test('not impacted by CHROME_EXECUTABLE var', () async {
+ await d.file('test.dart', '''
+import 'dart:html';
+
+import 'package:test/test.dart';
+
+void main() {
+ test("success", () {
+ assert(window.navigator.vendor != 'Google Inc.');
+ });
+}
+''').create();
+ var test = await runTest(['-p', 'firefox', 'test.dart'],
+ environment: {'CHROME_EXECUTABLE': '/some/bad/path'});
+ expect(test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ });
+}
diff --git a/pkgs/test/test/runner/browser/loader_test.dart b/pkgs/test/test/runner/browser/loader_test.dart
new file mode 100644
index 0000000..17cdb9a
--- /dev/null
+++ b/pkgs/test/test/runner/browser/loader_test.dart
@@ -0,0 +1,181 @@
+// Copyright (c) 2015, 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.
+
+@TestOn('vm')
+@Tags(['chrome'])
+library;
+
+import 'dart:io';
+
+import 'package:path/path.dart' as p;
+import 'package:test/src/runner/browser/platform.dart';
+import 'package:test/test.dart';
+import 'package:test_api/src/backend/runtime.dart';
+import 'package:test_api/src/backend/state.dart';
+import 'package:test_api/src/backend/test.dart';
+import 'package:test_core/src/runner/hack_register_platform.dart';
+import 'package:test_core/src/runner/loader.dart';
+import 'package:test_core/src/runner/runner_suite.dart';
+import 'package:test_core/src/runner/runner_test.dart';
+import 'package:test_core/src/runner/runtime_selection.dart';
+import 'package:test_core/src/runner/suite.dart';
+import 'package:test_descriptor/test_descriptor.dart' as d;
+
+import '../../utils.dart';
+
+late Loader _loader;
+
+/// A configuration that loads suites on Chrome.
+final _chrome =
+ SuiteConfiguration.runtimes([RuntimeSelection(Runtime.chrome.identifier)]);
+
+void main() {
+ setUp(() async {
+ // The default loader doesn't have the platforms registered.
+ registerPlatformPlugin([
+ Runtime.chrome,
+ ], () => BrowserPlatform.start(root: d.sandbox));
+
+ _loader = Loader();
+
+ await d.file('a_test.dart', '''
+ import 'dart:async';
+
+ import 'package:test/test.dart';
+
+ void main() {
+ test("success", () {});
+ test("failure", () => throw TestFailure('oh no'));
+ test("error", () => throw 'oh no');
+ }
+ ''').create();
+ });
+
+ tearDown(() => _loader.close());
+
+ group('.loadFile()', () {
+ late RunnerSuite suite;
+ setUp(() async {
+ var suites = await _loader
+ .loadFile(p.join(d.sandbox, 'a_test.dart'), _chrome)
+ .toList();
+
+ expect(suites, hasLength(1));
+ var loadSuite = suites.first;
+ suite = (await loadSuite.getSuite())!;
+ });
+
+ test('returns a suite with the file path and platform', () {
+ expect(suite.path, equals(p.join(d.sandbox, 'a_test.dart')));
+ expect(suite.platform.runtime, equals(Runtime.chrome));
+ expect(suite.platform.compiler, equals(Runtime.chrome.defaultCompiler));
+ });
+
+ test('returns tests with the correct names', () {
+ expect(suite.group.entries, hasLength(3));
+ expect(suite.group.entries[0].name, equals('success'));
+ expect(suite.group.entries[1].name, equals('failure'));
+ expect(suite.group.entries[2].name, equals('error'));
+ });
+
+ test('can load and run a successful test', () {
+ var liveTest = (suite.group.entries[0] as RunnerTest).load(suite);
+
+ expectStates(liveTest, [
+ const State(Status.running, Result.success),
+ const State(Status.complete, Result.success)
+ ]);
+ expectErrors(liveTest, []);
+
+ return liveTest.run().whenComplete(() => liveTest.close());
+ });
+
+ test('can load and run a failing test', () {
+ var liveTest = (suite.group.entries[1] as RunnerTest).load(suite);
+ expectSingleFailure(liveTest);
+ return liveTest.run().whenComplete(() => liveTest.close());
+ });
+ });
+
+ test('loads tests that are defined asynchronously', () async {
+ File(p.join(d.sandbox, 'a_test.dart')).writeAsStringSync('''
+import 'dart:async';
+
+import 'package:test/test.dart';
+
+Future main() {
+ return Future(() {
+ test("success", () {});
+
+ return Future(() {
+ test("failure", () => throw TestFailure('oh no'));
+
+ return Future(() {
+ test("error", () => throw 'oh no');
+ });
+ });
+ });
+}
+''');
+
+ var suites = await _loader
+ .loadFile(p.join(d.sandbox, 'a_test.dart'), _chrome)
+ .toList();
+ expect(suites, hasLength(1));
+ var loadSuite = suites.first;
+ var suite = (await loadSuite.getSuite())!;
+ expect(suite.group.entries, hasLength(3));
+ expect(suite.group.entries[0].name, equals('success'));
+ expect(suite.group.entries[1].name, equals('failure'));
+ expect(suite.group.entries[2].name, equals('error'));
+ });
+
+ test('loads a suite both in the browser and the VM', () async {
+ var path = p.join(d.sandbox, 'a_test.dart');
+
+ var suites = await _loader
+ .loadFile(
+ path,
+ SuiteConfiguration.runtimes([
+ RuntimeSelection(Runtime.vm.identifier),
+ RuntimeSelection(Runtime.chrome.identifier)
+ ]))
+ .asyncMap((loadSuite) => loadSuite.getSuite())
+ .cast<RunnerSuite>()
+ .toList();
+ expect(suites[0].platform.runtime, equals(Runtime.vm));
+ expect(suites[0].platform.compiler, equals(Runtime.vm.defaultCompiler));
+ expect(suites[0].path, equals(path));
+ expect(suites[1].platform.runtime, equals(Runtime.chrome));
+ expect(suites[1].platform.compiler, equals(Runtime.chrome.defaultCompiler));
+ expect(suites[1].path, equals(path));
+
+ for (var suite in suites) {
+ expect(suite.group.entries, hasLength(3));
+ expect(suite.group.entries[0].name, equals('success'));
+ expect(suite.group.entries[1].name, equals('failure'));
+ expect(suite.group.entries[2].name, equals('error'));
+ }
+ });
+
+ test('a print in a loaded file is piped through the LoadSuite', () async {
+ File(p.join(d.sandbox, 'a_test.dart')).writeAsStringSync('''
+void main() {
+ print('print within test');
+}
+''');
+ var suites = await _loader
+ .loadFile(p.join(d.sandbox, 'a_test.dart'), _chrome)
+ .toList();
+ expect(suites, hasLength(1));
+ var loadSuite = suites.first;
+
+ var liveTest = (loadSuite.group.entries.single as Test).load(loadSuite);
+ // Skip the "Compiled" message from dart2js.
+ expect(liveTest.onMessage.skip(1).first.then((message) => message.text),
+ completion(equals('print within test')));
+ await liveTest.run();
+ expectTestPassed(liveTest);
+ });
+}
diff --git a/pkgs/test/test/runner/browser/microsoft_edge_test.dart b/pkgs/test/test/runner/browser/microsoft_edge_test.dart
new file mode 100644
index 0000000..a48bfd2
--- /dev/null
+++ b/pkgs/test/test/runner/browser/microsoft_edge_test.dart
@@ -0,0 +1,91 @@
+// 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.
+
+@TestOn('vm')
+@Tags(['edge'])
+library;
+
+import 'package:test/src/runner/browser/microsoft_edge.dart';
+import 'package:test/src/runner/executable_settings.dart';
+import 'package:test/test.dart';
+import 'package:test_descriptor/test_descriptor.dart' as d;
+
+import '../../io.dart';
+import '../../utils.dart';
+import 'code_server.dart';
+
+void main() {
+ setUpAll(precompileTestExecutable);
+
+ test('starts edge with the given URL', () async {
+ var server = await CodeServer.start();
+
+ server.handleJavaScript('''
+var webSocket = new WebSocket(window.location.href.replace("http://", "ws://"));
+webSocket.addEventListener("open", function() {
+ webSocket.send("loaded!");
+});
+''');
+ var webSocket = server.handleWebSocket();
+
+ var edge = MicrosoftEdge(server.url, configuration());
+ addTearDown(() => edge.close());
+
+ expect(await (await webSocket).stream.first, equals('loaded!'));
+ }, timeout: const Timeout.factor(2));
+
+ test('reports an error in onExit', () {
+ var edge = MicrosoftEdge(Uri.parse('https://dart.dev'), configuration(),
+ settings: ExecutableSettings(
+ linuxExecutable: '_does_not_exist',
+ macOSExecutable: '_does_not_exist',
+ windowsExecutable: '_does_not_exist'));
+ expect(
+ edge.onExit,
+ throwsA(isApplicationException(
+ startsWith('Failed to run Edge: $noSuchFileMessage'))));
+ });
+
+ test('can run successful tests', () async {
+ await d.file('test.dart', '''
+import 'package:test/test.dart';
+
+void main() {
+ test("success", () {});
+}
+''').create();
+
+ var test = await runTest(['-p', 'edge', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ test('can run failing tests', () async {
+ await d.file('test.dart', '''
+import 'package:test/test.dart';
+
+void main() {
+ test("failure", () => throw TestFailure("oh no"));
+}
+''').create();
+
+ var test = await runTest(['-p', 'edge', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains('-1: Some tests failed.')));
+ await test.shouldExit(1);
+ });
+
+ test('can override edge location with MS_EDGE_EXECUTABLE var', () async {
+ await d.file('test.dart', '''
+import 'package:test/test.dart';
+
+void main() {
+ test("success", () {});
+}
+''').create();
+ var test = await runTest(['-p', 'edge', 'test.dart'],
+ environment: {'MS_EDGE_EXECUTABLE': '/some/bad/path'});
+ expect(test.stdout, emitsThrough(contains('Failed to run Edge:')));
+ await test.shouldExit(1);
+ });
+}
diff --git a/pkgs/test/test/runner/browser/runner_test.dart b/pkgs/test/test/runner/browser/runner_test.dart
new file mode 100644
index 0000000..c55cbb8
--- /dev/null
+++ b/pkgs/test/test/runner/browser/runner_test.dart
@@ -0,0 +1,978 @@
+// Copyright (c) 2015, 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.
+
+@TestOn('vm')
+library;
+
+import 'dart:convert';
+
+import 'package:test/test.dart';
+import 'package:test_descriptor/test_descriptor.dart' as d;
+
+import '../../io.dart';
+
+final _success = '''
+import 'package:test/test.dart';
+
+void main() {
+ test("success", () {});
+}
+''';
+
+final _failure = '''
+import 'package:test/test.dart';
+
+void main() {
+ test("failure", () => throw TestFailure("oh no"));
+}
+''';
+
+void main() {
+ setUpAll(precompileTestExecutable);
+
+ group('fails gracefully if', () {
+ test('a test file fails to compile', () async {
+ await d.file('test.dart', 'invalid Dart file').create();
+ var test = await runTest(['-p', 'chrome', 'test.dart']);
+
+ expect(
+ test.stdout,
+ containsInOrder([
+ 'Error: Compilation failed.',
+ '-1: loading test.dart [E]',
+ 'Failed to load "test.dart": dart2js failed.'
+ ]));
+ await test.shouldExit(1);
+ }, tags: 'chrome');
+
+ test('a test file throws', () async {
+ await d.file('test.dart', "void main() => throw 'oh no';").create();
+
+ var test = await runTest(['-p', 'chrome', 'test.dart']);
+ expect(
+ test.stdout,
+ containsInOrder([
+ '-1: loading test.dart [E]',
+ 'Failed to load "test.dart": oh no'
+ ]));
+ await test.shouldExit(1);
+ }, tags: 'chrome');
+
+ test("a test file doesn't have a main defined", () async {
+ await d.file('test.dart', 'void foo() {}').create();
+
+ var test = await runTest(['-p', 'chrome', 'test.dart']);
+ expect(
+ test.stdout,
+ containsInOrder([
+ '-1: loading test.dart [E]',
+ 'Failed to load "test.dart": No top-level main() function defined.'
+ ]));
+ await test.shouldExit(1);
+ }, tags: 'chrome', skip: 'https://github.com/dart-lang/test/issues/894');
+
+ test('a test file has a non-function main', () async {
+ await d.file('test.dart', 'int main;').create();
+
+ var test = await runTest(['-p', 'chrome', 'test.dart']);
+ expect(
+ test.stdout,
+ containsInOrder([
+ '-1: loading test.dart [E]',
+ 'Failed to load "test.dart": Top-level main getter is not a function.'
+ ]));
+ await test.shouldExit(1);
+ }, tags: 'chrome', skip: 'https://github.com/dart-lang/test/issues/894');
+
+ test('a test file has a main with arguments', () async {
+ await d.file('test.dart', 'void main(arg) {}').create();
+
+ var test = await runTest(['-p', 'chrome', 'test.dart']);
+ expect(
+ test.stdout,
+ containsInOrder([
+ '-1: loading test.dart [E]',
+ 'Failed to load "test.dart": Top-level main() function takes arguments.'
+ ]));
+ await test.shouldExit(1);
+ }, tags: 'chrome');
+
+ test('a custom HTML file has no script tag', () async {
+ await d.file('test.dart', 'void main() {}').create();
+
+ await d.file('test.html', '''
+<html>
+<head>
+ <link rel="x-dart-test" href="test.dart">
+</head>
+</html>
+''').create();
+
+ var test = await runTest(['-p', 'chrome', 'test.dart']);
+ expect(
+ test.stdout,
+ containsInOrder([
+ '-1: loading test.dart [E]',
+ 'Failed to load "test.dart": "test.html" must contain '
+ '<script src="packages/test/dart.js"></script>.'
+ ]));
+ await test.shouldExit(1);
+ }, tags: 'chrome');
+
+ test('a custom HTML file has no link', () async {
+ await d.file('test.dart', 'void main() {}').create();
+
+ await d.file('test.html', '''
+<html>
+<head>
+ <script src="packages/test/dart.js"></script>
+</head>
+</html>
+''').create();
+
+ var test = await runTest(['-p', 'chrome', 'test.dart']);
+ expect(
+ test.stdout,
+ containsInOrder([
+ '-1: loading test.dart [E]',
+ 'Failed to load "test.dart": Expected exactly 1 '
+ '<link rel="x-dart-test"> in test.html, found 0.'
+ ]));
+ await test.shouldExit(1);
+ }, tags: 'chrome');
+
+ test('a custom HTML file has too many links', () async {
+ await d.file('test.dart', 'void main() {}').create();
+
+ await d.file('test.html', '''
+<html>
+<head>
+ <link rel='x-dart-test' href='test.dart'>
+ <link rel='x-dart-test' href='test.dart'>
+ <script src="packages/test/dart.js"></script>
+</head>
+</html>
+''').create();
+
+ var test = await runTest(['-p', 'chrome', 'test.dart']);
+ expect(
+ test.stdout,
+ containsInOrder([
+ '-1: loading test.dart [E]',
+ 'Failed to load "test.dart": Expected exactly 1 '
+ '<link rel="x-dart-test"> in test.html, found 2.'
+ ]));
+ await test.shouldExit(1);
+ }, tags: 'chrome');
+
+ test('a custom HTML file has no href in the link', () async {
+ await d.file('test.dart', 'void main() {}').create();
+
+ await d.file('test.html', '''
+<html>
+<head>
+ <link rel='x-dart-test'>
+ <script src="packages/test/dart.js"></script>
+</head>
+</html>
+''').create();
+
+ var test = await runTest(['-p', 'chrome', 'test.dart']);
+ expect(
+ test.stdout,
+ containsInOrder([
+ '-1: loading test.dart [E]',
+ 'Failed to load "test.dart": Expected <link rel="x-dart-test"> in '
+ 'test.html to have an "href" attribute.'
+ ]));
+ await test.shouldExit(1);
+ }, tags: 'chrome');
+
+ test('a custom HTML file has an invalid test URL', () async {
+ await d.file('test.dart', 'void main() {}').create();
+
+ await d.file('test.html', '''
+<html>
+<head>
+ <link rel='x-dart-test' href='wrong.dart'>
+ <script src="packages/test/dart.js"></script>
+</head>
+</html>
+''').create();
+
+ var test = await runTest(['-p', 'chrome', 'test.dart']);
+ expect(
+ test.stdout,
+ containsInOrder([
+ '-1: loading test.dart [E]',
+ 'Failed to load "test.dart": Failed to load script at '
+ ]));
+ await test.shouldExit(1);
+ }, tags: 'chrome');
+
+ test(
+ 'still errors even with a custom HTML template set since it will take precedence',
+ () async {
+ await d.file('test.dart', 'void main() {}').create();
+
+ await d.file('test.html', '''
+<html>
+<head>
+ <link rel="x-dart-test" href="test.dart">
+</head>
+</html>
+''').create();
+
+ await d
+ .file(
+ 'global_test.yaml',
+ jsonEncode(
+ {'custom_html_template_path': 'html_template.html.tpl'}))
+ .create();
+
+ await d.file('html_template.html.tpl', '''
+<html>
+<head>
+ {{testScript}}
+ <script src="packages/test/dart.js"></script>
+</head>
+<body>
+ <div id="foo"></div>
+</body>
+</html>
+''').create();
+
+ var test = await runTest(['-p', 'chrome', 'test.dart'],
+ environment: {'DART_TEST_CONFIG': 'global_test.yaml'});
+ expect(
+ test.stdout,
+ containsInOrder([
+ '-1: loading test.dart [E]',
+ 'Failed to load "test.dart": "test.html" must contain '
+ '<script src="packages/test/dart.js"></script>.'
+ ]));
+ await test.shouldExit(1);
+ }, tags: 'chrome');
+
+ group('with a custom HTML template', () {
+ setUp(() async {
+ await d.file('test.dart', _success).create();
+ await d
+ .file(
+ 'global_test.yaml',
+ jsonEncode(
+ {'custom_html_template_path': 'html_template.html.tpl'}))
+ .create();
+ });
+
+ test('that does not exist', () async {
+ var test = await runTest(['-p', 'chrome', 'test.dart'],
+ environment: {'DART_TEST_CONFIG': 'global_test.yaml'});
+ expect(
+ test.stdout,
+ containsInOrder([
+ '-1: loading test.dart [E]',
+ 'Failed to load "test.dart": "html_template.html.tpl" does not exist or is not readable'
+ ]));
+ await test.shouldExit(1);
+ }, tags: 'chrome');
+
+ test("that doesn't contain the {{testScript}} tag", () async {
+ await d.file('html_template.html.tpl', '''
+<html>
+<head>
+ <script src="packages/test/dart.js"></script>
+</head>
+<body>
+ <div id="foo"></div>
+</body>
+</html>
+''').create();
+
+ var test = await runTest(['-p', 'chrome', 'test.dart'],
+ environment: {'DART_TEST_CONFIG': 'global_test.yaml'});
+ expect(
+ test.stdout,
+ containsInOrder([
+ '-1: loading test.dart [E]',
+ 'Failed to load "test.dart": "html_template.html.tpl" must contain exactly one {{testScript}} placeholder'
+ ]));
+ await test.shouldExit(1);
+ }, tags: 'chrome');
+
+ test('that contains more than one {{testScript}} tag', () async {
+ await d.file('html_template.html.tpl', '''
+<html>
+<head>
+ {{testScript}}
+ {{testScript}}
+ <script src="packages/test/dart.js"></script>
+</head>
+<body>
+ <div id="foo"></div>
+</body>
+</html>
+''').create();
+
+ var test = await runTest(['-p', 'chrome', 'test.dart'],
+ environment: {'DART_TEST_CONFIG': 'global_test.yaml'});
+ expect(
+ test.stdout,
+ containsInOrder([
+ '-1: loading test.dart [E]',
+ 'Failed to load "test.dart": "html_template.html.tpl" must contain exactly one {{testScript}} placeholder'
+ ]));
+ await test.shouldExit(1);
+ }, tags: 'chrome');
+
+ test('that has no script tag', () async {
+ await d.file('html_template.html.tpl', '''
+<html>
+<head>
+ {{testScript}}
+</head>
+</html>
+''').create();
+
+ var test = await runTest(['-p', 'chrome', 'test.dart'],
+ environment: {'DART_TEST_CONFIG': 'global_test.yaml'});
+ expect(
+ test.stdout,
+ containsInOrder([
+ '-1: loading test.dart [E]',
+ 'Failed to load "test.dart": "html_template.html.tpl" must contain '
+ '<script src="packages/test/dart.js"></script>.'
+ ]));
+ await test.shouldExit(1);
+ }, tags: 'chrome');
+
+ test('that is named like the test file', () async {
+ await d.file('test.html', '''
+<html>
+<head>
+ {{testScript}}
+ <script src="packages/test/dart.js"></script>
+</head>
+</html>
+''').create();
+
+ await d
+ .file('global_test_2.yaml',
+ jsonEncode({'custom_html_template_path': 'test.html'}))
+ .create();
+ var test = await runTest(['-p', 'chrome', 'test.dart'],
+ environment: {'DART_TEST_CONFIG': 'global_test_2.yaml'});
+ expect(
+ test.stdout,
+ containsInOrder([
+ '-1: loading test.dart [E]',
+ 'Failed to load "test.dart": template file "test.html" cannot be named '
+ 'like the test file.'
+ ]));
+ await test.shouldExit(1);
+ });
+ });
+ });
+
+ group('runs successful tests', () {
+ test('on a browser and the VM', () async {
+ await d.file('test.dart', _success).create();
+ var test = await runTest(['-p', 'chrome', '-p', 'vm', 'test.dart']);
+
+ expect(test.stdout, emitsThrough(contains('+2: All tests passed!')));
+ await test.shouldExit(0);
+ }, tags: 'chrome');
+
+ test('with setUpAll', () async {
+ await d.file('test.dart', r'''
+ import 'package:test/test.dart';
+
+ void main() {
+ setUpAll(() => print("in setUpAll"));
+
+ test("test", () {});
+ }
+ ''').create();
+
+ var test = await runTest(['-p', 'chrome', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains('+0: (setUpAll)')));
+ expect(test.stdout, emits('in setUpAll'));
+ await test.shouldExit(0);
+ }, tags: 'chrome');
+
+ test('with tearDownAll', () async {
+ await d.file('test.dart', r'''
+ import 'package:test/test.dart';
+
+ void main() {
+ tearDownAll(() => print("in tearDownAll"));
+
+ test("test", () {});
+ }
+ ''').create();
+
+ var test = await runTest(['-p', 'chrome', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains('+1: (tearDownAll)')));
+ expect(test.stdout, emits('in tearDownAll'));
+ await test.shouldExit(0);
+ }, tags: 'chrome');
+
+ // Regression test; this broke in 0.12.0-beta.9.
+ test('on a file in a subdirectory', () async {
+ await d.dir('dir', [d.file('test.dart', _success)]).create();
+
+ var test = await runTest(['-p', 'chrome', 'dir/test.dart']);
+ expect(test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ }, tags: 'chrome');
+
+ group('with a custom HTML template file', () {
+ group('without a {{testName}} tag', () {
+ setUp(() async {
+ await d
+ .file(
+ 'global_test.yaml',
+ jsonEncode(
+ {'custom_html_template_path': 'html_template.html.tpl'}))
+ .create();
+ await d.file('html_template.html.tpl', '''
+ <html>
+ <head>
+ {{testScript}}
+ <script src="packages/test/dart.js"></script>
+ </head>
+ <body>
+ <div id="foo"></div>
+ </body>
+ </html>
+ ''').create();
+
+ await d.file('test.dart', '''
+ import 'package:test/src/runner/browser/dom.dart' as dom;
+ import 'package:test/test.dart';
+
+ void main() {
+ test("success", () {
+ expect(dom.document.querySelector('#foo'), isNotNull);
+ });
+ }
+ ''').create();
+ });
+
+ test('on Chrome', () async {
+ var test = await runTest(['-p', 'chrome', 'test.dart'],
+ environment: {'DART_TEST_CONFIG': 'global_test.yaml'});
+ expect(test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ }, tags: 'chrome');
+ });
+
+ group('with a {{testName}} tag', () {
+ setUp(() async {
+ await d
+ .file(
+ 'global_test.yaml',
+ jsonEncode(
+ {'custom_html_template_path': 'html_template.html.tpl'}))
+ .create();
+ await d.file('html_template.html.tpl', '''
+ <html>
+ <head>
+ <title>{{testName}}</title>
+ {{testScript}}
+ <script src="packages/test/dart.js"></script>
+ </head>
+ <body>
+ <div id="foo"></div>
+ </body>
+ </html>
+ ''').create();
+
+ await d.file('test-with-title.dart', '''
+ import 'package:test/src/runner/browser/dom.dart' as dom;
+ import 'package:test/test.dart';
+
+ void main() {
+ test("success", () {
+ expect(dom.document.querySelector('#foo'), isNotNull);
+ });
+ test("title", () {
+ expect(dom.document.title, 'test-with-title.dart');
+ });
+ }
+ ''').create();
+ });
+
+ test('on Chrome', () async {
+ var test = await runTest(['-p', 'chrome', 'test-with-title.dart'],
+ environment: {'DART_TEST_CONFIG': 'global_test.yaml'});
+ expect(test.stdout, emitsThrough(contains('+2: All tests passed!')));
+ await test.shouldExit(0);
+ }, tags: 'chrome');
+ });
+ });
+
+ group('with a custom HTML file', () {
+ setUp(() async {
+ await d.file('test.dart', '''
+import 'package:test/src/runner/browser/dom.dart' as dom;
+import 'package:test/test.dart';
+
+void main() {
+ test("success", () {
+ expect(dom.document.querySelector('#foo'), isNotNull);
+ });
+}
+''').create();
+
+ await d.file('test.html', '''
+<html>
+<head>
+ <link rel='x-dart-test' href='test.dart'>
+ <script src="packages/test/dart.js"></script>
+</head>
+<body>
+ <div id="foo"></div>
+</body>
+</html>
+''').create();
+ });
+
+ test('on Chrome', () async {
+ var test = await runTest(['-p', 'chrome', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ }, tags: 'chrome');
+
+ // Regression test for https://github.com/dart-lang/test/issues/82.
+ test('ignores irrelevant link tags', () async {
+ await d.file('test.html', '''
+<html>
+<head>
+ <link rel='x-dart-test-not'>
+ <link rel='other' href='test.dart'>
+ <link rel='x-dart-test' href='test.dart'>
+ <script src="packages/test/dart.js"></script>
+</head>
+<body>
+ <div id="foo"></div>
+</body>
+</html>
+''').create();
+
+ var test = await runTest(['-p', 'chrome', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ }, tags: 'chrome');
+
+ test('takes precedence over provided HTML template', () async {
+ await d
+ .file(
+ 'global_test.yaml',
+ jsonEncode(
+ {'custom_html_template_path': 'html_template.html.tpl'}))
+ .create();
+ await d.file('html_template.html.tpl', '''
+<html>
+<head>
+ {{testScript}}
+ <script src="packages/test/dart.js"></script>
+</head>
+<body>
+ <div id="not-foo"></div>
+</body>
+</html>
+''').create();
+
+ var test = await runTest(['-p', 'chrome', 'test.dart'],
+ environment: {'DART_TEST_CONFIG': 'global_test.yaml'});
+ expect(test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ }, tags: 'chrome');
+ });
+ });
+
+ group('runs failing tests', () {
+ test('that fail only on the browser', () async {
+ await d.file('test.dart', '''
+import 'dart:async';
+
+import 'package:path/path.dart' as p;
+import 'package:test/test.dart';
+
+void main() {
+ test("test", () {
+ if (p.style == p.Style.url) throw TestFailure("oh no");
+ });
+}
+''').create();
+
+ var test = await runTest(['-p', 'chrome', '-p', 'vm', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains('+1 -1: Some tests failed.')));
+ await test.shouldExit(1);
+ }, tags: 'chrome');
+
+ test('that fail only on the VM', () async {
+ await d.file('test.dart', '''
+import 'dart:async';
+
+import 'package:path/path.dart' as p;
+import 'package:test/test.dart';
+
+void main() {
+ test("test", () {
+ if (p.style != p.Style.url) throw TestFailure("oh no");
+ });
+}
+''').create();
+
+ var test = await runTest(['-p', 'chrome', '-p', 'vm', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains('+1 -1: Some tests failed.')));
+ await test.shouldExit(1);
+ }, tags: 'chrome');
+
+ group('with a custom HTML file', () {
+ setUp(() async {
+ await d.file('test.dart', '''
+import 'package:test/src/runner/browser/dom.dart' as dom;
+import 'package:test/test.dart';
+
+void main() {
+ test("failure", () {
+ expect(dom.document.querySelector('#foo'), isNull);
+ });
+}
+''').create();
+
+ await d.file('test.html', '''
+<html>
+<head>
+ <link rel='x-dart-test' href='test.dart'>
+ <script src="packages/test/dart.js"></script>
+</head>
+<body>
+ <div id="foo"></div>
+</body>
+</html>
+''').create();
+ });
+
+ test('on Chrome', () async {
+ var test = await runTest(['-p', 'chrome', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains('-1: Some tests failed.')));
+ await test.shouldExit(1);
+ }, tags: 'chrome');
+ });
+ });
+
+ test('the compiler uses colors if the test runner uses colors', () async {
+ await d.file('test.dart', '{').create();
+
+ var test = await runTest(['--color', '-p', 'chrome', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains('\u001b[31m')));
+ await test.shouldExit(1);
+ }, tags: 'chrome');
+
+ test('forwards prints from the browser test', () async {
+ await d.file('test.dart', '''
+import 'dart:async';
+
+import 'package:test/test.dart';
+
+void main() {
+ test("test", () {
+ print("Hello,");
+ return Future(() => print("world!"));
+ });
+}
+''').create();
+
+ var test = await runTest(['-p', 'chrome', 'test.dart']);
+ expect(test.stdout, emitsInOrder([emitsThrough('Hello,'), 'world!']));
+ await test.shouldExit(0);
+ }, tags: 'chrome');
+
+ test('dartifies stack traces for JS-compiled tests by default', () async {
+ await d.file('test.dart', _failure).create();
+
+ var test = await runTest(['-p', 'chrome', '--verbose-trace', 'test.dart']);
+ expect(test.stdout,
+ containsInOrder([' main.<fn>', 'package:test', 'dart:async/zone.dart']),
+ skip: 'https://github.com/dart-lang/sdk/issues/41949');
+ await test.shouldExit(1);
+ }, tags: 'chrome');
+
+ test("doesn't dartify stack traces for JS-compiled tests with --js-trace",
+ () async {
+ await d.file('test.dart', _failure).create();
+
+ var test = await runTest(
+ ['-p', 'chrome', '--verbose-trace', '--js-trace', 'test.dart']);
+ expect(test.stdoutStream(), neverEmits(endsWith(' main.<fn>')));
+ expect(test.stdoutStream(), neverEmits(contains('package:test')));
+ expect(test.stdoutStream(), neverEmits(contains('dart:async/zone.dart')));
+ expect(test.stdout, emitsThrough(contains('-1: Some tests failed.')));
+ await test.shouldExit(1);
+ }, tags: 'chrome');
+
+ test('respects top-level @Timeout declarations', () async {
+ await d.file('test.dart', '''
+@Timeout(const Duration(seconds: 0))
+
+import 'dart:async';
+
+import 'package:test/test.dart';
+
+void main() {
+ test("timeout", () => Future.delayed(Duration.zero));
+}
+''').create();
+
+ var test = await runTest(['-p', 'chrome', 'test.dart']);
+ expect(
+ test.stdout,
+ containsInOrder(
+ ['Test timed out after 0 seconds.', '-1: Some tests failed.']));
+ await test.shouldExit(1);
+ }, tags: 'chrome');
+
+ group('with onPlatform', () {
+ test('respects matching Skips', () async {
+ await d.file('test.dart', '''
+import 'dart:async';
+
+import 'package:test/test.dart';
+
+void main() {
+ test("fail", () => throw 'oh no', onPlatform: {"browser": Skip()});
+}
+''').create();
+
+ var test = await runTest(['-p', 'chrome', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains('+0 ~1: All tests skipped.')));
+ await test.shouldExit(0);
+ }, tags: 'chrome');
+
+ test('ignores non-matching Skips', () async {
+ await d.file('test.dart', '''
+import 'dart:async';
+
+import 'package:test/test.dart';
+
+void main() {
+ test("success", () {}, onPlatform: {"vm": Skip()});
+}
+''').create();
+
+ var test = await runTest(['-p', 'chrome', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ }, tags: 'chrome');
+
+ test('respects matching Timeouts', () async {
+ await d.file('test.dart', '''
+import 'dart:async';
+
+import 'package:test/test.dart';
+
+void main() {
+ test("fail", () async {
+ await Future.delayed(Duration.zero);
+ throw 'oh no';
+ }, onPlatform: {
+ "browser": Timeout(Duration.zero)
+ });
+}
+''').create();
+
+ var test = await runTest(['-p', 'chrome', 'test.dart']);
+ expect(
+ test.stdout,
+ containsInOrder(
+ ['Test timed out after 0 seconds.', '-1: Some tests failed.']));
+ await test.shouldExit(1);
+ }, tags: 'chrome');
+
+ test('ignores non-matching Timeouts', () async {
+ await d.file('test.dart', '''
+import 'dart:async';
+
+import 'package:test/test.dart';
+
+void main() {
+ test("success", () {}, onPlatform: {
+ "vm": Timeout(Duration(seconds: 0))
+ });
+}
+''').create();
+
+ var test = await runTest(['-p', 'chrome', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ }, tags: 'chrome');
+
+ test('applies matching platforms in order', () async {
+ await d.file('test.dart', '''
+import 'dart:async';
+
+import 'package:test/test.dart';
+
+void main() {
+ test("success", () {}, onPlatform: {
+ "browser": Skip("first"),
+ "browser || windows": Skip("second"),
+ "browser || linux": Skip("third"),
+ "browser || mac-os": Skip("fourth"),
+ "browser || android": Skip("fifth")
+ });
+}
+''').create();
+
+ var test = await runTest(['-p', 'chrome', 'test.dart']);
+ expect(test.stdoutStream(), neverEmits(contains('Skip: first')));
+ expect(test.stdoutStream(), neverEmits(contains('Skip: second')));
+ expect(test.stdoutStream(), neverEmits(contains('Skip: third')));
+ expect(test.stdoutStream(), neverEmits(contains('Skip: fourth')));
+ expect(test.stdout, emitsThrough(contains('Skip: fifth')));
+ await test.shouldExit(0);
+ }, tags: 'chrome');
+ });
+
+ group('with an @OnPlatform annotation', () {
+ test('respects matching Skips', () async {
+ await d.file('test.dart', '''
+@OnPlatform(const {"browser": const Skip()})
+
+import 'dart:async';
+
+import 'package:test/test.dart';
+
+void main() {
+ test("fail", () => throw 'oh no');
+}
+''').create();
+
+ var test = await runTest(['-p', 'chrome', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains('~1: All tests skipped.')));
+ await test.shouldExit(0);
+ }, tags: 'chrome');
+
+ test('ignores non-matching Skips', () async {
+ await d.file('test.dart', '''
+@OnPlatform(const {"vm": const Skip()})
+
+import 'dart:async';
+
+import 'package:test/test.dart';
+
+void main() {
+ test("success", () {});
+}
+''').create();
+
+ var test = await runTest(['-p', 'chrome', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ }, tags: 'chrome');
+
+ test('respects matching Timeouts', () async {
+ await d.file('test.dart', '''
+@OnPlatform(const {
+ "browser": const Timeout(const Duration(seconds: 0))
+})
+
+import 'dart:async';
+
+import 'package:test/test.dart';
+
+void main() {
+ test("fail", () async {
+ await Future.delayed(Duration.zero);
+ throw 'oh no';
+ });
+}
+''').create();
+
+ var test = await runTest(['-p', 'chrome', 'test.dart']);
+ expect(
+ test.stdout,
+ containsInOrder(
+ ['Test timed out after 0 seconds.', '-1: Some tests failed.']));
+ await test.shouldExit(1);
+ }, tags: 'chrome');
+
+ test('ignores non-matching Timeouts', () async {
+ await d.file('test.dart', '''
+@OnPlatform(const {
+ "vm": const Timeout(const Duration(seconds: 0))
+})
+
+import 'dart:async';
+
+import 'package:test/test.dart';
+
+void main() {
+ test("success", () {});
+}
+''').create();
+
+ var test = await runTest(['-p', 'chrome', 'test.dart']);
+ await test.shouldExit(0);
+ }, tags: 'chrome');
+ });
+
+ group('deferred loading', () {
+ test('can run browser tests with deferred library imports', () async {
+ await d.file('deferred.dart', '''
+int x = 1;
+''').create();
+ await d.file('test.dart', '''
+import 'package:test/test.dart';
+
+import 'deferred.dart' deferred as d;
+
+void main() {
+ test("success", () async {
+ await d.loadLibrary();
+ expect(d.x, 1);
+ });
+}
+''').create();
+ var test = await runTest(['-p', 'chrome', 'test.dart']);
+
+ expect(test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ }, tags: 'chrome');
+
+ test('stack trace mapping works for deferred loaded libraries', () async {
+ await d.file('deferred.dart', '''
+int get x {
+ throw 'Oh no!';
+}
+''').create();
+ await d.file('test.dart', '''
+import 'package:test/test.dart';
+
+import 'deferred.dart' deferred as d;
+
+void main() {
+ test("failure", () async {
+ await d.loadLibrary();
+ expect(d.x, 1);
+ });
+}
+''').create();
+
+ var test = await runTest(['-p', 'chrome', 'test.dart']);
+ expect(
+ test.stdout,
+ containsInOrder([
+ 'Oh no!',
+ 'deferred.dart',
+ 'test.dart',
+ ]));
+ await test.shouldExit(1);
+ }, tags: 'chrome');
+ });
+}
diff --git a/pkgs/test/test/runner/browser/safari_test.dart b/pkgs/test/test/runner/browser/safari_test.dart
new file mode 100644
index 0000000..28f4022
--- /dev/null
+++ b/pkgs/test/test/runner/browser/safari_test.dart
@@ -0,0 +1,100 @@
+// Copyright (c) 2015, 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.
+
+@TestOn('vm')
+@Tags(['safari'])
+library;
+
+import 'package:test/src/runner/browser/safari.dart';
+import 'package:test/src/runner/executable_settings.dart';
+import 'package:test/test.dart';
+import 'package:test_descriptor/test_descriptor.dart' as d;
+
+import '../../io.dart';
+import '../../utils.dart';
+import 'code_server.dart';
+
+void main() {
+ setUpAll(precompileTestExecutable);
+
+ test('starts Safari with the given URL',
+ skip: 'https://github.com/dart-lang/test/issues/1253', () async {
+ var server = await CodeServer.start();
+
+ server.handleJavaScript('''
+var webSocket = new WebSocket(window.location.href.replace("http://", "ws://"));
+webSocket.addEventListener("open", function() {
+ webSocket.send("loaded!");
+});
+''');
+ var webSocket = server.handleWebSocket();
+
+ var safari = Safari(server.url);
+ addTearDown(() => safari.close());
+
+ expect(await (await webSocket).stream.first, equals('loaded!'));
+ });
+
+ test("a process can be killed synchronously after it's started", () async {
+ var server = await CodeServer.start();
+
+ var safari = Safari(server.url);
+ await safari.close();
+ });
+
+ test('reports an error in onExit', () {
+ var safari = Safari(Uri.https('dart.dev'),
+ settings: ExecutableSettings(
+ linuxExecutable: '_does_not_exist',
+ macOSExecutable: '_does_not_exist',
+ windowsExecutable: '_does_not_exist'));
+ expect(
+ safari.onExit,
+ throwsA(isApplicationException(
+ startsWith('Failed to run Safari: $noSuchFileMessage'))));
+ });
+
+ test('can run successful tests',
+ skip: 'https://github.com/dart-lang/test/issues/1253', () async {
+ await d.file('test.dart', '''
+import 'package:test/test.dart';
+
+void main() {
+ test("success", () {});
+}
+''').create();
+
+ var test = await runTest(['-p', 'safari', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ test('can run failing tests', () async {
+ await d.file('test.dart', '''
+import 'package:test/test.dart';
+
+void main() {
+ test("failure", () => throw TestFailure("oh no"));
+}
+''').create();
+
+ var test = await runTest(['-p', 'safari', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains('-1: Some tests failed.')));
+ await test.shouldExit(1);
+ });
+
+ test('can override safari location with SAFARI_EXECUTABLE var', () async {
+ await d.file('test.dart', '''
+import 'package:test/test.dart';
+
+void main() {
+ test("success", () {});
+}
+''').create();
+ var test = await runTest(['-p', 'safari', 'test.dart'],
+ environment: {'SAFARI_EXECUTABLE': '/some/bad/path'});
+ expect(test.stdout, emitsThrough(contains('Failed to run Safari:')));
+ await test.shouldExit(1);
+ });
+}
diff --git a/pkgs/test/test/runner/compact_reporter_test.dart b/pkgs/test/test/runner/compact_reporter_test.dart
new file mode 100644
index 0000000..c935e02
--- /dev/null
+++ b/pkgs/test/test/runner/compact_reporter_test.dart
@@ -0,0 +1,550 @@
+// Copyright (c) 2015, 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.
+
+@TestOn('vm')
+library;
+
+import 'dart:async';
+import 'dart:io';
+
+import 'package:path/path.dart' as p;
+import 'package:test/test.dart';
+import 'package:test_descriptor/test_descriptor.dart' as d;
+
+import '../io.dart';
+
+void main() {
+ setUpAll(precompileTestExecutable);
+
+ test('reports when no tests are run', () async {
+ await d.file('test.dart', 'void main() {}').create();
+
+ var test = await runTest(['test.dart'], reporter: 'compact');
+ expect(test.stdout, emitsThrough(contains('No tests ran.')));
+ await test.shouldExit(79);
+ });
+
+ test('runs several successful tests and reports when each completes', () {
+ return _expectReport('''
+ test('success 1', () {});
+ test('success 2', () {});
+ test('success 3', () {});''', '''
+ +0: loading test.dart
+ +0: success 1
+ +1: success 1
+ +1: success 2
+ +2: success 2
+ +2: success 3
+ +3: success 3
+ +3: All tests passed!''');
+ });
+
+ test('runs several failing tests and reports when each fails', () {
+ return _expectReport('''
+ test('failure 1', () => throw TestFailure('oh no'));
+ test('failure 2', () => throw TestFailure('oh no'));
+ test('failure 3', () => throw TestFailure('oh no'));''', '''
+ +0: loading test.dart
+ +0: failure 1
+ +0 -1: failure 1 [E]
+ oh no
+ test.dart 6:33 main.<fn>
+
+
+ +0 -1: failure 2
+ +0 -2: failure 2 [E]
+ oh no
+ test.dart 7:33 main.<fn>
+
+
+ +0 -2: failure 3
+ +0 -3: failure 3 [E]
+ oh no
+ test.dart 8:33 main.<fn>
+
+
+ +0 -3: Some tests failed.''');
+ });
+
+ test('includes the full stack trace with --verbose-trace', () async {
+ await d.file('test.dart', '''
+import 'dart:async';
+
+import 'package:test/test.dart';
+
+void main() {
+ test("failure", () => throw "oh no");
+}
+''').create();
+
+ var test =
+ await runTest(['--verbose-trace', 'test.dart'], reporter: 'compact');
+ expect(test.stdout, emitsThrough(contains('dart:async')));
+ await test.shouldExit(1);
+ });
+
+ test('runs failing tests along with successful tests', () {
+ return _expectReport('''
+ test('failure 1', () => throw TestFailure('oh no'));
+ test('success 1', () {});
+ test('failure 2', () => throw TestFailure('oh no'));
+ test('success 2', () {});''', '''
+ +0: loading test.dart
+ +0: failure 1
+ +0 -1: failure 1 [E]
+ oh no
+ test.dart 6:33 main.<fn>
+
+
+ +0 -1: success 1
+ +1 -1: success 1
+ +1 -1: failure 2
+ +1 -2: failure 2 [E]
+ oh no
+ test.dart 8:33 main.<fn>
+
+
+ +1 -2: success 2
+ +2 -2: success 2
+ +2 -2: Some tests failed.''');
+ });
+
+ test('gracefully handles multiple test failures in a row', () {
+ return _expectReport('''
+ // This completer ensures that the test isolate isn't killed until all
+ // errors have been thrown.
+ var completer = Completer();
+ test('failures', () {
+ Future.microtask(() => throw 'first error');
+ Future.microtask(() => throw 'second error');
+ Future.microtask(() => throw 'third error');
+ Future.microtask(completer.complete);
+ });
+ test('wait', () => completer.future);''', '''
+ +0: loading test.dart
+ +0: failures
+ +0 -1: failures [E]
+ first error
+ test.dart 10:34 main.<fn>.<fn>
+ ===== asynchronous gap ===========================
+ dart:async new Future.microtask
+ test.dart 10:18 main.<fn>
+
+ second error
+ test.dart 11:34 main.<fn>.<fn>
+ ===== asynchronous gap ===========================
+ dart:async new Future.microtask
+ test.dart 11:18 main.<fn>
+
+ third error
+ test.dart 12:34 main.<fn>.<fn>
+ ===== asynchronous gap ===========================
+ dart:async new Future.microtask
+ test.dart 12:18 main.<fn>
+
+
+ +0 -1: wait
+ +1 -1: wait
+ +1 -1: Some tests failed.''');
+ });
+
+ test('prints the full test name before an error', () {
+ return _expectReport('''
+ test(
+ 'really gosh dang long test name. Even longer than that. No, yet '
+ 'longer. Even more. We have to get to at least 200 characters. '
+ 'I know that seems like a lot, but I believe in you. A little '
+ 'more... okay, that should do it.',
+ () => throw TestFailure('oh no'));''', '''
+ +0: loading test.dart
+ +0: really ... than that. No, yet longer. Even more. We have to get to at least 200 characters. I know that seems like a lot, but I believe in you. A little more... okay, that should do it.
+ +0 -1: really gosh dang long test name. Even longer than that. No, yet longer. Even more. We have to get to at least 200 characters. I know that seems like a lot, but I believe in you. A little more... okay, that should do it. [E]
+ oh no
+ test.dart 11:18 main.<fn>
+
+
+ +0 -1: Some tests failed.''');
+ });
+
+ group('print:', () {
+ test('handles multiple prints', () {
+ return _expectReport('''
+ test('test', () {
+ print("one");
+ print("two");
+ print("three");
+ print("four");
+ });''', '''
+ +0: loading test.dart
+ +0: test
+ one
+ two
+ three
+ four
+
+ +1: test
+ +1: All tests passed!''');
+ });
+
+ test('handles a print after the test completes', () {
+ return _expectReport('''
+ // This completer ensures that the test isolate isn't killed until all
+ // prints have happened.
+ var testDone = Completer();
+ var waitStarted = Completer();
+ test('test', () {
+ waitStarted.future.then((_) {
+ Future(() => print("one"));
+ Future(() => print("two"));
+ Future(() => print("three"));
+ Future(() => print("four"));
+ Future(testDone.complete);
+ });
+ });
+
+ test('wait', () {
+ waitStarted.complete();
+ return testDone.future;
+ });''', '''
+ +0: loading test.dart
+ +0: test
+ +1: test
+ +1: wait
+ +1: test
+ one
+ two
+ three
+ four
+
+ +2: wait
+ +2: All tests passed!''');
+ });
+
+ test('interleaves prints and errors', () {
+ return _expectReport('''
+ // This completer ensures that the test isolate isn't killed until all
+ // prints have happened.
+ var completer = Completer();
+ test('test', () {
+ scheduleMicrotask(() {
+ print("three");
+ print("four");
+ throw "second error";
+ });
+
+ scheduleMicrotask(() {
+ print("five");
+ print("six");
+ completer.complete();
+ });
+
+ print("one");
+ print("two");
+ throw "first error";
+ });
+
+ test('wait', () => completer.future);''', '''
+ +0: loading test.dart
+ +0: test
+ one
+ two
+
+ +0 -1: test [E]
+ first error
+ test.dart 24:11 main.<fn>
+
+ three
+ four
+ second error
+ test.dart 13:13 main.<fn>.<fn>
+ ===== asynchronous gap ===========================
+ dart:async scheduleMicrotask
+ test.dart 10:11 main.<fn>
+
+ five
+ six
+
+ +0 -1: wait
+ +1 -1: wait
+ +1 -1: Some tests failed.''');
+ });
+
+ test('prints the full test name before a print', () {
+ return _expectReport('''
+ test(
+ 'really gosh dang long test name. Even longer than that. No, yet '
+ 'longer. Even more. We have to get to at least 200 '
+ 'characters. I know that seems like a lot, but I believe in '
+ 'you. A little more... okay, that should do it.',
+ () => print('hello'));''', '''
+ +0: loading test.dart
+ +0: really ... than that. No, yet longer. Even more. We have to get to at least 200 characters. I know that seems like a lot, but I believe in you. A little more... okay, that should do it.
+ +0: really gosh dang long test name. Even longer than that. No, yet longer. Even more. We have to get to at least 200 characters. I know that seems like a lot, but I believe in you. A little more... okay, that should do it.
+ hello
+
+ +1: really ... than that. No, yet longer. Even more. We have to get to at least 200 characters. I know that seems like a lot, but I believe in you. A little more... okay, that should do it.
+ +1: All tests passed!''');
+ });
+
+ test("doesn't print a clock update between two prints", () {
+ return _expectReport('''
+ test('slow', () async {
+ print('hello');
+ await Future.delayed(Duration(seconds: 3));
+ print('goodbye');
+ });''', '''
+ +0: loading test.dart
+ +0: slow
+ hello
+ goodbye
+
+ +1: slow
+ +1: All tests passed!''');
+ });
+ });
+
+ group('skip:', () {
+ test('displays skipped tests separately', () {
+ return _expectReport('''
+ test('skip 1', () {}, skip: true);
+ test('skip 2', () {}, skip: true);
+ test('skip 3', () {}, skip: true);''', '''
+ +0: loading test.dart
+ +0: skip 1
+ +0 ~1: skip 1
+ +0 ~1: skip 2
+ +0 ~2: skip 2
+ +0 ~2: skip 3
+ +0 ~3: skip 3
+ +0 ~3: All tests skipped.''');
+ });
+
+ test('displays a skipped group', () {
+ return _expectReport('''
+ group('skip', () {
+ test('test 1', () {});
+ test('test 2', () {});
+ test('test 3', () {});
+ }, skip: true);''', '''
+ +0: loading test.dart
+ +0: skip test 1
+ +0 ~1: skip test 1
+ +0 ~1: skip test 2
+ +0 ~2: skip test 2
+ +0 ~2: skip test 3
+ +0 ~3: skip test 3
+ +0 ~3: All tests skipped.''');
+ });
+
+ test('runs skipped tests along with successful tests', () {
+ return _expectReport('''
+ test('skip 1', () {}, skip: true);
+ test('success 1', () {});
+ test('skip 2', () {}, skip: true);
+ test('success 2', () {});''', '''
+ +0: loading test.dart
+ +0: skip 1
+ +0 ~1: skip 1
+ +0 ~1: success 1
+ +1 ~1: success 1
+ +1 ~1: skip 2
+ +1 ~2: skip 2
+ +1 ~2: success 2
+ +2 ~2: success 2
+ +2 ~2: All tests passed!''');
+ });
+
+ test('runs skipped tests along with successful and failing tests', () {
+ return _expectReport('''
+ test('failure 1', () => throw TestFailure('oh no'));
+ test('skip 1', () {}, skip: true);
+ test('success 1', () {});
+ test('failure 2', () => throw TestFailure('oh no'));
+ test('skip 2', () {}, skip: true);
+ test('success 2', () {});''', '''
+ +0: loading test.dart
+ +0: failure 1
+ +0 -1: failure 1 [E]
+ oh no
+ test.dart 6:35 main.<fn>
+
+
+ +0 -1: skip 1
+ +0 ~1 -1: skip 1
+ +0 ~1 -1: success 1
+ +1 ~1 -1: success 1
+ +1 ~1 -1: failure 2
+ +1 ~1 -2: failure 2 [E]
+ oh no
+ test.dart 9:35 main.<fn>
+
+
+ +1 ~1 -2: skip 2
+ +1 ~2 -2: skip 2
+ +1 ~2 -2: success 2
+ +2 ~2 -2: success 2
+ +2 ~2 -2: Some tests failed.''');
+ });
+
+ test('displays the skip reason if available', () {
+ return _expectReport('''
+ test('skip 1', () {}, skip: 'some reason');
+ test('skip 2', () {}, skip: 'or another');''', '''
+ +0: loading test.dart
+ +0: skip 1
+ Skip: some reason
+
+ +0 ~1: skip 1
+ +0 ~1: skip 2
+ Skip: or another
+
+ +0 ~2: skip 2
+ +0 ~2: All tests skipped.''');
+ });
+
+ test('runs skipped tests with --run-skipped', () {
+ return _expectReport('''
+ test('skip 1', () {}, skip: 'some reason');
+ test('skip 2', () {}, skip: 'or another');''', '''
+ +0: loading test.dart
+ +0: skip 1
+ +1: skip 1
+ +1: skip 2
+ +2: skip 2
+ +2: All tests passed!''', args: ['--run-skipped']);
+ });
+ });
+
+ test('Directs users to enable stack trace chaining if disabled', () async {
+ await _expectReport(
+ '''test('failure 1', () => throw TestFailure('oh no'));''', '''
+ +0: loading test.dart
+ +0: failure 1
+ +0 -1: failure 1 [E]
+ oh no
+ test.dart 6:25 main.<fn>
+ +0 -1: Some tests failed.
+ Consider enabling the flag chain-stack-traces to receive more detailed exceptions.
+ For example, 'dart test --chain-stack-traces'.''',
+ chainStackTraces: false);
+ });
+
+ group('gives non-windows users a way to re-run failed tests', () {
+ final executablePath = p.absolute(Platform.resolvedExecutable);
+
+ test('with simple names', () {
+ return _expectReport('''
+ test('failure', () {
+ expect(1, equals(2));
+ });''', '''
+ +0: loading test.dart
+ +0: failure
+ +0 -1: failure [E]
+ Expected: <2>
+ Actual: <1>
+
+ To run this test again: $executablePath test test.dart -p vm --plain-name 'failure'
+
+ +0 -1: Some tests failed.''');
+ });
+
+ test('escapes names containing single quotes', () {
+ return _expectReport('''
+ test("failure with a ' in the name", () {
+ expect(1, equals(2));
+ });''', '''
+ +0: loading test.dart
+ +0: failure with a ' in the name
+ +0 -1: failure with a ' in the name [E]
+ Expected: <2>
+ Actual: <1>
+
+ To run this test again: $executablePath test test.dart -p vm --plain-name 'failure with a '\\'' in the name'
+
+ +0 -1: Some tests failed.''');
+ });
+ }, testOn: '!windows');
+
+ group('gives windows users a way to re-run failed tests', () {
+ final executablePath = p.absolute(Platform.resolvedExecutable);
+
+ test('with simple names', () {
+ return _expectReport('''
+ test('failure', () {
+ expect(1, equals(2));
+ });''', '''
+ +0: loading test.dart
+ +0: failure
+ +0 -1: failure [E]
+ Expected: <2>
+ Actual: <1>
+
+ To run this test again: $executablePath test test.dart -p vm --plain-name "failure"
+
+ +0 -1: Some tests failed.''');
+ });
+
+ test('escapes names containing double quotes', () {
+ return _expectReport('''
+ test('failure with a " in the name', () {
+ expect(1, equals(2));
+ });''', '''
+ +0: loading test.dart
+ +0: failure with a " in the name
+ +0 -1: failure with a " in the name [E]
+ Expected: <2>
+ Actual: <1>
+
+ To run this test again: $executablePath test test.dart -p vm --plain-name "failure with a """ in the name"
+
+ +0 -1: Some tests failed.''');
+ });
+ }, testOn: 'windows');
+}
+
+Future<void> _expectReport(String tests, String expected,
+ {List<String> args = const [], bool chainStackTraces = true}) async {
+ await d.file('test.dart', '''
+ import 'dart:async';
+
+ import 'package:test/test.dart';
+
+ void main() {
+$tests
+ }
+ ''').create();
+
+ var test = await runTest([
+ 'test.dart',
+ if (chainStackTraces) '--chain-stack-traces',
+ ...args,
+ ], reporter: 'compact');
+ await test.shouldExit();
+
+ var stdoutLines = await test.stdout.rest.toList();
+
+ // Skip the first CR, remove excess trailing whitespace, and trim off
+ // timestamps.
+ String? lastLine;
+ var actual = stdoutLines.skip(1).map((line) {
+ if (line.startsWith(' ') || line.isEmpty) return line.trimRight();
+
+ var trimmed = line.trim().replaceFirst(RegExp('^[0-9]{2}:[0-9]{2} '), '');
+
+ // Trim identical lines so the test isn't dependent on how fast each test
+ // runs.
+ if (trimmed == lastLine) return null;
+ lastLine = trimmed;
+ return trimmed;
+ }).where((line) => line != null);
+
+ // Un-indent the expected string.
+ var indentation = expected.indexOf(RegExp('[^ ]'));
+ var expectedLines = expected.split('\n').map((line) {
+ if (line.isEmpty) return line;
+ return line.substring(indentation);
+ });
+
+ expect(actual, containsAllInOrder(expectedLines));
+}
diff --git a/pkgs/test/test/runner/compiler_runtime_matrix_test.dart b/pkgs/test/test/runner/compiler_runtime_matrix_test.dart
new file mode 100644
index 0000000..74d8802
--- /dev/null
+++ b/pkgs/test/test/runner/compiler_runtime_matrix_test.dart
@@ -0,0 +1,174 @@
+// 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.
+
+@TestOn('vm')
+@Timeout.factor(2)
+library;
+
+import 'dart:io';
+
+import 'package:test/test.dart';
+import 'package:test_api/backend.dart';
+import 'package:test_descriptor/test_descriptor.dart' as d;
+
+import '../io.dart';
+
+void main() {
+ setUpAll(() async {
+ await precompileTestExecutable();
+ });
+
+ for (var runtime in Runtime.builtIn) {
+ for (var compiler in runtime.supportedCompilers) {
+ // Ignore the platforms we can't run on this OS.
+ if ((runtime == Runtime.edge && !Platform.isWindows) ||
+ (runtime == Runtime.safari && !Platform.isMacOS)) {
+ continue;
+ }
+ String? skipReason;
+ if (runtime == Runtime.safari) {
+ skipReason = 'https://github.com/dart-lang/test/issues/1253';
+ } else if (compiler == Compiler.dart2wasm) {
+ skipReason = 'Wasm tests are experimental and require special setup';
+ } else if ([Runtime.firefox, Runtime.nodeJS].contains(runtime) &&
+ Platform.isWindows) {
+ skipReason = 'https://github.com/dart-lang/test/issues/1942';
+ } else if (runtime == Runtime.firefox && Platform.isMacOS) {
+ skipReason = 'https://github.com/dart-lang/test/pull/2276';
+ }
+ group('--runtime ${runtime.identifier} --compiler ${compiler.identifier}',
+ skip: skipReason, () {
+ final testArgs = [
+ 'test.dart',
+ '-p',
+ runtime.identifier,
+ '-c',
+ compiler.identifier
+ ];
+
+ test('can run passing tests', () async {
+ await d.file('test.dart', _goodTest).create();
+ var test = await runTest(testArgs);
+
+ expect(test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ test('fails gracefully for invalid code', () async {
+ await d.file('test.dart', _compileErrorTest).create();
+ var test = await runTest(testArgs);
+
+ expect(
+ test.stdout,
+ containsInOrder([
+ "Error: A value of type 'String' can't be assigned to a variable of type 'int'.",
+ "int x = 'hello';",
+ ]));
+
+ await test.shouldExit(1);
+ });
+
+ test('fails gracefully for test failures', () async {
+ await d.file('test.dart', _failingTest).create();
+ var test = await runTest(testArgs);
+
+ expect(
+ test.stdout,
+ containsInOrder([
+ 'Expected: <2>',
+ 'Actual: <1>',
+ 'test.dart 5',
+ '+0 -1: Some tests failed.',
+ ]));
+
+ await test.shouldExit(1);
+ });
+
+ test('fails gracefully if a test file throws in main', () async {
+ await d.file('test.dart', _throwingTest).create();
+ var test = await runTest(testArgs);
+ expect(
+ test.stdout,
+ containsInOrder([
+ '-1: [${runtime.name}, ${compiler.name}] loading test.dart [E]',
+ 'Failed to load "test.dart": oh no'
+ ]));
+ await test.shouldExit(1);
+ });
+
+ test('captures prints', () async {
+ await d.file('test.dart', _testWithPrints).create();
+ var test = await runTest([...testArgs, '-r', 'json']);
+
+ expect(
+ test.stdout,
+ containsInOrder([
+ '"messageType":"print","message":"hello","type":"print"',
+ ]));
+
+ await test.shouldExit(0);
+ });
+
+ if (runtime.isDartVM) {
+ test('forwards stdout/stderr', () async {
+ await d.file('test.dart', _testWithStdOutAndErr).create();
+ var test = await runTest(testArgs, reporter: 'silent');
+
+ expect(test.stdout, emitsThrough('hello'));
+ expect(test.stderr, emits('world'));
+ await test.shouldExit(0);
+ },
+ skip: Platform.isWindows && compiler == Compiler.exe
+ ? 'https://github.com/dart-lang/test/issues/2150'
+ : null);
+ }
+ });
+ }
+ }
+}
+
+final _goodTest = '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("success", () {});
+ }
+''';
+
+final _failingTest = '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("failure", () {
+ expect(1, 2);
+ });
+ }
+''';
+
+final _compileErrorTest = '''
+int x = 'hello';
+
+void main() {}
+''';
+
+final _throwingTest = "void main() => throw 'oh no';";
+
+final _testWithPrints = '''
+import 'package:test/test.dart';
+
+void main() {
+ print('hello');
+ test('success', () {});
+}''';
+
+final _testWithStdOutAndErr = '''
+import 'dart:io';
+import 'package:test/test.dart';
+
+void main() async {
+ stdout.writeln('hello');
+ await stdout.flush();
+ stderr.writeln('world');
+ test('success', () {});
+}''';
diff --git a/pkgs/test/test/runner/compiler_test.dart b/pkgs/test/test/runner/compiler_test.dart
new file mode 100644
index 0000000..5cf7a47
--- /dev/null
+++ b/pkgs/test/test/runner/compiler_test.dart
@@ -0,0 +1,77 @@
+// 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.
+
+@TestOn('vm')
+library;
+
+import 'package:test/test.dart';
+import 'package:test_descriptor/test_descriptor.dart' as d;
+
+import '../io.dart';
+
+final _test = '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("success", () {});
+ }
+''';
+
+void main() {
+ setUpAll(() async {
+ await precompileTestExecutable();
+ await d.file('test.dart', _test).create();
+ });
+
+ group('--compiler', () {
+ test(
+ 'uses the default compiler if none other is specified for the platform',
+ () async {
+ var test =
+ await runTest(['test.dart', '-p', 'chrome,vm', '-c', 'dart2js']);
+
+ expect(test.stdout, emitsThrough(contains('[Chrome, Dart2Js]')));
+ expect(test.stdout, emitsThrough(contains('[VM, Kernel]')));
+ expect(test.stdout, emitsThrough(contains('+2: All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ test('runs all supported compiler and platform combinations', () async {
+ var test = await runTest(
+ ['test.dart', '-p', 'chrome,vm', '-c', 'dart2js,kernel,source']);
+
+ expect(test.stdout, emitsThrough(contains('[Chrome, Dart2Js]')));
+ expect(test.stdout, emitsThrough(contains('[VM, Kernel]')));
+ expect(test.stdout, emitsThrough(contains('[VM, Source]')));
+ expect(test.stdout, emitsThrough(contains('+3: All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ test('supports platform selectors', () async {
+ var test = await runTest(
+ ['test.dart', '-p', 'vm', '-c', 'vm:source,browser:kernel']);
+
+ expect(test.stdout, emitsThrough(contains('[VM, Source]')));
+ expect(test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ test(
+ 'will only run a given test once for each compiler, even if there are '
+ 'multiple matches', () async {
+ var test =
+ await runTest(['test.dart', '-p', 'vm', '-c', 'vm:source,source']);
+
+ expect(test.stdout, emitsThrough(contains('[VM, Source]')));
+ expect(test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ test('fails on unknown compilers', () async {
+ var test = await runTest(['test.dart', '-c', 'fake']);
+ expect(test.stderr, emitsThrough(contains('Invalid compiler `fake`')));
+ await test.shouldExit(64);
+ });
+ });
+}
diff --git a/pkgs/test/test/runner/configuration/compiler_test.dart b/pkgs/test/test/runner/configuration/compiler_test.dart
new file mode 100644
index 0000000..d8f8d33
--- /dev/null
+++ b/pkgs/test/test/runner/configuration/compiler_test.dart
@@ -0,0 +1,75 @@
+// 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.
+
+@TestOn('vm')
+library;
+
+import 'dart:convert';
+
+import 'package:test/test.dart';
+import 'package:test_descriptor/test_descriptor.dart' as d;
+
+import '../../io.dart';
+
+void main() {
+ setUpAll(precompileTestExecutable);
+
+ group('compilers', () {
+ test('uses specified compilers for supporting platforms', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'compilers': ['source']
+ }))
+ .create();
+
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("test", () {});
+ }
+ ''').create();
+
+ var test = await runTest(['-p', 'chrome,vm', 'test.dart']);
+ expect(
+ test.stdout,
+ containsInOrder([
+ '+0: [Chrome, Dart2Js]',
+ '+1: [VM, Source]',
+ '+2: All tests passed!',
+ ]));
+ await test.shouldExit(0);
+ });
+
+ test('supports platform selectors with compilers', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'compilers': ['vm:source', 'browser:kernel']
+ }))
+ .create();
+
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("test", () {});
+ }
+ ''').create();
+
+ var test = await runTest(['-p', 'chrome,vm', 'test.dart']);
+ expect(
+ test.stdout,
+ containsInOrder([
+ '+0: [Chrome, Dart2Js]',
+ '+1: [VM, Source]',
+ '+2: All tests passed!',
+ ]));
+ await test.shouldExit(0);
+ });
+ });
+}
diff --git a/pkgs/test/test/runner/configuration/configuration_test.dart b/pkgs/test/test/runner/configuration/configuration_test.dart
new file mode 100644
index 0000000..03cc728
--- /dev/null
+++ b/pkgs/test/test/runner/configuration/configuration_test.dart
@@ -0,0 +1,326 @@
+// Copyright (c) 2016, 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.
+
+@TestOn('vm')
+library;
+
+import 'package:boolean_selector/boolean_selector.dart';
+import 'package:test/test.dart';
+import 'package:test_core/src/runner/configuration/reporters.dart';
+import 'package:test_core/src/runner/suite.dart';
+import 'package:test_core/src/util/io.dart';
+
+import '../../utils.dart';
+
+void main() {
+ group('merge', () {
+ group('for most fields', () {
+ test('if neither is defined, preserves the default', () {
+ var merged = configuration().merge(configuration());
+ expect(merged.help, isFalse);
+ expect(merged.version, isFalse);
+ expect(merged.pauseAfterLoad, isFalse);
+ expect(merged.debug, isFalse);
+ expect(merged.color, equals(canUseSpecialChars));
+ expect(merged.configurationPath, equals('dart_test.yaml'));
+ expect(merged.reporter, equals(defaultReporter));
+ expect(merged.fileReporters, isEmpty);
+ expect(merged.shardIndex, isNull);
+ expect(merged.totalShards, isNull);
+ expect(merged.testRandomizeOrderingSeed, isNull);
+ expect(merged.testSelections.keys.single, 'test');
+ });
+
+ test("if only the old configuration's is defined, uses it", () {
+ var merged = configuration(
+ help: true,
+ version: true,
+ pauseAfterLoad: true,
+ debug: true,
+ color: true,
+ configurationPath: 'special_test.yaml',
+ reporter: 'json',
+ fileReporters: {'json': 'out.json'},
+ shardIndex: 3,
+ totalShards: 10,
+ testRandomizeOrderingSeed: 123,
+ testSelections: const {
+ 'bar': {TestSelection()}
+ }).merge(configuration());
+
+ expect(merged.help, isTrue);
+ expect(merged.version, isTrue);
+ expect(merged.pauseAfterLoad, isTrue);
+ expect(merged.debug, isTrue);
+ expect(merged.color, isTrue);
+ expect(merged.configurationPath, equals('special_test.yaml'));
+ expect(merged.reporter, equals('json'));
+ expect(merged.fileReporters, equals({'json': 'out.json'}));
+ expect(merged.shardIndex, equals(3));
+ expect(merged.totalShards, equals(10));
+ expect(merged.testRandomizeOrderingSeed, 123);
+ expect(merged.testSelections.keys.single, 'bar');
+ });
+
+ test("if only the new configuration's is defined, uses it", () {
+ var merged = configuration().merge(configuration(
+ help: true,
+ version: true,
+ pauseAfterLoad: true,
+ debug: true,
+ color: true,
+ configurationPath: 'special_test.yaml',
+ reporter: 'json',
+ fileReporters: {'json': 'out.json'},
+ shardIndex: 3,
+ totalShards: 10,
+ testRandomizeOrderingSeed: 123,
+ testSelections: const {
+ 'bar': {TestSelection()}
+ }));
+
+ expect(merged.help, isTrue);
+ expect(merged.version, isTrue);
+ expect(merged.pauseAfterLoad, isTrue);
+ expect(merged.debug, isTrue);
+ expect(merged.color, isTrue);
+ expect(merged.configurationPath, equals('special_test.yaml'));
+ expect(merged.reporter, equals('json'));
+ expect(merged.fileReporters, equals({'json': 'out.json'}));
+ expect(merged.shardIndex, equals(3));
+ expect(merged.totalShards, equals(10));
+ expect(merged.testRandomizeOrderingSeed, 123);
+ expect(merged.testSelections.keys.single, 'bar');
+ });
+
+ test(
+ "if the two configurations conflict, uses the new configuration's "
+ 'values', () {
+ var older = configuration(
+ help: true,
+ version: false,
+ pauseAfterLoad: true,
+ debug: true,
+ color: false,
+ configurationPath: 'special_test.yaml',
+ reporter: 'json',
+ fileReporters: {'json': 'old.json'},
+ shardIndex: 2,
+ totalShards: 4,
+ testRandomizeOrderingSeed: 0,
+ testSelections: const {
+ 'bar': {TestSelection()}
+ });
+ var newer = configuration(
+ help: false,
+ version: true,
+ pauseAfterLoad: false,
+ debug: false,
+ color: true,
+ configurationPath: 'test_special.yaml',
+ reporter: 'compact',
+ fileReporters: {'json': 'new.json'},
+ shardIndex: 3,
+ totalShards: 10,
+ testRandomizeOrderingSeed: 123,
+ testSelections: const {
+ 'blech': {TestSelection()}
+ });
+ var merged = older.merge(newer);
+
+ expect(merged.help, isFalse);
+ expect(merged.version, isTrue);
+ expect(merged.pauseAfterLoad, isFalse);
+ expect(merged.debug, isFalse);
+ expect(merged.color, isTrue);
+ expect(merged.configurationPath, equals('test_special.yaml'));
+ expect(merged.reporter, equals('compact'));
+ expect(merged.fileReporters, equals({'json': 'new.json'}));
+ expect(merged.shardIndex, equals(3));
+ expect(merged.totalShards, equals(10));
+ expect(merged.testRandomizeOrderingSeed, 123);
+ expect(merged.testSelections.keys.single, 'blech');
+ });
+ });
+
+ group('for chosenPresets', () {
+ test('if neither is defined, preserves the default', () {
+ var merged = configuration().merge(configuration());
+ expect(merged.chosenPresets, isEmpty);
+ });
+
+ test("if only the old configuration's is defined, uses it", () {
+ var merged = configuration(chosenPresets: ['baz', 'bang'])
+ .merge(configuration());
+ expect(merged.chosenPresets, equals(['baz', 'bang']));
+ });
+
+ test("if only the new configuration's is defined, uses it", () {
+ var merged = configuration()
+ .merge(configuration(chosenPresets: ['baz', 'bang']));
+ expect(merged.chosenPresets, equals(['baz', 'bang']));
+ });
+
+ test('if both are defined, unions them', () {
+ var merged = configuration(chosenPresets: ['baz', 'bang'])
+ .merge(configuration(chosenPresets: ['qux']));
+ expect(merged.chosenPresets, equals(['baz', 'bang', 'qux']));
+ });
+ });
+
+ group('for presets', () {
+ test('merges each nested configuration', () {
+ var merged = configuration(presets: {
+ 'bang': configuration(pauseAfterLoad: true),
+ 'qux': configuration(color: true)
+ }).merge(configuration(presets: {
+ 'qux': configuration(color: false),
+ 'zap': configuration(help: true)
+ }));
+
+ expect(merged.presets['bang']!.pauseAfterLoad, isTrue);
+ expect(merged.presets['qux']!.color, isFalse);
+ expect(merged.presets['zap']!.help, isTrue);
+ });
+
+ test('automatically resolves a matching chosen preset', () {
+ var config = configuration(
+ presets: {'foo': configuration(color: true)},
+ chosenPresets: ['foo']);
+ expect(config.presets, isEmpty);
+ expect(config.chosenPresets, equals(['foo']));
+ expect(config.knownPresets, equals(['foo']));
+ expect(config.color, isTrue);
+ });
+
+ test('resolves a chosen presets in order', () {
+ var config = configuration(presets: {
+ 'foo': configuration(color: true),
+ 'bar': configuration(color: false)
+ }, chosenPresets: [
+ 'foo',
+ 'bar'
+ ]);
+ expect(config.presets, isEmpty);
+ expect(config.chosenPresets, equals(['foo', 'bar']));
+ expect(config.knownPresets, unorderedEquals(['foo', 'bar']));
+ expect(config.color, isFalse);
+
+ config = configuration(presets: {
+ 'foo': configuration(color: true),
+ 'bar': configuration(color: false)
+ }, chosenPresets: [
+ 'bar',
+ 'foo'
+ ]);
+ expect(config.presets, isEmpty);
+ expect(config.chosenPresets, equals(['bar', 'foo']));
+ expect(config.knownPresets, unorderedEquals(['foo', 'bar']));
+ expect(config.color, isTrue);
+ });
+
+ test('ignores inapplicable chosen presets', () {
+ var config = configuration(presets: {}, chosenPresets: ['baz']);
+ expect(config.presets, isEmpty);
+ expect(config.chosenPresets, equals(['baz']));
+ expect(config.knownPresets, equals(isEmpty));
+ });
+
+ test('resolves presets through merging', () {
+ var config = configuration(presets: {'foo': configuration(color: true)})
+ .merge(configuration(chosenPresets: ['foo']));
+
+ expect(config.presets, isEmpty);
+ expect(config.chosenPresets, equals(['foo']));
+ expect(config.knownPresets, equals(['foo']));
+ expect(config.color, isTrue);
+ });
+
+ test('preserves known presets through merging', () {
+ var config = configuration(
+ presets: {'foo': configuration(color: true)},
+ chosenPresets: ['foo']).merge(configuration());
+
+ expect(config.presets, isEmpty);
+ expect(config.chosenPresets, equals(['foo']));
+ expect(config.knownPresets, equals(['foo']));
+ expect(config.color, isTrue);
+ });
+ });
+
+ group('for include and excludeTags', () {
+ test('if neither is defined, preserves the default', () {
+ var merged = configuration().merge(configuration());
+ expect(merged.includeTags, equals(BooleanSelector.all));
+ expect(merged.excludeTags, equals(BooleanSelector.none));
+ });
+
+ test("if only the old configuration's is defined, uses it", () {
+ var merged = configuration(
+ includeTags: BooleanSelector.parse('foo || bar'),
+ excludeTags: BooleanSelector.parse('baz || bang'))
+ .merge(configuration());
+
+ expect(merged.includeTags, equals(BooleanSelector.parse('foo || bar')));
+ expect(
+ merged.excludeTags, equals(BooleanSelector.parse('baz || bang')));
+ });
+
+ test("if only the configuration's is defined, uses it", () {
+ var merged = configuration().merge(configuration(
+ includeTags: BooleanSelector.parse('foo || bar'),
+ excludeTags: BooleanSelector.parse('baz || bang')));
+
+ expect(merged.includeTags, equals(BooleanSelector.parse('foo || bar')));
+ expect(
+ merged.excludeTags, equals(BooleanSelector.parse('baz || bang')));
+ });
+
+ test('if both are defined, unions or intersects them', () {
+ var older = configuration(
+ includeTags: BooleanSelector.parse('foo || bar'),
+ excludeTags: BooleanSelector.parse('baz || bang'));
+ var newer = configuration(
+ includeTags: BooleanSelector.parse('blip'),
+ excludeTags: BooleanSelector.parse('qux'));
+ var merged = older.merge(newer);
+
+ expect(merged.includeTags,
+ equals(BooleanSelector.parse('(foo || bar) && blip')));
+ expect(merged.excludeTags,
+ equals(BooleanSelector.parse('(baz || bang) || qux')));
+ });
+ });
+
+ group('for globalPatterns', () {
+ test('if neither is defined, preserves the default', () {
+ var merged = configuration().merge(configuration());
+ expect(merged.globalPatterns, isEmpty);
+ });
+
+ test("if only the old configuration's is defined, uses it", () {
+ var merged = configuration(globalPatterns: ['beep', 'boop'])
+ .merge(configuration());
+
+ expect(merged.globalPatterns, equals(['beep', 'boop']));
+ });
+
+ test("if only the new configuration's is defined, uses it", () {
+ var merged = configuration()
+ .merge(configuration(globalPatterns: ['beep', 'boop']));
+
+ expect(merged.globalPatterns, equals(['beep', 'boop']));
+ });
+
+ test('if both are defined, unions them', () {
+ var older = configuration(globalPatterns: ['beep', 'boop']);
+ var newer = configuration(globalPatterns: ['bonk']);
+ var merged = older.merge(newer);
+
+ expect(
+ merged.globalPatterns, unorderedEquals(['beep', 'boop', 'bonk']));
+ });
+ });
+ });
+}
diff --git a/pkgs/test/test/runner/configuration/custom_platform_test.dart b/pkgs/test/test/runner/configuration/custom_platform_test.dart
new file mode 100644
index 0000000..ca9ec05
--- /dev/null
+++ b/pkgs/test/test/runner/configuration/custom_platform_test.dart
@@ -0,0 +1,930 @@
+// Copyright (c) 2017, 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.
+
+@TestOn('vm')
+library;
+
+import 'dart:io';
+
+import 'package:test/src/runner/browser/default_settings.dart';
+import 'package:test/test.dart';
+import 'package:test_api/src/backend/runtime.dart';
+import 'package:test_core/src/util/exit_codes.dart' as exit_codes;
+import 'package:test_descriptor/test_descriptor.dart' as d;
+import 'package:test_process/test_process.dart';
+
+import '../../io.dart';
+
+void main() {
+ setUpAll(precompileTestExecutable);
+
+ setUp(() async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("success", () {});
+ }
+ ''').create();
+ });
+
+ group('override_platforms', () {
+ group('can override a browser', () {
+ test('without any changes', () async {
+ await d.file('dart_test.yaml', '''
+ override_platforms:
+ chrome:
+ settings: {}
+ ''').create();
+
+ var test = await runTest(['-p', 'chrome', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains('All tests passed!')));
+ await test.shouldExit(0);
+ }, tags: 'chrome');
+
+ test("that's user-defined", () async {
+ await d.file('dart_test.yaml', '''
+ define_platforms:
+ chromium:
+ name: Chromium
+ extends: chrome
+ settings: {}
+
+ override_platforms:
+ chromium:
+ settings: {}
+ ''').create();
+
+ var test = await runTest(['-p', 'chromium', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains('All tests passed!')));
+ await test.shouldExit(0);
+ }, tags: 'chrome');
+
+ test('with a basename-only executable', () async {
+ await d.file('dart_test.yaml', '''
+ override_platforms:
+ firefox:
+ settings:
+ executable:
+ linux: firefox
+ mac_os: firefox
+ windows: firefox.exe
+ ''').create();
+
+ var test = await runTest(['-p', 'firefox', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains('All tests passed!')));
+ await test.shouldExit(0);
+ }, tags: 'firefox');
+
+ test('with an absolute-path executable', () async {
+ String path;
+ if (Platform.isLinux) {
+ var process = await TestProcess.start('which', ['google-chrome']);
+ path = await process.stdout.next;
+ await process.shouldExit(0);
+ } else {
+ path = defaultSettings[Runtime.chrome]!.executable;
+ }
+
+ await d.file('dart_test.yaml', '''
+ override_platforms:
+ chrome:
+ settings:
+ executable: $path
+ ''').create();
+
+ var test = await runTest(['-p', 'chrome', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains('All tests passed!')));
+ await test.shouldExit(0);
+ }, tags: 'chrome');
+
+ test('with non-headless mode', () async {
+ await d.file('dart_test.yaml', '''
+ override_platforms:
+ chrome:
+ settings:
+ headless: false
+ ''').create();
+
+ await d.file('test.dart', '''
+ import 'package:test/src/runner/browser/dom.dart' as dom;
+ import 'package:test/test.dart';
+
+ void main() {
+ test("is not headless", () {
+ expect(dom.window.navigator.userAgent,
+ isNot(contains('HeadlessChrome')));
+ });
+ }
+ ''').create();
+
+ var test = await runTest(['-p', 'chrome', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains('All tests passed!')));
+ await test.shouldExit(0);
+ }, tags: 'chrome');
+ });
+
+ test('can override Node.js without any changes', () async {
+ await d.file('dart_test.yaml', '''
+ override_platforms:
+ node:
+ settings: {}
+ ''').create();
+
+ var test = await runTest(['-p', 'node', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains('All tests passed!')));
+ await test.shouldExit(0);
+ }, tags: 'node');
+
+ group('errors', () {
+ test('rejects a non-map value', () async {
+ await d.file('dart_test.yaml', 'override_platforms: 12').create();
+
+ var test = await runTest([]);
+ expect(test.stderr,
+ containsInOrder(['override_platforms must be a map.', '^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('rejects a non-string key', () async {
+ await d
+ .file('dart_test.yaml', 'override_platforms: {12: null}')
+ .create();
+
+ var test = await runTest([]);
+ expect(test.stderr,
+ containsInOrder(['Platform identifier must be a string.', '^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('rejects a non-identifier-like key', () async {
+ await d
+ .file('dart_test.yaml', 'override_platforms: {foo bar: null}')
+ .create();
+
+ var test = await runTest([]);
+ expect(
+ test.stderr,
+ containsInOrder([
+ 'Platform identifier must be an (optionally hyphenated) Dart '
+ 'identifier.',
+ '^^^^^^^'
+ ]));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('rejects a non-map definition', () async {
+ await d.file('dart_test.yaml', '''
+ override_platforms:
+ chrome: 12
+ ''').create();
+
+ var test = await runTest([]);
+ expect(test.stderr,
+ containsInOrder(['Platform definition must be a map.', '^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('requires a settings key', () async {
+ await d.file('dart_test.yaml', '''
+ override_platforms:
+ chrome: {}
+ ''').create();
+
+ var test = await runTest([]);
+ expect(test.stderr,
+ containsInOrder(['Missing required field "settings".', '^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('settings must be a map', () async {
+ await d.file('dart_test.yaml', '''
+ override_platforms:
+ chrome:
+ settings: null
+ ''').create();
+
+ var test = await runTest([]);
+ expect(test.stderr, containsInOrder(['Must be a map.', '^^^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('the overridden platform must exist', () async {
+ await d.file('dart_test.yaml', '''
+ override_platforms:
+ chromium:
+ settings: {}
+ ''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stderr,
+ containsInOrder(['Unknown platform "chromium".', '^^^^^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test("uncustomizable platforms can't be overridden", () async {
+ await d.file('dart_test.yaml', '''
+ override_platforms:
+ vm:
+ settings: {}
+ ''').create();
+
+ var test = await runTest(['-p', 'vm', 'test.dart']);
+ expect(test.stdout,
+ containsInOrder(['The "vm" platform can\'t be customized.', '^^']));
+ await test.shouldExit(1);
+ });
+
+ group('when overriding browsers', () {
+ test('executable must be a string or map', () async {
+ await d.file('dart_test.yaml', '''
+ override_platforms:
+ chrome:
+ settings:
+ executable: 12
+ ''').create();
+
+ var test = await runTest(['-p', 'chrome', 'test.dart']);
+ expect(test.stdout,
+ containsInOrder(['Must be a map or a string.', '^^']));
+ await test.shouldExit(1);
+ });
+
+ test('executable string may not be relative on POSIX', () async {
+ await d.file('dart_test.yaml', '''
+ override_platforms:
+ chrome:
+ settings:
+ executable: foo/bar
+ ''').create();
+
+ var test = await runTest(['-p', 'chrome', 'test.dart']);
+ expect(
+ test.stdout,
+ containsInOrder([
+ 'Linux and Mac OS executables may not be relative paths.',
+ '^^^^^^^'
+ ]));
+ await test.shouldExit(1);
+ },
+ // We allow relative executables for Windows so that Windows users
+ // can set a global executable without having to explicitly write
+ // `windows:`.
+ testOn: '!windows');
+
+ test('Linux executable must be a string', () async {
+ await d.file('dart_test.yaml', '''
+ override_platforms:
+ chrome:
+ settings:
+ executable:
+ linux: 12
+ ''').create();
+
+ var test = await runTest(['-p', 'chrome', 'test.dart']);
+ expect(test.stdout, containsInOrder(['Must be a string.', '^^']));
+ await test.shouldExit(1);
+ });
+
+ test('Linux executable may not be relative', () async {
+ await d.file('dart_test.yaml', '''
+ override_platforms:
+ chrome:
+ settings:
+ executable:
+ linux: foo/bar
+ ''').create();
+
+ var test = await runTest(['-p', 'chrome', 'test.dart']);
+ expect(
+ test.stdout,
+ containsInOrder([
+ 'Linux and Mac OS executables may not be relative paths.',
+ '^^^^^^^'
+ ]));
+ await test.shouldExit(1);
+ });
+
+ test('Mac OS executable must be a string', () async {
+ await d.file('dart_test.yaml', '''
+ override_platforms:
+ chrome:
+ settings:
+ executable:
+ mac_os: 12
+ ''').create();
+
+ var test = await runTest(['-p', 'chrome', 'test.dart']);
+ expect(test.stdout, containsInOrder(['Must be a string.', '^^']));
+ await test.shouldExit(1);
+ });
+
+ test('Mac OS executable may not be relative', () async {
+ await d.file('dart_test.yaml', '''
+ override_platforms:
+ chrome:
+ settings:
+ executable:
+ mac_os: foo/bar
+ ''').create();
+
+ var test = await runTest(['-p', 'chrome', 'test.dart']);
+ expect(
+ test.stdout,
+ containsInOrder([
+ 'Linux and Mac OS executables may not be relative paths.',
+ '^^^^^^^'
+ ]));
+ await test.shouldExit(1);
+ });
+
+ test('Windows executable must be a string', () async {
+ await d.file('dart_test.yaml', '''
+ override_platforms:
+ chrome:
+ settings:
+ executable:
+ windows: 12
+ ''').create();
+
+ var test = await runTest(['-p', 'chrome', 'test.dart']);
+ expect(test.stdout, containsInOrder(['Must be a string.', '^^']));
+ await test.shouldExit(1);
+ });
+
+ test('executable must exist', () async {
+ await d.file('dart_test.yaml', '''
+ override_platforms:
+ chrome:
+ settings:
+ executable: _does_not_exist
+ ''').create();
+
+ var test = await runTest(['-p', 'chrome', 'test.dart']);
+ expect(
+ test.stdout,
+ emitsThrough(
+ contains('Failed to run Chrome: $noSuchFileMessage')));
+ await test.shouldExit(1);
+ });
+
+ test('executable must exist for Node.js', () async {
+ await d.file('dart_test.yaml', '''
+ override_platforms:
+ node:
+ settings:
+ executable: _does_not_exist
+ ''').create();
+
+ var test = await runTest(['-p', 'node', 'test.dart']);
+ expect(
+ test.stdout,
+ emitsThrough(
+ contains('Failed to run Node.js: $noSuchFileMessage')));
+ await test.shouldExit(1);
+ }, tags: 'node');
+
+ test('headless must be a boolean', () async {
+ await d.file('dart_test.yaml', '''
+ override_platforms:
+ chrome:
+ settings:
+ headless: definitely
+ ''').create();
+
+ var test = await runTest(['-p', 'chrome', 'test.dart']);
+ expect(
+ test.stdout,
+ emitsThrough(
+ containsInOrder(['Must be a boolean.', '^^^^^^^^^^'])));
+ await test.shouldExit(1);
+ });
+ });
+ });
+ });
+
+ group('define_platforms', () {
+ group('can define a new browser', () {
+ group('without any changes', () {
+ setUp(() async {
+ await d.file('dart_test.yaml', '''
+ define_platforms:
+ chromium:
+ name: Chromium
+ extends: chrome
+ settings: {}
+ ''').create();
+ });
+
+ test('that can be used to run tests', () async {
+ var test = await runTest(['-p', 'chromium', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains('All tests passed!')));
+ await test.shouldExit(0);
+ }, tags: 'chrome');
+
+ test('that can be used in platform selectors', () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("success", () {}, testOn: "chromium");
+ }
+ ''').create();
+
+ var test = await runTest(['-p', 'chromium', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains('All tests passed!')));
+ await test.shouldExit(0);
+
+ test = await runTest(['-p', 'chrome', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains('No tests ran.')));
+ await test.shouldExit(79);
+ }, tags: 'chrome');
+
+ test('that counts as its parent', () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("success", () {}, testOn: "chrome");
+ }
+ ''').create();
+
+ var test = await runTest(['-p', 'chromium', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains('All tests passed!')));
+ await test.shouldExit(0);
+ }, tags: 'chrome');
+ });
+
+ test('with a basename-only executable', () async {
+ await d.file('dart_test.yaml', '''
+ define_platforms:
+ my-firefox:
+ name: My Firefox
+ extends: firefox
+ settings:
+ executable:
+ linux: firefox
+ mac_os: firefox
+ windows: firefox.exe
+ ''').create();
+
+ var test = await runTest(['-p', 'my-firefox', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains('All tests passed!')));
+ await test.shouldExit(0);
+ }, tags: 'firefox');
+
+ test('with an absolute-path executable', () async {
+ String path;
+ if (Platform.isLinux) {
+ var process = await TestProcess.start('which', ['google-chrome']);
+ path = await process.stdout.next;
+ await process.shouldExit(0);
+ } else {
+ path = defaultSettings[Runtime.chrome]!.executable;
+ }
+
+ await d.file('dart_test.yaml', '''
+ define_platforms:
+ chromium:
+ name: Chromium
+ extends: chrome
+ settings:
+ executable: $path
+ ''').create();
+
+ var test = await runTest(['-p', 'chromium', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains('All tests passed!')));
+ await test.shouldExit(0);
+ }, tags: 'chrome');
+ });
+
+ group('errors', () {
+ test('rejects a non-map value', () async {
+ await d.file('dart_test.yaml', 'define_platforms: 12').create();
+
+ var test = await runTest([]);
+ expect(test.stderr,
+ containsInOrder(['define_platforms must be a map.', '^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('rejects a non-string key', () async {
+ await d.file('dart_test.yaml', 'define_platforms: {12: null}').create();
+
+ var test = await runTest([]);
+ expect(test.stderr,
+ containsInOrder(['Platform identifier must be a string.', '^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('rejects a non-identifier-like key', () async {
+ await d
+ .file('dart_test.yaml', 'define_platforms: {foo bar: null}')
+ .create();
+
+ var test = await runTest([]);
+ expect(
+ test.stderr,
+ containsInOrder([
+ 'Platform identifier must be an (optionally hyphenated) Dart '
+ 'identifier.',
+ '^^^^^^^'
+ ]));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('rejects a non-map definition', () async {
+ await d.file('dart_test.yaml', '''
+ define_platforms:
+ chromium: 12
+ ''').create();
+
+ var test = await runTest([]);
+ expect(test.stderr,
+ containsInOrder(['Platform definition must be a map.', '^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('requires a name key', () async {
+ await d.file('dart_test.yaml', '''
+ define_platforms:
+ chromium:
+ extends: chrome
+ settings: {}
+ ''').create();
+
+ var test = await runTest([]);
+ expect(
+ test.stderr,
+ containsInOrder(
+ ['Missing required field "name".', 'extends: chrome']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('name must be a string', () async {
+ await d.file('dart_test.yaml', '''
+ define_platforms:
+ chromium:
+ name: null
+ extends: chrome
+ settings: {}
+ ''').create();
+
+ var test = await runTest([]);
+ expect(test.stderr, containsInOrder(['Must be a string.', '^^^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('requires an extends key', () async {
+ await d.file('dart_test.yaml', '''
+ define_platforms:
+ chromium:
+ name: Chromium
+ settings: {}
+ ''').create();
+
+ var test = await runTest([]);
+ expect(
+ test.stderr,
+ containsInOrder(
+ ['Missing required field "extends".', 'name: Chromium']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('extends must be a string', () async {
+ await d.file('dart_test.yaml', '''
+ define_platforms:
+ chromium:
+ name: Chromium
+ extends: null
+ settings: {}
+ ''').create();
+
+ var test = await runTest([]);
+ expect(test.stderr,
+ containsInOrder(['Platform parent must be a string.', '^^^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('extends must be identifier-like', () async {
+ await d.file('dart_test.yaml', '''
+ define_platforms:
+ chromium:
+ name: Chromium
+ extends: foo bar
+ settings: {}
+ ''').create();
+
+ var test = await runTest([]);
+ expect(
+ test.stderr,
+ containsInOrder([
+ 'Platform parent must be an (optionally hyphenated) Dart '
+ 'identifier.',
+ '^^^^^^^'
+ ]));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('requires a settings key', () async {
+ await d.file('dart_test.yaml', '''
+ define_platforms:
+ chromium:
+ name: Chromium
+ extends: chrome
+ ''').create();
+
+ var test = await runTest([]);
+ expect(
+ test.stderr,
+ containsInOrder(
+ ['Missing required field "settings".', 'name: Chromium']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('settings must be a map', () async {
+ await d.file('dart_test.yaml', '''
+ define_platforms:
+ chromium:
+ name: Chromium
+ extends: chrome
+ settings: null
+ ''').create();
+
+ var test = await runTest([]);
+ expect(test.stderr, containsInOrder(['Must be a map.', '^^^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('the new platform may not override an existing platform', () async {
+ await d.file('dart_test.yaml', '''
+ define_platforms:
+ chrome:
+ name: Chromium
+ extends: firefox
+ settings: {}
+ ''').create();
+
+ await d.dir('test').create();
+
+ var test = await runTest([]);
+ expect(
+ test.stderr,
+ containsInOrder([
+ 'The platform "chrome" already exists. Use override_platforms to '
+ 'override it.',
+ '^^^^^^'
+ ]));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('the new platform must extend an existing platform', () async {
+ await d.file('dart_test.yaml', '''
+ define_platforms:
+ chromium:
+ name: Chromium
+ extends: foobar
+ settings: {}
+ ''').create();
+
+ await d.dir('test').create();
+
+ var test = await runTest([]);
+ expect(test.stderr, containsInOrder(['Unknown platform.', '^^^^^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test("the new platform can't extend an uncustomizable platform",
+ () async {
+ await d.file('dart_test.yaml', '''
+ define_platforms:
+ myvm:
+ name: My VM
+ extends: vm
+ settings: {}
+ ''').create();
+
+ var test = await runTest(['-p', 'myvm', 'test.dart']);
+ expect(test.stdout,
+ containsInOrder(['The "vm" platform can\'t be customized.', '^^']));
+ await test.shouldExit(1);
+ });
+
+ group('when overriding browsers', () {
+ test('executable must be a string or map', () async {
+ await d.file('dart_test.yaml', '''
+ define_platforms:
+ chromium:
+ name: Chromium
+ extends: chrome
+ settings:
+ executable: 12
+ ''').create();
+
+ var test = await runTest(['-p', 'chromium', 'test.dart']);
+ expect(test.stdout,
+ containsInOrder(['Must be a map or a string.', '^^']));
+ await test.shouldExit(1);
+ });
+
+ test('executable string may not be relative on POSIX', () async {
+ await d.file('dart_test.yaml', '''
+ define_platforms:
+ chromium:
+ name: Chromium
+ extends: chrome
+ settings:
+ executable: foo/bar
+ ''').create();
+
+ var test = await runTest(['-p', 'chromium', 'test.dart']);
+ expect(
+ test.stdout,
+ containsInOrder([
+ 'Linux and Mac OS executables may not be relative paths.',
+ '^^^^^^^'
+ ]));
+ await test.shouldExit(1);
+ },
+ // We allow relative executables for Windows so that Windows users
+ // can set a global executable without having to explicitly write
+ // `windows:`.
+ testOn: '!windows');
+
+ test('Linux executable must be a string', () async {
+ await d.file('dart_test.yaml', '''
+ define_platforms:
+ chromium:
+ name: Chromium
+ extends: chrome
+ settings:
+ executable:
+ linux: 12
+ ''').create();
+
+ var test = await runTest(['-p', 'chromium', 'test.dart']);
+ expect(test.stdout, containsInOrder(['Must be a string.', '^^']));
+ await test.shouldExit(1);
+ });
+
+ test('Linux executable may not be relative', () async {
+ await d.file('dart_test.yaml', '''
+ define_platforms:
+ chromium:
+ name: Chromium
+ extends: chrome
+ settings:
+ executable:
+ linux: foo/bar
+ ''').create();
+
+ var test = await runTest(['-p', 'chromium', 'test.dart']);
+ expect(
+ test.stdout,
+ containsInOrder([
+ 'Linux and Mac OS executables may not be relative paths.',
+ '^^^^^^^'
+ ]));
+ await test.shouldExit(1);
+ });
+
+ test('Mac OS executable must be a string', () async {
+ await d.file('dart_test.yaml', '''
+ define_platforms:
+ chromium:
+ name: Chromium
+ extends: chrome
+ settings:
+ executable:
+ mac_os: 12
+ ''').create();
+
+ var test = await runTest(['-p', 'chromium', 'test.dart']);
+ expect(test.stdout, containsInOrder(['Must be a string.', '^^']));
+ await test.shouldExit(1);
+ });
+
+ test('Mac OS executable may not be relative', () async {
+ await d.file('dart_test.yaml', '''
+ define_platforms:
+ chromium:
+ name: Chromium
+ extends: chrome
+ settings:
+ executable:
+ mac_os: foo/bar
+ ''').create();
+
+ var test = await runTest(['-p', 'chromium', 'test.dart']);
+ expect(
+ test.stdout,
+ containsInOrder([
+ 'Linux and Mac OS executables may not be relative paths.',
+ '^^^^^^^'
+ ]));
+ await test.shouldExit(1);
+ });
+
+ test('Windows executable must be a string', () async {
+ await d.file('dart_test.yaml', '''
+ define_platforms:
+ chromium:
+ name: Chromium
+ extends: chrome
+ settings:
+ executable:
+ windows: 12
+ ''').create();
+
+ var test = await runTest(['-p', 'chromium', 'test.dart']);
+ expect(test.stdout, containsInOrder(['Must be a string.', '^^']));
+ await test.shouldExit(1);
+ });
+
+ test('executable must exist', () async {
+ await d.file('dart_test.yaml', '''
+ define_platforms:
+ chromium:
+ name: Chromium
+ extends: chrome
+ settings:
+ executable: _does_not_exist
+ ''').create();
+
+ var test = await runTest(['-p', 'chromium', 'test.dart']);
+ expect(
+ test.stdout,
+ emitsThrough(
+ contains('Failed to run Chrome: $noSuchFileMessage')));
+ await test.shouldExit(1);
+ });
+
+ test('arguments must be a string', () async {
+ await d.file('dart_test.yaml', '''
+ define_platforms:
+ chromium:
+ name: Chromium
+ extends: chrome
+ settings:
+ arguments: 12
+ ''').create();
+
+ var test = await runTest(['-p', 'chromium', 'test.dart']);
+ expect(test.stdout, containsInOrder(['Must be a string.', '^^']));
+ await test.shouldExit(1);
+ });
+
+ test('arguments must be shell parseable', () async {
+ await d.file('dart_test.yaml', '''
+ define_platforms:
+ chromium:
+ name: Chromium
+ extends: chrome
+ settings:
+ arguments: --foo 'bar
+ ''').create();
+
+ var test = await runTest(['-p', 'chromium', 'test.dart']);
+ expect(test.stdout,
+ containsInOrder(['Unmatched single quote.', '^^^^^^^^^^']));
+ await test.shouldExit(1);
+ });
+
+ test('headless must be a boolean', () async {
+ await d.file('dart_test.yaml', '''
+ define_platforms:
+ chromium:
+ name: Chromium
+ extends: chrome
+ settings:
+ headless: definitely
+ ''').create();
+
+ var test = await runTest(['-p', 'chromium', 'test.dart']);
+ expect(
+ test.stdout,
+ emitsThrough(
+ containsInOrder(['Must be a boolean.', '^^^^^^^^^^'])));
+ await test.shouldExit(1);
+ });
+
+ test('with an argument that causes the browser to quit', () async {
+ await d.file('dart_test.yaml', '''
+ define_platforms:
+ myfox:
+ name: My Firefox
+ extends: firefox
+ settings:
+ arguments: --version
+ ''').create();
+
+ var test = await runTest(['-p', 'myfox', 'test.dart']);
+ expect(test.stdout,
+ emitsThrough(contains('My Firefox exited before connecting.')));
+ await test.shouldExit(1);
+ }, tags: 'firefox');
+ });
+ });
+ });
+}
diff --git a/pkgs/test/test/runner/configuration/duplicate_names_test.dart b/pkgs/test/test/runner/configuration/duplicate_names_test.dart
new file mode 100644
index 0000000..5a02f52
--- /dev/null
+++ b/pkgs/test/test/runner/configuration/duplicate_names_test.dart
@@ -0,0 +1,82 @@
+// Copyright (c) 2021, 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.
+
+@TestOn('vm')
+library;
+
+import 'dart:convert';
+
+import 'package:path/path.dart' as p;
+import 'package:test/test.dart';
+import 'package:test_descriptor/test_descriptor.dart' as d;
+
+import '../../io.dart';
+
+void main() {
+ setUpAll(precompileTestExecutable);
+
+ group('duplicate names', () {
+ group('can be disabled for', () {
+ for (var function in ['group', 'test']) {
+ test('${function}s', () async {
+ await d
+ .file('dart_test.yaml',
+ jsonEncode({'allow_duplicate_test_names': false}))
+ .create();
+
+ var testName = 'test';
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ $function("$testName", () {});
+ $function("$testName", () {});
+ }
+ ''').create();
+
+ var test = await runTest([
+ 'test.dart',
+ '--configuration',
+ p.join(d.sandbox, 'dart_test.yaml')
+ ]);
+
+ expect(
+ test.stdout,
+ emitsThrough(contains(
+ 'A test with the name "$testName" was already declared.')));
+
+ await test.shouldExit(1);
+ });
+ }
+ });
+ group('are allowed by default for', () {
+ for (var function in ['group', 'test']) {
+ test('${function}s', () async {
+ var testName = 'test';
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ $function("$testName", () {});
+ $function("$testName", () {});
+
+ // Needed so at least one test runs when testing groups.
+ test('a test', () {
+ expect(true, isTrue);
+ });
+ }
+ ''').create();
+
+ var test = await runTest(
+ ['test.dart'],
+ );
+
+ expect(test.stdout, emitsThrough(contains('All tests passed!')));
+
+ await test.shouldExit(0);
+ });
+ }
+ });
+ });
+}
diff --git a/pkgs/test/test/runner/configuration/global_test.dart b/pkgs/test/test/runner/configuration/global_test.dart
new file mode 100644
index 0000000..98e8741
--- /dev/null
+++ b/pkgs/test/test/runner/configuration/global_test.dart
@@ -0,0 +1,122 @@
+// Copyright (c) 2016, 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.
+
+@TestOn('vm')
+library;
+
+import 'dart:convert';
+
+import 'package:test/test.dart';
+import 'package:test_core/src/util/exit_codes.dart' as exit_codes;
+import 'package:test_descriptor/test_descriptor.dart' as d;
+
+import '../../io.dart';
+
+void main() {
+ setUpAll(precompileTestExecutable);
+
+ test('ignores an empty file', () async {
+ await d.file('global_test.yaml', '').create();
+
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("success", () {});
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart'],
+ environment: {'DART_TEST_CONFIG': 'global_test.yaml'});
+ expect(test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ test('uses supported test configuration', () async {
+ await d
+ .file('global_test.yaml', jsonEncode({'verbose_trace': true}))
+ .create();
+
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("failure", () => throw "oh no");
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart'],
+ environment: {'DART_TEST_CONFIG': 'global_test.yaml'});
+ expect(test.stdout, emitsThrough(contains('dart:async')));
+ await test.shouldExit(1);
+ });
+
+ test('uses supported runner configuration', () async {
+ await d.file('global_test.yaml', jsonEncode({'reporter': 'json'})).create();
+
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("success", () {});
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart'],
+ environment: {'DART_TEST_CONFIG': 'global_test.yaml'});
+ expect(test.stdout, emitsThrough(contains('"testStart"')));
+ await test.shouldExit(0);
+ });
+
+ test('local configuration takes precedence', () async {
+ await d
+ .file('global_test.yaml', jsonEncode({'verbose_trace': true}))
+ .create();
+
+ await d
+ .file('dart_test.yaml', jsonEncode({'verbose_trace': false}))
+ .create();
+
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("failure", () => throw "oh no");
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart'],
+ environment: {'DART_TEST_CONFIG': 'global_test.yaml'});
+ expect(test.stdout, neverEmits(contains('dart:isolate-patch')));
+ await test.shouldExit(1);
+ });
+
+ group('disallows local-only configuration:', () {
+ for (var field in [
+ 'skip', 'retry', 'test_on', 'paths', 'filename', 'names', 'tags', //
+ 'plain_names', 'include_tags', 'exclude_tags', 'add_tags',
+ 'define_platforms', 'allow_duplicate_test_names',
+ ]) {
+ test('for $field', () async {
+ await d.file('global_test.yaml', jsonEncode({field: null})).create();
+
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("success", () {});
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart'],
+ environment: {'DART_TEST_CONFIG': 'global_test.yaml'});
+ expect(
+ test.stderr,
+ containsInOrder(
+ ["of global_test.yaml: $field isn't supported here.", '^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+ }
+ });
+}
diff --git a/pkgs/test/test/runner/configuration/include_test.dart b/pkgs/test/test/runner/configuration/include_test.dart
new file mode 100644
index 0000000..5d064cf
--- /dev/null
+++ b/pkgs/test/test/runner/configuration/include_test.dart
@@ -0,0 +1,170 @@
+// Copyright (c) 2018, 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.
+
+@TestOn('vm')
+library;
+
+import 'package:path/path.dart' as p;
+import 'package:test/test.dart';
+import 'package:test_core/src/runner/configuration.dart';
+import 'package:test_descriptor/test_descriptor.dart' as d;
+
+void main() {
+ test('should merge with a base configuration', () async {
+ await d.dir('repo', [
+ d.file('dart_test_base.yaml', 'filename: "test_*.dart"'),
+ d.dir('pkg', [
+ d.file('dart_test.yaml', '''
+ include: ../dart_test_base.yaml
+ concurrency: 3
+ '''),
+ ]),
+ ]).create();
+
+ var path = p.join(d.sandbox, 'repo', 'pkg', 'dart_test.yaml');
+ var config = Configuration.load(path);
+ expect(config.filename.pattern, equals('test_*.dart'));
+ expect(config.concurrency, equals(3));
+ });
+
+ test('should merge fields with a base configuration', () async {
+ await d.dir('repo', [
+ d.file('dart_test_base.yaml', '''
+ tags:
+ hello:
+ '''),
+ d.dir('pkg', [
+ d.file('dart_test.yaml', '''
+ include: ../dart_test_base.yaml
+ tags:
+ world:
+ '''),
+ ]),
+ ]).create();
+
+ var path = p.join(d.sandbox, 'repo', 'pkg', 'dart_test.yaml');
+ var config = Configuration.load(path);
+ expect(config.knownTags, unorderedEquals(['hello', 'world']));
+ });
+
+ test('should allow an included file to include a file', () async {
+ await d.dir('repo', [
+ d.file('dart_test_base_base.yaml', '''
+ tags:
+ tag:
+ '''),
+ d.file('dart_test_base.yaml', '''
+ include: dart_test_base_base.yaml
+ filename: "test_*.dart"
+ '''),
+ d.dir('pkg', [
+ d.file('dart_test.yaml', '''
+ include: ../dart_test_base.yaml
+ concurrency: 3
+ '''),
+ ]),
+ ]).create();
+
+ var path = p.join(d.sandbox, 'repo', 'pkg', 'dart_test.yaml');
+ var config = Configuration.load(path);
+ expect(config.knownTags, ['tag']);
+ expect(config.filename.pattern, 'test_*.dart');
+ expect(config.concurrency, 3);
+ });
+
+ test('should not allow an include field in a test config context', () async {
+ await d.dir('repo', [
+ d.dir('pkg', [
+ d.file('dart_test.yaml', r'''
+ tags:
+ foo:
+ include: ../dart_test.yaml
+ '''),
+ ]),
+ ]).create();
+
+ var path = p.join(d.sandbox, 'repo', 'pkg', 'dart_test.yaml');
+ expect(
+ () => Configuration.load(path),
+ throwsA(allOf(
+ isFormatException,
+ predicate((error) =>
+ error.toString().contains("include isn't supported here")))));
+ });
+
+ test('should allow an include field in a runner config context', () async {
+ await d.dir('repo', [
+ d.dir('pkg', [
+ d.file('dart_test.yaml', '''
+ presets:
+ bar:
+ include: other_dart_test.yaml
+ pause_after_load: true
+ '''),
+ d.file('other_dart_test.yaml', 'reporter: expanded'),
+ ]),
+ ]).create();
+
+ var path = p.join(d.sandbox, 'repo', 'pkg', 'dart_test.yaml');
+ var config = Configuration.load(path);
+ var presetBar = config.presets['bar']!;
+ expect(presetBar.pauseAfterLoad, isTrue);
+ expect(presetBar.reporter, 'expanded');
+ });
+
+ test('local configuration should take precedence after merging', () async {
+ await d.dir('repo', [
+ d.dir('pkg', [
+ d.file('dart_test.yaml', '''
+ include: other_dart_test.yaml
+ concurrency: 5
+ '''),
+ d.file('other_dart_test.yaml', 'concurrency: 10'),
+ ]),
+ ]).create();
+
+ var path = p.join(d.sandbox, 'repo', 'pkg', 'dart_test.yaml');
+ var config = Configuration.load(path);
+ expect(config.concurrency, 5);
+ });
+
+ group('gracefully handles', () {
+ test('a non-string include field', () async {
+ await d.dir('repo', [
+ d.dir('pkg', [
+ d.file('dart_test.yaml', 'include: 3'),
+ ]),
+ ]).create();
+
+ var path = p.join(d.sandbox, 'repo', 'pkg', 'dart_test.yaml');
+ expect(() => Configuration.load(path), throwsFormatException);
+ });
+
+ test('a non-existent included file', () async {
+ await d.dir('repo', [
+ d.dir('pkg', [
+ d.file('dart_test.yaml', 'include: other_test.yaml'),
+ ]),
+ ]).create();
+
+ var path = p.join(d.sandbox, 'repo', 'pkg', 'dart_test.yaml');
+ expect(() => Configuration.load(path), throwsFormatException);
+ });
+
+ test('an include field in a test config context', () async {
+ await d.dir('repo', [
+ d.dir('pkg', [
+ d.file('dart_test.yaml', '''
+ tags:
+ foo:
+ include: ../dart_test.yaml
+ '''),
+ ]),
+ ]).create();
+
+ var path = p.join(d.sandbox, 'repo', 'pkg', 'dart_test.yaml');
+ expect(() => Configuration.load(path), throwsFormatException);
+ });
+ });
+}
diff --git a/pkgs/test/test/runner/configuration/platform_test.dart b/pkgs/test/test/runner/configuration/platform_test.dart
new file mode 100644
index 0000000..014c0ed
--- /dev/null
+++ b/pkgs/test/test/runner/configuration/platform_test.dart
@@ -0,0 +1,310 @@
+// Copyright (c) 2016, 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.
+
+@TestOn('vm')
+library;
+
+import 'dart:convert';
+
+import 'package:test/test.dart';
+import 'package:test_core/src/util/exit_codes.dart' as exit_codes;
+import 'package:test_core/src/util/io.dart';
+import 'package:test_descriptor/test_descriptor.dart' as d;
+
+import '../../io.dart';
+
+void main() {
+ setUpAll(precompileTestExecutable);
+
+ group('on_platform', () {
+ test('applies platform-specific configuration to matching tests', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'on_platform': {
+ 'chrome': {'timeout': '0s'}
+ }
+ }))
+ .create();
+
+ await d.file('test.dart', '''
+ import 'dart:async';
+
+ import 'package:test/test.dart';
+
+ void main() {
+ test("test", () => Future.delayed(Duration.zero));
+ }
+ ''').create();
+
+ var test = await runTest(['-p', 'chrome,vm', 'test.dart']);
+ expect(
+ test.stdout,
+ containsInOrder(
+ ['-1: [Chrome, Dart2Js] test [E]', '+1 -1: Some tests failed.']));
+ await test.shouldExit(1);
+ }, tags: ['chrome']);
+
+ test('supports platform selectors', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'on_platform': {
+ 'chrome || vm': {'timeout': '0s'}
+ }
+ }))
+ .create();
+
+ await d.file('test.dart', '''
+ import 'dart:async';
+
+ import 'package:test/test.dart';
+
+ void main() {
+ test("test", () => Future.delayed(Duration.zero));
+ }
+ ''').create();
+
+ var test = await runTest(['-p', 'chrome,vm', 'test.dart']);
+ expect(
+ test.stdout,
+ containsInOrder([
+ '-1: [Chrome, Dart2Js] test [E]',
+ '-2: [VM, Kernel] test [E]',
+ '-2: Some tests failed.'
+ ]));
+ await test.shouldExit(1);
+ }, tags: ['chrome']);
+
+ group('errors', () {
+ test('rejects an invalid selector type', () async {
+ await d.file('dart_test.yaml', '{"on_platform": {12: null}}').create();
+
+ var test = await runTest([]);
+ expect(test.stderr,
+ containsInOrder(['on_platform key must be a string', '^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('rejects an invalid selector', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'on_platform': {'foo bar': null}
+ }))
+ .create();
+
+ var test = await runTest([]);
+ expect(
+ test.stderr,
+ containsInOrder([
+ 'Invalid on_platform key: Expected end of input.',
+ '^^^^^^^^^'
+ ]));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('rejects a selector with an undefined variable', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'on_platform': {'foo': null}
+ }))
+ .create();
+
+ await d.dir('test').create();
+
+ var test = await runTest([]);
+ expect(test.stderr, containsInOrder(['Undefined variable.', '^^^^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('rejects an invalid map', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'on_platform': {'linux': 12}
+ }))
+ .create();
+
+ var test = await runTest([]);
+ expect(test.stderr,
+ containsInOrder(['on_platform value must be a map.', '^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('rejects an invalid configuration', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'on_platform': {
+ 'linux': {'timeout': '12p'}
+ }
+ }))
+ .create();
+
+ var test = await runTest([]);
+ expect(test.stderr,
+ containsInOrder(['Invalid timeout: expected unit.', '^^^^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('rejects runner configuration', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'on_platform': {
+ 'linux': {'filename': '*_blorp'}
+ }
+ }))
+ .create();
+
+ var test = await runTest([]);
+ expect(test.stderr,
+ containsInOrder(["filename isn't supported here.", '^^^^^^^^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+ });
+ });
+
+ group('on_os', () {
+ test('applies OS-specific configuration on a matching OS', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'on_os': {
+ currentOS.identifier: {'filename': 'test_*.dart'}
+ }
+ }))
+ .create();
+
+ await d.file('foo_test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("foo_test", () {});
+ }
+ ''').create();
+
+ await d.file('test_foo.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("test_foo", () {});
+ }
+ ''').create();
+
+ var test = await runTest(['.']);
+ expect(
+ test.stdout,
+ containsInOrder(
+ ['+0: ./test_foo.dart: test_foo', '+1: All tests passed!']));
+ await test.shouldExit(0);
+ });
+
+ test("doesn't apply OS-specific configuration on a non-matching OS",
+ () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'on_os': {
+ otherOS: {'filename': 'test_*.dart'}
+ }
+ }))
+ .create();
+
+ await d.file('foo_test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("foo_test", () {});
+ }
+ ''').create();
+
+ await d.file('test_foo.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("test_foo", () {});
+ }
+ ''').create();
+
+ var test = await runTest(['.']);
+ expect(
+ test.stdout,
+ containsInOrder(
+ ['+0: ./foo_test.dart: foo_test', '+1: All tests passed!']));
+ await test.shouldExit(0);
+ });
+
+ group('errors', () {
+ test('rejects an invalid OS type', () async {
+ await d.file('dart_test.yaml', '{"on_os": {12: null}}').create();
+
+ var test = await runTest([]);
+ expect(
+ test.stderr, containsInOrder(['on_os key must be a string', '^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('rejects an unknown OS name', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'on_os': {'foo': null}
+ }))
+ .create();
+
+ var test = await runTest([]);
+ expect(
+ test.stderr,
+ containsInOrder(
+ ['Invalid on_os key: No such operating system.', '^^^^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('rejects an invalid map', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'on_os': {'linux': 12}
+ }))
+ .create();
+
+ var test = await runTest([]);
+ expect(
+ test.stderr, containsInOrder(['on_os value must be a map.', '^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('rejects an invalid configuration', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'on_os': {
+ 'linux': {'timeout': '12p'}
+ }
+ }))
+ .create();
+
+ var test = await runTest([]);
+ expect(test.stderr,
+ containsInOrder(['Invalid timeout: expected unit.', '^^^^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+ });
+ });
+}
diff --git a/pkgs/test/test/runner/configuration/presets_test.dart b/pkgs/test/test/runner/configuration/presets_test.dart
new file mode 100644
index 0000000..193f12e
--- /dev/null
+++ b/pkgs/test/test/runner/configuration/presets_test.dart
@@ -0,0 +1,515 @@
+// Copyright (c) 2016, 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.
+
+@TestOn('vm')
+library;
+
+import 'dart:convert';
+
+import 'package:test/test.dart';
+import 'package:test_core/src/util/exit_codes.dart' as exit_codes;
+import 'package:test_core/src/util/io.dart';
+import 'package:test_descriptor/test_descriptor.dart' as d;
+
+import '../../io.dart';
+
+void main() {
+ setUpAll(precompileTestExecutable);
+
+ group('presets', () {
+ test("don't do anything by default", () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'presets': {
+ 'foo': {'timeout': '0s'}
+ }
+ }))
+ .create();
+
+ await d.file('test.dart', '''
+ import 'dart:async';
+
+ import 'package:test/test.dart';
+
+ void main() {
+ test("test", () => Future.delayed(Duration.zero));
+ }
+ ''').create();
+
+ await (await runTest(['test.dart'])).shouldExit(0);
+ });
+
+ test('can be selected on the command line', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'presets': {
+ 'foo': {'timeout': '0s'}
+ }
+ }))
+ .create();
+
+ await d.file('test.dart', '''
+ import 'dart:async';
+
+ import 'package:test/test.dart';
+
+ void main() {
+ test("test", () => Future.delayed(Duration.zero));
+ }
+ ''').create();
+
+ var test = await runTest(['-P', 'foo', 'test.dart']);
+ expect(test.stdout,
+ containsInOrder(['-1: test [E]', '-1: Some tests failed.']));
+ await test.shouldExit(1);
+ });
+
+ test('multiple presets can be selected', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'presets': {
+ 'foo': {'timeout': '0s'},
+ 'bar': {
+ 'paths': ['test.dart']
+ }
+ }
+ }))
+ .create();
+
+ await d.file('test.dart', '''
+ import 'dart:async';
+
+ import 'package:test/test.dart';
+
+ void main() {
+ test("test", () => Future.delayed(Duration.zero));
+ }
+ ''').create();
+
+ var test = await runTest(['-P', 'foo,bar']);
+ expect(test.stdout,
+ containsInOrder(['-1: test [E]', '-1: Some tests failed.']));
+ await test.shouldExit(1);
+ });
+
+ test('the latter preset takes precedence', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'presets': {
+ 'foo': {'timeout': '0s'},
+ 'bar': {'timeout': '30s'}
+ }
+ }))
+ .create();
+
+ await d.file('test.dart', '''
+ import 'dart:async';
+
+ import 'package:test/test.dart';
+
+ void main() {
+ test("test", () => Future.delayed(Duration.zero));
+ }
+ ''').create();
+
+ await (await runTest(['-P', 'foo,bar', 'test.dart'])).shouldExit(0);
+
+ var test = await runTest(['-P', 'bar,foo', 'test.dart']);
+ expect(test.stdout,
+ containsInOrder(['-1: test [E]', '-1: Some tests failed.']));
+ await test.shouldExit(1);
+ });
+
+ test('a preset takes precedence over the base configuration', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'presets': {
+ 'foo': {'timeout': '0s'}
+ },
+ 'timeout': '30s'
+ }))
+ .create();
+
+ await d.file('test.dart', '''
+ import 'dart:async';
+
+ import 'package:test/test.dart';
+
+ void main() {
+ test("test", () => Future.delayed(Duration.zero));
+ }
+ ''').create();
+
+ var test = await runTest(['-P', 'foo', 'test.dart']);
+ expect(test.stdout,
+ containsInOrder(['-1: test [E]', '-1: Some tests failed.']));
+ await test.shouldExit(1);
+
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'presets': {
+ 'foo': {'timeout': '30s'}
+ },
+ 'timeout': '00s'
+ }))
+ .create();
+
+ await (await runTest(['-P', 'foo', 'test.dart'])).shouldExit(0);
+ });
+
+ test('a nested preset is activated', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'tags': {
+ 'foo': {
+ 'presets': {
+ 'bar': {'timeout': '0s'}
+ },
+ },
+ }
+ }))
+ .create();
+
+ await d.file('test.dart', '''
+ import 'dart:async';
+
+ import 'package:test/test.dart';
+
+ void main() {
+ test("test 1", () => Future.delayed(Duration.zero), tags: "foo");
+ test("test 2", () => Future.delayed(Duration.zero));
+ }
+ ''').create();
+
+ var test = await runTest(['-P', 'bar', 'test.dart']);
+ expect(test.stdout,
+ containsInOrder(['+0 -1: test 1 [E]', '+1 -1: Some tests failed.']));
+ await test.shouldExit(1);
+
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'presets': {
+ 'foo': {'timeout': '30s'}
+ },
+ 'timeout': '00s'
+ }))
+ .create();
+
+ await (await runTest(['-P', 'foo', 'test.dart'])).shouldExit(0);
+ });
+ });
+
+ group('add_presets', () {
+ test('selects a preset', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'presets': {
+ 'foo': {'timeout': '0s'}
+ },
+ 'add_presets': ['foo']
+ }))
+ .create();
+
+ await d.file('test.dart', '''
+ import 'dart:async';
+
+ import 'package:test/test.dart';
+
+ void main() {
+ test("test", () => Future.delayed(Duration.zero));
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stdout,
+ containsInOrder(['-1: test [E]', '-1: Some tests failed.']));
+ await test.shouldExit(1);
+ });
+
+ test('applies presets in selection order', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'presets': {
+ 'foo': {'timeout': '0s'},
+ 'bar': {'timeout': '30s'}
+ },
+ 'add_presets': ['foo', 'bar']
+ }))
+ .create();
+
+ await d.file('test.dart', '''
+ import 'dart:async';
+
+ import 'package:test/test.dart';
+
+ void main() {
+ test("test", () => Future.delayed(Duration.zero));
+ }
+ ''').create();
+
+ await (await runTest(['test.dart'])).shouldExit(0);
+
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'presets': {
+ 'foo': {'timeout': '0s'},
+ 'bar': {'timeout': '30s'}
+ },
+ 'add_presets': ['bar', 'foo']
+ }))
+ .create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stdout,
+ containsInOrder(['-1: test [E]', '-1: Some tests failed.']));
+ await test.shouldExit(1);
+ });
+
+ test('allows preset inheritance via add_presets', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'presets': {
+ 'foo': {
+ 'add_presets': ['bar']
+ },
+ 'bar': {'timeout': '0s'}
+ }
+ }))
+ .create();
+
+ await d.file('test.dart', '''
+ import 'dart:async';
+
+ import 'package:test/test.dart';
+
+ void main() {
+ test("test", () => Future.delayed(Duration.zero));
+ }
+ ''').create();
+
+ var test = await runTest(['-P', 'foo', 'test.dart']);
+ expect(test.stdout,
+ containsInOrder(['+0 -1: test [E]', '-1: Some tests failed.']));
+ await test.shouldExit(1);
+ });
+
+ test('allows circular preset inheritance via add_presets', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'presets': {
+ 'foo': {
+ 'add_presets': ['bar']
+ },
+ 'bar': {
+ 'add_presets': ['foo']
+ }
+ }
+ }))
+ .create();
+
+ await d.file('test.dart', '''
+ import 'dart:async';
+
+ import 'package:test/test.dart';
+
+ void main() {
+ test("test", () {});
+ }
+ ''').create();
+
+ await (await runTest(['-P', 'foo', 'test.dart'])).shouldExit(0);
+ });
+ });
+
+ group('errors', () {
+ group('presets', () {
+ test('rejects an invalid preset type', () async {
+ await d.file('dart_test.yaml', '{"presets": {12: null}}').create();
+
+ var test = await runTest([]);
+ expect(test.stderr,
+ containsInOrder(['presets key must be a string', '^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('rejects an invalid preset name', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'presets': {'foo bar': null}
+ }))
+ .create();
+
+ var test = await runTest([]);
+ expect(
+ test.stderr,
+ containsInOrder([
+ 'presets key must be an (optionally hyphenated) Dart identifier.',
+ '^^^^^^^^^'
+ ]));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('rejects an invalid preset map', () async {
+ await d.file('dart_test.yaml', jsonEncode({'presets': 12})).create();
+
+ var test = await runTest([]);
+ expect(test.stderr, containsInOrder(['presets must be a map', '^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('rejects an invalid preset configuration', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'presets': {
+ 'foo': {'timeout': '12p'}
+ }
+ }))
+ .create();
+
+ var test = await runTest([]);
+ expect(test.stderr,
+ containsInOrder(['Invalid timeout: expected unit', '^^^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('rejects runner configuration in a non-runner context', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'tags': {
+ 'foo': {
+ 'presets': {
+ 'bar': {'filename': '*_blorp.dart'}
+ }
+ }
+ }
+ }))
+ .create();
+
+ var test = await runTest([]);
+ expect(test.stderr,
+ containsInOrder(["filename isn't supported here.", '^^^^^^^^^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('fails if an undefined preset is passed', () async {
+ var test = await runTest(['-P', 'foo']);
+ expect(test.stderr, emitsThrough(contains('Undefined preset "foo".')));
+ await test.shouldExit(exit_codes.usage);
+ });
+
+ test('fails if an undefined preset is added', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'add_presets': ['foo', 'bar']
+ }))
+ .create();
+
+ var test = await runTest([]);
+ expect(test.stderr,
+ emitsThrough(contains('Undefined presets "foo" and "bar".')));
+ await test.shouldExit(exit_codes.usage);
+ });
+
+ test('fails if an undefined preset is added in a nested context',
+ () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'on_os': {
+ currentOS.identifier: {
+ 'add_presets': ['bar']
+ }
+ }
+ }))
+ .create();
+
+ var test = await runTest([]);
+ expect(test.stderr, emitsThrough(contains('Undefined preset "bar".')));
+ await test.shouldExit(exit_codes.usage);
+ });
+ });
+
+ group('add_presets', () {
+ test('rejects an invalid list type', () async {
+ await d
+ .file('dart_test.yaml', jsonEncode({'add_presets': 'foo'}))
+ .create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stderr,
+ containsInOrder(['add_presets must be a list', '^^^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('rejects an invalid preset type', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'add_presets': [12]
+ }))
+ .create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stderr,
+ containsInOrder(['Preset name must be a string', '^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('rejects an invalid preset name', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'add_presets': ['foo bar']
+ }))
+ .create();
+
+ var test = await runTest(['test.dart']);
+ expect(
+ test.stderr,
+ containsInOrder([
+ 'Preset name must be an (optionally hyphenated) Dart identifier.',
+ '^^^^^^^^^'
+ ]));
+ await test.shouldExit(exit_codes.data);
+ });
+ });
+ });
+}
diff --git a/pkgs/test/test/runner/configuration/randomize_order_test.dart b/pkgs/test/test/runner/configuration/randomize_order_test.dart
new file mode 100644
index 0000000..690f54b
--- /dev/null
+++ b/pkgs/test/test/runner/configuration/randomize_order_test.dart
@@ -0,0 +1,234 @@
+// Copyright (c) 2016, 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.
+
+@TestOn('vm')
+library;
+
+import 'dart:convert';
+
+import 'package:test/test.dart';
+import 'package:test_descriptor/test_descriptor.dart' as d;
+
+import '../../io.dart';
+
+void main() {
+ setUpAll(precompileTestExecutable);
+
+ test('shuffles test order when passed a seed', () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("test 1", () {});
+ test("test 2", () {});
+ test("test 3", () {});
+ test("test 4", () {});
+ }
+ ''').create();
+
+ // Test with a given seed
+ var test =
+ await runTest(['test.dart', '--test-randomize-ordering-seed=987654']);
+ expect(
+ test.stdout,
+ containsInOrder([
+ '+0: test 4',
+ '+1: test 3',
+ '+2: test 1',
+ '+3: test 2',
+ '+4: All tests passed!'
+ ]));
+ await test.shouldExit(0);
+
+ // Do not shuffle when passed 0
+ test = await runTest(['test.dart', '--test-randomize-ordering-seed=0']);
+ expect(
+ test.stdout,
+ containsInOrder([
+ '+0: test 1',
+ '+1: test 2',
+ '+2: test 3',
+ '+3: test 4',
+ '+4: All tests passed!'
+ ]));
+ await test.shouldExit(0);
+
+ // Do not shuffle when passed nothing
+ test = await runTest(['test.dart']);
+ expect(
+ test.stdout,
+ containsInOrder([
+ '+0: test 1',
+ '+1: test 2',
+ '+2: test 3',
+ '+3: test 4',
+ '+4: All tests passed!'
+ ]));
+ await test.shouldExit(0);
+
+ // Shuffle when passed random
+ test =
+ await runTest(['test.dart', '--test-randomize-ordering-seed=random']);
+ expect(
+ test.stdout,
+ emitsInAnyOrder([
+ contains('Shuffling test order with --test-randomize-ordering-seed'),
+ isNot(contains(
+ 'Shuffling test order with --test-randomize-ordering-seed=0'))
+ ]));
+ await test.shouldExit(0);
+
+ // Doesn't log about shuffling with the json reporter
+ test = await runTest(
+ ['test.dart', '--test-randomize-ordering-seed=random', '-r', 'json']);
+ expect(test.stdout, neverEmits(contains('Shuffling test order')));
+ await test.shouldExit(0);
+ });
+
+ test('test shuffling can be disabled in dart_test.yml', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'tags': {
+ 'doNotShuffle': {'allow_test_randomization': false}
+ }
+ }))
+ .create();
+
+ await d.file('test.dart', '''
+ @Tags(['doNotShuffle'])
+ import 'package:test/test.dart';
+
+ void main() {
+ test("test 1", () {});
+ test("test 2", () {});
+ test("test 3", () {});
+ test("test 4", () {});
+ }
+ ''').create();
+
+ var test =
+ await runTest(['test.dart', '--test-randomize-ordering-seed=987654']);
+ expect(
+ test.stdout,
+ containsInOrder([
+ '+0: test 1',
+ '+1: test 2',
+ '+2: test 3',
+ '+3: test 4',
+ '+4: All tests passed!'
+ ]));
+ await test.shouldExit(0);
+ });
+
+ test('shuffles each suite with the same seed', () async {
+ await d.file('1_test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("test 1.1", () {});
+ test("test 1.2", () {});
+ test("test 1.3", () {});
+ }
+ ''').create();
+
+ await d.file('2_test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("test 2.1", () {});
+ test("test 2.2", () {});
+ test("test 2.3", () {});
+ }
+ ''').create();
+
+ var test = await runTest(['.', '--test-randomize-ordering-seed=12345']);
+ expect(
+ test.stdout,
+ emitsInAnyOrder([
+ containsInOrder([
+ './1_test.dart: test 1.2',
+ './1_test.dart: test 1.3',
+ './1_test.dart: test 1.1'
+ ]),
+ containsInOrder([
+ './2_test.dart: test 2.2',
+ './2_test.dart: test 2.3',
+ './2_test.dart: test 2.1'
+ ]),
+ contains('+6: All tests passed!')
+ ]));
+ await test.shouldExit(0);
+ });
+
+ test('shuffles groups as well as tests in groups', () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ group("Group 1", () {
+ test("test 1.1", () {});
+ test("test 1.2", () {});
+ test("test 1.3", () {});
+ test("test 1.4", () {});
+ });
+ group("Group 2", () {
+ test("test 2.1", () {});
+ test("test 2.2", () {});
+ test("test 2.3", () {});
+ test("test 2.4", () {});
+ });
+ }
+ ''').create();
+
+ // Test with a given seed
+ var test =
+ await runTest(['test.dart', '--test-randomize-ordering-seed=123']);
+ expect(
+ test.stdout,
+ containsInOrder([
+ '+0: Group 2 test 2.4',
+ '+1: Group 2 test 2.2',
+ '+2: Group 2 test 2.1',
+ '+3: Group 2 test 2.3',
+ '+4: Group 1 test 1.4',
+ '+5: Group 1 test 1.2',
+ '+6: Group 1 test 1.1',
+ '+7: Group 1 test 1.3',
+ '+8: All tests passed!'
+ ]));
+ await test.shouldExit(0);
+ });
+
+ test('shuffles nested groups', () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ group("Group 1", () {
+ test("test 1.1", () {});
+ test("test 1.2", () {});
+ group("Group 2", () {
+ test("test 2.3", () {});
+ test("test 2.4", () {});
+ });
+ });
+ }
+ ''').create();
+
+ var test =
+ await runTest(['test.dart', '--test-randomize-ordering-seed=123']);
+ expect(
+ test.stdout,
+ containsInOrder([
+ '+0: Group 1 test 1.1',
+ '+1: Group 1 Group 2 test 2.4',
+ '+2: Group 1 Group 2 test 2.3',
+ '+3: Group 1 test 1.2',
+ '+4: All tests passed!'
+ ]));
+ await test.shouldExit(0);
+ });
+}
diff --git a/pkgs/test/test/runner/configuration/suite_test.dart b/pkgs/test/test/runner/configuration/suite_test.dart
new file mode 100644
index 0000000..1c2fc62
--- /dev/null
+++ b/pkgs/test/test/runner/configuration/suite_test.dart
@@ -0,0 +1,147 @@
+// Copyright (c) 2016, 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.
+
+@TestOn('vm')
+library;
+
+import 'package:boolean_selector/boolean_selector.dart';
+import 'package:test/test.dart';
+import 'package:test_api/src/backend/platform_selector.dart';
+import 'package:test_api/src/backend/runtime.dart';
+import 'package:test_core/src/runner/compiler_selection.dart';
+import 'package:test_core/src/runner/runtime_selection.dart';
+
+import '../../utils.dart';
+
+void main() {
+ group('merge', () {
+ group('for most fields', () {
+ test('if neither is defined, preserves the default', () {
+ var merged = suiteConfiguration().merge(suiteConfiguration());
+ expect(merged.jsTrace, isFalse);
+ expect(merged.runSkipped, isFalse);
+ expect(merged.precompiledPath, isNull);
+ expect(merged.runtimes, equals([Runtime.vm.identifier]));
+ expect(merged.compilerSelections, isNull);
+ });
+
+ test("if only the old configuration's is defined, uses it", () {
+ var merged = suiteConfiguration(
+ jsTrace: true,
+ runSkipped: true,
+ precompiledPath: '/tmp/js',
+ runtimes: [RuntimeSelection(Runtime.chrome.identifier)],
+ compilerSelections: [CompilerSelection.parse('dart2js')])
+ .merge(suiteConfiguration());
+
+ expect(merged.jsTrace, isTrue);
+ expect(merged.runSkipped, isTrue);
+ expect(merged.precompiledPath, equals('/tmp/js'));
+ expect(merged.runtimes, equals([Runtime.chrome.identifier]));
+ expect(merged.compilerSelections,
+ equals([CompilerSelection.parse('dart2js')]));
+ });
+
+ test("if only the configuration's is defined, uses it", () {
+ var merged = suiteConfiguration().merge(suiteConfiguration(
+ jsTrace: true,
+ runSkipped: true,
+ precompiledPath: '/tmp/js',
+ runtimes: [RuntimeSelection(Runtime.chrome.identifier)],
+ compilerSelections: [CompilerSelection.parse('dart2js')]));
+
+ expect(merged.jsTrace, isTrue);
+ expect(merged.runSkipped, isTrue);
+ expect(merged.precompiledPath, equals('/tmp/js'));
+ expect(merged.runtimes, equals([Runtime.chrome.identifier]));
+ expect(merged.compilerSelections,
+ equals([CompilerSelection.parse('dart2js')]));
+ });
+
+ test(
+ "if the two configurations conflict, uses the configuration's "
+ 'values', () {
+ var older = suiteConfiguration(
+ jsTrace: false,
+ runSkipped: true,
+ precompiledPath: '/tmp/js',
+ runtimes: [RuntimeSelection(Runtime.chrome.identifier)],
+ compilerSelections: [CompilerSelection.parse('dart2js')]);
+ var newer = suiteConfiguration(
+ jsTrace: true,
+ runSkipped: false,
+ precompiledPath: '../js',
+ runtimes: [RuntimeSelection(Runtime.firefox.identifier)],
+ compilerSelections: [CompilerSelection.parse('source')]);
+ var merged = older.merge(newer);
+
+ expect(merged.jsTrace, isTrue);
+ expect(merged.runSkipped, isFalse);
+ expect(merged.precompiledPath, equals('../js'));
+ expect(merged.runtimes, equals([Runtime.firefox.identifier]));
+ expect(merged.compilerSelections,
+ equals([CompilerSelection.parse('source')]));
+ });
+ });
+
+ group('for dart2jsArgs', () {
+ test('if neither is defined, preserves the default', () {
+ var merged = suiteConfiguration().merge(suiteConfiguration());
+ expect(merged.dart2jsArgs, isEmpty);
+ });
+
+ test("if only the old configuration's is defined, uses it", () {
+ var merged = suiteConfiguration(dart2jsArgs: ['--foo', '--bar'])
+ .merge(suiteConfiguration());
+ expect(merged.dart2jsArgs, equals(['--foo', '--bar']));
+ });
+
+ test("if only the configuration's is defined, uses it", () {
+ var merged = suiteConfiguration()
+ .merge(suiteConfiguration(dart2jsArgs: ['--foo', '--bar']));
+ expect(merged.dart2jsArgs, equals(['--foo', '--bar']));
+ });
+
+ test('if both are defined, concatenates them', () {
+ var older = suiteConfiguration(dart2jsArgs: ['--foo', '--bar']);
+ var newer = suiteConfiguration(dart2jsArgs: ['--baz']);
+ var merged = older.merge(newer);
+ expect(merged.dart2jsArgs, equals(['--foo', '--bar', '--baz']));
+ });
+ });
+
+ group('for config maps', () {
+ test('merges each nested configuration', () {
+ var merged = suiteConfiguration(tags: {
+ BooleanSelector.parse('foo'):
+ suiteConfiguration(precompiledPath: 'path/'),
+ BooleanSelector.parse('bar'): suiteConfiguration(jsTrace: true)
+ }, onPlatform: {
+ PlatformSelector.parse('vm'):
+ suiteConfiguration(precompiledPath: 'path/'),
+ PlatformSelector.parse('chrome'): suiteConfiguration(jsTrace: true)
+ }).merge(suiteConfiguration(tags: {
+ BooleanSelector.parse('bar'): suiteConfiguration(jsTrace: false),
+ BooleanSelector.parse('baz'): suiteConfiguration(runSkipped: true)
+ }, onPlatform: {
+ PlatformSelector.parse('chrome'): suiteConfiguration(jsTrace: false),
+ PlatformSelector.parse('firefox'):
+ suiteConfiguration(runSkipped: true)
+ }));
+
+ expect(merged.tags[BooleanSelector.parse('foo')]!.precompiledPath,
+ equals('path/'));
+ expect(merged.tags[BooleanSelector.parse('bar')]!.jsTrace, isFalse);
+ expect(merged.tags[BooleanSelector.parse('baz')]!.runSkipped, isTrue);
+
+ expect(merged.onPlatform[PlatformSelector.parse('vm')]!.precompiledPath,
+ 'path/');
+ expect(merged.onPlatform[PlatformSelector.parse('chrome')]!.jsTrace,
+ isFalse);
+ expect(merged.onPlatform[PlatformSelector.parse('firefox')]!.runSkipped,
+ isTrue);
+ });
+ });
+ });
+}
diff --git a/pkgs/test/test/runner/configuration/tags_test.dart b/pkgs/test/test/runner/configuration/tags_test.dart
new file mode 100644
index 0000000..bbdb1d1
--- /dev/null
+++ b/pkgs/test/test/runner/configuration/tags_test.dart
@@ -0,0 +1,401 @@
+// Copyright (c) 2016, 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.
+
+@TestOn('vm')
+library;
+
+import 'dart:convert';
+
+import 'package:test/test.dart';
+import 'package:test_core/src/util/exit_codes.dart' as exit_codes;
+import 'package:test_descriptor/test_descriptor.dart' as d;
+
+import '../../io.dart';
+
+void main() {
+ setUpAll(precompileTestExecutable);
+
+ test('adds the specified tags', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'add_tags': ['foo', 'bar']
+ }))
+ .create();
+
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("test", () {});
+ }
+ ''').create();
+
+ var test = await runTest(['--exclude-tag', 'foo', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains('No tests ran.')));
+ await test.shouldExit(79);
+
+ test = await runTest(['--exclude-tag', 'bar', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains('No tests ran.')));
+ await test.shouldExit(79);
+
+ test = await runTest(['test.dart']);
+ expect(test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ group('tags', () {
+ test("doesn't warn for tags that exist in the configuration", () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'tags': {'foo': null}
+ }))
+ .create();
+
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("test", () {});
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stdout, neverEmits(contains('Warning: Tags were used')));
+ await test.shouldExit(0);
+ });
+
+ test('applies tag-specific configuration only to matching tests', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'tags': {
+ 'foo': {'timeout': '0s'}
+ }
+ }))
+ .create();
+
+ await d.file('test.dart', '''
+ import 'dart:async';
+
+ import 'package:test/test.dart';
+
+ void main() {
+ test("test 1", () => Future.delayed(Duration.zero), tags: ['foo']);
+ test("test 2", () => Future.delayed(Duration.zero));
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stdout,
+ containsInOrder(['-1: test 1 [E]', '+1 -1: Some tests failed.']));
+ await test.shouldExit(1);
+ });
+
+ test('supports tag selectors', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'tags': {
+ 'foo && bar': {'timeout': '0s'}
+ }
+ }))
+ .create();
+
+ await d.file('test.dart', '''
+ import 'dart:async';
+
+ import 'package:test/test.dart';
+
+ void main() {
+ test("test 1", () => Future.delayed(Duration.zero), tags: ['foo']);
+ test("test 2", () => Future.delayed(Duration.zero), tags: ['bar']);
+ test("test 3", () => Future.delayed(Duration.zero),
+ tags: ['foo', 'bar']);
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stdout,
+ containsInOrder(['+2 -1: test 3 [E]', '+2 -1: Some tests failed.']));
+ await test.shouldExit(1);
+ });
+
+ test('allows tag inheritance via add_tags', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'tags': {
+ 'foo': null,
+ 'bar': {
+ 'add_tags': ['foo']
+ }
+ }
+ }))
+ .create();
+
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("test 1", () {}, tags: ['bar']);
+ test("test 2", () {});
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart', '--tags', 'foo']);
+ expect(test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ // Regression test for #503.
+ test('skips tests whose tags are marked as skip', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'tags': {
+ 'foo': {'skip': 'some reason'}
+ }
+ }))
+ .create();
+
+ await d.file('test.dart', '''
+ import 'dart:async';
+
+ import 'package:test/test.dart';
+
+ void main() {
+ test("test 1", () => throw 'bad', tags: ['foo']);
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(
+ test.stdout, containsInOrder(['some reason', 'All tests skipped.']));
+ await test.shouldExit(0);
+ });
+ });
+
+ group('include_tags and exclude_tags', () {
+ test('only runs tests with the included tags', () async {
+ await d
+ .file('dart_test.yaml', jsonEncode({'include_tags': 'foo && bar'}))
+ .create();
+
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("zip", () {}, tags: "foo");
+ test("zap", () {}, tags: "bar");
+ test("zop", () {}, tags: ["foo", "bar"]);
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(
+ test.stdout, containsInOrder(['+0: zop', '+1: All tests passed!']));
+ await test.shouldExit(0);
+ });
+
+ test("doesn't run tests with the excluded tags", () async {
+ await d
+ .file('dart_test.yaml', jsonEncode({'exclude_tags': 'foo && bar'}))
+ .create();
+
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("zip", () {}, tags: "foo");
+ test("zap", () {}, tags: "bar");
+ test("zop", () {}, tags: ["foo", "bar"]);
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stdout,
+ containsInOrder(['+0: zip', '+1: zap', '+2: All tests passed!']));
+ await test.shouldExit(0);
+ });
+ });
+
+ group('errors', () {
+ group('tags', () {
+ test('rejects an invalid tag type', () async {
+ await d.file('dart_test.yaml', '{"tags": {12: null}}').create();
+
+ var test = await runTest([]);
+ expect(
+ test.stderr, containsInOrder(['tags key must be a string', '^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('rejects an invalid tag selector', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'tags': {'foo bar': null}
+ }))
+ .create();
+
+ var test = await runTest([]);
+ expect(
+ test.stderr,
+ containsInOrder(
+ ['Invalid tags key: Expected end of input.', '^^^^^^^^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('rejects an invalid tag map', () async {
+ await d.file('dart_test.yaml', jsonEncode({'tags': 12})).create();
+
+ var test = await runTest([]);
+ expect(test.stderr, containsInOrder(['tags must be a map', '^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('rejects an invalid tag configuration', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'tags': {
+ 'foo': {'timeout': '12p'}
+ }
+ }))
+ .create();
+
+ var test = await runTest([]);
+ expect(test.stderr,
+ containsInOrder(['Invalid timeout: expected unit', '^^^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('rejects runner configuration', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'tags': {
+ 'foo': {'filename': '*_blorp.dart'}
+ }
+ }))
+ .create();
+
+ var test = await runTest([]);
+ expect(test.stderr,
+ containsInOrder(["filename isn't supported here.", '^^^^^^^^^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+ });
+
+ group('add_tags', () {
+ test('rejects an invalid list type', () async {
+ await d
+ .file('dart_test.yaml', jsonEncode({'add_tags': 'foo'}))
+ .create();
+
+ var test = await runTest(['test.dart']);
+ expect(
+ test.stderr, containsInOrder(['add_tags must be a list', '^^^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('rejects an invalid tag type', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'add_tags': [12]
+ }))
+ .create();
+
+ var test = await runTest(['test.dart']);
+ expect(
+ test.stderr, containsInOrder(['Tag name must be a string', '^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('rejects an invalid tag name', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'add_tags': ['foo bar']
+ }))
+ .create();
+
+ var test = await runTest(['test.dart']);
+ expect(
+ test.stderr,
+ containsInOrder([
+ 'Tag name must be an (optionally hyphenated) Dart identifier.',
+ '^^^^^^^^^'
+ ]));
+ await test.shouldExit(exit_codes.data);
+ });
+ });
+
+ group('include_tags', () {
+ test('rejects an invalid type', () async {
+ await d
+ .file('dart_test.yaml', jsonEncode({'include_tags': 12}))
+ .create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stderr,
+ containsInOrder(['include_tags must be a string', '^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('rejects an invalid selector', () async {
+ await d
+ .file('dart_test.yaml', jsonEncode({'include_tags': 'foo bar'}))
+ .create();
+
+ var test = await runTest([]);
+ expect(
+ test.stderr,
+ containsInOrder(
+ ['Invalid include_tags: Expected end of input.', '^^^^^^^^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+ });
+
+ group('exclude_tags', () {
+ test('rejects an invalid type', () async {
+ await d
+ .file('dart_test.yaml', jsonEncode({'exclude_tags': 12}))
+ .create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stderr,
+ containsInOrder(['exclude_tags must be a string', '^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('rejects an invalid selector', () async {
+ await d
+ .file('dart_test.yaml', jsonEncode({'exclude_tags': 'foo bar'}))
+ .create();
+
+ var test = await runTest([]);
+ expect(
+ test.stderr,
+ containsInOrder(
+ ['Invalid exclude_tags: Expected end of input.', '^^^^^^^^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+ });
+ });
+}
diff --git a/pkgs/test/test/runner/configuration/top_level_error_test.dart b/pkgs/test/test/runner/configuration/top_level_error_test.dart
new file mode 100644
index 0000000..56a717c
--- /dev/null
+++ b/pkgs/test/test/runner/configuration/top_level_error_test.dart
@@ -0,0 +1,417 @@
+// Copyright (c) 2016, 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.
+
+@TestOn('vm')
+library;
+
+import 'dart:convert';
+
+import 'package:test/test.dart';
+import 'package:test_core/src/util/exit_codes.dart' as exit_codes;
+import 'package:test_descriptor/test_descriptor.dart' as d;
+
+import '../../io.dart';
+
+void main() {
+ setUpAll(precompileTestExecutable);
+
+ test('rejects an invalid fold_stack_frames', () async {
+ await d
+ .file('dart_test.yaml', jsonEncode({'fold_stack_frames': 'flup'}))
+ .create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stderr,
+ containsInOrder(['fold_stack_frames must be a map', '^^^^^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('rejects multiple fold_stack_frames keys', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'fold_stack_frames': {
+ 'except': ['blah'],
+ 'only': ['blah']
+ }
+ }))
+ .create();
+
+ var test = await runTest(['test.dart']);
+ expect(
+ test.stderr,
+ containsInOrder(
+ ['Can only contain one of "only" or "except".', '^^^^^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('rejects invalid fold_stack_frames keys', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'fold_stack_frames': {'invalid': 'blah'}
+ }))
+ .create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stderr,
+ containsInOrder(['Must be "only" or "except".', '^^^^^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('rejects invalid fold_stack_frames values', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'fold_stack_frames': {'only': 'blah'}
+ }))
+ .create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stderr,
+ containsInOrder(['Folded packages must be strings', '^^^^^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('rejects an invalid pause_after_load', () async {
+ await d
+ .file('dart_test.yaml', jsonEncode({'pause_after_load': 'flup'}))
+ .create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stderr,
+ containsInOrder(['pause_after_load must be a boolean', '^^^^^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('rejects an invalid verbose_trace', () async {
+ await d
+ .file('dart_test.yaml', jsonEncode({'verbose_trace': 'flup'}))
+ .create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stderr,
+ containsInOrder(['verbose_trace must be a boolean', '^^^^^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('rejects an invalid chain_stack_traces', () async {
+ await d
+ .file('dart_test.yaml', jsonEncode({'chain_stack_traces': 'flup'}))
+ .create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stderr,
+ containsInOrder(['chain_stack_traces must be a boolean', '^^^^^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('rejects an invalid retry', () async {
+ await d.file('dart_test.yaml', jsonEncode({'retry': 'flup'})).create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stderr,
+ containsInOrder(['retry must be a non-negative int', '^^^^^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('rejects an negative retry values', () async {
+ await d.file('dart_test.yaml', jsonEncode({'retry': -1})).create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stderr,
+ containsInOrder(['retry must be a non-negative int', '^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('rejects an invalid js_trace', () async {
+ await d.file('dart_test.yaml', jsonEncode({'js_trace': 'flup'})).create();
+
+ var test = await runTest(['test.dart']);
+ expect(
+ test.stderr, containsInOrder(['js_trace must be a boolean', '^^^^^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ group('reporter', () {
+ test('rejects an invalid type', () async {
+ await d.file('dart_test.yaml', jsonEncode({'reporter': 12})).create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stderr, containsInOrder(['reporter must be a string', '^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('rejects an invalid name', () async {
+ await d
+ .file('dart_test.yaml', jsonEncode({'reporter': 'non-existent'}))
+ .create();
+
+ var test = await runTest(['test.dart']);
+ expect(
+ test.stderr,
+ containsInOrder(
+ ['Unknown reporter "non-existent"', '^^^^^^^^^^^^^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+ });
+
+ group('file_reporters', () {
+ test('rejects an invalid type', () async {
+ await d
+ .file('dart_test.yaml', jsonEncode({'file_reporters': 12}))
+ .create();
+
+ var test = await runTest(['test.dart']);
+ expect(
+ test.stderr, containsInOrder(['file_reporters must be a map', '^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('rejects an invalid value type', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'file_reporters': {'json': 12}
+ }))
+ .create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stderr,
+ containsInOrder(['file_reporters value must be a string', '^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('rejects an invalid name', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'file_reporters': {'non-existent': 'out'}
+ }))
+ .create();
+
+ var test = await runTest(['test.dart']);
+ expect(
+ test.stderr,
+ containsInOrder(
+ ['Unknown reporter "non-existent"', '^^^^^^^^^^^^^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+ });
+
+ test('rejects an invalid concurrency', () async {
+ await d.file('dart_test.yaml', jsonEncode({'concurrency': 'foo'})).create();
+
+ var test = await runTest(['test.dart']);
+ expect(
+ test.stderr, containsInOrder(['concurrency must be an int', '^^^^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ group('timeout', () {
+ test('rejects an invalid type', () async {
+ await d.file('dart_test.yaml', jsonEncode({'timeout': 12})).create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stderr, containsInOrder(['timeout must be a string', '^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('rejects an invalid format', () async {
+ await d.file('dart_test.yaml', jsonEncode({'timeout': '12p'})).create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stderr,
+ containsInOrder(['Invalid timeout: expected unit', '^^^^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+ });
+
+ group('names', () {
+ test('rejects an invalid list type', () async {
+ await d.file('dart_test.yaml', jsonEncode({'names': 'vm'})).create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stderr, containsInOrder(['names must be a list', '^^^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('rejects an invalid member type', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'names': [12]
+ }))
+ .create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stderr, containsInOrder(['Names must be strings', '^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('rejects an invalid RegExp', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'names': ['(foo']
+ }))
+ .create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stderr,
+ containsInOrder(['Invalid name: Unterminated group', '^^^^^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+ });
+
+ group('plain_names', () {
+ test('rejects an invalid list type', () async {
+ await d
+ .file('dart_test.yaml', jsonEncode({'plain_names': 'vm'}))
+ .create();
+
+ var test = await runTest(['test.dart']);
+ expect(
+ test.stderr, containsInOrder(['plain_names must be a list', '^^^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('rejects an invalid member type', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'plain_names': [12]
+ }))
+ .create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stderr, containsInOrder(['Names must be strings', '^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+ });
+
+ group('platforms', () {
+ test('rejects an invalid list type', () async {
+ await d.file('dart_test.yaml', jsonEncode({'platforms': 'vm'})).create();
+
+ var test = await runTest(['test.dart']);
+ expect(
+ test.stderr, containsInOrder(['platforms must be a list', '^^^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('rejects an invalid member type', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'platforms': [12]
+ }))
+ .create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stderr,
+ containsInOrder(['Platform name must be a string', '^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('rejects an invalid member name', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'platforms': ['foo']
+ }))
+ .create();
+
+ await d.dir('test').create();
+
+ var test = await runTest([]);
+ expect(test.stderr, containsInOrder(['Unknown platform "foo"', '^^^^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+ });
+
+ group('paths', () {
+ test('rejects an invalid list type', () async {
+ await d.file('dart_test.yaml', jsonEncode({'paths': 'test'})).create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stderr, containsInOrder(['paths must be a list', '^^^^^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('rejects an invalid member type', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'paths': [12]
+ }))
+ .create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stderr, containsInOrder(['Paths must be strings', '^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('rejects an absolute path', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'paths': ['/foo']
+ }))
+ .create();
+
+ var test = await runTest(['test.dart']);
+ expect(
+ test.stderr, containsInOrder(['Paths must be relative.', '^^^^^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('rejects an invalid URI', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'paths': [':invalid']
+ }))
+ .create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stderr,
+ containsInOrder(['Invalid path: Invalid empty scheme', '^^^^^^^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+ });
+
+ group('filename', () {
+ test('rejects an invalid type', () async {
+ await d.file('dart_test.yaml', jsonEncode({'filename': 12})).create();
+
+ var test = await runTest(['test.dart']);
+ expect(
+ test.stderr, containsInOrder(['filename must be a string.', '^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('rejects an invalid format', () async {
+ await d.file('dart_test.yaml', jsonEncode({'filename': '{foo'})).create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stderr,
+ containsInOrder(['Invalid filename: expected ",".', '^^^^^^']));
+ await test.shouldExit(exit_codes.data);
+ });
+ });
+}
diff --git a/pkgs/test/test/runner/configuration/top_level_test.dart b/pkgs/test/test/runner/configuration/top_level_test.dart
new file mode 100644
index 0000000..9c749a4
--- /dev/null
+++ b/pkgs/test/test/runner/configuration/top_level_test.dart
@@ -0,0 +1,578 @@
+// Copyright (c) 2016, 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.
+
+@TestOn('vm')
+library;
+
+import 'dart:async';
+import 'dart:convert';
+
+import 'package:test/test.dart';
+import 'package:test_core/src/util/io.dart';
+import 'package:test_descriptor/test_descriptor.dart' as d;
+
+import '../../io.dart';
+
+void main() {
+ setUpAll(precompileTestExecutable);
+
+ test('ignores an empty file', () async {
+ await d.file('dart_test.yaml', '').create();
+
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("success", () {});
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ test('loads configuration from the path passed to --configuration', () async {
+ // Make sure dart_test.yaml is ignored.
+ await d.file('dart_test.yaml', jsonEncode({'run_skipped': true})).create();
+
+ await d.file('special_test.yaml', jsonEncode({'skip': true})).create();
+
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("test", () => throw "oh no");
+ }
+ ''').create();
+
+ var test =
+ await runTest(['--configuration', 'special_test.yaml', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains('All tests skipped.')));
+ await test.shouldExit(0);
+ });
+
+ test('pauses the test runner after a suite loads with pause_after_load: true',
+ () async {
+ await d
+ .file('dart_test.yaml', jsonEncode({'pause_after_load': true}))
+ .create();
+
+ await d.file('test.dart', '''
+import 'package:test/test.dart';
+
+void main() {
+ print('loaded test!');
+
+ test("success", () {});
+}
+''').create();
+
+ var test = await runTest(['-p', 'chrome', 'test.dart']);
+ await expectLater(test.stdout, emitsThrough('loaded test!'));
+ await expectLater(
+ test.stdout,
+ emitsInOrder([
+ '',
+ equalsIgnoringWhitespace('''
+ The test runner is paused. Open the dev console in Chrome and set
+ breakpoints. Once you're finished, return to this terminal and press
+ Enter.
+ ''')
+ ]));
+
+ var nextLineFired = false;
+
+ unawaited(test.stdout.next.then(expectAsync1((line) {
+ expect(line, contains('+0: success'));
+ nextLineFired = true;
+ })));
+
+ // Wait a little bit to be sure that the tests don't start running without
+ // our input.
+ await Future<void>.delayed(const Duration(seconds: 2));
+ expect(nextLineFired, isFalse);
+
+ test.stdin.writeln();
+ await expectLater(
+ test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ }, tags: 'chrome', onPlatform: const {
+ 'windows': Skip('https://github.com/dart-lang/test/issues/1613')
+ });
+
+ test('runs skipped tests with run_skipped: true', () async {
+ await d.file('dart_test.yaml', jsonEncode({'run_skipped': true})).create();
+
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("skip", () => print("In test!"), skip: true);
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stdout, emitsThrough(contains('In test!')));
+ expect(test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ test('includes the full stack with verbose_trace: true', () async {
+ await d
+ .file('dart_test.yaml', jsonEncode({'verbose_trace': true}))
+ .create();
+
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("failure", () => throw "oh no");
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stdout, emitsThrough(contains('dart:async')));
+ await test.shouldExit(1);
+ });
+
+ test('disables stack trace chaining with chain_stack_traces: false',
+ () async {
+ await d
+ .file('dart_test.yaml', jsonEncode({'chain_stack_traces': false}))
+ .create();
+
+ await d.file('test.dart', '''
+ import 'dart:async';
+
+ import 'package:test/test.dart';
+
+ void main() {
+ test("failure", () async{
+ await Future((){});
+ await Future((){});
+ throw "oh no";
+ });
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(
+ test.stdout,
+ containsInOrder([
+ '+0: failure',
+ '+0 -1: failure [E]',
+ 'oh no',
+ 'test.dart 9:15 main.<fn>',
+ ]));
+ await test.shouldExit(1);
+ });
+
+ test("doesn't dartify stack traces for JS-compiled tests with js_trace: true",
+ () async {
+ await d.file('dart_test.yaml', jsonEncode({'js_trace': true})).create();
+
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("failure", () => throw "oh no");
+ }
+ ''').create();
+
+ var test = await runTest(['-p', 'chrome', '--verbose-trace', 'test.dart']);
+ expect(test.stdoutStream(), neverEmits(endsWith(' main.<fn>')));
+ expect(test.stdoutStream(), neverEmits(contains('package:test')));
+ expect(test.stdoutStream(), neverEmits(contains('dart:async/zone.dart')));
+ expect(test.stdout, emitsThrough(contains('-1: Some tests failed.')));
+ await test.shouldExit(1);
+ }, tags: 'chrome');
+
+ test('retries tests with retry: 1', () async {
+ await d.file('dart_test.yaml', jsonEncode({'retry': 1})).create();
+
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+ import 'dart:async';
+
+ var attempt = 0;
+ void main() {
+ test("test", () {
+ attempt++;
+ if(attempt <= 1) {
+ throw 'Failure!';
+ }
+ });
+ }
+
+ ''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stdout, emitsThrough(contains('+1: All tests passed')));
+ await test.shouldExit(0);
+ });
+
+ test('skips tests with skip: true', () async {
+ await d.file('dart_test.yaml', jsonEncode({'skip': true})).create();
+
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("test", () {});
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stdout, emitsThrough(contains('All tests skipped.')));
+ await test.shouldExit(0);
+ });
+
+ test('skips tests with skip: reason', () async {
+ await d
+ .file('dart_test.yaml', jsonEncode({'skip': 'Tests are boring.'}))
+ .create();
+
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("test", () {});
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stdout, emitsThrough(contains('Tests are boring.')));
+ expect(test.stdout, emitsThrough(contains('All tests skipped.')));
+ await test.shouldExit(0);
+ });
+
+ group('test_on', () {
+ test('runs tests on a platform matching platform', () async {
+ await d.file('dart_test.yaml', jsonEncode({'test_on': 'vm'})).create();
+
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("test", () {});
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stdout, emitsThrough(contains('All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ test('warns about the VM when no OSes are supported', () async {
+ await d
+ .file('dart_test.yaml', jsonEncode({'test_on': 'chrome'}))
+ .create();
+
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("test", () {});
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(
+ test.stderr,
+ emits(
+ "Warning: this package doesn't support running tests on the Dart "
+ 'VM.'));
+ expect(test.stdout, emitsThrough(contains('No tests ran.')));
+ await test.shouldExit(79);
+ });
+
+ test('warns about the OS when some OSes are supported', () async {
+ await d.file('dart_test.yaml', jsonEncode({'test_on': otherOS})).create();
+
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("test", () {});
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(
+ test.stderr,
+ emits("Warning: this package doesn't support running tests on "
+ '${currentOS.name}.'));
+ expect(test.stdout, emitsThrough(contains('No tests ran.')));
+ await test.shouldExit(79);
+ });
+
+ test('warns about browsers in general when no browsers are supported',
+ () async {
+ await d.file('dart_test.yaml', jsonEncode({'test_on': 'vm'})).create();
+
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("test", () {});
+ }
+ ''').create();
+
+ var test = await runTest(['-p', 'chrome', 'test.dart']);
+ expect(
+ test.stderr,
+ emits(
+ "Warning: this package doesn't support running tests on browsers."));
+ expect(test.stdout, emitsThrough(contains('No tests ran.')));
+ await test.shouldExit(79);
+ });
+
+ test(
+ 'warns about specific browsers when specific browsers are '
+ 'supported', () async {
+ await d
+ .file('dart_test.yaml', jsonEncode({'test_on': 'safari'}))
+ .create();
+
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("test", () {});
+ }
+ ''').create();
+
+ var test = await runTest(['-p', 'chrome,firefox', 'test.dart']);
+ expect(
+ test.stderr,
+ emits("Warning: this package doesn't support running tests on Chrome "
+ 'or Firefox.'));
+ expect(test.stdout, emitsThrough(contains('No tests ran.')));
+ await test.shouldExit(79);
+ });
+ });
+
+ test('uses the specified reporter', () async {
+ await d.file('dart_test.yaml', jsonEncode({'reporter': 'json'})).create();
+
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("success", () {});
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stdout, emitsThrough(contains('"testStart"')));
+ await test.shouldExit(0);
+ });
+
+ test('uses the specified concurrency', () async {
+ await d.file('dart_test.yaml', jsonEncode({'concurrency': 2})).create();
+
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("success", () {});
+ }
+ ''').create();
+
+ // We can't reliably test the concurrency, but this at least ensures that
+ // it doesn't fail to parse.
+ var test = await runTest(['test.dart']);
+ expect(test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ test('uses the specified timeout', () async {
+ await d.file('dart_test.yaml', jsonEncode({'timeout': '0s'})).create();
+
+ await d.file('test.dart', '''
+ import 'dart:async';
+
+ import 'package:test/test.dart';
+
+ void main() {
+ test("success", () => Future.delayed(Duration.zero));
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(
+ test.stdout,
+ containsInOrder(
+ ['Test timed out after 0 seconds.', '-1: Some tests failed.']));
+ await test.shouldExit(1);
+ });
+
+ test('runs on the specified platforms', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'platforms': ['vm', 'chrome']
+ }))
+ .create();
+
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("success", () {});
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stdout,
+ containsInOrder(['[VM, Kernel] success', '[Chrome, Dart2Js] success']));
+ await test.shouldExit(0);
+ }, tags: 'chrome');
+
+ test('command line args take precedence', () async {
+ await d.file('dart_test.yaml', jsonEncode({'timeout': '0s'})).create();
+
+ await d.file('test.dart', '''
+ import 'dart:async';
+
+ import 'package:test/test.dart';
+
+ void main() {
+ test("success", () => Future.delayed(Duration.zero));
+ }
+ ''').create();
+
+ var test = await runTest(['--timeout=none', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains('All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ test('uses the specified regexp names', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'names': ['z[ia]p', 'a']
+ }))
+ .create();
+
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("zip", () {});
+ test("zap", () {});
+ test("zop", () {});
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stdout, containsInOrder(['+0: zap', '+1: All tests passed!']));
+ await test.shouldExit(0);
+ });
+
+ test('uses the specified plain names', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'names': ['z', 'a']
+ }))
+ .create();
+
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("zip", () {});
+ test("zap", () {});
+ test("zop", () {});
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stdout, containsInOrder(['+0: zap', '+1: All tests passed!']));
+ await test.shouldExit(0);
+ });
+
+ test('uses the specified paths', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'paths': ['zip', 'zap']
+ }))
+ .create();
+
+ await d.dir('zip', [
+ d.file('zip_test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("success", () {});
+ }
+ ''')
+ ]).create();
+
+ await d.dir('zap', [
+ d.file('zip_test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("success", () {});
+ }
+ ''')
+ ]).create();
+
+ await d.dir('zop', [
+ d.file('zip_test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("failure", () => throw "oh no");
+ }
+ ''')
+ ]).create();
+
+ var test = await runTest([]);
+ expect(test.stdout, emitsThrough(contains('All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ test('uses the specified filename', () async {
+ await d
+ .file('dart_test.yaml', jsonEncode({'filename': 'test_*.dart'}))
+ .create();
+
+ await d.dir('test', [
+ d.file('test_foo.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("success", () {});
+ }
+ '''),
+ d.file('foo_test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("failure", () => throw "oh no");
+ }
+ '''),
+ d.file('test_foo.bart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("failure", () => throw "oh no");
+ }
+ ''')
+ ]).create();
+
+ var test = await runTest([]);
+ expect(test.stdout, emitsThrough(contains('All tests passed!')));
+ await test.shouldExit(0);
+ });
+}
diff --git a/pkgs/test/test/runner/coverage_test.dart b/pkgs/test/test/runner/coverage_test.dart
new file mode 100644
index 0000000..b149345
--- /dev/null
+++ b/pkgs/test/test/runner/coverage_test.dart
@@ -0,0 +1,138 @@
+// Copyright (c) 2016, 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.
+
+@TestOn('vm')
+library;
+
+import 'dart:convert';
+import 'dart:io';
+
+import 'package:path/path.dart' as p;
+import 'package:test/test.dart';
+import 'package:test_descriptor/test_descriptor.dart' as d;
+import 'package:test_process/test_process.dart';
+
+import '../io.dart';
+
+void main() {
+ setUpAll(precompileTestExecutable);
+
+ group('with the --coverage flag,', () {
+ late Directory coverageDirectory;
+
+ Future<void> validateCoverage(TestProcess test, String coveragePath) async {
+ expect(test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+
+ final coverageFile = File(p.join(coverageDirectory.path, coveragePath));
+ final coverage = await coverageFile.readAsString();
+ final jsonCoverage = json.decode(coverage);
+ expect(jsonCoverage['coverage'], isNotEmpty);
+ }
+
+ setUp(() async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("test 1", () {
+ expect(true, isTrue);
+ });
+ }
+ ''').create();
+
+ coverageDirectory =
+ await Directory.systemTemp.createTemp('test_coverage');
+ });
+
+ tearDown(() async {
+ await coverageDirectory.delete(recursive: true);
+ });
+
+ test('gathers coverage for VM tests', () async {
+ var test =
+ await runTest(['--coverage', coverageDirectory.path, 'test.dart']);
+ await validateCoverage(test, 'test.dart.vm.json');
+ });
+
+ test('gathers coverage for Chrome tests', () async {
+ var test = await runTest(
+ ['--coverage', coverageDirectory.path, 'test.dart', '-p', 'chrome']);
+ await validateCoverage(test, 'test.dart.chrome.json');
+ });
+
+ test(
+ 'gathers coverage for Chrome tests when JS files contain unicode characters',
+ () async {
+ final sourceMapFileContent =
+ '{"version":3,"file":"","sources":[],"names":[],"mappings":""}';
+ final jsContent = '''
+ (function() {
+ '© '
+ window.foo = function foo() {
+ return 'foo';
+ };
+ })({
+
+ '© ': ''
+ });
+ ''';
+ await d.file('file_with_unicode.js', jsContent).create();
+ await d.file('file_with_unicode.js.map', sourceMapFileContent).create();
+
+ await d.file('js_with_unicode_test.dart', '''
+ import 'dart:async';
+
+ import 'package:js/js.dart';
+ import 'package:js/js_util.dart';
+
+ import 'package:test/src/runner/browser/dom.dart' as dom;
+ import 'package:test/test.dart';
+
+ Future<void> loadScript(String src) async {
+ final controller = StreamController();
+ final scriptLoaded = controller.stream.first;
+ final script = dom.createHTMLScriptElement()..src = src;
+ script.addEventListener('load',
+ allowInterop((_) {
+ controller.add('loaded');
+ }));
+ dom.document.body!.appendChild(script);
+ await scriptLoaded.timeout(Duration(seconds: 1));
+ }
+
+ void main() {
+ test("test 1", () async {
+ await loadScript('file_with_unicode.js');
+ expect(getProperty(dom.window, 'foo'), isNotNull);
+ callMethod(dom.window, 'foo', []);
+ expect(true, isTrue);
+ });
+ }
+ ''').create();
+
+ final jsBytes = utf8.encode(jsContent);
+ final jsLatin1 = latin1.decode(jsBytes);
+ final jsUtf8 = utf8.decode(jsBytes);
+ expect(jsLatin1, isNot(jsUtf8),
+ reason: 'test setup: should have decoded differently');
+
+ const functionPattern = 'function foo';
+ expect([jsLatin1, jsUtf8], everyElement(contains(functionPattern)));
+ expect(jsLatin1.indexOf(functionPattern),
+ isNot(jsUtf8.indexOf(functionPattern)),
+ reason:
+ 'test setup: decoding should have shifted the position of the function');
+
+ var test = await runTest([
+ '--coverage',
+ coverageDirectory.path,
+ 'js_with_unicode_test.dart',
+ '-p',
+ 'chrome'
+ ]);
+ await validateCoverage(test, 'js_with_unicode_test.dart.chrome.json');
+ });
+ });
+}
diff --git a/pkgs/test/test/runner/engine_test.dart b/pkgs/test/test/runner/engine_test.dart
new file mode 100644
index 0000000..6b7df23
--- /dev/null
+++ b/pkgs/test/test/runner/engine_test.dart
@@ -0,0 +1,357 @@
+// Copyright (c) 2015, 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 'dart:math';
+
+import 'package:test/test.dart';
+import 'package:test_api/src/backend/group.dart';
+import 'package:test_api/src/backend/state.dart';
+import 'package:test_core/src/runner/engine.dart';
+
+import '../utils.dart';
+
+void main() {
+ test('runs each test in each suite in order', () async {
+ var testsRun = 0;
+ var tests = declare(() {
+ for (var i = 0; i < 4; i++) {
+ test(
+ 'test ${i + 1}',
+ expectAsync0(() {
+ expect(testsRun, equals(i));
+ testsRun++;
+ }, max: 1));
+ }
+ });
+
+ var engine = Engine.withSuites([
+ runnerSuite(Group.root(tests.take(2))),
+ runnerSuite(Group.root(tests.skip(2)))
+ ]);
+
+ await engine.run();
+ expect(testsRun, equals(4));
+ });
+
+ test('runs tests in a suite added after run() was called', () {
+ var testsRun = 0;
+ var tests = declare(() {
+ for (var i = 0; i < 4; i++) {
+ test(
+ 'test ${i + 1}',
+ expectAsync0(() {
+ expect(testsRun, equals(i));
+ testsRun++;
+ }, max: 1));
+ }
+ });
+
+ var engine = Engine();
+ expect(
+ engine.run().then((_) {
+ expect(testsRun, equals(4));
+ }),
+ completes);
+
+ engine.suiteSink.add(runnerSuite(Group.root(tests)));
+ engine.suiteSink.close();
+ });
+
+ test('returns fail if any test does not complete', () async {
+ var completer = Completer<void>();
+ var engine = declareEngine(() {
+ test('completes', () {});
+ test('does not complete', () async {
+ await completer.future;
+ });
+ });
+ expect(engine.run(), completion(isFalse));
+ await pumpEventQueue();
+ unawaited(engine.close());
+ // We need to complete this so the outer test finishes.
+ completer.complete();
+ });
+
+ test(
+ 'emits each test before it starts running and after the previous test '
+ 'finished', () {
+ var testsRun = 0;
+ var engine = declareEngine(() {
+ for (var i = 0; i < 3; i++) {
+ test('test ${i + 1}', expectAsync0(() => testsRun++, max: 1));
+ }
+ });
+
+ engine.onTestStarted.listen(expectAsync1((liveTest) {
+ // [testsRun] should be one less than the test currently running.
+ expect(liveTest.test.name, equals('test ${testsRun + 1}'));
+
+ // [Engine.onTestStarted] is guaranteed to fire before the first
+ // [LiveTest.onStateChange].
+ expect(liveTest.onStateChange.first,
+ completion(equals(const State(Status.running, Result.success))));
+ }, count: 3, max: 3));
+
+ return engine.run();
+ });
+
+ test('.run() returns true if every test passes', () {
+ var engine = declareEngine(() {
+ for (var i = 0; i < 2; i++) {
+ test('test ${i + 1}', () {});
+ }
+ });
+
+ expect(engine.run(), completion(isTrue));
+ });
+
+ test('.run() returns false if any test fails', () {
+ var engine = declareEngine(() {
+ for (var i = 0; i < 2; i++) {
+ test('test ${i + 1}', () {});
+ }
+ test('failure', () => throw TestFailure('oh no'));
+ });
+
+ expect(engine.run(), completion(isFalse));
+ });
+
+ test('.run() returns false if any test errors', () {
+ var engine = declareEngine(() {
+ for (var i = 0; i < 2; i++) {
+ test('test ${i + 1}', () {});
+ }
+ test('failure', () => throw 'oh no');
+ });
+
+ expect(engine.run(), completion(isFalse));
+ });
+
+ test('.run() does not run more tests after failure for stopOnFirstFailure',
+ () async {
+ var secondTestRan = false;
+ var engine = declareEngine(() {
+ test('failure', () => throw 'oh no');
+ test('subsequent', () {
+ secondTestRan = true;
+ });
+ }, stopOnFirstFailure: true);
+ await expectLater(engine.run(), completion(isFalse));
+ expect(secondTestRan, false);
+ });
+
+ test('.run() may not be called more than once', () {
+ var engine = Engine.withSuites([]);
+ expect(engine.run(), completes);
+ expect(engine.run, throwsStateError);
+ });
+
+ test('runs tearDown after a test times out', () {
+ // Declare this here so the expect is in the context of this test, rather
+ // than the inner test.
+ var secondTestStarted = false;
+ var firstTestFinished = false;
+ var tearDownBody = expectAsync0(() {
+ expect(secondTestStarted, isFalse);
+ expect(firstTestFinished, isFalse);
+ });
+
+ var engine = declareEngine(() {
+ // This ensures that the first test doesn't actually finish until the
+ // second test runs.
+ var firstTestCompleter = Completer<void>();
+
+ group('group', () {
+ tearDown(tearDownBody);
+
+ test('first test', () async {
+ await firstTestCompleter.future;
+ firstTestFinished = true;
+ }, timeout: const Timeout(Duration.zero));
+ });
+
+ test('second test', () {
+ secondTestStarted = true;
+ firstTestCompleter.complete();
+ });
+ });
+
+ expect(engine.run(), completes);
+ });
+
+ group('for a skipped test', () {
+ test("doesn't run the test's body", () async {
+ var bodyRun = false;
+ var engine = declareEngine(() {
+ test('test', () => bodyRun = true, skip: true);
+ });
+
+ await engine.run();
+ expect(bodyRun, isFalse);
+ });
+
+ test("runs the test's body with --run-skipped", () async {
+ var bodyRun = false;
+ var engine = declareEngine(() {
+ test('test', () => bodyRun = true, skip: true);
+ }, runSkipped: true);
+
+ await engine.run();
+ expect(bodyRun, isTrue);
+ });
+
+ test('exposes a LiveTest that emits the correct states', () {
+ var tests = declare(() {
+ test('test', () {}, skip: true);
+ });
+
+ var engine = Engine.withSuites([runnerSuite(Group.root(tests))]);
+
+ engine.onTestStarted.listen(expectAsync1((liveTest) {
+ expect(liveTest, same(engine.liveTests.single));
+ expect(liveTest.test.name, equals(tests.single.name));
+
+ var i = 0;
+ liveTest.onStateChange.listen(expectAsync1((state) {
+ if (i == 0) {
+ expect(state, equals(const State(Status.running, Result.success)));
+ } else if (i == 1) {
+ expect(state, equals(const State(Status.running, Result.skipped)));
+ } else if (i == 2) {
+ expect(state, equals(const State(Status.complete, Result.skipped)));
+ }
+ i++;
+ }, count: 3));
+
+ expect(liveTest.onComplete, completes);
+ }));
+
+ return engine.run();
+ });
+ });
+
+ group('for a skipped group', () {
+ test("doesn't run a test in the group", () async {
+ var bodyRun = false;
+ var engine = declareEngine(() {
+ group('group', () {
+ test('test', () => bodyRun = true);
+ }, skip: true);
+ });
+
+ await engine.run();
+ expect(bodyRun, isFalse);
+ });
+
+ test('runs tests in the group with --run-skipped', () async {
+ var bodyRun = false;
+ var engine = declareEngine(() {
+ group('group', () {
+ test('test', () => bodyRun = true);
+ }, skip: true);
+ }, runSkipped: true);
+
+ await engine.run();
+ expect(bodyRun, isTrue);
+ });
+
+ test('runs tests in the group when they are skip: false', () async {
+ var bodyRun = false;
+ var engine = declareEngine(() {
+ group('group', () {
+ test('test', skip: false, () => bodyRun = true);
+ }, skip: true);
+ });
+
+ await engine.run();
+ expect(bodyRun, isTrue);
+ });
+
+ test('exposes a LiveTest that emits the correct states', () {
+ var entries = declare(() {
+ group('group', () {
+ test('test', () {});
+ }, skip: true);
+ });
+
+ var engine = Engine.withSuites([runnerSuite(Group.root(entries))]);
+
+ engine.onTestStarted.listen(expectAsync1((liveTest) {
+ expect(liveTest, same(engine.liveTests.single));
+ expect(liveTest.test.name, equals('group test'));
+
+ var i = 0;
+ liveTest.onStateChange.listen(expectAsync1((state) {
+ if (i == 0) {
+ expect(state, equals(const State(Status.running, Result.success)));
+ } else if (i == 1) {
+ expect(state, equals(const State(Status.running, Result.skipped)));
+ } else if (i == 2) {
+ expect(state, equals(const State(Status.complete, Result.skipped)));
+ }
+ i++;
+ }, count: 3));
+
+ expect(liveTest.onComplete, completes);
+ }));
+
+ return engine.run();
+ });
+ });
+
+ group('concurrency', () {
+ test('is shared between runner and load suites', () async {
+ for (var concurrency = 1; concurrency < 5; concurrency++) {
+ var testsLoaded = 0;
+ var maxLoadConcurrency = 0;
+ var testsRunning = 0;
+ var maxTestConcurrency = 0;
+ var testCount = concurrency * 2;
+
+ Future<void> updateAndCheckConcurrency(
+ {bool isLoadSuite = false}) async {
+ if (isLoadSuite) {
+ testsLoaded++;
+ maxLoadConcurrency = max(maxLoadConcurrency, testsLoaded);
+ expect(testsLoaded, lessThanOrEqualTo(concurrency));
+ } else {
+ testsRunning++;
+ maxTestConcurrency = max(maxTestConcurrency, testsRunning);
+ expect(testsRunning, lessThanOrEqualTo(concurrency));
+ }
+ // Simulate the test/loading taking some amount of time so that
+ // we actually reach max concurrency.
+ await Future<void>.delayed(const Duration(milliseconds: 100));
+ if (!isLoadSuite) {
+ testsRunning--;
+ testsLoaded--;
+ }
+ }
+
+ var tests = declare(() {
+ for (var i = 0; i < testCount; i++) {
+ test('test ${i + 1}', () async {
+ await updateAndCheckConcurrency();
+ });
+ }
+ });
+ var engine = Engine.withSuites([
+ for (var i = 0; i < testCount; i++)
+ loadSuite('group $i', () async {
+ await updateAndCheckConcurrency(isLoadSuite: true);
+ return runnerSuite(Group.root([tests[i]]));
+ }),
+ ], concurrency: concurrency);
+
+ await engine.run();
+ expect(engine.liveTests.length, testCount);
+
+ // We should reach but not exceed max concurrency
+ expect(maxTestConcurrency, concurrency);
+ expect(maxLoadConcurrency, concurrency);
+ }
+ });
+ });
+}
diff --git a/pkgs/test/test/runner/expanded_reporter_test.dart b/pkgs/test/test/runner/expanded_reporter_test.dart
new file mode 100644
index 0000000..1c11686
--- /dev/null
+++ b/pkgs/test/test/runner/expanded_reporter_test.dart
@@ -0,0 +1,386 @@
+// Copyright (c) 2015, 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.
+
+@TestOn('vm')
+library;
+
+import 'dart:async';
+
+import 'package:test/test.dart';
+import 'package:test_descriptor/test_descriptor.dart' as d;
+
+import '../io.dart';
+
+void main() {
+ setUpAll(precompileTestExecutable);
+
+ test('reports when no tests are run', () async {
+ await d.file('test.dart', 'void main() {}').create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stdout, emitsThrough(contains('No tests ran.')));
+ await test.shouldExit(79);
+ });
+
+ test('runs several successful tests and reports when each completes', () {
+ return _expectReport('''
+ test('success 1', () {});
+ test('success 2', () {});
+ test('success 3', () {});''', '''
+ +0: loading test.dart
+ +0: success 1
+ +1: success 2
+ +2: success 3
+ +3: All tests passed!''');
+ });
+
+ test('runs several failing tests and reports when each fails', () {
+ return _expectReport('''
+ test('failure 1', () => throw TestFailure('oh no'));
+ test('failure 2', () => throw TestFailure('oh no'));
+ test('failure 3', () => throw TestFailure('oh no'));''', '''
+ +0: loading test.dart
+ +0: failure 1
+ +0 -1: failure 1 [E]
+ oh no
+ test.dart 6:33 main.<fn>
+
+ +0 -1: failure 2
+ +0 -2: failure 2 [E]
+ oh no
+ test.dart 7:33 main.<fn>
+
+ +0 -2: failure 3
+ +0 -3: failure 3 [E]
+ oh no
+ test.dart 8:33 main.<fn>
+
+ +0 -3: Some tests failed.''');
+ });
+
+ test('includes the full stack trace with --verbose-trace', () async {
+ await d.file('test.dart', '''
+import 'dart:async';
+
+import 'package:test/test.dart';
+
+void main() {
+ test("failure", () => throw "oh no");
+}
+''').create();
+
+ var test = await runTest(['--verbose-trace', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains('dart:async')));
+ await test.shouldExit(1);
+ });
+
+ test('runs failing tests along with successful tests', () {
+ return _expectReport('''
+ test('failure 1', () => throw TestFailure('oh no'));
+ test('success 1', () {});
+ test('failure 2', () => throw TestFailure('oh no'));
+ test('success 2', () {});''', '''
+ +0: loading test.dart
+ +0: failure 1
+ +0 -1: failure 1 [E]
+ oh no
+ test.dart 6:33 main.<fn>
+
+ +0 -1: success 1
+ +1 -1: failure 2
+ +1 -2: failure 2 [E]
+ oh no
+ test.dart 8:33 main.<fn>
+
+ +1 -2: success 2
+ +2 -2: Some tests failed.''');
+ });
+
+ test('always prints the full test name', () {
+ return _expectReport('''
+ test(
+ 'really gosh dang long test name. Even longer than that. No, yet '
+ 'longer. A little more... okay, that should do it.',
+ () {});''', '''
+ +0: loading test.dart
+ +0: really gosh dang long test name. Even longer than that. No, yet longer. A little more... okay, that should do it.
+ +1: All tests passed!''');
+ });
+
+ test('gracefully handles multiple test failures in a row', () {
+ return _expectReport('''
+ // This completer ensures that the test isolate isn't killed until all
+ // errors have been thrown.
+ var completer = Completer();
+ test('failures', () {
+ Future.microtask(() => throw 'first error');
+ Future.microtask(() => throw 'second error');
+ Future.microtask(() => throw 'third error');
+ Future.microtask(completer.complete);
+ });
+ test('wait', () => completer.future);''', '''
+ +0: loading test.dart
+ +0: failures
+ +0 -1: failures [E]
+ first error
+ test.dart 10:34 main.<fn>.<fn>
+ ===== asynchronous gap ===========================
+ dart:async new Future.microtask
+ test.dart 10:18 main.<fn>
+
+ second error
+ test.dart 11:34 main.<fn>.<fn>
+ ===== asynchronous gap ===========================
+ dart:async new Future.microtask
+ test.dart 11:18 main.<fn>
+
+ third error
+ test.dart 12:34 main.<fn>.<fn>
+ ===== asynchronous gap ===========================
+ dart:async new Future.microtask
+ test.dart 12:18 main.<fn>
+
+ +0 -1: wait
+ +1 -1: Some tests failed.''');
+ });
+
+ group('print:', () {
+ test('handles multiple prints', () {
+ return _expectReport('''
+ test('test', () {
+ print("one");
+ print("two");
+ print("three");
+ print("four");
+ });''', '''
+ +0: loading test.dart
+ +0: test
+ one
+ two
+ three
+ four
+ +1: All tests passed!''');
+ });
+
+ test('handles a print after the test completes', () {
+ return _expectReport('''
+ // This completer ensures that the test isolate isn't killed until all
+ // prints have happened.
+ var testDone = Completer();
+ var waitStarted = Completer();
+ test('test', () async {
+ waitStarted.future.then((_) {
+ Future(() => print("one"));
+ Future(() => print("two"));
+ Future(() => print("three"));
+ Future(() => print("four"));
+ Future(testDone.complete);
+ });
+ });
+
+ test('wait', () {
+ waitStarted.complete();
+ return testDone.future;
+ });''', '''
+ +0: loading test.dart
+ +0: test
+ +1: wait
+ +1: test
+ one
+ two
+ three
+ four
+ +2: All tests passed!''');
+ });
+
+ test('interleaves prints and errors', () {
+ return _expectReport('''
+ // This completer ensures that the test isolate isn't killed until all
+ // prints have happened.
+ var completer = Completer();
+ test('test', () {
+ scheduleMicrotask(() {
+ print("three");
+ print("four");
+ throw "second error";
+ });
+
+ scheduleMicrotask(() {
+ print("five");
+ print("six");
+ completer.complete();
+ });
+
+ print("one");
+ print("two");
+ throw "first error";
+ });
+
+ test('wait', () => completer.future);''', '''
+ +0: loading test.dart
+ +0: test
+ one
+ two
+ +0 -1: test [E]
+ first error
+ test.dart 24:11 main.<fn>
+
+ three
+ four
+ second error
+ test.dart 13:13 main.<fn>.<fn>
+ ===== asynchronous gap ===========================
+ dart:async scheduleMicrotask
+ test.dart 10:11 main.<fn>
+
+ five
+ six
+ +0 -1: wait
+ +1 -1: Some tests failed.''');
+ });
+ });
+
+ group('skip:', () {
+ test('displays skipped tests separately', () {
+ return _expectReport('''
+ test('skip 1', () {}, skip: true);
+ test('skip 2', () {}, skip: true);
+ test('skip 3', () {}, skip: true);''', '''
+ +0: loading test.dart
+ +0: skip 1
+ +0 ~1: skip 2
+ +0 ~2: skip 3
+ +0 ~3: All tests skipped.''');
+ });
+
+ test('displays a skipped group', () {
+ return _expectReport('''
+ group('skip', () {
+ test('test 1', () {});
+ test('test 2', () {});
+ test('test 3', () {});
+ }, skip: true);''', '''
+ +0: loading test.dart
+ +0: skip test 1
+ +0 ~1: skip test 2
+ +0 ~2: skip test 3
+ +0 ~3: All tests skipped.''');
+ });
+
+ test('runs skipped tests along with successful tests', () {
+ return _expectReport('''
+ test('skip 1', () {}, skip: true);
+ test('success 1', () {});
+ test('skip 2', () {}, skip: true);
+ test('success 2', () {});''', '''
+ +0: loading test.dart
+ +0: skip 1
+ +0 ~1: success 1
+ +1 ~1: skip 2
+ +1 ~2: success 2
+ +2 ~2: All tests passed!''');
+ });
+
+ test('runs skipped tests along with successful and failing tests', () {
+ return _expectReport('''
+ test('failure 1', () => throw TestFailure('oh no'));
+ test('skip 1', () {}, skip: true);
+ test('success 1', () {});
+ test('failure 2', () => throw TestFailure('oh no'));
+ test('skip 2', () {}, skip: true);
+ test('success 2', () {});''', '''
+ +0: loading test.dart
+ +0: failure 1
+ +0 -1: failure 1 [E]
+ oh no
+ test.dart 6:35 main.<fn>
+
+ +0 -1: skip 1
+ +0 ~1 -1: success 1
+ +1 ~1 -1: failure 2
+ +1 ~1 -2: failure 2 [E]
+ oh no
+ test.dart 9:35 main.<fn>
+
+ +1 ~1 -2: skip 2
+ +1 ~2 -2: success 2
+ +2 ~2 -2: Some tests failed.''');
+ });
+
+ test('displays the skip reason if available', () {
+ return _expectReport('''
+ test('skip 1', () {}, skip: 'some reason');
+ test('skip 2', () {}, skip: 'or another');''', '''
+ +0: loading test.dart
+ +0: skip 1
+ Skip: some reason
+ +0 ~1: skip 2
+ Skip: or another
+ +0 ~2: All tests skipped.''');
+ });
+
+ test('runs skipped tests with --run-skipped', () {
+ return _expectReport('''
+ test('skip 1', () {}, skip: 'some reason');
+ test('skip 2', () {}, skip: 'or another');''', '''
+ +0: loading test.dart
+ +0: skip 1
+ +1: skip 2
+ +2: All tests passed!''', args: ['--run-skipped']);
+ });
+ });
+
+ test('Directs users to enable stack trace chaining if disabled', () async {
+ await _expectReport(
+ '''test('failure 1', () => throw TestFailure('oh no'));''', '''
+ +0: loading test.dart
+ +0: failure 1
+ +0 -1: failure 1 [E]
+ oh no
+ test.dart 6:25 main.<fn>
+
+ +0 -1: Some tests failed.
+
+ Consider enabling the flag chain-stack-traces to receive more detailed exceptions.
+ For example, 'dart test --chain-stack-traces'.''',
+ chainStackTraces: false);
+ });
+}
+
+Future<void> _expectReport(String tests, String expected,
+ {List<String> args = const [], bool chainStackTraces = true}) async {
+ await d.file('test.dart', '''
+ import 'dart:async';
+
+ import 'package:test/test.dart';
+
+ void main() {
+$tests
+ }
+ ''').create();
+
+ var test = await runTest([
+ 'test.dart',
+ if (chainStackTraces) '--chain-stack-traces',
+ ...args,
+ ]);
+ await test.shouldExit();
+
+ var stdoutLines = await test.stdoutStream().toList();
+
+ // Remove excess trailing whitespace and trim off timestamps.
+ var actual = stdoutLines.map((line) {
+ if (line.startsWith(' ') || line.isEmpty) return line.trimRight();
+ return line.trim().replaceFirst(RegExp('^[0-9]{2}:[0-9]{2} '), '');
+ }).join('\n');
+
+ // Un-indent the expected string.
+ var indentation = expected.indexOf(RegExp('[^ ]'));
+ expected = expected.split('\n').map((line) {
+ if (line.isEmpty) return line;
+ return line.substring(indentation);
+ }).join('\n');
+
+ expect(actual, equals(expected));
+}
diff --git a/pkgs/test/test/runner/failures_only_reporter_test.dart b/pkgs/test/test/runner/failures_only_reporter_test.dart
new file mode 100644
index 0000000..3e2690a
--- /dev/null
+++ b/pkgs/test/test/runner/failures_only_reporter_test.dart
@@ -0,0 +1,257 @@
+// Copyright (c) 2024, 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.
+
+@TestOn('vm')
+library;
+
+import 'dart:async';
+
+import 'package:test/test.dart';
+import 'package:test_descriptor/test_descriptor.dart' as d;
+
+import '../io.dart';
+
+void main() {
+ setUpAll(precompileTestExecutable);
+
+ test('reports when no tests are run', () async {
+ await d.file('test.dart', 'void main() {}').create();
+
+ var test = await runTest(['test.dart'], reporter: 'failures-only');
+ expect(test.stdout, emitsThrough(contains('No tests ran.')));
+ await test.shouldExit(79);
+ });
+
+ test('runs several successful tests and reports only at the end', () {
+ return _expectReport('''
+ test('success 1', () {});
+ test('success 2', () {});
+ test('success 3', () {});''', '''
+ +3: All tests passed!''');
+ });
+
+ test('runs several failing tests and reports when each fails', () {
+ return _expectReport('''
+ test('failure 1', () => throw TestFailure('oh no'));
+ test('failure 2', () => throw TestFailure('oh no'));
+ test('failure 3', () => throw TestFailure('oh no'));''', '''
+ +0 -1: failure 1 [E]
+ oh no
+ test.dart 6:33 main.<fn>
+
+ +0 -2: failure 2 [E]
+ oh no
+ test.dart 7:33 main.<fn>
+
+ +0 -3: failure 3 [E]
+ oh no
+ test.dart 8:33 main.<fn>
+
+ +0 -3: Some tests failed.''');
+ });
+
+ test('includes the full stack trace with --verbose-trace', () async {
+ await d.file('test.dart', '''
+import 'dart:async';
+
+import 'package:test/test.dart';
+
+void main() {
+ test("failure", () => throw "oh no");
+}
+''').create();
+
+ var test = await runTest(['--verbose-trace', 'test.dart'],
+ reporter: 'failures-only');
+ expect(test.stdout, emitsThrough(contains('dart:async')));
+ await test.shouldExit(1);
+ });
+
+ test('reports only failing tests amid successful tests', () {
+ return _expectReport('''
+ test('failure 1', () => throw TestFailure('oh no'));
+ test('success 1', () {});
+ test('failure 2', () => throw TestFailure('oh no'));
+ test('success 2', () {});''', '''
+ +0 -1: failure 1 [E]
+ oh no
+ test.dart 6:33 main.<fn>
+
+ +1 -2: failure 2 [E]
+ oh no
+ test.dart 8:33 main.<fn>
+
+ +2 -2: Some tests failed.''');
+ });
+
+ group('print:', () {
+ test('handles multiple prints', () {
+ return _expectReport('''
+ test('test', () {
+ print("one");
+ print("two");
+ print("three");
+ print("four");
+ });''', '''
+ +0: test
+ one
+ two
+ three
+ four
+ +1: All tests passed!''');
+ });
+
+ test('handles a print after the test completes', () {
+ return _expectReport('''
+ // This completer ensures that the test isolate isn't killed until all
+ // prints have happened.
+ var testDone = Completer();
+ var waitStarted = Completer();
+ test('test', () async {
+ waitStarted.future.then((_) {
+ Future(() => print("one"));
+ Future(() => print("two"));
+ Future(() => print("three"));
+ Future(() => print("four"));
+ Future(testDone.complete);
+ });
+ });
+
+ test('wait', () {
+ waitStarted.complete();
+ return testDone.future;
+ });''', '''
+ +1: test
+ one
+ two
+ three
+ four
+ +2: All tests passed!''');
+ });
+
+ test('interleaves prints and errors', () {
+ return _expectReport('''
+ // This completer ensures that the test isolate isn't killed until all
+ // prints have happened.
+ var completer = Completer();
+ test('test', () {
+ scheduleMicrotask(() {
+ print("three");
+ print("four");
+ throw "second error";
+ });
+
+ scheduleMicrotask(() {
+ print("five");
+ print("six");
+ completer.complete();
+ });
+
+ print("one");
+ print("two");
+ throw "first error";
+ });
+
+ test('wait', () => completer.future);''', '''
+ +0: test
+ one
+ two
+ +0 -1: test [E]
+ first error
+ test.dart 24:11 main.<fn>
+
+ three
+ four
+ second error
+ test.dart 13:13 main.<fn>.<fn>
+ ===== asynchronous gap ===========================
+ dart:async scheduleMicrotask
+ test.dart 10:11 main.<fn>
+
+ five
+ six
+ +1 -1: Some tests failed.''');
+ });
+ });
+
+ group('skip:', () {
+ test('does not emit for skips', () {
+ return _expectReport('''
+ test('skip 1', () {}, skip: true);
+ test('skip 2', () {}, skip: true);
+ test('skip 3', () {}, skip: true);''', '''
+ +0 ~3: All tests skipped.''');
+ });
+
+ test('runs skipped tests along with successful and failing tests', () {
+ return _expectReport('''
+ test('failure 1', () => throw TestFailure('oh no'));
+ test('skip 1', () {}, skip: true);
+ test('success 1', () {});
+ test('failure 2', () => throw TestFailure('oh no'));
+ test('skip 2', () {}, skip: true);
+ test('success 2', () {});''', '''
+ +0 -1: failure 1 [E]
+ oh no
+ test.dart 6:35 main.<fn>
+
+ +1 ~1 -2: failure 2 [E]
+ oh no
+ test.dart 9:35 main.<fn>
+
+ +2 ~2 -2: Some tests failed.''');
+ });
+ });
+
+ test('Directs users to enable stack trace chaining if disabled', () async {
+ await _expectReport(
+ '''test('failure 1', () => throw TestFailure('oh no'));''', '''
+ +0 -1: failure 1 [E]
+ oh no
+ test.dart 6:25 main.<fn>
+
+ +0 -1: Some tests failed.
+
+ Consider enabling the flag chain-stack-traces to receive more detailed exceptions.
+ For example, 'dart test --chain-stack-traces'.''',
+ chainStackTraces: false);
+ });
+}
+
+Future<void> _expectReport(String tests, String expected,
+ {List<String> args = const [], bool chainStackTraces = true}) async {
+ await d.file('test.dart', '''
+ import 'dart:async';
+
+ import 'package:test/test.dart';
+
+ void main() {
+$tests
+ }
+ ''').create();
+
+ var test = await runTest([
+ 'test.dart',
+ if (chainStackTraces) '--chain-stack-traces',
+ ...args,
+ ], reporter: 'failures-only');
+ await test.shouldExit();
+
+ var stdoutLines = await test.stdoutStream().toList();
+
+ // Remove excess trailing whitespace.
+ var actual = stdoutLines.map((line) {
+ if (line.startsWith(' ') || line.isEmpty) return line.trimRight();
+ return line.trim();
+ }).join('\n');
+
+ // Un-indent the expected string.
+ var indentation = expected.indexOf(RegExp('[^ ]'));
+ expected = expected.split('\n').map((line) {
+ if (line.isEmpty) return line;
+ return line.substring(indentation);
+ }).join('\n');
+
+ expect(actual, equals(expected));
+}
diff --git a/pkgs/test/test/runner/github_reporter_test.dart b/pkgs/test/test/runner/github_reporter_test.dart
new file mode 100644
index 0000000..db50058
--- /dev/null
+++ b/pkgs/test/test/runner/github_reporter_test.dart
@@ -0,0 +1,377 @@
+// Copyright (c) 2022, 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.
+
+@TestOn('vm')
+library;
+
+import 'dart:async';
+
+import 'package:test/test.dart';
+import 'package:test_descriptor/test_descriptor.dart' as d;
+
+import '../io.dart';
+
+void main() {
+ setUpAll(precompileTestExecutable);
+
+ test('reports when no tests are run', () async {
+ await d.file('test.dart', 'void main() {}').create();
+
+ var test = await runTest(['test.dart'], reporter: 'github');
+ expect(test.stdout, emitsThrough(contains('0 tests passed')));
+ await test.shouldExit(79);
+ });
+
+ test('runs several successful tests and reports when each completes', () {
+ return _expectReport('''
+ test('success 1', () {});
+ test('success 2', () {});
+ test('success 3', () {});''', '''
+ ✅ success 1
+ ✅ success 2
+ ✅ success 3
+ 🎉 3 tests passed.''');
+ });
+
+ test('includes the platform name when multiple platforms are run', () {
+ return _expectReportLines('''
+ test('success 1', () {});''', [
+ '✅ [VM, Kernel] success 1',
+ '✅ [Chrome, Dart2Js] success 1',
+ '🎉 2 tests passed.',
+ ], args: [
+ '-p',
+ 'vm,chrome'
+ ]);
+ });
+
+ test('runs several failing tests and reports when each fails', () {
+ return _expectReport('''
+ test('failure 1', () => throw TestFailure('oh no'));
+ test('failure 2', () => throw TestFailure('oh no'));
+ test('failure 3', () => throw TestFailure('oh no'));''', '''
+ ::group::❌ failure 1 (failed)
+ oh no
+ test.dart 6:33 main.<fn>
+ ::endgroup::
+ ::group::❌ failure 2 (failed)
+ oh no
+ test.dart 7:33 main.<fn>
+ ::endgroup::
+ ::group::❌ failure 3 (failed)
+ oh no
+ test.dart 8:33 main.<fn>
+ ::endgroup::
+ ::error::0 tests passed, 3 failed.''');
+ });
+
+ test('includes the full stack trace with --verbose-trace', () async {
+ await d.file('test.dart', '''
+import 'dart:async';
+
+import 'package:test/test.dart';
+
+void main() {
+ test("failure", () => throw "oh no");
+}
+''').create();
+
+ var test =
+ await runTest(['--verbose-trace', 'test.dart'], reporter: 'github');
+ expect(test.stdout, emitsThrough(contains('dart:async')));
+ await test.shouldExit(1);
+ });
+
+ test('runs failing tests along with successful tests', () {
+ return _expectReport('''
+ test('failure 1', () => throw TestFailure('oh no'));
+ test('success 1', () {});
+ test('failure 2', () => throw TestFailure('oh no'));
+ test('success 2', () {});''', '''
+ ::group::❌ failure 1 (failed)
+ oh no
+ test.dart 6:33 main.<fn>
+ ::endgroup::
+ ✅ success 1
+ ::group::❌ failure 2 (failed)
+ oh no
+ test.dart 8:33 main.<fn>
+ ::endgroup::
+ ✅ success 2
+ ::error::2 tests passed, 2 failed.''');
+ });
+
+ test('always prints the full test name', () {
+ return _expectReport(
+ '''
+ test(
+ 'really gosh dang long test name. Even longer than that. No, yet '
+ 'longer. A little more... okay, that should do it.',
+ () {});''',
+ '✅ really gosh dang long test name. Even longer than that. No, yet longer. A little more... okay, that should do it.',
+ useContains: true,
+ );
+ });
+
+ test('gracefully handles multiple test failures in a row', () {
+ return _expectReport('''
+ // This completer ensures that the test isolate isn't killed until all
+ // errors have been thrown.
+ var completer = Completer();
+ test('failures', () {
+ Future.microtask(() => throw 'first error');
+ Future.microtask(() => throw 'second error');
+ Future.microtask(() => throw 'third error');
+ Future.microtask(completer.complete);
+ });
+ test('wait', () => completer.future);''', '''
+ ::group::❌ failures (failed)
+ first error
+ test.dart 10:34 main.<fn>.<fn>
+ second error
+ test.dart 11:34 main.<fn>.<fn>
+ third error
+ test.dart 12:34 main.<fn>.<fn>
+ ::endgroup::
+ ✅ wait
+ ::error::1 test passed, 1 failed.''');
+ });
+
+ test('displays failures occuring after a test completes', () {
+ return _expectReport(
+ '''
+ test('fail after completion', () {
+ Future(() {
+ Zone.current.handleUncaughtError('foo', StackTrace.current);
+ });
+ });
+
+ test('second test so that the first failure is reported', () {});''',
+ '''
+ ✅ fail after completion
+ ::group::❌ fail after completion (failed after test completion)
+ foo
+ test.dart 8:62 main.<fn>.<fn>
+ ::endgroup::
+ ::group::❌ fail after completion (failed after test completion)
+ This test failed after it had already completed.
+ Make sure to use a matching library which informs the test runner
+ of pending async work.
+ test.dart 8:62 main.<fn>.<fn>
+ ::endgroup::
+ ✅ second test so that the first failure is reported
+ ::error::1 test passed, 1 failed.''',
+ );
+ });
+
+ group('print:', () {
+ test('handles multiple prints', () {
+ return _expectReport(
+ '''
+ test('test', () {
+ print("one");
+ print("two");
+ print("three");
+ print("four");
+ });''',
+ '''
+ ::group::✅ test
+ one
+ two
+ three
+ four
+ ::endgroup::''',
+ useContains: true,
+ );
+ });
+
+ test('handles a print after the test completes', () {
+ return _expectReport('''
+ // This completer ensures that the test isolate isn't killed until all
+ // prints have happened.
+ var testDone = Completer();
+ var waitStarted = Completer();
+ test('test', () async {
+ waitStarted.future.then((_) {
+ Future(() => print("one"));
+ Future(() => print("two"));
+ Future(() => print("three"));
+ Future(() => print("four"));
+ Future(testDone.complete);
+ });
+ });
+
+ test('wait', () {
+ waitStarted.complete();
+ return testDone.future;
+ });''', '''
+ ✅ test
+ one
+ two
+ three
+ four
+ ✅ wait
+ 🎉 2 tests passed.''');
+ });
+ });
+
+ group('skip:', () {
+ test('displays skipped tests', () {
+ return _expectReport('''
+ test('skip 1', () {}, skip: true);
+ test('skip 2', () {}, skip: true);
+ test('skip 3', () {}, skip: true);''', '''
+ ❎ skip 1 (skipped)
+ ❎ skip 2 (skipped)
+ ❎ skip 3 (skipped)
+ 🎉 0 tests passed, 3 skipped.''');
+ });
+
+ test('displays a skipped group', () {
+ return _expectReport('''
+ group('skip', () {
+ test('test 1', () {});
+ test('test 2', () {});
+ test('test 3', () {});
+ }, skip: true);''', '''
+ ❎ skip test 1 (skipped)
+ ❎ skip test 2 (skipped)
+ ❎ skip test 3 (skipped)
+ 🎉 0 tests passed, 3 skipped.''');
+ });
+
+ test('runs skipped tests along with successful tests', () {
+ return _expectReport('''
+ test('skip 1', () {}, skip: true);
+ test('success 1', () {});
+ test('skip 2', () {}, skip: true);
+ test('success 2', () {});''', '''
+ ❎ skip 1 (skipped)
+ ✅ success 1
+ ❎ skip 2 (skipped)
+ ✅ success 2
+ 🎉 2 tests passed, 2 skipped.''');
+ });
+
+ test('runs skipped tests along with successful and failing tests', () {
+ return _expectReport('''
+ test('failure 1', () => throw TestFailure('oh no'));
+ test('skip 1', () {}, skip: true);
+ test('success 1', () {});
+ test('failure 2', () => throw TestFailure('oh no'));
+ test('skip 2', () {}, skip: true);
+ test('success 2', () {});''', '''
+ ::group::❌ failure 1 (failed)
+ oh no
+ test.dart 6:35 main.<fn>
+ ::endgroup::
+ ❎ skip 1 (skipped)
+ ✅ success 1
+ ::group::❌ failure 2 (failed)
+ oh no
+ test.dart 9:35 main.<fn>
+ ::endgroup::
+ ❎ skip 2 (skipped)
+ ✅ success 2
+ ::error::2 tests passed, 2 failed, 2 skipped.''');
+ });
+
+ test('displays the skip reason if available', () {
+ return _expectReport('''
+ test('skip 1', () {}, skip: 'some reason');
+ test('skip 2', () {}, skip: 'or another');''', '''
+ ::group::❎ skip 1 (skipped)
+ Skip: some reason
+ ::endgroup::
+ ::group::❎ skip 2 (skipped)
+ Skip: or another
+ ::endgroup::
+ 🎉 0 tests passed, 2 skipped.''');
+ });
+ });
+
+ test('loadSuite, setUpAll, and tearDownAll hidden if no content', () {
+ return _expectReport('''
+ group('one', () {
+ setUpAll(() {/* nothing to do here */});
+ tearDownAll(() {/* nothing to do here */});
+ test('test 1', () {});
+ });''', '''
+ ✅ one test 1
+ 🎉 1 test passed.''');
+ });
+
+ test('setUpAll and tearDownAll show when they have content', () {
+ return _expectReport('''
+ group('one', () {
+ setUpAll(() { print('one'); });
+ tearDownAll(() { print('two'); });
+ test('test 1', () {});
+ });''', '''
+ ::group::✅ one (setUpAll)
+ one
+ ::endgroup::
+ ✅ one test 1
+ ::group::✅ one (tearDownAll)
+ two
+ ::endgroup::
+ 🎉 1 test passed.''');
+ });
+}
+
+/// Expects exactly [expected] to appear in the test output.
+///
+/// If [useContains] is passed, then the output only must contain [expected].
+Future<void> _expectReport(
+ String tests,
+ String expected, {
+ List<String> args = const [],
+ bool useContains = false,
+}) async {
+ expected = expected.split('\n').map(_unindent).join('\n');
+
+ var actual = (await _reportLines(tests, args)).join('\n');
+
+ expect(actual, useContains ? contains(expected) : equals(expected));
+}
+
+/// Expects all of [expected] lines to appear in the test output, but additional
+/// output is allowed.
+Future<void> _expectReportLines(
+ String tests,
+ List<String> expected, {
+ List<String> args = const [],
+}) async {
+ expected = [for (var line in expected) _unindent(line)];
+ var actual = await _reportLines(tests, args);
+ expect(actual, containsAllInOrder(expected));
+}
+
+/// All the output lines from running [tests].
+Future<List<String>> _reportLines(String tests, List<String> args) async {
+ await d.file('test.dart', '''
+ import 'dart:async';
+
+ import 'package:test/test.dart';
+
+ void main() {
+$tests
+ }
+ ''').create();
+
+ var test = await runTest([
+ 'test.dart',
+ ...args,
+ ], reporter: 'github');
+ await test.shouldExit();
+
+ var stdoutLines = await test.stdoutStream().toList();
+ return stdoutLines
+ .map((line) => line.trim())
+ .where((line) => line.isNotEmpty)
+ .toList();
+}
+
+/// Removes all leading space from [line].
+String _unindent(String line) => line.trimLeft();
diff --git a/pkgs/test/test/runner/json_file_reporter_test.dart b/pkgs/test/test/runner/json_file_reporter_test.dart
new file mode 100644
index 0000000..ce3bd42
--- /dev/null
+++ b/pkgs/test/test/runner/json_file_reporter_test.dart
@@ -0,0 +1,155 @@
+// Copyright (c) 2020, 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.
+
+@TestOn('vm')
+library;
+
+import 'dart:async';
+import 'dart:io';
+
+import 'package:path/path.dart' as p;
+import 'package:test/test.dart';
+import 'package:test_core/src/util/exit_codes.dart' as exit_codes;
+import 'package:test_descriptor/test_descriptor.dart' as d;
+
+import '../io.dart';
+import 'json_reporter_utils.dart';
+
+void main() {
+ setUpAll(precompileTestExecutable);
+
+ test('runs successful tests with a stdout reporter and file reporter', () {
+ return _expectReports('''
+ test('success 1', () {});
+ test('success 2', () {});
+ test('success 3', () {});
+ ''', '''
+ +0: loading test.dart
+ +0: success 1
+ +1: success 2
+ +2: success 3
+ +3: All tests passed!''', [
+ [
+ suiteJson(0),
+ testStartJson(1, 'loading test.dart', groupIDs: []),
+ testDoneJson(1, hidden: true),
+ ],
+ [
+ groupJson(2, testCount: 3),
+ testStartJson(3, 'success 1', line: 6, column: 7),
+ testDoneJson(3),
+ testStartJson(4, 'success 2', line: 7, column: 7),
+ testDoneJson(4),
+ testStartJson(5, 'success 3', line: 8, column: 7),
+ testDoneJson(5),
+ ]
+ ], doneJson());
+ });
+
+ test('runs failing tests with a stdout reporter and file reporter', () {
+ return _expectReports('''
+ test('failure 1', () => throw new TestFailure('oh no'));
+ test('failure 2', () => throw new TestFailure('oh no'));
+ test('failure 3', () => throw new TestFailure('oh no'));
+ ''', '''
+ +0: loading test.dart
+ +0: failure 1
+ +0 -1: failure 1 [E]
+ oh no
+ test.dart 6:31 main.<fn>
+
+ +0 -1: failure 2
+ +0 -2: failure 2 [E]
+ oh no
+ test.dart 7:31 main.<fn>
+
+ +0 -2: failure 3
+ +0 -3: failure 3 [E]
+ oh no
+ test.dart 8:31 main.<fn>
+
+ +0 -3: Some tests failed.''', [
+ [
+ suiteJson(0),
+ testStartJson(1, 'loading test.dart', groupIDs: []),
+ testDoneJson(1, hidden: true),
+ ],
+ [
+ groupJson(2, testCount: 3),
+ testStartJson(3, 'failure 1', line: 6, column: 7),
+ errorJson(3, 'oh no', isFailure: true),
+ testDoneJson(3, result: 'failure'),
+ testStartJson(4, 'failure 2', line: 7, column: 7),
+ errorJson(4, 'oh no', isFailure: true),
+ testDoneJson(4, result: 'failure'),
+ testStartJson(5, 'failure 3', line: 8, column: 7),
+ errorJson(5, 'oh no', isFailure: true),
+ testDoneJson(5, result: 'failure'),
+ ]
+ ], doneJson(success: false));
+ });
+
+ group('reports an error if --file-reporter', () {
+ test('is not in the form <reporter>:<filepath>', () async {
+ var test = await runTest(['--file-reporter=json']);
+ expect(test.stderr,
+ emits(contains('option must be in the form <reporter>:<filepath>')));
+ await test.shouldExit(exit_codes.usage);
+ });
+
+ test('targets a non-existent reporter', () async {
+ var test = await runTest(['--file-reporter=nope:output.txt']);
+ expect(
+ test.stderr, emits(contains('"nope" is not a supported reporter')));
+ await test.shouldExit(exit_codes.usage);
+ });
+ });
+}
+
+Future<void> _expectReports(
+ String tests,
+ String stdoutExpected,
+ List<List<Object /*Map|Matcher*/ >> jsonFileExpected,
+ Map<Object, Object> jsonFileDone,
+ {List<String> args = const []}) async {
+ await d.file('test.dart', '''
+ import 'dart:async';
+
+ import 'package:test/test.dart';
+
+ void main() {
+$tests
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart', '--chain-stack-traces', ...args],
+ // Write to a file within a dir that doesn't yet exist to verify that the
+ // file is created recursively.
+ fileReporter: 'json:reports/tests.json');
+ await test.shouldExit();
+
+ // ---- stdout reporter verification ----
+ var stdoutLines = await test.stdoutStream().toList();
+
+ // Remove excess trailing whitespace and trim off timestamps.
+ var actual = stdoutLines.map((line) {
+ if (line.startsWith(' ') || line.isEmpty) return line.trimRight();
+ return line.trim().replaceFirst(RegExp('^[0-9]{2}:[0-9]{2} '), '');
+ }).join('\n');
+
+ // Un-indent the expected string.
+ var indentation = stdoutExpected.indexOf(RegExp('[^ ]'));
+ stdoutExpected = stdoutExpected.split('\n').map((line) {
+ if (line.isEmpty) return line;
+ return line.substring(indentation);
+ }).join('\n');
+
+ expect(actual, equals(stdoutExpected));
+
+ // ---- file reporter verification ----
+ var fileOutputLines =
+ File(p.join(d.sandbox, 'reports', 'tests.json')).readAsLinesSync();
+ await expectJsonReport(
+ fileOutputLines, test.pid, jsonFileExpected, jsonFileDone);
+}
diff --git a/pkgs/test/test/runner/json_reporter_test.dart b/pkgs/test/test/runner/json_reporter_test.dart
new file mode 100644
index 0000000..a771438
--- /dev/null
+++ b/pkgs/test/test/runner/json_reporter_test.dart
@@ -0,0 +1,655 @@
+// Copyright (c) 2015, 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.
+
+@TestOn('vm')
+library;
+
+import 'dart:async';
+
+import 'package:path/path.dart' as p;
+import 'package:test/test.dart';
+import 'package:test_descriptor/test_descriptor.dart' as d;
+
+import '../io.dart';
+import 'json_reporter_utils.dart';
+
+void main() {
+ setUpAll(precompileTestExecutable);
+
+ test('runs several successful tests and reports when each completes', () {
+ return _expectReport('''
+ test('success 1', () {});
+ test('success 2', () {});
+ test('success 3', () {});
+ ''', [
+ [
+ suiteJson(0),
+ testStartJson(1, 'loading test.dart', groupIDs: []),
+ testDoneJson(1, hidden: true),
+ ],
+ [
+ groupJson(2, testCount: 3),
+ testStartJson(3, 'success 1', line: 6, column: 7),
+ testDoneJson(3),
+ testStartJson(4, 'success 2', line: 7, column: 7),
+ testDoneJson(4),
+ testStartJson(5, 'success 3', line: 8, column: 7),
+ testDoneJson(5),
+ ]
+ ], doneJson());
+ });
+
+ test('runs several failing tests and reports when each fails', () {
+ return _expectReport('''
+ test('failure 1', () => throw TestFailure('oh no'));
+ test('failure 2', () => throw TestFailure('oh no'));
+ test('failure 3', () => throw TestFailure('oh no'));
+ ''', [
+ [
+ suiteJson(0),
+ testStartJson(1, 'loading test.dart', groupIDs: []),
+ testDoneJson(1, hidden: true),
+ ],
+ [
+ groupJson(2, testCount: 3),
+ testStartJson(3, 'failure 1', line: 6, column: 7),
+ errorJson(3, 'oh no', isFailure: true),
+ testDoneJson(3, result: 'failure'),
+ testStartJson(4, 'failure 2', line: 7, column: 7),
+ errorJson(4, 'oh no', isFailure: true),
+ testDoneJson(4, result: 'failure'),
+ testStartJson(5, 'failure 3', line: 8, column: 7),
+ errorJson(5, 'oh no', isFailure: true),
+ testDoneJson(5, result: 'failure'),
+ ]
+ ], doneJson(success: false));
+ });
+
+ test('includes the full stack trace with --verbose-trace', () async {
+ await d.file('test.dart', '''
+ import 'dart:async';
+
+ import 'package:test/test.dart';
+
+ void main() {
+ test("failure", () => throw "oh no");
+ }
+ ''').create();
+
+ var test =
+ await runTest(['--verbose-trace', 'test.dart'], reporter: 'json');
+ expect(test.stdout, emitsThrough(contains('dart:async')));
+ await test.shouldExit(1);
+ });
+
+ test('runs failing tests along with successful tests', () {
+ return _expectReport('''
+ test('failure 1', () => throw TestFailure('oh no'));
+ test('success 1', () {});
+ test('failure 2', () => throw TestFailure('oh no'));
+ test('success 2', () {});
+ ''', [
+ [
+ suiteJson(0),
+ testStartJson(1, 'loading test.dart', groupIDs: []),
+ testDoneJson(1, hidden: true),
+ ],
+ [
+ groupJson(2, testCount: 4),
+ testStartJson(3, 'failure 1', line: 6, column: 7),
+ errorJson(3, 'oh no', isFailure: true),
+ testDoneJson(3, result: 'failure'),
+ testStartJson(4, 'success 1', line: 7, column: 7),
+ testDoneJson(4),
+ testStartJson(5, 'failure 2', line: 8, column: 7),
+ errorJson(5, 'oh no', isFailure: true),
+ testDoneJson(5, result: 'failure'),
+ testStartJson(6, 'success 2', line: 9, column: 7),
+ testDoneJson(6),
+ ]
+ ], doneJson(success: false));
+ });
+
+ test('gracefully handles multiple test failures in a row', () {
+ return _expectReport('''
+ // This completer ensures that the test isolate isn't killed until all
+ // errors have been thrown.
+ var completer = Completer();
+ test('failures', () {
+ Future.microtask(() => throw 'first error');
+ Future.microtask(() => throw 'second error');
+ Future.microtask(() => throw 'third error');
+ Future.microtask(completer.complete);
+ });
+ test('wait', () => completer.future);
+ ''', [
+ [
+ suiteJson(0),
+ testStartJson(1, 'loading test.dart', groupIDs: []),
+ testDoneJson(1, hidden: true),
+ ],
+ [
+ groupJson(2, testCount: 2),
+ testStartJson(3, 'failures', line: 9, column: 7),
+ errorJson(3, 'first error'),
+ errorJson(3, 'second error'),
+ errorJson(3, 'third error'),
+ testDoneJson(3, result: 'error'),
+ testStartJson(4, 'wait', line: 15, column: 7),
+ testDoneJson(4),
+ ]
+ ], doneJson(success: false));
+ });
+
+ test('gracefully handles a test failing after completion', () {
+ return _expectReport('''
+ // These completers ensure that the first test won't fail until the second
+ // one is running, and that the test isolate isn't killed until all errors
+ // have been thrown.
+ var waitStarted = Completer();
+ var testDone = Completer();
+ test('failure', () {
+ waitStarted.future.then((_) {
+ Future.microtask(testDone.complete);
+ throw 'oh no';
+ });
+ });
+ test('wait', () {
+ waitStarted.complete();
+ return testDone.future;
+ });
+ ''', [
+ [
+ suiteJson(0),
+ testStartJson(1, 'loading test.dart', groupIDs: []),
+ testDoneJson(1, hidden: true),
+ ],
+ [
+ groupJson(2, testCount: 2),
+ testStartJson(3, 'failure', line: 11, column: 7),
+ testDoneJson(3),
+ testStartJson(4, 'wait', line: 17, column: 7),
+ errorJson(3, 'oh no'),
+ errorJson(
+ 3,
+ 'This test failed after it had already completed.\n'
+ 'Make sure to use a matching library which informs the '
+ 'test runner\nof pending async work.'),
+ testDoneJson(4),
+ ]
+ ], doneJson(success: false));
+ });
+
+ test('reports each test in its proper groups', () {
+ return _expectReport('''
+ group('group 1', () {
+ group('.2', () {
+ group('.3', () {
+ test('success', () {});
+ });
+ });
+
+ test('success1', () {});
+ test('success2', () {});
+ });
+ ''', [
+ [
+ suiteJson(0),
+ testStartJson(1, 'loading test.dart', groupIDs: []),
+ testDoneJson(1, hidden: true),
+ ],
+ [
+ groupJson(2, testCount: 3),
+ groupJson(3,
+ name: 'group 1', parentID: 2, testCount: 3, line: 6, column: 7),
+ groupJson(4, name: 'group 1 .2', parentID: 3, line: 7, column: 9),
+ groupJson(5, name: 'group 1 .2 .3', parentID: 4, line: 8, column: 11),
+ testStartJson(6, 'group 1 .2 .3 success',
+ groupIDs: [2, 3, 4, 5], line: 9, column: 13),
+ testDoneJson(6),
+ testStartJson(7, 'group 1 success1',
+ groupIDs: [2, 3], line: 13, column: 9),
+ testDoneJson(7),
+ testStartJson(8, 'group 1 success2',
+ groupIDs: [2, 3], line: 14, column: 9),
+ testDoneJson(8),
+ ]
+ ], doneJson());
+ });
+
+ group('print:', () {
+ test('handles multiple prints', () {
+ return _expectReport('''
+ test('test', () {
+ print("one");
+ print("two");
+ print("three");
+ print("four");
+ });
+ ''', [
+ [
+ suiteJson(0),
+ testStartJson(1, 'loading test.dart', groupIDs: []),
+ testDoneJson(1, hidden: true),
+ ],
+ [
+ groupJson(2),
+ testStartJson(3, 'test', line: 6, column: 9),
+ printJson(3, 'one'),
+ printJson(3, 'two'),
+ printJson(3, 'three'),
+ printJson(3, 'four'),
+ testDoneJson(3),
+ ]
+ ], doneJson());
+ });
+
+ test('handles a print after the test completes', () {
+ return _expectReport('''
+ // This completer ensures that the test isolate isn't killed until all
+ // prints have happened.
+ var testDone = Completer();
+ var waitStarted = Completer();
+ test('test', () async {
+ waitStarted.future.then((_) {
+ Future(() => print("one"));
+ Future(() => print("two"));
+ Future(() => print("three"));
+ Future(() => print("four"));
+ Future(testDone.complete);
+ });
+ });
+
+ test('wait', () {
+ waitStarted.complete();
+ return testDone.future;
+ });
+ ''', [
+ [
+ suiteJson(0),
+ testStartJson(1, 'loading test.dart', groupIDs: []),
+ testDoneJson(1, hidden: true),
+ ],
+ [
+ groupJson(2, testCount: 2),
+ testStartJson(3, 'test', line: 10, column: 9),
+ testDoneJson(3),
+ testStartJson(4, 'wait', line: 20, column: 9),
+ printJson(3, 'one'),
+ printJson(3, 'two'),
+ printJson(3, 'three'),
+ printJson(3, 'four'),
+ testDoneJson(4),
+ ]
+ ], doneJson());
+ });
+
+ test('interleaves prints and errors', () {
+ return _expectReport('''
+ // This completer ensures that the test isolate isn't killed until all
+ // prints have happened.
+ var completer = Completer();
+ test('test', () {
+ scheduleMicrotask(() {
+ print("three");
+ print("four");
+ throw "second error";
+ });
+
+ scheduleMicrotask(() {
+ print("five");
+ print("six");
+ completer.complete();
+ });
+
+ print("one");
+ print("two");
+ throw "first error";
+ });
+
+ test('wait', () => completer.future);
+ ''', [
+ [
+ suiteJson(0),
+ testStartJson(1, 'loading test.dart', groupIDs: []),
+ testDoneJson(1, hidden: true),
+ ],
+ [
+ groupJson(2, testCount: 2),
+ testStartJson(3, 'test', line: 9, column: 9),
+ printJson(3, 'one'),
+ printJson(3, 'two'),
+ errorJson(3, 'first error'),
+ printJson(3, 'three'),
+ printJson(3, 'four'),
+ errorJson(3, 'second error'),
+ printJson(3, 'five'),
+ printJson(3, 'six'),
+ testDoneJson(3, result: 'error'),
+ testStartJson(4, 'wait', line: 27, column: 9),
+ testDoneJson(4),
+ ]
+ ], doneJson(success: false));
+ });
+ });
+
+ group('skip:', () {
+ test('reports skipped tests', () {
+ return _expectReport('''
+ test('skip 1', () {}, skip: true);
+ test('skip 2', () {}, skip: true);
+ test('skip 3', () {}, skip: true);
+ ''', [
+ [
+ suiteJson(0),
+ testStartJson(1, 'loading test.dart', groupIDs: []),
+ testDoneJson(1, hidden: true),
+ ],
+ [
+ groupJson(2, testCount: 3),
+ testStartJson(3, 'skip 1', skip: true, line: 6, column: 9),
+ testDoneJson(3, skipped: true),
+ testStartJson(4, 'skip 2', skip: true, line: 7, column: 9),
+ testDoneJson(4, skipped: true),
+ testStartJson(5, 'skip 3', skip: true, line: 8, column: 9),
+ testDoneJson(5, skipped: true),
+ ]
+ ], doneJson());
+ });
+
+ test('reports skipped groups', () {
+ return _expectReport('''
+ group('skip', () {
+ test('success 1', () {});
+ test('success 2', () {});
+ test('success 3', () {});
+ }, skip: true);
+ ''', [
+ [
+ suiteJson(0),
+ testStartJson(1, 'loading test.dart', groupIDs: []),
+ testDoneJson(1, hidden: true),
+ ],
+ [
+ groupJson(2, testCount: 3),
+ groupJson(3,
+ name: 'skip',
+ parentID: 2,
+ skip: true,
+ testCount: 3,
+ line: 6,
+ column: 9),
+ testStartJson(4, 'skip success 1',
+ groupIDs: [2, 3], skip: true, line: 7, column: 11),
+ testDoneJson(4, skipped: true),
+ testStartJson(5, 'skip success 2',
+ groupIDs: [2, 3], skip: true, line: 8, column: 11),
+ testDoneJson(5, skipped: true),
+ testStartJson(6, 'skip success 3',
+ groupIDs: [2, 3], skip: true, line: 9, column: 11),
+ testDoneJson(6, skipped: true),
+ ]
+ ], doneJson());
+ });
+
+ test('reports the skip reason if available', () {
+ return _expectReport('''
+ test('skip 1', () {}, skip: 'some reason');
+ test('skip 2', () {}, skip: 'or another');
+ ''', [
+ [
+ suiteJson(0),
+ testStartJson(1, 'loading test.dart', groupIDs: []),
+ testDoneJson(1, hidden: true),
+ ],
+ [
+ groupJson(2, testCount: 2),
+ testStartJson(3, 'skip 1', skip: 'some reason', line: 6, column: 9),
+ printJson(3, 'Skip: some reason', type: 'skip'),
+ testDoneJson(3, skipped: true),
+ testStartJson(4, 'skip 2', skip: 'or another', line: 7, column: 9),
+ printJson(4, 'Skip: or another', type: 'skip'),
+ testDoneJson(4, skipped: true),
+ ]
+ ], doneJson());
+ });
+
+ test('runs skipped tests with --run-skipped', () {
+ return _expectReport(
+ '''
+ test('skip 1', () {}, skip: 'some reason');
+ test('skip 2', () {}, skip: 'or another');
+ ''',
+ [
+ [
+ suiteJson(0),
+ testStartJson(1, 'loading test.dart', groupIDs: []),
+ testDoneJson(1, hidden: true),
+ ],
+ [
+ groupJson(2, testCount: 2),
+ testStartJson(3, 'skip 1', line: 6, column: 9),
+ testDoneJson(3),
+ testStartJson(4, 'skip 2', line: 7, column: 9),
+ testDoneJson(4),
+ ]
+ ],
+ doneJson(),
+ args: ['--run-skipped']);
+ });
+ });
+
+ group('reports line and column numbers for', () {
+ test('the first call to setUpAll()', () {
+ return _expectReport('''
+ setUpAll(() {});
+ setUpAll(() {});
+ setUpAll(() {});
+ test('success', () {});
+ ''', [
+ [
+ suiteJson(0),
+ testStartJson(1, 'loading test.dart', groupIDs: []),
+ testDoneJson(1, hidden: true),
+ ],
+ [
+ groupJson(2, testCount: 1),
+ testStartJson(3, '(setUpAll)', line: 6, column: 9),
+ testDoneJson(3, hidden: true),
+ testStartJson(4, 'success', line: 9, column: 9),
+ testDoneJson(4),
+ testStartJson(5, '(tearDownAll)'),
+ testDoneJson(5, hidden: true),
+ ]
+ ], doneJson());
+ });
+
+ test('the first call to tearDownAll()', () {
+ return _expectReport('''
+ tearDownAll(() {});
+ tearDownAll(() {});
+ tearDownAll(() {});
+ test('success', () {});
+ ''', [
+ [
+ testStartJson(1, 'loading test.dart', groupIDs: []),
+ testDoneJson(1, hidden: true),
+ ],
+ [
+ suiteJson(0),
+ groupJson(2, testCount: 1),
+ testStartJson(3, 'success', line: 9, column: 9),
+ testDoneJson(3),
+ testStartJson(4, '(tearDownAll)', line: 6, column: 9),
+ testDoneJson(4, hidden: true),
+ ]
+ ], doneJson());
+ });
+
+ test('a test compiled to JS', () {
+ return _expectReport(
+ '''
+ test('success', () {});
+ ''',
+ [
+ [
+ suiteJson(0, platform: 'chrome'),
+ testStartJson(1, 'loading test.dart', groupIDs: []),
+ printJson(
+ 1,
+ isA<String>().having((s) => s.split('\n'), 'lines',
+ contains(startsWith('Compiled')))),
+ testDoneJson(1, hidden: true),
+ ],
+ [
+ groupJson(2, testCount: 1),
+ testStartJson(3, 'success', line: 6, column: 9),
+ testDoneJson(3),
+ ]
+ ],
+ doneJson(),
+ args: ['-p', 'chrome']);
+ }, tags: ['chrome'], skip: 'https://github.com/dart-lang/test/issues/872');
+
+ test('the root suite from a relative path', () {
+ return _expectReport(
+ '''
+ customTest('success 1', () {});
+ test('success 2', () {});
+ ''',
+ [
+ [
+ suiteJson(0),
+ testStartJson(1, 'loading test.dart', groupIDs: []),
+ testDoneJson(1, hidden: true),
+ ],
+ [
+ groupJson(2, testCount: 2),
+ testStartJson(3, 'success 1',
+ line: 3,
+ column: 60,
+ url: p.toUri(p.join(d.sandbox, 'common.dart')).toString(),
+ rootColumn: 7,
+ rootLine: 7,
+ rootUrl: p.toUri(p.join(d.sandbox, 'test.dart')).toString()),
+ testDoneJson(3),
+ testStartJson(4, 'success 2', line: 8, column: 7),
+ testDoneJson(4),
+ ]
+ ],
+ doneJson(),
+ externalLibraries: {
+ 'common.dart': '''
+import 'package:test/test.dart';
+
+void customTest(String name, dynamic Function() testFn) => test(name, testFn);
+''',
+ });
+ });
+
+ test('the root suite from an absolute path', () {
+ final path = p.prettyUri(p.join(d.sandbox, 'test.dart'));
+ return _expectReport(
+ '''
+ customTest('success 1', () {});
+ test('success 2', () {});
+ ''',
+ useRelativePath: false,
+ [
+ [
+ suiteJson(0, path: equalsIgnoringCase(path)),
+ testStartJson(
+ 1, allOf(startsWith('loading '), endsWith('test.dart')),
+ groupIDs: []),
+ testDoneJson(1, hidden: true),
+ ],
+ [
+ groupJson(2, testCount: 2),
+ testStartJson(3, 'success 1',
+ line: 3,
+ column: 60,
+ url: p.toUri(p.join(d.sandbox, 'common.dart')).toString(),
+ rootColumn: 7,
+ rootLine: 7,
+ rootUrl: p.toUri(p.join(d.sandbox, 'test.dart')).toString()),
+ testDoneJson(3),
+ testStartJson(4, 'success 2', line: 8, column: 7),
+ testDoneJson(4),
+ ]
+ ],
+ doneJson(),
+ externalLibraries: {
+ 'common.dart': '''
+import 'package:test/test.dart';
+
+void customTest(String name, dynamic Function() testFn) => test(name, testFn);
+''',
+ });
+ });
+ });
+
+ test(
+ "doesn't report line and column information for a test compiled to JS "
+ 'with --js-trace', () {
+ return _expectReport(
+ '''
+ test('success', () {});
+ ''',
+ [
+ [
+ suiteJson(0, platform: 'chrome'),
+ testStartJson(1, 'loading test.dart', groupIDs: []),
+ printJson(
+ 1,
+ isA<String>().having((s) => s.split('\n'), 'lines',
+ contains(startsWith('Compiled')))),
+ testDoneJson(1, hidden: true),
+ ],
+ [
+ groupJson(2, testCount: 1),
+ testStartJson(3, 'success'),
+ testDoneJson(3),
+ ],
+ ],
+ doneJson(),
+ args: ['-p', 'chrome', '--js-trace']);
+ }, tags: ['chrome']);
+}
+
+/// Asserts that the tests defined by [tests] produce the JSON events in
+/// [expected].
+///
+/// If [externalLibraries] are provided it should be a map of relative file
+/// paths to contents. All libraries will be added as imports to the test, and
+/// files will be created for them.
+Future<void> _expectReport(String tests,
+ List<List<Object /*Map|Matcher*/ >> expected, Map<Object, Object> done,
+ {List<String> args = const [],
+ bool useRelativePath = true,
+ Map<String, String> externalLibraries = const {}}) async {
+ var testContent = StringBuffer('''
+import 'dart:async';
+
+import 'package:test/test.dart';
+
+''');
+ for (var entry in externalLibraries.entries) {
+ testContent.writeln("import '${entry.key}';");
+ await d.file(entry.key, entry.value).create();
+ }
+ testContent
+ ..writeln('void main() {')
+ ..writeln(tests)
+ ..writeln('}');
+
+ await d.file('test.dart', testContent.toString()).create();
+ var testPath = useRelativePath ? 'test.dart' : p.join(d.sandbox, 'test.dart');
+
+ var test = await runTest([testPath, '--chain-stack-traces', ...args],
+ reporter: 'json');
+ await test.shouldExit();
+
+ var stdoutLines = await test.stdoutStream().toList();
+ return expectJsonReport(stdoutLines, test.pid, expected, done);
+}
diff --git a/pkgs/test/test/runner/json_reporter_utils.dart b/pkgs/test/test/runner/json_reporter_utils.dart
new file mode 100644
index 0000000..bbdbb78
--- /dev/null
+++ b/pkgs/test/test/runner/json_reporter_utils.dart
@@ -0,0 +1,209 @@
+// Copyright (c) 2020, 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:convert';
+
+import 'package:path/path.dart' as p;
+import 'package:test/test.dart';
+import 'package:test_core/src/runner/version.dart';
+import 'package:test_descriptor/test_descriptor.dart' as d;
+
+/// Asserts that the outputs from running tests with a JSON reporter match the
+/// given expectations.
+///
+/// Verifies that [outputLines] matches each set of matchers in [expected],
+/// includes the [testPid] from the test process, and ends with [done].
+Future<void> expectJsonReport(
+ List<String> outputLines,
+ int testPid,
+ List<List<Object /*Map|Matcher*/ >> expected,
+ Map<Object, Object> done) async {
+ // Ensure the output is of the same length, including start, done and all
+ // suites messages.
+ expect(outputLines,
+ hasLength(expected.fold<int>(3, (int a, m) => a + m.length)));
+
+ final decoded = [
+ for (final line in outputLines)
+ (jsonDecode(line) as Map)
+ ..remove('time')
+ ..remove('stackTrace')
+ ];
+
+ // Should contain all suites message.
+ expect(decoded, containsAll([_allSuitesJson()]));
+
+ // A single start event is emitted first.
+ final start = {
+ 'type': 'start',
+ 'protocolVersion': '0.1.1',
+ 'runnerVersion': testVersion,
+ 'pid': testPid,
+ };
+ expect(decoded.first, equals(start));
+
+ // A single done event is emitted last.
+ expect(decoded.last, equals(done));
+
+ for (var value in expected) {
+ expect(decoded, containsAllInOrder(value));
+ }
+}
+
+/// Returns the event emitted by the JSON reporter providing information about
+/// all suites.
+///
+/// The [count] defaults to 1.
+Map<String, Object> _allSuitesJson({int count = 1}) =>
+ {'type': 'allSuites', 'count': count};
+
+/// Returns the event emitted by the JSON reporter indicating that a suite has
+/// begun running.
+///
+/// The [platform] defaults to `'vm'`.
+/// The [path] defaults to `equals('test.dart')`.
+Map<String, Object> suiteJson(int id,
+ {String platform = 'vm', Matcher? path}) =>
+ {
+ 'type': 'suite',
+ 'suite': {
+ 'id': id,
+ 'platform': platform,
+ 'path': path ?? 'test.dart',
+ }
+ };
+
+/// Returns the event emitted by the JSON reporter indicating that a group has
+/// begun running.
+///
+/// If [skip] is `true`, the group is expected to be marked as skipped without a
+/// reason. If it's a [String], the group is expected to be marked as skipped
+/// with that reason.
+///
+/// The [testCount] parameter indicates the number of tests in the group. It
+/// defaults to 1.
+Map<String, Object> groupJson(int id,
+ {String? name,
+ int? suiteID,
+ int? parentID,
+ Object? skip,
+ int? testCount,
+ int? line,
+ int? column}) {
+ if ((line == null) != (column == null)) {
+ throw ArgumentError(
+ 'line and column must either both be null or both be passed');
+ }
+
+ return {
+ 'type': 'group',
+ 'group': {
+ 'id': id,
+ 'name': name ?? '',
+ 'suiteID': suiteID ?? 0,
+ 'parentID': parentID,
+ 'metadata': _metadataJson(skip: skip),
+ 'testCount': testCount ?? 1,
+ 'line': line,
+ 'column': column,
+ 'url': line == null
+ ? null
+ : p.toUri(p.join(d.sandbox, 'test.dart')).toString()
+ }
+ };
+}
+
+/// Returns the event emitted by the JSON reporter indicating that a test has
+/// begun running.
+///
+/// If [parentIDs] is passed, it's the IDs of groups containing this test. If
+/// [skip] is `true`, the test is expected to be marked as skipped without a
+/// reason. If it's a [String], the test is expected to be marked as skipped
+/// with that reason.
+Map<String, Object> testStartJson(int id, Object /*String|Matcher*/ name,
+ {int? suiteID,
+ Iterable<int>? groupIDs,
+ int? line,
+ int? column,
+ String? url,
+ Object? skip,
+ int? rootLine,
+ int? rootColumn,
+ String? rootUrl}) {
+ if ((line == null) != (column == null)) {
+ throw ArgumentError(
+ 'line and column must either both be null or both be passed');
+ }
+
+ url ??=
+ line == null ? null : p.toUri(p.join(d.sandbox, 'test.dart')).toString();
+ return {
+ 'type': 'testStart',
+ 'test': {
+ 'id': id,
+ 'name': name,
+ 'suiteID': suiteID ?? 0,
+ 'groupIDs': groupIDs ?? [2],
+ 'metadata': _metadataJson(skip: skip),
+ 'line': line,
+ 'column': column,
+ 'url': url,
+ if (rootLine != null) 'root_line': rootLine,
+ if (rootColumn != null) 'root_column': rootColumn,
+ if (rootUrl != null) 'root_url': rootUrl,
+ }
+ };
+}
+
+/// Returns the event emitted by the JSON reporter indicating that a test
+/// printed [message].
+Matcher printJson(int id, dynamic /*String|Matcher*/ message,
+ {String type = 'print'}) =>
+ allOf(
+ hasLength(4),
+ containsPair('type', 'print'),
+ containsPair('testID', id),
+ containsPair('message', message),
+ containsPair('messageType', type),
+ );
+
+/// Returns the event emitted by the JSON reporter indicating that a test
+/// emitted [error].
+///
+/// The [isFailure] parameter indicates whether the error was a [TestFailure] or
+/// not.
+Map<String, Object> errorJson(int id, String error, {bool isFailure = false}) =>
+ {'type': 'error', 'testID': id, 'error': error, 'isFailure': isFailure};
+
+/// Returns the event emitted by the JSON reporter indicating that a test
+/// finished.
+///
+/// The [result] parameter indicates the result of the test. It defaults to
+/// `"success"`.
+///
+/// The [hidden] parameter indicates whether the test should not be displayed
+/// after finishing. The [skipped] parameter indicates whether the test was
+/// skipped.
+Map<String, Object> testDoneJson(int id,
+ {String result = 'success',
+ bool hidden = false,
+ bool skipped = false}) =>
+ {
+ 'type': 'testDone',
+ 'testID': id,
+ 'result': result,
+ 'hidden': hidden,
+ 'skipped': skipped
+ };
+
+/// Returns the event emitted by the JSON reporter indicating that the entire
+/// run finished.
+Map<String, Object> doneJson({bool success = true}) =>
+ {'type': 'done', 'success': success};
+
+/// Returns the serialized metadata corresponding to [skip].
+Map<String, Object?> _metadataJson({Object? skip}) => {
+ 'skip': skip == true || skip is String,
+ 'skipReason': skip is String ? skip : null
+ };
diff --git a/pkgs/test/test/runner/line_and_col_test.dart b/pkgs/test/test/runner/line_and_col_test.dart
new file mode 100644
index 0000000..c513cef
--- /dev/null
+++ b/pkgs/test/test/runner/line_and_col_test.dart
@@ -0,0 +1,386 @@
+// Copyright (c) 2021, 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.
+
+@TestOn('vm')
+library;
+
+import 'package:test/test.dart';
+import 'package:test_core/src/util/exit_codes.dart' as exit_codes;
+import 'package:test_descriptor/test_descriptor.dart' as d;
+
+import '../io.dart';
+
+void main() {
+ setUpAll(precompileTestExecutable);
+
+ group('with test.dart?line=<line> query', () {
+ test('selects test with the matching line', () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("a", () {});
+ test("b", () => throw TestFailure("oh no"));
+ test("c", () {});
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart?line=6']);
+
+ expect(
+ test.stdout,
+ emitsThrough(contains('+1: All tests passed!')),
+ );
+
+ await test.shouldExit(0);
+ });
+
+ test('selects multiple tests on the same line', () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("a", () {}); test("b", () {});
+ test("c", () => throw TestFailure("oh no"));
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart?line=4']);
+
+ expect(
+ test.stdout,
+ emitsThrough(contains('+2: All tests passed!')),
+ );
+
+ await test.shouldExit(0);
+ });
+
+ test('selects groups with a matching line', () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ group("a", () {
+ test("b", () {});
+ });
+ group("b", () {
+ test("b", () => throw TestFailure("oh no"));
+ });
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart?line=4']);
+
+ expect(
+ test.stdout,
+ emitsThrough(contains('+1: All tests passed!')),
+ );
+
+ await test.shouldExit(0);
+ });
+
+ test('No matching tests', () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("a", () {});
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart?line=1']);
+
+ expect(
+ test.stderr,
+ emitsThrough(contains('No tests were found.')),
+ );
+
+ await test.shouldExit(exit_codes.noTestsRan);
+ });
+
+ test('allows the line anywhere in the stack trace', () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void runTest(String name) {
+ test(name, () {});
+ }
+
+ void main() {
+ runTest("a");
+ test("b", () {});
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart?line=8']);
+
+ expect(
+ test.stdout,
+ emitsThrough(contains('+1: All tests passed!')),
+ );
+
+ await test.shouldExit(0);
+ });
+ });
+
+ group('with test.dart?col=<col> query', () {
+ test('selects single test with the matching column', () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("a", () {});
+ test("b", () => throw TestFailure("oh no"));
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart?col=11']);
+
+ expect(
+ test.stdout,
+ emitsThrough(contains('+1: All tests passed!')),
+ );
+
+ await test.shouldExit(0);
+ });
+
+ test('selects multiple tests starting on the same column', () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("a", () {});
+ test("b", () {});
+ test("c", () => throw TestFailure("oh no"));
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart?col=11']);
+
+ expect(
+ test.stdout,
+ emitsThrough(contains('+2: All tests passed!')),
+ );
+
+ await test.shouldExit(0);
+ });
+
+ test('selects groups with a matching column', () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ group("a", () {
+ test("b", () {});
+ });
+ group("b", () {
+ test("b", () => throw TestFailure("oh no"));
+ });
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart?col=11']);
+
+ expect(
+ test.stdout,
+ emitsThrough(contains('+1: All tests passed!')),
+ );
+
+ await test.shouldExit(0);
+ });
+
+ test('No matching tests', () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("a", () {});
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart?col=1']);
+
+ expect(
+ test.stderr,
+ emitsThrough(contains('No tests were found.')),
+ );
+
+ await test.shouldExit(exit_codes.noTestsRan);
+ });
+
+ test('allows the col anywhere in the stack trace', () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void runTest(String name) {
+ test(name, () {});
+ }
+
+ void main() {
+ runTest("a");
+ test("b", () => throw TestFailure("oh no"));
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart?col=13']);
+
+ expect(
+ test.stdout,
+ emitsThrough(contains('+1: All tests passed!')),
+ );
+
+ await test.shouldExit(0);
+ });
+ });
+
+ group('with test.dart?line=<line>&col=<col> query', () {
+ test('selects test with the matching line and col in the same frame',
+ () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ void runTests() {
+ test("a", () {});test("b", () => throw TestFailure("oh no"));
+ }
+ runTests();
+ test("c", () => throw TestFailure("oh no"));
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart?line=5&col=11']);
+
+ expect(
+ test.stdout,
+ emitsThrough(contains('+1: All tests passed!')),
+ );
+
+ await test.shouldExit(0);
+ });
+
+ test('selects group with the matching line and col', () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ group("a", () {
+ test("b", () {});
+ test("c", () {});
+ });
+ group("d", () {
+ test("e", () => throw TestFailure("oh no"));
+ });
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart?line=4&col=11']);
+
+ expect(
+ test.stdout,
+ emitsThrough(contains('+2: All tests passed!')),
+ );
+
+ await test.shouldExit(0);
+ });
+
+ test('no matching tests - col doesnt match', () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("a", () {});
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart?line=4&col=1']);
+
+ expect(
+ test.stderr,
+ emitsThrough(contains('No tests were found.')),
+ );
+
+ await test.shouldExit(exit_codes.noTestsRan);
+ });
+
+ test('no matching tests - line doesnt match', () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("a", () {});
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart?line=1&col=11']);
+
+ expect(
+ test.stderr,
+ emitsThrough(contains('No tests were found.')),
+ );
+
+ await test.shouldExit(exit_codes.noTestsRan);
+ });
+
+ test('supports browser tests', () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("a", () {});
+ test("b", () => throw TestFailure("oh no"));
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart?line=4&col=11', '-p', 'chrome']);
+
+ expect(
+ test.stdout,
+ emitsThrough(contains('+1: All tests passed!')),
+ );
+
+ await test.shouldExit(0);
+ });
+
+ test('supports node tests', () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("a", () {});
+ test("b", () => throw TestFailure("oh no"));
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart?line=4&col=11', '-p', 'node']);
+
+ expect(
+ test.stdout,
+ emitsThrough(contains('+1: All tests passed!')),
+ );
+
+ await test.shouldExit(0);
+ }, retry: 3);
+ });
+
+ test('bundles runs by suite, deduplicates tests that match multiple times',
+ () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test('a', () {});
+ test('b', () => throw TestFailure('oh no'));
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart?line=4', 'test.dart?full-name=a']);
+
+ expect(
+ test.stdout,
+ emitsThrough(contains('+1: All tests passed!')),
+ );
+
+ await test.shouldExit(0);
+ });
+}
diff --git a/pkgs/test/test/runner/load_suite_test.dart b/pkgs/test/test/runner/load_suite_test.dart
new file mode 100644
index 0000000..ab5fc79
--- /dev/null
+++ b/pkgs/test/test/runner/load_suite_test.dart
@@ -0,0 +1,178 @@
+// Copyright (c) 2015, 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.
+
+@TestOn('vm')
+library;
+
+import 'dart:async';
+
+import 'package:test/test.dart';
+import 'package:test_api/src/backend/group.dart';
+import 'package:test_api/src/backend/runtime.dart';
+import 'package:test_api/src/backend/state.dart';
+import 'package:test_api/src/backend/test.dart';
+import 'package:test_core/src/runner/load_exception.dart';
+import 'package:test_core/src/runner/load_suite.dart';
+import 'package:test_core/src/runner/runner_suite.dart';
+import 'package:test_core/src/runner/suite.dart';
+
+import '../utils.dart';
+
+void main() {
+ late RunnerSuite innerSuite;
+ setUp(() {
+ innerSuite = runnerSuite(Group.root([]));
+ });
+
+ test('running a load test causes LoadSuite.suite to emit a suite', () async {
+ var suite = LoadSuite('name', SuiteConfiguration.empty, suitePlatform,
+ () => Future.value(innerSuite));
+ expect(suite.group.entries, hasLength(1));
+
+ expect(suite.suite, completion(equals(innerSuite)));
+ var liveTest = (suite.group.entries.single as Test).load(suite);
+ await liveTest.run();
+ expectTestPassed(liveTest);
+ });
+
+ test("running a load suite's body may be synchronous", () async {
+ var suite = LoadSuite(
+ 'name', SuiteConfiguration.empty, suitePlatform, () => innerSuite);
+ expect(suite.group.entries, hasLength(1));
+
+ expect(suite.suite, completion(equals(innerSuite)));
+ var liveTest = (suite.group.entries.single as Test).load(suite);
+ await liveTest.run();
+ expectTestPassed(liveTest);
+ });
+
+ test("a load test doesn't complete until the body returns", () async {
+ var completer = Completer<RunnerSuite>();
+ var suite = LoadSuite('name', SuiteConfiguration.empty, suitePlatform,
+ () => completer.future);
+ expect(suite.group.entries, hasLength(1));
+
+ var liveTest = (suite.group.entries.single as Test).load(suite);
+ expect(liveTest.run(), completes);
+ await Future<void>.delayed(Duration.zero);
+ expect(liveTest.state.status, equals(Status.running));
+
+ completer.complete(innerSuite);
+ await Future<void>.delayed(Duration.zero);
+ expectTestPassed(liveTest);
+ });
+
+ test('a load test forwards errors and completes LoadSuite.suite to null',
+ () async {
+ var suite = LoadSuite('name', SuiteConfiguration.empty, suitePlatform, () {
+ return fail('error');
+ });
+ expect(suite.group.entries, hasLength(1));
+
+ expect(suite.suite, completion(isNull));
+
+ var liveTest = (suite.group.entries.single as Test).load(suite);
+ await liveTest.run();
+ expectTestFailed(liveTest, 'error');
+ });
+
+ test("a load test completes early if it's closed", () async {
+ var suite = LoadSuite('name', SuiteConfiguration.empty, suitePlatform,
+ () => Completer<RunnerSuite>().future);
+ expect(suite.group.entries, hasLength(1));
+
+ var liveTest = (suite.group.entries.single as Test).load(suite);
+ expect(liveTest.run(), completes);
+ await Future<void>.delayed(Duration.zero);
+ expect(liveTest.state.status, equals(Status.running));
+
+ expect(liveTest.close(), completes);
+ });
+
+ test('forLoadException() creates a suite that completes to a LoadException',
+ () async {
+ var exception = LoadException('path', 'error');
+ var suite = LoadSuite.forLoadException(exception, SuiteConfiguration.empty);
+ expect(suite.group.entries, hasLength(1));
+
+ expect(suite.suite, completion(isNull));
+
+ var liveTest = (suite.group.entries.single as Test).load(suite);
+ await liveTest.run();
+ expect(liveTest.state.status, equals(Status.complete));
+ expect(liveTest.state.result, equals(Result.error));
+ expect(liveTest.errors, hasLength(1));
+ expect(liveTest.errors.first.error, equals(exception));
+ });
+
+ test('forSuite() creates a load suite that completes to a test suite',
+ () async {
+ var suite = LoadSuite.forSuite(innerSuite);
+ expect(suite.group.entries, hasLength(1));
+
+ expect(suite.suite, completion(equals(innerSuite)));
+ var liveTest = (suite.group.entries.single as Test).load(suite);
+ await liveTest.run();
+ expectTestPassed(liveTest);
+ });
+
+ group('changeSuite()', () {
+ test('returns a new load suite with the same properties', () {
+ var suite = LoadSuite(
+ 'name', SuiteConfiguration.empty, suitePlatform, () => innerSuite);
+ expect(suite.group.entries, hasLength(1));
+
+ var newSuite = suite.changeSuite((suite) => suite);
+ expect(newSuite.platform.runtime, equals(Runtime.vm));
+ expect(newSuite.group.entries.single.name,
+ equals(suite.group.entries.single.name));
+ });
+
+ test('changes the inner suite', () async {
+ var suite = LoadSuite(
+ 'name', SuiteConfiguration.empty, suitePlatform, () => innerSuite);
+ expect(suite.group.entries, hasLength(1));
+
+ var newInnerSuite = runnerSuite(Group.root([]));
+ var newSuite = suite.changeSuite((suite) => newInnerSuite);
+ expect(newSuite.suite, completion(equals(newInnerSuite)));
+
+ var liveTest = (suite.group.entries.single as Test).load(suite);
+ await liveTest.run();
+ expectTestPassed(liveTest);
+ });
+
+ test("doesn't run change() if the suite is null", () async {
+ var suite = LoadSuite(
+ 'name', SuiteConfiguration.empty, suitePlatform, () => null);
+ expect(suite.group.entries, hasLength(1));
+
+ var newSuite = suite.changeSuite(expectAsync1((_) {
+ return null;
+ }, count: 0));
+ expect(newSuite.suite, completion(isNull));
+
+ var liveTest = (suite.group.entries.single as Test).load(suite);
+ await liveTest.run();
+ expectTestPassed(liveTest);
+ });
+ });
+
+ group('getSuite()', () {
+ test('runs the test and returns the suite', () {
+ var suite = LoadSuite.forSuite(innerSuite);
+ expect(suite.group.entries, hasLength(1));
+
+ expect(suite.getSuite(), completion(equals(innerSuite)));
+ });
+
+ test('forwards errors to the future', () {
+ var suite = LoadSuite(
+ 'name', SuiteConfiguration.empty, suitePlatform, () => throw 'error');
+ expect(suite.group.entries, hasLength(1));
+
+ expect(suite.getSuite(), throwsA('error'));
+ });
+ });
+}
diff --git a/pkgs/test/test/runner/loader_test.dart b/pkgs/test/test/runner/loader_test.dart
new file mode 100644
index 0000000..8d1d4ad
--- /dev/null
+++ b/pkgs/test/test/runner/loader_test.dart
@@ -0,0 +1,293 @@
+// Copyright (c) 2015, 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.
+
+@TestOn('vm')
+library;
+
+import 'dart:async';
+
+import 'package:path/path.dart' as p;
+import 'package:test/test.dart';
+import 'package:test_api/src/backend/compiler.dart';
+import 'package:test_api/src/backend/runtime.dart';
+import 'package:test_api/src/backend/state.dart';
+import 'package:test_api/src/backend/test.dart';
+import 'package:test_core/src/runner/compiler_selection.dart';
+import 'package:test_core/src/runner/load_suite.dart';
+import 'package:test_core/src/runner/loader.dart';
+import 'package:test_core/src/runner/runner_suite.dart';
+import 'package:test_core/src/runner/runner_test.dart';
+import 'package:test_core/src/runner/suite.dart';
+import 'package:test_descriptor/test_descriptor.dart' as d;
+
+import '../utils.dart';
+
+late Loader _loader;
+
+final _tests = '''
+import 'dart:async';
+
+import 'package:test/test.dart';
+
+void main() {
+ test("success", () {});
+ test("failure", () => throw TestFailure('oh no'));
+ test("error", () => throw 'oh no');
+}
+''';
+
+void main() {
+ setUp(() async {
+ _loader = Loader();
+ });
+
+ tearDown(() => _loader.close());
+
+ group('.loadFile()', () {
+ late RunnerSuite suite;
+ group('with empty configuration', () {
+ setUp(() async {
+ await d.file('a_test.dart', _tests).create();
+ var suites = await _loader
+ .loadFile(
+ p.join(d.sandbox, 'a_test.dart'), SuiteConfiguration.empty)
+ .toList();
+ expect(suites, hasLength(1));
+ var loadSuite = suites.first;
+ suite = (await loadSuite.getSuite())!;
+ });
+
+ test('returns a suite with the file path and platform', () {
+ expect(suite.path, equals(p.join(d.sandbox, 'a_test.dart')));
+ expect(suite.platform.runtime, equals(Runtime.vm));
+ expect(suite.platform.compiler, equals(Runtime.vm.defaultCompiler));
+ });
+
+ test('returns entries with the correct names and platforms', () {
+ expect(suite.group.entries, hasLength(3));
+ expect(suite.group.entries[0].name, equals('success'));
+ expect(suite.group.entries[1].name, equals('failure'));
+ expect(suite.group.entries[2].name, equals('error'));
+ });
+
+ test('can load and run a successful test', () {
+ var liveTest = (suite.group.entries[0] as RunnerTest).load(suite);
+
+ expectStates(liveTest, [
+ const State(Status.running, Result.success),
+ const State(Status.complete, Result.success)
+ ]);
+ expectErrors(liveTest, []);
+
+ return liveTest.run().whenComplete(() => liveTest.close());
+ });
+
+ test('can load and run a failing test', () {
+ var liveTest = (suite.group.entries[1] as RunnerTest).load(suite);
+ expectSingleFailure(liveTest);
+ return liveTest.run().whenComplete(() => liveTest.close());
+ });
+ });
+
+ group('with compiler selection', () {
+ Future<List<LoadSuite>> loadSuitesWithConfig(
+ SuiteConfiguration suiteConfiguration) async {
+ await d.file('a_test.dart', _tests).create();
+ return _loader
+ .loadFile(p.join(d.sandbox, 'a_test.dart'), suiteConfiguration)
+ .toList();
+ }
+
+ test('with a single compiler selection, uses the selected compiler',
+ () async {
+ var suites = await loadSuitesWithConfig(suiteConfiguration(
+ compilerSelections: [CompilerSelection.parse('source')]));
+ expect(suites, hasLength(1));
+ var loadSuite = suites.first;
+ suite = (await loadSuite.getSuite())!;
+ expect(suite.path, equals(p.join(d.sandbox, 'a_test.dart')));
+ expect(suite.platform.runtime, equals(Runtime.vm));
+ expect(suite.platform.compiler, equals(Compiler.source));
+ });
+
+ test('with multiple compiler selections, returns a suite for each',
+ () async {
+ var suites = await loadSuitesWithConfig(suiteConfiguration(
+ compilerSelections: [
+ CompilerSelection.parse('source'),
+ CompilerSelection.parse('kernel')
+ ]));
+
+ expect(suites, hasLength(2));
+ var runnerSuites =
+ await Future.wait([for (var suite in suites) suite.getSuite()]);
+ expect(
+ runnerSuites,
+ unorderedEquals([
+ isA<RunnerSuite>()
+ .having(
+ (s) => s.platform.runtime, 'The vm runtime', Runtime.vm)
+ .having((s) => s.platform.compiler, 'The source compiler',
+ Compiler.source),
+ isA<RunnerSuite>()
+ .having(
+ (s) => s.platform.runtime, 'The vm runtime', Runtime.vm)
+ .having((s) => s.platform.compiler, 'The kernel compiler',
+ Compiler.kernel),
+ ]));
+ });
+
+ test('with unsupported compiler selections, uses the default compiler',
+ () async {
+ var suites =
+ await loadSuitesWithConfig(suiteConfiguration(compilerSelections: [
+ CompilerSelection.parse('dart2js'),
+ ]));
+ expect(suites, hasLength(1));
+ var loadSuite = suites.first;
+ suite = (await loadSuite.getSuite())!;
+ expect(suite.path, equals(p.join(d.sandbox, 'a_test.dart')));
+ expect(suite.platform.runtime, equals(Runtime.vm));
+ expect(suite.platform.compiler, equals(Runtime.vm.defaultCompiler));
+ });
+
+ test('compiler selections support matching boolean selectors', () async {
+ var suites =
+ await loadSuitesWithConfig(suiteConfiguration(compilerSelections: [
+ CompilerSelection.parse('vm:source'),
+ ]));
+ expect(suites, hasLength(1));
+ var loadSuite = suites.first;
+ suite = (await loadSuite.getSuite())!;
+ expect(suite.path, equals(p.join(d.sandbox, 'a_test.dart')));
+ expect(suite.platform.runtime, equals(Runtime.vm));
+ expect(suite.platform.compiler, equals(Compiler.source));
+ });
+
+ test('compiler selections support unmatched boolean selectors', () async {
+ var suites =
+ await loadSuitesWithConfig(suiteConfiguration(compilerSelections: [
+ CompilerSelection.parse('browser:source'),
+ ]));
+ expect(suites, hasLength(1));
+ var loadSuite = suites.first;
+ suite = (await loadSuite.getSuite())!;
+ expect(suite.path, equals(p.join(d.sandbox, 'a_test.dart')));
+ expect(suite.platform.runtime, equals(Runtime.vm));
+ expect(suite.platform.compiler,
+ allOf(Runtime.vm.defaultCompiler, isNot(Compiler.source)));
+ });
+ });
+ });
+
+ group('.loadDir()', () {
+ test('ignores non-Dart files', () async {
+ await d.file('a_test.txt', _tests).create();
+ expect(_loader.loadDir(d.sandbox, SuiteConfiguration.empty).toList(),
+ completion(isEmpty));
+ });
+
+ test("ignores files that don't end in _test.dart", () async {
+ await d.file('test.dart', _tests).create();
+ expect(_loader.loadDir(d.sandbox, SuiteConfiguration.empty).toList(),
+ completion(isEmpty));
+ });
+
+ group('with suites loaded from a directory', () {
+ late List<RunnerSuite> suites;
+ setUp(() async {
+ await d.file('a_test.dart', _tests).create();
+ await d.file('another_test.dart', _tests).create();
+ await d.dir('dir', [d.file('sub_test.dart', _tests)]).create();
+
+ suites = await _loader
+ .loadDir(d.sandbox, SuiteConfiguration.empty)
+ .asyncMap((loadSuite) async => (await loadSuite.getSuite())!)
+ .toList();
+ });
+
+ test('gives those suites the correct paths', () {
+ expect(
+ suites.map((suite) => suite.path),
+ unorderedEquals([
+ p.join(d.sandbox, 'a_test.dart'),
+ p.join(d.sandbox, 'another_test.dart'),
+ p.join(d.sandbox, 'dir', 'sub_test.dart')
+ ]));
+ });
+
+ test('can run tests in those suites', () {
+ var suite =
+ suites.firstWhere((suite) => suite.path!.contains('a_test'));
+ var liveTest = (suite.group.entries[1] as RunnerTest).load(suite);
+ expectSingleFailure(liveTest);
+ return liveTest.run().whenComplete(() => liveTest.close());
+ });
+ });
+ });
+
+ test('a print in a loaded file is piped through the LoadSuite', () async {
+ await d.file('a_test.dart', '''
+ void main() {
+ print('print within test');
+ }
+ ''').create();
+ var suites = await _loader
+ .loadFile(p.join(d.sandbox, 'a_test.dart'), SuiteConfiguration.empty)
+ .toList();
+ expect(suites, hasLength(1));
+ var loadSuite = suites.first;
+
+ var liveTest = (loadSuite.group.entries.single as Test).load(loadSuite);
+ expect(liveTest.onMessage.first.then((message) => message.text),
+ completion(equals('print within test')));
+ await liveTest.run();
+ expectTestPassed(liveTest);
+ });
+
+ group('LoadException', () {
+ test('suites can be retried', () async {
+ var numRetries = 5;
+
+ await d.file('a_test.dart', '''
+ import 'hello.dart';
+
+ void main() {}
+ ''').create();
+
+ var firstFailureCompleter = Completer<void>();
+
+ // After the first load failure we create the missing dependency.
+ unawaited(firstFailureCompleter.future.then((_) async {
+ await d.file('hello.dart', '''
+ String get message => 'hello';
+ ''').create();
+ }));
+
+ await runZoned(() async {
+ var suites = await _loader
+ .loadFile(p.join(d.sandbox, 'a_test.dart'),
+ suiteConfiguration(retry: numRetries))
+ .toList();
+ expect(suites, hasLength(1));
+ var loadSuite = suites.first;
+ var suite = (await loadSuite.getSuite())!;
+ expect(suite.path, equals(p.join(d.sandbox, 'a_test.dart')));
+ expect(suite.platform.runtime, equals(Runtime.vm));
+ }, zoneSpecification:
+ ZoneSpecification(print: (_, parent, zone, message) {
+ if (message.contains('Retrying load of') &&
+ !firstFailureCompleter.isCompleted) {
+ firstFailureCompleter.complete(null);
+ }
+ parent.print(zone, message);
+ }));
+
+ expect(firstFailureCompleter.isCompleted, true);
+ });
+ });
+
+ // TODO: Test load suites. Don't forget to test that prints in loaded files
+ // are piped through the suite. Also for browser tests!
+}
diff --git a/pkgs/test/test/runner/name_test.dart b/pkgs/test/test/runner/name_test.dart
new file mode 100644
index 0000000..bd4dc21
--- /dev/null
+++ b/pkgs/test/test/runner/name_test.dart
@@ -0,0 +1,460 @@
+// Copyright (c) 2016, 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.
+
+@TestOn('vm')
+library;
+
+import 'package:test/test.dart';
+import 'package:test_core/src/util/exit_codes.dart' as exit_codes;
+import 'package:test_descriptor/test_descriptor.dart' as d;
+
+import '../io.dart';
+
+void main() {
+ setUpAll(precompileTestExecutable);
+
+ group('with test.dart?name="name" query', () {
+ test('selects tests with matching names', () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("selected 1", () {});
+ test("nope", () => throw TestFailure("oh no"));
+ test("selected 2", () {});
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart?name=selected']);
+
+ expect(
+ test.stdout,
+ emitsThrough(contains('+2: All tests passed!')),
+ );
+
+ await test.shouldExit(0);
+ });
+
+ test('supports RegExp syntax', () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("test 1", () {});
+ test("test 2", () => throw TestFailure("oh no"));
+ test("test 3", () {});
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart?name=test [13]']);
+
+ expect(
+ test.stdout,
+ emitsThrough(contains('+2: All tests passed!')),
+ );
+
+ await test.shouldExit(0);
+ });
+
+ test('applies only to the associated file', () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("selected 1", () {});
+ test("selected 2", () => throw TestFailure("oh no"));
+ }
+ ''').create();
+
+ await d.file('test2.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("selected 1", () => throw TestFailure("oh no"));
+ test("selected 2", () {});
+ }
+ ''').create();
+
+ var test = await runTest(
+ ['test.dart?name=selected 1', 'test2.dart?name=selected 2'],
+ );
+
+ expect(
+ test.stdout,
+ emitsThrough(contains('+2: All tests passed!')),
+ );
+ await test.shouldExit(0);
+ });
+
+ test('selects more narrowly when passed multiple times', () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("selected 1", () {});
+ test("nope", () => throw TestFailure("oh no"));
+ test("selected 2", () {});
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart?name=selected&name=1']);
+
+ expect(
+ test.stdout,
+ emitsThrough(contains('+1: All tests passed!')),
+ );
+ await test.shouldExit(0);
+ });
+
+ test('applies to directories', () async {
+ await d.dir('dir', [
+ d.file('first_test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("selected 1", () {});
+ test("selected 2", () => throw TestFailure("oh no"));
+ }
+ '''),
+ d.file('second_test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("selected 1", () {});
+ test("selected 2", () => throw TestFailure("oh no"));
+ }
+ ''')
+ ]).create();
+
+ var test = await runTest(['dir?name=selected 1']);
+
+ expect(
+ test.stdout,
+ emitsThrough(contains('+2: All tests passed!')),
+ );
+ await test.shouldExit(0);
+ });
+
+ test('produces an error when no tests match', () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("test", () {});
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart?name=no']);
+
+ expect(
+ test.stderr,
+ emitsThrough(contains('No tests were found.')),
+ );
+
+ await test.shouldExit(exit_codes.noTestsRan);
+ });
+
+ test("doesn't filter out load exceptions", () async {
+ var test = await runTest(['file?name=name']);
+ expect(
+ test.stdout,
+ containsInOrder([
+ '-1: loading file [E]',
+ ' Failed to load "file": Does not exist.'
+ ]),
+ );
+
+ await test.shouldExit(1);
+ });
+ });
+
+ group('with test.dart?full-name query,', () {
+ test('matches with the complete test name', () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("selected", () {});
+ test("nope", () => throw TestFailure("oh no"));
+ test("selected nope", () => throw TestFailure("oh no"));
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart?full-name=selected']);
+
+ expect(
+ test.stdout,
+ emitsThrough(contains('+1: All tests passed!')),
+ );
+ await test.shouldExit(0);
+ });
+
+ test("doesn't support RegExp syntax", () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("test 1", () => throw TestFailure("oh no"));
+ test("test 2", () => throw TestFailure("oh no"));
+ test("test [12]", () {});
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart?full-name=test [12]']);
+
+ expect(
+ test.stdout,
+ emitsThrough(contains('+1: All tests passed!')),
+ );
+ await test.shouldExit(0);
+ });
+
+ test('applies only to the associated file', () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("selected 1", () {});
+ test("selected 2", () => throw TestFailure("oh no"));
+ }
+ ''').create();
+
+ await d.file('test2.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("selected 1", () => throw TestFailure("oh no"));
+ test("selected 2", () {});
+ }
+ ''').create();
+
+ var test = await runTest(
+ ['test.dart?full-name=selected 1', 'test2.dart?full-name=selected 2'],
+ );
+
+ expect(
+ test.stdout,
+ emitsThrough(contains('+2: All tests passed!')),
+ );
+ await test.shouldExit(0);
+ });
+
+ test('produces an error when no tests match', () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("test", () {});
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart?full-name=no match']);
+
+ expect(
+ test.stderr,
+ emitsThrough(contains('No tests were found.')),
+ );
+ await test.shouldExit(exit_codes.noTestsRan);
+ });
+ });
+
+ test('test?name="name" and --name narrow the selection', () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("selected 1", () {});
+ test("nope 1", () => throw TestFailure("oh no"));
+ test("selected 2", () => throw TestFailure("oh no"));
+ test("nope 2", () => throw TestFailure("oh no"));
+ }
+ ''').create();
+
+ var test = await runTest(['--name', '1', 'test.dart?name=selected']);
+
+ expect(
+ test.stdout,
+ emitsThrough(contains('+1: All tests passed!')),
+ );
+ await test.shouldExit(0);
+ });
+
+ test('test?name="name" and test?full-name="name" throws', () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("selected 1", () {});
+ test("nope 1", () => throw TestFailure("oh no"));
+ test("selected 2", () => throw TestFailure("oh no"));
+ test("nope 2", () => throw TestFailure("oh no"));
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart?name=selected&full-name=selected 1']);
+
+ await test.shouldExit(64);
+ });
+
+ group('with the --name flag,', () {
+ test('selects tests with matching names', () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("selected 1", () {});
+ test("nope", () => throw TestFailure("oh no"));
+ test("selected 2", () {});
+ }
+ ''').create();
+
+ var test = await runTest(['--name', 'selected', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains('+2: All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ test('supports RegExp syntax', () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("test 1", () {});
+ test("test 2", () => throw TestFailure("oh no"));
+ test("test 3", () {});
+ }
+ ''').create();
+
+ var test = await runTest(['--name', 'test [13]', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains('+2: All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ test('selects more narrowly when passed multiple times', () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("selected 1", () {});
+ test("nope", () => throw TestFailure("oh no"));
+ test("selected 2", () {});
+ }
+ ''').create();
+
+ var test =
+ await runTest(['--name', 'selected', '--name', '1', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ test('produces an error when no tests match', () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("test", () {});
+ }
+ ''').create();
+
+ var test = await runTest(['--name', 'no match', 'test.dart']);
+ expect(
+ test.stderr,
+ emitsThrough(
+ contains('No tests match regular expression "no match".')));
+ await test.shouldExit(exit_codes.noTestsRan);
+ });
+
+ test("doesn't filter out load exceptions", () async {
+ var test = await runTest(['--name', 'name', 'file']);
+ expect(
+ test.stdout,
+ containsInOrder([
+ '-1: loading file [E]',
+ ' Failed to load "file": Does not exist.'
+ ]));
+ await test.shouldExit(1);
+ });
+ });
+
+ group('with the --plain-name flag,', () {
+ test('selects tests with matching names', () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("selected 1", () {});
+ test("nope", () => throw TestFailure("oh no"));
+ test("selected 2", () {});
+ }
+ ''').create();
+
+ var test = await runTest(['--plain-name', 'selected', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains('+2: All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ test("doesn't support RegExp syntax", () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("test 1", () => throw TestFailure("oh no"));
+ test("test 2", () => throw TestFailure("oh no"));
+ test("test [12]", () {});
+ }
+ ''').create();
+
+ var test = await runTest(['--plain-name', 'test [12]', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ test('selects more narrowly when passed multiple times', () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("selected 1", () {});
+ test("nope", () => throw TestFailure("oh no"));
+ test("selected 2", () {});
+ }
+ ''').create();
+
+ var test = await runTest(
+ ['--plain-name', 'selected', '--plain-name', '1', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ test('produces an error when no tests match', () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("test", () {});
+ }
+ ''').create();
+
+ var test = await runTest(['--plain-name', 'no match', 'test.dart']);
+ expect(test.stderr, emitsThrough(contains('No tests match "no match".')));
+ await test.shouldExit(exit_codes.noTestsRan);
+ });
+ });
+
+ test('--name and --plain-name together narrow the selection', () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("selected 1", () {});
+ test("nope", () => throw TestFailure("oh no"));
+ test("selected 2", () {});
+ }
+ ''').create();
+
+ var test =
+ await runTest(['--name', '.....', '--plain-name', 'e', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains('+2: All tests passed!')));
+ await test.shouldExit(0);
+ });
+}
diff --git a/pkgs/test/test/runner/node/runner_test.dart b/pkgs/test/test/runner/node/runner_test.dart
new file mode 100644
index 0000000..82d2321
--- /dev/null
+++ b/pkgs/test/test/runner/node/runner_test.dart
@@ -0,0 +1,469 @@
+// Copyright (c) 2017, 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.
+
+@TestOn('vm')
+@Tags(['node'])
+library;
+
+import 'dart:convert';
+import 'dart:io';
+
+import 'package:test/src/runner/executable_settings.dart';
+import 'package:test/test.dart';
+import 'package:test_core/src/util/io.dart';
+import 'package:test_descriptor/test_descriptor.dart' as d;
+
+import '../../io.dart';
+
+final _success = '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("success", () {});
+ }
+''';
+
+final _failure = '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("failure", () => throw TestFailure("oh no"));
+ }
+''';
+
+({int major, String full})? _nodeVersion;
+
+({int major, String full}) _readNodeVersion() {
+ final process = Process.runSync(
+ ExecutableSettings(
+ linuxExecutable: 'node',
+ macOSExecutable: 'node',
+ windowsExecutable: 'node.exe',
+ ).executable,
+ ['--version'],
+ stdoutEncoding: utf8,
+ );
+ if (process.exitCode != 0) {
+ throw const OSError('Could not run node --version');
+ }
+
+ final version = RegExp(r'v(\d+)\..*');
+ final parsed = version.firstMatch(process.stdout as String)!;
+ return (major: int.parse(parsed.group(1)!), full: process.stdout);
+}
+
+String? skipBelowMajorNodeVersion(int minimumMajorVersion) {
+ final (:major, :full) = _nodeVersion ??= _readNodeVersion();
+ if (major < minimumMajorVersion) {
+ return 'This test requires Node $minimumMajorVersion.x or later, '
+ 'but is running on $full';
+ }
+
+ return null;
+}
+
+String? skipAboveMajorNodeVersion(int maximumMajorVersion) {
+ final (:major, :full) = _nodeVersion ??= _readNodeVersion();
+ if (major > maximumMajorVersion) {
+ return 'This test requires Node $maximumMajorVersion.x or older, '
+ 'but is running on $full';
+ }
+
+ return null;
+}
+
+void main() {
+ setUpAll(precompileTestExecutable);
+
+ group('fails gracefully if', () {
+ test('a test file fails to compile', () async {
+ await d.file('test.dart', 'invalid Dart file').create();
+ var test = await runTest(['-p', 'node', 'test.dart']);
+
+ expect(
+ test.stdout,
+ containsInOrder([
+ 'Error: Compilation failed.',
+ '-1: loading test.dart [E]',
+ 'Failed to load "test.dart": dart2js failed.'
+ ]));
+ await test.shouldExit(1);
+ });
+
+ test('a test file throws', () async {
+ await d.file('test.dart', "void main() => throw 'oh no';").create();
+
+ var test = await runTest(['-p', 'node', 'test.dart']);
+ expect(
+ test.stdout,
+ containsInOrder([
+ '-1: loading test.dart [E]',
+ 'Failed to load "test.dart": oh no'
+ ]));
+ await test.shouldExit(1);
+ });
+
+ test("a test file doesn't have a main defined", () async {
+ await d.file('test.dart', 'void foo() {}').create();
+
+ var test = await runTest(['-p', 'node', 'test.dart']);
+ expect(
+ test.stdout,
+ containsInOrder([
+ '-1: loading test.dart [E]',
+ 'Failed to load "test.dart": No top-level main() function defined.'
+ ]));
+ await test.shouldExit(1);
+ }, skip: 'https://github.com/dart-lang/test/issues/894');
+
+ test('a test file has a non-function main', () async {
+ await d.file('test.dart', 'int main;').create();
+
+ var test = await runTest(['-p', 'node', 'test.dart']);
+ expect(
+ test.stdout,
+ containsInOrder([
+ '-1: loading test.dart [E]',
+ 'Failed to load "test.dart": Top-level main getter is not a function.'
+ ]));
+ await test.shouldExit(1);
+ }, skip: 'https://github.com/dart-lang/test/issues/894');
+
+ test('a test file has a main with arguments', () async {
+ await d.file('test.dart', 'void main(arg) {}').create();
+
+ var test = await runTest(['-p', 'node', 'test.dart']);
+ expect(
+ test.stdout,
+ containsInOrder([
+ '-1: loading test.dart [E]',
+ 'Failed to load "test.dart": Top-level main() function takes arguments.'
+ ]));
+ await test.shouldExit(1);
+ });
+ });
+
+ group('runs successful tests', () {
+ test('on Node and the VM', () async {
+ await d.file('test.dart', _success).create();
+ var test = await runTest(['-p', 'node', '-p', 'vm', 'test.dart']);
+
+ expect(test.stdout, emitsThrough(contains('+2: All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ // Regression test; this broke in 0.12.0-beta.9.
+ test('on a file in a subdirectory', () async {
+ await d.dir('dir', [d.file('test.dart', _success)]).create();
+
+ var test = await runTest(['-p', 'node', 'dir/test.dart']);
+ expect(test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ test('compiled with dart2wasm', () async {
+ await d.file('test.dart', _success).create();
+ var test =
+ await runTest(['-p', 'node', '--compiler', 'dart2wasm', 'test.dart']);
+
+ expect(test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ }, skip: skipBelowMajorNodeVersion(22));
+ });
+
+ test('defines a node environment constant', () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("test", () {
+ expect(const bool.fromEnvironment("node"), isTrue);
+ });
+ }
+ ''').create();
+
+ var test = await runTest(['-p', 'node', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ test('runs failing tests that fail only on node', () async {
+ await d.file('test.dart', '''
+ import 'package:path/path.dart' as p;
+ import 'package:test/test.dart';
+
+ void main() {
+ test("test", () {
+ if (const bool.fromEnvironment("node")) {
+ throw TestFailure("oh no");
+ }
+ });
+ }
+ ''').create();
+
+ var test =
+ await runTest(['-p', 'node', '-p', 'vm', '-c', 'dart2js', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains('+1 -1: Some tests failed.')));
+ await test.shouldExit(1);
+ });
+
+ test('runs failing tests that fail only on node (with dart2wasm)', () async {
+ await d.file('test.dart', '''
+ import 'package:path/path.dart' as p;
+ import 'package:test/test.dart';
+
+ void main() {
+ test("test", () {
+ if (const bool.fromEnvironment("node")) {
+ throw TestFailure("oh no");
+ }
+ });
+ }
+ ''').create();
+
+ var test = await runTest([
+ '-p',
+ 'node',
+ '-p',
+ 'vm',
+ '-c',
+ 'dart2js',
+ '-c',
+ 'dart2wasm',
+ 'test.dart'
+ ]);
+ expect(test.stdout, emitsThrough(contains('+1 -2: Some tests failed.')));
+ await test.shouldExit(1);
+ }, skip: skipBelowMajorNodeVersion(22));
+
+ test(
+ 'gracefully handles wasm errors on old node versions',
+ () async {
+ // Old Node.JS versions can't read the WebAssembly modules emitted by
+ // dart2wasm. The node process exits before connecting to the server
+ // opened by the test runner, leading to timeouts. So, this is a
+ // regression test for https://github.com/dart-lang/test/pull/2259#issuecomment-2307868442
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("test", () {
+ // Should pass on newer node versions
+ });
+ }
+ ''').create();
+
+ var test = await runTest(['-p', 'node', '-c', 'dart2wasm', 'test.dart']);
+ expect(
+ test.stdout,
+ emitsInOrder([
+ emitsThrough(
+ contains('Node exited before connecting to the test channel.')),
+ emitsThrough(contains('-1: Some tests failed.')),
+ ]),
+ );
+ await test.shouldExit(1);
+ },
+ skip: skipAboveMajorNodeVersion(21),
+ );
+
+ test('forwards prints from the Node test', () async {
+ await d.file('test.dart', '''
+ import 'dart:async';
+
+ import 'package:test/test.dart';
+
+ void main() {
+ test("test", () {
+ print("Hello,");
+ return Future(() => print("world!"));
+ });
+ }
+ ''').create();
+
+ var test = await runTest(['-p', 'node', 'test.dart']);
+ expect(test.stdout, emitsInOrder([emitsThrough('Hello,'), 'world!']));
+ await test.shouldExit(0);
+ });
+
+ test('forwards raw JS prints from the Node test', () async {
+ await d.file('test.dart', '''
+ import 'dart:async';
+
+ import 'package:js/js.dart';
+ import 'package:test/test.dart';
+
+ @JS("console.log")
+ external void log(value);
+
+ void main() {
+ test("test", () {
+ log("Hello,");
+ return Future(() => log("world!"));
+ });
+ }
+ ''').create();
+
+ var test = await runTest(['-p', 'node', 'test.dart']);
+ expect(test.stdout, emitsInOrder([emitsThrough('Hello,'), 'world!']));
+ await test.shouldExit(0);
+ });
+
+ test('dartifies stack traces for JS-compiled tests by default', () async {
+ await d.file('test.dart', _failure).create();
+
+ var test = await runTest(['-p', 'node', '--verbose-trace', 'test.dart']);
+ expect(test.stdout,
+ containsInOrder([' main.<fn>', 'package:test', 'dart:async/zone.dart']),
+ skip: 'https://github.com/dart-lang/sdk/issues/41949');
+ await test.shouldExit(1);
+ });
+
+ test("doesn't dartify stack traces for JS-compiled tests with --js-trace",
+ () async {
+ await d.file('test.dart', _failure).create();
+
+ var test = await runTest(
+ ['-p', 'node', '--verbose-trace', '--js-trace', 'test.dart']);
+ expect(test.stdoutStream(), neverEmits(endsWith(' main.<fn>')));
+ expect(test.stdoutStream(), neverEmits(contains('package:test')));
+ expect(test.stdoutStream(), neverEmits(contains('dart:async/zone.dart')));
+ expect(test.stdout, emitsThrough(contains('-1: Some tests failed.')));
+ await test.shouldExit(1);
+ });
+
+ test('supports node_modules in the package directory', () async {
+ await d.dir('node_modules', [
+ d.dir('my_module', [d.file('index.js', 'module.exports.value = 12;')])
+ ]).create();
+
+ await d.file('test.dart', '''
+ import 'package:js/js.dart';
+ import 'package:test/test.dart';
+
+ @JS()
+ external MyModule require(String name);
+
+ @JS()
+ class MyModule {
+ external int get value;
+ }
+
+ void main() {
+ test("can load from a module", () {
+ expect(require("my_module").value, equals(12));
+ });
+ }
+ ''').create();
+
+ var test = await runTest(['-p', 'node', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ group('with onPlatform', () {
+ test('respects matching Skips', () async {
+ await d.file('test.dart', '''
+ import 'dart:async';
+
+ import 'package:test/test.dart';
+
+ void main() {
+ test("fail", () => throw 'oh no', onPlatform: {"node": Skip()});
+ }
+ ''').create();
+
+ var test = await runTest(['-p', 'node', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains('+0 ~1: All tests skipped.')));
+ await test.shouldExit(0);
+ });
+
+ test('ignores non-matching Skips', () async {
+ await d.file('test.dart', '''
+ import 'dart:async';
+
+ import 'package:test/test.dart';
+
+ void main() {
+ test("success", () {}, onPlatform: {"browser": Skip()});
+ }
+ ''').create();
+
+ var test = await runTest(['-p', 'node', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ test('matches the current OS', () async {
+ await d.file('test.dart', '''
+ import 'dart:async';
+
+ import 'package:test/test.dart';
+
+ void main() {
+ test("fail", () => throw 'oh no',
+ onPlatform: {"${currentOS.identifier}": Skip()});
+ }
+ ''').create();
+
+ var test = await runTest(['-p', 'node', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains('+0 ~1: All tests skipped.')));
+ await test.shouldExit(0);
+ });
+
+ test("doesn't match a different OS", () async {
+ await d.file('test.dart', '''
+ import 'dart:async';
+
+ import 'package:test/test.dart';
+
+ void main() {
+ test("success", () {}, onPlatform: {"$otherOS": Skip()});
+ }
+ ''').create();
+
+ var test = await runTest(['-p', 'node', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ });
+ });
+
+ group('with an @OnPlatform annotation', () {
+ test('respects matching Skips', () async {
+ await d.file('test.dart', '''
+ @OnPlatform(const {"js": const Skip()})
+
+ import 'dart:async';
+
+ import 'package:test/test.dart';
+
+ void main() {
+ test("fail", () => throw 'oh no');
+ }
+ ''').create();
+
+ var test = await runTest(['-p', 'node', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains('~1: All tests skipped.')));
+ await test.shouldExit(0);
+ });
+
+ test('ignores non-matching Skips', () async {
+ await d.file('test.dart', '''
+ @OnPlatform(const {"vm": const Skip()})
+
+ import 'dart:async';
+
+ import 'package:test/test.dart';
+
+ void main() {
+ test("success", () {});
+ }
+ ''').create();
+
+ var test = await runTest(['-p', 'node', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ });
+ });
+}
diff --git a/pkgs/test/test/runner/parse_metadata_test.dart b/pkgs/test/test/runner/parse_metadata_test.dart
new file mode 100644
index 0000000..a8ffa9c
--- /dev/null
+++ b/pkgs/test/test/runner/parse_metadata_test.dart
@@ -0,0 +1,326 @@
+// Copyright (c) 2015, 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.
+
+@TestOn('vm')
+library;
+
+import 'package:test/test.dart';
+import 'package:test_api/src/backend/platform_selector.dart';
+import 'package:test_api/src/backend/runtime.dart';
+import 'package:test_api/src/backend/suite_platform.dart';
+import 'package:test_core/src/runner/parse_metadata.dart';
+
+final _path = 'test.dart';
+
+void main() {
+ test('returns empty metadata for an empty file', () {
+ var metadata = parseMetadata(_path, '', {});
+ expect(metadata.testOn, equals(PlatformSelector.all));
+ expect(metadata.timeout.scaleFactor, equals(1));
+ });
+
+ test('ignores irrelevant annotations', () {
+ var metadata =
+ parseMetadata(_path, '@Fblthp\n@Fblthp.foo\nlibrary foo;', {});
+ expect(metadata.testOn, equals(PlatformSelector.all));
+ });
+
+ test('parses a prefixed annotation', () {
+ var metadata = parseMetadata(
+ _path,
+ "@foo.TestOn('vm')\n"
+ "import 'package:test/test.dart' as foo;",
+ {});
+ expect(metadata.testOn.evaluate(SuitePlatform(Runtime.vm, compiler: null)),
+ isTrue);
+ expect(
+ metadata.testOn.evaluate(SuitePlatform(Runtime.chrome, compiler: null)),
+ isFalse);
+ });
+
+ group('@TestOn:', () {
+ test('parses a valid annotation', () {
+ var metadata = parseMetadata(_path, "@TestOn('vm')\nlibrary foo;", {});
+ expect(
+ metadata.testOn.evaluate(SuitePlatform(Runtime.vm, compiler: null)),
+ isTrue);
+ expect(
+ metadata.testOn
+ .evaluate(SuitePlatform(Runtime.chrome, compiler: null)),
+ isFalse);
+ });
+
+ test('ignores a constructor named TestOn', () {
+ var metadata =
+ parseMetadata(_path, "@foo.TestOn('foo')\nlibrary foo;", {});
+ expect(metadata.testOn, equals(PlatformSelector.all));
+ });
+
+ group('throws an error for', () {
+ test('multiple @TestOns', () {
+ expect(
+ () => parseMetadata(
+ _path, "@TestOn('foo')\n@TestOn('bar')\nlibrary foo;", {}),
+ throwsFormatException);
+ });
+ });
+ });
+
+ group('@Timeout:', () {
+ test('parses a valid duration annotation', () {
+ var metadata = parseMetadata(_path, '''
+@Timeout(const Duration(
+ hours: 1,
+ minutes: 2,
+ seconds: 3,
+ milliseconds: 4,
+ microseconds: 5))
+
+library foo;
+''', {});
+ expect(
+ metadata.timeout.duration,
+ equals(const Duration(
+ hours: 1,
+ minutes: 2,
+ seconds: 3,
+ milliseconds: 4,
+ microseconds: 5)));
+ });
+
+ test('parses a valid duration omitting const', () {
+ var metadata = parseMetadata(_path, '''
+@Timeout(Duration(
+ hours: 1,
+ minutes: 2,
+ seconds: 3,
+ milliseconds: 4,
+ microseconds: 5))
+
+library foo;
+''', {});
+ expect(
+ metadata.timeout.duration,
+ equals(const Duration(
+ hours: 1,
+ minutes: 2,
+ seconds: 3,
+ milliseconds: 4,
+ microseconds: 5)));
+ });
+
+ test('parses a valid duration with an import prefix', () {
+ var metadata = parseMetadata(_path, '''
+@Timeout(core.Duration(
+ hours: 1,
+ minutes: 2,
+ seconds: 3,
+ milliseconds: 4,
+ microseconds: 5))
+import 'dart:core' as core;
+''', {});
+ expect(
+ metadata.timeout.duration,
+ equals(const Duration(
+ hours: 1,
+ minutes: 2,
+ seconds: 3,
+ milliseconds: 4,
+ microseconds: 5)));
+ });
+
+ test('parses a valid int factor annotation', () {
+ var metadata = parseMetadata(_path, '''
+@Timeout.factor(1)
+
+library foo;
+''', {});
+ expect(metadata.timeout.scaleFactor, equals(1));
+ });
+
+ test('parses a valid int factor annotation with an import prefix', () {
+ var metadata = parseMetadata(_path, '''
+@test.Timeout.factor(1)
+import 'package:test/test.dart' as test;
+''', {});
+ expect(metadata.timeout.scaleFactor, equals(1));
+ });
+
+ test('parses a valid double factor annotation', () {
+ var metadata = parseMetadata(_path, '''
+@Timeout.factor(0.5)
+
+library foo;
+''', {});
+ expect(metadata.timeout.scaleFactor, equals(0.5));
+ });
+
+ test('parses a valid Timeout.none annotation', () {
+ var metadata = parseMetadata(_path, '''
+@Timeout.none
+
+library foo;
+''', {});
+ expect(metadata.timeout, same(Timeout.none));
+ });
+
+ test('ignores a constructor named Timeout', () {
+ var metadata =
+ parseMetadata(_path, "@foo.Timeout('foo')\nlibrary foo;", {});
+ expect(metadata.timeout.scaleFactor, equals(1));
+ });
+
+ group('throws an error for', () {
+ test('multiple @Timeouts', () {
+ expect(
+ () => parseMetadata(_path,
+ '@Timeout.factor(1)\n@Timeout.factor(2)\nlibrary foo;', {}),
+ throwsFormatException);
+ });
+ });
+ });
+
+ group('@Skip:', () {
+ test('parses a valid annotation', () {
+ var metadata = parseMetadata(_path, '@Skip()\nlibrary foo;', {});
+ expect(metadata.skip, isTrue);
+ expect(metadata.skipReason, isNull);
+ });
+
+ test('parses a valid annotation with a reason', () {
+ var metadata = parseMetadata(_path, "@Skip('reason')\nlibrary foo;", {});
+ expect(metadata.skip, isTrue);
+ expect(metadata.skipReason, equals('reason'));
+ });
+
+ test('ignores a constructor named Skip', () {
+ var metadata = parseMetadata(_path, "@foo.Skip('foo')\nlibrary foo;", {});
+ expect(metadata.skip, isFalse);
+ });
+
+ group('throws an error for', () {
+ test('multiple @Skips', () {
+ expect(
+ () => parseMetadata(
+ _path, "@Skip('foo')\n@Skip('bar')\nlibrary foo;", {}),
+ throwsFormatException);
+ });
+ });
+ });
+
+ group('@Tags:', () {
+ test('parses a valid annotation', () {
+ var metadata = parseMetadata(_path, "@Tags(['a'])\nlibrary foo;", {});
+ expect(metadata.tags, equals(['a']));
+ });
+
+ test('ignores a constructor named Tags', () {
+ var metadata = parseMetadata(_path, "@foo.Tags(['a'])\nlibrary foo;", {});
+ expect(metadata.tags, isEmpty);
+ });
+
+ group('throws an error for', () {
+ test('multiple @Tags', () {
+ expect(
+ () => parseMetadata(
+ _path, "@Tags(['a'])\n@Tags(['b'])\nlibrary foo;", {}),
+ throwsFormatException);
+ });
+
+ test('String interpolation', () {
+ expect(
+ () => parseMetadata(
+ _path, "@Tags(['\$a'])\nlibrary foo;\nconst a = 'a';", {}),
+ throwsFormatException);
+ });
+ });
+ });
+
+ group('@OnPlatform:', () {
+ test('parses a valid annotation', () {
+ var metadata = parseMetadata(_path, '''
+@OnPlatform({
+ 'chrome': Timeout.factor(2),
+ 'vm': [Skip(), Timeout.factor(3)]
+})
+library foo;''', {});
+
+ var key = metadata.onPlatform.keys.first;
+ expect(
+ key.evaluate(SuitePlatform(Runtime.chrome, compiler: null)), isTrue);
+ expect(key.evaluate(SuitePlatform(Runtime.vm, compiler: null)), isFalse);
+ var value = metadata.onPlatform.values.first;
+ expect(value.timeout.scaleFactor, equals(2));
+
+ key = metadata.onPlatform.keys.last;
+ expect(key.evaluate(SuitePlatform(Runtime.vm, compiler: null)), isTrue);
+ expect(
+ key.evaluate(SuitePlatform(Runtime.chrome, compiler: null)), isFalse);
+ value = metadata.onPlatform.values.last;
+ expect(value.skip, isTrue);
+ expect(value.timeout.scaleFactor, equals(3));
+ });
+
+ test('parses a valid annotation with an import prefix', () {
+ var metadata = parseMetadata(_path, '''
+@test.OnPlatform({
+ 'chrome': test.Timeout.factor(2),
+ 'vm': [test.Skip(), test.Timeout.factor(3)]
+})
+import 'package:test/test.dart' as test;
+''', {});
+
+ var key = metadata.onPlatform.keys.first;
+ expect(
+ key.evaluate(SuitePlatform(Runtime.chrome, compiler: null)), isTrue);
+ expect(key.evaluate(SuitePlatform(Runtime.vm, compiler: null)), isFalse);
+ var value = metadata.onPlatform.values.first;
+ expect(value.timeout.scaleFactor, equals(2));
+
+ key = metadata.onPlatform.keys.last;
+ expect(key.evaluate(SuitePlatform(Runtime.vm, compiler: null)), isTrue);
+ expect(
+ key.evaluate(SuitePlatform(Runtime.chrome, compiler: null)), isFalse);
+ value = metadata.onPlatform.values.last;
+ expect(value.skip, isTrue);
+ expect(value.timeout.scaleFactor, equals(3));
+ });
+
+ test('ignores a constructor named OnPlatform', () {
+ var metadata =
+ parseMetadata(_path, "@foo.OnPlatform('foo')\nlibrary foo;", {});
+ expect(metadata.testOn, equals(PlatformSelector.all));
+ });
+
+ group('throws an error for', () {
+ test('a map with a unparseable key', () {
+ expect(
+ () => parseMetadata(
+ _path, "@OnPlatform({'invalid': Skip()})\nlibrary foo;", {}),
+ throwsFormatException);
+ });
+
+ test('a map with an invalid value', () {
+ expect(
+ () => parseMetadata(_path,
+ "@OnPlatform({'vm': const TestOn('vm')})\nlibrary foo;", {}),
+ throwsFormatException);
+ });
+
+ test('a map with an invalid value in a list', () {
+ expect(
+ () => parseMetadata(_path,
+ "@OnPlatform({'vm': [const TestOn('vm')]})\nlibrary foo;", {}),
+ throwsFormatException);
+ });
+
+ test('multiple @OnPlatforms', () {
+ expect(
+ () => parseMetadata(
+ _path, '@OnPlatform({})\n@OnPlatform({})\nlibrary foo;', {}),
+ throwsFormatException);
+ });
+ });
+ });
+}
diff --git a/pkgs/test/test/runner/pause_after_load_test.dart b/pkgs/test/test/runner/pause_after_load_test.dart
new file mode 100644
index 0000000..faba441
--- /dev/null
+++ b/pkgs/test/test/runner/pause_after_load_test.dart
@@ -0,0 +1,283 @@
+// Copyright (c) 2015, 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.
+
+@TestOn('vm')
+@OnPlatform({'windows': Skip('https://github.com/dart-lang/test/issues/1613')})
+library;
+
+import 'dart:async';
+import 'dart:io';
+
+import 'package:test/test.dart';
+import 'package:test_descriptor/test_descriptor.dart' as d;
+
+import '../io.dart';
+
+void main() {
+ setUpAll(precompileTestExecutable);
+
+ test('pauses the test runner for each file until the user presses enter',
+ () async {
+ await d.file('test1.dart', '''
+import 'package:test/test.dart';
+
+void main() {
+ print('loaded test 1!');
+
+ test("success", () {});
+}
+''').create();
+
+ await d.file('test2.dart', '''
+import 'package:test/test.dart';
+
+void main() {
+
+ print('loaded test 2!');
+ test("success", () {});
+}
+''').create();
+
+ var test = await runTest(
+ ['--pause-after-load', '-p', 'chrome', 'test1.dart', 'test2.dart']);
+ await expectLater(test.stdout, emitsThrough('loaded test 1!'));
+ await expectLater(test.stdout, emitsThrough(equalsIgnoringWhitespace('''
+ The test runner is paused. Open the dev console in Chrome and set
+ breakpoints. Once you're finished, return to this terminal and press
+ Enter.
+ ''')));
+
+ var nextLineFired = false;
+ unawaited(test.stdout.next.then(expectAsync1((line) {
+ expect(line, contains('+0: test1.dart: success'));
+ nextLineFired = true;
+ })));
+
+ // Wait a little bit to be sure that the tests don't start running without
+ // our input.
+ await Future<void>.delayed(const Duration(seconds: 2));
+ expect(nextLineFired, isFalse);
+
+ test.stdin.writeln();
+
+ await expectLater(test.stdout, emitsThrough('loaded test 2!'));
+ await expectLater(test.stdout, emitsThrough(equalsIgnoringWhitespace('''
+ The test runner is paused. Open the dev console in Chrome and set
+ breakpoints. Once you're finished, return to this terminal and press
+ Enter.
+ ''')));
+
+ nextLineFired = false;
+ unawaited(test.stdout.next.then(expectAsync1((line) {
+ expect(line, contains('+1: test2.dart: success'));
+ nextLineFired = true;
+ })));
+
+ // Wait a little bit to be sure that the tests don't start running without
+ // our input.
+ await Future<void>.delayed(const Duration(seconds: 2));
+ expect(nextLineFired, isFalse);
+
+ test.stdin.writeln();
+ await expectLater(
+ test.stdout, emitsThrough(contains('+2: All tests passed!')));
+ await test.shouldExit(0);
+ }, tags: 'chrome');
+
+ test('pauses the test runner for each platform until the user presses enter',
+ () async {
+ await d.file('test.dart', '''
+import 'package:test/test.dart';
+
+void main() {
+ print('loaded test!');
+
+ test("success", () {});
+}
+''').create();
+
+ var test = await runTest([
+ '--pause-after-load',
+ '-p',
+ 'firefox',
+ '-p',
+ 'chrome',
+ '-p',
+ 'vm',
+ 'test.dart'
+ ]);
+ await expectLater(test.stdout, emitsThrough('loaded test!'));
+ await expectLater(test.stdout, emitsThrough(equalsIgnoringWhitespace('''
+ The test runner is paused. Open the dev console in Firefox and set
+ breakpoints. Once you're finished, return to this terminal and press
+ Enter.
+ ''')));
+
+ var nextLineFired = false;
+ unawaited(test.stdout.next.then(expectAsync1((line) {
+ expect(line, contains('+0: [Firefox, Dart2Js] success'));
+ nextLineFired = true;
+ })));
+
+ // Wait a little bit to be sure that the tests don't start running without
+ // our input.
+ await Future<void>.delayed(const Duration(seconds: 2));
+ expect(nextLineFired, isFalse);
+
+ test.stdin.writeln();
+
+ await expectLater(test.stdout, emitsThrough('loaded test!'));
+ await expectLater(
+ test.stdout,
+ emitsThrough(emitsInOrder([
+ 'The test runner is paused. Open the dev console in Chrome and set '
+ "breakpoints. Once you're finished, return to this terminal and "
+ 'press Enter.'
+ ])));
+
+ nextLineFired = false;
+ unawaited(test.stdout.next.then(expectAsync1((line) {
+ expect(line, contains('+1: [Chrome, Dart2Js] success'));
+ nextLineFired = true;
+ })));
+
+ // Wait a little bit to be sure that the tests don't start running without
+ // our input.
+ await Future<void>.delayed(const Duration(seconds: 2));
+ expect(nextLineFired, isFalse);
+
+ test.stdin.writeln();
+ await expectLater(test.stdout, emitsThrough('loaded test!'));
+ await expectLater(
+ test.stdout,
+ emitsThrough(emitsInOrder([
+ 'The test runner is paused. Open the Observatory and set '
+ "breakpoints. Once you're finished, return to this terminal "
+ 'and press Enter.'
+ ])));
+
+ nextLineFired = false;
+ unawaited(test.stdout.next.then(expectAsync1((line) {
+ expect(line, contains('+2: [VM, Kernel] success'));
+ nextLineFired = true;
+ })));
+
+ // Wait a little bit to be sure that the tests don't start running without
+ // our input.
+ await Future<void>.delayed(const Duration(seconds: 2));
+ expect(nextLineFired, isFalse);
+
+ test.stdin.writeln();
+
+ await expectLater(
+ test.stdout, emitsThrough(contains('+3: All tests passed!')));
+ await test.shouldExit(0);
+ }, tags: ['firefox', 'chrome', 'vm']);
+
+ test('stops immediately if killed while paused', () async {
+ await d.file('test.dart', '''
+import 'package:test/test.dart';
+
+void main() {
+ print('loaded test!');
+
+ test("success", () {});
+}
+''').create();
+
+ var test =
+ await runTest(['--pause-after-load', '-p', 'chrome', 'test.dart']);
+ await expectLater(test.stdout, emitsThrough('loaded test!'));
+ await expectLater(test.stdout, emitsThrough(equalsIgnoringWhitespace('''
+ The test runner is paused. Open the dev console in Chrome and set
+ breakpoints. Once you're finished, return to this terminal and press
+ Enter.
+ ''')));
+
+ test.signal(ProcessSignal.sigterm);
+ await test.shouldExit();
+ await expectLater(test.stderr, emitsDone);
+ }, tags: 'chrome', testOn: '!windows');
+
+ test('disables timeouts', () async {
+ await d.file('test.dart', '''
+import 'dart:async';
+
+import 'package:test/test.dart';
+
+void main() {
+ print('loaded test 1!');
+
+ test("success", () async {
+ await Future.delayed(Duration.zero);
+ }, timeout: Timeout(Duration.zero));
+}
+''').create();
+
+ var test = await runTest(
+ ['--pause-after-load', '-p', 'chrome', '-n', 'success', 'test.dart']);
+ await expectLater(test.stdout, emitsThrough('loaded test 1!'));
+ await expectLater(test.stdout, emitsThrough(equalsIgnoringWhitespace('''
+ The test runner is paused. Open the dev console in Chrome and set
+ breakpoints. Once you're finished, return to this terminal and press
+ Enter.
+ ''')));
+
+ var nextLineFired = false;
+ unawaited(test.stdout.next.then(expectAsync1((line) {
+ expect(line, contains('+0: success'));
+ nextLineFired = true;
+ })));
+
+ // Wait a little bit to be sure that the tests don't start running without
+ // our input.
+ await Future<void>.delayed(const Duration(seconds: 2));
+ expect(nextLineFired, isFalse);
+
+ test.stdin.writeln();
+ await expectLater(
+ test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ }, tags: 'chrome');
+
+ // Regression test for #304.
+ test('supports test name patterns', () async {
+ await d.file('test.dart', '''
+import 'package:test/test.dart';
+
+void main() {
+ print('loaded test 1!');
+
+ test("failure 1", () {});
+ test("success", () {});
+ test("failure 2", () {});
+}
+''').create();
+
+ var test = await runTest(
+ ['--pause-after-load', '-p', 'chrome', '-n', 'success', 'test.dart']);
+ await expectLater(test.stdout, emitsThrough('loaded test 1!'));
+ await expectLater(test.stdout, emitsThrough(equalsIgnoringWhitespace('''
+ The test runner is paused. Open the dev console in Chrome and set
+ breakpoints. Once you're finished, return to this terminal and press
+ Enter.
+ ''')));
+
+ var nextLineFired = false;
+ unawaited(test.stdout.next.then(expectAsync1((line) {
+ expect(line, contains('+0: success'));
+ nextLineFired = true;
+ })));
+
+ // Wait a little bit to be sure that the tests don't start running without
+ // our input.
+ await Future<void>.delayed(const Duration(seconds: 2));
+ expect(nextLineFired, isFalse);
+
+ test.stdin.writeln();
+ await expectLater(
+ test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ }, tags: 'chrome');
+}
diff --git a/pkgs/test/test/runner/precompiled_test.dart b/pkgs/test/test/runner/precompiled_test.dart
new file mode 100644
index 0000000..51dde28
--- /dev/null
+++ b/pkgs/test/test/runner/precompiled_test.dart
@@ -0,0 +1,264 @@
+// Copyright (c) 2016, 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.
+
+@TestOn('vm')
+@OnPlatform({'windows': Skip('https://github.com/dart-lang/test/issues/1617')})
+library;
+
+import 'dart:async';
+import 'dart:io';
+import 'dart:isolate';
+
+import 'package:node_preamble/preamble.dart' as preamble;
+import 'package:package_config/package_config.dart';
+import 'package:path/path.dart' as p;
+import 'package:test/test.dart';
+import 'package:test_descriptor/test_descriptor.dart' as d;
+import 'package:test_process/test_process.dart';
+
+import '../io.dart';
+
+void main() {
+ setUpAll(precompileTestExecutable);
+
+ group('browser tests', () {
+ setUpAll(() async {
+ await _precompileBrowserTest('test.dart');
+ });
+
+ test('run a precompiled version of a test rather than recompiling',
+ () async {
+ var test = await runTest([
+ '-p',
+ 'chrome',
+ '--precompiled=precompiled/',
+ 'test.dart',
+ ]);
+ expect(test.stdout,
+ containsInOrder(['+0: success', '+1: All tests passed!']));
+ await test.shouldExit(0);
+ });
+
+ test('run two precompiled tests', () async {
+ await _precompileBrowserTest('test_2.dart');
+ var test = await runTest(concurrency: 2, [
+ '-p',
+ 'chrome',
+ '--precompiled=precompiled/',
+ 'test.dart',
+ 'test_2.dart',
+ ]);
+ expect(test.stdout, containsInOrder(['+2: All tests passed!']));
+ await test.shouldExit(0);
+ });
+
+ test('can use the json reporter', () async {
+ var test = await runTest([
+ '-p',
+ 'chrome',
+ '--precompiled=precompiled/',
+ 'test.dart',
+ '-r',
+ 'json'
+ ]);
+ expect(
+ test.stdout,
+ containsInOrder([
+ '{"testID":3,"result":"success"',
+ '{"success":true,"type":"done"'
+ ]));
+ await test.shouldExit(0);
+ });
+ }, tags: const ['chrome']);
+
+ group('node tests', () {
+ setUp(() async {
+ await d.dir('test', [
+ d.file('test.dart', '''
+ import "package:test/src/bootstrap/node.dart";
+ import "package:test/test.dart";
+
+ void main() {
+ internalBootstrapNodeTest(() => () => test("success", () {
+ expect(true, isTrue);
+ }));
+ }''')
+ ]).create();
+ await _writePackagesFile();
+
+ var jsPath = p.join(d.sandbox, 'test', 'test.dart.node_test.dart.js');
+ var dart2js = await TestProcess.start(
+ Platform.resolvedExecutable,
+ [
+ 'compile',
+ 'js',
+ '--packages=${await Isolate.packageConfig}',
+ p.join('test', 'test.dart'),
+ '--out=$jsPath',
+ ],
+ workingDirectory: d.sandbox);
+ await dart2js.shouldExit(0);
+
+ var jsFile = File(jsPath);
+ await jsFile.writeAsString(
+ preamble.getPreamble(minified: true) + await jsFile.readAsString());
+
+ await d.dir('test', [d.file('test.dart', 'invalid dart}')]).create();
+ });
+
+ test('run a precompiled version of a test rather than recompiling',
+ () async {
+ var test = await runTest([
+ '-p',
+ 'node',
+ '--precompiled',
+ d.sandbox,
+ p.join('test', 'test.dart')
+ ]);
+ expect(test.stdout,
+ containsInOrder(['+0: success', '+1: All tests passed!']));
+ await test.shouldExit(0);
+ });
+
+ test('can use the json reporter', () async {
+ var test = await runTest([
+ '-p',
+ 'node',
+ '--precompiled',
+ d.sandbox,
+ p.join('test', 'test.dart'),
+ '-r',
+ 'json'
+ ]);
+ expect(
+ test.stdout,
+ containsInOrder([
+ '{"testID":3,"result":"success"',
+ '{"success":true,"type":"done"'
+ ]));
+ await test.shouldExit(0);
+ });
+ }, tags: const ['node']);
+
+ group('vm tests', () {
+ setUp(() async {
+ await d.dir('test', [
+ d.file('test.dart', '''
+ import "package:test/test.dart";
+ void main() {
+ test("true is true", () {
+ expect(true, isTrue);
+ });
+ }
+ '''),
+ d.file('test.dart.vm_test.dart', '''
+ import "dart:isolate";
+ import "package:test_core/src/bootstrap/vm.dart";
+ import "test.dart" as test;
+ void main(_, SendPort message) {
+ internalBootstrapVmTest(() => test.main, message);
+ }
+ '''),
+ ]).create();
+ await _writePackagesFile();
+ });
+
+ test('run in the precompiled directory', () async {
+ var test = await runTest(
+ ['-p', 'vm', '--precompiled=${d.sandbox}', 'test/test.dart']);
+ expect(test.stdout,
+ containsInOrder(['+0: true is true', '+1: All tests passed!']));
+ await test.shouldExit(0);
+ });
+
+ test('can load precompiled dill files if available', () async {
+ // Create the snapshot in the sandbox directory.
+ var snapshotProcess = await runDart([
+ '--snapshot_kind=script',
+ '--snapshot=test/test.dart.vm_test.vm.app.dill',
+ 'test/test.dart.vm_test.dart'
+ ]);
+ await snapshotProcess.shouldExit(0);
+
+ // Modify the original test so it would fail if it actually got ran, this
+ // makes sure the test fails if the dill file isn't loaded.
+ var testFile = File(p.join(d.sandbox, 'test', 'test.dart'));
+ expect(await testFile.exists(), isTrue);
+ var originalContent = await testFile.readAsString();
+ await testFile
+ .writeAsString(originalContent.replaceAll('isTrue', 'isFalse'));
+
+ // Actually invoke the test with the dill file.
+ var testProcess = await runTest(
+ ['-p', 'vm', '--precompiled=${d.sandbox}', 'test/test.dart']);
+ expect(testProcess.stdout,
+ containsInOrder(['+0: true is true', '+1: All tests passed!']));
+ await testProcess.shouldExit(0);
+ });
+
+ test('can use the json reporter', () async {
+ var test = await runTest([
+ '-p',
+ 'vm',
+ '--precompiled=${d.sandbox}',
+ 'test/test.dart',
+ '-r',
+ 'json'
+ ]);
+ expect(
+ test.stdout,
+ containsInOrder([
+ '{"testID":3,"result":"success"',
+ '{"success":true,"type":"done"'
+ ]));
+ await test.shouldExit(0);
+ });
+ });
+}
+
+Future<void> _writePackagesFile() async {
+ var config = (await findPackageConfig(Directory.current))!;
+ await d.dir('.dart_tool').create();
+ await savePackageConfig(config, Directory(d.sandbox));
+}
+
+Future<void> _precompileBrowserTest(String testPath) async {
+ var tmpDir = await Directory.systemTemp.createTemp('browser_test');
+ var file = File.fromUri(tmpDir.uri.resolve('precompiled.dart'));
+ await file.writeAsString('''
+ import "package:test/bootstrap/browser.dart";
+ import "package:test/test.dart";
+
+ main(_) {
+ internalBootstrapBrowserTest(() => () => test("success", () {}));
+ }
+ ''');
+
+ await d.dir('precompiled', [
+ d.file(p.setExtension(testPath, 'html'), '''
+ <!DOCTYPE html>
+ <html>
+ <head>
+ <title>test Test</title>
+ <script src="$testPath.browser_test.dart.js"></script>
+ </head>
+ </html>
+ ''')
+ ]).create();
+
+ var dart2js = await TestProcess.start(
+ Platform.resolvedExecutable,
+ [
+ 'compile',
+ 'js',
+ ...Platform.executableArguments,
+ '--packages=${(await Isolate.packageConfig)!.toFilePath()}',
+ file.path,
+ '--out=precompiled/$testPath.browser_test.dart.js'
+ ],
+ workingDirectory: d.sandbox);
+ await dart2js.shouldExit(0);
+
+ await d.file(testPath, 'invalid dart}').create();
+}
diff --git a/pkgs/test/test/runner/retry_test.dart b/pkgs/test/test/runner/retry_test.dart
new file mode 100644
index 0000000..0e16fef
--- /dev/null
+++ b/pkgs/test/test/runner/retry_test.dart
@@ -0,0 +1,231 @@
+// Copyright (c) 2017, 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.
+
+@TestOn('vm')
+library;
+
+import 'package:test/test.dart';
+import 'package:test_descriptor/test_descriptor.dart' as d;
+
+import '../io.dart';
+
+void main() {
+ setUpAll(precompileTestExecutable);
+
+ test('respects --no-retry flag with retry option', () async {
+ await d.file('test.dart', '''
+ import 'dart:async';
+
+ import 'package:test/test.dart';
+
+ var attempt = 0;
+ void main() {
+ test("eventually passes", () {
+ attempt++;
+ if(attempt <= 1 ) {
+ throw TestFailure("oh no");
+ }
+ }, retry: 1);
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart', '--no-retry']);
+ expect(test.stdout, emitsThrough(contains('-1: Some tests failed.')));
+ await test.shouldExit(1);
+ });
+
+ test('respects --no-retry flag with @Retry declaration', () async {
+ await d.file('test.dart', '''
+ @Retry(3)
+
+ import 'dart:async';
+
+ import 'package:test/test.dart';
+
+ var attempt = 0;
+ void main() {
+ test("eventually passes", () {
+ attempt++;
+ if(attempt <= 1 ) {
+ throw TestFailure("oh no");
+ }
+ });
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart', '--no-retry']);
+ expect(test.stdout, emitsThrough(contains('-1: Some tests failed.')));
+ await test.shouldExit(1);
+ });
+
+ test('respects top-level @Retry declarations', () async {
+ await d.file('test.dart', '''
+ @Retry(3)
+
+ import 'dart:async';
+
+ import 'package:test/test.dart';
+
+ var attempt = 0;
+ void main() {
+ test("failure", () {
+ attempt++;
+ if(attempt <= 3) {
+ throw TestFailure("oh no");
+ }
+ });
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ test('respects group retry declarations', () async {
+ await d.file('test.dart', '''
+ import 'dart:async';
+
+ import 'package:test/test.dart';
+
+ var attempt = 0;
+ void main() {
+ group("retry", () {
+ test("failure", () {
+ attempt++;
+ if(attempt <= 3) {
+ throw TestFailure("oh no");
+ }
+ });
+ }, retry: 3);
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ test('tests are not retried after they have already been reported successful',
+ () async {
+ await d.file('test.dart', '''
+ import 'dart:async';
+
+ import 'package:test/test.dart';
+
+ void main() {
+ var completer1 = Completer();
+ var completer2 = Completer();
+ test("first", () {
+ completer1.future.then((_) {
+ completer2.complete();
+ throw "oh no";
+ });
+ }, retry: 2);
+
+ test("second", () async {
+ completer1.complete();
+ await completer2.future;
+ });
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(
+ test.stdout,
+ emitsThrough(
+ contains('This test failed after it had already completed')));
+ await test.shouldExit(1);
+ });
+
+ group('retries tests', () {
+ test('and eventually passes for valid tests', () async {
+ await d.file('test.dart', '''
+ import 'dart:async';
+
+ import 'package:test/test.dart';
+
+ var attempt = 0;
+ void main() {
+ test("eventually passes", () {
+ attempt++;
+ if(attempt <= 2) {
+ throw TestFailure("oh no");
+ }
+ }, retry: 2);
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ test('and ignores previous errors', () async {
+ await d.file('test.dart', '''
+ import 'dart:async';
+
+ import 'package:test/test.dart';
+
+ var attempt = 0;
+ Completer completer = Completer();
+ void main() {
+ test("failure", () async {
+ attempt++;
+ if (attempt == 1) {
+ completer.future.then((_) => throw 'some error');
+ throw TestFailure("oh no");
+ }
+ completer.complete(null);
+ await Future((){});
+ }, retry: 1);
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ test('and eventually fails for invalid tests', () async {
+ await d.file('test.dart', '''
+ import 'dart:async';
+
+ import 'package:test/test.dart';
+
+ void main() {
+ test("failure", () {
+ throw TestFailure("oh no");
+ }, retry: 2);
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stdout, emitsThrough(contains('-1: Some tests failed.')));
+ await test.shouldExit(1);
+ });
+
+ test('only after a failure', () async {
+ await d.file('test.dart', '''
+ import 'dart:async';
+
+ import 'package:test/test.dart';
+
+ var attempt = 0;
+ void main() {
+ test("eventually passes", () {
+ attempt++;
+ if (attempt != 2){
+ throw TestFailure("oh no");
+ }
+ }, retry: 5);
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ });
+ });
+}
diff --git a/pkgs/test/test/runner/runner_test.dart b/pkgs/test/test/runner/runner_test.dart
new file mode 100644
index 0000000..379e2a7
--- /dev/null
+++ b/pkgs/test/test/runner/runner_test.dart
@@ -0,0 +1,871 @@
+// Copyright (c) 2015, 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.
+
+@TestOn('vm')
+library;
+
+import 'dart:io';
+import 'dart:math' as math;
+
+import 'package:path/path.dart' as p;
+import 'package:test/test.dart';
+import 'package:test_core/src/util/exit_codes.dart' as exit_codes;
+import 'package:test_descriptor/test_descriptor.dart' as d;
+
+import '../io.dart';
+
+final _success = '''
+import 'dart:async';
+
+import 'package:test/test.dart';
+
+void main() {
+ test("success", () {});
+}
+''';
+
+final _failure = '''
+import 'dart:async';
+
+import 'package:test/test.dart';
+
+void main() {
+ test("failure", () => throw TestFailure("oh no"));
+}
+''';
+
+final _asyncFailure = '''
+import 'dart:async';
+
+import 'package:test/test.dart';
+
+void main() {
+ test("failure", () async {
+ await Future(() {}).then((_) {
+ throw 'oh no';
+ });
+ });
+}
+''';
+
+final _defaultConcurrency = math.max(1, Platform.numberOfProcessors ~/ 2);
+
+final _usage = '''
+Usage: dart test [files or directories...]
+
+-h, --help Show this usage information.
+ --version Show the package:test version.
+
+Selecting Tests:
+-n, --name A substring of the name of the test to run.
+ Regular expression syntax is supported.
+ If passed multiple times, tests must match all substrings.
+-N, --plain-name A plain-text substring of the name of the test to run.
+ If passed multiple times, tests must match all substrings.
+-t, --tags Run only tests with all of the specified tags.
+ Supports boolean selector syntax.
+-x, --exclude-tags Don't run tests with any of the specified tags.
+ Supports boolean selector syntax.
+ --[no-]run-skipped Run skipped tests instead of skipping them.
+
+Running Tests:
+-p, --platform The platform(s) on which to run the tests.
+ $_runtimes.
+ Each platform supports the following compilers:
+$_runtimeCompilers
+-c, --compiler The compiler(s) to use to run tests, supported compilers are [dart2js, dart2wasm, exe, kernel, source].
+ Each platform has a default compiler but may support other compilers.
+ You can target a compiler to a specific platform using arguments of the following form [<platform-selector>:]<compiler>.
+ If a platform is specified but no given compiler is supported for that platform, then it will use its default compiler.
+-P, --preset The configuration preset(s) to use.
+-j, --concurrency=<threads> The number of concurrent test suites run.
+ (defaults to "$_defaultConcurrency")
+ --total-shards The total number of invocations of the test runner being run.
+ --shard-index The index of this test runner invocation (of --total-shards).
+ --timeout The default test timeout. For example: 15s, 2x, none
+ (defaults to "30s")
+ --ignore-timeouts Ignore all timeouts (useful if debugging)
+ --pause-after-load Pause for debugging before any tests execute.
+ Implies --concurrency=1, --debug, and --ignore-timeouts.
+ Currently only supported for browser tests.
+ --debug Run the VM and Chrome tests in debug mode.
+ --coverage=<directory> Gather coverage and output it to the specified directory.
+ Implies --debug.
+ --[no-]chain-stack-traces Use chained stack traces to provide greater exception details
+ especially for asynchronous code. It may be useful to disable
+ to provide improved test performance but at the cost of
+ debuggability.
+ --no-retry Don't rerun tests that have retry set.
+ --test-randomize-ordering-seed Use the specified seed to randomize the execution order of test cases.
+ Must be a 32bit unsigned integer or "random".
+ If "random", pick a random seed to use.
+ If not passed, do not randomize test case execution order.
+ --[no-]fail-fast Stop running tests after the first failure.
+
+Output:
+-r, --reporter=<option> Set how to print test results.
+
+ [compact] A single line, updated continuously.
+ [expanded] (default) A separate line for each update.
+ [failures-only] A separate line for failing tests with no output for passing tests
+ [github] A custom reporter for GitHub Actions (the default reporter when running on GitHub Actions).
+ [json] A machine-readable format (see https://dart.dev/go/test-docs/json_reporter.md).
+ [silent] A reporter with no output. May be useful when only the exit code is meaningful.
+
+ --file-reporter Enable an additional reporter writing test results to a file.
+ Should be in the form <reporter>:<filepath>, Example: "json:reports/tests.json"
+ --verbose-trace Emit stack traces with core library frames.
+ --js-trace Emit raw JavaScript stack traces for browser tests.
+ --[no-]color Use terminal colors.
+ (auto-detected by default)
+''';
+
+final _runtimes = '[vm (default), chrome, firefox'
+ '${Platform.isMacOS ? ', safari' : ''}'
+ ', edge, node]';
+
+final _runtimeCompilers = [
+ '[vm]: kernel (default), source, exe',
+ '[chrome]: dart2js (default), dart2wasm',
+ '[firefox]: dart2js (default), dart2wasm',
+ if (Platform.isMacOS) '[safari]: dart2js (default)',
+ '[edge]: dart2js (default)',
+ '[node]: dart2js (default), dart2wasm',
+].map((str) => ' $str').join('\n');
+
+void main() {
+ setUpAll(precompileTestExecutable);
+
+ test('prints help information', () async {
+ var test = await runTest(['--help']);
+ expectStdoutEquals(test, '''
+Runs tests in this package.
+
+$_usage''');
+ await test.shouldExit(0);
+ });
+
+ group('fails gracefully if', () {
+ test('an invalid option is passed', () async {
+ var test = await runTest(['--asdf']);
+ expectStderrEquals(test, '''
+Could not find an option named "--asdf".
+
+$_usage''');
+ await test.shouldExit(exit_codes.usage);
+ });
+
+ test('a non-existent file is passed', () async {
+ var test = await runTest(['file']);
+ expect(
+ test.stdout,
+ containsInOrder([
+ '-1: loading file [E]',
+ 'Failed to load "file": Does not exist.'
+ ]));
+ await test.shouldExit(1);
+ });
+
+ test("the default directory doesn't exist", () async {
+ var test = await runTest([]);
+ expectStderrEquals(test, '''
+No test files were passed and the default "test/" directory doesn't exist.
+
+$_usage''');
+ await test.shouldExit(exit_codes.data);
+ });
+
+ test('a test file fails to load', () async {
+ await d.file('test.dart', 'invalid Dart file').create();
+ var test = await runTest(['test.dart']);
+
+ expect(
+ test.stdout,
+ containsInOrder([
+ 'Failed to load "test.dart":',
+ "test.dart:1:9: Error: Expected ';' after this.",
+ 'invalid Dart file'
+ ]));
+
+ await test.shouldExit(1);
+ });
+
+ // This syntax error is detected lazily, and so requires some extra
+ // machinery to support.
+ test('a test file fails to parse due to a missing semicolon', () async {
+ await d.file('test.dart', 'void main() {foo}').create();
+ var test = await runTest(['test.dart']);
+
+ expect(
+ test.stdout,
+ containsInOrder([
+ '-1: loading test.dart [E]',
+ 'Failed to load "test.dart":',
+ "test.dart:1:14: Error: Expected ';' after this"
+ ]));
+
+ await test.shouldExit(1);
+ });
+
+ // This is slightly different from the above test because it's an error
+ // that's caught first by the analyzer when it's used to parse the file.
+ test('a test file fails to parse', () async {
+ await d.file('test.dart', '@TestOn)').create();
+ var test = await runTest(['test.dart']);
+
+ expect(
+ test.stdout,
+ containsInOrder([
+ '-1: loading test.dart [E]',
+ 'Failed to load "test.dart":',
+ "test.dart:1:8: Error: Expected a declaration, but got ')'",
+ '@TestOn)',
+ ]));
+
+ await test.shouldExit(1);
+ });
+
+ test("an annotation's contents are invalid", () async {
+ await d.file('test.dart', "@TestOn('zim')\nlibrary foo;").create();
+ var test = await runTest(['test.dart']);
+
+ expect(
+ test.stdout,
+ containsInOrder([
+ '-1: loading test.dart [E]',
+ 'Failed to load "test.dart":',
+ 'Error on line 1, column 10: Undefined variable.',
+ "@TestOn('zim')",
+ ' ^^^'
+ ]));
+ await test.shouldExit(1);
+ });
+
+ test('a test file throws', () async {
+ await d.file('test.dart', "void main() => throw 'oh no';").create();
+ var test = await runTest(['test.dart']);
+
+ expect(
+ test.stdout,
+ containsInOrder([
+ '-1: loading test.dart [E]',
+ 'Failed to load "test.dart": oh no'
+ ]));
+ await test.shouldExit(1);
+ });
+
+ test("a test file doesn't have a main defined", () async {
+ await d.file('test.dart', 'void foo() {}').create();
+ var test = await runTest(['test.dart']);
+
+ expect(
+ test.stdout,
+ emitsThrough(
+ contains('-1: loading test.dart [E]'),
+ ));
+ expect(
+ test.stdout,
+ emitsThrough(anyOf([
+ contains("Error: Getter not found: 'main'"),
+ contains("Error: Undefined name 'main'"),
+ ])));
+
+ await test.shouldExit(1);
+ });
+
+ test('a test file has a non-function main', () async {
+ await d.file('test.dart', 'int main = 0;').create();
+ var test = await runTest(['test.dart']);
+
+ expect(test.stdout, emitsThrough(contains('-1: loading test.dart [E]')));
+ expect(
+ test.stdout,
+ emitsThrough(anyOf([
+ contains(
+ "A value of type 'int' can't be assigned to a variable of type "
+ "'Function'",
+ ),
+ contains(
+ "A value of type 'int' can't be returned from a function with "
+ "return type 'Function'",
+ ),
+ ])));
+
+ await test.shouldExit(1);
+ });
+
+ test('a test file has a main with arguments', () async {
+ await d.file('test.dart', 'void main(arg) {}').create();
+ var test = await runTest(['test.dart']);
+
+ expect(
+ test.stdout,
+ containsInOrder([
+ '-1: loading test.dart [E]',
+ 'Failed to load "test.dart": Top-level main() function takes arguments.'
+ ]));
+ await test.shouldExit(1);
+ });
+
+ test('multiple load errors occur', () async {
+ await d.file('test.dart', 'invalid Dart file').create();
+ var test = await runTest(['test.dart', 'nonexistent.dart']);
+
+ expect(
+ await test.stdoutStream().toList(),
+ containsAll([
+ contains('loading nonexistent.dart [E]'),
+ contains('Failed to load "nonexistent.dart": Does not exist'),
+ contains('loading test.dart [E]'),
+ contains('Failed to load "test.dart"'),
+ ]));
+
+ await test.shouldExit(1);
+ });
+
+ // TODO(nweiz): test what happens when a test file is unreadable once issue
+ // 15078 is fixed.
+ });
+
+ group('runs successful tests', () {
+ test('defined in a single file', () async {
+ await d.file('test.dart', _success).create();
+ var test = await runTest(['test.dart']);
+ expect(test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ test('defined in a directory', () async {
+ for (var i = 0; i < 3; i++) {
+ await d.file('${i}_test.dart', _success).create();
+ }
+
+ var test = await runTest(['.']);
+ expect(test.stdout, emitsThrough(contains('+3: All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ test('defaulting to the test directory', () async {
+ await d
+ .dir(
+ 'test',
+ Iterable.generate(3, (i) {
+ return d.file('${i}_test.dart', _success);
+ }))
+ .create();
+
+ var test = await runTest([]);
+ expect(test.stdout, emitsThrough(contains('+3: All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ test('directly', () async {
+ await d.file('test.dart', _success).create();
+ var test = await runDart(['test.dart']);
+
+ expect(test.stdout, emitsThrough(contains('All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ // Regression test; this broke in 0.12.0-beta.9.
+ test('on a file in a subdirectory', () async {
+ await d.dir('dir', [d.file('test.dart', _success)]).create();
+
+ var test = await runTest(['dir/test.dart']);
+ expect(test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ test('given a file: uri', () async {
+ await d.file('test.dart', _success).create();
+ var fileUri = p.toUri(d.path('test.dart')).toString();
+ expect(fileUri, startsWith('file:///'));
+ var test = await runTest([fileUri]);
+ expect(test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ test('with platform specific relative paths', () async {
+ await d.dir('foo', [d.file('test.dart', _success)]).create();
+ var test = await runTest([p.join('foo', 'test.dart')]);
+ expect(test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ test('with platform specific absolute paths', () async {
+ await d.dir('foo', [d.file('test.dart', _success)]).create();
+ var test = await runTest([d.path(p.join('foo', 'test.dart'))]);
+ expect(test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ test('with platform specific relative paths containing query params',
+ () async {
+ await d.dir('foo', [d.file('test.dart', _success)]).create();
+ var test = await runTest(['${p.join('foo', 'test.dart')}?line=6']);
+ expect(test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ });
+ });
+
+ group('runs successful tests with async setup', () {
+ setUp(() async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() async {
+ test("success 1", () {});
+
+ await () async {};
+
+ test("success 2", () {});
+ }
+ ''').create();
+ });
+
+ test('defined in a single file', () async {
+ var test = await runTest(['test.dart']);
+ expect(test.stdout, emitsThrough(contains('+2: All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ test('directly', () async {
+ var test = await runDart(['test.dart']);
+ expect(test.stdout, emitsThrough(contains('All tests passed!')));
+ await test.shouldExit(0);
+ });
+ });
+
+ group('runs failing tests', () {
+ test('respects the chain-stack-traces flag', () async {
+ await d.file('test.dart', _asyncFailure).create();
+
+ var test = await runTest(['test.dart', '--chain-stack-traces']);
+ expect(test.stdout, emitsThrough(contains('asynchronous gap')));
+ await test.shouldExit(1);
+ });
+
+ test('defaults to not chaining stack traces', () async {
+ await d.file('test.dart', _asyncFailure).create();
+
+ var test = await runTest(['test.dart']);
+ expect(
+ test.stdout,
+ containsInOrder([
+ '00:00 +0: failure',
+ '00:00 +0 -1: failure [E]',
+ 'oh no',
+ 'test.dart 8:7 main.<fn>.<fn>',
+ ]));
+ await test.shouldExit(1);
+ });
+
+ test('defined in a single file', () async {
+ await d.file('test.dart', _failure).create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stdout, emitsThrough(contains('-1: Some tests failed.')));
+ await test.shouldExit(1);
+ });
+
+ test('defined in a directory', () async {
+ for (var i = 0; i < 3; i++) {
+ await d.file('${i}_test.dart', _failure).create();
+ }
+
+ var test = await runTest(['.']);
+ expect(test.stdout, emitsThrough(contains('-3: Some tests failed.')));
+ await test.shouldExit(1);
+ });
+
+ test('defaulting to the test directory', () async {
+ await d
+ .dir(
+ 'test',
+ Iterable.generate(3, (i) {
+ return d.file('${i}_test.dart', _failure);
+ }))
+ .create();
+
+ var test = await runTest([]);
+ expect(test.stdout, emitsThrough(contains('-3: Some tests failed.')));
+ await test.shouldExit(1);
+ });
+
+ test('directly', () async {
+ await d.file('test.dart', _failure).create();
+ var test = await runDart(['test.dart']);
+ expect(test.stdout, emitsThrough(contains('Some tests failed.')));
+ await test.shouldExit(255);
+ });
+ });
+
+ test('runs tests even when a file fails to load', () async {
+ await d.file('test.dart', _success).create();
+
+ var test = await runTest(['test.dart', 'nonexistent.dart']);
+ expect(test.stdout, emitsThrough(contains('+1 -1: Some tests failed.')));
+ await test.shouldExit(1);
+ });
+
+ group('with a top-level @Skip declaration', () {
+ setUp(() async {
+ await d.file('test.dart', '''
+ @Skip()
+
+ import 'dart:async';
+
+ import 'package:test/test.dart';
+
+ void main() {
+ test('success', () {});
+ test('explicitly unskipped', skip: false, () {});
+ }
+ ''').create();
+ });
+
+ test('skips all tests', () async {
+ var test = await runTest(['test.dart']);
+ expect(test.stdout, emitsThrough(contains('+0 ~1: All tests skipped.')));
+ await test.shouldExit(0);
+ });
+
+ test('runs all tests with --run-skipped', () async {
+ var test = await runTest(['--run-skipped', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains('+2: All tests passed!')));
+ await test.shouldExit(0);
+ });
+ });
+
+ group('with onPlatform', () {
+ test('respects matching Skips', () async {
+ await d.file('test.dart', '''
+import 'dart:async';
+
+import 'package:test/test.dart';
+
+void main() {
+ test("fail", () => throw 'oh no', onPlatform: {"vm": Skip()});
+}
+''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stdout, emitsThrough(contains('+0 ~1: All tests skipped.')));
+ await test.shouldExit(0);
+ });
+
+ test('ignores non-matching Skips', () async {
+ await d.file('test.dart', '''
+import 'dart:async';
+
+import 'package:test/test.dart';
+
+void main() {
+ test("success", () {}, onPlatform: {"chrome": Skip()});
+}
+''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ test('respects matching Timeouts', () async {
+ await d.file('test.dart', '''
+import 'dart:async';
+
+import 'package:test/test.dart';
+
+void main() {
+ test("fail", () async {
+ await Future.delayed(Duration.zero);
+ throw 'oh no';
+ }, onPlatform: {
+ "vm": Timeout(Duration.zero)
+ });
+}
+''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(
+ test.stdout,
+ containsInOrder(
+ ['Test timed out after 0 seconds.', '-1: Some tests failed.']));
+ await test.shouldExit(1);
+ });
+
+ test('ignores non-matching Timeouts', () async {
+ await d.file('test.dart', '''
+import 'dart:async';
+
+import 'package:test/test.dart';
+
+void main() {
+ test("success", () {}, onPlatform: {
+ "chrome": Timeout(Duration(seconds: 0))
+ });
+}
+''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ test('applies matching platforms in order', () async {
+ await d.file('test.dart', '''
+import 'dart:async';
+
+import 'package:test/test.dart';
+
+void main() {
+ test("success", () {}, onPlatform: {
+ "vm": Skip("first"),
+ "vm || windows": Skip("second"),
+ "vm || linux": Skip("third"),
+ "vm || mac-os": Skip("fourth"),
+ "vm || android": Skip("fifth")
+ });
+}
+''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stdoutStream(), neverEmits(contains('Skip: first')));
+ expect(test.stdoutStream(), neverEmits(contains('Skip: second')));
+ expect(test.stdoutStream(), neverEmits(contains('Skip: third')));
+ expect(test.stdoutStream(), neverEmits(contains('Skip: fourth')));
+ expect(test.stdout, emitsThrough(contains('Skip: fifth')));
+ await test.shouldExit(0);
+ });
+
+ test('applies platforms to a group', () async {
+ await d.file('test.dart', '''
+import 'dart:async';
+
+import 'package:test/test.dart';
+
+void main() {
+ group("group", () {
+ test("success", () {});
+ }, onPlatform: {
+ "vm": Skip()
+ });
+}
+''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stdout, emitsThrough(contains('All tests skipped.')));
+ await test.shouldExit(0);
+ });
+ });
+
+ group('with an @OnPlatform annotation', () {
+ test('respects matching Skips', () async {
+ await d.file('test.dart', '''
+@OnPlatform(const {"vm": const Skip()})
+
+import 'dart:async';
+
+import 'package:test/test.dart';
+
+void main() {
+ test("fail", () => throw 'oh no');
+}
+''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stdout, emitsThrough(contains('+0 ~1: All tests skipped.')));
+ await test.shouldExit(0);
+ });
+
+ test('ignores non-matching Skips', () async {
+ await d.file('test.dart', '''
+@OnPlatform(const {"chrome": const Skip()})
+
+import 'dart:async';
+
+import 'package:test/test.dart';
+
+void main() {
+ test("success", () {});
+}
+''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ test('respects matching Timeouts', () async {
+ await d.file('test.dart', '''
+@OnPlatform(const {
+ "vm": const Timeout(const Duration(seconds: 0))
+})
+
+import 'dart:async';
+
+import 'package:test/test.dart';
+
+void main() {
+ test("fail", () async {
+ await Future.delayed(Duration.zero);
+ throw 'oh no';
+ });
+}
+''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(
+ test.stdout,
+ containsInOrder(
+ ['Test timed out after 0 seconds.', '-1: Some tests failed.']));
+ await test.shouldExit(1);
+ });
+
+ test('ignores non-matching Timeouts', () async {
+ await d.file('test.dart', '''
+@OnPlatform(const {
+ "chrome": const Timeout(const Duration(seconds: 0))
+})
+
+import 'dart:async';
+
+import 'package:test/test.dart';
+
+void main() {
+ test("success", () {});
+}
+''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ });
+ });
+
+ test('with the --color flag, uses colors', () async {
+ await d.file('test.dart', _failure).create();
+ var test = await runTest(['--color', 'test.dart']);
+ // This is the color code for red.
+ expect(test.stdout, emitsThrough(contains('\u001b[31m')));
+ await test.shouldExit();
+ });
+
+ group('runs tests successfully more than once when calling runTests', () {
+ test('defined in a single file', () async {
+ await d.file('test.dart', _success).create();
+ await d.file('runner.dart', '''
+import 'package:test_core/src/executable.dart' as test;
+
+void main(List<String> args) async {
+ await test.runTests(args);
+ await test.runTests(args);
+ test.completeShutdown();
+}''').create();
+ var test = await runDart([
+ 'runner.dart',
+ '--no-color',
+ '--reporter',
+ 'compact',
+ '--',
+ 'test.dart',
+ ], description: 'dart runner.dart -- test.dart');
+ expect(
+ test.stdout,
+ emitsThrough(containsInOrder([
+ '+0: loading test.dart',
+ '+0: success',
+ '+1: success',
+ 'All tests passed!'
+ ])));
+ expect(
+ test.stdout,
+ emitsThrough(containsInOrder([
+ '+0: loading test.dart',
+ '+0: success',
+ '+1: success',
+ '+1: All tests passed!',
+ ])));
+ await test.shouldExit(0);
+ });
+ }, onPlatform: const {
+ 'windows': Skip('https://github.com/dart-lang/test/issues/1615')
+ });
+
+ group('language experiments', () {
+ group('are inherited from the executable arguments', () {
+ setUp(() async {
+ await d.file('test.dart', '''
+// @dart=2.10
+import 'package:test/test.dart';
+
+// Compile time error if the experiment is enabled
+int x;
+
+void main() {
+ test('x is null', () {
+ expect(x, isNull);
+ });
+}
+''').create();
+ });
+
+ for (var platform in ['vm', 'chrome']) {
+ test('on the $platform platform', () async {
+ var test = await runTest(['test.dart', '-p', platform],
+ vmArgs: ['--enable-experiment=non-nullable']);
+
+ await expectLater(test.stdout, emitsThrough(contains('int x;')));
+ await test.shouldExit(1);
+
+ // Test that they can be removed on subsequent runs as well
+ test = await runTest(['test.dart', '-p', platform]);
+ await expectLater(
+ test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ }, skip: 'https://github.com/dart-lang/test/issues/1813');
+ }
+ });
+ });
+
+ group('runs tests after changing directories', () {
+ setUp(() async {
+ await d.file('a_test.dart', '''
+@TestOn('vm')
+import 'dart:io';
+
+import 'package:test/test.dart';
+
+void main() {
+ test('changes directory', () {
+ Directory.current = Directory.current.parent;
+ });
+}
+''').create();
+ await d.file('b_test.dart', '''
+import 'package:test/test.dart';
+
+void main() {
+ test('passes', () {
+ expect(true, true);
+ });
+}
+''').create();
+ });
+ test('on the VM platform', () async {
+ var test = await runTest(['-p', 'vm', 'a_test.dart', 'b_test.dart']);
+ await expectLater(
+ test.stdout, emitsThrough(contains('+2: All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ test('on the browser platform', () async {
+ var test =
+ await runTest(['-p', 'vm,chrome', 'a_test.dart', 'b_test.dart']);
+ await expectLater(
+ test.stdout, emitsThrough(contains('+3: All tests passed!')));
+ await test.shouldExit(0);
+ }, skip: 'https://github.com/dart-lang/test/issues/1803');
+ });
+}
diff --git a/pkgs/test/test/runner/set_up_all_test.dart b/pkgs/test/test/runner/set_up_all_test.dart
new file mode 100644
index 0000000..d1259e1
--- /dev/null
+++ b/pkgs/test/test/runner/set_up_all_test.dart
@@ -0,0 +1,98 @@
+// Copyright (c) 2015, 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.
+
+@TestOn('vm')
+library;
+
+import 'package:test/test.dart';
+import 'package:test_descriptor/test_descriptor.dart' as d;
+
+import '../io.dart';
+
+void main() {
+ setUpAll(precompileTestExecutable);
+
+ test('an error causes the run to fail', () async {
+ await d.file('test.dart', r'''
+ import 'package:test/test.dart';
+
+ void main() {
+ setUpAll(() => throw "oh no");
+
+ test("test", () {});
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stdout, emitsThrough(contains('-1: (setUpAll) [E]')));
+ expect(test.stdout, emitsThrough(contains('-1: Some tests failed.')));
+ await test.shouldExit(1);
+ });
+
+ test("doesn't run if no tests in the group are selected", () async {
+ await d.file('test.dart', r'''
+ import 'package:test/test.dart';
+
+ void main() {
+ group("with setUpAll", () {
+ setUpAll(() => throw "oh no");
+
+ test("test", () {});
+ });
+
+ group("without setUpAll", () {
+ test("test", () {});
+ });
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart', '--name', 'without']);
+ expect(test.stdout, neverEmits(contains('(setUpAll)')));
+ await test.shouldExit(0);
+ });
+
+ test("doesn't run if no tests in the group match the platform", () async {
+ await d.file('test.dart', r'''
+ import 'package:test/test.dart';
+
+ void main() {
+ group("group1", () {
+ setUpAll(() => throw "oh no");
+
+ test("with", () {}, testOn: "browser");
+ });
+
+ group("group2", () {
+ test("without", () {});
+ });
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stdout, neverEmits(contains('(setUpAll)')));
+ await test.shouldExit(0);
+ });
+
+ test("doesn't run if the group doesn't match the platform", () async {
+ await d.file('test.dart', r'''
+ import 'package:test/test.dart';
+
+ void main() {
+ group("group1", () {
+ setUpAll(() => throw "oh no");
+
+ test("with", () {});
+ }, testOn: "browser");
+
+ group("group2", () {
+ test("without", () {});
+ });
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stdout, neverEmits(contains('(setUpAll)')));
+ await test.shouldExit(0);
+ });
+}
diff --git a/pkgs/test/test/runner/shard_test.dart b/pkgs/test/test/runner/shard_test.dart
new file mode 100644
index 0000000..8d4be86
--- /dev/null
+++ b/pkgs/test/test/runner/shard_test.dart
@@ -0,0 +1,183 @@
+// Copyright (c) 2016, 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.
+
+@TestOn('vm')
+library;
+
+import 'package:test/test.dart';
+import 'package:test_core/src/util/exit_codes.dart' as exit_codes;
+import 'package:test_descriptor/test_descriptor.dart' as d;
+
+import '../io.dart';
+
+void main() {
+ setUpAll(precompileTestExecutable);
+
+ test('divides all the tests among the available shards', () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("test 1", () {});
+ test("test 2", () {});
+ test("test 3", () {});
+ test("test 4", () {});
+ test("test 5", () {});
+ test("test 6", () {});
+ test("test 7", () {});
+ test("test 8", () {});
+ test("test 9", () {});
+ test("test 10", () {});
+ }
+ ''').create();
+
+ var test =
+ await runTest(['test.dart', '--shard-index=0', '--total-shards=3']);
+ expect(
+ test.stdout,
+ containsInOrder([
+ '+0: test 1',
+ '+1: test 2',
+ '+2: test 3',
+ '+3: All tests passed!'
+ ]));
+ await test.shouldExit(0);
+
+ test = await runTest(['test.dart', '--shard-index=1', '--total-shards=3']);
+ expect(
+ test.stdout,
+ containsInOrder([
+ '+0: test 4',
+ '+1: test 5',
+ '+2: test 6',
+ '+3: test 7',
+ '+4: All tests passed!'
+ ]));
+ await test.shouldExit(0);
+
+ test = await runTest(['test.dart', '--shard-index=2', '--total-shards=3']);
+ expect(
+ test.stdout,
+ containsInOrder([
+ '+0: test 8',
+ '+1: test 9',
+ '+2: test 10',
+ '+3: All tests passed!'
+ ]));
+ await test.shouldExit(0);
+ });
+
+ test('shards each suite', () async {
+ await d.file('1_test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("test 1.1", () {});
+ test("test 1.2", () {});
+ test("test 1.3", () {});
+ }
+ ''').create();
+
+ await d.file('2_test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("test 2.1", () {});
+ test("test 2.2", () {});
+ test("test 2.3", () {});
+ }
+ ''').create();
+
+ var test = await runTest(['.', '--shard-index=0', '--total-shards=3']);
+ expect(
+ test.stdout,
+ emitsInOrder([
+ emitsAnyOf([
+ containsInOrder(
+ ['+0: ./1_test.dart: test 1.1', '+1: ./2_test.dart: test 2.1']),
+ containsInOrder(
+ ['+0: ./2_test.dart: test 2.1', '+1: ./1_test.dart: test 1.1'])
+ ]),
+ contains('+2: All tests passed!')
+ ]));
+ await test.shouldExit(0);
+
+ test = await runTest(['.', '--shard-index=1', '--total-shards=3']);
+ expect(
+ test.stdout,
+ emitsInOrder([
+ emitsAnyOf([
+ containsInOrder(
+ ['+0: ./1_test.dart: test 1.2', '+1: ./2_test.dart: test 2.2']),
+ containsInOrder(
+ ['+0: ./2_test.dart: test 2.2', '+1: ./1_test.dart: test 1.2'])
+ ]),
+ contains('+2: All tests passed!')
+ ]));
+ await test.shouldExit(0);
+
+ test = await runTest(['.', '--shard-index=2', '--total-shards=3']);
+ expect(
+ test.stdout,
+ emitsInOrder([
+ emitsAnyOf([
+ containsInOrder(
+ ['+0: ./1_test.dart: test 1.3', '+1: ./2_test.dart: test 2.3']),
+ containsInOrder(
+ ['+0: ./2_test.dart: test 2.3', '+1: ./1_test.dart: test 1.3'])
+ ]),
+ contains('+2: All tests passed!')
+ ]));
+ await test.shouldExit(0);
+ });
+
+ test('an empty shard reports success', () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("test 1", () {});
+ test("test 2", () {});
+ }
+ ''').create();
+
+ var test =
+ await runTest(['test.dart', '--shard-index=1', '--total-shards=3']);
+ expect(test.stdout, emitsThrough('No tests ran.'));
+ await test.shouldExit(79);
+ });
+
+ group('reports an error if', () {
+ test('--shard-index is provided alone', () async {
+ var test = await runTest(['--shard-index=1']);
+ expect(
+ test.stderr,
+ emits(
+ '--shard-index and --total-shards may only be passed together.'));
+ await test.shouldExit(exit_codes.usage);
+ });
+
+ test('--total-shards is provided alone', () async {
+ var test = await runTest(['--total-shards=5']);
+ expect(
+ test.stderr,
+ emits(
+ '--shard-index and --total-shards may only be passed together.'));
+ await test.shouldExit(exit_codes.usage);
+ });
+
+ test('--shard-index is negative', () async {
+ var test = await runTest(['--shard-index=-1', '--total-shards=5']);
+ expect(test.stderr, emits('--shard-index may not be negative.'));
+ await test.shouldExit(exit_codes.usage);
+ });
+
+ test('--shard-index is equal to --total-shards', () async {
+ var test = await runTest(['--shard-index=5', '--total-shards=5']);
+ expect(test.stderr,
+ emits('--shard-index must be less than --total-shards.'));
+ await test.shouldExit(exit_codes.usage);
+ });
+ });
+}
diff --git a/pkgs/test/test/runner/signal_test.dart b/pkgs/test/test/runner/signal_test.dart
new file mode 100644
index 0000000..d14ee97
--- /dev/null
+++ b/pkgs/test/test/runner/signal_test.dart
@@ -0,0 +1,236 @@
+// Copyright (c) 2015, 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.
+
+// Windows doesn't support sending signals.
+@TestOn('vm && !windows')
+library;
+
+import 'dart:async';
+import 'dart:io';
+
+import 'package:path/path.dart' as p;
+import 'package:test/test.dart';
+import 'package:test_descriptor/test_descriptor.dart' as d;
+import 'package:test_process/test_process.dart';
+
+import '../io.dart';
+
+String get _tempDir => p.join(d.sandbox, 'tmp');
+
+// This test is inherently prone to race conditions. If it fails, it will likely
+// do so flakily, but if it succeeds, it will succeed consistently. The tests
+// represent a best effort to kill the test runner at certain times during its
+// execution.
+void main() {
+ setUpAll(precompileTestExecutable);
+
+ setUp(() => d.dir('tmp').create());
+
+ group('during loading,', () {
+ test('cleans up if killed while loading a VM test', () async {
+ await d.file('test.dart', '''
+void main() {
+ print("in test.dart");
+ // Spin for a long time so the test is probably killed while still loading.
+ for (var i = 0; i < 100000000; i++) {}
+}
+''').create();
+
+ var test = await _runTest(['test.dart']);
+ await expectLater(test.stdout, emitsThrough('in test.dart'));
+ await signalAndQuit(test);
+
+ expectTempDirEmpty();
+ });
+
+ test('cleans up if killed while loading a browser test', () async {
+ await d.file('test.dart', 'void main() {}').create();
+
+ var test = await _runTest(['-p', 'chrome', 'test.dart']);
+ await expectLater(
+ test.stdout, emitsThrough(endsWith('loading test.dart')));
+ await signalAndQuit(test);
+
+ expectTempDirEmpty(skip: 'Failing on Travis.');
+ }, tags: 'chrome');
+
+ test('exits immediately if ^C is sent twice', () async {
+ await d.file('test.dart', '''
+void main() {
+ print("in test.dart");
+ while (true) {}
+}
+''').create();
+
+ var test = await _runTest(['test.dart']);
+ await expectLater(test.stdout, emitsThrough('in test.dart'));
+ test.signal(ProcessSignal.sigterm);
+
+ // TODO(nweiz): Sending two signals in close succession can cause the
+ // second one to be ignored, so we wait a bit before the second
+ // one. Remove this hack when issue 23047 is fixed.
+ await Future<void>.delayed(const Duration(seconds: 1));
+
+ await signalAndQuit(test);
+ });
+ });
+
+ group('during test running', () {
+ test('waits for a VM test to finish running', () async {
+ await d.file('test.dart', '''
+import 'dart:async';
+import 'dart:io';
+
+import 'package:test/test.dart';
+
+void main() {
+ tearDownAll(() {
+ File("output_all").writeAsStringSync("ran tearDownAll");
+ });
+
+ tearDown(() => File("output").writeAsStringSync("ran tearDown"));
+
+ test("test", () {
+ print("running test");
+ return Future.delayed(Duration(seconds: 1));
+ });
+}
+''').create();
+
+ var test = await _runTest(['test.dart']);
+ await expectLater(test.stdout, emitsThrough('running test'));
+ await signalAndQuit(test);
+
+ await d.file('output', 'ran tearDown').validate();
+ await d.file('output_all', 'ran tearDownAll').validate();
+ expectTempDirEmpty();
+ });
+
+ test('waits for an active tearDownAll to finish running', () async {
+ await d.file('test.dart', '''
+import 'dart:async';
+import 'dart:io';
+
+import 'package:test/test.dart';
+
+void main() {
+ tearDownAll(() async {
+ print("running tearDownAll");
+ await Future.delayed(Duration(seconds: 1));
+ File("output").writeAsStringSync("ran tearDownAll");
+ });
+
+ test("test", () {});
+}
+''').create();
+
+ var test = await _runTest(['test.dart']);
+ await expectLater(test.stdout, emitsThrough('running tearDownAll'));
+ await signalAndQuit(test);
+
+ await d.file('output', 'ran tearDownAll').validate();
+ expectTempDirEmpty();
+ });
+
+ test('kills a browser test immediately', () async {
+ await d.file('test.dart', '''
+import 'dart:async';
+
+import 'package:test/test.dart';
+
+void main() {
+ test("test", () {
+ print("running test");
+
+ // Allow an event loop to pass so the preceding print can be handled.
+ return Future(() {
+ // Loop forever so that if the test isn't stopped while running, it never
+ // stops.
+ while (true) {}
+ });
+ });
+}
+''').create();
+
+ var test = await _runTest(['-p', 'chrome', 'test.dart']);
+ await expectLater(test.stdout, emitsThrough('running test'));
+ await signalAndQuit(test);
+
+ expectTempDirEmpty(skip: 'Failing on Travis.');
+ }, tags: 'chrome');
+
+ test('kills a VM test immediately if ^C is sent twice', () async {
+ await d.file('test.dart', '''
+import 'package:test/test.dart';
+
+void main() {
+ test("test", () {
+ print("running test");
+ while (true) {}
+ });
+}
+''').create();
+
+ var test = await _runTest(['test.dart']);
+ await expectLater(test.stdout, emitsThrough('running test'));
+ test.signal(ProcessSignal.sigterm);
+
+ // TODO(nweiz): Sending two signals in close succession can cause the
+ // second one to be ignored, so we wait a bit before the second
+ // one. Remove this hack when issue 23047 is fixed.
+ await Future<void>.delayed(const Duration(seconds: 1));
+ await signalAndQuit(test);
+ });
+
+ test('causes expectAsync() to always throw an error immediately', () async {
+ await d.file('test.dart', '''
+import 'dart:async';
+import 'dart:io';
+
+import 'package:test/test.dart';
+
+void main() {
+ var expectAsyncThrewError = false;
+
+ tearDown(() {
+ File("output").writeAsStringSync(expectAsyncThrewError.toString());
+ });
+
+ test("test", () async {
+ print("running test");
+
+ await Future.delayed(Duration(seconds: 1));
+ try {
+ expectAsync0(() {});
+ } catch (_) {
+ expectAsyncThrewError = true;
+ }
+ });
+}
+''').create();
+
+ var test = await _runTest(['test.dart']);
+ await expectLater(test.stdout, emitsThrough('running test'));
+ await signalAndQuit(test);
+
+ await d.file('output', 'true').validate();
+ expectTempDirEmpty();
+ });
+ });
+}
+
+Future<TestProcess> _runTest(List<String> args, {bool forwardStdio = false}) =>
+ runTest(args,
+ environment: {'_UNITTEST_TEMP_DIR': _tempDir},
+ forwardStdio: forwardStdio);
+
+Future<void> signalAndQuit(TestProcess test) async {
+ test.signal(ProcessSignal.sigterm);
+ await test.shouldExit();
+ await expectLater(test.stderr, emitsDone);
+}
+
+void expectTempDirEmpty({Object? skip}) {
+ expect(Directory(_tempDir).listSync(), isEmpty, skip: skip);
+}
diff --git a/pkgs/test/test/runner/skip_expect_test.dart b/pkgs/test/test/runner/skip_expect_test.dart
new file mode 100644
index 0000000..e22332c
--- /dev/null
+++ b/pkgs/test/test/runner/skip_expect_test.dart
@@ -0,0 +1,270 @@
+// Copyright (c) 2016, 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.
+
+@TestOn('vm')
+library;
+
+import 'package:test/test.dart';
+import 'package:test_descriptor/test_descriptor.dart' as d;
+
+import '../io.dart';
+
+void main() {
+ setUpAll(precompileTestExecutable);
+
+ group('a skipped expect', () {
+ test('marks the test as skipped', () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("skipped", () => expect(1, equals(2), skip: true));
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stdout, emitsThrough(contains('~1: All tests skipped.')));
+ await test.shouldExit(0);
+ });
+
+ test('prints the skip reason if there is one', () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("skipped", () => expect(1, equals(2),
+ reason: "1 is 2", skip: "is failing"));
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(
+ test.stdout,
+ containsInOrder([
+ '+0: skipped',
+ ' Skip expect: is failing',
+ '~1: All tests skipped.'
+ ]));
+ await test.shouldExit(0);
+ });
+
+ test("prints the expect reason if there's no skip reason", () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("skipped", () => expect(1, equals(2),
+ reason: "1 is 2", skip: true));
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(
+ test.stdout,
+ containsInOrder([
+ '+0: skipped',
+ ' Skip expect (1 is 2).',
+ '~1: All tests skipped.'
+ ]));
+ await test.shouldExit(0);
+ });
+
+ test('prints the matcher description if there are no reasons', () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("skipped", () => expect(1, equals(2), skip: true));
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(
+ test.stdout,
+ containsInOrder([
+ '+0: skipped',
+ ' Skip expect (<2>).',
+ '~1: All tests skipped.'
+ ]));
+ await test.shouldExit(0);
+ });
+
+ test('still allows the test to fail', () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("failing", () {
+ expect(1, equals(2), skip: true);
+ expect(1, equals(2));
+ });
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(
+ test.stdout,
+ containsInOrder([
+ '+0: failing',
+ ' Skip expect (<2>).',
+ '+0 -1: failing [E]',
+ ' Expected: <2>',
+ ' Actual: <1>',
+ '+0 -1: Some tests failed.'
+ ]));
+ await test.shouldExit(1);
+ });
+ });
+
+ group('markTestSkipped', () {
+ test('prints the skip reason', () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test('skipped', () {
+ markTestSkipped('some reason');
+ });
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(
+ test.stdout,
+ containsInOrder([
+ '+0: skipped',
+ ' some reason',
+ '~1: All tests skipped.',
+ ]));
+ await test.shouldExit(0);
+ });
+
+ test('still allows the test to fail', () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test('failing', () {
+ markTestSkipped('some reason');
+ expect(1, equals(2));
+ });
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(
+ test.stdout,
+ containsInOrder([
+ '+0: failing',
+ ' some reason',
+ '+0 -1: failing [E]',
+ ' Expected: <2>',
+ ' Actual: <1>',
+ '+0 -1: Some tests failed.'
+ ]));
+ await test.shouldExit(1);
+ });
+
+ test('error when called after the test succeeded', () async {
+ await d.file('test.dart', '''
+ import 'dart:async';
+
+ import 'package:test/test.dart';
+
+ void main() {
+ var skipCompleter = Completer();
+ var waitCompleter = Completer();
+ test('skip', () {
+ skipCompleter.future.then((_) {
+ waitCompleter.complete();
+ markTestSkipped('some reason');
+ });
+ });
+
+ // Trigger the skip completer in a following test to ensure that it
+ // only fires after skip has completed successfully.
+ test('wait', () async {
+ skipCompleter.complete();
+ await waitCompleter.future;
+ });
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(
+ test.stdout,
+ containsInOrder([
+ '+0: skip',
+ '+1: wait',
+ '+0 -1: skip',
+ 'This test was marked as skipped after it had already completed.',
+ 'Make sure to use a matching library which informs the test runner',
+ 'of pending async work.',
+ '+1 -1: Some tests failed.'
+ ]));
+ await test.shouldExit(1);
+ });
+ });
+
+ group('errors', () {
+ test('when called after the test succeeded', () async {
+ await d.file('test.dart', '''
+ import 'dart:async';
+
+ import 'package:test/test.dart';
+
+ void main() {
+ var skipCompleter = Completer();
+ var waitCompleter = Completer();
+ test("skip", () {
+ skipCompleter.future.then((_) {
+ waitCompleter.complete();
+ expect(1, equals(2), skip: true);
+ });
+ });
+
+ // Trigger the skip completer in a following test to ensure that it
+ // only fires after skip has completed successfully.
+ test("wait", () async {
+ skipCompleter.complete();
+ await waitCompleter.future;
+ });
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(
+ test.stdout,
+ containsInOrder([
+ '+0: skip',
+ '+1: wait',
+ '+0 -1: skip',
+ 'This test was marked as skipped after it had already completed.',
+ 'Make sure to use a matching library which informs the test runner',
+ 'of pending async work.',
+ '+1 -1: Some tests failed.'
+ ]));
+ await test.shouldExit(1);
+ });
+
+ test('when an invalid type is used for skip', () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("failing", () {
+ expect(1, equals(2), skip: 10);
+ });
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(
+ test.stdout,
+ containsInOrder(
+ ['Invalid argument (skip)', '+0 -1: Some tests failed.']));
+ await test.shouldExit(1);
+ });
+ });
+}
diff --git a/pkgs/test/test/runner/solo_test.dart b/pkgs/test/test/runner/solo_test.dart
new file mode 100644
index 0000000..87f6f25
--- /dev/null
+++ b/pkgs/test/test/runner/solo_test.dart
@@ -0,0 +1,67 @@
+// Copyright (c) 2018, 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.
+
+@TestOn('vm')
+library;
+
+import 'package:test/test.dart';
+import 'package:test_descriptor/test_descriptor.dart' as d;
+
+import '../io.dart';
+
+void main() {
+ setUpAll(precompileTestExecutable);
+
+ test('only runs the tests marked as solo', () async {
+ await d.file('test.dart', '''
+ import 'dart:async';
+
+ import 'package:test/test.dart';
+
+ void main() {
+ test("passes", () {
+ expect(true, isTrue);
+ }, solo: true);
+ test("failed", () {
+ throw 'some error';
+ });
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stdout, emitsThrough(contains('+1 ~1: All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ test('only runs groups marked as solo', () async {
+ await d.file('test.dart', '''
+ import 'dart:async';
+
+ import 'package:test/test.dart';
+
+ void main() {
+ group('solo', () {
+ test("first pass", () {
+ expect(true, isTrue);
+ });
+ test("second pass", () {
+ expect(true, isTrue);
+ });
+ }, solo: true);
+ group('no solo', () {
+ test("failure", () {
+ throw 'some error';
+ });
+ test("another failure", () {
+ throw 'some error';
+ });
+ });
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stdout, emitsThrough(contains('+2 ~1: All tests passed!')));
+ await test.shouldExit(0);
+ });
+}
diff --git a/pkgs/test/test/runner/tag_test.dart b/pkgs/test/test/runner/tag_test.dart
new file mode 100644
index 0000000..da9dca7
--- /dev/null
+++ b/pkgs/test/test/runner/tag_test.dart
@@ -0,0 +1,370 @@
+// Copyright (c) 2015, 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.
+
+@TestOn('vm')
+library;
+
+import 'package:test/test.dart';
+import 'package:test_descriptor/test_descriptor.dart' as d;
+
+import '../io.dart';
+
+void main() {
+ setUpAll(precompileTestExecutable);
+
+ setUp(() async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("no tags", () {});
+ test("a", () {}, tags: "a");
+ test("b", () {}, tags: "b");
+ test("bc", () {}, tags: ["b", "c"]);
+ }
+ ''').create();
+ });
+
+ group('--tags', () {
+ test('runs all tests when no tags are specified', () async {
+ var test = await runTest(['test.dart']);
+ expect(test.stdout, tagWarnings(['a', 'b', 'c']));
+ expect(test.stdout, emitsThrough(contains(': no tags')));
+ expect(test.stdout, emitsThrough(contains(': a')));
+ expect(test.stdout, emitsThrough(contains(': b')));
+ expect(test.stdout, emitsThrough(contains(': bc')));
+ expect(test.stdout, emitsThrough(contains('+4: All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ test('runs a test with only a specified tag', () async {
+ var test = await runTest(['--tags=a', 'test.dart']);
+ expect(test.stdout, tagWarnings(['b', 'c']));
+ expect(test.stdout, emitsThrough(contains(': a')));
+ expect(test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ test('runs a test with a specified tag among others', () async {
+ var test = await runTest(['--tags=c', 'test.dart']);
+ expect(test.stdout, tagWarnings(['a', 'b']));
+ expect(test.stdout, emitsThrough(contains(': bc')));
+ expect(test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ test('with multiple tags, runs only tests matching all of them', () async {
+ var test = await runTest(['--tags=b,c', 'test.dart']);
+ expect(test.stdout, tagWarnings(['a']));
+ expect(test.stdout, emitsThrough(contains(': bc')));
+ expect(test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ test('supports boolean selector syntax', () async {
+ var test = await runTest(['--tags=b || c', 'test.dart']);
+ expect(test.stdout, tagWarnings(['a']));
+ expect(test.stdout, emitsThrough(contains(': b')));
+ expect(test.stdout, emitsThrough(contains(': bc')));
+ expect(test.stdout, emitsThrough(contains('+2: All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ test('prints no warnings when all tags are specified', () async {
+ var test = await runTest(['--tags=a,b,c', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains('No tests ran.')));
+ await test.shouldExit(79);
+ });
+ });
+
+ group('--exclude-tags', () {
+ test("dosn't run a test with only an excluded tag", () async {
+ var test = await runTest(['--exclude-tags=a', 'test.dart']);
+ expect(test.stdout, tagWarnings(['b', 'c']));
+ expect(test.stdout, emitsThrough(contains(': no tags')));
+ expect(test.stdout, emitsThrough(contains(': b')));
+ expect(test.stdout, emitsThrough(contains(': bc')));
+ expect(test.stdout, emitsThrough(contains('+3: All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ test("doesn't run a test with an excluded tag among others", () async {
+ var test = await runTest(['--exclude-tags=c', 'test.dart']);
+ expect(test.stdout, tagWarnings(['a', 'b']));
+ expect(test.stdout, emitsThrough(contains(': no tags')));
+ expect(test.stdout, emitsThrough(contains(': a')));
+ expect(test.stdout, emitsThrough(contains(': b')));
+ expect(test.stdout, emitsThrough(contains('+3: All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ test("dosn't load a suite with an excluded tag", () async {
+ await d.file('test.dart', '''
+ @Tags(const ["a"])
+
+ import 'package:test/test.dart';
+
+ void main() {
+ throw "error";
+ }
+ ''').create();
+
+ var test = await runTest(['--exclude-tags=a', 'test.dart']);
+ expect(test.stdout, emits('No tests ran.'));
+ await test.shouldExit(79);
+ });
+
+ test('allows unused tags', () async {
+ var test = await runTest(['--exclude-tags=b,z', 'test.dart']);
+ expect(test.stdout, tagWarnings(['a', 'c']));
+ expect(test.stdout, emitsThrough(contains(': no tags')));
+ expect(test.stdout, emitsThrough(contains(': a')));
+ expect(test.stdout, emitsThrough(contains('+2: All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ test('supports boolean selector syntax', () async {
+ var test = await runTest(['--exclude-tags=b && c', 'test.dart']);
+ expect(test.stdout, tagWarnings(['a']));
+ expect(test.stdout, emitsThrough(contains(': no tags')));
+ expect(test.stdout, emitsThrough(contains(': a')));
+ expect(test.stdout, emitsThrough(contains(': b')));
+ expect(test.stdout, emitsThrough(contains('+3: All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ test('prints no warnings when all tags are specified', () async {
+ var test = await runTest(['--exclude-tags=a,b,c', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains(': no tags')));
+ expect(test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ });
+ });
+
+ group('with a tagged group', () {
+ setUp(() async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ group("a", () {
+ test("in", () {});
+ }, tags: "a");
+
+ test("out", () {});
+ }
+ ''').create();
+ });
+
+ test('includes tags specified on the group', () async {
+ var test = await runTest(['-x', 'a', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains(': out')));
+ expect(test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ test('excludes tags specified on the group', () async {
+ var test = await runTest(['-t', 'a', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains(': a in')));
+ expect(test.stdout, emitsThrough(contains('+1: All tests passed!')));
+ await test.shouldExit(0);
+ });
+ });
+
+ test('respects top-level @Tags annotations', () async {
+ await d.file('test.dart', '''
+ @Tags(const ['a'])
+ import 'package:test/test.dart';
+
+ void main() {
+ test("foo", () {});
+ }
+ ''').create();
+
+ var test = await runTest(['-x', 'a', 'test.dart']);
+ expect(test.stdout, emitsThrough(contains('No tests ran')));
+ await test.shouldExit(79);
+ });
+
+ group('warning formatting', () {
+ test('for multiple tags', () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("foo", () {}, tags: ["a", "b"]);
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(
+ test.stdout,
+ emitsThrough(lines(
+ 'Warning: Tags were used that weren\'t specified in dart_test.yaml.\n'
+ ' a was used in the test "foo"\n'
+ ' b was used in the test "foo"')));
+ await test.shouldExit(0);
+ });
+
+ test('for multiple tests', () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("foo", () {}, tags: "a");
+ test("bar", () {}, tags: "a");
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(
+ test.stdout,
+ emitsThrough(lines(
+ 'Warning: A tag was used that wasn\'t specified in dart_test.yaml.\n'
+ ' a was used in:\n'
+ ' the test "foo"\n'
+ ' the test "bar"')));
+ await test.shouldExit(0);
+ });
+
+ test('for groups', () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ group("group", () {
+ test("foo", () {});
+ test("bar", () {});
+ }, tags: "a");
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(
+ test.stdout,
+ emitsThrough(lines(
+ 'Warning: A tag was used that wasn\'t specified in dart_test.yaml.\n'
+ ' a was used in the group "group"')));
+ await test.shouldExit(0);
+ });
+
+ test('for suites', () async {
+ await d.file('test.dart', '''
+ @Tags(const ["a"])
+ import 'package:test/test.dart';
+
+ void main() {
+ test("foo", () {});
+ test("bar", () {});
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(
+ test.stdout,
+ emitsThrough(lines(
+ 'Warning: A tag was used that wasn\'t specified in dart_test.yaml.\n'
+ ' a was used in the suite itself')));
+ await test.shouldExit(0);
+ });
+
+ test("doesn't double-print a tag warning", () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("foo", () {}, tags: "a");
+ }
+ ''').create();
+
+ var test = await runTest(['-p', 'vm,chrome', 'test.dart']);
+ expect(
+ test.stdout,
+ emitsThrough(lines(
+ 'Warning: A tag was used that wasn\'t specified in dart_test.yaml.\n'
+ ' a was used in the test "foo"')));
+ expect(test.stdout, neverEmits(startsWith('Warning:')));
+ await test.shouldExit(0);
+ }, tags: 'chrome');
+ });
+
+ group('invalid tags', () {
+ test('are disallowed by test()', () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ test("foo", () {}, tags: "a b");
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(
+ test.stdout,
+ emitsThrough(
+ ' Failed to load "test.dart": Invalid argument(s): Invalid tag "a '
+ 'b". Tags must be (optionally hyphenated) Dart identifiers.'));
+ await test.shouldExit(1);
+ });
+
+ test('are disallowed by group()', () async {
+ await d.file('test.dart', '''
+ import 'package:test/test.dart';
+
+ void main() {
+ group("group", () {
+ test("foo", () {});
+ }, tags: "a b");
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(
+ test.stdout,
+ emitsThrough(
+ ' Failed to load "test.dart": Invalid argument(s): Invalid tag "a '
+ 'b". Tags must be (optionally hyphenated) Dart identifiers.'));
+ await test.shouldExit(1);
+ });
+
+ test('are disallowed by @Tags()', () async {
+ await d.file('test.dart', '''
+ @Tags(const ["a b"])
+
+ import 'package:test/test.dart';
+
+ void main() {
+ test("foo", () {});
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(
+ test.stdout,
+ emitsThrough(lines(' Failed to load "test.dart":\n'
+ ' Error on line 1, column 22: Invalid tag name. Tags must be '
+ '(optionally hyphenated) Dart identifiers.')));
+ await test.shouldExit(1);
+ });
+ });
+}
+
+/// Returns a [StreamMatcher] that asserts that a test emits warnings for [tags]
+/// in order.
+StreamMatcher tagWarnings(List<String> tags) => emitsInOrder([
+ emitsThrough(
+ "Warning: ${tags.length == 1 ? 'A tag was' : 'Tags were'} used that "
+ "${tags.length == 1 ? "wasn't" : "weren't"} specified in "
+ 'dart_test.yaml.'),
+
+ for (var tag in tags) emitsThrough(startsWith(' $tag was used in')),
+
+ // Consume until the end of the warning block, and assert that it has no
+ // further tags than the ones we specified.
+ mayEmitMultiple(isNot(anyOf([contains(' was used in'), isEmpty]))),
+ isEmpty,
+ ]);
+
+/// Returns a [StreamMatcher] that matches the lines of [string] in order.
+StreamMatcher lines(String string) => emitsInOrder(string.split('\n'));
diff --git a/pkgs/test/test/runner/tear_down_all_test.dart b/pkgs/test/test/runner/tear_down_all_test.dart
new file mode 100644
index 0000000..93ede4f
--- /dev/null
+++ b/pkgs/test/test/runner/tear_down_all_test.dart
@@ -0,0 +1,98 @@
+// Copyright (c) 2015, 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.
+
+@TestOn('vm')
+library;
+
+import 'package:test/test.dart';
+import 'package:test_descriptor/test_descriptor.dart' as d;
+
+import '../io.dart';
+
+void main() {
+ setUpAll(precompileTestExecutable);
+
+ test('an error causes the run to fail', () async {
+ await d.file('test.dart', r'''
+ import 'package:test/test.dart';
+
+ void main() {
+ tearDownAll(() => throw "oh no");
+
+ test("test", () {});
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stdout, emitsThrough(contains('-1: (tearDownAll) [E]')));
+ expect(test.stdout, emitsThrough(contains('-1: Some tests failed.')));
+ await test.shouldExit(1);
+ });
+
+ test("doesn't run if no tests in the group are selected", () async {
+ await d.file('test.dart', r'''
+ import 'package:test/test.dart';
+
+ void main() {
+ group("with tearDownAll", () {
+ tearDownAll(() => throw "oh no");
+
+ test("test", () {});
+ });
+
+ group("without tearDownAll", () {
+ test("test", () {});
+ });
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart', '--name', 'without']);
+ expect(test.stdout, neverEmits(contains('(tearDownAll)')));
+ await test.shouldExit(0);
+ });
+
+ test("doesn't run if no tests in the group match the platform", () async {
+ await d.file('test.dart', r'''
+ import 'package:test/test.dart';
+
+ void main() {
+ group("group1", () {
+ tearDownAll(() => throw "oh no");
+
+ test("with", () {}, testOn: "browser");
+ });
+
+ group("group2", () {
+ test("without", () {});
+ });
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stdout, neverEmits(contains('(tearDownAll)')));
+ await test.shouldExit(0);
+ });
+
+ test("doesn't run if the group doesn't match the platform", () async {
+ await d.file('test.dart', r'''
+ import 'package:test/test.dart';
+
+ void main() {
+ group("group1", () {
+ tearDownAll(() => throw "oh no");
+
+ test("with", () {});
+ }, testOn: "browser");
+
+ group("group2", () {
+ test("without", () {});
+ });
+ }
+ ''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(test.stdout, neverEmits(contains('(tearDownAll)')));
+ await test.shouldExit(0);
+ });
+}
diff --git a/pkgs/test/test/runner/test_chain_test.dart b/pkgs/test/test/runner/test_chain_test.dart
new file mode 100644
index 0000000..ad814de
--- /dev/null
+++ b/pkgs/test/test/runner/test_chain_test.dart
@@ -0,0 +1,84 @@
+// Copyright (c) 2017, 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.
+
+@TestOn('vm')
+library;
+
+import 'dart:convert';
+
+import 'package:test/test.dart';
+import 'package:test_descriptor/test_descriptor.dart' as d;
+
+import '../io.dart';
+
+void main() {
+ setUpAll(precompileTestExecutable);
+
+ setUp(() async {
+ await d.file('test.dart', '''
+ import 'dart:async';
+
+ import 'package:test/test.dart';
+
+ void main() {
+ test("failure", () async{
+ await Future((){});
+ await Future((){});
+ throw "oh no";
+ });
+ }
+ ''').create();
+ });
+ test('folds packages contained in the except list', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'fold_stack_frames': {
+ 'except': ['stream_channel']
+ }
+ }))
+ .create();
+ var test = await runTest(['test.dart']);
+ expect(test.stdoutStream(), neverEmits(contains('package:stream_channel')));
+ await test.shouldExit(1);
+ });
+
+ test('by default folds both stream_channel and test packages', () async {
+ var test = await runTest(['test.dart']);
+ expect(test.stdoutStream(), neverEmits(contains('package:test')));
+ expect(test.stdoutStream(), neverEmits(contains('package:stream_channel')));
+ await test.shouldExit(1);
+ });
+
+ test('folds all packages not contained in the only list', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'fold_stack_frames': {
+ 'only': ['test']
+ }
+ }))
+ .create();
+ var test = await runTest(['test.dart']);
+ expect(test.stdoutStream(), neverEmits(contains('package:stream_channel')));
+ await test.shouldExit(1);
+ });
+
+ test('does not fold packages in the only list', () async {
+ await d
+ .file(
+ 'dart_test.yaml',
+ jsonEncode({
+ 'fold_stack_frames': {
+ 'only': ['test_api']
+ }
+ }))
+ .create();
+ var test = await runTest(['test.dart']);
+ expect(test.stdoutStream(), emitsThrough(contains('package:test_api')));
+ await test.shouldExit(1);
+ });
+}
diff --git a/pkgs/test/test/runner/test_on_test.dart b/pkgs/test/test/runner/test_on_test.dart
new file mode 100644
index 0000000..96baf0b
--- /dev/null
+++ b/pkgs/test/test/runner/test_on_test.dart
@@ -0,0 +1,226 @@
+// Copyright (c) 2015, 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.
+
+@TestOn('vm')
+library;
+
+import 'dart:async';
+import 'dart:convert';
+import 'dart:isolate';
+
+import 'package:package_config/package_config.dart';
+import 'package:test/test.dart';
+import 'package:test_core/src/util/io.dart';
+import 'package:test_descriptor/test_descriptor.dart' as d;
+
+import '../io.dart';
+
+void main() {
+ late PackageConfig currentPackageConfig;
+
+ setUpAll(() async {
+ await precompileTestExecutable();
+ currentPackageConfig =
+ await loadPackageConfigUri((await Isolate.packageConfig)!);
+ });
+
+ setUp(() async {
+ await d
+ .file('package_config.json',
+ jsonEncode(PackageConfig.toJson(currentPackageConfig)))
+ .create();
+ });
+
+ group('for suite', () {
+ test('runs a test suite on a matching platform', () async {
+ await _writeTestFile('vm_test.dart', suiteTestOn: 'vm');
+
+ var test = await runTest(['vm_test.dart']);
+ expect(test.stdout, emitsThrough(contains('All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ test("doesn't run a test suite on a non-matching platform", () async {
+ await _writeTestFile('vm_test.dart', suiteTestOn: 'vm');
+
+ var test = await runTest(['--platform', 'chrome', 'vm_test.dart']);
+ expect(test.stdout, emitsThrough(contains('No tests ran.')));
+ await test.shouldExit(79);
+ }, tags: 'chrome');
+
+ test('runs a test suite on a matching operating system', () async {
+ await _writeTestFile('os_test.dart', suiteTestOn: currentOS.identifier);
+
+ var test = await runTest(['os_test.dart']);
+ expect(test.stdout, emitsThrough(contains('All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ test("doesn't run a test suite on a non-matching operating system",
+ () async {
+ await _writeTestFile('os_test.dart',
+ suiteTestOn: otherOS, loadable: false);
+
+ var test = await runTest(['os_test.dart']);
+ expect(test.stdout, emitsThrough(contains('No tests ran.')));
+ await test.shouldExit(79);
+ });
+
+ test('only loads matching files when loading as a group', () async {
+ await _writeTestFile('vm_test.dart', suiteTestOn: 'vm');
+ await _writeTestFile('browser_test.dart',
+ suiteTestOn: 'browser', loadable: false);
+ await _writeTestFile('this_os_test.dart',
+ suiteTestOn: currentOS.identifier);
+ await _writeTestFile('other_os_test.dart',
+ suiteTestOn: otherOS, loadable: false);
+
+ var test = await runTest(['.']);
+ expect(test.stdout, emitsThrough(contains('+2: All tests passed!')));
+ await test.shouldExit(0);
+ });
+ });
+
+ group('for group', () {
+ test('runs a VM group on the VM', () async {
+ await _writeTestFile('vm_test.dart', groupTestOn: 'vm');
+
+ var test = await runTest(['vm_test.dart']);
+ expect(test.stdout, emitsThrough(contains('All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ test("doesn't run a Browser group on the VM", () async {
+ await _writeTestFile('browser_test.dart', groupTestOn: 'browser');
+
+ var test = await runTest(['browser_test.dart']);
+ expect(test.stdout, emitsThrough(contains('No tests ran.')));
+ await test.shouldExit(79);
+ });
+
+ test('runs a browser group on a browser', () async {
+ await _writeTestFile('browser_test.dart', groupTestOn: 'browser');
+
+ var test = await runTest(['--platform', 'chrome', 'browser_test.dart']);
+ expect(test.stdout, emitsThrough(contains('All tests passed!')));
+ await test.shouldExit(0);
+ }, tags: 'chrome');
+
+ test("doesn't run a VM group on a browser", () async {
+ await _writeTestFile('vm_test.dart', groupTestOn: 'vm');
+
+ var test = await runTest(['--platform', 'chrome', 'vm_test.dart']);
+ expect(test.stdout, emitsThrough(contains('No tests ran.')));
+ await test.shouldExit(79);
+ }, tags: 'chrome');
+ });
+
+ group('for test', () {
+ test('runs a VM test on the VM', () async {
+ await _writeTestFile('vm_test.dart', testTestOn: 'vm');
+
+ var test = await runTest(['vm_test.dart']);
+ expect(test.stdout, emitsThrough(contains('All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ test("doesn't run a browser test on the VM", () async {
+ await _writeTestFile('browser_test.dart', testTestOn: 'browser');
+
+ var test = await runTest(['browser_test.dart']);
+ expect(test.stdout, emitsThrough(contains('No tests ran.')));
+ await test.shouldExit(79);
+ });
+
+ test('runs a browser test on a browser', () async {
+ await _writeTestFile('browser_test.dart', testTestOn: 'browser');
+
+ var test = await runTest(['--platform', 'chrome', 'browser_test.dart']);
+ expect(test.stdout, emitsThrough(contains('All tests passed!')));
+ await test.shouldExit(0);
+ }, tags: 'chrome');
+
+ test("doesn't run a VM test on a browser", () async {
+ await _writeTestFile('vm_test.dart', testTestOn: 'vm');
+
+ var test = await runTest(['--platform', 'chrome', 'vm_test.dart']);
+ expect(test.stdout, emitsThrough(contains('No tests ran.')));
+ await test.shouldExit(79);
+ }, tags: 'chrome');
+ });
+
+ group('with suite, group, and test selectors', () {
+ test('runs the test if all selectors match', () async {
+ await _writeTestFile('vm_test.dart',
+ suiteTestOn: '!browser', groupTestOn: '!js', testTestOn: 'vm');
+
+ var test = await runTest(['vm_test.dart']);
+ expect(test.stdout, emitsThrough(contains('All tests passed!')));
+ await test.shouldExit(0);
+ });
+
+ test("doesn't runs the test if the suite doesn't match", () async {
+ await _writeTestFile('vm_test.dart',
+ suiteTestOn: 'browser', groupTestOn: '!js', testTestOn: 'vm');
+
+ var test = await runTest(['vm_test.dart']);
+ expect(test.stdout, emitsThrough(contains('No tests ran.')));
+ await test.shouldExit(79);
+ });
+
+ test("doesn't runs the test if the group doesn't match", () async {
+ await _writeTestFile('vm_test.dart',
+ suiteTestOn: '!browser', groupTestOn: 'browser', testTestOn: 'vm');
+
+ var test = await runTest(['vm_test.dart']);
+ expect(test.stdout, emitsThrough(contains('No tests ran.')));
+ await test.shouldExit(79);
+ });
+
+ test("doesn't runs the test if the test doesn't match", () async {
+ await _writeTestFile('vm_test.dart',
+ suiteTestOn: '!browser', groupTestOn: '!js', testTestOn: 'browser');
+
+ var test = await runTest(['vm_test.dart']);
+ expect(test.stdout, emitsThrough(contains('No tests ran.')));
+ await test.shouldExit(79);
+ });
+ });
+}
+
+/// Writes a test file with some platform selectors to [filename].
+///
+/// Each of [suiteTestOn], [groupTestOn], and [testTestOn] is a platform
+/// selector that's suite-, group-, and test-level respectively. If [loadable]
+/// is `false`, the test file will be made unloadable on the Dart VM.
+Future<void> _writeTestFile(String filename,
+ {String? suiteTestOn,
+ String? groupTestOn,
+ String? testTestOn,
+ bool loadable = true}) {
+ var buffer = StringBuffer();
+ if (suiteTestOn != null) buffer.writeln("@TestOn('$suiteTestOn')");
+ if (!loadable) buffer.writeln("import 'dart:js_util';");
+
+ buffer
+ ..writeln("import 'package:test/test.dart';")
+ ..writeln('void main() {')
+ ..writeln(" group('group', () {");
+
+ if (testTestOn != null) {
+ buffer.writeln(" test('test', () {}, testOn: '$testTestOn');");
+ } else {
+ buffer.writeln(" test('test', () {});");
+ }
+
+ if (groupTestOn != null) {
+ buffer.writeln(" }, testOn: '$groupTestOn');");
+ } else {
+ buffer.writeln(' });');
+ }
+
+ buffer.writeln('}');
+
+ return d.file(filename, buffer.toString()).create();
+}
diff --git a/pkgs/test/test/runner/timeout_test.dart b/pkgs/test/test/runner/timeout_test.dart
new file mode 100644
index 0000000..6f4b0e7
--- /dev/null
+++ b/pkgs/test/test/runner/timeout_test.dart
@@ -0,0 +1,185 @@
+// Copyright (c) 2016, 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.
+
+@TestOn('vm')
+library;
+
+import 'package:test/test.dart';
+import 'package:test_descriptor/test_descriptor.dart' as d;
+
+import '../io.dart';
+
+void main() {
+ setUpAll(precompileTestExecutable);
+
+ test('respects top-level @Timeout declarations', () async {
+ await d.file('test.dart', '''
+@Timeout(const Duration(seconds: 0))
+
+import 'dart:async';
+
+import 'package:test/test.dart';
+
+void main() {
+ test("timeout", () async {
+ await Future.delayed(Duration.zero);
+ });
+}
+''').create();
+
+ var test = await runTest(['test.dart']);
+ expect(
+ test.stdout,
+ containsInOrder(
+ ['Test timed out after 0 seconds.', '-1: Some tests failed.']));
+ await test.shouldExit(1);
+ });
+
+ test('respects the --timeout flag', () async {
+ await d.file('test.dart', '''
+import 'dart:async';
+
+import 'package:test/test.dart';
+
+void main() {
+ test("timeout", () async {
+ await Future.delayed(Duration.zero);
+ });
+}
+''').create();
+
+ var test = await runTest(['--timeout=0s', 'test.dart']);
+ expect(
+ test.stdout,
+ containsInOrder(
+ ['Test timed out after 0 seconds.', '-1: Some tests failed.']));
+ await test.shouldExit(1);
+ });
+
+ test('timeout is reset with each retry', () async {
+ await d.file('test.dart', '''
+import 'dart:async';
+
+import 'package:test/test.dart';
+
+void main() {
+ var runCount = 0;
+ test("timeout", () async {
+ runCount++;
+ if (runCount <=2) {
+ await Future.delayed(Duration(milliseconds: 1000));
+ }
+ }, retry: 3);
+}
+''').create();
+
+ var test = await runTest(['--timeout=400ms', 'test.dart']);
+ expect(
+ test.stdout,
+ containsInOrder([
+ 'Test timed out after 0.4 seconds.',
+ 'Test timed out after 0.4 seconds.',
+ '+1: All tests passed!'
+ ]));
+ await test.shouldExit(0);
+ });
+
+ test('the --timeout flag applies on top of the default 30s timeout',
+ () async {
+ await d.file('test.dart', '''
+import 'dart:async';
+
+import 'package:test/test.dart';
+
+void main() {
+ test("no timeout", () async {
+ await Future.delayed(Duration(milliseconds: 250));
+ });
+
+ test("timeout", () async {
+ await Future.delayed(Duration(milliseconds: 750));
+ });
+}
+''').create();
+
+ // This should make the timeout about 500ms, which should cause exactly one
+ // test to fail.
+ var test = await runTest(['--timeout=0.016x', 'test.dart']);
+ expect(
+ test.stdout,
+ containsInOrder(
+ ['Test timed out after 0.4 seconds.', '-1: Some tests failed.']));
+ await test.shouldExit(1);
+ });
+
+ test('times out teardown callbacks', () async {
+ await d.file('test.dart', '''
+import 'dart:async';
+
+import 'package:test/test.dart';
+
+void main() {
+ tearDown(() async {
+ await Completer<void>().future;
+ });
+
+ test('timeout in teardown', () async {
+ // nothing
+ });
+}
+''').create();
+
+ var test = await runTest(['--timeout=50ms', 'test.dart']);
+ expect(
+ test.stdout,
+ containsInOrder(
+ ['Test timed out after 0 seconds.', '-1: Some tests failed.']));
+ await test.shouldExit(1);
+ });
+
+ test('times out after failing test', () async {
+ await d.file('test.dart', '''
+import 'dart:async';
+
+import 'package:test/test.dart';
+
+void main() {
+ tearDown(() async {
+ await Completer<void>().future;
+ });
+
+ test('timeout in teardown', () async {
+ expect(true, false);
+ });
+}
+''').create();
+
+ var test = await runTest(['--timeout=50ms', 'test.dart']);
+ expect(
+ test.stdout,
+ containsInOrder(
+ ['Test timed out after 0 seconds.', '-1: Some tests failed.']));
+ await test.shouldExit(1);
+ });
+
+ test('are ignored with --ignore-timeouts', () async {
+ await d.file('test.dart', '''
+@Timeout(const Duration(seconds: 0))
+
+import 'dart:async';
+
+import 'package:test/test.dart';
+
+void main() {
+ test("timeout", () async {
+ await Future.delayed(Duration(milliseconds: 10));
+ });
+}
+''').create();
+
+ var test = await runTest(['test.dart', '--ignore-timeouts']);
+ expect(test.stdout, containsInOrder(['+1: All tests passed!']));
+ await test.shouldExit(0);
+ });
+}
diff --git a/pkgs/test/test/util/one_off_handler_test.dart b/pkgs/test/test/util/one_off_handler_test.dart
new file mode 100644
index 0000000..c10a7af
--- /dev/null
+++ b/pkgs/test/test/util/one_off_handler_test.dart
@@ -0,0 +1,74 @@
+// Copyright (c) 2015, 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:shelf/shelf.dart' as shelf;
+import 'package:test/src/util/one_off_handler.dart';
+import 'package:test/test.dart';
+
+void main() {
+ late OneOffHandler handler;
+ setUp(() => handler = OneOffHandler());
+
+ Future<shelf.Response> handle(shelf.Request request) =>
+ Future.sync(() => handler.handler(request));
+
+ test('returns a 404 for a root URL', () async {
+ var request = shelf.Request('GET', Uri.parse('http://localhost/'));
+ expect((await handle(request)).statusCode, equals(404));
+ });
+
+ test('returns a 404 for an unhandled URL', () async {
+ var request = shelf.Request('GET', Uri.parse('http://localhost/1'));
+ expect((await handle(request)).statusCode, equals(404));
+ });
+
+ test('passes a request to a handler only once', () async {
+ var path = handler.create(expectAsync1((request) {
+ expect(request.method, equals('GET'));
+ return shelf.Response.ok('good job!');
+ }));
+
+ var request = shelf.Request('GET', Uri.parse('http://localhost/$path'));
+ var response = await handle(request);
+ expect(response.statusCode, equals(200));
+ expect(response.readAsString(), completion(equals('good job!')));
+
+ request = shelf.Request('GET', Uri.parse('http://localhost/$path'));
+ expect((await handle(request)).statusCode, equals(404));
+ });
+
+ test('passes requests to the correct handlers', () async {
+ var path1 = handler.create(expectAsync1((request) {
+ expect(request.method, equals('GET'));
+ return shelf.Response.ok('one');
+ }));
+
+ var path2 = handler.create(expectAsync1((request) {
+ expect(request.method, equals('GET'));
+ return shelf.Response.ok('two');
+ }));
+
+ var path3 = handler.create(expectAsync1((request) {
+ expect(request.method, equals('GET'));
+ return shelf.Response.ok('three');
+ }));
+
+ var request = shelf.Request('GET', Uri.parse('http://localhost/$path2'));
+ var response = await handle(request);
+ expect(response.statusCode, equals(200));
+ expect(response.readAsString(), completion(equals('two')));
+
+ request = shelf.Request('GET', Uri.parse('http://localhost/$path1'));
+ response = await handle(request);
+ expect(response.statusCode, equals(200));
+ expect(response.readAsString(), completion(equals('one')));
+
+ request = shelf.Request('GET', Uri.parse('http://localhost/$path3'));
+ response = await handle(request);
+ expect(response.statusCode, equals(200));
+ expect(response.readAsString(), completion(equals('three')));
+ });
+}
diff --git a/pkgs/test/test/util/path_handler_test.dart b/pkgs/test/test/util/path_handler_test.dart
new file mode 100644
index 0000000..9a5d98b
--- /dev/null
+++ b/pkgs/test/test/util/path_handler_test.dart
@@ -0,0 +1,78 @@
+// Copyright (c) 2015, 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:shelf/shelf.dart' as shelf;
+import 'package:test/src/util/path_handler.dart';
+import 'package:test/test.dart';
+
+void main() {
+ late PathHandler handler;
+ setUp(() => handler = PathHandler());
+
+ Future<shelf.Response> localHandler(shelf.Request request) =>
+ Future.sync(() => handler.handler(request));
+
+ test('returns a 404 for a root URL', () async {
+ var request = shelf.Request('GET', Uri.parse('http://localhost/'));
+ expect((await localHandler(request)).statusCode, equals(404));
+ });
+
+ test('returns a 404 for an unregistered URL', () async {
+ var request = shelf.Request('GET', Uri.parse('http://localhost/foo'));
+ expect((await localHandler(request)).statusCode, equals(404));
+ });
+
+ test('runs a handler for an exact URL', () async {
+ var request = shelf.Request('GET', Uri.parse('http://localhost/foo'));
+ handler.add('foo', expectAsync1((request) {
+ expect(request.handlerPath, equals('/foo'));
+ expect(request.url.path, isEmpty);
+ return shelf.Response.ok('good job!');
+ }));
+
+ var response = await localHandler(request);
+ expect(response.statusCode, equals(200));
+ expect(response.readAsString(), completion(equals('good job!')));
+ });
+
+ test('runs a handler for a suffix', () async {
+ var request = shelf.Request('GET', Uri.parse('http://localhost/foo/bar'));
+ handler.add('foo', expectAsync1((request) {
+ expect(request.handlerPath, equals('/foo/'));
+ expect(request.url.path, 'bar');
+ return shelf.Response.ok('good job!');
+ }));
+
+ var response = await localHandler(request);
+ expect(response.statusCode, equals(200));
+ expect(response.readAsString(), completion(equals('good job!')));
+ });
+
+ test('runs the longest matching handler', () async {
+ var request =
+ shelf.Request('GET', Uri.parse('http://localhost/foo/bar/baz'));
+
+ handler.add(
+ 'foo',
+ expectAsync1((_) {
+ return shelf.Response.notFound('fake');
+ }, count: 0));
+ handler.add('foo/bar', expectAsync1((request) {
+ expect(request.handlerPath, equals('/foo/bar/'));
+ expect(request.url.path, 'baz');
+ return shelf.Response.ok('good job!');
+ }));
+ handler.add(
+ 'foo/bar/baz/bang',
+ expectAsync1((_) {
+ return shelf.Response.notFound('fake');
+ }, count: 0));
+
+ var response = await localHandler(request);
+ expect(response.statusCode, equals(200));
+ expect(response.readAsString(), completion(equals('good job!')));
+ });
+}
diff --git a/pkgs/test/test/util/string_literal_iterator_test.dart b/pkgs/test/test/util/string_literal_iterator_test.dart
new file mode 100644
index 0000000..03c8e34
--- /dev/null
+++ b/pkgs/test/test/util/string_literal_iterator_test.dart
@@ -0,0 +1,250 @@
+// Copyright (c) 2015, 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.
+
+@TestOn('vm')
+library;
+
+import 'package:analyzer/dart/analysis/utilities.dart';
+import 'package:analyzer/dart/ast/ast.dart';
+import 'package:test/test.dart';
+import 'package:test_core/src/util/string_literal_iterator.dart';
+
+final _offset = 'final str = '.length;
+
+void main() {
+ group('returns simple characters in', () {
+ test('a single simple string', () {
+ var iter = _parse('"abc"');
+
+ expect(() => iter.current, throwsA(isA<TypeError>()));
+ expect(iter.offset, equals(_offset));
+
+ expect(iter.moveNext(), isTrue);
+ expect(iter.current, _isRune('a'));
+ expect(iter.offset, equals(_offset + 1));
+
+ expect(iter.moveNext(), isTrue);
+ expect(iter.current, _isRune('b'));
+ expect(iter.offset, equals(_offset + 2));
+
+ expect(iter.moveNext(), isTrue);
+ expect(iter.current, _isRune('c'));
+ expect(iter.offset, equals(_offset + 3));
+
+ expect(iter.moveNext(), isFalse);
+ expect(() => iter.current, throwsA(isA<TypeError>()));
+ expect(iter.offset, equals(_offset + 4));
+ });
+
+ test('a raw string', () {
+ var iter = _parse('r"abc"');
+
+ expect(() => iter.current, throwsA(isA<TypeError>()));
+ expect(iter.offset, equals(_offset + 1));
+
+ expect(iter.moveNext(), isTrue);
+ expect(iter.current, _isRune('a'));
+ expect(iter.offset, equals(_offset + 2));
+
+ expect(iter.moveNext(), isTrue);
+ expect(iter.current, _isRune('b'));
+ expect(iter.offset, equals(_offset + 3));
+
+ expect(iter.moveNext(), isTrue);
+ expect(iter.current, _isRune('c'));
+ expect(iter.offset, equals(_offset + 4));
+
+ expect(iter.moveNext(), isFalse);
+ expect(() => iter.current, throwsA(isA<TypeError>()));
+ expect(iter.offset, equals(_offset + 5));
+ });
+
+ test('a multiline string', () {
+ var iter = _parse('"""ab\ncd"""');
+
+ expect(() => iter.current, throwsA(isA<TypeError>()));
+ expect(iter.offset, equals(_offset + 2));
+
+ expect(iter.moveNext(), isTrue);
+ expect(iter.current, _isRune('a'));
+ expect(iter.offset, equals(_offset + 3));
+
+ expect(iter.moveNext(), isTrue);
+ expect(iter.current, _isRune('b'));
+ expect(iter.offset, equals(_offset + 4));
+
+ expect(iter.moveNext(), isTrue);
+ expect(iter.current, _isRune('\n'));
+ expect(iter.offset, equals(_offset + 5));
+
+ expect(iter.moveNext(), isTrue);
+ expect(iter.current, _isRune('c'));
+ expect(iter.offset, equals(_offset + 6));
+
+ expect(iter.moveNext(), isTrue);
+ expect(iter.current, _isRune('d'));
+ expect(iter.offset, equals(_offset + 7));
+
+ expect(iter.moveNext(), isFalse);
+ expect(() => iter.current, throwsA(isA<TypeError>()));
+ expect(iter.offset, equals(_offset + 8));
+ });
+
+ test('a raw multiline string', () {
+ var iter = _parse('r"""ab\ncd"""');
+
+ expect(() => iter.current, throwsA(isA<TypeError>()));
+ expect(iter.offset, equals(_offset + 3));
+
+ expect(iter.moveNext(), isTrue);
+ expect(iter.current, _isRune('a'));
+ expect(iter.offset, equals(_offset + 4));
+
+ expect(iter.moveNext(), isTrue);
+ expect(iter.current, _isRune('b'));
+ expect(iter.offset, equals(_offset + 5));
+
+ expect(iter.moveNext(), isTrue);
+ expect(iter.current, _isRune('\n'));
+ expect(iter.offset, equals(_offset + 6));
+
+ expect(iter.moveNext(), isTrue);
+ expect(iter.current, _isRune('c'));
+ expect(iter.offset, equals(_offset + 7));
+
+ expect(iter.moveNext(), isTrue);
+ expect(iter.current, _isRune('d'));
+ expect(iter.offset, equals(_offset + 8));
+
+ expect(iter.moveNext(), isFalse);
+ expect(() => iter.current, throwsA(isA<TypeError>()));
+ expect(iter.offset, equals(_offset + 9));
+ });
+
+ test('adjacent strings', () {
+ var iter = _parse('"ab" r"cd" """ef\ngh"""');
+
+ expect(() => iter.current, throwsA(isA<TypeError>()));
+ expect(iter.offset, equals(_offset));
+
+ expect(iter.moveNext(), isTrue);
+ expect(iter.current, _isRune('a'));
+ expect(iter.offset, equals(_offset + 1));
+
+ expect(iter.moveNext(), isTrue);
+ expect(iter.current, _isRune('b'));
+ expect(iter.offset, equals(_offset + 2));
+
+ expect(iter.moveNext(), isTrue);
+ expect(iter.current, _isRune('c'));
+ expect(iter.offset, equals(_offset + 7));
+
+ expect(iter.moveNext(), isTrue);
+ expect(iter.current, _isRune('d'));
+ expect(iter.offset, equals(_offset + 8));
+
+ expect(iter.moveNext(), isTrue);
+ expect(iter.current, _isRune('e'));
+ expect(iter.offset, equals(_offset + 14));
+
+ expect(iter.moveNext(), isTrue);
+ expect(iter.current, _isRune('f'));
+ expect(iter.offset, equals(_offset + 15));
+
+ expect(iter.moveNext(), isTrue);
+ expect(iter.current, _isRune('\n'));
+ expect(iter.offset, equals(_offset + 16));
+
+ expect(iter.moveNext(), isTrue);
+ expect(iter.current, _isRune('g'));
+ expect(iter.offset, equals(_offset + 17));
+
+ expect(iter.moveNext(), isTrue);
+ expect(iter.current, _isRune('h'));
+ expect(iter.offset, equals(_offset + 18));
+
+ expect(iter.moveNext(), isFalse);
+ expect(() => iter.current, throwsA(isA<TypeError>()));
+ expect(iter.offset, equals(_offset + 19));
+ });
+ });
+
+ group('parses an escape sequence for', () {
+ test('a newline', () => _expectEscape(r'\n', '\n'));
+ test('a carriage return', () => _expectEscape(r'\r', '\r'));
+ test('a form feed', () => _expectEscape(r'\f', '\f'));
+ test('a backspace', () => _expectEscape(r'\b', '\b'));
+ test('a tab', () => _expectEscape(r'\t', '\t'));
+ test('a vertical tab', () => _expectEscape(r'\v', '\v'));
+ test('a quote', () => _expectEscape(r'\"', '"'));
+ test('a backslash', () => _expectEscape(r'\\', '\\'));
+
+ test('a hex character', () {
+ _expectEscape(r'\x62', 'b');
+ _expectEscape(r'\x7A', 'z');
+ _expectEscape(r'\x7a', 'z');
+ });
+
+ test('a fixed-length unicode character',
+ () => _expectEscape(r'\u0062', 'b'));
+
+ test('a short variable-length unicode character',
+ () => _expectEscape(r'\u{62}', 'b'));
+
+ test('a long variable-length unicode character',
+ () => _expectEscape(r'\u{000062}', 'b'));
+ });
+
+ group('throws an ArgumentError for', () {
+ test('interpolation', () {
+ expect(() => _parse(r'"$foo"'), throwsArgumentError);
+ });
+
+ test('interpolation in an adjacent string', () {
+ expect(() => _parse(r'"foo" "$bar" "baz"'), throwsArgumentError);
+ });
+ });
+}
+
+/// Asserts that [escape] is parsed as [value].
+void _expectEscape(String escape, String value) {
+ var iter = _parse('"a${escape}b"');
+
+ expect(() => iter.current, throwsA(isA<TypeError>()));
+ expect(iter.offset, equals(_offset));
+
+ expect(iter.moveNext(), isTrue);
+ expect(iter.current, _isRune('a'));
+ expect(iter.offset, equals(_offset + 1));
+
+ expect(iter.moveNext(), isTrue);
+ expect(iter.current, _isRune(value));
+ expect(iter.offset, equals(_offset + 2));
+
+ expect(iter.moveNext(), isTrue);
+ expect(iter.current, _isRune('b'));
+ expect(iter.offset, equals(_offset + escape.length + 2));
+
+ expect(iter.moveNext(), isFalse);
+ expect(() => iter.current, throwsA(isA<TypeError>()));
+ expect(iter.offset, equals(_offset + escape.length + 3));
+}
+
+/// Returns a matcher that asserts that the given rune is the rune for [char].
+Matcher _isRune(String char) {
+ return predicate((rune) {
+ return rune is int && String.fromCharCode(rune) == char;
+ }, 'is the rune "$char"');
+}
+
+/// Parses [dart], which should be a string literal, into a
+/// [StringLiteralIterator].
+StringLiteralIterator _parse(String dart) {
+ var declaration = parseString(content: 'final str = $dart;')
+ .unit
+ .declarations
+ .single as TopLevelVariableDeclaration;
+ var literal = declaration.variables.variables.single.initializer;
+ return StringLiteralIterator(literal as StringLiteral);
+}
diff --git a/pkgs/test/test/utils.dart b/pkgs/test/test/utils.dart
new file mode 100644
index 0000000..23d5b7e
--- /dev/null
+++ b/pkgs/test/test/utils.dart
@@ -0,0 +1,287 @@
+// Copyright (c) 2015, 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 'dart:collection';
+
+import 'package:boolean_selector/boolean_selector.dart';
+import 'package:glob/glob.dart';
+import 'package:test/test.dart';
+import 'package:test_api/src/backend/declarer.dart';
+import 'package:test_api/src/backend/group.dart';
+import 'package:test_api/src/backend/group_entry.dart';
+import 'package:test_api/src/backend/live_test.dart';
+import 'package:test_api/src/backend/platform_selector.dart';
+import 'package:test_api/src/backend/runtime.dart';
+import 'package:test_api/src/backend/state.dart';
+import 'package:test_api/src/backend/suite_platform.dart';
+import 'package:test_core/src/runner/application_exception.dart';
+import 'package:test_core/src/runner/compiler_selection.dart';
+import 'package:test_core/src/runner/configuration.dart';
+import 'package:test_core/src/runner/configuration/custom_runtime.dart';
+import 'package:test_core/src/runner/configuration/runtime_settings.dart';
+import 'package:test_core/src/runner/engine.dart';
+import 'package:test_core/src/runner/load_suite.dart';
+import 'package:test_core/src/runner/plugin/environment.dart';
+import 'package:test_core/src/runner/runner_suite.dart';
+import 'package:test_core/src/runner/runtime_selection.dart';
+import 'package:test_core/src/runner/suite.dart';
+
+/// A dummy suite platform to use for testing suites.
+final suitePlatform = SuitePlatform(Runtime.vm, compiler: null);
+
+// The last state change detected via [expectStates].
+State? _lastState;
+
+/// Asserts that exactly [states] will be emitted via [liveTest.onStateChange].
+///
+/// The most recent emitted state is stored in [_lastState].
+void expectStates(LiveTest liveTest, Iterable<State> statesIter) {
+ var states = Queue.of(statesIter);
+ liveTest.onStateChange.listen(expectAsync1((state) {
+ _lastState = state;
+ expect(state, equals(states.removeFirst()));
+ }, count: states.length, max: states.length));
+}
+
+/// Asserts that errors will be emitted via [liveTest.onError] that match
+/// [validators], in order.
+void expectErrors(
+ LiveTest liveTest, Iterable<void Function(Object)> validatorsIter) {
+ var validators = Queue.of(validatorsIter);
+ liveTest.onError.listen(expectAsync1((error) {
+ validators.removeFirst()(error.error);
+ }, count: validators.length, max: validators.length));
+}
+
+/// Asserts that [liveTest] will have a single failure with message `"oh no"`.
+void expectSingleFailure(LiveTest liveTest) {
+ expectStates(liveTest, [
+ const State(Status.running, Result.success),
+ const State(Status.complete, Result.failure)
+ ]);
+
+ expectErrors(liveTest, [
+ (error) {
+ expect(_lastState!.status, equals(Status.complete));
+ expect(error, _isTestFailure('oh no'));
+ }
+ ]);
+}
+
+/// 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 [ApplicationException] with the given
+/// [message].
+///
+/// [message] can be a string or a [Matcher].
+Matcher isApplicationException(Object message) =>
+ const TypeMatcher<ApplicationException>()
+ .having((e) => e.message, 'message', message);
+
+/// Asserts that [liveTest] has completed and passed.
+///
+/// If the test had any errors, they're surfaced nicely into the outer test.
+void expectTestPassed(LiveTest liveTest) {
+ // Since the test is expected to pass, we forward any current or future errors
+ // to the outer test, because they're definitely unexpected.
+ for (var error in liveTest.errors) {
+ registerException(error.error, error.stackTrace);
+ }
+ liveTest.onError.listen((error) {
+ registerException(error.error, error.stackTrace);
+ });
+
+ expect(liveTest.state.status, equals(Status.complete));
+ expect(liveTest.state.result, equals(Result.success));
+}
+
+/// Asserts that [liveTest] failed with a single [TestFailure] whose message
+/// matches [message].
+void expectTestFailed(LiveTest liveTest, Object message) {
+ expect(liveTest.state.status, equals(Status.complete));
+ expect(liveTest.state.result, equals(Result.failure));
+ expect(liveTest.errors, hasLength(1));
+ expect(liveTest.errors.first.error, _isTestFailure(message));
+}
+
+/// Runs [body] with a declarer and returns the declared entries.
+List<GroupEntry> declare(void Function() body) {
+ var declarer = Declarer()..declare(body);
+ return declarer.build().entries;
+}
+
+/// Runs [body] with a declarer and returns an engine that runs those tests.
+Engine declareEngine(
+ void Function() body, {
+ bool runSkipped = false,
+ String? coverage,
+ bool stopOnFirstFailure = false,
+}) {
+ var declarer = Declarer()..declare(body);
+ return Engine.withSuites(
+ [
+ RunnerSuite(
+ const PluginEnvironment(),
+ SuiteConfiguration.runSkipped(runSkipped),
+ declarer.build(),
+ suitePlatform)
+ ],
+ coverage: coverage,
+ stopOnFirstFailure: stopOnFirstFailure,
+ );
+}
+
+/// Returns a [RunnerSuite] with a default environment and configuration.
+RunnerSuite runnerSuite(Group root) => RunnerSuite(
+ const PluginEnvironment(), SuiteConfiguration.empty, root, suitePlatform);
+
+/// Returns a [LoadSuite] with a default configuration.
+LoadSuite loadSuite(String name, FutureOr<RunnerSuite> Function() body) =>
+ LoadSuite(name, SuiteConfiguration.empty, suitePlatform, body);
+
+SuiteConfiguration suiteConfiguration(
+ {bool? allowDuplicateTestNames,
+ bool? allowTestRandomization,
+ bool? jsTrace,
+ bool? runSkipped,
+ Iterable<String>? dart2jsArgs,
+ String? precompiledPath,
+ Iterable<CompilerSelection>? compilerSelections,
+ Iterable<RuntimeSelection>? runtimes,
+ Map<BooleanSelector, SuiteConfiguration>? tags,
+ Map<PlatformSelector, SuiteConfiguration>? onPlatform,
+ bool? ignoreTimeouts,
+
+ // Test-level configuration
+ Timeout? timeout,
+ bool? verboseTrace,
+ bool? chainStackTraces,
+ bool? skip,
+ int? retry,
+ String? skipReason,
+ PlatformSelector? testOn,
+ Iterable<String>? addTags}) =>
+ SuiteConfiguration(
+ allowDuplicateTestNames: allowDuplicateTestNames,
+ allowTestRandomization: allowTestRandomization,
+ jsTrace: jsTrace,
+ runSkipped: runSkipped,
+ dart2jsArgs: dart2jsArgs,
+ precompiledPath: precompiledPath,
+ compilerSelections: compilerSelections,
+ runtimes: runtimes,
+ tags: tags,
+ onPlatform: onPlatform,
+ ignoreTimeouts: ignoreTimeouts,
+ timeout: timeout,
+ verboseTrace: verboseTrace,
+ chainStackTraces: chainStackTraces,
+ skip: skip,
+ retry: retry,
+ skipReason: skipReason,
+ testOn: testOn,
+ addTags: addTags);
+
+Configuration configuration(
+ {bool? help,
+ String? customHtmlTemplatePath,
+ bool? version,
+ bool? pauseAfterLoad,
+ bool? debug,
+ bool? color,
+ String? configurationPath,
+ String? reporter,
+ Map<String, String>? fileReporters,
+ String? coverage,
+ int? concurrency,
+ int? shardIndex,
+ int? totalShards,
+ Map<String, Set<TestSelection>>? testSelections,
+ Iterable<String>? foldTraceExcept,
+ Iterable<String>? foldTraceOnly,
+ Glob? filename,
+ Iterable<String>? chosenPresets,
+ Map<String, Configuration>? presets,
+ Map<String, RuntimeSettings>? overrideRuntimes,
+ Map<String, CustomRuntime>? defineRuntimes,
+ bool? noRetry,
+ bool? ignoreTimeouts,
+
+ // Suite-level configuration
+ bool? allowDuplicateTestNames,
+ bool? allowTestRandomization,
+ bool? jsTrace,
+ bool? runSkipped,
+ Iterable<String>? dart2jsArgs,
+ String? precompiledPath,
+ Iterable<Pattern>? globalPatterns,
+ Iterable<CompilerSelection>? compilerSelections,
+ Iterable<RuntimeSelection>? runtimes,
+ BooleanSelector? includeTags,
+ BooleanSelector? excludeTags,
+ Map<BooleanSelector, SuiteConfiguration>? tags,
+ Map<PlatformSelector, SuiteConfiguration>? onPlatform,
+ int? testRandomizeOrderingSeed,
+
+ // Test-level configuration
+ Timeout? timeout,
+ bool? verboseTrace,
+ bool? chainStackTraces,
+ bool? skip,
+ int? retry,
+ String? skipReason,
+ PlatformSelector? testOn,
+ Iterable<String>? addTags}) =>
+ Configuration(
+ help: help,
+ customHtmlTemplatePath: customHtmlTemplatePath,
+ version: version,
+ pauseAfterLoad: pauseAfterLoad,
+ debug: debug,
+ color: color,
+ configurationPath: configurationPath,
+ reporter: reporter,
+ fileReporters: fileReporters,
+ coverage: coverage,
+ concurrency: concurrency,
+ shardIndex: shardIndex,
+ totalShards: totalShards,
+ testSelections: testSelections,
+ foldTraceExcept: foldTraceExcept,
+ foldTraceOnly: foldTraceOnly,
+ filename: filename,
+ chosenPresets: chosenPresets,
+ presets: presets,
+ overrideRuntimes: overrideRuntimes,
+ defineRuntimes: defineRuntimes,
+ noRetry: noRetry,
+ ignoreTimeouts: ignoreTimeouts,
+ allowDuplicateTestNames: allowDuplicateTestNames,
+ allowTestRandomization: allowTestRandomization,
+ jsTrace: jsTrace,
+ runSkipped: runSkipped,
+ dart2jsArgs: dart2jsArgs,
+ precompiledPath: precompiledPath,
+ globalPatterns: globalPatterns,
+ compilerSelections: compilerSelections,
+ runtimes: runtimes,
+ includeTags: includeTags,
+ excludeTags: excludeTags,
+ tags: tags,
+ onPlatform: onPlatform,
+ testRandomizeOrderingSeed: testRandomizeOrderingSeed,
+ stopOnFirstFailure: false,
+ timeout: timeout,
+ verboseTrace: verboseTrace,
+ chainStackTraces: chainStackTraces,
+ skip: skip,
+ retry: retry,
+ skipReason: skipReason,
+ testOn: testOn,
+ addTags: addTags);
diff --git a/pkgs/test/tool/README.md b/pkgs/test/tool/README.md
new file mode 100644
index 0000000..bd9ee8b
--- /dev/null
+++ b/pkgs/test/tool/README.md
@@ -0,0 +1,7 @@
+`host.dart` is the source for `lib/src/runner/browser/static/host.dart.js`.
+
+To updated it, run:
+
+```console
+dart compile js tool/host.dart -o lib/src/runner/browser/static/host.dart.js
+```
diff --git a/pkgs/test/tool/host.dart b/pkgs/test/tool/host.dart
new file mode 100644
index 0000000..dc3e5ab
--- /dev/null
+++ b/pkgs/test/tool/host.dart
@@ -0,0 +1,252 @@
+// Copyright (c) 2015, 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.
+
+@JS()
+library;
+
+import 'dart:async';
+import 'dart:convert';
+
+import 'package:js/js.dart';
+import 'package:stack_trace/stack_trace.dart';
+import 'package:stream_channel/stream_channel.dart';
+import 'package:test/src/runner/browser/dom.dart' as dom;
+
+/// A class that exposes the test API to JS.
+///
+/// These are exposed so that tools like IDEs can interact with them via remote
+/// debugging.
+@JS()
+@anonymous
+@staticInterop
+class _JSApi {
+ external factory _JSApi(
+ {void Function() resume, void Function() restartCurrent});
+}
+
+extension _JSApiExtension on _JSApi {
+ /// Causes the test runner to resume running, as though the user had clicked
+ /// the "play" button.
+ // ignore: unused_element
+ external Function get resume;
+
+ /// Causes the test runner to restart the current test once it finishes
+ /// running.
+ // ignore: unused_element
+ external Function get restartCurrent;
+}
+
+/// Sets the top-level `dartTest` object so that it's visible to JS.
+@JS('dartTest')
+external set _jsApi(_JSApi api);
+
+/// The iframes created for each loaded test suite, indexed by the suite id.
+final _iframes = <int, dom.HTMLIFrameElement>{};
+
+/// Subscriptions created for each loaded test suite, indexed by the suite id.
+final _subscriptions = <int, StreamSubscription<void>>{};
+final _domSubscriptions = <int, dom.Subscription>{};
+
+/// The URL for the current page.
+final _currentUrl = Uri.parse(dom.window.location.href);
+
+/// Code that runs in the browser and loads test suites at the server's behest.
+///
+/// One instance of this runs for each browser. When the server tells it to load
+/// a test, it starts an iframe pointing at that test's code; from then on, it
+/// just relays messages between the two.
+///
+/// The browser uses two layers of [MultiChannel]s when communicating with the
+/// server:
+///
+/// server
+/// │
+/// (WebSocket)
+/// │
+/// ┏━ host.html ━━━━━━━━┿━━━━━━━━━━━━━━━━━┓
+/// ┃ │ ┃
+/// ┃ ┌──────┬───MultiChannel─────┐ ┃
+/// ┃ │ │ │ │ │ ┃
+/// ┃ host suite suite suite suite ┃
+/// ┃ │ │ │ │ ┃
+/// ┗━━━━━━━━━━━┿━━━━━━┿━━━━━━┿━━━━━━┿━━━━━┛
+/// │ │ │ │
+/// │ ... ... ...
+/// │
+/// (MessageChannel)
+/// │
+/// ┏━ suite.html (in iframe) ┿━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+/// ┃ │ ┃
+/// ┃ ┌──────────MultiChannel┬─────────┐ ┃
+/// ┃ │ │ │ │ │ ┃
+/// ┃ RemoteListener test test test running test ┃
+/// ┃ ┃
+/// ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
+///
+/// The host (this code) has a [MultiChannel] that splits the WebSocket
+/// connection with the server. One connection is used for the host itself to
+/// receive messages like "load a suite at this URL", and the rest are
+/// connected to each test suite's iframe via a [MessageChannel].
+///
+/// Each iframe runs a `RemoteListener` which creates its own [MultiChannel] on
+/// top of a [MessageChannel] connection. One connection is used for
+/// the `RemoteListener`, which sends messages like "here are all the tests in
+/// this suite". The rest are used for each test, receiving messages like
+/// "start running". A new connection is also created whenever a test begins
+/// running to send status messages about its progress.
+///
+/// It's of particular note that the suite's [MultiChannel] connection uses the
+/// host's purely as a transport layer; neither is aware that the other is also
+/// using [MultiChannel]. This is necessary, since the host doesn't share memory
+/// with the suites and thus can't share its [MultiChannel] with them, but it
+/// does mean that the server needs to be sure to nest its [MultiChannel]s at
+/// the same place the client does.
+void main() {
+ dom.window.console.log('Dart test runner browser host running');
+ if (_currentUrl.queryParameters['debug'] == 'true') {
+ dom.document.body!.classList.add('debug');
+ }
+
+ runZonedGuarded(() {
+ var serverChannel = _connectToServer();
+ serverChannel.stream.listen((message) {
+ switch (message) {
+ case {
+ 'command': 'loadSuite',
+ 'channel': final num channel,
+ 'url': final String url,
+ 'id': final num id
+ }:
+ var suiteChannel = serverChannel.virtualChannel(channel.toInt());
+ var iframeChannel = _connectToIframe(url, id.toInt());
+ suiteChannel.pipe(iframeChannel);
+ case {'command': 'displayPause'}:
+ dom.document.body!.classList.add('paused');
+ case {'command': 'resume'}:
+ dom.document.body!.classList.remove('paused');
+ case {'command': 'closeSuite', 'id': final id}:
+ _iframes.remove(id)!.remove();
+ _subscriptions.remove(id)?.cancel();
+ _domSubscriptions.remove(id)?.cancel();
+ default:
+ dom.window.console
+ .warn('Unhandled message from test runner: $message');
+ }
+ });
+
+ // Send periodic pings to the test runner so it can know when the browser is
+ // paused for debugging.
+ Timer.periodic(const Duration(seconds: 1),
+ (_) => serverChannel.sink.add({'command': 'ping'}));
+
+ var play = dom.document.querySelector('#play');
+ play!.addEventListener('click', allowInterop((_) {
+ if (!dom.document.body!.classList.contains('paused')) return;
+ dom.document.body!.classList.remove('paused');
+ serverChannel.sink.add({'command': 'resume'});
+ }));
+
+ _jsApi = _JSApi(resume: allowInterop(() {
+ if (!dom.document.body!.classList.contains('paused')) return;
+ dom.document.body!.classList.remove('paused');
+ serverChannel.sink.add({'command': 'resume'});
+ }), restartCurrent: allowInterop(() {
+ serverChannel.sink.add({'command': 'restart'});
+ }));
+ }, (error, stackTrace) {
+ dom.window.console.warn('$error\n${Trace.from(stackTrace).terse}');
+ });
+}
+
+/// Creates a [MultiChannel] connection to the server, using a [WebSocket] as
+/// the underlying protocol.
+MultiChannel<dynamic> _connectToServer() {
+ // The `managerUrl` query parameter contains the WebSocket URL of the remote
+ // [BrowserManager] with which this communicates.
+ var webSocket =
+ dom.createWebSocket(_currentUrl.queryParameters['managerUrl']!);
+
+ var controller = StreamChannelController<Object?>(sync: true);
+ webSocket.addEventListener('message', allowInterop((message) {
+ controller.local.sink
+ .add(jsonDecode((message as dom.MessageEvent).data as String));
+ }));
+
+ controller.local.stream
+ .listen((message) => webSocket.send(jsonEncode(message)));
+
+ return MultiChannel(controller.foreign);
+}
+
+/// Creates an iframe with `src` [url] and expects a message back to connect a
+/// message channel with the suite running in the frame.
+///
+/// [id] identifies the suite loaded in this iframe.
+///
+/// Before the frame is attached, adds a listener for `window.onMessage` which
+/// filters to only the messages coming from this frame (by it's URL) and
+/// expects the first message to be either an initialization message, (coming
+/// from the browser bootstrap message channel initialization), or a map with
+/// the key 'exception' set to true and details in the value for 'data' (coming
+/// from `dart.js` due to a load exception).
+///
+/// Legacy bootstrap implementations send a `{'ready': true}` message as a
+/// signal for this host to create a [MessageChannel] and send the port through
+/// the frame's `window.onMessage` channel.
+///
+/// Upcoming bootstrap implementations will send the string 'port' and include a
+/// port for a prepared [MessageChannel].
+///
+/// Returns a [StreamChannel] which will be connected to the frame once the
+/// message channel port is active.
+StreamChannel<dynamic> _connectToIframe(String url, int id) {
+ var suiteUrl = Uri.parse(url).removeFragment();
+ dom.window.console.log('Starting suite $suiteUrl');
+ var iframe = dom.createHTMLIFrameElement();
+ _iframes[id] = iframe;
+ var controller = StreamChannelController<Object?>(sync: true);
+
+ late dom.Subscription windowSubscription;
+ windowSubscription =
+ dom.Subscription(dom.window, 'message', allowInterop((dom.Event event) {
+ // A message on the Window can theoretically come from any website. It's
+ // very unlikely that a malicious site would care about hacking someone's
+ // unit tests, let alone be able to find the test server while it's
+ // running, but it's good practice to check the origin anyway.
+ var message = event as dom.MessageEvent;
+ if (message.origin != dom.window.location.origin) return;
+ // Disambiguate between frames for different test suites.
+ // Depending on the source type, the `location.href` may be missing.
+ if (message.source.location?.href != iframe.src) return;
+
+ message.stopPropagation();
+ windowSubscription.cancel();
+
+ switch (message.data) {
+ case 'port':
+ dom.window.console.log('Connecting channel for suite $suiteUrl');
+ // The frame is starting and sending a port to forward for the suite.
+ final port = message.ports.first;
+ assert(!_domSubscriptions.containsKey(id));
+ _domSubscriptions[id] =
+ dom.Subscription(port, 'message', allowInterop((event) {
+ controller.local.sink.add((event as dom.MessageEvent).data);
+ }));
+ port.start();
+
+ assert(!_subscriptions.containsKey(id));
+ _subscriptions[id] = controller.local.stream.listen(port.postMessage);
+ case {'exception': true, 'data': final data}:
+ // This message from `dart.js` indicates that an exception occurred
+ // loading the test.
+ controller.local.sink.add(data);
+ }
+ }));
+
+ iframe.src = url;
+ dom.document.body!.appendChild(iframe);
+ dom.window.console.log('Appended iframe with src $url');
+
+ return controller.foreign;
+}
diff --git a/pkgs/test_api/CHANGELOG.md b/pkgs/test_api/CHANGELOG.md
new file mode 100644
index 0000000..98d65ba
--- /dev/null
+++ b/pkgs/test_api/CHANGELOG.md
@@ -0,0 +1,339 @@
+## 0.7.4
+
+* Allow `analyzer: '>=6.0.0 <8.0.0'`
+* Increase SDK constraint to ^3.5.0.
+* Support running Node.js tests compiled with dart2wasm.
+
+## 0.7.3
+
+* Increase SDK constraint to ^3.4.0.
+
+## 0.7.2
+
+* Update min SDK constraint to 3.2.0.
+
+## 0.7.1
+
+- Added [`@doNotSubmit`](https://pub.dev/documentation/meta/latest/meta/doNotSubmit-constant.html) to `test(solo: ...)` and `group(solo: ...)`. In
+ practice, this means that code that was relying on ignoring deprecation
+ warnings and using `solo` or `group` with a `skip` parameter will now fail if
+ `dart analyze --fatal-infos` (or similar) is enabled.
+
+## 0.7.0
+
+- Deprecate `Runtime.internetExplorer`.
+- Added `dart2wasm` as a supported compiler for the `chrome` runtime.
+- **BREAKING**: Removed the `experimentalChromeWasm` runtime.
+- **BREAKING**: Removed `Runtime.isJS` and `Runtime.isWasm`, as this is now
+ based on the compiler and not the runtime.
+
+## 0.6.1
+
+- Drop support for null unsafe Dart, bump SDK constraint to `3.0.0`.
+- Make some implementation classes `final`. These classes were never intended to
+ be extended or implemented. `Metadata`, `PlatformSelector`, `RemoteListener`,
+ `Runtime`, `StackTraceFormatter`, `SuitePlatform`, `RemoteException`,
+ `TestHandle`, `OutstandingWork`, `OutsideTestException`, `OnPlatform`,
+ `Retry`, `Skip`, `Tags`, `TestOn`, `Timeout`.
+- Mark an implementation class `interface`: `StackTraceMapper`.
+- Change the `Compiler` class into an `enum`.
+- Make `Fake` a `mixin class`.
+- Allow the latest analyzer (6.x.x).
+
+## 0.6.0
+
+- Remove the `package:test_api/expect.dart' library. `test`will export from`package:matcher` directly.
+- Fix compatibility with wasm number semantics.
+
+## 0.5.2
+
+- Remove deprecation for the `scaffolding.dart` and `backend.dart` libraries.
+- Export `registerException` from the `scaffolding.dart` library.
+
+## 0.5.1
+
+- Handle a missing `'compiler'` value when running a test compiled against a
+ newer `test_api` than the runner back end is using. The expectation was that
+ the json protocol is only used across packages compatible with the same major
+ version of the `test_api` package, but `flutter test` does not check the
+ version of packages in the pub solve for user test code.
+
+## 0.5.0
+
+- Add `Compiler` class, exposed through `backend.dart`.
+- Support compiler identifiers in platform selectors.
+- Add `compiler` field to `SuitePlatform`. This will become required in the next
+ major release.
+- **BREAKING** Add required `defaultCompiler` and `supportedCompilers` fields
+ to `Runtime`.
+- Add `package:test_api/hooks_testing.dart` library for writing tests against
+ code that uses `package:test_api/hooks.dart`.
+- **BREAKING** Remove `ErrorFormatter`, `expectAsync`, `throws`, and `Throws`
+ from `package:test_api/test_api.dart`.
+
+## 0.4.18
+
+- Don't run `tearDown` until the test body and outstanding work is complete,
+ even if the test has already failed.
+
+## 0.4.17
+
+- Deprecate `throwsNullThrownError`, use `throwsA(isA<TypeError>())` instead.
+ The implementation has been changed to ease migrations.
+- Deprecate `throwsCyclicInitializationError` and replace the implementation
+ with `Throws(TypeMatcher<Error>())`. The specific exception no longer exists
+ and there is no guarantee about what type of error will be thrown.
+
+## 0.4.16
+
+- Add the `experimental-chrome-wasm` runtime. This is very unstable and will
+ eventually be deleted, to be replaced by a `--compiler` flag. See
+ https://github.com/dart-lang/test/issues/1776 for more information on future
+ plans
+- Add `isWasm` field to `Runtime` (defaults to `false`).
+
+## 0.4.15
+
+- Expand the pubspec description.
+- Support `package:matcher` version `0.12.13`.
+
+## 0.4.14
+
+- Require Dart >= 2.18.0
+- Support the latest `package:analyzer`.
+
+## 0.4.13
+
+- Fix `printOnFailure` output to be associated with the correct test.
+
+## 0.4.12
+
+- Internal cleanup.
+
+## 0.4.11
+
+- Support the latest version of `package:matcher`.
+
+## 0.4.10
+
+- Add `Target` to restrict `TestOn` annotation to library level.
+
+## 0.4.9
+
+- Add `ignoreTimeouts` option to `Suite`, which disables all timeouts for all
+ tests in that suite.
+
+## 0.4.8
+
+- `TestFailure` implements `Exception` for compatibility with
+ `only_throw_exceptions`.
+
+## 0.4.7
+
+- Remove logging about enabling the chain-stack-traces flag from the invoker.
+
+## 0.4.6
+
+- Give a better exception when using `markTestSkipped` outside of a test.
+- Format stack traces if a formatter is available when serializing tests
+ and groups from the remote listener.
+
+## 0.4.5
+
+- Add defaulting for older test backends that don't pass a configuration for
+ the `allow_duplicate_test_names` parameter to the remote listener.
+
+## 0.4.4
+
+- Allow disabling duplicate test or group names in the `Declarer`.
+
+## 0.4.3
+
+- Use the latest `package:matcher`.
+
+## 0.4.2
+
+- Update `analyzer` constraint to `>=1.5.0 <3.0.0`.
+
+## 0.4.1
+
+- Give a better error when `printOnFailure` is called from outside a test
+ zone.
+
+## 0.4.0
+
+- Add libraries `scaffolding.dart`, and `expect.dart` to allow importing as
+ subset of the normal surface area.
+- Add new APIs in `hooks.dart` to allow writing custom expectation frameworks
+ which integrate with the test runner.
+- Add examples to `throwsA` and make top-level `throws...` matchers refer to it.
+- Disable stack trace chaining by default.
+- Fix `expectAsync` function type checks.
+- Add `RemoteException`, `RemoteListener`, `StackTraceFormatter`, and
+ `StackTraceMapper` to `backend.dart`.
+- **Breaking** remove `Runtime.phantomJS`
+- **Breaking** Add callback to get the suite channel in the `beforeLoad`
+ callback of `RemoteListener.start`. This is now used in place of using zones
+ to communicate the value.
+
+## 0.3.0
+
+- **Breaking** `TestException.message` is now nullable.
+ - Fixes handling of `null` messages in remote exceptions.
+
+## 0.2.20
+
+- Fix some strong null safety mode errors in the original migration.
+
+## 0.2.19
+
+- Stable release for null safety.
+
+## 0.2.19-nullsafety.7
+
+- Expand upper bound constraints for some null safe migrated packages.
+
+## 0.2.19-nullsafety.6
+
+- Fix `spawnHybridUri` to respect language versioning of the spawned uri.
+
+## 0.2.19-nullsafety.5
+
+- Update SDK constraints to `>=2.12.0-0 <3.0.0` based on beta release
+ guidelines.
+
+## 0.2.19-nullsafety.4
+
+- Allow prerelease versions of the 2.12 sdk.
+
+## 0.2.19-nullsafety.3
+
+- Add capability to filter to a single exact test name in `Declarer`.
+- Add `markTestSkipped` API.
+
+## 0.2.19-nullsafety.2
+
+- Allow `2.10` stable and `2.11.0-dev` SDKs.
+- Annotate the classes used as annotations to restrict their usage to library
+ level.
+
+## 0.2.19-nullsafety
+
+- Migrate to NNBD.
+ - The vast majority of changes are intended to express the pre-existing
+ behavior of the code regarding to handling of nulls.
+ - **Breaking Change**: `GroupEntry.name` is no longer nullable, the root
+ group now has the empty string as its name.
+- Add the `Fake` class, available through `package:test_api/fake.dart`. This
+ was previously part of the Mockito package, but with null safety it is useful
+ enough that we decided to make it available through `package:test`. In a
+ future release it will be made available directly through
+ `package:test_api/test_api.dart` (and hence through
+ `package:test_core/test_core.dart` and `package:test/test.dart`).
+
+## 0.2.18+1 (Backport)
+
+- Fix `spawnHybridUri` to respect language versioning of the spawned uri.
+
+## 0.2.18
+
+- Update to `matcher` version `0.12.9`.
+
+## 0.2.17
+
+- Add `languageVersionComment` on the `MetaData` class. This should only be
+ present for test suites.
+
+## 0.2.16
+
+- Deprecate `LiveTestController.liveTest`, the `LiveTestController` instance now
+ implements `LiveTest` and can be used directly.
+
+## 0.2.15
+
+- Cancel any StreamQueue that is created as a part of a stream matcher once it
+ is done matching.
+ - This fixes a bug where using a matcher on a custom stream controller and
+ then awaiting the `close()` method on that controller would hang.
+- Avoid causing the test runner to hang if there is a timeout during a
+ `tearDown` callback following a failing test case.
+
+## 0.2.14
+
+- Bump minimum SDK to `2.4.0` for safer usage of for-loop elements.
+
+## 0.2.13
+
+- Work around a bug in the `2.3.0` SDK by avoiding for-loop elements at the top
+ level.
+
+## 0.2.12
+
+- Link to docs on setting timeout when a test times out with the default
+ duration.
+- No longer directly depend on `package:pedantic`.
+
+## 0.2.11
+
+- Extend the timeout for synthetic tests, e.g. `tearDownAll`.
+
+## 0.2.10
+
+- Update to latest `package:matcher`. Improves output for instances of private
+ classes.
+
+## 0.2.9
+
+- Treat non-solo tests as skipped so they are properly reported.
+
+## 0.2.8
+
+- Remove logic which accounted for a race condition in state change. The logic
+ was required because `package:sse` used to not guarantee order. This is no
+ longer the case.
+
+## 0.2.7
+
+- Prepare for upcoming `Stream<List<int>>` changes in the Dart SDK.
+- Mark `package:test_api` as deprecated to prevent accidental use.
+
+## 0.2.6
+
+- Don't swallow exceptions from callbacks in `expectAsync*`.
+- Internal cleanup - fix lints.
+- Fixed a race condition that caused tests to occasionally fail during
+ `tearDownAll` with the message `(tearDownAll) - did not complete [E]`.
+
+## 0.2.5
+
+- Expose the `Metadata`, `PlatformSelector`, `Runtime`, and `SuitePlatform`
+ classes publicly through a new `backend.dart` import.
+
+## 0.2.4
+
+- Allow `stream_channel` version `2.0.0`.
+
+## 0.2.3
+
+- Update to matcher version `0.12.5`.
+
+## 0.2.2
+
+- Require Dart SDK `>=2.1.0`.
+
+## 0.2.1
+
+- Add `remote_listener.dart` and `suite_channel_manager.dart`.
+
+## 0.2.0
+
+- Remove "runner" extensions.
+
+## 0.1.1
+
+- Update `stack_trace_formatter` to fold `test_api` frames by default.
+
+## 0.1.0
+
+- Initial release of `test_api`. Provides the basic API for writing tests and
+ touch points for implementing a custom test runner.
diff --git a/pkgs/test_api/LICENSE b/pkgs/test_api/LICENSE
new file mode 100644
index 0000000..9972f6e
--- /dev/null
+++ b/pkgs/test_api/LICENSE
@@ -0,0 +1,27 @@
+Copyright 2018, the Dart project authors.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+ * Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ * Redistributions in binary form must reproduce the above
+ copyright notice, this list of conditions and the following
+ disclaimer in the documentation and/or other materials provided
+ with the distribution.
+ * Neither the name of Google LLC nor the names of its
+ contributors may be used to endorse or promote products derived
+ from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
diff --git a/pkgs/test_api/README.md b/pkgs/test_api/README.md
new file mode 100644
index 0000000..aa1af49
--- /dev/null
+++ b/pkgs/test_api/README.md
@@ -0,0 +1,8 @@
+[](https://pub.dev/packages/test_api)
+[](https://pub.dev/packages/test_api/publisher)
+
+A minimal package for writing tests. At this time this package is not intended
+to be publicly used as the API will take time to stabilize.
+
+If you're interested in testing Dart code, you likely want to use
+[package:test](https://pub.dev/packages/test).
diff --git a/pkgs/test_api/dart_test.yaml b/pkgs/test_api/dart_test.yaml
new file mode 100644
index 0000000..faff3bb
--- /dev/null
+++ b/pkgs/test_api/dart_test.yaml
@@ -0,0 +1,46 @@
+# Fold frames from helper packages we use in our tests, but not from test
+# itself.
+fold_stack_frames:
+ except:
+ - shelf_test_handler
+ - stream_channel
+ - test_descriptor
+ - test_process
+
+presets:
+ # "-P terse-trace" folds frames from test's implementation to make the output
+ # less verbose when
+ terse-trace:
+ fold_stack_frames:
+ except: [test]
+
+tags:
+ browser:
+ timeout: 2x
+
+ # Browsers can sometimes randomly time out while starting, especially on
+ # Travis which is pretty slow. Don't retry locally because it makes
+ # debugging more annoying.
+ presets: {travis: {retry: 3}}
+
+ dart2js:
+ add_tags: [browser]
+ timeout: 2x
+
+ firefox: {add_tags: [dart2js]}
+ chrome: {add_tags: [dart2js]}
+ phantomjs: {add_tags: [dart2js]}
+
+ safari:
+ add_tags: [dart2js]
+ test_on: mac-os
+
+ # Tests that run pub. These tests may need to be excluded when there are local
+ # dependency_overrides.
+ pub:
+ timeout: 2x
+
+ # Tests that use Node.js. These tests may need to be excluded on systems that
+ # don't have Node installed.
+ node:
+ timeout: 2x
diff --git a/pkgs/test_api/lib/backend.dart b/pkgs/test_api/lib/backend.dart
new file mode 100644
index 0000000..5da47b6
--- /dev/null
+++ b/pkgs/test_api/lib/backend.dart
@@ -0,0 +1,13 @@
+// Copyright (c) 2019, 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.
+
+export 'src/backend/compiler.dart' show Compiler;
+export 'src/backend/metadata.dart' show Metadata;
+export 'src/backend/platform_selector.dart' show PlatformSelector;
+export 'src/backend/remote_exception.dart' show RemoteException;
+export 'src/backend/remote_listener.dart' show RemoteListener;
+export 'src/backend/runtime.dart' show Runtime;
+export 'src/backend/stack_trace_formatter.dart' show StackTraceFormatter;
+export 'src/backend/stack_trace_mapper.dart' show StackTraceMapper;
+export 'src/backend/suite_platform.dart' show SuitePlatform;
diff --git a/pkgs/test_api/lib/fake.dart b/pkgs/test_api/lib/fake.dart
new file mode 100644
index 0000000..f8b2d80
--- /dev/null
+++ b/pkgs/test_api/lib/fake.dart
@@ -0,0 +1,13 @@
+// Copyright (c) 2020, 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.
+
+// Note: eventually we would like to fold this into test_api.dart, but we can't
+// do so until Mockito stops implementing its own version of `Fake`, because
+// there is code in the wild that imports both test_api.dart and Mockito.
+
+@Deprecated('package:test_api is not intended for general use. '
+ 'Please use package:test.')
+library;
+
+export 'src/frontend/fake.dart';
diff --git a/pkgs/test_api/lib/hooks.dart b/pkgs/test_api/lib/hooks.dart
new file mode 100644
index 0000000..126d322
--- /dev/null
+++ b/pkgs/test_api/lib/hooks.dart
@@ -0,0 +1,82 @@
+// Copyright (c) 2021, 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:stack_trace/stack_trace.dart';
+
+import 'src/backend/closed_exception.dart';
+import 'src/backend/invoker.dart';
+import 'src/backend/stack_trace_formatter.dart';
+
+export 'src/backend/test_failure.dart' show TestFailure;
+export 'src/scaffolding/utils.dart' show pumpEventQueue;
+
+final class TestHandle {
+ /// Returns handle for the currently running test.
+ ///
+ /// This must be called from within the zone that the test is running in. If
+ /// the current zone is not a test's zone throws [OutsideTestException].
+ static TestHandle get current {
+ final invoker = Invoker.current;
+ if (invoker == null) throw OutsideTestException();
+ return TestHandle._(
+ invoker, StackTraceFormatter.current ?? _defaultFormatter);
+ }
+
+ static final _defaultFormatter = StackTraceFormatter();
+
+ final Invoker _invoker;
+ final StackTraceFormatter _stackTraceFormatter;
+ TestHandle._(this._invoker, this._stackTraceFormatter);
+
+ String get name => _invoker.liveTest.test.name;
+
+ /// Whether this test has already completed successfully.
+ ///
+ /// If a callback originating from a test case is invoked after the test has
+ /// already passed it may be an indication of a test that fails to wait for
+ /// all work to be finished, or of an asynchronous callback that is called
+ /// more times or later than expected.
+ bool get shouldBeDone => _invoker.liveTest.state.shouldBeDone;
+
+ /// Marks this test as skipped.
+ ///
+ /// A skipped test may still fail if any exception is thrown, including
+ /// uncaught asynchronous errors.
+ void markSkipped(String message) {
+ if (_invoker.closed) throw ClosedException();
+ _invoker.skip(message);
+ }
+
+ /// Indicates that this test should not be considered done until the returned
+ /// [OutstandingWork] is marked as complete.
+ ///
+ /// The test may time out before the outstanding work completes.
+ OutstandingWork markPending() {
+ if (_invoker.closed) throw ClosedException();
+ return OutstandingWork._(_invoker, Zone.current);
+ }
+
+ /// Converts [stackTrace] to a [Chain] according to the current test's
+ /// configuration.
+ Chain formatStackTrace(StackTrace stackTrace) =>
+ _stackTraceFormatter.formatStackTrace(stackTrace);
+}
+
+final class OutstandingWork {
+ final Invoker _invoker;
+ final Zone _zone;
+ var _isComplete = false;
+ OutstandingWork._(this._invoker, this._zone) {
+ _invoker.addOutstandingCallback();
+ }
+ void complete() {
+ if (_isComplete) return;
+ _isComplete = true;
+ _zone.run(_invoker.removeOutstandingCallback);
+ }
+}
+
+final class OutsideTestException implements Exception {}
diff --git a/pkgs/test_api/lib/hooks_testing.dart b/pkgs/test_api/lib/hooks_testing.dart
new file mode 100644
index 0000000..b0a6154
--- /dev/null
+++ b/pkgs/test_api/lib/hooks_testing.dart
@@ -0,0 +1,157 @@
+// 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 'src/backend/group.dart';
+import 'src/backend/invoker.dart';
+import 'src/backend/live_test.dart';
+import 'src/backend/metadata.dart';
+import 'src/backend/runtime.dart';
+import 'src/backend/state.dart';
+import 'src/backend/suite.dart';
+import 'src/backend/suite_platform.dart';
+
+@Deprecated('These classes are unused for monitoring tests. Use `State`.')
+export 'src/backend/state.dart' show Result, Status;
+export 'src/backend/test_failure.dart' show TestFailure;
+
+/// A monitor for the behavior of a callback when it is run as the body of a
+/// test case.
+///
+/// Allows running a callback as the body of a local test case and querying for
+/// the current [state], and [errors], and subscribing to future errors.
+///
+/// Use [run] to run a test body and query for the success or failure.
+///
+/// Use [start] to start a test and query for whether it has finished running.
+final class TestCaseMonitor {
+ final LiveTest _liveTest;
+ final _done = Completer<void>();
+ TestCaseMonitor._(FutureOr<void> Function() body)
+ : _liveTest = _createTest(body);
+
+ /// Run [body] as a test case and return a [TestCaseMonitor] with the result.
+ ///
+ /// The [state] will either [State.passed], [State.skipped], or
+ /// [State.failed], the test will no longer be running.
+ ///
+ /// {@template result-late-fail}
+ /// Note that a test can change state from [State.passed] to [State.failed]
+ /// if the test surfaces an unawaited asynchronous error.
+ /// {@endtemplate}
+ ///
+ /// ```dart
+ /// final monitor = await TestCaseMonitor.run(() {
+ /// fail('oh no!');
+ /// });
+ /// assert(monitor.state == State.failed);
+ /// assert((monitor.errors.single.error as TestFailure).message == 'oh no!');
+ /// ```
+ static Future<TestCaseMonitor> run(FutureOr<void> Function() body) async {
+ final monitor = TestCaseMonitor.start(body);
+ await monitor.onDone;
+ return monitor;
+ }
+
+ /// Start [body] as a test case and return a [TestCaseMonitor] with the status
+ /// and result.
+ ///
+ /// The [state] will start as [State.pending] if queried synchronously, but it
+ /// will switch to [State.running]. After `onDone` completes the state will be
+ /// one of [State.passed], [State.skipped], or [State.failed].
+ ///
+ /// {@macro result-late-fail}
+ ///
+ /// ```dart
+ /// late void Function() completeWork;
+ /// final monitor = TestCaseMonitor.start(() {
+ /// final outstandingWork = TestHandle.current.markPending();
+ /// completeWork = outstandingWork.complete;
+ /// });
+ /// await pumpEventQueue();
+ /// assert(monitor.state == State.running);
+ /// completeWork();
+ /// await monitor.onDone;
+ /// assert(monitor.state == State.passed);
+ /// ```
+ static TestCaseMonitor start(FutureOr<void> Function() body) =>
+ TestCaseMonitor._(body).._start();
+
+ void _start() {
+ _liveTest.run().whenComplete(_done.complete);
+ }
+
+ /// A future that completes after this test has finished running, or has
+ /// surfaced an error.
+ Future<void> get onDone => _done.future;
+
+ /// The running and success or failure status for the test case.
+ State get state {
+ final status = _liveTest.state.status;
+ if (status == Status.pending) return State.pending;
+ if (status == Status.running) return State.running;
+ final result = _liveTest.state.result;
+ if (result == Result.skipped) return State.skipped;
+ if (result == Result.success) return State.passed;
+ // result == Result.failure || result == Result.error
+ return State.failed;
+ }
+
+ /// The errors surfaced by the test.
+ ///
+ /// A test with any errors will have a [state] of [State.failed].
+ ///
+ /// {@macro result-late-fail}
+ ///
+ /// A test may have more than one error if there were unhandled asynchronous
+ /// errors surfaced after the test is done.
+ Iterable<AsyncError> get errors => _liveTest.errors;
+
+ /// A stream of errors surfaced by the test.
+ ///
+ /// This stream will not close, asynchronous errors may be surfaced within the
+ /// test's error zone at any point.
+ Stream<AsyncError> get onError => _liveTest.onError;
+}
+
+/// Returns a local [LiveTest] that runs [body].
+LiveTest _createTest(FutureOr<void> Function() body) {
+ var test = LocalTest('test', Metadata(chainStackTraces: true), body);
+ var suite = Suite(Group.root([test]), _suitePlatform, ignoreTimeouts: false);
+ return test.load(suite);
+}
+
+/// A dummy suite platform to use for testing suites.
+final _suitePlatform =
+ SuitePlatform(Runtime.vm, compiler: Runtime.vm.defaultCompiler);
+
+/// The running and success state of a test monitored by a [TestCaseMonitor].
+enum State {
+ /// The test is has not yet started.
+ pending,
+
+ /// The test is running and has not yet failed.
+ running,
+
+ /// The test has completed without any error.
+ ///
+ /// This implies that the test body has completed, and no error has surfaced
+ /// *yet*. However, it this doesn't mean that the test won't fail in the
+ /// future.
+ passed,
+
+ /// The test, or some part of it, has been skipped.
+ ///
+ /// This does not imply that the test has not had an error, but if there are
+ /// errors they are ignored.
+ skipped,
+
+ /// The test has failed.
+ ///
+ /// An test fails when any exception, typically a [TestFailure], is thrown in
+ /// the test's zone. A test that has failed may still have additional errors
+ /// that surface as unhandled asynchronous errors.
+ failed,
+}
diff --git a/pkgs/test_api/lib/scaffolding.dart b/pkgs/test_api/lib/scaffolding.dart
new file mode 100644
index 0000000..9d864bb
--- /dev/null
+++ b/pkgs/test_api/lib/scaffolding.dart
@@ -0,0 +1,23 @@
+// Copyright (c) 2021, 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.
+
+/// {@canonicalFor on_platform.OnPlatform}
+/// {@canonicalFor retry.Retry}
+/// {@canonicalFor skip.Skip}
+/// {@canonicalFor tags.Tags}
+/// {@canonicalFor test_on.TestOn}
+/// {@canonicalFor timeout.Timeout}
+library;
+
+export 'src/backend/configuration/on_platform.dart' show OnPlatform;
+export 'src/backend/configuration/retry.dart' show Retry;
+export 'src/backend/configuration/skip.dart' show Skip;
+export 'src/backend/configuration/tags.dart' show Tags;
+export 'src/backend/configuration/test_on.dart' show TestOn;
+export 'src/backend/configuration/timeout.dart' show Timeout;
+export 'src/scaffolding/spawn_hybrid.dart' show spawnHybridCode, spawnHybridUri;
+export 'src/scaffolding/test_structure.dart'
+ show addTearDown, group, setUp, setUpAll, tearDown, tearDownAll, test;
+export 'src/scaffolding/utils.dart'
+ show markTestSkipped, printOnFailure, pumpEventQueue, registerException;
diff --git a/pkgs/test_api/lib/src/backend/closed_exception.dart b/pkgs/test_api/lib/src/backend/closed_exception.dart
new file mode 100644
index 0000000..08a45a0
--- /dev/null
+++ b/pkgs/test_api/lib/src/backend/closed_exception.dart
@@ -0,0 +1,12 @@
+// Copyright (c) 2015, 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.
+
+/// An exception thrown by various front-end methods when the test framework has
+/// been closed and a test must shut down as soon as possible.
+class ClosedException implements Exception {
+ ClosedException();
+
+ @override
+ String toString() => 'This test has been closed.';
+}
diff --git a/pkgs/test_api/lib/src/backend/compiler.dart b/pkgs/test_api/lib/src/backend/compiler.dart
new file mode 100644
index 0000000..41c253d
--- /dev/null
+++ b/pkgs/test_api/lib/src/backend/compiler.dart
@@ -0,0 +1,59 @@
+// 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.
+
+/// All the Dart compilers supported by the test runner.
+enum Compiler {
+ /// The production Dart to Javascript compiler (whole world, optimizing).
+ dart2js('Dart2Js', 'dart2js'),
+
+ /// Experimental Dart to Wasm compiler.
+ dart2wasm('Dart2Wasm', 'dart2wasm'),
+
+ /// Compiles dart code to a native executable.
+ exe('Exe', 'exe'),
+
+ /// The standard compiler for vm tests, compiles tests to kernel before
+ /// running them on the VM.
+ kernel('Kernel', 'kernel'),
+
+ /// Runs tests directly from source, with no precompilation.
+ source('Source', 'source');
+
+ /// The compilers that are supported by the test runner by default.
+ static const List<Compiler> builtIn = [
+ Compiler.dart2js,
+ Compiler.dart2wasm,
+ Compiler.exe,
+ Compiler.kernel,
+ Compiler.source,
+ ];
+
+ /// The human-friendly name of the compiler.
+ final String name;
+
+ /// The identifier used to look up the compiler.
+ final String identifier;
+
+ const Compiler(this.name, this.identifier);
+
+ /// Converts a JSON-safe representation generated by [serialize] back into a
+ /// [Compiler].
+ ///
+ /// Note that custom [Compiler] implementations are not supported.
+ factory Compiler.deserialize(Object serialized) => builtIn
+ .firstWhere((compiler) => compiler.identifier == serialized as String);
+
+ /// Converts [this] into a JSON-safe object that can be converted back to a
+ /// [Compiler] using [Compiler.deserialize].
+ Object serialize() => identifier;
+
+ @override
+ String toString() => name;
+}
+
+extension CompileTarget on Compiler {
+ bool get isJS => this == Compiler.dart2js;
+
+ bool get isWasm => this == Compiler.dart2wasm;
+}
diff --git a/pkgs/test_api/lib/src/backend/configuration/on_platform.dart b/pkgs/test_api/lib/src/backend/configuration/on_platform.dart
new file mode 100644
index 0000000..02a5254
--- /dev/null
+++ b/pkgs/test_api/lib/src/backend/configuration/on_platform.dart
@@ -0,0 +1,17 @@
+// Copyright (c) 2015, 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 'package:meta/meta_meta.dart';
+
+/// An annotation for platform-specific customizations for a test suite.
+///
+/// See [the README][onPlatform].
+///
+/// [onPlatform]: https://github.com/dart-lang/test/tree/master/pkgs/test#platform-specific-configuration
+@Target({TargetKind.library})
+final class OnPlatform {
+ final Map<String, dynamic> annotationsByPlatform;
+
+ const OnPlatform(this.annotationsByPlatform);
+}
diff --git a/pkgs/test_api/lib/src/backend/configuration/retry.dart b/pkgs/test_api/lib/src/backend/configuration/retry.dart
new file mode 100644
index 0000000..1811814
--- /dev/null
+++ b/pkgs/test_api/lib/src/backend/configuration/retry.dart
@@ -0,0 +1,18 @@
+// Copyright (c) 2018, 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 'package:meta/meta_meta.dart';
+
+/// An annotation for marking a test suite to be retried.
+///
+/// A suite-level retry configuration will enable retries for every test in the
+/// suite, unless the group or test is configured with a more specific retry.
+@Target({TargetKind.library})
+final class Retry {
+ /// The number of times the tests in the suite will be retried.
+ final int count;
+
+ /// Marks all tests in a test suite to be retried.
+ const Retry(this.count);
+}
diff --git a/pkgs/test_api/lib/src/backend/configuration/skip.dart b/pkgs/test_api/lib/src/backend/configuration/skip.dart
new file mode 100644
index 0000000..3927994
--- /dev/null
+++ b/pkgs/test_api/lib/src/backend/configuration/skip.dart
@@ -0,0 +1,18 @@
+// Copyright (c) 2015, 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 'package:meta/meta_meta.dart';
+
+/// An annotation for marking a test suite as skipped.
+@Target({TargetKind.library})
+final class Skip {
+ /// The reason the test suite is skipped, or `null` if no reason is given.
+ final String? reason;
+
+ /// Marks a suite as skipped.
+ ///
+ /// If [reason] is passed, it's included in the test output as the reason the
+ /// test is skipped.
+ const Skip([this.reason]);
+}
diff --git a/pkgs/test_api/lib/src/backend/configuration/tags.dart b/pkgs/test_api/lib/src/backend/configuration/tags.dart
new file mode 100644
index 0000000..dbd03f3
--- /dev/null
+++ b/pkgs/test_api/lib/src/backend/configuration/tags.dart
@@ -0,0 +1,21 @@
+// Copyright (c) 2015, 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 'package:meta/meta_meta.dart';
+
+/// An annotation for applying a set of user-defined tags to a test suite.
+///
+/// See [the documentation on tagging tests][tagging tests].
+///
+/// [tagging tests]: https://github.com/dart-lang/test/blob/master/pkgs/test/README.md#tagging-tests
+@Target({TargetKind.library})
+final class Tags {
+ /// The tags for the test suite.
+ Set<String> get tags => _tags.toSet();
+
+ final Iterable<String> _tags;
+
+ /// Applies a set of user-defined tags to a test suite.
+ const Tags(this._tags);
+}
diff --git a/pkgs/test_api/lib/src/backend/configuration/test_on.dart b/pkgs/test_api/lib/src/backend/configuration/test_on.dart
new file mode 100644
index 0000000..dee7f40
--- /dev/null
+++ b/pkgs/test_api/lib/src/backend/configuration/test_on.dart
@@ -0,0 +1,18 @@
+// Copyright (c) 2015, 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 'package:meta/meta_meta.dart';
+
+/// An annotation indicating which platforms a test suite supports.
+///
+/// For the full syntax of [expression], see [the README][].
+///
+/// [the README]: https://github.com/dart-lang/test/tree/master/pkgs/test#platform-selectors
+@Target({TargetKind.library})
+final class TestOn {
+ /// The expression specifying the platform.
+ final String expression;
+
+ const TestOn(this.expression);
+}
diff --git a/pkgs/test_api/lib/src/backend/configuration/timeout.dart b/pkgs/test_api/lib/src/backend/configuration/timeout.dart
new file mode 100644
index 0000000..e51d520
--- /dev/null
+++ b/pkgs/test_api/lib/src/backend/configuration/timeout.dart
@@ -0,0 +1,155 @@
+// Copyright (c) 2015, 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 'package:meta/meta_meta.dart';
+import 'package:string_scanner/string_scanner.dart';
+
+/// A regular expression that matches text until a letter or whitespace.
+///
+/// This is intended to scan through a number without actually encoding the full
+/// Dart number grammar. It doesn't stop on "e" because that can be a component
+/// of numbers.
+final _untilUnit = RegExp(r'[^a-df-z\s]+', caseSensitive: false);
+
+/// A regular expression that matches a time unit.
+final _unit = RegExp(r'([um]s|[dhms])', caseSensitive: false);
+
+/// A regular expression that matches a section of whitespace.
+final _whitespace = RegExp(r'\s+');
+
+/// A class representing a modification to the default timeout for a test.
+///
+/// By default, a test will time out after 30 seconds. With [Timeout], that
+/// can be overridden entirely; with [Timeout.factor], it can be scaled
+/// relative to the default.
+@Target({TargetKind.library})
+final class Timeout {
+ /// A constant indicating that a test should never time out.
+ static const none = Timeout._none();
+
+ /// The timeout duration.
+ ///
+ /// If set, this overrides the default duration entirely. It's `null` for
+ /// timeouts with a non-null [scaleFactor] and for [Timeout.none].
+ final Duration? duration;
+
+ /// The timeout factor.
+ ///
+ /// The default timeout will be multiplied by this to get the new timeout.
+ /// Thus a factor of 2 means that the test will take twice as long to time
+ /// out, and a factor of 0.5 means that it will time out twice as quickly.
+ ///
+ /// This is `null` for timeouts with a non-null [duration] and for
+ /// [Timeout.none].
+ final num? scaleFactor;
+
+ /// Declares an absolute timeout that overrides the default.
+ const Timeout(this.duration) : scaleFactor = null;
+
+ /// Declares a relative timeout that scales the default.
+ const Timeout.factor(this.scaleFactor) : duration = null;
+
+ const Timeout._none()
+ : scaleFactor = null,
+ duration = null;
+
+ /// Parse the timeout from a user-provided string.
+ ///
+ /// This supports the following formats:
+ ///
+ /// * `Number "x"`, which produces a relative timeout with the given scale
+ /// factor.
+ ///
+ /// * `(Number ("d" | "h" | "m" | "s" | "ms" | "us") (" ")?)+`, which produces
+ /// an absolute timeout with the duration given by the sum of the given
+ /// units.
+ ///
+ /// * `"none"`, which produces [Timeout.none].
+ ///
+ /// Throws a [FormatException] if [timeout] is not in a valid format
+ factory Timeout.parse(String timeout) {
+ var scanner = StringScanner(timeout);
+
+ // First check for the string "none".
+ if (scanner.scan('none')) {
+ scanner.expectDone();
+ return Timeout.none;
+ }
+
+ // Scan a number. This will be either a time unit or a scale factor.
+ scanner.expect(_untilUnit, name: 'number');
+ var number = double.parse(scanner.lastMatch![0]!);
+
+ // A number followed by "x" is a scale factor.
+ if (scanner.scan('x') || scanner.scan('X')) {
+ scanner.expectDone();
+ return Timeout.factor(number);
+ }
+
+ // Parse time units until none are left. The condition is in the middle of
+ // the loop because we've already parsed the first number.
+ var microseconds = 0.0;
+ while (true) {
+ scanner.expect(_unit, name: 'unit');
+ microseconds += _microsecondsFor(number, scanner.lastMatch![0]!);
+
+ scanner.scan(_whitespace);
+
+ // Scan the next number, if it's available.
+ if (!scanner.scan(_untilUnit)) break;
+ number = double.parse(scanner.lastMatch![0]!);
+ }
+
+ scanner.expectDone();
+ return Timeout(Duration(microseconds: microseconds.round()));
+ }
+
+ /// Returns the number of microseconds in [number] [unit]s.
+ static double _microsecondsFor(double number, String unit) => switch (unit) {
+ 'd' => number * 24 * 60 * 60 * 1000000,
+ 'h' => number * 60 * 60 * 1000000,
+ 'm' => number * 60 * 1000000,
+ 's' => number * 1000000,
+ 'ms' => number * 1000,
+ 'us' => number,
+ _ => throw ArgumentError('Unknown unit $unit.'),
+ };
+
+ /// Returns a new [Timeout] that merges [this] with [other].
+ ///
+ /// [Timeout.none] takes precedence over everything. If timeout is
+ /// [Timeout.none] and [other] declares a [duration], that takes precedence.
+ /// Otherwise, this timeout's [duration] or [factor] are multiplied by
+ /// [other]'s [factor].
+ Timeout merge(Timeout other) {
+ if (this == none || other == none) return none;
+ if (other.duration != null) return Timeout(other.duration);
+ if (duration != null) return Timeout(duration! * other.scaleFactor!);
+ return Timeout.factor(scaleFactor! * other.scaleFactor!);
+ }
+
+ /// Returns a new [Duration] from applying [this] to [base].
+ ///
+ /// If this is [none], returns `null`.
+ Duration? apply(Duration base) {
+ if (this == none) return null;
+ return duration ?? base * scaleFactor!;
+ }
+
+ @override
+ int get hashCode => duration.hashCode ^ 5 * scaleFactor.hashCode;
+
+ @override
+ bool operator ==(Object other) =>
+ other is Timeout &&
+ other.duration == duration &&
+ other.scaleFactor == scaleFactor;
+
+ @override
+ String toString() {
+ if (duration != null) return duration.toString();
+ if (scaleFactor != null) return '${scaleFactor}x';
+ return 'none';
+ }
+}
diff --git a/pkgs/test_api/lib/src/backend/declarer.dart b/pkgs/test_api/lib/src/backend/declarer.dart
new file mode 100644
index 0000000..76f7563
--- /dev/null
+++ b/pkgs/test_api/lib/src/backend/declarer.dart
@@ -0,0 +1,433 @@
+// Copyright (c) 2015, 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:collection/collection.dart';
+import 'package:stack_trace/stack_trace.dart';
+
+import 'configuration/timeout.dart';
+import 'group.dart';
+import 'group_entry.dart';
+import 'invoker.dart';
+import 'metadata.dart';
+import 'test.dart';
+
+/// A class that manages the state of tests as they're declared.
+///
+/// A nested tree of Declarers tracks the current group, set-up, and tear-down
+/// functions. Each Declarer in the tree corresponds to a group. This tree is
+/// tracked by a zone-scoped "current" Declarer; the current declarer can be set
+/// for a block using [Declarer.declare], and it can be accessed using
+/// [Declarer.current].
+class Declarer {
+ /// The parent declarer, or `null` if this corresponds to the root group.
+ final Declarer? _parent;
+
+ /// The name of the current test group, including the name of any parent
+ /// groups.
+ ///
+ /// This is `null` if this is the root group.
+ final String? _name;
+
+ /// The metadata for this group, including the metadata of any parent groups
+ /// and of the test suite.
+ final Metadata _metadata;
+
+ /// The set of variables that are valid for platform selectors, in addition to
+ /// the built-in variables that are allowed everywhere.
+ final Set<String> _platformVariables;
+
+ /// The stack trace for this group.
+ ///
+ /// This is `null` for the root (implicit) group.
+ final Trace? _trace;
+
+ /// Whether to collect stack traces for [GroupEntry]s.
+ final bool _collectTraces;
+
+ /// Whether to disable retries of tests.
+ final bool _noRetry;
+
+ /// The set-up functions to run for each test in this group.
+ final _setUps = <dynamic Function()>[];
+
+ /// The tear-down functions to run for each test in this group.
+ final _tearDowns = <dynamic Function()>[];
+
+ /// The set-up functions to run once for this group.
+ final _setUpAlls = <dynamic Function()>[];
+
+ /// The default timeout for synthetic tests.
+ final _timeout = const Timeout(Duration(minutes: 12));
+
+ /// The trace for the first call to [setUpAll].
+ ///
+ /// All [setUpAll]s are run in a single logical test, so they can only have
+ /// one trace. The first trace is most often correct, since the first
+ /// [setUpAll] is always run and the rest are only run if that one succeeds.
+ Trace? _setUpAllTrace;
+
+ /// The tear-down functions to run once for this group.
+ final _tearDownAlls = <void Function()>[];
+
+ /// The trace for the first call to [tearDownAll].
+ ///
+ /// All [tearDownAll]s are run in a single logical test, so they can only have
+ /// one trace. The first trace matches [_setUpAllTrace].
+ Trace? _tearDownAllTrace;
+
+ /// The children of this group, either tests or sub-groups.
+ ///
+ /// All modifications to this must go through [_addEntry].
+ final _entries = <GroupEntry>[];
+
+ /// Whether [build] has been called for this declarer.
+ bool _built = false;
+
+ /// The tests and/or groups that have been flagged as solo.
+ final _soloEntries = <GroupEntry>[];
+
+ /// Whether any tests and/or groups have been flagged as solo.
+ bool get _solo => _soloEntries.isNotEmpty;
+
+ /// An exact full test name to match.
+ ///
+ /// When non-null only tests with exactly this name will be considered. The
+ /// full test name is the combination of the test case name with all group
+ /// prefixes. All other tests, including their metadata like `solo`, is
+ /// ignored. Uniqueness is not guaranteed so this may match more than one
+ /// test.
+ ///
+ /// Groups which are not a strict prefix of this name will be ignored.
+ final String? _fullTestName;
+
+ /// The current zone-scoped declarer.
+ static Declarer? get current => Zone.current[#test.declarer] as Declarer?;
+
+ /// All the test and group names that have been declared in the entire suite.
+ ///
+ /// If duplicate test names are allowed, this is not tracked and it will be
+ /// `null`.
+ final Set<String>? _seenNames;
+
+ /// Whether this declarer is running in a standalone test executation.
+ ///
+ /// The full test runner awaits asynchronous `main` declarations, and so
+ /// asynchronous work can be performed in between calls to `group`, and `test`
+ /// etc. When running as a standalone file tests are run synchronously
+ /// following the first call to declare a test, so all tests must be declared
+ /// synchronously starting at that point. Track whether we are running in this
+ /// more limited mode to customize the error message for tests declared late.
+ final bool _isStandalone;
+
+ /// Creates a new declarer for the root group.
+ ///
+ /// This is the implicit group that exists outside of any calls to `group()`.
+ /// If [metadata] is passed, it's used as the metadata for the implicit root
+ /// group.
+ ///
+ /// The [platformVariables] are the set of variables that are valid for
+ /// platform selectors in test and group metadata, in addition to the built-in
+ /// variables that are allowed everywhere.
+ ///
+ /// If [collectTraces] is `true`, this will set [GroupEntry.trace] for all
+ /// entries built by the declarer. Note that this can be noticeably slow when
+ /// thousands of tests are being declared (see #457).
+ ///
+ /// If [noRetry] is `true` tests will be run at most once.
+ ///
+ /// If [allowDuplicateTestNames] is `false`, then a
+ /// [DuplicateTestNameException] will be thrown if two tests (or groups) have
+ /// the same name.
+ Declarer({
+ Metadata? metadata,
+ Set<String>? platformVariables,
+ bool collectTraces = false,
+ bool noRetry = false,
+ String? fullTestName,
+ // TODO: Change the default https://github.com/dart-lang/test/issues/1571
+ bool allowDuplicateTestNames = true,
+ bool isStandalone = false,
+ }) : this._(
+ null,
+ null,
+ metadata ?? Metadata(),
+ platformVariables ?? const UnmodifiableSetView.empty(),
+ collectTraces,
+ null,
+ noRetry,
+ fullTestName,
+ allowDuplicateTestNames ? null : <String>{},
+ isStandalone,
+ );
+
+ Declarer._(
+ this._parent,
+ this._name,
+ this._metadata,
+ this._platformVariables,
+ this._collectTraces,
+ this._trace,
+ this._noRetry,
+ this._fullTestName,
+ this._seenNames,
+ this._isStandalone,
+ );
+
+ /// Runs [body] with this declarer as [Declarer.current].
+ ///
+ /// Returns the return value of [body].
+ T declare<T>(T Function() body) =>
+ runZoned(body, zoneValues: {#test.declarer: this});
+
+ /// Defines a test case with the given name and body.
+ void test(String name, dynamic Function() body,
+ {String? testOn,
+ Timeout? timeout,
+ Object? skip,
+ Map<String, dynamic>? onPlatform,
+ Object? tags,
+ int? retry,
+ bool solo = false}) {
+ _checkNotBuilt('test');
+
+ final fullName = _prefix(name);
+ if (_fullTestName != null && fullName != _fullTestName) {
+ return;
+ }
+
+ var newMetadata = Metadata.parse(
+ testOn: testOn,
+ timeout: timeout,
+ skip: skip,
+ onPlatform: onPlatform,
+ tags: tags,
+ retry: _noRetry ? 0 : retry);
+ newMetadata.validatePlatformSelectors(_platformVariables);
+ var metadata = _metadata.merge(newMetadata);
+ _addEntry(LocalTest(fullName, metadata, () async {
+ var parents = <Declarer>[];
+ for (Declarer? declarer = this;
+ declarer != null;
+ declarer = declarer._parent) {
+ parents.add(declarer);
+ }
+
+ // Register all tear-down functions in all declarers. Iterate through
+ // parents outside-in so that the Invoker gets the functions in the order
+ // they were declared in source.
+ for (var declarer in parents.reversed) {
+ for (var tearDown in declarer._tearDowns) {
+ Invoker.current!.addTearDown(tearDown);
+ }
+ }
+
+ await runZoned(() async {
+ await _runSetUps();
+ await body();
+ },
+ // Make the declarer visible to running tests so that they'll throw
+ // useful errors when calling `test()` and `group()` within a test.
+ zoneValues: {#test.declarer: this});
+ }, trace: _collectTraces ? Trace.current(2) : null, guarded: false));
+
+ if (solo) {
+ _soloEntries.add(_entries.last);
+ }
+ }
+
+ /// Creates a group of tests.
+ void group(String name, void Function() body,
+ {String? testOn,
+ Timeout? timeout,
+ Object? skip,
+ Map<String, dynamic>? onPlatform,
+ Object? tags,
+ int? retry,
+ bool solo = false}) {
+ _checkNotBuilt('group');
+
+ final fullTestPrefix = _prefix(name);
+ if (_fullTestName != null && !_fullTestName.startsWith(fullTestPrefix)) {
+ return;
+ }
+
+ var newMetadata = Metadata.parse(
+ testOn: testOn,
+ timeout: timeout,
+ skip: skip,
+ onPlatform: onPlatform,
+ tags: tags,
+ retry: _noRetry ? 0 : retry);
+ newMetadata.validatePlatformSelectors(_platformVariables);
+ var metadata = _metadata.merge(newMetadata);
+ var trace = _collectTraces ? Trace.current(2) : null;
+
+ var declarer = Declarer._(
+ this,
+ fullTestPrefix,
+ metadata,
+ _platformVariables,
+ _collectTraces,
+ trace,
+ _noRetry,
+ _fullTestName,
+ _seenNames,
+ _isStandalone,
+ );
+ declarer.declare(() {
+ // Cast to dynamic to avoid the analyzer complaining about us using the
+ // result of a void method.
+ var result = (body as dynamic)();
+ if (result is! Future) return;
+ throw ArgumentError('Groups may not be async.');
+ });
+ _addEntry(declarer.build());
+
+ if (solo || declarer._solo) {
+ _soloEntries.add(_entries.last);
+ }
+ }
+
+ /// Returns [name] prefixed with this declarer's group name.
+ String _prefix(String name) => _name == null ? name : '$_name $name';
+
+ /// Registers a function to be run before each test in this group.
+ void setUp(dynamic Function() callback) {
+ _checkNotBuilt('setUp');
+ _setUps.add(callback);
+ }
+
+ /// Registers a function to be run after each test in this group.
+ void tearDown(dynamic Function() callback) {
+ _checkNotBuilt('tearDown');
+ _tearDowns.add(callback);
+ }
+
+ /// Registers a function to be run once before all tests.
+ void setUpAll(dynamic Function() callback) {
+ _checkNotBuilt('setUpAll');
+ if (_collectTraces) _setUpAllTrace ??= Trace.current(2);
+ _setUpAlls.add(callback);
+ }
+
+ /// Registers a function to be run once after all tests.
+ void tearDownAll(dynamic Function() callback) {
+ _checkNotBuilt('tearDownAll');
+ if (_collectTraces) _tearDownAllTrace ??= Trace.current(2);
+ _tearDownAlls.add(callback);
+ }
+
+ /// Like [tearDownAll], but called from within a running [setUpAll] test to
+ /// dynamically add a [tearDownAll].
+ void addTearDownAll(dynamic Function() callback) =>
+ _tearDownAlls.add(callback);
+
+ /// Finalizes and returns the group being declared.
+ ///
+ /// **Note**: The tests in this group must be run in a [Invoker.guard]
+ /// context; otherwise, test errors won't be captured.
+ Group build() {
+ _checkNotBuilt('build');
+
+ _built = true;
+ var entries = _entries.map((entry) {
+ if (_solo && !_soloEntries.contains(entry)) {
+ entry = LocalTest(
+ entry.name,
+ entry.metadata
+ .change(skip: true, skipReason: 'does not have "solo"'),
+ () {});
+ }
+ return entry;
+ }).toList();
+
+ return Group(_name ?? '', entries,
+ metadata: _metadata,
+ trace: _trace,
+ setUpAll: _setUpAll,
+ tearDownAll: _tearDownAll);
+ }
+
+ /// Throws a [StateError] if [build] has been called.
+ ///
+ /// [name] should be the name of the method being called.
+ void _checkNotBuilt(String name) {
+ if (!_built) return;
+ final restrictionMessage = _isStandalone
+ ? 'When running a test as an executable directly '
+ '(not as a suite by the test runner), '
+ 'tests must be declared in a synchronous block.\n'
+ 'If async work is required before any tests are run '
+ 'use a `setUpAll` callback.\n'
+ 'If async work cannot be avoided before declaring tests, '
+ 'all async events must be complete before declaring the first test.'
+ : 'If async work is required before any tests are run '
+ 'use a `setUpAll` callback.\n'
+ 'If async work cannot be avoided before declaring tests it must '
+ 'all be awaited within the Future returned from `main`.';
+ throw StateError("Can't call $name() once tests have begun running.\n"
+ '$restrictionMessage');
+ }
+
+ /// Run the set-up functions for this and any parent groups.
+ ///
+ /// If no set-up functions are declared, this returns a [Future] that
+ /// completes immediately.
+ Future _runSetUps() async {
+ if (_parent != null) await _parent._runSetUps();
+ // TODO: why does type inference not work here?
+ await Future.forEach<Function>(_setUps, (setUp) => setUp());
+ }
+
+ /// Returns a [Test] that runs the callbacks in [_setUpAll], or `null`.
+ Test? get _setUpAll {
+ if (_setUpAlls.isEmpty) return null;
+
+ return LocalTest(_prefix('(setUpAll)'), _metadata.change(timeout: _timeout),
+ () {
+ return runZoned(
+ () => Future.forEach<Function>(_setUpAlls, (setUp) => setUp()),
+ // Make the declarer visible to running scaffolds so they can add to
+ // the declarer's `tearDownAll()` list.
+ zoneValues: {#test.declarer: this});
+ }, trace: _setUpAllTrace, guarded: false, isScaffoldAll: true);
+ }
+
+ /// Returns a [Test] that runs the callbacks in [_tearDownAll], or `null`.
+ Test? get _tearDownAll {
+ // We have to create a tearDownAll if there's a setUpAll, since it might
+ // dynamically add tear-down code using [addTearDownAll].
+ if (_setUpAlls.isEmpty && _tearDownAlls.isEmpty) return null;
+
+ return LocalTest(
+ _prefix('(tearDownAll)'), _metadata.change(timeout: _timeout), () {
+ return runZoned(() => Invoker.current!.runTearDowns(_tearDownAlls),
+ // Make the declarer visible to running scaffolds so they can add to
+ // the declarer's `tearDownAll()` list.
+ zoneValues: {#test.declarer: this});
+ }, trace: _tearDownAllTrace, guarded: false, isScaffoldAll: true);
+ }
+
+ void _addEntry(GroupEntry entry) {
+ if (_seenNames?.add(entry.name) == false) {
+ throw DuplicateTestNameException(entry.name);
+ }
+ _entries.add(entry);
+ }
+}
+
+/// An exception thrown when two test cases in the same test suite (same `main`)
+/// have an identical name.
+class DuplicateTestNameException implements Exception {
+ final String name;
+ DuplicateTestNameException(this.name);
+
+ @override
+ String toString() => 'A test with the name "$name" was already declared. '
+ 'Test cases must have unique names.\n\n'
+ 'See https://github.com/dart-lang/test/blob/master/pkgs/test/doc/'
+ 'configuration.md#allow_test_randomization for info on enabling this.';
+}
diff --git a/pkgs/test_api/lib/src/backend/group.dart b/pkgs/test_api/lib/src/backend/group.dart
new file mode 100644
index 0000000..9a28875
--- /dev/null
+++ b/pkgs/test_api/lib/src/backend/group.dart
@@ -0,0 +1,90 @@
+// Copyright (c) 2015, 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 'package:stack_trace/stack_trace.dart';
+
+import 'group_entry.dart';
+import 'metadata.dart';
+import 'suite_platform.dart';
+import 'test.dart';
+
+/// A group contains one or more tests and subgroups.
+///
+/// It includes metadata that applies to all contained tests.
+class Group implements GroupEntry {
+ @override
+ final String name;
+
+ @override
+ final Metadata metadata;
+
+ @override
+ final Trace? trace;
+
+ /// The children of this group.
+ final List<GroupEntry> entries;
+
+ /// Returns a new root-level group.
+ Group.root(Iterable<GroupEntry> entries, {Metadata? metadata})
+ : this('', entries, metadata: metadata);
+
+ /// A test to run before all tests in the group.
+ ///
+ /// This is `null` if no `setUpAll` callbacks were declared.
+ final Test? setUpAll;
+
+ /// A test to run after all tests in the group.
+ ///
+ /// This is `null` if no `tearDown` callbacks were declared.
+ final Test? tearDownAll;
+
+ /// The number of tests (recursively) in this group.
+ int get testCount {
+ if (_testCount != null) return _testCount!;
+ _testCount = entries.fold<int>(
+ 0, (count, entry) => count + (entry is Group ? entry.testCount : 1));
+ return _testCount!;
+ }
+
+ int? _testCount;
+
+ Group(this.name, Iterable<GroupEntry> entries,
+ {Metadata? metadata, this.trace, this.setUpAll, this.tearDownAll})
+ : entries = List<GroupEntry>.unmodifiable(entries),
+ metadata = metadata ?? Metadata();
+
+ @override
+ Group? forPlatform(SuitePlatform platform) {
+ if (!metadata.testOn.evaluate(platform)) return null;
+ var newMetadata = metadata.forPlatform(platform);
+ var filtered = _map((entry) => entry.forPlatform(platform));
+ if (filtered.isEmpty && entries.isNotEmpty) return null;
+ return Group(name, filtered,
+ metadata: newMetadata,
+ trace: trace,
+ setUpAll: setUpAll,
+ tearDownAll: tearDownAll);
+ }
+
+ @override
+ Group? filter(bool Function(Test) callback) {
+ var filtered = _map((entry) => entry.filter(callback));
+ if (filtered.isEmpty && entries.isNotEmpty) return null;
+ return Group(name, filtered,
+ metadata: metadata,
+ trace: trace,
+ setUpAll: setUpAll,
+ tearDownAll: tearDownAll);
+ }
+
+ /// Returns the entries of this group mapped using [callback].
+ ///
+ /// Any `null` values returned by [callback] will be removed.
+ List<GroupEntry> _map(GroupEntry? Function(GroupEntry) callback) {
+ return entries
+ .map((entry) => callback(entry))
+ .whereType<GroupEntry>()
+ .toList();
+ }
+}
diff --git a/pkgs/test_api/lib/src/backend/group_entry.dart b/pkgs/test_api/lib/src/backend/group_entry.dart
new file mode 100644
index 0000000..a6f30bd
--- /dev/null
+++ b/pkgs/test_api/lib/src/backend/group_entry.dart
@@ -0,0 +1,39 @@
+// Copyright (c) 2015, 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 'package:stack_trace/stack_trace.dart';
+
+import 'metadata.dart';
+import 'suite_platform.dart';
+import 'test.dart';
+
+/// A [Test] or [Group].
+abstract class GroupEntry {
+ /// The name of the entry, including the prefixes from any containing
+ /// [Group]s.
+ ///
+ /// This will be empty for the root group.
+ String get name;
+
+ /// The metadata for the entry, including the metadata from any containing
+ /// [Group]s.
+ Metadata get metadata;
+
+ /// The stack trace for the call to `test()` or `group()` that defined this
+ /// entry, or `null` if the entry was defined in a different way.
+ Trace? get trace;
+
+ /// Returns a copy of [this] with all platform-specific metadata resolved.
+ ///
+ /// Removes any tests and groups with [Metadata.testOn] selectors that don't
+ /// match [platform]. Returns `null` if this entry's selector doesn't match.
+ GroupEntry? forPlatform(SuitePlatform platform);
+
+ /// Returns a copy of [this] with all tests that don't match [callback]
+ /// removed.
+ ///
+ /// Returns `null` if this is a test that doesn't match [callback] or a group
+ /// where no child tests match [callback].
+ GroupEntry? filter(bool Function(Test) callback);
+}
diff --git a/pkgs/test_api/lib/src/backend/invoker.dart b/pkgs/test_api/lib/src/backend/invoker.dart
new file mode 100644
index 0000000..58f1001
--- /dev/null
+++ b/pkgs/test_api/lib/src/backend/invoker.dart
@@ -0,0 +1,464 @@
+// Copyright (c) 2015, 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:stack_trace/stack_trace.dart';
+
+import 'closed_exception.dart';
+import 'declarer.dart';
+import 'group.dart';
+import 'live_test.dart';
+import 'live_test_controller.dart';
+import 'message.dart';
+import 'metadata.dart';
+import 'state.dart';
+import 'suite.dart';
+import 'suite_platform.dart';
+import 'test.dart';
+import 'test_failure.dart';
+import 'util/pretty_print.dart';
+
+/// A test in this isolate.
+class LocalTest extends Test {
+ @override
+ final String name;
+
+ @override
+ final Metadata metadata;
+
+ @override
+ final Trace? trace;
+
+ /// Whether this is a test defined using `setUpAll()` or `tearDownAll()`.
+ final bool isScaffoldAll;
+
+ /// The test body.
+ final void Function() _body;
+
+ /// Whether the test is run in its own error zone.
+ final bool _guarded;
+
+ /// Creates a new [LocalTest].
+ ///
+ /// If [guarded] is `true`, the test is run in its own error zone, and any
+ /// errors that escape that zone cause the test to fail. If it's `false`, it's
+ /// the caller's responsibility to invoke [LiveTest.run] in the context of a
+ /// call to [Invoker.guard].
+ LocalTest(this.name, this.metadata, this._body,
+ {this.trace, bool guarded = true, this.isScaffoldAll = false})
+ : _guarded = guarded;
+
+ LocalTest._(this.name, this.metadata, this._body, this.trace, this._guarded,
+ this.isScaffoldAll);
+
+ /// Loads a single runnable instance of this test.
+ @override
+ LiveTest load(Suite suite, {Iterable<Group>? groups}) {
+ var invoker = Invoker._(suite, this, groups: groups, guarded: _guarded);
+ return invoker.liveTest;
+ }
+
+ @override
+ Test? forPlatform(SuitePlatform platform) {
+ if (!metadata.testOn.evaluate(platform)) return null;
+ return LocalTest._(name, metadata.forPlatform(platform), _body, trace,
+ _guarded, isScaffoldAll);
+ }
+}
+
+/// The class responsible for managing the lifecycle of a single local test.
+///
+/// The current invoker is accessible within the zone scope of the running test
+/// using [Invoker.current]. It's used to track asynchronous callbacks and
+/// report asynchronous errors.
+class Invoker {
+ /// The live test being driven by the invoker.
+ ///
+ /// This provides a view into the state of the test being executed.
+ LiveTest get liveTest => _controller;
+ late final LiveTestController _controller;
+
+ /// Whether to run this test in its own error zone.
+ final bool _guarded;
+
+ /// Whether the user code is allowed to interact with the invoker despite it
+ /// being closed.
+ ///
+ /// A test is generally closed because the runner is shutting down (in
+ /// response to a signal) or because the test's suite is finished.
+ /// Typically calls to [addTearDown] and [addOutstandingCallback] are only
+ /// allowed before the test is closed. Tear down callbacks, however, are
+ /// allowed to perform these interactions to facilitate resource cleanup on a
+ /// best-effort basis, so the invoker is made to appear open only within the
+ /// zones running the teardown callbacks.
+ bool get _forceOpen => Zone.current[_forceOpenForTearDownKey] as bool;
+
+ /// An opaque object used as a key in the zone value map to identify
+ /// [_forceOpen].
+ ///
+ /// This is an instance variable to ensure that multiple invokers don't step
+ /// on one anothers' toes.
+ final _forceOpenForTearDownKey = Object();
+
+ /// Whether the test has been closed.
+ ///
+ /// Once the test is closed, [expect] and [expectAsync] will throw
+ /// [ClosedException]s whenever accessed to help the test stop executing as
+ /// soon as possible.
+ bool get closed => !_forceOpen && _onCloseCompleter.isCompleted;
+
+ /// A future that completes once the test has been closed.
+ Future<void> get onClose => _onCloseCompleter.future;
+ final _onCloseCompleter = Completer<void>();
+
+ /// The test being run.
+ LocalTest get _test => liveTest.test as LocalTest;
+
+ /// The outstanding callback counter for the current zone.
+ _AsyncCounter get _outstandingCallbacks {
+ var counter = Zone.current[_counterKey] as _AsyncCounter?;
+ if (counter != null) return counter;
+ throw StateError("Can't add or remove outstanding callbacks outside "
+ 'of a test body.');
+ }
+
+ /// All the zones created by [_waitForOutstandingCallbacks], in the order they
+ /// were created.
+ ///
+ /// This is used to throw timeout errors in the most recent zone.
+ final _outstandingCallbackZones = <Zone>[];
+
+ /// An opaque object used as a key in the zone value map to identify
+ /// [_outstandingCallbacks].
+ ///
+ /// This is an instance variable to ensure that multiple invokers don't step
+ /// on one anothers' toes.
+ final _counterKey = Object();
+
+ /// The number of times this [liveTest] has been run.
+ int _runCount = 0;
+
+ /// The current invoker, or `null` if none is defined.
+ ///
+ /// An invoker is only set within the zone scope of a running test.
+ static Invoker? get current {
+ // TODO(nweiz): Use a private symbol when dart2js supports it (issue 17526).
+ return Zone.current[#test.invoker] as Invoker?;
+ }
+
+ /// Runs [callback] in a zone where unhandled errors from [LiveTest]s are
+ /// caught and dispatched to the appropriate [Invoker].
+ static T? guard<T>(T Function() callback) =>
+ runZoned<T?>(callback, zoneSpecification: ZoneSpecification(
+ // Use [handleUncaughtError] rather than [onError] so we can
+ // capture [zone] and with it the outstanding callback counter for
+ // the zone in which [error] was thrown.
+ handleUncaughtError: (self, _, zone, error, stackTrace) {
+ var invoker = zone[#test.invoker] as Invoker?;
+ if (invoker != null) {
+ self.parent!.run(() => invoker._handleError(zone, error, stackTrace));
+ } else {
+ self.parent!.handleUncaughtError(error, stackTrace);
+ }
+ }));
+
+ /// The timer for tracking timeouts.
+ ///
+ /// This will be `null` until the test starts running.
+ Timer? _timeoutTimer;
+
+ /// The tear-down functions to run when this test finishes.
+ final _tearDowns = <void Function()>[];
+
+ /// Messages to print if and when this test fails.
+ final _printsOnFailure = <String>[];
+
+ Invoker._(Suite suite, LocalTest test,
+ {Iterable<Group>? groups, bool guarded = true})
+ : _guarded = guarded {
+ _controller = LiveTestController(
+ suite, test, _onRun, _onCloseCompleter.complete,
+ groups: groups);
+ }
+
+ /// Runs [callback] after this test completes.
+ ///
+ /// The [callback] may return a [Future]. Like all tear-downs, callbacks are
+ /// run in the reverse of the order they're declared.
+ void addTearDown(dynamic Function() callback) {
+ if (closed) throw ClosedException();
+
+ if (_test.isScaffoldAll) {
+ Declarer.current!.addTearDownAll(callback);
+ } else {
+ _tearDowns.add(callback);
+ }
+ }
+
+ /// Tells the invoker that there's a callback running that it should wait for
+ /// before considering the test successful.
+ ///
+ /// Each call to [addOutstandingCallback] should be followed by a call to
+ /// [removeOutstandingCallback] once the callback is no longer running. Note
+ /// that only successful tests wait for outstanding callbacks; as soon as a
+ /// test experiences an error, any further calls to [addOutstandingCallback]
+ /// or [removeOutstandingCallback] will do nothing.
+ ///
+ /// Throws a [ClosedException] if this test has been closed.
+ void addOutstandingCallback() {
+ if (closed) throw ClosedException();
+ _outstandingCallbacks.increment();
+ }
+
+ /// Tells the invoker that a callback declared with [addOutstandingCallback]
+ /// is no longer running.
+ void removeOutstandingCallback() {
+ heartbeat();
+ _outstandingCallbacks.decrement();
+ }
+
+ /// Run [tearDowns] in reverse order.
+ ///
+ /// An exception thrown in a tearDown callback will cause the test to fail, if
+ /// it isn't already failing, but it won't prevent the remaining callbacks
+ /// from running. This invoker will not be closeable within the zone that the
+ /// teardowns are running in.
+ Future<void> runTearDowns(List<FutureOr<void> Function()> tearDowns) {
+ heartbeat();
+ return runZoned(() async {
+ while (tearDowns.isNotEmpty) {
+ var completer = Completer<void>();
+
+ addOutstandingCallback();
+ _waitForOutstandingCallbacks(() {
+ Future.sync(tearDowns.removeLast()).whenComplete(completer.complete);
+ }).then((_) => removeOutstandingCallback()).unawaited;
+
+ await completer.future;
+ }
+ }, zoneValues: {_forceOpenForTearDownKey: true});
+ }
+
+ /// Runs [fn] and completes once [fn] and all outstanding callbacks registered
+ /// within [fn] have completed.
+ ///
+ /// Outstanding callbacks registered within [fn] will *not* be registered as
+ /// outstanding callback outside of [fn].
+ Future<void> _waitForOutstandingCallbacks(FutureOr<void> Function() fn) {
+ heartbeat();
+
+ Zone? zone;
+ var counter = _AsyncCounter();
+ runZoned(() async {
+ zone = Zone.current;
+ _outstandingCallbackZones.add(zone!);
+ try {
+ await fn();
+ } finally {
+ counter.decrement();
+ }
+ }, zoneValues: {_counterKey: counter});
+
+ return counter.onZero.whenComplete(() {
+ _outstandingCallbackZones.remove(zone!);
+ });
+ }
+
+ /// Notifies the invoker that progress is being made.
+ ///
+ /// Each heartbeat resets the timeout timer. This helps ensure that
+ /// long-running tests that still make progress don't time out.
+ void heartbeat() {
+ if (liveTest.isComplete) return;
+ if (_timeoutTimer != null) _timeoutTimer!.cancel();
+ if (liveTest.suite.ignoreTimeouts == true) return;
+
+ const defaultTimeout = Duration(seconds: 30);
+ var timeout = liveTest.test.metadata.timeout.apply(defaultTimeout);
+ if (timeout == null) return;
+ String message() {
+ var message = 'Test timed out after ${niceDuration(timeout)}.';
+ if (timeout == defaultTimeout) {
+ message += ' See https://pub.dev/packages/test#timeouts';
+ }
+ return message;
+ }
+
+ _timeoutTimer = Zone.root.createTimer(timeout, () {
+ _outstandingCallbackZones.last.run(() {
+ _handleError(Zone.current, TimeoutException(message(), timeout));
+ _outstandingCallbacks.complete();
+ });
+ });
+ }
+
+ /// Marks the current test as skipped.
+ ///
+ /// If passed, [message] is emitted as a skip message.
+ ///
+ /// Note that this *does not* mark the test as complete. That is, it sets
+ /// the result to [Result.skipped], but doesn't change the state.
+ void skip([String? message]) {
+ if (liveTest.state.shouldBeDone) {
+ // Set the state explicitly so we don't get an extra error about the test
+ // failing after being complete.
+ _controller.setState(const State(Status.complete, Result.error));
+ throw 'This test was marked as skipped after it had already completed.\n'
+ 'Make sure to use a matching library which informs the test runner\n'
+ 'of pending async work.';
+ }
+
+ if (message != null) _controller.message(Message.skip(message));
+ // TODO: error if the test is already complete.
+ _controller.setState(const State(Status.pending, Result.skipped));
+ }
+
+ /// Prints [message] if and when this test fails.
+ void printOnFailure(String message) {
+ message = message.trim();
+ if (liveTest.state.result.isFailing) {
+ _print('\n$message');
+ } else {
+ _printsOnFailure.add(message);
+ }
+ }
+
+ /// Notifies the invoker of an asynchronous error.
+ ///
+ /// The [zone] is the zone in which the error was thrown.
+ void _handleError(Zone zone, Object error, [StackTrace? stackTrace]) {
+ // Ignore errors propagated from previous test runs
+ if (_runCount != zone[#runCount]) return;
+
+ // Get the chain information from the zone in which the error was thrown.
+ zone.run(() {
+ if (stackTrace == null) {
+ stackTrace = Chain.current();
+ } else {
+ stackTrace = Chain.forTrace(stackTrace!);
+ }
+ });
+
+ // Store these here because they'll change when we set the state below.
+ var shouldBeDone = liveTest.state.shouldBeDone;
+
+ if (error is! TestFailure) {
+ _controller.setState(const State(Status.complete, Result.error));
+ } else if (liveTest.state.result != Result.error) {
+ _controller.setState(const State(Status.complete, Result.failure));
+ }
+
+ _controller.addError(error, stackTrace!);
+
+ if (_printsOnFailure.isNotEmpty) {
+ _print(_printsOnFailure.join('\n\n'));
+ _printsOnFailure.clear();
+ }
+
+ // If a test was supposed to be done but then had an error, that indicates
+ // that it was poorly-written and could be flaky.
+ if (!shouldBeDone) return;
+
+ // However, users don't think of load tests as "tests", so the error isn't
+ // helpful for them.
+ if (liveTest.suite.isLoadSuite) return;
+
+ _handleError(
+ zone,
+ 'This test failed after it had already completed.\n'
+ 'Make sure to use a matching library which informs the test runner\n'
+ 'of pending async work.',
+ stackTrace);
+ }
+
+ /// The method that's run when the test is started.
+ void _onRun() {
+ _controller.setState(const State(Status.running, Result.success));
+
+ _runCount++;
+ Chain.capture(() {
+ _guardIfGuarded(() {
+ runZoned(() async {
+ // Run the test asynchronously so that the "running" state change
+ // has a chance to hit its event handler(s) before the test produces
+ // an error. If an error is emitted before the first state change is
+ // handled, we can end up with [onError] callbacks firing before the
+ // corresponding [onStateChange], which violates the timing
+ // guarantees.
+ //
+ // Use the event loop over the microtask queue to avoid starvation.
+ await Future(() {});
+
+ await _waitForOutstandingCallbacks(_test._body);
+ await _waitForOutstandingCallbacks(() => runTearDowns(_tearDowns));
+
+ if (_timeoutTimer != null) _timeoutTimer!.cancel();
+
+ if (liveTest.state.result != Result.success &&
+ _runCount < liveTest.test.metadata.retry + 1) {
+ _controller.message(Message.print('Retry: ${liveTest.test.name}'));
+ _onRun();
+ return;
+ }
+
+ _controller.setState(State(Status.complete, liveTest.state.result));
+
+ _controller.completer.complete();
+ },
+ zoneValues: {
+ #test.invoker: this,
+ _forceOpenForTearDownKey: false,
+ #runCount: _runCount,
+ },
+ zoneSpecification:
+ ZoneSpecification(print: (_, __, ___, line) => _print(line)));
+ });
+ }, when: liveTest.test.metadata.chainStackTraces, errorZone: false);
+ }
+
+ /// Runs [callback], in a [Invoker.guard] context if [_guarded] is `true`.
+ void _guardIfGuarded(void Function() callback) {
+ if (_guarded) {
+ Invoker.guard(callback);
+ } else {
+ callback();
+ }
+ }
+
+ /// Prints [text] as a message to [_controller].
+ void _print(String text) => _controller.message(Message.print(text));
+}
+
+/// A manually incremented/decremented counter that completes a [Future] the
+/// first time it reaches zero or is forcefully completed.
+class _AsyncCounter {
+ var _count = 1;
+
+ /// A Future that completes the first time the counter reaches 0.
+ Future<void> get onZero => _completer.future;
+ final _completer = Completer<void>();
+
+ void increment() {
+ _count++;
+ }
+
+ void decrement() {
+ _count--;
+ if (_count != 0) return;
+ if (_completer.isCompleted) return;
+ _completer.complete();
+ }
+
+ /// Force [onZero] to complete.
+ ///
+ /// No effect if [onZero] has already completed.
+ void complete() {
+ if (!_completer.isCompleted) _completer.complete();
+ }
+}
+
+extension<T> on Future<T> {
+ void get unawaited {}
+}
diff --git a/pkgs/test_api/lib/src/backend/live_test.dart b/pkgs/test_api/lib/src/backend/live_test.dart
new file mode 100644
index 0000000..683e87c
--- /dev/null
+++ b/pkgs/test_api/lib/src/backend/live_test.dart
@@ -0,0 +1,148 @@
+// Copyright (c) 2015, 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 'group.dart';
+import 'message.dart';
+import 'state.dart';
+import 'suite.dart';
+import 'test.dart';
+
+/// A runnable instance of a test.
+///
+/// This is distinct from [Test] in order to keep [Test] immutable. Running a
+/// test requires state, and [LiveTest] provides a view of the state of the test
+/// as it runs.
+///
+/// If the state changes, [state] will be updated before [onStateChange] fires.
+/// Likewise, if an error is caught, it will be added to [errors] before being
+/// emitted via [onError]. If an error causes a state change, [onStateChange]
+/// will fire before [onError]. If an error or other state change causes the
+/// test to complete, [onComplete] will complete after [onStateChange] and
+/// [onError] fire.
+abstract class LiveTest {
+ /// The suite within which this test is being run.
+ Suite get suite;
+
+ /// The groups within which this test is being run, from the outermost to the
+ /// innermost.
+ ///
+ /// This will always contain at least the implicit top-level group.
+ List<Group> get groups;
+
+ /// The running test.
+ Test get test;
+
+ /// The current state of the running test.
+ ///
+ /// This starts as [Status.pending] and [Result.success]. It will be updated
+ /// before [onStateChange] fires.
+ ///
+ /// Note that even if this is marked [Status.complete], the test may still be
+ /// running code asynchronously. A test is considered complete either once it
+ /// hits its first error or when all [expectAsync] callbacks have been called
+ /// and any returned [Future] has completed, but it's possible for further
+ /// processing to happen, which may cause further errors. It's even possible
+ /// for a test that was marked [Status.complete] and [Result.success] to be
+ /// marked as [Result.error] later.
+ State get state;
+
+ /// Returns whether this test has completed.
+ ///
+ /// This is equivalent to [state.status] being [Status.complete].
+ ///
+ /// Note that even if this returns `true`, the test may still be
+ /// running code asynchronously. A test is considered complete either once it
+ /// hits its first error or when all [expectAsync] callbacks have been called
+ /// and any returned [Future] has completed, but it's possible for further
+ /// processing to happen, which may cause further errors.
+ bool get isComplete => state.status == Status.complete;
+
+ // A stream that emits a new [State] whenever [state] changes.
+ //
+ // This will only ever emit a [State] if it's different than the previous
+ // [state]. It will emit an event after [state] has been updated. Note that
+ // since this is an asynchronous stream, it's possible for [state] not to
+ // match the [State] that it emits within the [Stream.listen] callback.
+ Stream<State> get onStateChange;
+
+ /// An unmodifiable list of all errors that have been caught while running
+ /// this test.
+ ///
+ /// This will be updated before [onError] fires. These errors are not
+ /// guaranteed to have the same types as when they were thrown; for example,
+ /// they may need to be serialized across isolate boundaries. The stack traces
+ /// will be [Chain]s.
+ List<AsyncError> get errors;
+
+ /// A stream that emits a new [AsyncError] whenever an error is caught.
+ ///
+ /// This will emit an event after [errors] is updated. These errors are not
+ /// guaranteed to have the same types as when they were thrown; for example,
+ /// they may need to be serialized across isolate boundaries. The stack traces
+ /// will be [Chain]s.
+ Stream<AsyncError> get onError;
+
+ /// A stream that emits messages produced by the test.
+ Stream<Message> get onMessage;
+
+ /// A [Future] that completes once the test is complete.
+ ///
+ /// This will complete after [onStateChange] has fired, and after [onError]
+ /// has fired if the test completes because of an error. It's the same as the
+ /// [Future] returned by [run].
+ ///
+ /// Note that even once this completes, the test may still be running code
+ /// asynchronously. A test is considered complete either once it hits its
+ /// first error or when all [expectAsync] callbacks have been called and any
+ /// returned [Future] has completed, but it's possible for further processing
+ /// to happen, which may cause further errors.
+ Future get onComplete;
+
+ /// The name of this live test without any group prefixes.
+ String get individualName {
+ var group = groups.last;
+ if (group.name.isEmpty) return test.name;
+ if (!test.name.startsWith(group.name)) return test.name;
+
+ // The test will have the same name as the group for virtual tests created
+ // to represent skipping the entire group.
+ if (test.name.length == group.name.length) return '';
+
+ return test.name.substring(group.name.length + 1);
+ }
+
+ /// Loads a copy of this [LiveTest] that's able to be run again.
+ LiveTest copy() => test.load(suite, groups: groups);
+
+ /// Signals that this test should start running as soon as possible.
+ ///
+ /// A test may not start running immediately for various reasons specific to
+ /// the means by which it's defined. Until it starts running, [state] will
+ /// continue to be marked [Status.pending].
+ ///
+ /// This returns the same [Future] as [onComplete]. It may not be called more
+ /// than once.
+ Future run();
+
+ /// Signals that this test should stop emitting events and release any
+ /// resources it may have allocated.
+ ///
+ /// Once [close] is called, [onComplete] will complete if it hasn't already
+ /// and [onStateChange] and [onError] will close immediately. This means that,
+ /// if the test was running at the time [close] is called, it will never emit
+ /// a [Status.complete] state-change event. Once a test is closed, [expect]
+ /// and [expectAsync] will throw a [ClosedException] to help the test
+ /// terminate as quickly as possible.
+ ///
+ /// This doesn't automatically happen after the test completes because there
+ /// may be more asynchronous work going on in the background that could
+ /// produce new errors.
+ ///
+ /// Returns a [Future] that completes once all resources are released *and*
+ /// the test has completed. This allows the caller to wait until the test's
+ /// tear-down logic has run.
+ Future close();
+}
diff --git a/pkgs/test_api/lib/src/backend/live_test_controller.dart b/pkgs/test_api/lib/src/backend/live_test_controller.dart
new file mode 100644
index 0000000..956c293
--- /dev/null
+++ b/pkgs/test_api/lib/src/backend/live_test_controller.dart
@@ -0,0 +1,178 @@
+// Copyright (c) 2015, 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 'dart:collection';
+
+import 'package:stack_trace/stack_trace.dart';
+
+import 'group.dart';
+import 'live_test.dart';
+import 'message.dart';
+import 'state.dart';
+import 'suite.dart';
+import 'test.dart';
+
+/// A concrete [LiveTest] that enforces some lifecycle guarantees.
+///
+/// This automatically handles some of [LiveTest]'s guarantees, but for the most
+/// part it's the caller's responsibility to make sure everything gets
+/// dispatched in the correct order.
+class LiveTestController extends LiveTest {
+ @Deprecated('Use this instance instead')
+ LiveTest get liveTest => this;
+
+ @override
+ final Suite suite;
+
+ @override
+ final List<Group> groups;
+
+ @override
+ final Test test;
+
+ /// The function that will actually start the test running.
+ final void Function() _onRun;
+
+ /// A function to run when the test is closed.
+ ///
+ /// This may be `null`.
+ final void Function() _onClose;
+
+ /// The list of errors caught by the test.
+ final _errors = <AsyncError>[];
+
+ @override
+ List<AsyncError> get errors => UnmodifiableListView(_errors);
+
+ /// The current state of the test.
+ @override
+ State state = const State(Status.pending, Result.success);
+
+ /// The controller for [onStateChange].
+ ///
+ /// This is synchronous to ensure that events are well-ordered across multiple
+ /// streams.
+ final _onStateChange = StreamController<State>.broadcast(sync: true);
+ @override
+ Stream<State> get onStateChange => _onStateChange.stream;
+
+ /// The controller for [onError].
+ ///
+ /// This is synchronous to ensure that events are well-ordered across multiple
+ /// streams.
+ final _onError = StreamController<AsyncError>.broadcast(sync: true);
+ @override
+ Stream<AsyncError> get onError => _onError.stream;
+
+ /// The controller for [onMessage].
+ ///
+ /// This is synchronous to ensure that events are well-ordered across multiple
+ /// streams.
+ final _onMessage = StreamController<Message>.broadcast(sync: true);
+ @override
+ Stream<Message> get onMessage => _onMessage.stream;
+
+ final completer = Completer<void>();
+
+ /// Whether [run] has been called.
+ var _runCalled = false;
+
+ /// Whether [close] has been called.
+ bool get _isClosed => _onError.isClosed;
+
+ /// Creates a new controller for a [LiveTest].
+ ///
+ /// [test] is the test being run; [suite] is the suite that contains it.
+ ///
+ /// [onRun] is a function that's called from [LiveTest.run]. It should start
+ /// the test running. The controller takes care of ensuring that
+ /// [LiveTest.run] isn't called more than once and that [LiveTest.onComplete]
+ /// is returned.
+ ///
+ /// [onClose] is a function that's called the first time [LiveTest.close] is
+ /// called. It should clean up any resources that have been allocated for the
+ /// test and ensure that the test finishes quickly if it's still running. It
+ /// will only be called if [onRun] has been called first.
+ ///
+ /// If [groups] is passed, it's used to populate the list of groups that
+ /// contain this test. Otherwise, `suite.group` is used.
+ LiveTestController(this.suite, this.test, this._onRun, this._onClose,
+ {Iterable<Group>? groups})
+ : groups = groups == null ? [suite.group] : List.unmodifiable(groups);
+
+ /// Adds an error to the [LiveTest].
+ ///
+ /// This both adds the error to [LiveTest.errors] and emits it via
+ /// [LiveTest.onError]. [stackTrace] is automatically converted into a [Chain]
+ /// if it's not one already.
+ void addError(Object error, StackTrace? stackTrace) {
+ if (_isClosed) return;
+
+ var asyncError = AsyncError(
+ error, Chain.forTrace(stackTrace ?? StackTrace.fromString('')));
+ _errors.add(asyncError);
+ _onError.add(asyncError);
+ }
+
+ /// Sets the current state of the [LiveTest] to [newState].
+ ///
+ /// If [newState] is different than the old state, this both sets
+ /// [LiveTest.state] and emits the new state via [LiveTest.onStateChanged]. If
+ /// it's not different, this does nothing.
+ void setState(State newState) {
+ if (_isClosed) return;
+ if (state == newState) return;
+
+ state = newState;
+ _onStateChange.add(newState);
+ }
+
+ /// Emits message over [LiveTest.onMessage].
+ void message(Message message) {
+ if (_onMessage.hasListener) {
+ _onMessage.add(message);
+ } else {
+ // Make sure all messages get surfaced one way or another to aid in
+ // debugging.
+ Zone.root.print(message.text);
+ }
+ }
+
+ @override
+ Future<void> run() {
+ if (_runCalled) {
+ throw StateError('LiveTest.run() may not be called more than once.');
+ } else if (_isClosed) {
+ throw StateError('LiveTest.run() may not be called for a closed '
+ 'test.');
+ }
+ _runCalled = true;
+
+ _onRun();
+ return onComplete;
+ }
+
+ /// Returns a future that completes when the test is complete.
+ ///
+ /// We also wait for the state to transition to Status.complete.
+ @override
+ Future<void> get onComplete => completer.future;
+
+ @override
+ Future<void> close() {
+ if (_isClosed) return onComplete;
+
+ _onStateChange.close();
+ _onError.close();
+
+ if (_runCalled) {
+ _onClose();
+ } else {
+ completer.complete();
+ }
+
+ return onComplete;
+ }
+}
diff --git a/pkgs/test_api/lib/src/backend/message.dart b/pkgs/test_api/lib/src/backend/message.dart
new file mode 100644
index 0000000..a027460
--- /dev/null
+++ b/pkgs/test_api/lib/src/backend/message.dart
@@ -0,0 +1,41 @@
+// Copyright (c) 2016, 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.
+
+/// A message emitted by a test.
+///
+/// A message encompasses any textual information that should be presented to
+/// the user. Reporters are encouraged to visually distinguish different message
+/// types.
+class Message {
+ final MessageType type;
+
+ final String text;
+
+ Message(this.type, this.text);
+
+ Message.print(this.text) : type = MessageType.print;
+ Message.skip(this.text) : type = MessageType.skip;
+}
+
+class MessageType {
+ /// A message explicitly printed by the user's test.
+ static const print = MessageType._('print');
+
+ /// A message indicating that a test, or some portion of one, was skipped.
+ static const skip = MessageType._('skip');
+
+ /// The name of the message type.
+ final String name;
+
+ factory MessageType.parse(String name) => switch (name) {
+ 'print' => MessageType.print,
+ 'skip' => MessageType.skip,
+ _ => throw ArgumentError('Invalid message type "$name".'),
+ };
+
+ const MessageType._(this.name);
+
+ @override
+ String toString() => name;
+}
diff --git a/pkgs/test_api/lib/src/backend/metadata.dart b/pkgs/test_api/lib/src/backend/metadata.dart
new file mode 100644
index 0000000..d0663b1
--- /dev/null
+++ b/pkgs/test_api/lib/src/backend/metadata.dart
@@ -0,0 +1,420 @@
+// Copyright (c) 2015, 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 'package:boolean_selector/boolean_selector.dart';
+import 'package:collection/collection.dart';
+
+import 'configuration/skip.dart';
+import 'configuration/timeout.dart';
+import 'platform_selector.dart';
+import 'suite_platform.dart';
+import 'util/identifier_regex.dart';
+import 'util/pretty_print.dart';
+
+/// Metadata for a test or test suite.
+///
+/// This metadata comes from declarations on the test itself; it doesn't include
+/// configuration from the user.
+final class Metadata {
+ /// Empty metadata with only default values.
+ ///
+ /// Using this is slightly more efficient than manually constructing a new
+ /// metadata with no arguments.
+ static final empty = Metadata._();
+
+ /// The selector indicating which platforms the suite supports.
+ final PlatformSelector testOn;
+
+ /// The modification to the timeout for the test or suite.
+ final Timeout timeout;
+
+ /// Whether the test or suite should be skipped.
+ bool get skip => _skip ?? false;
+ final bool? _skip;
+
+ /// The reason the test or suite should be skipped, if given.
+ final String? skipReason;
+
+ /// Whether to use verbose stack traces.
+ bool get verboseTrace => _verboseTrace ?? false;
+ final bool? _verboseTrace;
+
+ /// Whether to chain stack traces.
+ bool get chainStackTraces => _chainStackTraces ?? _verboseTrace ?? false;
+ final bool? _chainStackTraces;
+
+ /// The user-defined tags attached to the test or suite.
+ final Set<String> tags;
+
+ /// The number of times to re-run a test before being marked as a failure.
+ int get retry => _retry ?? 0;
+ final int? _retry;
+
+ /// Platform-specific metadata.
+ ///
+ /// Each key identifies a platform, and its value identifies the specific
+ /// metadata for that platform. These can be applied by calling [forPlatform].
+ final Map<PlatformSelector, Metadata> onPlatform;
+
+ /// Metadata that applies only when specific tags are applied.
+ ///
+ /// Tag-specific metadata is applied when merging this with other metadata.
+ /// Note that unlike [onPlatform], the base metadata takes precedence over any
+ /// tag-specific metadata.
+ ///
+ /// This is guaranteed not to have any keys that match [tags]; those are
+ /// resolved when the metadata is constructed.
+ final Map<BooleanSelector, Metadata> forTag;
+
+ /// The language version comment, if one is present.
+ ///
+ /// Only available for test suites and not individual tests.
+ final String? languageVersionComment;
+
+ /// Parses a user-provided map into the value for [onPlatform].
+ static Map<PlatformSelector, Metadata> _parseOnPlatform(
+ Map<String, dynamic>? onPlatform) {
+ if (onPlatform == null) return {};
+
+ var result = <PlatformSelector, Metadata>{};
+ onPlatform.forEach((platform, metadata) {
+ var selector = PlatformSelector.parse(platform);
+ if (metadata is Timeout || metadata is Skip) {
+ result[selector] = _parsePlatformOptions(platform, [metadata]);
+ } else if (metadata is List) {
+ result[selector] = _parsePlatformOptions(platform, metadata);
+ } else {
+ throw ArgumentError('Metadata for platform "$platform" must be a '
+ 'Timeout, Skip, or List of those; was "$metadata".');
+ }
+ });
+ return result;
+ }
+
+ static Metadata _parsePlatformOptions(
+ String platform, List<dynamic> metadata) {
+ Timeout? timeout;
+ dynamic skip;
+ for (var metadatum in metadata) {
+ if (metadatum is Timeout) {
+ if (timeout != null) {
+ throw ArgumentError('Only a single Timeout may be declared for '
+ '"$platform".');
+ }
+
+ timeout = metadatum;
+ } else if (metadatum is Skip) {
+ if (skip != null) {
+ throw ArgumentError('Only a single Skip may be declared for '
+ '"$platform".');
+ }
+
+ skip = metadatum.reason ?? true;
+ } else {
+ throw ArgumentError('Metadata for platform "$platform" must be a '
+ 'Timeout, Skip, or List of those; was "$metadata".');
+ }
+ }
+
+ return Metadata.parse(timeout: timeout, skip: skip);
+ }
+
+ /// Parses a user-provided [String] or [Iterable] into the value for [tags].
+ ///
+ /// Throws an [ArgumentError] if [tags] is not a [String] or an [Iterable].
+ static Set<String> _parseTags(Object? tags) {
+ if (tags == null) return {};
+ if (tags is String) return {tags};
+ if (tags is! Iterable) {
+ throw ArgumentError.value(
+ tags, 'tags', 'must be either a String or an Iterable.');
+ }
+
+ if (tags.any((tag) => tag is! String)) {
+ throw ArgumentError.value(tags, 'tags', 'must contain only Strings.');
+ }
+
+ return Set.from(tags);
+ }
+
+ /// Creates new Metadata.
+ ///
+ /// [testOn] defaults to [PlatformSelector.all].
+ ///
+ /// If [forTag] contains metadata that applies to [tags], that metadata is
+ /// included inline in the returned value. The values directly passed to the
+ /// constructor take precedence over tag-specific metadata.
+ factory Metadata(
+ {PlatformSelector? testOn,
+ Timeout? timeout,
+ bool? skip,
+ bool? verboseTrace,
+ bool? chainStackTraces,
+ int? retry,
+ String? skipReason,
+ Iterable<String>? tags,
+ Map<PlatformSelector, Metadata>? onPlatform,
+ Map<BooleanSelector, Metadata>? forTag,
+ String? languageVersionComment}) {
+ // Returns metadata without forTag resolved at all.
+ Metadata unresolved() => Metadata._(
+ testOn: testOn,
+ timeout: timeout,
+ skip: skip,
+ verboseTrace: verboseTrace,
+ chainStackTraces: chainStackTraces,
+ retry: retry,
+ skipReason: skipReason,
+ tags: tags,
+ onPlatform: onPlatform,
+ forTag: forTag,
+ languageVersionComment: languageVersionComment);
+
+ // If there's no tag-specific metadata, or if none of it applies, just
+ // return the metadata as-is.
+ if (forTag == null || tags == null) return unresolved();
+ tags = Set.from(tags);
+ forTag = Map.from(forTag);
+
+ // Otherwise, resolve the tag-specific components. Doing this eagerly means
+ // we only have to resolve suite- or group-level tags once, rather than
+ // doing it for every test individually.
+ var empty = Metadata._();
+ var merged = forTag.keys.toList().fold(empty, (Metadata merged, selector) {
+ if (!selector.evaluate(tags!.contains)) return merged;
+ return merged.merge(forTag!.remove(selector)!);
+ });
+
+ if (merged == empty) return unresolved();
+ return merged.merge(unresolved());
+ }
+
+ /// Creates new Metadata.
+ ///
+ /// Unlike [Metadata], this assumes [forTag] is already resolved.
+ Metadata._({
+ PlatformSelector? testOn,
+ Timeout? timeout,
+ bool? skip,
+ this.skipReason,
+ bool? verboseTrace,
+ bool? chainStackTraces,
+ int? retry,
+ Iterable<String>? tags,
+ Map<PlatformSelector, Metadata>? onPlatform,
+ Map<BooleanSelector, Metadata>? forTag,
+ this.languageVersionComment,
+ }) : testOn = testOn ?? PlatformSelector.all,
+ timeout = timeout ?? const Timeout.factor(1),
+ _skip = skip,
+ _verboseTrace = verboseTrace,
+ _chainStackTraces = chainStackTraces,
+ _retry = retry,
+ tags = UnmodifiableSetView(tags == null ? {} : tags.toSet()),
+ onPlatform =
+ onPlatform == null ? const {} : UnmodifiableMapView(onPlatform),
+ forTag = forTag == null ? const {} : UnmodifiableMapView(forTag) {
+ if (retry != null) RangeError.checkNotNegative(retry, 'retry');
+ _validateTags();
+ }
+
+ /// Creates a new Metadata, but with fields parsed from caller-friendly values
+ /// where applicable.
+ ///
+ /// Throws a [FormatException] if any field is invalid.
+ Metadata.parse(
+ {String? testOn,
+ Timeout? timeout,
+ dynamic skip,
+ bool? verboseTrace,
+ bool? chainStackTraces,
+ int? retry,
+ Map<String, dynamic>? onPlatform,
+ Object? /* String|Iterable<String> */ tags,
+ this.languageVersionComment})
+ : testOn = testOn == null
+ ? PlatformSelector.all
+ : PlatformSelector.parse(testOn),
+ timeout = timeout ?? const Timeout.factor(1),
+ _skip = skip == null ? null : skip != false,
+ _verboseTrace = verboseTrace,
+ _chainStackTraces = chainStackTraces,
+ _retry = retry,
+ skipReason = skip is String ? skip : null,
+ onPlatform = _parseOnPlatform(onPlatform),
+ tags = _parseTags(tags),
+ forTag = const {} {
+ if (skip != null && skip is! String && skip is! bool) {
+ throw ArgumentError('"skip" must be a String or a bool, was "$skip".');
+ }
+
+ if (retry != null) RangeError.checkNotNegative(retry, 'retry');
+
+ _validateTags();
+ }
+
+ /// Deserializes the result of [Metadata.serialize] into a new [Metadata].
+ Metadata.deserialize(Map serialized)
+ : testOn = serialized['testOn'] == null
+ ? PlatformSelector.all
+ : PlatformSelector.parse(serialized['testOn'] as String),
+ timeout = _deserializeTimeout(serialized['timeout']),
+ _skip = serialized['skip'] as bool?,
+ skipReason = serialized['skipReason'] as String?,
+ _verboseTrace = serialized['verboseTrace'] as bool?,
+ _chainStackTraces = serialized['chainStackTraces'] as bool?,
+ _retry = (serialized['retry'] as num?)?.toInt(),
+ tags = Set.from(serialized['tags'] as Iterable),
+ onPlatform = {
+ for (var pair in serialized['onPlatform'] as List)
+ PlatformSelector.parse(pair.first as String):
+ Metadata.deserialize(pair.last as Map)
+ },
+ forTag = (serialized['forTag'] as Map).map((key, nested) => MapEntry(
+ BooleanSelector.parse(key as String),
+ Metadata.deserialize(nested as Map))),
+ languageVersionComment =
+ serialized['languageVersionComment'] as String?;
+
+ /// Deserializes timeout from the format returned by [_serializeTimeout].
+ static Timeout _deserializeTimeout(Object? serialized) {
+ if (serialized == 'none') return Timeout.none;
+ var scaleFactor = (serialized as Map)['scaleFactor'];
+ if (scaleFactor != null) return Timeout.factor(scaleFactor as num);
+ return Timeout(
+ Duration(microseconds: (serialized['duration'] as num).toInt()));
+ }
+
+ /// Throws an [ArgumentError] if any tags in [tags] aren't hyphenated
+ /// identifiers.
+ void _validateTags() {
+ var invalidTags = tags
+ .where((tag) => !tag.contains(anchoredHyphenatedIdentifier))
+ .map((tag) => '"$tag"')
+ .toList();
+
+ if (invalidTags.isEmpty) return;
+
+ throw ArgumentError("Invalid ${pluralize('tag', invalidTags.length)} "
+ '${toSentence(invalidTags)}. Tags must be (optionally hyphenated) '
+ 'Dart identifiers.');
+ }
+
+ /// Throws a [FormatException] if any [PlatformSelector]s use any variables
+ /// that don't appear either in [validVariables] or in the set of variables
+ /// that are known to be valid for all selectors.
+ void validatePlatformSelectors(Set<String> validVariables) {
+ testOn.validate(validVariables);
+ onPlatform.forEach((selector, metadata) {
+ selector.validate(validVariables);
+ metadata.validatePlatformSelectors(validVariables);
+ });
+ }
+
+ /// Return a new [Metadata] that merges [this] with [other].
+ ///
+ /// If the two [Metadata]s have conflicting properties, [other] wins. If
+ /// either has a [forTag] metadata for one of the other's tags, that metadata
+ /// is merged as well.
+ Metadata merge(Metadata other) => Metadata(
+ testOn: testOn.intersection(other.testOn),
+ timeout: timeout.merge(other.timeout),
+ skip: other._skip ?? _skip,
+ skipReason: other.skipReason ?? skipReason,
+ verboseTrace: other._verboseTrace ?? _verboseTrace,
+ chainStackTraces: other._chainStackTraces ?? _chainStackTraces,
+ retry: other._retry ?? _retry,
+ tags: tags.union(other.tags),
+ onPlatform: mergeMaps(onPlatform, other.onPlatform,
+ value: (metadata1, metadata2) => metadata1.merge(metadata2)),
+ forTag: mergeMaps(forTag, other.forTag,
+ value: (metadata1, metadata2) => metadata1.merge(metadata2)),
+ languageVersionComment:
+ other.languageVersionComment ?? languageVersionComment);
+
+ /// Returns a copy of [this] with the given fields changed.
+ Metadata change(
+ {PlatformSelector? testOn,
+ Timeout? timeout,
+ bool? skip,
+ bool? verboseTrace,
+ bool? chainStackTraces,
+ int? retry,
+ String? skipReason,
+ Map<PlatformSelector, Metadata>? onPlatform,
+ Set<String>? tags,
+ Map<BooleanSelector, Metadata>? forTag,
+ String? languageVersionComment}) {
+ testOn ??= this.testOn;
+ timeout ??= this.timeout;
+ skip ??= _skip;
+ verboseTrace ??= _verboseTrace;
+ chainStackTraces ??= _chainStackTraces;
+ retry ??= _retry;
+ skipReason ??= this.skipReason;
+ onPlatform ??= this.onPlatform;
+ tags ??= this.tags;
+ forTag ??= this.forTag;
+ languageVersionComment ??= this.languageVersionComment;
+ return Metadata(
+ testOn: testOn,
+ timeout: timeout,
+ skip: skip,
+ verboseTrace: verboseTrace,
+ chainStackTraces: chainStackTraces,
+ skipReason: skipReason,
+ onPlatform: onPlatform,
+ tags: tags,
+ forTag: forTag,
+ retry: retry,
+ languageVersionComment: languageVersionComment);
+ }
+
+ /// Returns a copy of [this] with all platform-specific metadata from
+ /// [onPlatform] resolved.
+ Metadata forPlatform(SuitePlatform platform) {
+ if (onPlatform.isEmpty) return this;
+
+ var metadata = this;
+ onPlatform.forEach((platformSelector, platformMetadata) {
+ if (!platformSelector.evaluate(platform)) return;
+ metadata = metadata.merge(platformMetadata);
+ });
+ return metadata.change(onPlatform: {});
+ }
+
+ /// Serializes [this] into a JSON-safe object that can be deserialized using
+ /// [Metadata.deserialize].
+ Map<String, dynamic> serialize() {
+ // Make this a list to guarantee that the order is preserved.
+ var serializedOnPlatform = <List<Object>>[];
+ onPlatform.forEach((key, value) {
+ serializedOnPlatform.add([key.toString(), value.serialize()]);
+ });
+
+ return {
+ 'testOn': testOn == PlatformSelector.all ? null : testOn.toString(),
+ 'timeout': _serializeTimeout(timeout),
+ 'skip': _skip,
+ 'skipReason': skipReason,
+ 'verboseTrace': _verboseTrace,
+ 'chainStackTraces': _chainStackTraces,
+ 'retry': _retry,
+ 'tags': tags.toList(),
+ 'onPlatform': serializedOnPlatform,
+ 'forTag': forTag.map((selector, metadata) =>
+ MapEntry(selector.toString(), metadata.serialize())),
+ 'languageVersionComment': languageVersionComment,
+ };
+ }
+
+ /// Serializes timeout into a JSON-safe object.
+ dynamic _serializeTimeout(Timeout timeout) {
+ if (timeout == Timeout.none) return 'none';
+ return {
+ 'duration': timeout.duration?.inMicroseconds,
+ 'scaleFactor': timeout.scaleFactor
+ };
+ }
+}
diff --git a/pkgs/test_api/lib/src/backend/operating_system.dart b/pkgs/test_api/lib/src/backend/operating_system.dart
new file mode 100644
index 0000000..a86c1e7
--- /dev/null
+++ b/pkgs/test_api/lib/src/backend/operating_system.dart
@@ -0,0 +1,74 @@
+// Copyright (c) 2015, 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.
+
+/// An enum of all operating systems supported by Dart.
+///
+/// This is used for selecting which operating systems a test can run on. Even
+/// for browser tests, this indicates the operating system of the machine
+/// running the test runner.
+class OperatingSystem {
+ /// Microsoft Windows.
+ static const windows = OperatingSystem._('Windows', 'windows');
+
+ /// Mac OS X.
+ static const macOS = OperatingSystem._('OS X', 'mac-os');
+
+ /// GNU/Linux.
+ static const linux = OperatingSystem._('Linux', 'linux');
+
+ /// Android.
+ ///
+ /// Since this is the operating system the test runner is running on, this
+ /// won't be true when testing remotely on an Android browser.
+ static const android = OperatingSystem._('Android', 'android');
+
+ /// iOS.
+ ///
+ /// Since this is the operating system the test runner is running on, this
+ /// won't be true when testing remotely on an iOS browser.
+ static const iOS = OperatingSystem._('iOS', 'ios');
+
+ /// No operating system.
+ ///
+ /// This is used when running in the browser, or if an unrecognized operating
+ /// system is used. It can't be referenced by name in platform selectors.
+ static const none = OperatingSystem._('none', 'none');
+
+ /// A list of all instances of [OperatingSystem] other than [none].
+ static const all = [windows, macOS, linux, android, iOS];
+
+ /// Finds an operating system by its name.
+ ///
+ /// If no operating system is found, returns [none].
+ static OperatingSystem find(String identifier) =>
+ all.firstWhere((platform) => platform.identifier == identifier,
+ orElse: () => none);
+
+ /// Finds an operating system by the return value from `dart:io`'s
+ /// `Platform.operatingSystem`.
+ ///
+ /// If no operating system is found, returns [none].
+ static OperatingSystem findByIoName(String name) => switch (name) {
+ 'windows' => windows,
+ 'macos' => macOS,
+ 'linux' => linux,
+ 'android' => android,
+ 'ios' => iOS,
+ _ => none,
+ };
+
+ /// The human-friendly of the operating system.
+ final String name;
+
+ /// The identifier used to look up the operating system.
+ final String identifier;
+
+ /// Whether this is a POSIX-ish operating system.
+ bool get isPosix => this != windows && this != none;
+
+ const OperatingSystem._(this.name, this.identifier);
+
+ @override
+ String toString() => name;
+}
diff --git a/pkgs/test_api/lib/src/backend/platform_selector.dart b/pkgs/test_api/lib/src/backend/platform_selector.dart
new file mode 100644
index 0000000..c65dc8b
--- /dev/null
+++ b/pkgs/test_api/lib/src/backend/platform_selector.dart
@@ -0,0 +1,116 @@
+// Copyright (c) 2015, 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 'package:boolean_selector/boolean_selector.dart';
+import 'package:source_span/source_span.dart';
+
+import 'compiler.dart';
+import 'operating_system.dart';
+import 'runtime.dart';
+import 'suite_platform.dart';
+
+/// The set of variable names that are valid for all platform selectors.
+final _universalValidVariables = {
+ 'posix',
+ 'dart-vm',
+ 'browser',
+ 'js',
+ 'blink',
+ 'google',
+ 'wasm',
+ for (var runtime in Runtime.builtIn) runtime.identifier,
+ for (var compiler in Compiler.builtIn) compiler.identifier,
+ for (var os in OperatingSystem.all) os.identifier,
+};
+
+/// An expression for selecting certain platforms, including operating systems
+/// and browsers.
+///
+/// This uses the [boolean selector][] syntax.
+///
+/// [boolean selector]: https://pub.dev/packages/boolean_selector
+final class PlatformSelector {
+ /// A selector that declares that a test can be run on all platforms.
+ static const all = PlatformSelector._(BooleanSelector.all);
+
+ /// The boolean selector used to implement this selector.
+ final BooleanSelector _inner;
+
+ /// The source span from which this selector was parsed.
+ final SourceSpan? _span;
+
+ /// Parses [selector].
+ ///
+ /// If [span] is passed, it indicates the location of the text for [selector]
+ /// in a larger document. It's used for error reporting.
+ PlatformSelector.parse(String selector, [SourceSpan? span])
+ : _inner =
+ _wrapFormatException(() => BooleanSelector.parse(selector), span),
+ _span = span;
+
+ const PlatformSelector._(this._inner) : _span = null;
+
+ /// Runs [body] and wraps any [FormatException] it throws in a
+ /// [SourceSpanFormatException] using [span].
+ ///
+ /// If [span] is `null`, runs [body] as-is.
+ static T _wrapFormatException<T>(T Function() body, [SourceSpan? span]) {
+ if (span == null) return body();
+
+ try {
+ return body();
+ } on FormatException catch (error) {
+ throw SourceSpanFormatException(error.message, span);
+ }
+ }
+
+ /// Throws a [FormatException] if this selector uses any variables that don't
+ /// appear either in [validVariables] or in the set of variables that are
+ /// known to be valid for all selectors.
+ void validate(Set<String> validVariables) {
+ if (identical(this, all)) return;
+
+ _wrapFormatException(
+ () => _inner.validate((name) =>
+ _universalValidVariables.contains(name) ||
+ validVariables.contains(name)),
+ _span);
+ }
+
+ /// Returns whether the selector matches the given [platform].
+ bool evaluate(SuitePlatform platform) =>
+ _inner.evaluate((String variable) => switch (variable) {
+ _
+ when variable == platform.runtime.identifier ||
+ variable == platform.runtime.parent?.identifier ||
+ variable == platform.os.identifier ||
+ variable == platform.compiler.identifier =>
+ true,
+ 'dart-vm' => platform.runtime.isDartVM,
+ 'browser' => platform.runtime.isBrowser,
+ 'js' => platform.compiler.isJS,
+ 'blink' => platform.runtime.isBlink,
+ 'posix' => platform.os.isPosix,
+ 'google' => platform.inGoogle,
+ 'wasm' => platform.compiler.isWasm,
+ _ => false,
+ });
+
+ /// Returns a new [PlatformSelector] that matches only platforms matched by
+ /// both [this] and [other].
+ PlatformSelector intersection(PlatformSelector other) {
+ if (other == PlatformSelector.all) return this;
+ return PlatformSelector._(_inner.intersection(other._inner));
+ }
+
+ @override
+ String toString() => _inner.toString();
+
+ @override
+ bool operator ==(Object other) =>
+ other is PlatformSelector && _inner == other._inner;
+
+ @override
+ int get hashCode => _inner.hashCode;
+}
diff --git a/pkgs/test_api/lib/src/backend/remote_exception.dart b/pkgs/test_api/lib/src/backend/remote_exception.dart
new file mode 100644
index 0000000..0d70561
--- /dev/null
+++ b/pkgs/test_api/lib/src/backend/remote_exception.dart
@@ -0,0 +1,88 @@
+// Copyright (c) 2015, 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:stack_trace/stack_trace.dart';
+
+import 'test_failure.dart';
+
+/// An exception that was thrown remotely.
+///
+/// This could be an exception thrown in a different isolate, a different
+/// process, or on an entirely different computer.
+final class RemoteException implements Exception {
+ /// The original exception's message, if it had one.
+ ///
+ /// If the original exception was a plain string, this will contain that
+ /// string.
+ final String? message;
+
+ /// The value of the original exception's `runtimeType.toString()`.
+ final String type;
+
+ /// The value of the original exception's `toString()`.
+ final String _toString;
+
+ /// Serializes [error] and [stackTrace] into a JSON-safe object.
+ ///
+ /// Other than JSON- and isolate-safety, no guarantees are made about the
+ /// serialized format.
+ static Map<String, dynamic> serialize(dynamic error, StackTrace stackTrace) {
+ String? message;
+ if (error is String) {
+ message = error;
+ } else {
+ try {
+ message = error.message.toString();
+ } on NoSuchMethodError catch (_) {
+ // Do nothing.
+ }
+ }
+
+ final supertype = (error is TestFailure) ? 'TestFailure' : null;
+
+ return {
+ 'message': message,
+ 'type': error.runtimeType.toString(),
+ 'supertype': supertype,
+ 'toString': error.toString(),
+ 'stackChain': Chain.forTrace(stackTrace).toString()
+ };
+ }
+
+ /// Deserializes an exception serialized with [RemoteException.serialize].
+ ///
+ /// The returned [AsyncError] is guaranteed to have a [RemoteException] as its
+ /// error and a [Chain] as its stack trace.
+ static AsyncError deserialize(Map serialized) {
+ return AsyncError(_deserializeException(serialized),
+ Chain.parse(serialized['stackChain'] as String));
+ }
+
+ /// Deserializes the exception portion of [serialized].
+ static RemoteException _deserializeException(Map serialized) {
+ final message = serialized['message'] as String?;
+ final type = serialized['type'] as String;
+ final toString = serialized['toString'] as String;
+
+ return switch (serialized['supertype'] as String?) {
+ 'TestFailure' => _RemoteTestFailure(message, type, toString),
+ _ => RemoteException._(message, type, toString),
+ };
+ }
+
+ RemoteException._(this.message, this.type, this._toString);
+
+ @override
+ String toString() => _toString;
+}
+
+/// A subclass of [RemoteException] that implements [TestFailure].
+///
+/// It's important to preserve [TestFailure]-ness, because tests have different
+/// results depending on whether an exception was a failure or an error.
+final class _RemoteTestFailure extends RemoteException implements TestFailure {
+ _RemoteTestFailure(super.message, super.type, super.toString) : super._();
+}
diff --git a/pkgs/test_api/lib/src/backend/remote_listener.dart b/pkgs/test_api/lib/src/backend/remote_listener.dart
new file mode 100644
index 0000000..66a0814
--- /dev/null
+++ b/pkgs/test_api/lib/src/backend/remote_listener.dart
@@ -0,0 +1,276 @@
+// Copyright (c) 2016, 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:async/async.dart';
+import 'package:stream_channel/stream_channel.dart';
+import 'package:term_glyph/term_glyph.dart' as glyph;
+
+import 'declarer.dart';
+import 'group.dart';
+import 'invoker.dart';
+import 'live_test.dart';
+import 'metadata.dart';
+import 'remote_exception.dart';
+import 'stack_trace_formatter.dart';
+import 'suite.dart';
+import 'suite_channel_manager.dart';
+import 'suite_platform.dart';
+import 'test.dart';
+
+final class RemoteListener {
+ /// The test suite to run.
+ final Suite _suite;
+
+ /// The zone to forward prints to, or `null` if prints shouldn't be forwarded.
+ final Zone? _printZone;
+
+ /// Extracts metadata about all the tests in the function returned by
+ /// [getMain] and returns a channel that will send information about them.
+ ///
+ /// The main function is wrapped in a closure so that we can handle it being
+ /// undefined here rather than in the generated code.
+ ///
+ /// Once that's done, this starts listening for commands about which tests to
+ /// run.
+ ///
+ /// If [hidePrints] is `true` (the default), calls to `print()` within this
+ /// suite will not be forwarded to the parent zone's print handler. However,
+ /// the caller may want them to be forwarded in (for example) a browser
+ /// context where they'll be visible in the development console.
+ ///
+ /// If [beforeLoad] is passed, it's called before the tests have been declared
+ /// for this worker.
+ static StreamChannel<Object?> start(Function Function() getMain,
+ {bool hidePrints = true,
+ Future Function(
+ StreamChannel<Object?> Function(String name) suiteChannel)?
+ beforeLoad}) {
+ // Synchronous in order to allow `print` output to show up immediately, even
+ // if they are followed by long running synchronous work.
+ var controller =
+ StreamChannelController<Object?>(allowForeignErrors: false, sync: true);
+ var channel = MultiChannel<Object?>(controller.local);
+
+ var verboseChain = true;
+
+ var printZone = hidePrints ? null : Zone.current;
+ var spec = ZoneSpecification(print: (_, __, ___, line) {
+ if (printZone != null) printZone.print(line);
+ channel.sink.add({'type': 'print', 'line': line});
+ });
+
+ final suiteChannelManager = SuiteChannelManager();
+ StackTraceFormatter().asCurrent(() {
+ runZonedGuarded(() async {
+ Function? main;
+ try {
+ main = getMain();
+ } on NoSuchMethodError catch (_) {
+ _sendLoadException(channel, 'No top-level main() function defined.');
+ return;
+ } catch (error, stackTrace) {
+ _sendError(channel, error, stackTrace, verboseChain);
+ return;
+ }
+
+ if (main is! FutureOr<void> Function()) {
+ _sendLoadException(
+ channel, 'Top-level main() function takes arguments.');
+ return;
+ }
+
+ var queue = StreamQueue(channel.stream);
+ var message = await queue.next as Map;
+ assert(message['type'] == 'initial');
+
+ queue.rest.cast<Map>().listen((message) {
+ if (message['type'] == 'close') {
+ controller.local.sink.close();
+ return;
+ }
+
+ assert(message['type'] == 'suiteChannel');
+ suiteChannelManager.connectIn(message['name'] as String,
+ channel.virtualChannel((message['id'] as num).toInt()));
+ });
+
+ if ((message['asciiGlyphs'] as bool?) ?? false) glyph.ascii = true;
+ var metadata = Metadata.deserialize(message['metadata'] as Map);
+ verboseChain = metadata.verboseTrace;
+ var declarer = Declarer(
+ metadata: metadata,
+ platformVariables: Set.from(message['platformVariables'] as Iterable),
+ collectTraces: message['collectTraces'] as bool,
+ noRetry: message['noRetry'] as bool,
+ // TODO: Change to non-nullable https://github.com/dart-lang/test/issues/1591
+ allowDuplicateTestNames:
+ message['allowDuplicateTestNames'] as bool? ?? true,
+ );
+ StackTraceFormatter.current!.configure(
+ except: _deserializeSet(message['foldTraceExcept'] as List),
+ only: _deserializeSet(message['foldTraceOnly'] as List));
+
+ if (beforeLoad != null) {
+ await beforeLoad(suiteChannelManager.connectOut);
+ }
+
+ await declarer.declare(main);
+
+ var suite = Suite(
+ declarer.build(),
+ SuitePlatform.deserialize(message['platform'] as Object),
+ path: message['path'] as String,
+ ignoreTimeouts: message['ignoreTimeouts'] as bool? ?? false,
+ );
+
+ runZoned(() {
+ Invoker.guard(
+ () => RemoteListener._(suite, printZone)._listen(channel));
+ },
+ // Make the declarer visible to running tests so that they'll throw
+ // useful errors when calling `test()` and `group()` within a test,
+ // and so they can add to the declarer's `tearDownAll()` list.
+ zoneValues: {#test.declarer: declarer});
+ }, (error, stackTrace) {
+ _sendError(channel, error, stackTrace, verboseChain);
+ }, zoneSpecification: spec);
+ });
+
+ return controller.foreign;
+ }
+
+ /// Returns a [Set] from a JSON serialized list of strings, or `null` if the
+ /// list is empty or `null`.
+ static Set<String>? _deserializeSet(List? list) {
+ if (list == null) return null;
+ if (list.isEmpty) return null;
+ return Set.from(list);
+ }
+
+ /// Sends a message over [channel] indicating that the tests failed to load.
+ ///
+ /// [message] should describe the failure.
+ static void _sendLoadException(StreamChannel channel, String message) {
+ channel.sink.add({'type': 'loadException', 'message': message});
+ }
+
+ /// Sends a message over [channel] indicating an error from user code.
+ static void _sendError(StreamChannel channel, Object error,
+ StackTrace stackTrace, bool verboseChain) {
+ channel.sink.add({
+ 'type': 'error',
+ 'error': RemoteException.serialize(
+ error,
+ StackTraceFormatter.current!
+ .formatStackTrace(stackTrace, verbose: verboseChain))
+ });
+ }
+
+ RemoteListener._(this._suite, this._printZone);
+
+ /// Send information about [_suite] across [channel] and start listening for
+ /// commands to run the tests.
+ void _listen(MultiChannel channel) {
+ channel.sink.add({
+ 'type': 'success',
+ 'root': _serializeGroup(channel, _suite.group, [])
+ });
+ }
+
+ /// Serializes [group] into a JSON-safe map.
+ ///
+ /// [parents] lists the groups that contain [group].
+ Map _serializeGroup(
+ MultiChannel channel, Group group, Iterable<Group> parents) {
+ parents = parents.toList()..add(group);
+ return {
+ 'type': 'group',
+ 'name': group.name,
+ 'metadata': group.metadata.serialize(),
+ 'trace': group.trace == null
+ ? null
+ : StackTraceFormatter.current
+ ?.formatStackTrace(group.trace!)
+ .toString() ??
+ group.trace?.toString(),
+ 'setUpAll': _serializeTest(channel, group.setUpAll, parents),
+ 'tearDownAll': _serializeTest(channel, group.tearDownAll, parents),
+ 'entries': group.entries.map((entry) {
+ return entry is Group
+ ? _serializeGroup(channel, entry, parents)
+ : _serializeTest(channel, entry as Test, parents);
+ }).toList()
+ };
+ }
+
+ /// Serializes [test] into a JSON-safe map.
+ ///
+ /// [groups] lists the groups that contain [test]. Returns `null` if [test]
+ /// is `null`.
+ Map? _serializeTest(
+ MultiChannel channel, Test? test, Iterable<Group>? groups) {
+ if (test == null) return null;
+
+ var testChannel = channel.virtualChannel();
+ testChannel.stream.listen((message) {
+ assert(message['command'] == 'run');
+ _runLiveTest(test.load(_suite, groups: groups),
+ channel.virtualChannel((message['channel'] as num).toInt()));
+ });
+
+ return {
+ 'type': 'test',
+ 'name': test.name,
+ 'metadata': test.metadata.serialize(),
+ 'trace': test.trace == null
+ ? null
+ : StackTraceFormatter.current
+ ?.formatStackTrace(test.trace!)
+ .toString() ??
+ test.trace?.toString(),
+ 'channel': testChannel.id
+ };
+ }
+
+ /// Runs [liveTest] and sends the results across [channel].
+ void _runLiveTest(LiveTest liveTest, MultiChannel channel) {
+ channel.stream.listen((message) {
+ assert(message['command'] == 'close');
+ liveTest.close();
+ });
+
+ liveTest.onStateChange.listen((state) {
+ channel.sink.add({
+ 'type': 'state-change',
+ 'status': state.status.name,
+ 'result': state.result.name
+ });
+ });
+
+ liveTest.onError.listen((asyncError) {
+ channel.sink.add({
+ 'type': 'error',
+ 'error': RemoteException.serialize(
+ asyncError.error,
+ StackTraceFormatter.current!.formatStackTrace(asyncError.stackTrace,
+ verbose: liveTest.test.metadata.verboseTrace))
+ });
+ });
+
+ liveTest.onMessage.listen((message) {
+ if (_printZone != null) _printZone.print(message.text);
+ channel.sink.add({
+ 'type': 'message',
+ 'message-type': message.type.name,
+ 'text': message.text
+ });
+ });
+
+ runZoned(() {
+ liveTest.run().then((_) => channel.sink.add({'type': 'complete'}));
+ }, zoneValues: {#test.runner.test_channel: channel});
+ }
+}
diff --git a/pkgs/test_api/lib/src/backend/runtime.dart b/pkgs/test_api/lib/src/backend/runtime.dart
new file mode 100644
index 0000000..ceef227
--- /dev/null
+++ b/pkgs/test_api/lib/src/backend/runtime.dart
@@ -0,0 +1,193 @@
+// Copyright (c) 2015, 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 'compiler.dart';
+
+/// An enum of all Dart runtimes supported by the test runner.
+final class Runtime {
+ // When adding new runtimes, be sure to update the baseline and derived
+ // variable tests in test/backend/platform_selector/evaluate_test.
+
+ /// The command-line Dart VM.
+ static const Runtime vm = Runtime('VM', 'vm', Compiler.kernel,
+ [Compiler.kernel, Compiler.source, Compiler.exe],
+ isDartVM: true);
+
+ /// Google Chrome.
+ static const Runtime chrome = Runtime('Chrome', 'chrome', Compiler.dart2js,
+ [Compiler.dart2js, Compiler.dart2wasm],
+ isBrowser: true, isBlink: true);
+
+ /// Mozilla Firefox.
+ static const Runtime firefox = Runtime('Firefox', 'firefox', Compiler.dart2js,
+ [Compiler.dart2js, Compiler.dart2wasm],
+ isBrowser: true);
+
+ /// Apple Safari.
+ static const Runtime safari = Runtime(
+ 'Safari', 'safari', Compiler.dart2js, [Compiler.dart2js],
+ isBrowser: true);
+
+ /// Microsoft Internet Explorer.
+ @Deprecated('Internet Explorer is no longer supported')
+ static const Runtime internetExplorer = Runtime(
+ 'Internet Explorer', 'ie', Compiler.dart2js, [Compiler.dart2js],
+ isBrowser: true);
+
+ /// Microsoft Edge (based on Chromium).
+ static const Runtime edge = Runtime(
+ 'Microsoft Edge', 'edge', Compiler.dart2js, [Compiler.dart2js],
+ isBrowser: true, isBlink: true);
+
+ /// The command-line Node.js VM.
+ static const Runtime nodeJS = Runtime('Node.js', 'node', Compiler.dart2js,
+ [Compiler.dart2js, Compiler.dart2wasm]);
+
+ /// The platforms that are supported by the test runner by default.
+ static const List<Runtime> builtIn = [
+ Runtime.vm,
+ Runtime.chrome,
+ Runtime.firefox,
+ Runtime.safari,
+ Runtime.edge,
+ Runtime.nodeJS,
+ ];
+
+ /// The human-friendly name of the platform.
+ final String name;
+
+ /// The identifier used to look up the platform.
+ final String identifier;
+
+ /// The parent platform that this is based on, or `null` if there is no
+ /// parent.
+ final Runtime? parent;
+
+ /// Returns whether this is a child of another platform.
+ bool get isChild => parent != null;
+
+ /// Whether this platform runs the Dart VM in any capacity.
+ final bool isDartVM;
+
+ /// Whether this platform is a browser.
+ final bool isBrowser;
+
+ /// Whether this platform uses the Blink rendering engine.
+ final bool isBlink;
+
+ /// Whether this platform has no visible window.
+ final bool isHeadless;
+
+ /// Returns the platform this is based on, or [this] if it's not based on
+ /// anything.
+ ///
+ /// That is, returns [parent] if it's non-`null` or [this] if it's `null`.
+ Runtime get root => parent ?? this;
+
+ /// The default compiler to use with this runtime.
+ final Compiler defaultCompiler;
+
+ /// All the supported compilers for this runtime.
+ final List<Compiler> supportedCompilers;
+
+ const Runtime(
+ this.name, this.identifier, this.defaultCompiler, this.supportedCompilers,
+ {this.isDartVM = false,
+ this.isBrowser = false,
+ this.isBlink = false,
+ this.isHeadless = false})
+ : parent = null;
+
+ Runtime._child(this.name, this.identifier, this.defaultCompiler,
+ this.supportedCompilers, Runtime this.parent)
+ : isDartVM = parent.isDartVM,
+ isBrowser = parent.isBrowser,
+ isBlink = parent.isBlink,
+ isHeadless = parent.isHeadless;
+
+ /// Converts a JSON-safe representation generated by [serialize] back into a
+ /// [Runtime].
+ factory Runtime.deserialize(Object serialized) {
+ if (serialized is String) {
+ return builtIn
+ .firstWhere((platform) => platform.identifier == serialized);
+ }
+
+ var map = serialized as Map;
+ var name = map['name'] as String;
+ var identifier = map['identifier'] as String;
+ var defaultCompiler =
+ Compiler.deserialize(map['defaultCompiler'] as Object);
+ var supportedCompilers = [
+ for (var compiler in map['supportedCompilers'] as List)
+ Compiler.deserialize(compiler as Object),
+ ];
+
+ var parent = map['parent'];
+ if (parent != null) {
+ // Note that the returned platform's [parent] won't necessarily be `==` to
+ // a separately-deserialized parent platform. This should be fine, though,
+ // since we only deserialize platforms in the remote execution context
+ // where they're only used to evaluate platform selectors.
+ return Runtime._child(name, identifier, defaultCompiler,
+ supportedCompilers, Runtime.deserialize(parent as Object));
+ }
+
+ return Runtime(name, identifier, defaultCompiler, supportedCompilers,
+ isDartVM: map['isDartVM'] as bool,
+ isBrowser: map['isBrowser'] as bool,
+ isBlink: map['isBlink'] as bool,
+ isHeadless: map['isHeadless'] as bool);
+ }
+
+ /// Converts [this] into a JSON-safe object that can be converted back to a
+ /// [Runtime] using [Runtime.deserialize].
+ Object serialize() {
+ if (builtIn.contains(this)) return identifier;
+
+ if (parent != null) {
+ return {
+ 'name': name,
+ 'defaultCompiler': defaultCompiler.serialize(),
+ 'supportedCompilers': [
+ for (var compiler in supportedCompilers) compiler.serialize(),
+ ],
+ 'identifier': identifier,
+ 'parent': parent!.serialize()
+ };
+ }
+
+ return {
+ 'name': name,
+ 'defaultCompiler': defaultCompiler.serialize(),
+ 'supportedCompilers': [
+ for (var compiler in supportedCompilers) compiler.serialize(),
+ ],
+ 'identifier': identifier,
+ 'isDartVM': isDartVM,
+ 'isBrowser': isBrowser,
+ 'isBlink': isBlink,
+ 'isHeadless': isHeadless,
+ // TODO(https://github.com/dart-lang/test/issues/2146): Remove this.
+ 'isJS': isBrowser || this == Runtime.nodeJS,
+ // TODO(https://github.com/dart-lang/test/issues/2146): Remove this.
+ 'isWasm': false,
+ };
+ }
+
+ /// Returns a child of [this] that counts as both this platform's identifier
+ /// and the new [identifier].
+ ///
+ /// This may not be called on a platform that's already a child.
+ Runtime extend(String name, String identifier) {
+ if (parent == null) {
+ return Runtime._child(
+ name, identifier, defaultCompiler, supportedCompilers, this);
+ }
+ throw StateError('A child platform may not be extended.');
+ }
+
+ @override
+ String toString() => name;
+}
diff --git a/pkgs/test_api/lib/src/backend/stack_trace_formatter.dart b/pkgs/test_api/lib/src/backend/stack_trace_formatter.dart
new file mode 100644
index 0000000..a495e89
--- /dev/null
+++ b/pkgs/test_api/lib/src/backend/stack_trace_formatter.dart
@@ -0,0 +1,75 @@
+// Copyright (c) 2018, 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:stack_trace/stack_trace.dart';
+
+import 'invoker.dart';
+import 'stack_trace_mapper.dart';
+
+/// The key used to look up [StackTraceFormatter.current] in a zone.
+final _currentKey = Object();
+
+/// A class that tracks how to format a stack trace according to the user's
+/// configuration.
+///
+/// This can convert JavaScript stack traces to Dart using source maps, and fold
+/// irrelevant frames out of the stack trace.
+final class StackTraceFormatter {
+ /// A class that converts [trace] into a Dart stack trace, or `null` to use it
+ /// as-is.
+ StackTraceMapper? _mapper;
+
+ /// The set of packages to fold when producing terse [Chain]s.
+ var _except = {'matcher', 'stream_channel', 'test', 'test_api'};
+
+ /// If non-empty, all packages not in this list will be folded when producing
+ /// terse [Chain]s.
+ var _only = <String>{};
+
+ /// Returns the current manager, or `null` if this isn't called within a call
+ /// to [asCurrent].
+ static StackTraceFormatter? get current =>
+ Zone.current[_currentKey] as StackTraceFormatter?;
+
+ /// Runs [body] with this as [StackTraceFormatter.current].
+ ///
+ /// This is zone-scoped, so this will be the current configuration in any
+ /// asynchronous callbacks transitively created by [body].
+ T asCurrent<T>(T Function() body) =>
+ runZoned(body, zoneValues: {_currentKey: this});
+
+ /// Configure how stack traces are formatted.
+ ///
+ /// The [mapper] is used to convert JavaScript traces into Dart traces. The
+ /// [except] set indicates packages whose frames should be folded away. If
+ /// [only] is non-empty, it indicates packages whose frames should *not* be
+ /// folded away.
+ void configure(
+ {StackTraceMapper? mapper, Set<String>? except, Set<String>? only}) {
+ if (mapper != null) _mapper = mapper;
+ if (except != null) _except = except;
+ if (only != null) _only = only;
+ }
+
+ /// Converts [stackTrace] to a [Chain] and formats it according to the user's
+ /// preferences.
+ ///
+ /// If [verbose] is `true`, this doesn't fold out irrelevant stack frames. It
+ /// defaults to the current test's [Metadata.verboseTrace] configuration, or
+ /// `false` if there is no current test.
+ Chain formatStackTrace(StackTrace stackTrace, {bool? verbose}) {
+ verbose ??= Invoker.current?.liveTest.test.metadata.verboseTrace ?? false;
+
+ var chain =
+ Chain.forTrace(_mapper?.mapStackTrace(stackTrace) ?? stackTrace);
+ if (verbose) return chain;
+
+ return chain.foldFrames((frame) {
+ if (_only.isNotEmpty) return !_only.contains(frame.package);
+ return _except.contains(frame.package);
+ }, terse: true);
+ }
+}
diff --git a/pkgs/test_api/lib/src/backend/stack_trace_mapper.dart b/pkgs/test_api/lib/src/backend/stack_trace_mapper.dart
new file mode 100644
index 0000000..b091bbe
--- /dev/null
+++ b/pkgs/test_api/lib/src/backend/stack_trace_mapper.dart
@@ -0,0 +1,12 @@
+// Copyright (c) 2015, 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.
+
+/// A class for mapping JS stack traces to Dart stack traces using source maps.
+abstract interface class StackTraceMapper {
+ /// Converts [trace] into a Dart stack trace.
+ StackTrace mapStackTrace(StackTrace trace);
+
+ /// Returns a Map representation which is suitable for JSON serialization.
+ Map<String, dynamic> serialize();
+}
diff --git a/pkgs/test_api/lib/src/backend/state.dart b/pkgs/test_api/lib/src/backend/state.dart
new file mode 100644
index 0000000..5a37654
--- /dev/null
+++ b/pkgs/test_api/lib/src/backend/state.dart
@@ -0,0 +1,109 @@
+// Copyright (c) 2015, 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.
+
+/// The state of a [LiveTest].
+///
+/// A test's state is made up of two components, its [status] and its [result].
+/// The [status] represents where the test is in its process of running; the
+/// [result] represents the outcome as far as its known.
+class State {
+ /// Where the test is in its process of running.
+ final Status status;
+
+ /// The outcome of the test, as far as it's known.
+ ///
+ /// Note that if [status] is [Status.pending], [result] will always be
+ /// [Result.success] since the test hasn't yet had a chance to fail.
+ final Result result;
+
+ /// Whether a test in this state is expected to be done running code.
+ ///
+ /// If [status] is [Status.complete] and [result] doesn't indicate an error, a
+ /// properly-written test case should not be running any more code. However,
+ /// it may have started asynchronous processes without notifying the test
+ /// runner.
+ bool get shouldBeDone => status == Status.complete && result.isPassing;
+
+ const State(this.status, this.result);
+
+ @override
+ bool operator ==(Object other) =>
+ other is State && status == other.status && result == other.result;
+
+ @override
+ int get hashCode => status.hashCode ^ (7 * result.hashCode);
+
+ @override
+ String toString() {
+ if (status == Status.pending) return 'pending';
+ if (status == Status.complete) return result.toString();
+ if (result == Result.success) return 'running';
+ return 'running with $result';
+ }
+}
+
+/// Where the test is in its process of running.
+enum Status {
+ /// The test has not yet begun running.
+ pending,
+
+ /// The test is currently running.
+ running,
+
+ /// The test has finished running.
+ ///
+ /// Note that even if the test is marked [complete], it may still be running
+ /// code asynchronously. A test is considered complete either once it hits its
+ /// first error or when all [expectAsync] callbacks have been called and any
+ /// returned [Future] has completed, but it's possible for further processing
+ /// to happen, which may cause further errors.
+ complete;
+
+ factory Status.parse(String name) => Status.values.byName(name);
+
+ @override
+ String toString() => name;
+}
+
+/// The outcome of the test, as far as it's known.
+enum Result {
+ /// The test has not yet failed in any way.
+ ///
+ /// Note that this doesn't mean that the test won't fail in the future.
+ success,
+
+ /// The test, or some part of it, has been skipped.
+ ///
+ /// This implies that the test hasn't failed *yet*. However, it this doesn't
+ /// mean that the test won't fail in the future.
+ skipped,
+
+ /// The test has failed.
+ ///
+ /// A failure is specifically caused by a [TestFailure] being thrown; any
+ /// other exception causes an error.
+ failure,
+
+ /// The test has crashed.
+ ///
+ /// Any exception other than a [TestFailure] is considered to be an error.
+ error;
+
+ /// Whether this is a passing result.
+ ///
+ /// A test is considered to have passed if it's a success or if it was
+ /// skipped.
+ bool get isPassing => this == success || this == skipped;
+
+ /// Whether this is a failing result.
+ ///
+ /// A test is considered to have failed if it experiences a failure or an
+ /// error.
+ bool get isFailing => !isPassing;
+
+ factory Result.parse(String name) => Result.values.byName(name);
+
+ @override
+ String toString() => name;
+}
diff --git a/pkgs/test_api/lib/src/backend/suite.dart b/pkgs/test_api/lib/src/backend/suite.dart
new file mode 100644
index 0000000..910f184
--- /dev/null
+++ b/pkgs/test_api/lib/src/backend/suite.dart
@@ -0,0 +1,62 @@
+// Copyright (c) 2015, 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 'group.dart';
+import 'metadata.dart';
+import 'suite_platform.dart';
+import 'test.dart';
+
+/// A test suite.
+///
+/// A test suite is a set of tests that are intended to be run together and that
+/// share default configuration.
+class Suite {
+ /// The platform on which the suite is running.
+ final SuitePlatform platform;
+
+ /// The path to the Dart test suite, or `null` if that path is unknown.
+ final String? path;
+
+ /// The metadata associated with this test suite.
+ ///
+ /// This is a shortcut for [group.metadata].
+ Metadata get metadata => group.metadata;
+
+ /// The top-level group for this test suite.
+ final Group group;
+
+ /// Whether or not to ignore test timeouts.
+ final bool ignoreTimeouts;
+
+ /// Creates a new suite containing [group].
+ ///
+ /// If [platform] and/or [os] are passed, [group] is filtered to match that
+ /// platform information.
+ ///
+ /// If [os] is passed without [platform], throws an [ArgumentError].
+ Suite(Group group, this.platform, {this.ignoreTimeouts = false, this.path})
+ : group = _filterGroup(group, platform);
+
+ /// Returns [entries] filtered according to [platform] and [os].
+ ///
+ /// Gracefully handles [platform] being null.
+ static Group _filterGroup(Group group, SuitePlatform platform) {
+ var filtered = group.forPlatform(platform);
+ if (filtered != null) return filtered;
+ return Group.root([], metadata: group.metadata);
+ }
+
+ /// Returns a new suite with all tests matching [test] removed.
+ ///
+ /// Unlike [GroupEntry.filter], this never returns `null`. If all entries are
+ /// filtered out, it returns an empty suite.
+ Suite filter(bool Function(Test) callback) {
+ var filtered = group.filter(callback);
+ filtered ??= Group.root([], metadata: metadata);
+ return Suite(filtered, platform,
+ ignoreTimeouts: ignoreTimeouts, path: path);
+ }
+
+ bool get isLoadSuite => false;
+}
diff --git a/pkgs/test_api/lib/src/backend/suite_channel_manager.dart b/pkgs/test_api/lib/src/backend/suite_channel_manager.dart
new file mode 100644
index 0000000..26a21c9
--- /dev/null
+++ b/pkgs/test_api/lib/src/backend/suite_channel_manager.dart
@@ -0,0 +1,44 @@
+// Copyright (c) 2018, 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 'package:stream_channel/stream_channel.dart';
+
+/// A class that connects incoming and outgoing channels with the same names.
+class SuiteChannelManager {
+ /// Connections from the test runner that have yet to connect to corresponding
+ /// calls to [connectOut].
+ final _incomingConnections = <String, StreamChannel<Object?>>{};
+
+ /// Connections from calls to [connectOut] that have yet to connect to
+ /// corresponding connections from the test runner.
+ final _outgoingConnections = <String, StreamChannelCompleter<Object?>>{};
+
+ /// The channel names that have already been used.
+ final _names = <String>{};
+
+ /// Creates a connection to the test runnner's channel with the given [name].
+ StreamChannel<Object?> connectOut(String name) {
+ if (_incomingConnections.containsKey(name)) {
+ return _incomingConnections[name]!;
+ } else if (_names.contains(name)) {
+ throw StateError('Duplicate suiteChannel() connection "$name".');
+ } else {
+ _names.add(name);
+ var completer = StreamChannelCompleter<Object?>();
+ _outgoingConnections[name] = completer;
+ return completer.channel;
+ }
+ }
+
+ /// Connects [channel] to this worker's channel with the given [name].
+ void connectIn(String name, StreamChannel<Object?> channel) {
+ if (_outgoingConnections.containsKey(name)) {
+ _outgoingConnections.remove(name)!.setChannel(channel);
+ } else if (_incomingConnections.containsKey(name)) {
+ throw StateError('Duplicate RunnerSuite.channel() connection "$name".');
+ } else {
+ _incomingConnections[name] = channel;
+ }
+ }
+}
diff --git a/pkgs/test_api/lib/src/backend/suite_platform.dart b/pkgs/test_api/lib/src/backend/suite_platform.dart
new file mode 100644
index 0000000..baab6ce
--- /dev/null
+++ b/pkgs/test_api/lib/src/backend/suite_platform.dart
@@ -0,0 +1,70 @@
+// Copyright (c) 2018, 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 'compiler.dart';
+import 'operating_system.dart';
+import 'runtime.dart';
+
+/// The platform on which a test suite is loaded.
+final class SuitePlatform {
+ /// The runtime that hosts the suite.
+ final Runtime runtime;
+
+ /// The operating system on which the suite is running.
+ ///
+ /// This will always be [OperatingSystem.none] if `runtime.isBrowser` is
+ /// true.
+ final OperatingSystem os;
+
+ /// Whether we're running on Google-internal infrastructure.
+ final bool inGoogle;
+
+ /// The compiler that should used for this platform.
+ final Compiler compiler;
+
+ /// Creates a new platform with the given [runtime] and [os], which defaults
+ /// to [OperatingSystem.none].
+ ///
+ /// Throws an [ArgumentError] if [runtime] is a browser and [os] is not
+ /// `null` or [OperatingSystem.none].
+ ///
+ /// If [compiler] is `null`, then the default compiler for [runtime] will be
+ /// used.
+ SuitePlatform(this.runtime,
+ {
+ // TODO(https://github.com/dart-lang/test/issues/1935): make required
+ Compiler? compiler,
+ this.os = OperatingSystem.none,
+ this.inGoogle = false})
+ : compiler = compiler ?? runtime.defaultCompiler {
+ if (runtime.isBrowser && os != OperatingSystem.none) {
+ throw ArgumentError('No OS should be passed for runtime "$runtime".');
+ }
+ if (!runtime.supportedCompilers.contains(this.compiler)) {
+ throw ArgumentError(
+ 'The platform $runtime does not support the compiler ${this.compiler}');
+ }
+ }
+
+ /// Converts a JSON-safe representation generated by [serialize] back into a
+ /// [SuitePlatform].
+ factory SuitePlatform.deserialize(Object serialized) {
+ var map = serialized as Map;
+ return SuitePlatform(Runtime.deserialize(map['runtime'] as Object),
+ compiler: map.containsKey('compiler')
+ ? Compiler.deserialize(map['compiler'] as Object)
+ : null,
+ os: OperatingSystem.find(map['os'] as String),
+ inGoogle: map['inGoogle'] as bool);
+ }
+
+ /// Converts [this] into a JSON-safe object that can be converted back to a
+ /// [SuitePlatform] using [SuitePlatform.deserialize].
+ Object serialize() => {
+ 'runtime': runtime.serialize(),
+ 'compiler': compiler.serialize(),
+ 'os': os.identifier,
+ 'inGoogle': inGoogle
+ };
+}
diff --git a/pkgs/test_api/lib/src/backend/test.dart b/pkgs/test_api/lib/src/backend/test.dart
new file mode 100644
index 0000000..5b5e73a
--- /dev/null
+++ b/pkgs/test_api/lib/src/backend/test.dart
@@ -0,0 +1,42 @@
+// Copyright (c) 2015, 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 'package:stack_trace/stack_trace.dart';
+
+import 'group.dart';
+import 'group_entry.dart';
+import 'live_test.dart';
+import 'metadata.dart';
+import 'suite.dart';
+import 'suite_platform.dart';
+
+/// A single test.
+///
+/// A test is immutable and stateless, which means that it can't be run
+/// directly. To run one, load a live version using [Test.load] and run it using
+/// [LiveTest.run].
+abstract class Test implements GroupEntry {
+ @override
+ String get name;
+
+ @override
+ Metadata get metadata;
+
+ @override
+ Trace? get trace;
+
+ /// Loads a live version of this test, which can be used to run it a single
+ /// time.
+ ///
+ /// [suite] is the suite within which this test is being run. If [groups] is
+ /// passed, it's the list of groups containing this test; otherwise, it
+ /// defaults to just containing `suite.group`.
+ LiveTest load(Suite suite, {Iterable<Group>? groups});
+
+ @override
+ Test? forPlatform(SuitePlatform platform);
+
+ @override
+ Test? filter(bool Function(Test) callback) => callback(this) ? this : null;
+}
diff --git a/pkgs/test_api/lib/src/backend/test_failure.dart b/pkgs/test_api/lib/src/backend/test_failure.dart
new file mode 100644
index 0000000..4d9fc79
--- /dev/null
+++ b/pkgs/test_api/lib/src/backend/test_failure.dart
@@ -0,0 +1,13 @@
+// Copyright (c) 2021, 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.
+
+/// An exception thrown when a test assertion fails.
+class TestFailure implements Exception {
+ final String? message;
+
+ TestFailure(this.message);
+
+ @override
+ String toString() => message.toString();
+}
diff --git a/pkgs/test_api/lib/src/backend/util/identifier_regex.dart b/pkgs/test_api/lib/src/backend/util/identifier_regex.dart
new file mode 100644
index 0000000..6426641
--- /dev/null
+++ b/pkgs/test_api/lib/src/backend/util/identifier_regex.dart
@@ -0,0 +1,9 @@
+// Copyright (c) 2021, 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.
+
+/// A regular expression matching a full string as a hyphenated identifier.
+///
+/// This is like a standard Dart identifier, except that it can also contain
+/// hyphens.
+final anchoredHyphenatedIdentifier = RegExp(r'^[a-zA-Z_-][a-zA-Z0-9_-]*$');
diff --git a/pkgs/test_api/lib/src/backend/util/pretty_print.dart b/pkgs/test_api/lib/src/backend/util/pretty_print.dart
new file mode 100644
index 0000000..5c011c5
--- /dev/null
+++ b/pkgs/test_api/lib/src/backend/util/pretty_print.dart
@@ -0,0 +1,45 @@
+// Copyright (c) 2021, 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.
+
+/// Returns [name] if [number] is 1, or the plural of [name] otherwise.
+///
+/// By default, this just adds "s" to the end of [name] to get the plural. If
+/// [plural] is passed, that's used instead.
+String pluralize(String name, int number, {String? plural}) {
+ if (number == 1) return name;
+ if (plural != null) return plural;
+ return '${name}s';
+}
+
+/// Returns a sentence fragment listing the elements of [iter].
+///
+/// This converts each element of [iter] to a string and separates them with
+/// commas and/or [conjunction] where appropriate. The [conjunction] defaults to
+/// "and".
+String toSentence(Iterable iter, {String conjunction = 'and'}) {
+ if (iter.length == 1) return iter.first.toString();
+
+ var result = iter.take(iter.length - 1).join(', ');
+ if (iter.length > 2) result += ',';
+ return '$result $conjunction ${iter.last}';
+}
+
+/// Returns a human-friendly representation of [duration].
+String niceDuration(Duration duration) {
+ var minutes = duration.inMinutes;
+ var seconds = duration.inSeconds % 60;
+ var decaseconds = (duration.inMilliseconds % 1000) ~/ 100;
+
+ var buffer = StringBuffer();
+ if (minutes != 0) buffer.write('$minutes minutes');
+
+ if (minutes == 0 || seconds != 0) {
+ if (minutes != 0) buffer.write(', ');
+ buffer.write(seconds);
+ if (decaseconds != 0) buffer.write('.$decaseconds');
+ buffer.write(' seconds');
+ }
+
+ return buffer.toString();
+}
diff --git a/pkgs/test_api/lib/src/frontend/fake.dart b/pkgs/test_api/lib/src/frontend/fake.dart
new file mode 100644
index 0000000..e3e0ea6
--- /dev/null
+++ b/pkgs/test_api/lib/src/frontend/fake.dart
@@ -0,0 +1,52 @@
+// Copyright (c) 2020, 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.
+
+/// A stand-in for another object which cannot be used except for specifically
+/// overridden methods.
+///
+/// A fake has a default behavior for every field and method of throwing
+/// [UnimplementedError]. Fields and methods that are exercised by the code
+/// under test should be manually overridden in the implementing class.
+///
+/// A fake does not have any support for verification or defining behavior from
+/// the test, it cannot be used as a mock.
+///
+/// In most cases a shared full fake implementation without a `noSuchMethod` is
+/// preferable to `extends Fake`, however `extends Fake` is preferred against
+/// `extends Mock` mixed with manual `@override` implementations.
+///
+/// __Example use__:
+///
+/// // Real class.
+/// class Cat {
+/// String meow(String suffix) => 'Meow$suffix';
+/// String hiss(String suffix) => 'Hiss$suffix';
+/// }
+///
+/// // Fake class.
+/// class FakeCat extends Fake implements Cat {
+/// @override
+/// String meow(String suffix) => 'FakeMeow$suffix';
+/// }
+///
+/// void main() {
+/// // Create a new fake Cat at runtime.
+/// var cat = new FakeCat();
+///
+/// // Try making a Cat sound...
+/// print(cat.meow('foo')); // Prints 'FakeMeowfoo'
+/// print(cat.hiss('foo')); // Throws
+/// }
+///
+/// **WARNING**: [Fake] uses [noSuchMethod](goo.gl/r3IQUH), which is a _form_ of
+/// runtime reflection, and causes sub-standard code to be generated. As such,
+/// [Fake] should strictly _not_ be used in any production code, especially if
+/// used within the context of Dart for Web (dart2js, DDC) and Dart for Mobile
+/// (Flutter).
+abstract mixin class Fake {
+ @override
+ dynamic noSuchMethod(Invocation invocation) {
+ throw UnimplementedError(invocation.memberName.toString().split('"')[1]);
+ }
+}
diff --git a/pkgs/test_api/lib/src/remote_listener.dart b/pkgs/test_api/lib/src/remote_listener.dart
new file mode 100644
index 0000000..f2df134
--- /dev/null
+++ b/pkgs/test_api/lib/src/remote_listener.dart
@@ -0,0 +1,5 @@
+// Copyright (c) 2021, 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.
+
+export 'backend/remote_listener.dart' show RemoteListener;
diff --git a/pkgs/test_api/lib/src/scaffolding/spawn_hybrid.dart b/pkgs/test_api/lib/src/scaffolding/spawn_hybrid.dart
new file mode 100644
index 0000000..7222d52
--- /dev/null
+++ b/pkgs/test_api/lib/src/scaffolding/spawn_hybrid.dart
@@ -0,0 +1,179 @@
+// Copyright (c) 2016, 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 'dart:convert';
+
+import 'package:async/async.dart';
+import 'package:stream_channel/stream_channel.dart';
+
+import '../backend/remote_exception.dart';
+import '../utils.dart';
+import 'test_structure.dart' show addTearDown;
+
+/// A transformer that handles messages from the spawned isolate and ensures
+/// that messages sent to it are JSON-encodable.
+///
+/// The spawned isolate sends three kinds of messages. Data messages are emitted
+/// as data events, error messages are emitted as error events, and print
+/// messages are printed using `print()`.
+// package:test will only send a `Map` across this channel, but users of
+// `hybridMain` can send any json encodeable type.
+final _transformer = StreamChannelTransformer<dynamic, dynamic>(
+ StreamTransformer.fromHandlers(handleData: (message, sink) {
+ switch (message['type'] as String) {
+ case 'data':
+ sink.add(message['data']);
+ break;
+
+ case 'print':
+ print(message['line']);
+ break;
+
+ case 'error':
+ var error = RemoteException.deserialize(message['error'] as Map);
+ sink.addError(error.error, error.stackTrace);
+ break;
+ }
+}), StreamSinkTransformer.fromHandlers(handleData: (message, sink) {
+ // This is called synchronously from the user's `Sink.add()` call, so if
+ // [ensureJsonEncodable] throws here they'll get a helpful stack trace.
+ ensureJsonEncodable(message);
+ sink.add(message);
+}));
+
+/// Spawns a VM isolate for the given [uri], which may be a [Uri] or a [String].
+///
+/// This allows browser tests to spawn servers with which they can communicate
+/// to test client/server interactions. It can also be used by VM tests to
+/// easily spawn an isolate.
+///
+/// The Dart file at [uri] must define a top-level `hybridMain()` function that
+/// takes a `StreamChannel` argument and, optionally, an `Object` argument to
+/// which [message] will be passed. Note that [message] must be JSON-encodable.
+/// For example:
+///
+/// ```dart
+/// import "package:stream_channel/stream_channel.dart";
+///
+/// hybridMain(StreamChannel channel, Object message) {
+/// // ...
+/// }
+/// ```
+///
+/// If [uri] is relative, it will be interpreted relative to the `file:` URL for
+/// the test suite being executed. If it's root-relative (that is, if it begins
+/// with `/`) it will be interpreted relative to the root of the package (the
+/// directory that contains `pubspec.yaml`, *not* the `test/` directory). If
+/// it's a `package:` URL, it will be resolved using the current package's
+/// dependency constellation.
+///
+/// Returns a [StreamChannel] that's connected to the channel passed to
+/// `hybridMain()`. Only JSON-encodable objects may be sent through this
+/// channel. If the channel is closed, the hybrid isolate is killed. If the
+/// isolate is killed, the channel's stream will emit a "done" event.
+///
+/// Any unhandled errors loading or running the hybrid isolate will be emitted
+/// as errors over the channel's stream. Any calls to `print()` in the hybrid
+/// isolate will be printed as though they came from the test that created the
+/// isolate.
+///
+/// Code in the hybrid isolate is not considered to be running in a test
+/// context, so it can't access test functions like `expect()` and
+/// `expectAsync()`.
+///
+/// By default, the hybrid isolate is automatically killed when the test
+/// finishes running. If [stayAlive] is `true`, it won't be killed until the
+/// entire test suite finishes running.
+///
+/// **Note**: If you use this API, be sure to add a dependency on the
+/// **`stream_channel` package, since you're using its API as well!
+StreamChannel spawnHybridUri(
+ Object uri, {
+ Object? message,
+ bool stayAlive = false,
+}) {
+ if (uri is String) {
+ // Ensure that it can be parsed as a uri.
+ Uri.parse(uri);
+ } else if (uri is! Uri) {
+ throw ArgumentError.value(uri, 'uri', 'must be a Uri or a String.');
+ }
+ return _spawn(uri.toString(), message, stayAlive: stayAlive);
+}
+
+/// Spawns a VM isolate that runs the given [dartCode], which is loaded as the
+/// contents of a Dart library.
+///
+/// This allows browser tests to spawn servers with which they can communicate
+/// to test client/server interactions. It can also be used by VM tests to
+/// easily spawn an isolate.
+///
+/// The [dartCode] must define a top-level `hybridMain()` function that takes a
+/// `StreamChannel` argument and, optionally, an `Object` argument to which
+/// [message] will be passed. Note that [message] must be JSON-encodable. For
+/// example:
+///
+/// ```dart
+/// import "package:stream_channel/stream_channel.dart";
+///
+/// hybridMain(StreamChannel channel, Object message) {
+/// // ...
+/// }
+/// ```
+///
+/// Returns a [StreamChannel] that's connected to the channel passed to
+/// `hybridMain()`. Only JSON-encodable objects may be sent through this
+/// channel. If the channel is closed, the hybrid isolate is killed. If the
+/// isolate is killed, the channel's stream will emit a "done" event.
+///
+/// Any unhandled errors loading or running the hybrid isolate will be emitted
+/// as errors over the channel's stream. Any calls to `print()` in the hybrid
+/// isolate will be printed as though they came from the test that created the
+/// isolate.
+///
+/// Code in the hybrid isolate is not considered to be running in a test
+/// context, so it can't access test functions like `expect()` and
+/// `expectAsync()`.
+///
+/// By default, the hybrid isolate is automatically killed when the test
+/// finishes running. If [stayAlive] is `true`, it won't be killed until the
+/// entire test suite finishes running.
+///
+/// **Note**: If you use this API, be sure to add a dependency on the
+/// **`stream_channel` package, since you're using its API as well!
+StreamChannel spawnHybridCode(String dartCode,
+ {Object? message, bool stayAlive = false}) {
+ var uri = Uri.dataFromString(dartCode,
+ encoding: utf8, mimeType: 'application/dart');
+ return _spawn(uri.toString(), message, stayAlive: stayAlive);
+}
+
+/// Like [spawnHybridUri], but doesn't take [Uri] objects.
+StreamChannel _spawn(String uri, Object? message, {bool stayAlive = false}) {
+ var channel = Zone.current[#test.runner.test_channel] as MultiChannel?;
+ if (channel == null) {
+ throw UnsupportedError("Can't connect to the test runner.\n"
+ 'spawnHybridUri() is currently only supported within "dart test".');
+ }
+
+ ensureJsonEncodable(message);
+
+ var virtualChannel = channel.virtualChannel();
+ StreamChannel isolateChannel = virtualChannel;
+ channel.sink.add({
+ 'type': 'spawn-hybrid-uri',
+ 'url': uri,
+ 'message': message,
+ 'channel': virtualChannel.id
+ });
+
+ if (!stayAlive) {
+ var disconnector = Disconnector<void>();
+ addTearDown(() => disconnector.disconnect());
+ isolateChannel = isolateChannel.transform(disconnector);
+ }
+
+ return isolateChannel.transform(_transformer);
+}
diff --git a/pkgs/test_api/lib/src/scaffolding/test_structure.dart b/pkgs/test_api/lib/src/scaffolding/test_structure.dart
new file mode 100644
index 0000000..642e013
--- /dev/null
+++ b/pkgs/test_api/lib/src/scaffolding/test_structure.dart
@@ -0,0 +1,251 @@
+// Copyright (c) 2021, 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:meta/meta.dart';
+
+import '../backend/configuration/timeout.dart';
+import '../backend/declarer.dart';
+import '../backend/invoker.dart';
+
+// test_core does not support running tests directly, so the Declarer should
+// always be on the Zone.
+Declarer get _declarer => Zone.current[#test.declarer] as Declarer;
+
+// TODO(nweiz): This and other top-level functions should throw exceptions if
+// they're called after the declarer has finished declaring.
+/// Creates a new test case with the given description (converted to a string)
+/// and body.
+///
+/// The description will be added to the descriptions of any surrounding
+/// [group]s. If [testOn] is passed, it's parsed as a [platform selector][]; the
+/// test will only be run on matching platforms.
+///
+/// [platform selector]: https://github.com/dart-lang/test/tree/master/pkgs/test#platform-selectors
+///
+/// If [timeout] is passed, it's used to modify or replace the default timeout
+/// of 30 seconds. Timeout modifications take precedence in suite-group-test
+/// order, so [timeout] will also modify any timeouts set on the group or suite.
+///
+/// If [skip] is a String or `true`, the test is skipped. If it's a String, it
+/// should explain why the test is skipped; this reason will be printed instead
+/// of running the test.
+///
+/// If [tags] is passed, it declares user-defined tags that are applied to the
+/// test. These tags can be used to select or skip the test on the command line,
+/// or to do bulk test configuration. All tags should be declared in the
+/// [package configuration file][configuring tags]. The parameter can be an
+/// [Iterable] of tag names, or a [String] representing a single tag.
+///
+/// If [retry] is passed, the test will be retried the provided number of times
+/// before being marked as a failure.
+///
+/// [configuring tags]: https://github.com/dart-lang/test/blob/master/pkgs/test/doc/configuration.md#configuring-tags
+///
+/// [onPlatform] allows tests to be configured on a platform-by-platform
+/// basis. It's a map from strings that are parsed as [PlatformSelector]s to
+/// annotation classes: [Timeout], [Skip], or lists of those. These
+/// annotations apply only on the given platforms. For example:
+///
+/// test('potentially slow test', () {
+/// // ...
+/// }, onPlatform: {
+/// // This test is especially slow on Windows.
+/// 'windows': Timeout.factor(2),
+/// 'browser': [
+/// Skip('TODO: add browser support'),
+/// // This will be slow on browsers once it works on them.
+/// Timeout.factor(2)
+/// ]
+/// });
+///
+/// If multiple platforms match, the annotations apply in order as through
+/// they were in nested groups.
+///
+/// If the `solo` flag is `true`, only tests and groups marked as
+/// "solo" will be be run. This only restricts tests *within this test
+/// suite*—tests in other suites will run as normal. We recommend that users
+/// avoid this flag if possible and instead use the test runner flag `-n` to
+/// filter tests by name.
+@isTest
+void test(Object? description, dynamic Function() body,
+ {String? testOn,
+ Timeout? timeout,
+ Object? skip,
+ Object? tags,
+ Map<String, dynamic>? onPlatform,
+ int? retry,
+ // TODO(https://github.com/dart-lang/test/issues/2205): Remove deprecated.
+ @Deprecated('Debug only') @doNotSubmit bool solo = false}) {
+ _declarer.test(description.toString(), body,
+ testOn: testOn,
+ timeout: timeout,
+ skip: skip,
+ onPlatform: onPlatform,
+ tags: tags,
+ retry: retry,
+ solo: solo);
+
+ // Force dart2js not to inline this function. We need it to be separate from
+ // `main()` in JS stack traces in order to properly determine the line and
+ // column where the test was defined. See sdk#26705.
+ return;
+ return; // ignore: dead_code
+}
+
+/// Creates a group of tests.
+///
+/// A group's description (converted to a string) is included in the descriptions
+/// of any tests or sub-groups it contains. [setUp] and [tearDown] are also scoped
+/// to the containing group.
+///
+/// If [testOn] is passed, it's parsed as a [platform selector][]; the test will
+/// only be run on matching platforms.
+///
+/// [platform selector]: https://github.com/dart-lang/test/tree/master/pkgs/test#platform-selectors
+///
+/// If [timeout] is passed, it's used to modify or replace the default timeout
+/// of 30 seconds. Timeout modifications take precedence in suite-group-test
+/// order, so [timeout] will also modify any timeouts set on the suite, and will
+/// be modified by any timeouts set on individual tests.
+///
+/// If [skip] is a String or `true`, the group is skipped. If it's a String, it
+/// should explain why the group is skipped; this reason will be printed instead
+/// of running the group's tests.
+///
+/// If [tags] is passed, it declares user-defined tags that are applied to the
+/// test. These tags can be used to select or skip the test on the command line,
+/// or to do bulk test configuration. All tags should be declared in the
+/// [package configuration file][configuring tags]. The parameter can be an
+/// [Iterable] of tag names, or a [String] representing a single tag.
+///
+/// [configuring tags]: https://github.com/dart-lang/test/blob/master/pkgs/test/doc/configuration.md#configuring-tags
+///
+/// [onPlatform] allows groups to be configured on a platform-by-platform
+/// basis. It's a map from strings that are parsed as [PlatformSelector]s to
+/// annotation classes: [Timeout], [Skip], or lists of those. These
+/// annotations apply only on the given platforms. For example:
+///
+/// group('potentially slow tests', () {
+/// // ...
+/// }, onPlatform: {
+/// // These tests are especially slow on Windows.
+/// 'windows': Timeout.factor(2),
+/// 'browser': [
+/// Skip('TODO: add browser support'),
+/// // They'll be slow on browsers once it works on them.
+/// Timeout.factor(2)
+/// ]
+/// });
+///
+/// If multiple platforms match, the annotations apply in order as through
+/// they were in nested groups.
+///
+/// If the `solo` flag is `true`, only tests and groups marked as
+/// "solo" will be be run. This only restricts tests *within this test
+/// suite*—tests in other suites will run as normal. We recommend that users
+/// avoid this flag if possible, and instead use the test runner flag `-n` to
+/// filter tests by name.
+@isTestGroup
+void group(Object? description, dynamic Function() body,
+ {String? testOn,
+ Timeout? timeout,
+ Object? skip,
+ Object? tags,
+ Map<String, dynamic>? onPlatform,
+ int? retry,
+ // TODO(https://github.com/dart-lang/test/issues/2205): Remove deprecated.
+ @Deprecated('Debug only') @doNotSubmit bool solo = false}) {
+ _declarer.group(description.toString(), body,
+ testOn: testOn,
+ timeout: timeout,
+ skip: skip,
+ tags: tags,
+ onPlatform: onPlatform,
+ retry: retry,
+ solo: solo);
+
+ // Force dart2js not to inline this function. We need it to be separate from
+ // `main()` in JS stack traces in order to properly determine the line and
+ // column where the test was defined. See sdk#26705.
+ return;
+ return; // ignore: dead_code
+}
+
+/// Registers a function to be run before tests.
+///
+/// This function will be called before each test is run. [callback] may be
+/// asynchronous; if so, it must return a [Future].
+///
+/// If this is called within a test group, it applies only to tests in that
+/// group. [callback] will be run after any set-up callbacks in parent groups or
+/// at the top level.
+///
+/// Each callback at the top level or in a given group will be run in the order
+/// they were declared.
+void setUp(dynamic Function() callback) => _declarer.setUp(callback);
+
+/// Registers a function to be run after tests.
+///
+/// This function will be called after each test is run. [callback] may be
+/// asynchronous; if so, it must return a [Future].
+///
+/// If this is called within a test group, it applies only to tests in that
+/// group. [callback] will be run before any tear-down callbacks in parent
+/// groups or at the top level.
+///
+/// Each callback at the top level or in a given group will be run in the
+/// reverse of the order they were declared.
+///
+/// See also [addTearDown], which adds tear-downs to a running test.
+void tearDown(dynamic Function() callback) => _declarer.tearDown(callback);
+
+/// Registers a function to be run after the current test.
+///
+/// This is called within a running test, and adds a tear-down only for the
+/// current test. It allows testing libraries to add cleanup logic as soon as
+/// there's something to clean up.
+///
+/// The [callback] is run before any callbacks registered with [tearDown]. Like
+/// [tearDown], the most recently registered callback is run first.
+///
+/// If this is called from within a [setUpAll] or [tearDownAll] callback, it
+/// instead runs the function after *all* tests in the current test suite.
+void addTearDown(dynamic Function() callback) {
+ if (Invoker.current == null) {
+ throw StateError('addTearDown() may only be called within a test.');
+ }
+
+ Invoker.current!.addTearDown(callback);
+}
+
+/// Registers a function to be run once before all tests.
+///
+/// [callback] may be asynchronous; if so, it must return a [Future].
+///
+/// If this is called within a test group, [callback] will run before all tests
+/// in that group. It will be run after any [setUpAll] callbacks in parent
+/// groups or at the top level. It won't be run if none of the tests in the
+/// group are run.
+///
+/// **Note**: This function makes it very easy to accidentally introduce hidden
+/// dependencies between tests that should be isolated. In general, you should
+/// prefer [setUp], and only use [setUpAll] if the callback is prohibitively
+/// slow.
+void setUpAll(dynamic Function() callback) => _declarer.setUpAll(callback);
+
+/// Registers a function to be run once after all tests.
+///
+/// If this is called within a test group, [callback] will run after all tests
+/// in that group. It will be run before any [tearDownAll] callbacks in parent
+/// groups or at the top level. It won't be run if none of the tests in the
+/// group are run.
+///
+/// **Note**: This function makes it very easy to accidentally introduce hidden
+/// dependencies between tests that should be isolated. In general, you should
+/// prefer [tearDown], and only use [tearDownAll] if the callback is
+/// prohibitively slow.
+void tearDownAll(dynamic Function() callback) =>
+ _declarer.tearDownAll(callback);
diff --git a/pkgs/test_api/lib/src/scaffolding/utils.dart b/pkgs/test_api/lib/src/scaffolding/utils.dart
new file mode 100644
index 0000000..134dc49
--- /dev/null
+++ b/pkgs/test_api/lib/src/scaffolding/utils.dart
@@ -0,0 +1,51 @@
+// Copyright (c) 2021, 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 '../backend/invoker.dart';
+
+/// Returns a [Future] that completes after the [event loop][] has run the given
+/// number of [times] (20 by default).
+///
+/// [event loop]: https://medium.com/dartlang/dart-asynchronous-programming-isolates-and-event-loops-bffc3e296a6a
+///
+/// Awaiting this approximates waiting until all asynchronous work (other than
+/// work that's waiting for external resources) completes.
+Future pumpEventQueue({int times = 20}) {
+ if (times == 0) return Future.value();
+ // Use the event loop to allow the microtask queue to finish.
+ return Future(() => pumpEventQueue(times: times - 1));
+}
+
+/// Registers an exception that was caught for the current test.
+void registerException(Object error,
+ [StackTrace stackTrace = StackTrace.empty]) {
+ // This will usually forward directly to [Invoker.current.handleError], but
+ // going through the zone API allows other zones to consistently see errors.
+ Zone.current.handleUncaughtError(error, stackTrace);
+}
+
+/// Prints [message] if and when the current test fails.
+///
+/// This is intended for test infrastructure to provide debugging information
+/// without cluttering the output for successful tests. Note that unlike
+/// [print], each individual message passed to [printOnFailure] will be
+/// separated by a blank line.
+void printOnFailure(String message) {
+ _currentInvoker.printOnFailure(message);
+}
+
+/// Marks the current test as skipped.
+///
+/// A skipped test may still fail if any exception is thrown, including uncaught
+/// asynchronous errors. If the entire test should be skipped `return` from the
+/// test body after marking it as skipped.
+void markTestSkipped(String message) => _currentInvoker..skip(message);
+
+Invoker get _currentInvoker =>
+ Invoker.current ??
+ (throw StateError(
+ 'There is no current invoker. Please make sure that you are making the '
+ 'call inside a test zone.'));
diff --git a/pkgs/test_api/lib/src/utils.dart b/pkgs/test_api/lib/src/utils.dart
new file mode 100644
index 0000000..3bf7518
--- /dev/null
+++ b/pkgs/test_api/lib/src/utils.dart
@@ -0,0 +1,27 @@
+// Copyright (c) 2013, 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.
+
+/// Throws an [ArgumentError] if [message] isn't recursively JSON-safe.
+void ensureJsonEncodable(Object? message) {
+ if (message == null ||
+ message is String ||
+ message is num ||
+ message is bool) {
+ // JSON-encodable, hooray!
+ } else if (message is List) {
+ for (var element in message) {
+ ensureJsonEncodable(element);
+ }
+ } else if (message is Map) {
+ message.forEach((key, value) {
+ if (key is! String) {
+ throw ArgumentError("$message can't be JSON-encoded.");
+ }
+
+ ensureJsonEncodable(value);
+ });
+ } else {
+ throw ArgumentError.value("$message can't be JSON-encoded.");
+ }
+}
diff --git a/pkgs/test_api/lib/test_api.dart b/pkgs/test_api/lib/test_api.dart
new file mode 100644
index 0000000..75c1540
--- /dev/null
+++ b/pkgs/test_api/lib/test_api.dart
@@ -0,0 +1,10 @@
+// Copyright (c) 2013, 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.
+
+@Deprecated('package:test_api is not intended for general use. '
+ 'Please use package:test.')
+library;
+
+export 'hooks.dart' show TestFailure;
+export 'scaffolding.dart';
diff --git a/pkgs/test_api/mono_pkg.yaml b/pkgs/test_api/mono_pkg.yaml
new file mode 100644
index 0000000..534d9c3
--- /dev/null
+++ b/pkgs/test_api/mono_pkg.yaml
@@ -0,0 +1,19 @@
+# See https://pub.dev/packages/mono_repo
+
+sdk:
+- dev
+- pubspec
+
+stages:
+- analyze_and_format:
+ - group:
+ - format
+ - analyze: --fatal-infos
+ sdk:
+ - dev
+- unit_test:
+ - group:
+ - command: dart test --preset travis -x browser
+ os:
+ - linux
+ - windows
diff --git a/pkgs/test_api/pubspec.yaml b/pkgs/test_api/pubspec.yaml
new file mode 100644
index 0000000..af5cb93
--- /dev/null
+++ b/pkgs/test_api/pubspec.yaml
@@ -0,0 +1,29 @@
+name: test_api
+version: 0.7.4
+description: >-
+ The user facing API for structuring Dart tests and checking expectations.
+repository: https://github.com/dart-lang/test/tree/master/pkgs/test_api
+resolution: workspace
+
+environment:
+ sdk: ^3.5.0
+
+dependencies:
+ async: ^2.5.0
+ boolean_selector: ^2.1.0
+ collection: ^1.15.0
+ meta: ^1.14.0
+ source_span: ^1.8.0
+ stack_trace: ^1.10.0
+ stream_channel: ^2.1.0
+ string_scanner: ^1.1.0
+ term_glyph: ^1.2.0
+
+dev_dependencies:
+ analyzer: '>=6.0.0 <8.0.0'
+ fake_async: ^1.2.0
+ glob: ^2.0.0
+ graphs: ^2.0.0
+ path: ^1.8.0
+ test: any
+ test_core: any
diff --git a/pkgs/test_api/test/backend/declarer_test.dart b/pkgs/test_api/test/backend/declarer_test.dart
new file mode 100644
index 0000000..f095ad0
--- /dev/null
+++ b/pkgs/test_api/test/backend/declarer_test.dart
@@ -0,0 +1,703 @@
+// Copyright (c) 2015, 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:test/test.dart';
+import 'package:test_api/src/backend/declarer.dart';
+import 'package:test_api/src/backend/group.dart';
+import 'package:test_api/src/backend/invoker.dart';
+import 'package:test_api/src/backend/suite.dart';
+import 'package:test_api/src/backend/test.dart';
+
+import '../utils.dart';
+
+late Suite _suite;
+
+void main() {
+ setUp(() {
+ _suite = Suite(Group.root([]), suitePlatform, ignoreTimeouts: false);
+ });
+
+ group('.test()', () {
+ test('declares a test with a description and body', () async {
+ var bodyRun = false;
+ var tests = declare(() {
+ test('description', () {
+ bodyRun = true;
+ });
+ });
+
+ expect(tests, hasLength(1));
+ expect(tests.single.name, equals('description'));
+
+ await _runTest(tests[0] as Test);
+ expect(bodyRun, isTrue);
+ });
+
+ test('declares a test with an object as the description', () async {
+ var tests = declare(() {
+ test(Object, () {});
+ });
+
+ expect(tests.single.name, equals('Object'));
+ });
+
+ test('declares multiple tests', () {
+ var tests = declare(() {
+ test('description 1', () {});
+ test('description 2', () {});
+ test('description 3', () {});
+ });
+
+ expect(tests, hasLength(3));
+ expect(tests[0].name, equals('description 1'));
+ expect(tests[1].name, equals('description 2'));
+ expect(tests[2].name, equals('description 3'));
+ });
+ });
+
+ group('.setUp()', () {
+ test('is run before all tests', () async {
+ var setUpRun = false;
+ var tests = declare(() {
+ setUp(() => setUpRun = true);
+
+ test(
+ 'description 1',
+ expectAsync0(() {
+ expect(setUpRun, isTrue);
+ setUpRun = false;
+ }, max: 1));
+
+ test(
+ 'description 2',
+ expectAsync0(() {
+ expect(setUpRun, isTrue);
+ setUpRun = false;
+ }, max: 1));
+ });
+
+ await _runTest(tests[0] as Test);
+ await _runTest(tests[1] as Test);
+ });
+
+ test('can return a Future', () {
+ var setUpRun = false;
+ var tests = declare(() {
+ setUp(() {
+ return Future(() => setUpRun = true);
+ });
+
+ test(
+ 'description',
+ expectAsync0(() {
+ expect(setUpRun, isTrue);
+ }, max: 1));
+ });
+
+ return _runTest(tests.single as Test);
+ });
+
+ test('runs in call order within a group', () async {
+ var firstSetUpRun = false;
+ var secondSetUpRun = false;
+ var thirdSetUpRun = false;
+ var tests = declare(() {
+ setUp(expectAsync0(() async {
+ expect(secondSetUpRun, isFalse);
+ expect(thirdSetUpRun, isFalse);
+ firstSetUpRun = true;
+ }));
+
+ setUp(expectAsync0(() async {
+ expect(firstSetUpRun, isTrue);
+ expect(thirdSetUpRun, isFalse);
+ secondSetUpRun = true;
+ }));
+
+ setUp(expectAsync0(() async {
+ expect(firstSetUpRun, isTrue);
+ expect(secondSetUpRun, isTrue);
+ thirdSetUpRun = true;
+ }));
+
+ test('description', expectAsync0(() {
+ expect(firstSetUpRun, isTrue);
+ expect(secondSetUpRun, isTrue);
+ expect(thirdSetUpRun, isTrue);
+ }));
+ });
+
+ await _runTest(tests.single as Test);
+ });
+ });
+
+ group('.tearDown()', () {
+ test('is run after all tests', () async {
+ late bool tearDownRun;
+ var tests = declare(() {
+ setUp(() => tearDownRun = false);
+ tearDown(() => tearDownRun = true);
+
+ test(
+ 'description 1',
+ expectAsync0(() {
+ expect(tearDownRun, isFalse);
+ }, max: 1));
+
+ test(
+ 'description 2',
+ expectAsync0(() {
+ expect(tearDownRun, isFalse);
+ }, max: 1));
+ });
+
+ await _runTest(tests[0] as Test);
+ expect(tearDownRun, isTrue);
+ await _runTest(tests[1] as Test);
+ expect(tearDownRun, isTrue);
+ });
+
+ test('is run after an out-of-band failure', () async {
+ late bool tearDownRun;
+ var tests = declare(() {
+ setUp(() => tearDownRun = false);
+ tearDown(() => tearDownRun = true);
+
+ test(
+ 'description 1',
+ expectAsync0(() {
+ Invoker.current!.addOutstandingCallback();
+ Future(() => throw TestFailure('oh no'))
+ .whenComplete(Invoker.current!.removeOutstandingCallback);
+ }, max: 1));
+ });
+
+ await _runTest(tests.single as Test, shouldFail: true);
+ expect(tearDownRun, isTrue);
+ });
+
+ test('can return a Future', () async {
+ var tearDownRun = false;
+ var tests = declare(() {
+ tearDown(() {
+ return Future(() => tearDownRun = true);
+ });
+
+ test(
+ 'description',
+ expectAsync0(() {
+ expect(tearDownRun, isFalse);
+ }, max: 1));
+ });
+
+ await _runTest(tests.single as Test);
+ expect(tearDownRun, isTrue);
+ });
+
+ test("isn't run until there are no outstanding callbacks", () async {
+ var outstandingCallbackRemoved = false;
+ var outstandingCallbackRemovedBeforeTeardown = false;
+ var tests = declare(() {
+ tearDown(() {
+ outstandingCallbackRemovedBeforeTeardown = outstandingCallbackRemoved;
+ });
+
+ test('description', () {
+ Invoker.current!.addOutstandingCallback();
+ pumpEventQueue().then((_) {
+ outstandingCallbackRemoved = true;
+ Invoker.current!.removeOutstandingCallback();
+ });
+ });
+ });
+
+ await _runTest(tests.single as Test);
+ expect(outstandingCallbackRemovedBeforeTeardown, isTrue);
+ });
+
+ test("isn't run until test body completes after out-of-band error",
+ () async {
+ var hasTestFinished = false;
+ var hasTestFinishedBeforeTeardown = false;
+ var tests = declare(() {
+ tearDown(() {
+ hasTestFinishedBeforeTeardown = hasTestFinished;
+ });
+
+ test('description', () {
+ Future<Never>.error('oh no');
+ return pumpEventQueue().then((_) {
+ hasTestFinished = true;
+ });
+ });
+ });
+
+ await _runTest(tests.single as Test, shouldFail: true);
+ expect(hasTestFinishedBeforeTeardown, isTrue);
+ });
+
+ test("doesn't complete until there are no outstanding callbacks", () async {
+ var outstandingCallbackRemoved = false;
+ var tests = declare(() {
+ tearDown(() {
+ Invoker.current!.addOutstandingCallback();
+ pumpEventQueue().then((_) {
+ outstandingCallbackRemoved = true;
+ Invoker.current!.removeOutstandingCallback();
+ });
+ });
+
+ test('description', () {});
+ });
+
+ await _runTest(tests.single as Test);
+ expect(outstandingCallbackRemoved, isTrue);
+ });
+
+ test('runs in reverse call order within a group', () async {
+ var firstTearDownRun = false;
+ var secondTearDownRun = false;
+ var thirdTearDownRun = false;
+ var tests = declare(() {
+ tearDown(expectAsync0(() async {
+ expect(secondTearDownRun, isTrue);
+ expect(thirdTearDownRun, isTrue);
+ firstTearDownRun = true;
+ }));
+
+ tearDown(expectAsync0(() async {
+ expect(firstTearDownRun, isFalse);
+ expect(thirdTearDownRun, isTrue);
+ secondTearDownRun = true;
+ }));
+
+ tearDown(expectAsync0(() async {
+ expect(firstTearDownRun, isFalse);
+ expect(secondTearDownRun, isFalse);
+ thirdTearDownRun = true;
+ }));
+
+ test(
+ 'description',
+ expectAsync0(() {
+ expect(firstTearDownRun, isFalse);
+ expect(secondTearDownRun, isFalse);
+ expect(thirdTearDownRun, isFalse);
+ }, max: 1));
+ });
+
+ await _runTest(tests.single as Test);
+ });
+
+ test('runs further tearDowns in a group even if one fails', () async {
+ var tests = declare(() {
+ tearDown(expectAsync0(() {}));
+
+ tearDown(() async {
+ throw 'error';
+ });
+
+ test('description', expectAsync0(() {}));
+ });
+
+ await _runTest(tests.single as Test, shouldFail: true);
+ });
+
+ test('runs in the same error zone as the test', () {
+ return expectTestsPass(() {
+ late Zone testBodyZone;
+
+ tearDown(() {
+ final tearDownZone = Zone.current;
+ expect(tearDownZone.inSameErrorZone(testBodyZone), isTrue,
+ reason: 'The tear down callback is in a different error zone '
+ 'than the test body.');
+ });
+
+ test('test', () {
+ testBodyZone = Zone.current;
+ });
+ });
+ });
+ });
+
+ group('in a group,', () {
+ test("tests inherit the group's description", () {
+ var entries = declare(() {
+ group('group', () {
+ test('description', () {});
+ });
+ });
+
+ expect(entries, hasLength(1));
+ var testGroup = entries.single as Group;
+ expect(testGroup.name, equals('group'));
+ expect(testGroup.entries, hasLength(1));
+ expect(testGroup.entries.single, const TypeMatcher<Test>());
+ expect(testGroup.entries.single.name, 'group description');
+ });
+
+ test("tests inherit the group's description when it's not a string", () {
+ var entries = declare(() {
+ group(Object, () {
+ test('description', () {});
+ });
+ });
+
+ expect(entries, hasLength(1));
+ var testGroup = entries.single as Group;
+ expect(testGroup.name, equals('Object'));
+ expect(testGroup.entries, hasLength(1));
+ expect(testGroup.entries.single, const TypeMatcher<Test>());
+ expect(testGroup.entries.single.name, 'Object description');
+ });
+
+ test("a test's timeout factor is applied to the group's", () {
+ var entries = declare(() {
+ group('group', () {
+ test('test', () {}, timeout: const Timeout.factor(3));
+ }, timeout: const Timeout.factor(2));
+ });
+
+ expect(entries, hasLength(1));
+ var testGroup = entries.single as Group;
+ expect(testGroup.metadata.timeout.scaleFactor, equals(2));
+ expect(testGroup.entries, hasLength(1));
+ expect(testGroup.entries.single, const TypeMatcher<Test>());
+ expect(testGroup.entries.single.metadata.timeout.scaleFactor, equals(6));
+ });
+
+ test("a test's timeout factor is applied to the group's duration", () {
+ var entries = declare(() {
+ group('group', () {
+ test('test', () {}, timeout: const Timeout.factor(2));
+ }, timeout: const Timeout(Duration(seconds: 10)));
+ });
+
+ expect(entries, hasLength(1));
+ var testGroup = entries.single as Group;
+ expect(testGroup.metadata.timeout.duration,
+ equals(const Duration(seconds: 10)));
+ expect(testGroup.entries, hasLength(1));
+ expect(testGroup.entries.single, const TypeMatcher<Test>());
+ expect(testGroup.entries.single.metadata.timeout.duration,
+ equals(const Duration(seconds: 20)));
+ });
+
+ test("a test's timeout duration is applied over the group's", () {
+ var entries = declare(() {
+ group('group', () {
+ test('test', () {}, timeout: const Timeout(Duration(seconds: 15)));
+ }, timeout: const Timeout(Duration(seconds: 10)));
+ });
+
+ expect(entries, hasLength(1));
+ var testGroup = entries.single as Group;
+ expect(testGroup.metadata.timeout.duration,
+ equals(const Duration(seconds: 10)));
+ expect(testGroup.entries, hasLength(1));
+ expect(testGroup.entries.single, const TypeMatcher<Test>());
+ expect(testGroup.entries.single.metadata.timeout.duration,
+ equals(const Duration(seconds: 15)));
+ });
+
+ test('disallows asynchronous groups', () async {
+ declare(() {
+ expect(() => group('group', () async {}), throwsArgumentError);
+ });
+ });
+
+ group('.setUp()', () {
+ test('is scoped to the group', () async {
+ var setUpRun = false;
+ var entries = declare(() {
+ group('group', () {
+ setUp(() => setUpRun = true);
+
+ test(
+ 'description 1',
+ expectAsync0(() {
+ expect(setUpRun, isTrue);
+ setUpRun = false;
+ }, max: 1));
+ });
+
+ test(
+ 'description 2',
+ expectAsync0(() {
+ expect(setUpRun, isFalse);
+ setUpRun = false;
+ }, max: 1));
+ });
+
+ await _runTest((entries[0] as Group).entries.single as Test);
+ await _runTest(entries[1] as Test);
+ });
+
+ test('runs from the outside in', () {
+ var outerSetUpRun = false;
+ var middleSetUpRun = false;
+ var innerSetUpRun = false;
+ var entries = declare(() {
+ setUp(expectAsync0(() {
+ expect(middleSetUpRun, isFalse);
+ expect(innerSetUpRun, isFalse);
+ outerSetUpRun = true;
+ }, max: 1));
+
+ group('middle', () {
+ setUp(expectAsync0(() {
+ expect(outerSetUpRun, isTrue);
+ expect(innerSetUpRun, isFalse);
+ middleSetUpRun = true;
+ }, max: 1));
+
+ group('inner', () {
+ setUp(expectAsync0(() {
+ expect(outerSetUpRun, isTrue);
+ expect(middleSetUpRun, isTrue);
+ innerSetUpRun = true;
+ }, max: 1));
+
+ test(
+ 'description',
+ expectAsync0(() {
+ expect(outerSetUpRun, isTrue);
+ expect(middleSetUpRun, isTrue);
+ expect(innerSetUpRun, isTrue);
+ }, max: 1));
+ });
+ });
+ });
+
+ var middleGroup = entries.single as Group;
+ var innerGroup = middleGroup.entries.single as Group;
+ return _runTest(innerGroup.entries.single as Test);
+ });
+
+ test('handles Futures when chained', () {
+ var outerSetUpRun = false;
+ var innerSetUpRun = false;
+ var entries = declare(() {
+ setUp(expectAsync0(() {
+ expect(innerSetUpRun, isFalse);
+ return Future(() => outerSetUpRun = true);
+ }, max: 1));
+
+ group('inner', () {
+ setUp(expectAsync0(() {
+ expect(outerSetUpRun, isTrue);
+ return Future(() => innerSetUpRun = true);
+ }, max: 1));
+
+ test(
+ 'description',
+ expectAsync0(() {
+ expect(outerSetUpRun, isTrue);
+ expect(innerSetUpRun, isTrue);
+ }, max: 1));
+ });
+ });
+
+ var innerGroup = entries.single as Group;
+ return _runTest(innerGroup.entries.single as Test);
+ });
+
+ test("inherits group's tags", () {
+ var tests = declare(() {
+ group('outer', () {
+ group('inner', () {
+ test('with tags', () {}, tags: 'd');
+ }, tags: ['b', 'c']);
+ }, tags: 'a');
+ });
+
+ var outerGroup = tests.single as Group;
+ var innerGroup = outerGroup.entries.single as Group;
+ var testWithTags = innerGroup.entries.single;
+ expect(outerGroup.metadata.tags, unorderedEquals(['a']));
+ expect(innerGroup.metadata.tags, unorderedEquals(['a', 'b', 'c']));
+ expect(
+ testWithTags.metadata.tags, unorderedEquals(['a', 'b', 'c', 'd']));
+ });
+
+ test('throws on invalid tags', () {
+ expect(() {
+ declare(() {
+ group('a', () {}, tags: 1);
+ });
+ }, throwsArgumentError);
+ });
+ });
+
+ group('.tearDown()', () {
+ test('is scoped to the group', () async {
+ late bool tearDownRun;
+ var entries = declare(() {
+ setUp(() => tearDownRun = false);
+
+ group('group', () {
+ tearDown(() => tearDownRun = true);
+
+ test(
+ 'description 1',
+ expectAsync0(() {
+ expect(tearDownRun, isFalse);
+ }, max: 1));
+ });
+
+ test(
+ 'description 2',
+ expectAsync0(() {
+ expect(tearDownRun, isFalse);
+ }, max: 1));
+ });
+
+ var testGroup = entries[0] as Group;
+ await _runTest(testGroup.entries.single as Test);
+ expect(tearDownRun, isTrue);
+ await _runTest(entries[1] as Test);
+ expect(tearDownRun, isFalse);
+ });
+
+ test('runs from the inside out', () async {
+ var innerTearDownRun = false;
+ var middleTearDownRun = false;
+ var outerTearDownRun = false;
+ var entries = declare(() {
+ tearDown(expectAsync0(() {
+ expect(innerTearDownRun, isTrue);
+ expect(middleTearDownRun, isTrue);
+ outerTearDownRun = true;
+ }, max: 1));
+
+ group('middle', () {
+ tearDown(expectAsync0(() {
+ expect(innerTearDownRun, isTrue);
+ expect(outerTearDownRun, isFalse);
+ middleTearDownRun = true;
+ }, max: 1));
+
+ group('inner', () {
+ tearDown(expectAsync0(() {
+ expect(outerTearDownRun, isFalse);
+ expect(middleTearDownRun, isFalse);
+ innerTearDownRun = true;
+ }, max: 1));
+
+ test(
+ 'description',
+ expectAsync0(() {
+ expect(outerTearDownRun, isFalse);
+ expect(middleTearDownRun, isFalse);
+ expect(innerTearDownRun, isFalse);
+ }, max: 1));
+ });
+ });
+ });
+
+ var middleGroup = entries.single as Group;
+ var innerGroup = middleGroup.entries.single as Group;
+ await _runTest(innerGroup.entries.single as Test);
+ expect(innerTearDownRun, isTrue);
+ expect(middleTearDownRun, isTrue);
+ expect(outerTearDownRun, isTrue);
+ });
+
+ test('handles Futures when chained', () async {
+ var outerTearDownRun = false;
+ var innerTearDownRun = false;
+ var entries = declare(() {
+ tearDown(expectAsync0(() {
+ expect(innerTearDownRun, isTrue);
+ return Future(() => outerTearDownRun = true);
+ }, max: 1));
+
+ group('inner', () {
+ tearDown(expectAsync0(() {
+ expect(outerTearDownRun, isFalse);
+ return Future(() => innerTearDownRun = true);
+ }, max: 1));
+
+ test(
+ 'description',
+ expectAsync0(() {
+ expect(outerTearDownRun, isFalse);
+ expect(innerTearDownRun, isFalse);
+ }, max: 1));
+ });
+ });
+
+ var innerGroup = entries.single as Group;
+ await _runTest(innerGroup.entries.single as Test);
+ expect(innerTearDownRun, isTrue);
+ expect(outerTearDownRun, isTrue);
+ });
+
+ test('runs outer callbacks even when inner ones fail', () async {
+ var outerTearDownRun = false;
+ var entries = declare(() {
+ tearDown(() {
+ return Future(() => outerTearDownRun = true);
+ });
+
+ group('inner', () {
+ tearDown(() {
+ throw 'inner error';
+ });
+
+ test(
+ 'description',
+ expectAsync0(() {
+ expect(outerTearDownRun, isFalse);
+ }, max: 1));
+ });
+ });
+
+ var innerGroup = entries.single as Group;
+ await _runTest(innerGroup.entries.single as Test, shouldFail: true);
+ expect(outerTearDownRun, isTrue);
+ });
+ });
+ });
+
+ group('duplicate names', () {
+ test('can be enabled', () {
+ expect(
+ () => declare(() {
+ test('a', expectAsync0(() {}, count: 0));
+ test('a', expectAsync0(() {}, count: 0));
+ }, allowDuplicateTestNames: false),
+ throwsA(isA<DuplicateTestNameException>()
+ .having((e) => e.name, 'name', 'a')));
+ });
+
+ test('are allowed by default', () {
+ expect(
+ declare(() {
+ test('a', expectAsync0(() {}, count: 0));
+ test('a', expectAsync0(() {}, count: 0));
+ }).map((e) => e.name),
+ equals(['a', 'a']));
+ });
+ });
+}
+
+/// Runs [test].
+///
+/// This automatically sets up an `onError` listener to ensure that the test
+/// doesn't throw any invisible exceptions.
+Future _runTest(Test test, {bool shouldFail = false}) {
+ var liveTest = test.load(_suite);
+
+ if (shouldFail) {
+ liveTest.onError.listen(expectAsync1((_) {}));
+ } else {
+ liveTest.onError.listen((e) => registerException(e.error, e.stackTrace));
+ }
+
+ return liveTest.run();
+}
diff --git a/pkgs/test_api/test/backend/invoker_test.dart b/pkgs/test_api/test/backend/invoker_test.dart
new file mode 100644
index 0000000..ef08b38
--- /dev/null
+++ b/pkgs/test_api/test/backend/invoker_test.dart
@@ -0,0 +1,581 @@
+// Copyright (c) 2015, 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:test/test.dart';
+import 'package:test_api/src/backend/group.dart';
+import 'package:test_api/src/backend/invoker.dart';
+import 'package:test_api/src/backend/live_test.dart';
+import 'package:test_api/src/backend/message.dart';
+import 'package:test_api/src/backend/metadata.dart';
+import 'package:test_api/src/backend/state.dart';
+import 'package:test_api/src/backend/suite.dart';
+
+import '../utils.dart';
+
+void main() {
+ late Suite suite;
+ setUp(() {
+ lastState = null;
+ suite = Suite(Group.root([]), suitePlatform, ignoreTimeouts: false);
+ });
+
+ group('Invoker.current', () {
+ var invoker = Invoker.current;
+ test('returns null outside of a test body', () {
+ expect(invoker, isNull);
+ });
+
+ test('returns the current invoker in a test body', () async {
+ late Invoker invoker;
+ var liveTest = _localTest(() {
+ invoker = Invoker.current!;
+ }).load(suite);
+ liveTest.onError.listen(expectAsync1((_) {}, count: 0));
+
+ await liveTest.run();
+ expect(invoker.liveTest, equals(liveTest));
+ });
+
+ test('returns the current invoker in a test body after the test completes',
+ () async {
+ Status? status;
+ var completer = Completer<Invoker>();
+ var liveTest = _localTest(() {
+ // Use the event loop to wait longer than a microtask for the test to
+ // complete.
+ Future(() {
+ status = Invoker.current!.liveTest.state.status;
+ completer.complete(Invoker.current);
+ });
+ }).load(suite);
+ liveTest.onError.listen(expectAsync1((_) {}, count: 0));
+
+ expect(liveTest.run(), completes);
+ var invoker = await completer.future;
+ expect(invoker.liveTest, equals(liveTest));
+ expect(status, equals(Status.complete));
+ });
+ });
+
+ group('in a successful test,', () {
+ test('the state changes from pending to running to complete', () async {
+ late State stateInTest;
+ late LiveTest liveTest;
+ liveTest = _localTest(() {
+ stateInTest = liveTest.state;
+ }).load(suite);
+ liveTest.onError.listen(expectAsync1((_) {}, count: 0));
+
+ expect(liveTest.state.status, equals(Status.pending));
+ expect(liveTest.state.result, equals(Result.success));
+
+ var future = liveTest.run();
+
+ expect(liveTest.state.status, equals(Status.running));
+ expect(liveTest.state.result, equals(Result.success));
+
+ await future;
+
+ expect(stateInTest.status, equals(Status.running));
+ expect(stateInTest.result, equals(Result.success));
+
+ expect(liveTest.state.status, equals(Status.complete));
+ expect(liveTest.state.result, equals(Result.success));
+ });
+
+ test('onStateChange fires for each state change', () {
+ var liveTest = _localTest(() {}).load(suite);
+ liveTest.onError.listen(expectAsync1((_) {}, count: 0));
+
+ var first = true;
+ liveTest.onStateChange.listen(expectAsync1((state) {
+ if (first) {
+ expect(state.status, equals(Status.running));
+ first = false;
+ } else {
+ expect(state.status, equals(Status.complete));
+ }
+ expect(state.result, equals(Result.success));
+ }, count: 2, max: 2));
+
+ return liveTest.run();
+ });
+
+ test('onComplete completes once the test body is done', () {
+ var testRun = false;
+ var liveTest = _localTest(() {
+ testRun = true;
+ }).load(suite);
+
+ expect(liveTest.onComplete.then((_) {
+ expect(testRun, isTrue);
+ }), completes);
+
+ return liveTest.run();
+ });
+ });
+
+ group('in a test with failures,', () {
+ test('a synchronous throw is reported and causes the test to fail', () {
+ var liveTest = _localTest(() {
+ throw TestFailure('oh no');
+ }).load(suite);
+
+ expectSingleFailure(liveTest);
+ return liveTest.run();
+ });
+
+ test('a synchronous reported failure causes the test to fail', () {
+ var liveTest = _localTest(() {
+ registerException(TestFailure('oh no'));
+ }).load(suite);
+
+ expectSingleFailure(liveTest);
+ return liveTest.run();
+ });
+
+ test('a failure reported asynchronously during the test causes it to fail',
+ () {
+ var liveTest = _localTest(() {
+ Invoker.current!.addOutstandingCallback();
+ Future(() => registerException(TestFailure('oh no')))
+ .whenComplete(Invoker.current!.removeOutstandingCallback);
+ }).load(suite);
+
+ expectSingleFailure(liveTest);
+ return liveTest.run();
+ });
+
+ test('a failure thrown asynchronously during the test causes it to fail',
+ () {
+ var liveTest = _localTest(() {
+ Invoker.current!.addOutstandingCallback();
+ Future(() => throw TestFailure('oh no'))
+ .whenComplete(Invoker.current!.removeOutstandingCallback);
+ }).load(suite);
+
+ expectSingleFailure(liveTest);
+ return liveTest.run();
+ });
+
+ test('a failure reported asynchronously after the test causes it to error',
+ () {
+ var liveTest = _localTest(() {
+ Future(() => registerException(TestFailure('oh no')));
+ }).load(suite);
+
+ expectStates(liveTest, [
+ const State(Status.running, Result.success),
+ const State(Status.complete, Result.success),
+ const State(Status.complete, Result.failure),
+ const State(Status.complete, Result.error)
+ ]);
+
+ expectErrors(liveTest, [
+ (error) {
+ expect(
+ lastState, equals(const State(Status.complete, Result.failure)));
+ expect(error, isTestFailure('oh no'));
+ },
+ (error) {
+ expect(lastState, equals(const State(Status.complete, Result.error)));
+ expect(
+ error,
+ equals('This test failed after it had already completed.\n'
+ 'Make sure to use a matching library which informs the '
+ 'test runner\nof pending async work.'));
+ }
+ ]);
+
+ return liveTest.run();
+ });
+
+ test('multiple asynchronous failures are reported', () {
+ var liveTest = _localTest(() {
+ Invoker.current!.addOutstandingCallback();
+ Future(() => throw TestFailure('one'));
+ Future(() => throw TestFailure('two'));
+ Future(() => throw TestFailure('three'));
+ Future(() => throw TestFailure('four'))
+ .whenComplete(Invoker.current!.removeOutstandingCallback);
+ }).load(suite);
+
+ expectStates(liveTest, [
+ const State(Status.running, Result.success),
+ const State(Status.complete, Result.failure)
+ ]);
+
+ expectErrors(liveTest, [
+ (error) {
+ expect(lastState?.status, equals(Status.complete));
+ expect(error, isTestFailure('one'));
+ },
+ (error) {
+ expect(error, isTestFailure('two'));
+ },
+ (error) {
+ expect(error, isTestFailure('three'));
+ },
+ (error) {
+ expect(error, isTestFailure('four'));
+ }
+ ]);
+
+ return liveTest.run();
+ });
+
+ test("a failure after an error doesn't change the state of the test", () {
+ var liveTest = _localTest(() {
+ Future(() => throw TestFailure('fail'));
+ throw 'error';
+ }).load(suite);
+
+ expectStates(liveTest, [
+ const State(Status.running, Result.success),
+ const State(Status.complete, Result.error)
+ ]);
+
+ expectErrors(liveTest, [
+ (error) {
+ expect(lastState, equals(const State(Status.complete, Result.error)));
+ expect(error, equals('error'));
+ },
+ (error) {
+ expect(error, isTestFailure('fail'));
+ }
+ ]);
+
+ return liveTest.run();
+ });
+ });
+
+ group('in a test with errors,', () {
+ test('a synchronous throw is reported and causes the test to error', () {
+ var liveTest = _localTest(() {
+ throw 'oh no';
+ }).load(suite);
+
+ expectSingleError(liveTest);
+ return liveTest.run();
+ });
+
+ test('a synchronous reported error causes the test to error', () {
+ var liveTest = _localTest(() {
+ registerException('oh no');
+ }).load(suite);
+
+ expectSingleError(liveTest);
+ return liveTest.run();
+ });
+
+ test('an error reported asynchronously during the test causes it to error',
+ () {
+ var liveTest = _localTest(() {
+ Invoker.current!.addOutstandingCallback();
+ Future(() => registerException('oh no'))
+ .whenComplete(Invoker.current!.removeOutstandingCallback);
+ }).load(suite);
+
+ expectSingleError(liveTest);
+ return liveTest.run();
+ });
+
+ test('an error thrown asynchronously during the test causes it to error',
+ () {
+ var liveTest = _localTest(() {
+ Invoker.current!.addOutstandingCallback();
+ Future(() => throw 'oh no')
+ .whenComplete(Invoker.current!.removeOutstandingCallback);
+ }).load(suite);
+
+ expectSingleError(liveTest);
+ return liveTest.run();
+ });
+
+ test('an error reported asynchronously after the test causes it to error',
+ () {
+ var liveTest = _localTest(() {
+ Future(() => registerException('oh no'));
+ }).load(suite);
+
+ expectStates(liveTest, [
+ const State(Status.running, Result.success),
+ const State(Status.complete, Result.success),
+ const State(Status.complete, Result.error)
+ ]);
+
+ expectErrors(liveTest, [
+ (error) {
+ expect(lastState, equals(const State(Status.complete, Result.error)));
+ expect(error, equals('oh no'));
+ },
+ (error) {
+ expect(
+ error,
+ equals('This test failed after it had already completed.\n'
+ 'Make sure to use a matching library which informs the '
+ 'test runner\nof pending async work.'));
+ }
+ ]);
+
+ return liveTest.run();
+ });
+
+ test('multiple asynchronous errors are reported', () {
+ var liveTest = _localTest(() {
+ Invoker.current!.addOutstandingCallback();
+ Future(() => throw 'one');
+ Future(() => throw 'two');
+ Future(() => throw 'three');
+ Future(() => throw 'four')
+ .whenComplete(Invoker.current!.removeOutstandingCallback);
+ }).load(suite);
+
+ expectStates(liveTest, [
+ const State(Status.running, Result.success),
+ const State(Status.complete, Result.error)
+ ]);
+
+ expectErrors(liveTest, [
+ (error) {
+ expect(lastState?.status, equals(Status.complete));
+ expect(error, equals('one'));
+ },
+ (error) {
+ expect(error, equals('two'));
+ },
+ (error) {
+ expect(error, equals('three'));
+ },
+ (error) {
+ expect(error, equals('four'));
+ }
+ ]);
+
+ return liveTest.run();
+ });
+
+ test('an error after a failure changes the state of the test', () {
+ var liveTest = _localTest(() {
+ Future(() => throw 'error');
+ throw TestFailure('fail');
+ }).load(suite);
+
+ expectStates(liveTest, [
+ const State(Status.running, Result.success),
+ const State(Status.complete, Result.failure),
+ const State(Status.complete, Result.error)
+ ]);
+
+ expectErrors(liveTest, [
+ (error) {
+ expect(
+ lastState, equals(const State(Status.complete, Result.failure)));
+ expect(error, isTestFailure('fail'));
+ },
+ (error) {
+ expect(lastState, equals(const State(Status.complete, Result.error)));
+ expect(error, equals('error'));
+ }
+ ]);
+
+ return liveTest.run();
+ });
+ });
+
+ test("a test doesn't complete until there are no outstanding callbacks",
+ () async {
+ var outstandingCallbackRemoved = false;
+ var liveTest = _localTest(() {
+ Invoker.current!.addOutstandingCallback();
+
+ // Pump the event queue to make sure the test isn't coincidentally
+ // completing after the outstanding callback is removed.
+ pumpEventQueue().then((_) {
+ outstandingCallbackRemoved = true;
+ Invoker.current!.removeOutstandingCallback();
+ });
+ }).load(suite);
+
+ liveTest.onError.listen(expectAsync1((_) {}, count: 0));
+
+ await liveTest.run();
+ expect(outstandingCallbackRemoved, isTrue);
+ });
+
+ test("a test's prints are captured and reported", () {
+ expect(() {
+ var liveTest = _localTest(() {
+ print('Hello,');
+ return Future(() => print('world!'));
+ }).load(suite);
+
+ expect(
+ liveTest.onMessage.take(2).toList().then((messages) {
+ expect(messages[0].type, equals(MessageType.print));
+ expect(messages[0].text, equals('Hello,'));
+ expect(messages[1].type, equals(MessageType.print));
+ expect(messages[1].text, equals('world!'));
+ }),
+ completes);
+
+ return liveTest.run();
+ }, prints(isEmpty));
+ });
+
+ group('timeout:', () {
+ test('A test can be timed out', () {
+ var liveTest = _localTest(() {
+ Invoker.current!.addOutstandingCallback();
+ },
+ metadata: Metadata(
+ chainStackTraces: true,
+ timeout: const Timeout(Duration.zero)))
+ .load(suite);
+
+ expectStates(liveTest, [
+ const State(Status.running, Result.success),
+ const State(Status.complete, Result.error)
+ ]);
+
+ expectErrors(liveTest, [
+ (error) {
+ expect(lastState!.status, equals(Status.complete));
+ expect(error, const TypeMatcher<TimeoutException>());
+ }
+ ]);
+
+ liveTest.run();
+ });
+
+ test('can be ignored', () {
+ suite = Suite(Group.root([]), suitePlatform, ignoreTimeouts: true);
+ var liveTest = _localTest(() async {
+ await Future<void>.delayed(const Duration(milliseconds: 10));
+ },
+ metadata: Metadata(
+ chainStackTraces: true,
+ timeout: const Timeout(Duration.zero)))
+ .load(suite);
+
+ expectStates(liveTest, [
+ const State(Status.running, Result.success),
+ const State(Status.complete, Result.success)
+ ]);
+
+ liveTest.run();
+ });
+ });
+
+ group('runTearDowns', () {
+ test('runs multiple tear downs', () async {
+ var firstTearDownStarted = false;
+ var secondTearDownStarted = false;
+ await Invoker.current!.runTearDowns([
+ () {
+ firstTearDownStarted = true;
+ },
+ () {
+ secondTearDownStarted = true;
+ }
+ ]);
+ expect(secondTearDownStarted, isTrue);
+ expect(firstTearDownStarted, isTrue);
+ });
+
+ test('waits for the future returned tear downs to complete', () async {
+ var firstTearDownWork = Completer<void>();
+ var secondTearDownStarted = false;
+ var result = Invoker.current!.runTearDowns([
+ () {
+ secondTearDownStarted = true;
+ },
+ () async {
+ await firstTearDownWork.future;
+ },
+ ]);
+ await pumpEventQueue();
+ expect(secondTearDownStarted, isFalse);
+ firstTearDownWork.complete();
+ await result;
+ expect(secondTearDownStarted, isTrue);
+ });
+
+ test('allows next tear down to run while there are still prior callbacks',
+ () async {
+ var firstTearDownAsyncWork = Completer<void>();
+ var secondTearDownStarted = false;
+ unawaited(Invoker.current!.runTearDowns([
+ () {
+ secondTearDownStarted = true;
+ },
+ () {
+ Invoker.current!.addOutstandingCallback();
+ firstTearDownAsyncWork.future
+ .whenComplete(Invoker.current!.removeOutstandingCallback);
+ },
+ ]));
+ await pumpEventQueue();
+ expect(secondTearDownStarted, isTrue);
+ firstTearDownAsyncWork.complete();
+ });
+
+ test('forwards errors to the enclosing test but does not end it', () async {
+ var liveTest = _localTest(() async {
+ Invoker.current!.addOutstandingCallback();
+ await Invoker.current!.runTearDowns([
+ () {
+ throw 'oh no';
+ }
+ ]);
+ }).load(suite);
+
+ expectStates(liveTest, [
+ const State(Status.running, Result.success),
+ const State(Status.complete, Result.error)
+ ]);
+
+ var isComplete = false;
+ unawaited(liveTest.run().then((_) => isComplete = true));
+ await pumpEventQueue();
+ expect(liveTest.state.status, equals(Status.complete));
+ expect(isComplete, isFalse);
+ });
+ });
+
+ group('printOnFailure:', () {
+ test("doesn't print anything if the test succeeds", () async {
+ var liveTest = _localTest(() {
+ Invoker.current!.printOnFailure('only on failure');
+ }).load(suite);
+ liveTest.onError.listen(expectAsync1((_) {}, count: 0));
+
+ liveTest.onMessage.listen(expectAsync1((_) {}, count: 0));
+
+ await liveTest.run();
+ });
+
+ test('prints if the test fails', () async {
+ var liveTest = _localTest(() {
+ Invoker.current!.printOnFailure('only on failure');
+ expect(true, isFalse);
+ }).load(suite);
+ liveTest.onError.listen(expectAsync1((_) {}, count: 1));
+
+ liveTest.onMessage.listen(expectAsync1((message) {
+ expect(message.type, equals(MessageType.print));
+ expect(message.text, equals('only on failure'));
+ }, count: 1));
+
+ await liveTest.run();
+ });
+ });
+}
+
+LocalTest _localTest(dynamic Function() body, {Metadata? metadata}) {
+ metadata ??= Metadata(chainStackTraces: true);
+ return LocalTest('test', metadata, body);
+}
diff --git a/pkgs/test_api/test/backend/metadata_test.dart b/pkgs/test_api/test/backend/metadata_test.dart
new file mode 100644
index 0000000..f42a535
--- /dev/null
+++ b/pkgs/test_api/test/backend/metadata_test.dart
@@ -0,0 +1,257 @@
+// Copyright (c) 2015, 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 'package:boolean_selector/boolean_selector.dart';
+import 'package:test/test.dart';
+import 'package:test_api/src/backend/metadata.dart';
+import 'package:test_api/src/backend/platform_selector.dart';
+import 'package:test_api/src/backend/runtime.dart';
+import 'package:test_api/src/backend/suite_platform.dart';
+
+void main() {
+ group('tags', () {
+ test('parses an Iterable', () {
+ expect(
+ Metadata.parse(tags: ['a', 'b']).tags, unorderedEquals(['a', 'b']));
+ });
+
+ test('parses a String', () {
+ expect(Metadata.parse(tags: 'a').tags, unorderedEquals(['a']));
+ });
+
+ test('parses null', () {
+ expect(Metadata.parse().tags, unorderedEquals([]));
+ });
+
+ test('parse refuses an invalid type', () {
+ expect(() => Metadata.parse(tags: 1), throwsArgumentError);
+ });
+
+ test('parse refuses an invalid type in a list', () {
+ expect(() => Metadata.parse(tags: [1]), throwsArgumentError);
+ });
+
+ test('merges tags by computing the union of the two tag sets', () {
+ var merged = Metadata(tags: ['a', 'b']).merge(Metadata(tags: ['b', 'c']));
+ expect(merged.tags, unorderedEquals(['a', 'b', 'c']));
+ });
+
+ test('serializes and deserializes tags', () {
+ var metadata = Metadata(tags: ['a', 'b']).serialize();
+ expect(Metadata.deserialize(metadata).tags, unorderedEquals(['a', 'b']));
+ });
+ });
+
+ group('constructor', () {
+ test("returns the normal metadata if there's no forTag", () {
+ var metadata = Metadata(verboseTrace: true, tags: ['foo', 'bar']);
+ expect(metadata.verboseTrace, isTrue);
+ expect(metadata.tags, equals(['foo', 'bar']));
+ });
+
+ test("returns the normal metadata if there's no tags", () {
+ var metadata = Metadata(
+ verboseTrace: true,
+ forTag: {BooleanSelector.parse('foo'): Metadata(skip: true)});
+ expect(metadata.verboseTrace, isTrue);
+ expect(metadata.skip, isFalse);
+ expect(metadata.forTag, contains(BooleanSelector.parse('foo')));
+ expect(metadata.forTag[BooleanSelector.parse('foo')]?.skip, isTrue);
+ });
+
+ test("returns the normal metadata if forTag doesn't match tags", () {
+ var metadata = Metadata(
+ verboseTrace: true,
+ tags: ['bar', 'baz'],
+ forTag: {BooleanSelector.parse('foo'): Metadata(skip: true)});
+
+ expect(metadata.verboseTrace, isTrue);
+ expect(metadata.skip, isFalse);
+ expect(metadata.tags, unorderedEquals(['bar', 'baz']));
+ expect(metadata.forTag, contains(BooleanSelector.parse('foo')));
+ expect(metadata.forTag[BooleanSelector.parse('foo')]?.skip, isTrue);
+ });
+
+ test('resolves forTags that match tags', () {
+ var metadata = Metadata(verboseTrace: true, tags: [
+ 'foo',
+ 'bar',
+ 'baz'
+ ], forTag: {
+ BooleanSelector.parse('foo'): Metadata(skip: true),
+ BooleanSelector.parse('baz'): Metadata(timeout: Timeout.none),
+ BooleanSelector.parse('qux'): Metadata(skipReason: 'blah')
+ });
+
+ expect(metadata.verboseTrace, isTrue);
+ expect(metadata.skip, isTrue);
+ expect(metadata.skipReason, isNull);
+ expect(metadata.timeout, equals(Timeout.none));
+ expect(metadata.tags, unorderedEquals(['foo', 'bar', 'baz']));
+ expect(metadata.forTag.keys, equals([BooleanSelector.parse('qux')]));
+ });
+
+ test('resolves forTags that adds a behavioral tag', () {
+ var metadata = Metadata(tags: [
+ 'foo'
+ ], forTag: {
+ BooleanSelector.parse('baz'): Metadata(skip: true),
+ BooleanSelector.parse('bar'):
+ Metadata(verboseTrace: true, tags: ['baz']),
+ BooleanSelector.parse('foo'): Metadata(tags: ['bar'])
+ });
+
+ expect(metadata.verboseTrace, isTrue);
+ expect(metadata.skip, isTrue);
+ expect(metadata.tags, unorderedEquals(['foo', 'bar', 'baz']));
+ expect(metadata.forTag, isEmpty);
+ });
+
+ test('resolves forTags that adds circular tags', () {
+ var metadata = Metadata(tags: [
+ 'foo'
+ ], forTag: {
+ BooleanSelector.parse('foo'): Metadata(tags: ['bar']),
+ BooleanSelector.parse('bar'): Metadata(tags: ['baz']),
+ BooleanSelector.parse('baz'): Metadata(tags: ['foo'])
+ });
+
+ expect(metadata.tags, unorderedEquals(['foo', 'bar', 'baz']));
+ expect(metadata.forTag, isEmpty);
+ });
+
+ test('base metadata takes precedence over forTags', () {
+ var metadata = Metadata(verboseTrace: true, tags: [
+ 'foo'
+ ], forTag: {
+ BooleanSelector.parse('foo'): Metadata(verboseTrace: false)
+ });
+
+ expect(metadata.verboseTrace, isTrue);
+ });
+ });
+
+ group('onPlatform', () {
+ test('parses a valid map', () {
+ var metadata = Metadata.parse(onPlatform: {
+ 'chrome': const Timeout.factor(2),
+ 'vm': [const Skip(), const Timeout.factor(3)]
+ });
+
+ var key = metadata.onPlatform.keys.first;
+ expect(
+ key.evaluate(SuitePlatform(Runtime.chrome, compiler: null)), isTrue);
+ expect(key.evaluate(SuitePlatform(Runtime.vm, compiler: null)), isFalse);
+ var value = metadata.onPlatform.values.first;
+ expect(value.timeout.scaleFactor, equals(2));
+
+ key = metadata.onPlatform.keys.last;
+ expect(key.evaluate(SuitePlatform(Runtime.vm, compiler: null)), isTrue);
+ expect(
+ key.evaluate(SuitePlatform(Runtime.chrome, compiler: null)), isFalse);
+ value = metadata.onPlatform.values.last;
+ expect(value.skip, isTrue);
+ expect(value.timeout.scaleFactor, equals(3));
+ });
+
+ test('refuses an invalid value', () {
+ expect(() {
+ Metadata.parse(onPlatform: {'chrome': const TestOn('chrome')});
+ }, throwsArgumentError);
+ });
+
+ test('refuses an invalid value in a list', () {
+ expect(() {
+ Metadata.parse(onPlatform: {
+ 'chrome': [const TestOn('chrome')]
+ });
+ }, throwsArgumentError);
+ });
+
+ test('refuses an invalid platform selector', () {
+ expect(() {
+ Metadata.parse(onPlatform: {'vm &&': const Skip()});
+ }, throwsFormatException);
+ });
+
+ test('refuses multiple Timeouts', () {
+ expect(() {
+ Metadata.parse(onPlatform: {
+ 'chrome': [const Timeout.factor(2), const Timeout.factor(3)]
+ });
+ }, throwsArgumentError);
+ });
+
+ test('refuses multiple Skips', () {
+ expect(() {
+ Metadata.parse(onPlatform: {
+ 'chrome': [const Skip(), const Skip()]
+ });
+ }, throwsArgumentError);
+ });
+ });
+
+ group('validatePlatformSelectors', () {
+ test('succeeds if onPlatform uses valid platforms', () {
+ Metadata.parse(onPlatform: {'vm || browser': const Skip()})
+ .validatePlatformSelectors({'vm'});
+ });
+
+ test('succeeds if testOn uses valid platforms', () {
+ Metadata.parse(testOn: 'vm || browser').validatePlatformSelectors({'vm'});
+ });
+
+ test('succeeds if testOn uses valid compilers', () {
+ Metadata.parse(testOn: 'dart2js || kernel').validatePlatformSelectors({});
+ });
+
+ test('fails if onPlatform uses an invalid platform', () {
+ expect(() {
+ Metadata.parse(onPlatform: {'unknown': const Skip()})
+ .validatePlatformSelectors({'vm'});
+ }, throwsFormatException);
+ });
+
+ test('fails if testOn uses an invalid platform', () {
+ expect(() {
+ Metadata.parse(testOn: 'unknown').validatePlatformSelectors({'vm'});
+ }, throwsFormatException);
+ });
+
+ test('fails if testOn uses an invalid compiler', () {
+ expect(() {
+ Metadata.parse(testOn: 'foo2bar').validatePlatformSelectors({});
+ }, throwsFormatException);
+ });
+ });
+
+ group('change', () {
+ test('preserves all fields if no parameters are passed', () {
+ var metadata = Metadata(
+ testOn: PlatformSelector.parse('linux'),
+ timeout: const Timeout.factor(2),
+ skip: true,
+ skipReason: 'just because',
+ verboseTrace: true,
+ tags: [
+ 'foo',
+ 'bar'
+ ],
+ onPlatform: {
+ PlatformSelector.parse('mac-os'): Metadata(skip: false)
+ },
+ forTag: {
+ BooleanSelector.parse('slow'):
+ Metadata(timeout: const Timeout.factor(4))
+ });
+ expect(metadata.serialize(), equals(metadata.change().serialize()));
+ });
+
+ test('updates a changed field', () {
+ var metadata = Metadata(timeout: const Timeout.factor(2));
+ expect(metadata.change(timeout: const Timeout.factor(3)).timeout,
+ equals(const Timeout.factor(3)));
+ });
+ });
+}
diff --git a/pkgs/test_api/test/frontend/add_tear_down_test.dart b/pkgs/test_api/test/frontend/add_tear_down_test.dart
new file mode 100644
index 0000000..de4bb55
--- /dev/null
+++ b/pkgs/test_api/test/frontend/add_tear_down_test.dart
@@ -0,0 +1,798 @@
+// Copyright (c) 2016, 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:async/async.dart';
+import 'package:test/test.dart';
+
+import '../utils.dart';
+
+void main() {
+ group('in a test', () {
+ test('runs after the test body', () {
+ return expectTestsPass(() {
+ var test1Run = false;
+ var tearDownRun = false;
+ test('test 1', () {
+ addTearDown(() {
+ expect(test1Run, isTrue);
+ expect(tearDownRun, isFalse);
+ tearDownRun = true;
+ });
+
+ expect(tearDownRun, isFalse);
+ test1Run = true;
+ });
+
+ test('test 2', () {
+ expect(tearDownRun, isTrue);
+ });
+ });
+ });
+
+ test('multiples run in reverse order', () {
+ return expectTestsPass(() {
+ var tearDown1Run = false;
+ var tearDown2Run = false;
+ var tearDown3Run = false;
+
+ test('test 1', () {
+ addTearDown(() {
+ expect(tearDown1Run, isFalse);
+ expect(tearDown2Run, isTrue);
+ expect(tearDown3Run, isTrue);
+ tearDown1Run = true;
+ });
+
+ addTearDown(() {
+ expect(tearDown1Run, isFalse);
+ expect(tearDown2Run, isFalse);
+ expect(tearDown3Run, isTrue);
+ tearDown2Run = true;
+ });
+
+ addTearDown(() {
+ expect(tearDown1Run, isFalse);
+ expect(tearDown2Run, isFalse);
+ expect(tearDown3Run, isFalse);
+ tearDown3Run = true;
+ });
+
+ expect(tearDown1Run, isFalse);
+ expect(tearDown2Run, isFalse);
+ expect(tearDown3Run, isFalse);
+ });
+
+ test('test 2', () {
+ expect(tearDown1Run, isTrue);
+ expect(tearDown2Run, isTrue);
+ expect(tearDown3Run, isTrue);
+ });
+ });
+ });
+
+ test('can be called in addTearDown', () {
+ return expectTestsPass(() {
+ var tearDown2Run = false;
+ var tearDown3Run = false;
+
+ test('test 1', () {
+ addTearDown(() {
+ expect(tearDown2Run, isTrue);
+ expect(tearDown3Run, isFalse);
+ tearDown3Run = true;
+ });
+
+ addTearDown(() {
+ addTearDown(() {
+ expect(tearDown2Run, isFalse);
+ expect(tearDown3Run, isFalse);
+ tearDown2Run = true;
+ });
+ });
+ });
+
+ test('test 2', () {
+ expect(tearDown2Run, isTrue);
+ expect(tearDown3Run, isTrue);
+ });
+ });
+ });
+
+ test('can be called in tearDown', () {
+ return expectTestsPass(() {
+ var tearDown2Run = false;
+ var tearDown3Run = false;
+
+ tearDown(() {
+ expect(tearDown2Run, isTrue);
+ expect(tearDown3Run, isFalse);
+ tearDown3Run = true;
+ });
+
+ tearDown(() {
+ tearDown2Run = false;
+ tearDown3Run = false;
+
+ addTearDown(() {
+ expect(tearDown2Run, isFalse);
+ expect(tearDown3Run, isFalse);
+ tearDown2Run = true;
+ });
+ });
+
+ test('test 1', () {});
+
+ test('test 2', () {
+ expect(tearDown2Run, isTrue);
+ expect(tearDown3Run, isTrue);
+ });
+ });
+ });
+
+ test('runs before a normal tearDown', () {
+ return expectTestsPass(() {
+ var groupTearDownRun = false;
+ var testTearDownRun = false;
+ group('group', () {
+ tearDown(() {
+ expect(testTearDownRun, isTrue);
+ expect(groupTearDownRun, isFalse);
+ groupTearDownRun = true;
+ });
+
+ test('test 1', () {
+ addTearDown(() {
+ expect(groupTearDownRun, isFalse);
+ expect(testTearDownRun, isFalse);
+ testTearDownRun = true;
+ });
+
+ expect(groupTearDownRun, isFalse);
+ expect(testTearDownRun, isFalse);
+ });
+ });
+
+ test('test 2', () {
+ expect(groupTearDownRun, isTrue);
+ expect(testTearDownRun, isTrue);
+ });
+ });
+ });
+
+ test('runs in the same error zone as the test', () {
+ return expectTestsPass(() {
+ test('test', () {
+ final testBodyZone = Zone.current;
+
+ addTearDown(() {
+ final tearDownZone = Zone.current;
+ expect(tearDownZone.inSameErrorZone(testBodyZone), isTrue,
+ reason: 'The tear down callback is in a different error zone '
+ 'than the test body.');
+ });
+ });
+ });
+ });
+
+ group('asynchronously', () {
+ test('blocks additional test tearDowns on in-band async', () {
+ return expectTestsPass(() {
+ var tearDown1Run = false;
+ var tearDown2Run = false;
+ var tearDown3Run = false;
+ test('test', () {
+ addTearDown(() async {
+ expect(tearDown1Run, isFalse);
+ expect(tearDown2Run, isTrue);
+ expect(tearDown3Run, isTrue);
+ await pumpEventQueue();
+ tearDown1Run = true;
+ });
+
+ addTearDown(() async {
+ expect(tearDown1Run, isFalse);
+ expect(tearDown2Run, isFalse);
+ expect(tearDown3Run, isTrue);
+ await pumpEventQueue();
+ tearDown2Run = true;
+ });
+
+ addTearDown(() async {
+ expect(tearDown1Run, isFalse);
+ expect(tearDown2Run, isFalse);
+ expect(tearDown3Run, isFalse);
+ await pumpEventQueue();
+ tearDown3Run = true;
+ });
+
+ expect(tearDown1Run, isFalse);
+ expect(tearDown2Run, isFalse);
+ expect(tearDown3Run, isFalse);
+ });
+ });
+ });
+
+ test("doesn't block additional test tearDowns on out-of-band async", () {
+ return expectTestsPass(() {
+ var tearDown1Run = false;
+ var tearDown2Run = false;
+ var tearDown3Run = false;
+ test('test', () {
+ addTearDown(() {
+ expect(tearDown1Run, isFalse);
+ expect(tearDown2Run, isFalse);
+ expect(tearDown3Run, isFalse);
+
+ expect(Future(() {
+ tearDown1Run = true;
+ }), completes);
+ });
+
+ addTearDown(() {
+ expect(tearDown1Run, isFalse);
+ expect(tearDown2Run, isFalse);
+ expect(tearDown3Run, isFalse);
+
+ expect(Future(() {
+ tearDown2Run = true;
+ }), completes);
+ });
+
+ addTearDown(() {
+ expect(tearDown1Run, isFalse);
+ expect(tearDown2Run, isFalse);
+ expect(tearDown3Run, isFalse);
+
+ expect(Future(() {
+ tearDown3Run = true;
+ }), completes);
+ });
+
+ expect(tearDown1Run, isFalse);
+ expect(tearDown2Run, isFalse);
+ expect(tearDown3Run, isFalse);
+ });
+ });
+ });
+
+ test('blocks additional group tearDowns on in-band async', () {
+ return expectTestsPass(() {
+ var groupTearDownRun = false;
+ var testTearDownRun = false;
+ tearDown(() async {
+ expect(groupTearDownRun, isFalse);
+ expect(testTearDownRun, isTrue);
+ await pumpEventQueue();
+ groupTearDownRun = true;
+ });
+
+ test('test', () {
+ addTearDown(() async {
+ expect(groupTearDownRun, isFalse);
+ expect(testTearDownRun, isFalse);
+ await pumpEventQueue();
+ testTearDownRun = true;
+ });
+
+ expect(groupTearDownRun, isFalse);
+ expect(testTearDownRun, isFalse);
+ });
+ });
+ });
+
+ test("doesn't block additional group tearDowns on out-of-band async", () {
+ return expectTestsPass(() {
+ var groupTearDownRun = false;
+ var testTearDownRun = false;
+ tearDown(() {
+ expect(groupTearDownRun, isFalse);
+ expect(testTearDownRun, isFalse);
+
+ expect(Future(() {
+ groupTearDownRun = true;
+ }), completes);
+ });
+
+ test('test', () {
+ addTearDown(() {
+ expect(groupTearDownRun, isFalse);
+ expect(testTearDownRun, isFalse);
+
+ expect(Future(() {
+ testTearDownRun = true;
+ }), completes);
+ });
+
+ expect(groupTearDownRun, isFalse);
+ expect(testTearDownRun, isFalse);
+ });
+ });
+ });
+
+ test('blocks further tests on in-band async', () {
+ return expectTestsPass(() {
+ var tearDownRun = false;
+ test('test 1', () {
+ addTearDown(() async {
+ expect(tearDownRun, isFalse);
+ await pumpEventQueue();
+ tearDownRun = true;
+ });
+ });
+
+ test('test 2', () {
+ expect(tearDownRun, isTrue);
+ });
+ });
+ });
+
+ test('blocks further tests on out-of-band async', () {
+ return expectTestsPass(() {
+ var tearDownRun = false;
+ test('test 1', () {
+ addTearDown(() async {
+ expect(tearDownRun, isFalse);
+ expect(
+ pumpEventQueue().then((_) {
+ tearDownRun = true;
+ }),
+ completes);
+ });
+ });
+
+ test('after', () {
+ expect(tearDownRun, isTrue);
+ });
+ });
+ });
+ });
+
+ group('with an error', () {
+ test('reports the error', () async {
+ var engine = declareEngine(() {
+ test('test', () {
+ addTearDown(() => throw TestFailure('fail'));
+ });
+ });
+
+ var queue = StreamQueue(engine.onTestStarted);
+ var liveTestFuture = queue.next;
+
+ expect(await engine.run(), isFalse);
+
+ var liveTest = await liveTestFuture;
+ expect(liveTest.test.name, equals('test'));
+ expectTestFailed(liveTest, 'fail');
+ });
+
+ test('runs further test tearDowns', () async {
+ // Declare this in the outer test so if it doesn't run, the outer test
+ // will fail.
+ var shouldRun = expectAsync0(() {});
+
+ var engine = declareEngine(() {
+ test('test', () {
+ addTearDown(() => throw 'error');
+ addTearDown(shouldRun);
+ });
+ });
+
+ expect(await engine.run(), isFalse);
+ });
+
+ test('runs further group tearDowns', () async {
+ // Declare this in the outer test so if it doesn't run, the outer test
+ // will fail.
+ var shouldRun = expectAsync0(() {});
+
+ var engine = declareEngine(() {
+ tearDown(shouldRun);
+
+ test('test', () {
+ addTearDown(() => throw 'error');
+ });
+ });
+
+ expect(await engine.run(), isFalse);
+ });
+ });
+ });
+
+ group('in setUpAll()', () {
+ test('runs after all tests', () async {
+ var test1Run = false;
+ var test2Run = false;
+ var tearDownRun = false;
+ await expectTestsPass(() {
+ setUpAll(() {
+ addTearDown(() {
+ expect(test1Run, isTrue);
+ expect(test2Run, isTrue);
+ expect(tearDownRun, isFalse);
+ tearDownRun = true;
+ });
+ });
+
+ test('test 1', () {
+ test1Run = true;
+ expect(tearDownRun, isFalse);
+ });
+
+ test('test 2', () {
+ test2Run = true;
+ expect(tearDownRun, isFalse);
+ });
+ });
+
+ expect(test1Run, isTrue);
+ expect(test2Run, isTrue);
+ expect(tearDownRun, isTrue);
+ });
+
+ test('multiples run in reverse order', () async {
+ var tearDown1Run = false;
+ var tearDown2Run = false;
+ var tearDown3Run = false;
+ await expectTestsPass(() {
+ setUpAll(() {
+ addTearDown(() {
+ expect(tearDown1Run, isFalse);
+ expect(tearDown2Run, isTrue);
+ expect(tearDown3Run, isTrue);
+ tearDown1Run = true;
+ });
+
+ addTearDown(() {
+ expect(tearDown1Run, isFalse);
+ expect(tearDown2Run, isFalse);
+ expect(tearDown3Run, isTrue);
+ tearDown2Run = true;
+ });
+
+ addTearDown(() {
+ expect(tearDown1Run, isFalse);
+ expect(tearDown2Run, isFalse);
+ expect(tearDown3Run, isFalse);
+ tearDown3Run = true;
+ });
+
+ expect(tearDown1Run, isFalse);
+ expect(tearDown2Run, isFalse);
+ expect(tearDown3Run, isFalse);
+ });
+
+ test('test', () {
+ expect(tearDown1Run, isFalse);
+ expect(tearDown2Run, isFalse);
+ expect(tearDown3Run, isFalse);
+ });
+ });
+
+ expect(tearDown1Run, isTrue);
+ expect(tearDown2Run, isTrue);
+ expect(tearDown3Run, isTrue);
+ });
+
+ test('can be called in addTearDown', () async {
+ var tearDown2Run = false;
+ var tearDown3Run = false;
+ await expectTestsPass(() {
+ setUpAll(() {
+ addTearDown(() {
+ expect(tearDown2Run, isTrue);
+ expect(tearDown3Run, isFalse);
+ tearDown3Run = true;
+ });
+
+ addTearDown(() {
+ addTearDown(() {
+ expect(tearDown2Run, isFalse);
+ expect(tearDown3Run, isFalse);
+ tearDown2Run = true;
+ });
+ });
+ });
+
+ test('test', () {
+ expect(tearDown2Run, isFalse);
+ expect(tearDown3Run, isFalse);
+ });
+ });
+
+ expect(tearDown2Run, isTrue);
+ expect(tearDown3Run, isTrue);
+ });
+
+ test('can be called in tearDownAll', () async {
+ var tearDown2Run = false;
+ var tearDown3Run = false;
+ await expectTestsPass(() {
+ tearDownAll(() {
+ expect(tearDown2Run, isTrue);
+ expect(tearDown3Run, isFalse);
+ tearDown3Run = true;
+ });
+
+ tearDownAll(() {
+ tearDown2Run = false;
+ tearDown3Run = false;
+
+ addTearDown(() {
+ expect(tearDown2Run, isFalse);
+ expect(tearDown3Run, isFalse);
+ tearDown2Run = true;
+ });
+ });
+
+ test('test', () {});
+ });
+
+ expect(tearDown2Run, isTrue);
+ expect(tearDown3Run, isTrue);
+ });
+
+ test('runs before a normal tearDownAll', () async {
+ var groupTearDownRun = false;
+ var testTearDownRun = false;
+ await expectTestsPass(() {
+ tearDownAll(() {
+ expect(testTearDownRun, isTrue);
+ expect(groupTearDownRun, isFalse);
+ groupTearDownRun = true;
+ });
+
+ setUpAll(() {
+ addTearDown(() {
+ expect(groupTearDownRun, isFalse);
+ expect(testTearDownRun, isFalse);
+ testTearDownRun = true;
+ });
+ });
+
+ test('test', () {
+ expect(groupTearDownRun, isFalse);
+ expect(testTearDownRun, isFalse);
+ });
+ });
+
+ expect(groupTearDownRun, isTrue);
+ expect(testTearDownRun, isTrue);
+ });
+
+ test('runs in the same error zone as the setUpAll', () async {
+ return expectTestsPass(() {
+ setUpAll(() {
+ final setUpAllZone = Zone.current;
+
+ addTearDown(() {
+ final tearDownZone = Zone.current;
+ expect(tearDownZone.inSameErrorZone(setUpAllZone), isTrue,
+ reason: 'The tear down callback is in a different error zone '
+ 'than the set up all callback.');
+ });
+ });
+
+ test('test', () {});
+ });
+ });
+
+ group('asynchronously', () {
+ test('blocks additional tearDowns on in-band async', () async {
+ var tearDown1Run = false;
+ var tearDown2Run = false;
+ var tearDown3Run = false;
+ await expectTestsPass(() {
+ setUpAll(() {
+ addTearDown(() async {
+ expect(tearDown1Run, isFalse);
+ expect(tearDown2Run, isTrue);
+ expect(tearDown3Run, isTrue);
+ await pumpEventQueue();
+ tearDown1Run = true;
+ });
+
+ addTearDown(() async {
+ expect(tearDown1Run, isFalse);
+ expect(tearDown2Run, isFalse);
+ expect(tearDown3Run, isTrue);
+ await pumpEventQueue();
+ tearDown2Run = true;
+ });
+
+ addTearDown(() async {
+ expect(tearDown1Run, isFalse);
+ expect(tearDown2Run, isFalse);
+ expect(tearDown3Run, isFalse);
+ await pumpEventQueue();
+ tearDown3Run = true;
+ });
+ });
+
+ test('test', () {
+ expect(tearDown1Run, isFalse);
+ expect(tearDown2Run, isFalse);
+ expect(tearDown3Run, isFalse);
+ });
+ });
+
+ expect(tearDown1Run, isTrue);
+ expect(tearDown2Run, isTrue);
+ expect(tearDown3Run, isTrue);
+ });
+
+ test("doesn't block additional tearDowns on out-of-band async", () async {
+ var tearDown1Run = false;
+ var tearDown2Run = false;
+ var tearDown3Run = false;
+ await expectTestsPass(() {
+ setUpAll(() {
+ addTearDown(() {
+ expect(tearDown1Run, isFalse);
+ expect(tearDown2Run, isFalse);
+ expect(tearDown3Run, isFalse);
+
+ expect(Future(() {
+ tearDown1Run = true;
+ }), completes);
+ });
+
+ addTearDown(() {
+ expect(tearDown1Run, isFalse);
+ expect(tearDown2Run, isFalse);
+ expect(tearDown3Run, isFalse);
+
+ expect(Future(() {
+ tearDown2Run = true;
+ }), completes);
+ });
+
+ addTearDown(() {
+ expect(tearDown1Run, isFalse);
+ expect(tearDown2Run, isFalse);
+ expect(tearDown3Run, isFalse);
+
+ expect(Future(() {
+ tearDown3Run = true;
+ }), completes);
+ });
+ });
+
+ test('test', () {
+ expect(tearDown1Run, isFalse);
+ expect(tearDown2Run, isFalse);
+ expect(tearDown3Run, isFalse);
+ });
+ });
+
+ expect(tearDown1Run, isTrue);
+ expect(tearDown2Run, isTrue);
+ expect(tearDown3Run, isTrue);
+ });
+
+ test('blocks additional tearDownAlls on in-band async', () async {
+ var groupTearDownRun = false;
+ var testTearDownRun = false;
+ await expectTestsPass(() {
+ tearDownAll(() async {
+ expect(groupTearDownRun, isFalse);
+ expect(testTearDownRun, isTrue);
+ await pumpEventQueue();
+ groupTearDownRun = true;
+ });
+
+ setUpAll(() {
+ addTearDown(() async {
+ expect(groupTearDownRun, isFalse);
+ expect(testTearDownRun, isFalse);
+ await pumpEventQueue();
+ testTearDownRun = true;
+ });
+ });
+
+ test('test', () {
+ expect(groupTearDownRun, isFalse);
+ expect(testTearDownRun, isFalse);
+ });
+ });
+
+ expect(groupTearDownRun, isTrue);
+ expect(testTearDownRun, isTrue);
+ });
+
+ test("doesn't block additional tearDownAlls on out-of-band async",
+ () async {
+ var groupTearDownRun = false;
+ var testTearDownRun = false;
+ await expectTestsPass(() {
+ tearDownAll(() {
+ expect(groupTearDownRun, isFalse);
+ expect(testTearDownRun, isFalse);
+
+ expect(Future(() {
+ groupTearDownRun = true;
+ }), completes);
+ });
+
+ setUpAll(() {
+ addTearDown(() {
+ expect(groupTearDownRun, isFalse);
+ expect(testTearDownRun, isFalse);
+
+ expect(Future(() {
+ testTearDownRun = true;
+ }), completes);
+ });
+ });
+
+ test('test', () {
+ expect(groupTearDownRun, isFalse);
+ expect(testTearDownRun, isFalse);
+ });
+ });
+
+ expect(groupTearDownRun, isTrue);
+ expect(testTearDownRun, isTrue);
+ });
+ });
+
+ group('with an error', () {
+ test('reports the error', () async {
+ var engine = declareEngine(() {
+ setUpAll(() {
+ addTearDown(() => throw TestFailure('fail'));
+ });
+
+ test('test', () {});
+ });
+
+ var queue = StreamQueue(engine.onTestStarted);
+ unawaited(queue.skip(2));
+ var liveTestFuture = queue.next;
+
+ expect(await engine.run(), isFalse);
+
+ var liveTest = await liveTestFuture;
+ expect(liveTest.test.name, equals('(tearDownAll)'));
+ expectTestFailed(liveTest, 'fail');
+ });
+
+ test('runs further tearDowns', () async {
+ // Declare this in the outer test so if it doesn't run, the outer test
+ // will fail.
+ var shouldRun = expectAsync0(() {});
+
+ var engine = declareEngine(() {
+ setUpAll(() {
+ addTearDown(() => throw 'error');
+ addTearDown(shouldRun);
+ });
+
+ test('test', () {});
+ });
+
+ expect(await engine.run(), isFalse);
+ });
+
+ test('runs further tearDownAlls', () async {
+ // Declare this in the outer test so if it doesn't run, the outer test
+ // will fail.
+ var shouldRun = expectAsync0(() {});
+
+ var engine = declareEngine(() {
+ tearDownAll(shouldRun);
+
+ setUpAll(() {
+ addTearDown(() => throw 'error');
+ });
+
+ test('test', () {});
+ });
+
+ expect(await engine.run(), isFalse);
+ });
+ });
+ });
+}
diff --git a/pkgs/test_api/test/frontend/fake_test.dart b/pkgs/test_api/test/frontend/fake_test.dart
new file mode 100644
index 0000000..7dfb306
--- /dev/null
+++ b/pkgs/test_api/test/frontend/fake_test.dart
@@ -0,0 +1,37 @@
+// Copyright (c) 2020, 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 'package:test/test.dart';
+import 'package:test_api/fake.dart' as test_api;
+
+void main() {
+ late _FakeSample fake;
+ setUp(() {
+ fake = _FakeSample();
+ });
+ test('method invocation', () {
+ expect(() => fake.f(), throwsA(const TypeMatcher<UnimplementedError>()));
+ });
+ test('getter', () {
+ expect(() => fake.x, throwsA(const TypeMatcher<UnimplementedError>()));
+ });
+ test('setter', () {
+ expect(() => fake.x = 0, throwsA(const TypeMatcher<UnimplementedError>()));
+ });
+ test('operator', () {
+ expect(() => fake + 1, throwsA(const TypeMatcher<UnimplementedError>()));
+ });
+}
+
+class _Sample {
+ void f() {}
+
+ int get x => 0;
+
+ set x(int value) {}
+
+ int operator +(int other) => 0;
+}
+
+class _FakeSample extends test_api.Fake implements _Sample {}
diff --git a/pkgs/test_api/test/frontend/set_up_all_test.dart b/pkgs/test_api/test/frontend/set_up_all_test.dart
new file mode 100644
index 0000000..60d4dc8
--- /dev/null
+++ b/pkgs/test_api/test/frontend/set_up_all_test.dart
@@ -0,0 +1,328 @@
+// Copyright (c) 2015, 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 'package:async/async.dart';
+import 'package:test/test.dart';
+
+import '../utils.dart';
+
+void main() {
+ test('runs once before all tests', () {
+ return expectTestsPass(() {
+ var setUpAllRun = false;
+ setUpAll(() {
+ expect(setUpAllRun, isFalse);
+ setUpAllRun = true;
+ });
+
+ test('test 1', () {
+ expect(setUpAllRun, isTrue);
+ });
+
+ test('test 2', () {
+ expect(setUpAllRun, isTrue);
+ });
+ });
+ });
+
+ test('runs once per group, outside-in', () {
+ return expectTestsPass(() {
+ var setUpAll1Run = false;
+ var setUpAll2Run = false;
+ var setUpAll3Run = false;
+ setUpAll(() {
+ expect(setUpAll1Run, isFalse);
+ expect(setUpAll2Run, isFalse);
+ expect(setUpAll3Run, isFalse);
+ setUpAll1Run = true;
+ });
+
+ group('mid', () {
+ setUpAll(() {
+ expect(setUpAll1Run, isTrue);
+ expect(setUpAll2Run, isFalse);
+ expect(setUpAll3Run, isFalse);
+ setUpAll2Run = true;
+ });
+
+ group('inner', () {
+ setUpAll(() {
+ expect(setUpAll1Run, isTrue);
+ expect(setUpAll2Run, isTrue);
+ expect(setUpAll3Run, isFalse);
+ setUpAll3Run = true;
+ });
+
+ test('test', () {
+ expect(setUpAll1Run, isTrue);
+ expect(setUpAll2Run, isTrue);
+ expect(setUpAll3Run, isTrue);
+ });
+ });
+ });
+ });
+ });
+
+ test('runs before setUps', () {
+ return expectTestsPass(() {
+ var setUpAllRun = false;
+ setUp(() {
+ expect(setUpAllRun, isTrue);
+ });
+
+ setUpAll(() {
+ expect(setUpAllRun, isFalse);
+ setUpAllRun = true;
+ });
+
+ setUp(() {
+ expect(setUpAllRun, isTrue);
+ });
+
+ test('test', () {
+ expect(setUpAllRun, isTrue);
+ });
+ });
+ });
+
+ test('multiples run in order', () {
+ return expectTestsPass(() {
+ var setUpAll1Run = false;
+ var setUpAll2Run = false;
+ var setUpAll3Run = false;
+ setUpAll(() {
+ expect(setUpAll1Run, isFalse);
+ expect(setUpAll2Run, isFalse);
+ expect(setUpAll3Run, isFalse);
+ setUpAll1Run = true;
+ });
+
+ setUpAll(() {
+ expect(setUpAll1Run, isTrue);
+ expect(setUpAll2Run, isFalse);
+ expect(setUpAll3Run, isFalse);
+ setUpAll2Run = true;
+ });
+
+ setUpAll(() {
+ expect(setUpAll1Run, isTrue);
+ expect(setUpAll2Run, isTrue);
+ expect(setUpAll3Run, isFalse);
+ setUpAll3Run = true;
+ });
+
+ test('test', () {
+ expect(setUpAll1Run, isTrue);
+ expect(setUpAll2Run, isTrue);
+ expect(setUpAll3Run, isTrue);
+ });
+ });
+ });
+
+ group('asynchronously', () {
+ test('blocks additional setUpAlls on in-band async', () {
+ return expectTestsPass(() {
+ var setUpAll1Run = false;
+ var setUpAll2Run = false;
+ var setUpAll3Run = false;
+ setUpAll(() async {
+ expect(setUpAll1Run, isFalse);
+ expect(setUpAll2Run, isFalse);
+ expect(setUpAll3Run, isFalse);
+ await pumpEventQueue();
+ setUpAll1Run = true;
+ });
+
+ setUpAll(() async {
+ expect(setUpAll1Run, isTrue);
+ expect(setUpAll2Run, isFalse);
+ expect(setUpAll3Run, isFalse);
+ await pumpEventQueue();
+ setUpAll2Run = true;
+ });
+
+ setUpAll(() async {
+ expect(setUpAll1Run, isTrue);
+ expect(setUpAll2Run, isTrue);
+ expect(setUpAll3Run, isFalse);
+ await pumpEventQueue();
+ setUpAll3Run = true;
+ });
+
+ test('test', () {
+ expect(setUpAll1Run, isTrue);
+ expect(setUpAll2Run, isTrue);
+ expect(setUpAll3Run, isTrue);
+ });
+ });
+ });
+
+ test("doesn't block additional setUpAlls on out-of-band async", () {
+ return expectTestsPass(() {
+ var setUpAll1Run = false;
+ var setUpAll2Run = false;
+ var setUpAll3Run = false;
+ setUpAll(() {
+ expect(setUpAll1Run, isFalse);
+ expect(setUpAll2Run, isFalse);
+ expect(setUpAll3Run, isFalse);
+
+ expect(
+ pumpEventQueue().then((_) {
+ setUpAll1Run = true;
+ }),
+ completes);
+ });
+
+ setUpAll(() {
+ expect(setUpAll1Run, isFalse);
+ expect(setUpAll2Run, isFalse);
+ expect(setUpAll3Run, isFalse);
+
+ expect(
+ pumpEventQueue().then((_) {
+ setUpAll2Run = true;
+ }),
+ completes);
+ });
+
+ setUpAll(() {
+ expect(setUpAll1Run, isFalse);
+ expect(setUpAll2Run, isFalse);
+ expect(setUpAll3Run, isFalse);
+
+ expect(
+ pumpEventQueue().then((_) {
+ setUpAll3Run = true;
+ }),
+ completes);
+ });
+
+ test('test', () {
+ expect(setUpAll1Run, isTrue);
+ expect(setUpAll2Run, isTrue);
+ expect(setUpAll3Run, isTrue);
+ });
+ });
+ });
+ });
+
+ test("isn't run for a skipped group", () async {
+ // Declare this in the outer test so if it runs, the outer test will fail.
+ var shouldNotRun = expectAsync0(() {}, count: 0);
+
+ var engine = declareEngine(() {
+ group('skipped', () {
+ setUpAll(shouldNotRun);
+
+ test('test', () {});
+ }, skip: true);
+ });
+
+ await engine.run();
+ expect(engine.liveTests, hasLength(1));
+ expect(engine.skipped, hasLength(1));
+ expect(engine.liveTests, equals(engine.skipped));
+ });
+
+ test('is emitted through Engine.onTestStarted', () async {
+ var engine = declareEngine(() {
+ setUpAll(() {});
+
+ test('test', () {});
+ });
+
+ var queue = StreamQueue(engine.onTestStarted);
+ var setUpAllFuture = queue.next;
+ var liveTestFuture = queue.next;
+
+ await engine.run();
+
+ var setUpAllLiveTest = await setUpAllFuture;
+ expect(setUpAllLiveTest.test.name, equals('(setUpAll)'));
+ expectTestPassed(setUpAllLiveTest);
+
+ // The fake test for setUpAll should be removed from the engine's live
+ // test list so that reporters don't display it as a passed test.
+ expect(engine.liveTests, isNot(contains(setUpAllLiveTest)));
+ expect(engine.passed, isNot(contains(setUpAllLiveTest)));
+ expect(engine.failed, isNot(contains(setUpAllLiveTest)));
+ expect(engine.skipped, isNot(contains(setUpAllLiveTest)));
+ expect(engine.active, isNot(contains(setUpAllLiveTest)));
+
+ var liveTest = await liveTestFuture;
+ expectTestPassed(await liveTestFuture);
+ expect(engine.liveTests, contains(liveTest));
+ expect(engine.passed, contains(liveTest));
+ });
+
+ group('with an error', () {
+ test('reports the error and remains in Engine.liveTests', () async {
+ var engine = declareEngine(() {
+ setUpAll(() => throw TestFailure('fail'));
+
+ test('test', () {});
+ });
+
+ var queue = StreamQueue(engine.onTestStarted);
+ var setUpAllFuture = queue.next;
+
+ expect(await engine.run(), isFalse);
+
+ var setUpAllLiveTest = await setUpAllFuture;
+ expect(setUpAllLiveTest.test.name, equals('(setUpAll)'));
+ expectTestFailed(setUpAllLiveTest, 'fail');
+
+ // The fake test for setUpAll should be removed from the engine's live
+ // test list so that reporters don't display it as a passed test.
+ expect(engine.liveTests, contains(setUpAllLiveTest));
+ expect(engine.failed, contains(setUpAllLiveTest));
+ expect(engine.passed, isNot(contains(setUpAllLiveTest)));
+ expect(engine.skipped, isNot(contains(setUpAllLiveTest)));
+ expect(engine.active, isNot(contains(setUpAllLiveTest)));
+ });
+
+ test("doesn't run tests in the group", () async {
+ // Declare this in the outer test so if it runs, the outer test will fail.
+ var shouldNotRun = expectAsync0(() {}, count: 0);
+
+ var engine = declareEngine(() {
+ setUpAll(() => throw 'error');
+
+ test('test', shouldNotRun);
+ });
+
+ expect(await engine.run(), isFalse);
+ });
+
+ test("doesn't run inner groups", () async {
+ // Declare this in the outer test so if it runs, the outer test will fail.
+ var shouldNotRun = expectAsync0(() {}, count: 0);
+
+ var engine = declareEngine(() {
+ setUpAll(() => throw 'error');
+
+ group('group', () {
+ test('test', shouldNotRun);
+ });
+ });
+
+ expect(await engine.run(), isFalse);
+ });
+
+ test("doesn't run further setUpAlls", () async {
+ // Declare this in the outer test so if it runs, the outer test will fail.
+ var shouldNotRun = expectAsync0(() {}, count: 0);
+
+ var engine = declareEngine(() {
+ setUpAll(() => throw 'error');
+ setUpAll(shouldNotRun);
+
+ test('test', shouldNotRun);
+ });
+
+ expect(await engine.run(), isFalse);
+ });
+ });
+}
diff --git a/pkgs/test_api/test/frontend/tear_down_all_test.dart b/pkgs/test_api/test/frontend/tear_down_all_test.dart
new file mode 100644
index 0000000..d6d209f
--- /dev/null
+++ b/pkgs/test_api/test/frontend/tear_down_all_test.dart
@@ -0,0 +1,372 @@
+// Copyright (c) 2015, 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 'package:async/async.dart';
+import 'package:test/test.dart';
+
+import '../utils.dart';
+
+void main() {
+ test('runs once after all tests', () {
+ return expectTestsPass(() {
+ var test1Run = false;
+ var test2Run = false;
+ var tearDownAllRun = false;
+ tearDownAll(() {
+ expect(test1Run, isTrue);
+ expect(test2Run, isTrue);
+ expect(tearDownAllRun, isFalse);
+ tearDownAllRun = true;
+ });
+
+ test('test 1', () {
+ expect(tearDownAllRun, isFalse);
+ test1Run = true;
+ });
+
+ test('test 2', () {
+ expect(tearDownAllRun, isFalse);
+ test2Run = true;
+ });
+ });
+ });
+
+ test('runs once per group, inside-out', () {
+ return expectTestsPass(() {
+ var tearDownAll1Run = false;
+ var tearDownAll2Run = false;
+ var tearDownAll3Run = false;
+ var testRun = false;
+ tearDownAll(() {
+ expect(tearDownAll1Run, isFalse);
+ expect(tearDownAll2Run, isTrue);
+ expect(tearDownAll3Run, isTrue);
+ expect(testRun, isTrue);
+ tearDownAll1Run = true;
+ });
+
+ group('mid', () {
+ tearDownAll(() {
+ expect(tearDownAll1Run, isFalse);
+ expect(tearDownAll2Run, isFalse);
+ expect(tearDownAll3Run, isTrue);
+ expect(testRun, isTrue);
+ tearDownAll2Run = true;
+ });
+
+ group('inner', () {
+ tearDownAll(() {
+ expect(tearDownAll1Run, isFalse);
+ expect(tearDownAll2Run, isFalse);
+ expect(tearDownAll3Run, isFalse);
+ expect(testRun, isTrue);
+ tearDownAll3Run = true;
+ });
+
+ test('test', () {
+ expect(tearDownAll1Run, isFalse);
+ expect(tearDownAll2Run, isFalse);
+ expect(tearDownAll3Run, isFalse);
+ testRun = true;
+ });
+ });
+ });
+ });
+ });
+
+ test('runs after tearDowns', () {
+ return expectTestsPass(() {
+ var tearDown1Run = false;
+ var tearDown2Run = false;
+ var tearDownAllRun = false;
+ tearDown(() {
+ expect(tearDownAllRun, isFalse);
+ tearDown1Run = true;
+ });
+
+ tearDownAll(() {
+ expect(tearDown1Run, isTrue);
+ expect(tearDown2Run, isTrue);
+ expect(tearDownAllRun, isFalse);
+ tearDownAllRun = true;
+ });
+
+ tearDown(() {
+ expect(tearDownAllRun, isFalse);
+ tearDown2Run = true;
+ });
+
+ test('test', () {
+ expect(tearDownAllRun, isFalse);
+ });
+ });
+ });
+
+ test('multiples run in reverse order', () {
+ return expectTestsPass(() {
+ var tearDownAll1Run = false;
+ var tearDownAll2Run = false;
+ var tearDownAll3Run = false;
+ tearDownAll(() {
+ expect(tearDownAll1Run, isFalse);
+ expect(tearDownAll2Run, isTrue);
+ expect(tearDownAll3Run, isTrue);
+ tearDownAll1Run = true;
+ });
+
+ tearDownAll(() {
+ expect(tearDownAll1Run, isFalse);
+ expect(tearDownAll2Run, isFalse);
+ expect(tearDownAll3Run, isTrue);
+ tearDownAll2Run = true;
+ });
+
+ tearDownAll(() {
+ expect(tearDownAll1Run, isFalse);
+ expect(tearDownAll2Run, isFalse);
+ expect(tearDownAll3Run, isFalse);
+ tearDownAll3Run = true;
+ });
+
+ test('test', () {
+ expect(tearDownAll1Run, isFalse);
+ expect(tearDownAll2Run, isFalse);
+ expect(tearDownAll3Run, isFalse);
+ });
+ });
+ });
+
+ group('asynchronously', () {
+ test('blocks additional tearDownAlls on in-band async', () {
+ return expectTestsPass(() {
+ var tearDownAll1Run = false;
+ var tearDownAll2Run = false;
+ var tearDownAll3Run = false;
+ tearDownAll(() async {
+ expect(tearDownAll1Run, isFalse);
+ expect(tearDownAll2Run, isTrue);
+ expect(tearDownAll3Run, isTrue);
+ await pumpEventQueue();
+ tearDownAll1Run = true;
+ });
+
+ tearDownAll(() async {
+ expect(tearDownAll1Run, isFalse);
+ expect(tearDownAll2Run, isFalse);
+ expect(tearDownAll3Run, isTrue);
+ await pumpEventQueue();
+ tearDownAll2Run = true;
+ });
+
+ tearDownAll(() async {
+ expect(tearDownAll1Run, isFalse);
+ expect(tearDownAll2Run, isFalse);
+ expect(tearDownAll3Run, isFalse);
+ await pumpEventQueue();
+ tearDownAll3Run = true;
+ });
+
+ test('test', () {
+ expect(tearDownAll1Run, isFalse);
+ expect(tearDownAll2Run, isFalse);
+ expect(tearDownAll3Run, isFalse);
+ });
+ });
+ });
+
+ test("doesn't block additional tearDownAlls on out-of-band async", () {
+ return expectTestsPass(() {
+ var tearDownAll1Run = false;
+ var tearDownAll2Run = false;
+ var tearDownAll3Run = false;
+ tearDownAll(() {
+ expect(tearDownAll1Run, isFalse);
+ expect(tearDownAll2Run, isFalse);
+ expect(tearDownAll3Run, isFalse);
+
+ expect(Future(() {
+ tearDownAll1Run = true;
+ }), completes);
+ });
+
+ tearDownAll(() {
+ expect(tearDownAll1Run, isFalse);
+ expect(tearDownAll2Run, isFalse);
+ expect(tearDownAll3Run, isFalse);
+
+ expect(Future(() {
+ tearDownAll2Run = true;
+ }), completes);
+ });
+
+ tearDownAll(() {
+ expect(tearDownAll1Run, isFalse);
+ expect(tearDownAll2Run, isFalse);
+ expect(tearDownAll3Run, isFalse);
+
+ expect(Future(() {
+ tearDownAll3Run = true;
+ }), completes);
+ });
+
+ test('test', () {
+ expect(tearDownAll1Run, isFalse);
+ expect(tearDownAll2Run, isFalse);
+ expect(tearDownAll3Run, isFalse);
+ });
+ });
+ });
+
+ test('blocks further tests on in-band async', () {
+ return expectTestsPass(() {
+ var tearDownAllRun = false;
+ group('group', () {
+ tearDownAll(() async {
+ expect(tearDownAllRun, isFalse);
+ await pumpEventQueue();
+ tearDownAllRun = true;
+ });
+
+ test('test', () {});
+ });
+
+ test('after', () {
+ expect(tearDownAllRun, isTrue);
+ });
+ });
+ });
+
+ test('blocks further tests on out-of-band async', () {
+ return expectTestsPass(() {
+ var tearDownAllRun = false;
+ group('group', () {
+ tearDownAll(() async {
+ expect(tearDownAllRun, isFalse);
+ expect(
+ pumpEventQueue().then((_) {
+ tearDownAllRun = true;
+ }),
+ completes);
+ });
+
+ test('test', () {});
+ });
+
+ test('after', () {
+ expect(tearDownAllRun, isTrue);
+ });
+ });
+ });
+ });
+
+ test("isn't run for a skipped group", () async {
+ // Declare this in the outer test so if it runs, the outer test will fail.
+ var shouldNotRun = expectAsync0(() {}, count: 0);
+
+ var engine = declareEngine(() {
+ group('skipped', () {
+ tearDownAll(shouldNotRun);
+
+ test('test', () {});
+ }, skip: true);
+ });
+
+ await engine.run();
+ expect(engine.liveTests, hasLength(1));
+ expect(engine.skipped, hasLength(1));
+ expect(engine.liveTests, equals(engine.skipped));
+ });
+
+ test('is emitted through Engine.onTestStarted', () async {
+ var engine = declareEngine(() {
+ tearDownAll(() {});
+
+ test('test', () {});
+ });
+
+ var queue = StreamQueue(engine.onTestStarted);
+ var liveTestFuture = queue.next;
+ var tearDownAllFuture = queue.next;
+
+ await engine.run();
+
+ var tearDownAllLiveTest = await tearDownAllFuture;
+ expect(tearDownAllLiveTest.test.name, equals('(tearDownAll)'));
+ expectTestPassed(tearDownAllLiveTest);
+
+ // The fake test for tearDownAll should be removed from the engine's live
+ // test list so that reporters don't display it as a passed test.
+ expect(engine.liveTests, isNot(contains(tearDownAllLiveTest)));
+ expect(engine.passed, isNot(contains(tearDownAllLiveTest)));
+ expect(engine.failed, isNot(contains(tearDownAllLiveTest)));
+ expect(engine.skipped, isNot(contains(tearDownAllLiveTest)));
+ expect(engine.active, isNot(contains(tearDownAllLiveTest)));
+
+ var liveTest = await liveTestFuture;
+ expectTestPassed(await liveTestFuture);
+ expect(engine.liveTests, contains(liveTest));
+ expect(engine.passed, contains(liveTest));
+ });
+
+ group('with an error', () {
+ test('reports the error and remains in Engine.liveTests', () async {
+ var engine = declareEngine(() {
+ tearDownAll(() => throw TestFailure('fail'));
+
+ test('test', () {});
+ });
+
+ var queue = StreamQueue(engine.onTestStarted);
+ expect(queue.next, completes);
+ var tearDownAllFuture = queue.next;
+
+ expect(await engine.run(), isFalse);
+
+ var tearDownAllLiveTest = await tearDownAllFuture;
+ expect(tearDownAllLiveTest.test.name, equals('(tearDownAll)'));
+ expectTestFailed(tearDownAllLiveTest, 'fail');
+
+ // The fake test for tearDownAll should be removed from the engine's live
+ // test list so that reporters don't display it as a passed test.
+ expect(engine.liveTests, contains(tearDownAllLiveTest));
+ expect(engine.failed, contains(tearDownAllLiveTest));
+ expect(engine.passed, isNot(contains(tearDownAllLiveTest)));
+ expect(engine.skipped, isNot(contains(tearDownAllLiveTest)));
+ expect(engine.active, isNot(contains(tearDownAllLiveTest)));
+ });
+
+ test('runs further tearDownAlls', () async {
+ // Declare this in the outer test so if it doesn't runs, the outer test
+ // will fail.
+ var shouldRun = expectAsync0(() {});
+
+ var engine = declareEngine(() {
+ tearDownAll(() => throw 'error');
+ tearDownAll(shouldRun);
+
+ test('test', () {});
+ });
+
+ expect(await engine.run(), isFalse);
+ });
+
+ test('runs outer tearDownAlls', () async {
+ // Declare this in the outer test so if it doesn't runs, the outer test
+ // will fail.
+ var shouldRun = expectAsync0(() {});
+
+ var engine = declareEngine(() {
+ tearDownAll(shouldRun);
+
+ group('group', () {
+ tearDownAll(() => throw 'error');
+
+ test('test', () {});
+ });
+ });
+
+ expect(await engine.run(), isFalse);
+ });
+ });
+}
diff --git a/pkgs/test_api/test/frontend/timeout_test.dart b/pkgs/test_api/test/frontend/timeout_test.dart
new file mode 100644
index 0000000..fdfd611
--- /dev/null
+++ b/pkgs/test_api/test/frontend/timeout_test.dart
@@ -0,0 +1,81 @@
+// Copyright (c) 2016, 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 'package:test/test.dart';
+
+void main() {
+ group('Timeout.parse', () {
+ group('for "none"', () {
+ test('successfully parses', () {
+ expect(Timeout.parse('none'), equals(Timeout.none));
+ });
+
+ test('rejects invalid input', () {
+ expect(() => Timeout.parse(' none'), throwsFormatException);
+ expect(() => Timeout.parse('none '), throwsFormatException);
+ expect(() => Timeout.parse('xnone'), throwsFormatException);
+ expect(() => Timeout.parse('nonex'), throwsFormatException);
+ expect(() => Timeout.parse('noxe'), throwsFormatException);
+ });
+ });
+
+ group('for a relative timeout', () {
+ test('successfully parses', () {
+ expect(Timeout.parse('1x'), equals(const Timeout.factor(1)));
+ expect(Timeout.parse('2.5x'), equals(const Timeout.factor(2.5)));
+ expect(Timeout.parse('1.2e3x'), equals(const Timeout.factor(1.2e3)));
+ });
+
+ test('rejects invalid input', () {
+ expect(() => Timeout.parse('.x'), throwsFormatException);
+ expect(() => Timeout.parse('x'), throwsFormatException);
+ expect(() => Timeout.parse('ax'), throwsFormatException);
+ expect(() => Timeout.parse('1x '), throwsFormatException);
+ expect(() => Timeout.parse('1x5m'), throwsFormatException);
+ });
+ });
+
+ group('for an absolute timeout', () {
+ test('successfully parses all supported units', () {
+ expect(Timeout.parse('2d'), equals(const Timeout(Duration(days: 2))));
+ expect(Timeout.parse('2h'), equals(const Timeout(Duration(hours: 2))));
+ expect(
+ Timeout.parse('2m'), equals(const Timeout(Duration(minutes: 2))));
+ expect(
+ Timeout.parse('2s'), equals(const Timeout(Duration(seconds: 2))));
+ expect(Timeout.parse('2ms'),
+ equals(const Timeout(Duration(milliseconds: 2))));
+ expect(Timeout.parse('2us'),
+ equals(const Timeout(Duration(microseconds: 2))));
+ });
+
+ test('supports non-integer units', () {
+ expect(Timeout.parse('2.73d'),
+ equals(Timeout(const Duration(days: 1) * 2.73)));
+ });
+
+ test('supports multiple units', () {
+ expect(
+ Timeout.parse('1d 2h3m 4s5ms\t6us'),
+ equals(const Timeout(Duration(
+ days: 1,
+ hours: 2,
+ minutes: 3,
+ seconds: 4,
+ milliseconds: 5,
+ microseconds: 6))));
+ });
+
+ test('rejects invalid input', () {
+ expect(() => Timeout.parse('.d'), throwsFormatException);
+ expect(() => Timeout.parse('d'), throwsFormatException);
+ expect(() => Timeout.parse('ad'), throwsFormatException);
+ expect(() => Timeout.parse('1z'), throwsFormatException);
+ expect(() => Timeout.parse('1u'), throwsFormatException);
+ expect(() => Timeout.parse('1d5x'), throwsFormatException);
+ expect(() => Timeout.parse('1d*5m'), throwsFormatException);
+ });
+ });
+ });
+}
diff --git a/pkgs/test_api/test/import_restrictions_test.dart b/pkgs/test_api/test/import_restrictions_test.dart
new file mode 100644
index 0000000..3fd9ffd
--- /dev/null
+++ b/pkgs/test_api/test/import_restrictions_test.dart
@@ -0,0 +1,126 @@
+// Copyright (c) 2021, 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 'dart:io';
+import 'dart:isolate';
+
+import 'package:analyzer/dart/analysis/analysis_context.dart';
+import 'package:analyzer/dart/analysis/analysis_context_collection.dart';
+import 'package:analyzer/dart/analysis/results.dart';
+import 'package:analyzer/dart/ast/ast.dart';
+import 'package:glob/glob.dart';
+import 'package:glob/list_local_fs.dart';
+import 'package:graphs/graphs.dart';
+import 'package:path/path.dart' as p;
+import 'package:test/test.dart';
+
+void main() {
+ late _ImportCheck importCheck;
+ setUpAll(() async {
+ importCheck = await _ImportCheck.create();
+ });
+ group('backend', () {
+ test('must not import from other subdirectories', () async {
+ final entryPoints = [
+ _testApiLibrary('backend.dart'),
+ ...await _ImportCheck.findEntrypointsUnder(
+ _testApiLibrary('src/backend'))
+ ];
+ await for (final source
+ in importCheck.transitiveSamePackageSources(entryPoints)) {
+ for (final import in source.imports) {
+ expect(import.pathSegments.skip(1).take(2), ['src', 'backend'],
+ reason: 'Invalid import from ${source.uri} : $import');
+ }
+ }
+ });
+ });
+}
+
+Uri _testApiLibrary(String path) => Uri.parse('package:test_api/$path');
+
+class _ImportCheck {
+ final AnalysisContext _context;
+
+ static Future<Iterable<Uri>> findEntrypointsUnder(Uri uri) async {
+ if (!uri.path.endsWith('/')) {
+ uri = uri.replace(path: '${uri.path}/');
+ }
+ final directory = p.fromUri(await Isolate.resolvePackageUri(uri));
+ return Glob('./**')
+ .listSync(root: directory)
+ .whereType<File>()
+ .map((f) => uri.resolve(p.url.relative(f.path, from: directory)));
+ }
+
+ static Future<_ImportCheck> create() async {
+ final context = await _createAnalysisContext();
+ return _ImportCheck._(context);
+ }
+
+ static Future<AnalysisContext> _createAnalysisContext() async {
+ final libUri = Uri.parse('package:graphs/');
+ final libPath = await _pathForUri(libUri);
+ final packagePath = p.dirname(libPath);
+
+ final contexts =
+ AnalysisContextCollection(includedPaths: [packagePath]).contexts;
+ if (contexts.length != 1) {
+ throw StateError('Expected to find exactly one context, got $contexts');
+ }
+ return contexts.first;
+ }
+
+ static Future<String> _pathForUri(Uri uri) async {
+ final fileUri = await Isolate.resolvePackageUri(uri);
+ if (fileUri == null || !fileUri.isScheme('file')) {
+ throw StateError('Expected to resolve $uri to a file URI, got $fileUri');
+ }
+ return p.fromUri(fileUri);
+ }
+
+ _ImportCheck._(this._context);
+
+ Stream<_Source> transitiveSamePackageSources(Iterable<Uri> entryPoints) {
+ assert(entryPoints.every((e) => e.scheme == 'package'));
+ final package = entryPoints.first.pathSegments.first;
+ assert(entryPoints.skip(1).every((e) => e.pathSegments.first == package));
+ return crawlAsync<Uri, _Source>(
+ entryPoints,
+ (uri) async => _Source(uri, await _findImports(uri, package)),
+ (_, source) => source.imports);
+ }
+
+ Future<Set<Uri>> _findImports(Uri uri, String restrictToPackage) async {
+ var path = await _pathForUri(uri);
+ var analysisSession = _context.currentSession;
+ var parseResult = analysisSession.getParsedUnit(path) as ParsedUnitResult;
+ assert(parseResult.content.isNotEmpty,
+ 'Tried to read an invalid library $uri');
+ return parseResult.unit.directives
+ .whereType<UriBasedDirective>()
+ .map((d) => d.uri.stringValue!)
+ .where((uri) => !uri.startsWith('dart:'))
+ .map((import) => _resolveImport(import, uri))
+ .where((import) => import.pathSegments.first == restrictToPackage)
+ .toSet();
+ }
+
+ static Uri _resolveImport(String import, Uri from) {
+ if (import.startsWith('package:')) return Uri.parse(import);
+ assert(from.scheme == 'package');
+ final package = from.pathSegments.first;
+ final fromPath = p.joinAll(from.pathSegments.skip(1));
+ final path = p.normalize(p.join(p.dirname(fromPath), import));
+ return Uri.parse('package:${p.join(package, path)}');
+ }
+}
+
+class _Source {
+ final Uri uri;
+ final Set<Uri> imports;
+
+ _Source(this.uri, this.imports);
+}
diff --git a/pkgs/test_api/test/utils.dart b/pkgs/test_api/test/utils.dart
new file mode 100644
index 0000000..97058e3
--- /dev/null
+++ b/pkgs/test_api/test/utils.dart
@@ -0,0 +1,146 @@
+// Copyright (c) 2015, 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:collection';
+
+import 'package:test/test.dart';
+import 'package:test_api/src/backend/declarer.dart';
+import 'package:test_api/src/backend/group_entry.dart';
+import 'package:test_api/src/backend/live_test.dart';
+import 'package:test_api/src/backend/runtime.dart';
+import 'package:test_api/src/backend/state.dart';
+import 'package:test_api/src/backend/suite_platform.dart';
+import 'package:test_core/src/runner/engine.dart';
+import 'package:test_core/src/runner/plugin/environment.dart';
+import 'package:test_core/src/runner/runner_suite.dart';
+import 'package:test_core/src/runner/suite.dart';
+
+/// A dummy suite platform to use for testing suites.
+final suitePlatform =
+ SuitePlatform(Runtime.vm, compiler: Runtime.vm.defaultCompiler);
+
+// The last state change detected via [expectStates].
+State? lastState;
+
+/// Asserts that exactly [states] will be emitted via [liveTest.onStateChange].
+///
+/// The most recent emitted state is stored in [_lastState].
+void expectStates(LiveTest liveTest, Iterable<State> statesIter) {
+ var states = Queue.of(statesIter);
+ liveTest.onStateChange.listen(expectAsync1((state) {
+ lastState = state;
+ expect(state, equals(states.removeFirst()));
+ }, count: states.length, max: states.length));
+}
+
+/// Asserts that errors will be emitted via [liveTest.onError] that match
+/// [validators], in order.
+void expectErrors(
+ LiveTest liveTest, Iterable<void Function(Object)> validatorsIter) {
+ var validators = Queue.of(validatorsIter);
+ liveTest.onError.listen(expectAsync1((error) {
+ validators.removeFirst()(error.error);
+ }, count: validators.length, max: validators.length));
+}
+
+/// Asserts that [liveTest] will have a single failure with message `"oh no"`.
+void expectSingleFailure(LiveTest liveTest) {
+ expectStates(liveTest, [
+ const State(Status.running, Result.success),
+ const State(Status.complete, Result.failure)
+ ]);
+
+ expectErrors(liveTest, [
+ (error) {
+ expect(lastState?.status, equals(Status.complete));
+ expect(error, isTestFailure('oh no'));
+ }
+ ]);
+}
+
+/// Asserts that [liveTest] will have a single error, the string `"oh no"`.
+void expectSingleError(LiveTest liveTest) {
+ expectStates(liveTest, [
+ const State(Status.running, Result.success),
+ const State(Status.complete, Result.error)
+ ]);
+
+ expectErrors(liveTest, [
+ (error) {
+ expect(lastState?.status, equals(Status.complete));
+ expect(error, equals('oh no'));
+ }
+ ]);
+}
+
+/// 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);
+
+/// Asserts that [liveTest] has completed and passed.
+///
+/// If the test had any errors, they're surfaced nicely into the outer test.
+void expectTestPassed(LiveTest liveTest) {
+ // Since the test is expected to pass, we forward any current or future errors
+ // to the outer test, because they're definitely unexpected.
+ for (var error in liveTest.errors) {
+ registerException(error.error, error.stackTrace);
+ }
+ liveTest.onError.listen((error) {
+ registerException(error.error, error.stackTrace);
+ });
+
+ expect(liveTest.state.status, equals(Status.complete));
+ expect(liveTest.state.result, equals(Result.success));
+}
+
+/// Asserts that [liveTest] failed with a single [TestFailure] whose message
+/// matches [message].
+void expectTestFailed(LiveTest liveTest, Object message) {
+ expect(liveTest.state.status, equals(Status.complete));
+ expect(liveTest.state.result, equals(Result.failure));
+ expect(liveTest.errors, hasLength(1));
+ expect(liveTest.errors.first.error, isTestFailure(message));
+}
+
+/// Runs [body] with a declarer, runs all the declared tests, and asserts that
+/// they pass.
+///
+/// This is typically used to run multiple tests where later tests make
+/// assertions about the results of previous ones.
+Future expectTestsPass(void Function() body) async {
+ var engine = declareEngine(body);
+ var success = await engine.run();
+
+ for (var test in engine.liveTests) {
+ expectTestPassed(test);
+ }
+
+ expect(success, isTrue);
+}
+
+/// Runs [body] with a declarer and returns the declared entries.
+List<GroupEntry> declare(
+ void Function() body, {
+ // TODO: Change the default https://github.com/dart-lang/test/issues/1571
+ bool allowDuplicateTestNames = true,
+}) {
+ var declarer = Declarer(allowDuplicateTestNames: allowDuplicateTestNames)
+ ..declare(body);
+ return declarer.build().entries;
+}
+
+/// Runs [body] with a declarer and returns an engine that runs those tests.
+Engine declareEngine(void Function() body, {bool runSkipped = false}) {
+ var declarer = Declarer()..declare(body);
+ return Engine.withSuites([
+ RunnerSuite(
+ const PluginEnvironment(),
+ SuiteConfiguration.runSkipped(runSkipped),
+ declarer.build(),
+ suitePlatform)
+ ]);
+}
diff --git a/pkgs/test_core/CHANGELOG.md b/pkgs/test_core/CHANGELOG.md
new file mode 100644
index 0000000..4c305bc
--- /dev/null
+++ b/pkgs/test_core/CHANGELOG.md
@@ -0,0 +1,668 @@
+## 0.6.8
+
+* Fix hang when running multiple precompiled browser tests.
+
+## 0.6.7
+
+* Update the `package:vm_service` constraint to allow version `15.x`.
+
+## 0.6.6
+
+* Allow `analyzer: '>=6.0.0 <8.0.0'`
+* Fix dart2wasm tests on windows.
+* Increase SDK constraint to ^3.5.0.
+* Allow passing additional arguments to `dart compile wasm`.
+
+## 0.6.5
+
+* Increase SDK constraint to ^3.4.0.
+* Ensure we don't create files ending in a `.`, this breaks windows.
+
+## 0.6.4
+
+* Enable asserts for `dart2wasm` tests.
+
+## 0.6.3
+
+* Update min SDK constraint to 3.2.0.
+* Fix testing with `dart2wasm` - use `dart compile wasm` instead of depending on
+ SDK internals
+
+## 0.6.2
+
+* Add `@doNotSubmit` to more declarations of the `solo` parameter.
+
+## 0.6.1
+
+* Handle missing package configs.
+* Document the silent reporter in CLI help output.
+* Support enabling experiments with the dart2wasm compiler.
+
+## 0.6.0
+
+* Handle paths with leading `/` when spawning test isolates.
+* Added `dart2wasm` as a supported compiler for the `chrome` runtime.
+* **BREAKING**: Removed the `experimentalChromeWasm` runtime.
+* **BREAKING**: Removed `Runtime.isJS` and `Runtime.isWasm`, as this is now
+ based on the compiler and not the runtime.
+* **BREAKING**: Removed `Configuration.pubServeUrl` and support for it.
+* Fix running of tests defined under `lib/` with relative imports to other
+ libraries in the package.
+* Update the `package:frontend_server_client` constraint to allow version
+ `4.0.0`.
+* Update the `package:vm_service` constraint to allow version `14.x`.
+
+## 0.5.9
+
+* Update the vm_service constraint to allow version `13.x`.
+
+## 0.5.8
+
+* Move scaffolding definitions to a non-deprecated library.
+* Allow omitting the `Compiler` argument to `currentPlatform`.
+
+## 0.5.7
+
+* Pass --disable-program-split to dart2js to fix tests which use deferred
+ loading.
+* Add a 'silent' reporter option. Keep it hidden in the CLI args help since it
+ is not useful in the general case, but can be useful for tests of the test
+ runner.
+* Update to `package:vm_service` `12.0.0`
+
+## 0.5.6
+
+* Add support for discontinuing after the first failing test with `--fail-fast`.
+
+## 0.5.5
+
+* Change "compiling <path>" to "loading <path>" message in all cases. Surface
+ the "loading" messages in the situations where previously only "compiling"
+ message would be used.
+
+## 0.5.4
+
+* Drop support for null unsafe Dart, bump SDK constraint to `3.0.0`.
+* Add `final` modifier on some implementation classes: `Configuration`,
+ `CustomRuntime`,`RuntimeSettings`, `SuiteConfiguration`.
+* Fix the `root_` fields in the JSON reporter when running a test on Windows
+ with an absolute path.
+* Allow the latest analyzer (6.x.x).
+
+## 0.5.3
+
+* Fix compatibility with wasm number semantics.
+
+## 0.5.2
+
+* Use the version `0.5.2` of `packge:test_api`.
+
+## 0.5.1
+
+* Start adding experimental support for native_assets.yaml, when
+ `--enable-experiment=native_assets` is passed.
+
+## 0.5.0
+
+* Support the `--compiler` flag, which can be used to configure which compiler
+ to use.
+ * To specify a compiler by platform, the argument supports platform selectors
+ through this syntax `[<platform>:]<compiler>`. For example the command line
+ argument `--compiler vm:source` would run all vm tests from source instead
+ of compiling to kernel first.
+ * If no given compiler is compatible for a platform, it will use its default
+ compiler instead.
+* Add support for `-c exe` (the native executable compiler) to the vm platform.
+* Add `Compiler` class, exposed through `backend.dart`.
+* Support compiler identifiers in platform selectors.
+* List the supported compilers for each platform in the usage text.
+* Update all reporters to print the compiler along with the platform name
+ when configured to print the platform. Extend the logic for printing platofrm
+ information to do so if any compilers are explicitly configured.
+* Deprecate `--use-data-isolate-strategy`. It is now an alias for `-c vm:source`
+ which is roughly equivalent. If this is breaking for you please file an issue.
+* **BREAKING** Add required `defaultCompiler` and `supportedCompilers` fields
+ to `Runtime`.
+* **BREAKING** Add required `compiler` field to `SuitePlatform`.
+* **BREAKING** Add required `compilerSelections` argument to some
+ `Configuration` and `SuiteConfiguration` constructors.
+* **BREAKING** Custom platform plugins need to respect the compiler option
+ given through the `SuitePlatform` argument to `PlatformPlugin.load`. This is
+ not statically breaking but it will be confusing for users if it isn't
+ supported.
+* **BREAKING** Remove `useDataIsolateStrategy` field from `Configuration`.
+* **BREAKING** Stop exporting APIs from `package:matcher/expect.dart`.
+
+## 0.4.24
+
+* Fix running paths by absolute path (with drive letter) on windows.
+
+## 0.4.23
+
+* Avoid empty expandable groups for tests without extra output in Github
+ reporter.
+* Support running tests by absolute file uri.
+* Update `vm_service` constraint to `>=6.0.0 <12.0.0`.
+
+## 0.4.22
+
+* Don't run `tearDown` until the test body and outstanding work is complete,
+ even if the test has already failed.
+* Update `vm_service` constraint to `>=6.0.0 <11.0.0`.
+
+## 0.4.21
+
+* Move `includeTags` and `excludeTags` from `SuiteConfiguration` to
+ `Configuration`.
+* Merge command lines args repeating the same test path to run the suite one
+ time with all the test cases across the different arguments.
+* Fix VM tests which run after some test has changed the working directory.
+ There are still issues with browser tests after changing directory.
+
+## 0.4.20
+
+* Fix an issue with the github reporter where tests that fail asynchronously
+ after they've completed would show up as succeeded tests.
+* Support the latest `package:test_api`.
+* Refactor `CompilerPool` to be abstract, add wasm compiler pool.
+
+## 0.4.19
+
+* Support `package:matcher` version `0.12.13`.
+* Require Dart SDK version 2.18.
+
+## 0.4.18
+
+* Support the latest `package:test_api`.
+* Support the latest `package:analyzer`.
+
+## 0.4.17
+
+* Support the latest `package:test_api`.
+* Support the latest `package:frontend_server_client`.
+
+## 0.4.16
+
+* Make the labels for test loading more readable in the compact and expanded
+ reporters, use gray instead of black.
+* Print a command to re-run the failed test after each failure in the compact
+ reporter.
+* Fix the package config path used when running pre-compiled vm tests.
+
+## 0.4.15
+
+* Support the latest `package:test_api`.
+
+## 0.4.14
+
+* Update the github reporter to output the platform in the test names when
+ multiple platforms are used.
+* Fix `spawnHybridUri` support for `package:` uris.
+
+## 0.4.13
+
+* Re-publish changes from 0.4.12.
+* Stop relying on setUpAllName and tearDownAllName constants from test_api.
+
+## 0.4.12 (retracted)
+
+* Remove wait for VM platform isolate exits.
+* Drop `dart2jsPath` configuration support.
+* Allow loading tests under a path with the directory named `packages`.
+* Require analyzer version `3.3.0`, and allow version `4.x`.
+
+## 0.4.11
+
+* Update `vm_service` constraint to `>=6.0.0 <9.0.0`.
+
+## 0.4.10
+
+* Update `analyzer` constraint to `>=2.14.0 <3.0.0`.
+* Add an `--ignore-timeouts` command line flag, which disables all timeouts
+ for all tests.
+* Experimental: Add a VM service extension `ext.test.pauseAfterTests` which
+ configures VM platform tests to pause for debugging after tests are run,
+ before the test isolates are killed.
+
+## 0.4.9
+
+* Wait for paused VM platform isolates before shutdown.
+
+## 0.4.8
+
+* Add logging about enabling stack trace chaining to the compact and expanded
+ reporters (moved from the invoker). This will now only be logged once after
+ all tests have ran.
+
+## 0.4.7
+
+* Fix parsing of file paths into a URI on windows.
+
+## 0.4.6
+
+* Support query parameters `name`, `full-name`, `line`, and `col` on test paths,
+ which will apply the filters to only those test suites.
+ * All specified filters must match for a test to run.
+ * Global filters (ie: `--name`) are also still respected and must match.
+ * The `line` and `col` will match if any frame from the test trace matches
+ (the test trace is the current stack trace where `test` is invoked).
+* Support the latest `test_api`.
+
+## 0.4.5
+
+* Use newer analyzer APIs.
+
+## 0.4.4
+
+* Support the latest `test_api`.
+
+## 0.4.3
+
+* Add an option to disallow duplicate test or group names in `directRunTests`.
+* Add configuration to disallow duplicate test and group names by default. See
+ the [docs][allow_duplicate_test_names] for more information.
+* Remove dependency on pedantic.
+
+[allow_duplicate_test_names]: https://github.com/dart-lang/test/blob/master/pkgs/test/doc/configuration.md#allow_duplicate_test_names
+
+## 0.4.2
+
+* Re-use the cached dill file from previous runs on subsequent runs.
+
+## 0.4.1
+
+* Use the latest `package:matcher`.
+
+## 0.4.0
+
+* **BREAKING**: All parameters to the `SuiteConfiguration` and `Configuration`
+ constructors are now required. Some specialized constructors have been added
+ for the common cases where a subset are intended to be provided.
+* **BREAKING**: Remove support for `FORCE_TEST_EXIT`.
+* Report incomplete tests as errors in the JSON reporter when the run is
+ canceled early.
+* Don't log the --test-randomization-ordering-seed if using the json reporter.
+* Add a new exit code, 79, which is used when no tests were ran.
+ * Previously you would have gotten either exit code 1 or 65 (65 if you had
+ provided a test name regex).
+* When no tests were ran but tags were provided, list the tag configuration.
+* Update `analyzer` constraint to `>=1.0.0 <3.0.0`.
+
+## 0.3.29
+
+* Fix a bug where a tag level configuration would cause test suites with that
+ tag to ignore the `--test-randomize-ordering-seed` argument.
+
+## 0.3.28
+
+* Add `time` field to the json reporters `allSuites` event type so that all
+ event types can be unified.
+
+## 0.3.27
+
+* Restore the `Configuration.loadFromString` constructor.
+
+## 0.3.26
+
+* Give a better error when `printOnFailure` is called from outside a test
+ zone.
+
+## 0.3.25
+
+* Support the latest vm_service release (`7.0.0`).
+
+## 0.3.24
+
+* Fix race condition between compilation of vm tests and the running of
+ isolates.
+
+## 0.3.23
+
+* Forward experiment args from the runner executable to the compiler with the
+ new vm test loading strategy.
+
+## 0.3.22
+
+* Fix a windows issue with the new loading strategy.
+
+## 0.3.21
+
+* Fix an issue where you couldn't have tests compiled in both sound and
+ unsound null safety modes.
+
+## 0.3.20
+
+* Add library `scaffolding.dart` to allow importing a subset of the normal
+ surface area.
+* Remove `suiteChannel`. This is now handled by an additional argument to the
+ `beforeLoad` callback in `serializeSuite`.
+* Disable stack trace chaining by default.
+* Change the default way VM tests are launched and ran to greatly speed up
+ loading performance.
+ * You can force the old strategy with `--use-data-isolate-strategy` flag if
+ you run into issues, but please also file a bug.
+* Improve the error message for `hybridMain` functions with an incompatible
+ StreamChannel parameter type.
+* Change the `message` argument to `PlatformPlugin.load` to `Map<String,
+ Object?>`. In an upcoming release this will be required as the type for this
+ argument when passed through to `deserializeSuite`.
+
+## 0.3.19
+
+* ~~Disable stack trace chaining by default.~~
+
+## 0.3.18
+
+* Update `spawnHybridCode` to default to the current packages language version.
+* Update to the latest `test_api`.
+
+## 0.3.17
+
+* Complete the null safety migration.
+
+## 0.3.16
+
+* Allow package:io version 1.0.0.
+
+## 0.3.14
+
+* Handle issue closing `stdin` during shutdown.
+
+## 0.3.13
+
+* Allow the latest analyzer `1.0.0`.
+
+## 0.3.12
+
+* Stable null safety release.
+
+## 0.3.12-nullsafety.17
+
+* Use the `test_api` for stable null safety.
+
+## 0.3.12-nullsafety.16
+
+* Expand upper bound constraints for some null safe migrated packages.
+
+## 0.3.12-nullsafety.15
+
+* Support the latest vm_service release (`6.x.x`).
+
+## 0.3.12-nullsafety.14
+
+* Support the latest coverage release (`0.15.x`).
+
+## 0.3.12-nullsafety.13
+
+* Allow the latest args release (`2.x`).
+
+## 0.3.12-nullsafety.12
+
+* Allow the latest glob release (`2.x`).
+
+## 0.3.12-nullsafety.11
+
+* Fix `spawnHybridUri` on windows.
+* Allow `package:yaml` version `3.x.x`.
+
+## 0.3.12-nullsafety.10
+
+* Allow `package:analyzer` version `0.41.x`.
+
+## 0.3.12-nullsafety.9
+
+* Fix `spawnHybridUri` to respect language versioning of the spawned uri.
+* Pre-emptively fix legacy library import lint violations, and unmigrate some
+ libraries as necessary.
+
+## 0.3.12-nullsafety.8
+
+* Fix a bug where the test runner could crash when printing the elapsed time.
+* Update SDK constraints to `>=2.12.0-0 <3.0.0` based on beta release
+ guidelines.
+
+
+## 0.3.12-nullsafety.7
+
+* Allow prerelease versions of the 2.12 sdk.
+
+## 0.3.12-nullsafety.6
+
+* Add experimental `directRunTests`, `directRunSingle`, and `enumerateTestCases`
+ APIs to enable test runners written around a single executable that can report
+ and run any single test case.
+
+## 0.3.12-nullsafety.5
+
+* Allow `2.10` stable and `2.11.0-dev` SDKs.
+* Add `src/platform.dart` library to consolidate the necessary imports required
+ to write a custom platform.
+* Stop required a `SILENT_OBSERVATORY` environment variable to run with
+ debugging and the JSON reporter.
+
+## 0.3.12-nullsafety.4
+
+* Support latest `package:vm_service`.
+
+## 0.3.12-nullsafety.3
+
+* Clean up `--help` output.
+
+## 0.3.12-nullsafety.2
+
+* Allow version `0.40.x` of `analyzer`.
+
+## 0.3.12-nullsafety.1
+
+* Update source_maps constraint.
+
+## 0.3.12-nullsafety
+
+* Migrate to null safety.
+
+## 0.3.11+4 (Backport)
+
+* Fix `spawnHybridUri` on windows.
+
+## 0.3.11+3 (Backport)
+
+* Support `package:analyzer` version `0.41.x`.
+
+## 0.3.11+2 (Backport)
+
+* Fix `spawnHybridUri` to respect language versioning of the spawned uri.
+
+## 0.3.11+1
+
+* Allow analyzer 0.40.x.
+
+## 0.3.11
+
+* Update to `matcher` version `0.12.9`.
+
+## 0.3.10
+
+* Prepare for `unawaited` from `package:meta`.
+
+## 0.3.9
+
+* Ignore a null `RunnerSuite` rather than throw an error.
+
+## 0.3.8
+
+* Update vm bootstrapping logic to ensure the bootstrap library has the same
+ language version as the test.
+* Populate `languageVersionComment` in the `Metadata` returned from
+ `parseMetadata`.
+
+## 0.3.7
+
+* Support the latest `package:coverage`.
+
+## 0.3.6
+
+* Expose the `Configuration` class and related classes through `backend.dart`.
+
+## 0.3.5
+
+* Add additional information to an exception when we end up with a null
+ `RunnerSuite`.
+
+* Update vm bootstrapping logic to ensure the bootstrap library has the same
+ language version as the test.
+* Populate `languageVersionComment` in the `Metadata` returned from
+ `parseMetadata`.
+
+## 0.3.4
+
+* Fix error messages for incorrect string literals in test annotations.
+
+## 0.3.3
+
+* Support latest `package:vm_service`.
+
+## 0.3.2
+
+* Drop the `package_resolver` dependency.
+
+## 0.3.1
+
+* Support latest `package:vm_service`.
+* Enable asserts in code running through `spawnHybrid` APIs.
+* Exit with a non-zero code if no tests were ran, whether due to skips or having
+ no tests defined.
+
+## 0.3.0
+
+* Bump minimum SDK to `2.4.0` for safer usage of for-loop elements.
+* Deprecate `PhantomJS` and provide warning when used. Support for `PhantomJS`
+ will be removed in version `2.0.0`.
+* Differentiate between test-randomize-ordering-seed not set and 0 being chosen
+ as the random seed.
+* `deserializeSuite` now takes an optional `gatherCoverage` callback.
+* Support retrying of entire test suites when they fail to load.
+* Fix the `compiling` message in precompiled mode so it says `loading` instead,
+ which is more accurate.
+* Change the behavior of the concurrency setting so that loading and running
+ don't have separate pools.
+ * The loading and running of a test are now done with the same resource, and
+ the concurrency setting uniformly affects each. With `-j1` only a single
+ test will ever be loaded at a time.
+ * Previously the loading pool was 2x larger than the actual concurrency
+ setting which could cause flaky tests due to tests being loaded while
+ other tests were running, even with `-j1`.
+* Avoid printing uncaught errors within `spawnHybridUri`.
+
+## 0.2.18
+
+* Allow `test_api` `0.2.13` to work around a bug in the SDK version `2.3.0`.
+
+## 0.2.17
+
+* Add `file_reporters` configuration option and `--file-reporter` CLI option to
+ allow specifying a separate reporter that writes to a file.
+
+## 0.2.16
+
+* Internal cleanup.
+* Add `customHtmlTemplateFile` configuration option to allow sharing an
+ html template between tests
+* Depend on the latest `test_api`.
+
+## 0.2.15
+
+* Add a `StringSink` argument to reporters to prepare for reporting to a file.
+* Add --test-randomize-ordering-seed` argument to randomize test
+execution order based on a provided seed
+* Depend on the latest `test_api`.
+
+## 0.2.14
+
+* Support the latest `package:analyzer`.
+* Update to latest `package:matcher`. Improves output for instances of private
+ classes.
+
+## 0.2.13
+
+* Depend on the latest `package:test_api`.
+
+## 0.2.12
+
+* Conditionally import coverage logic in `engine.dart`. This ensures the engine
+ is platform agnostic.
+
+## 0.2.11
+
+* Implement code coverage gathering for VM tests.
+
+## 0.2.10
+
+* Add a `--debug` argument for running the VM/Chrome in debug mode.
+
+## 0.2.9+2
+
+* Depend on the latest `test_api`.
+
+## 0.2.9+1
+
+* Allow the latest `package:vm_service`.
+
+## 0.2.9
+
+* Mark `package:test_core` as deprecated to prevent accidental use.
+* Depend on the latest `test_api`.
+
+## 0.2.8
+
+* Depend on `vm_service` instead of `vm_service_lib`.
+* Drop dependency on `pub_semver`.
+* Allow `analyzer` version `0.38.x`.
+
+## 0.2.7
+
+* Depend on `vm_service_lib` instead of `vm_service_client`.
+* Depend on latest `package:analyzer`.
+
+## 0.2.6
+
+* Internal cleanup - fix lints.
+* Use the latest `test_api`.
+
+## 0.2.5
+
+* Fix an issue where non-completed tests were considered passing.
+* Updated `compact` and `expanded` reporters to display non-completed tests.
+
+## 0.2.4
+
+* Avoid `dart:isolate` imports on code loaded in tests.
+* Expose the `parseMetadata` function publicly through a new `backend.dart`
+ import, as well as re-exporting `package:test_api/backend.dart`.
+
+## 0.2.3
+
+* Switch import for `IsolateChannel` for forwards compatibility with `2.0.0`.
+
+## 0.2.2
+
+* Allow `analyzer` version `0.36.x`.
+* Update to matcher version `0.12.5`.
+
+## 0.2.1+1
+
+* Allow `analyzer` version `0.35.x`.
+
+## 0.2.1
+
+* Require Dart SDK `>=2.1.0`.
+* Require latest `test_api`.
+
+## 0.2.0
+
+* Remove `remote_listener.dart` and `suite_channel_manager.dart` from runner
+ and depend on them from `test_api`.
+
+## 0.1.0
+
+* Initial release of `test_core`. Provides the basic API for writing and running
+ tests on the VM.
diff --git a/pkgs/test_core/LICENSE b/pkgs/test_core/LICENSE
new file mode 100644
index 0000000..9972f6e
--- /dev/null
+++ b/pkgs/test_core/LICENSE
@@ -0,0 +1,27 @@
+Copyright 2018, the Dart project authors.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+ * Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ * Redistributions in binary form must reproduce the above
+ copyright notice, this list of conditions and the following
+ disclaimer in the documentation and/or other materials provided
+ with the distribution.
+ * Neither the name of Google LLC nor the names of its
+ contributors may be used to endorse or promote products derived
+ from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
diff --git a/pkgs/test_core/README.md b/pkgs/test_core/README.md
new file mode 100644
index 0000000..67f21a8
--- /dev/null
+++ b/pkgs/test_core/README.md
@@ -0,0 +1,11 @@
+[](https://pub.dev/packages/test_core)
+[](https://pub.dev/packages/test_core/publisher)
+
+A minimal package for writing and running tests as well as extensions for
+implementing a custom test runner.
+
+If you're interested in testing Dart code, you likely want to use
+[package:test](https://pub.dev/packages/test).
+
+At this time this package is not intended to be used publicly. The API is not
+yet stable.
diff --git a/pkgs/test_core/lib/backend.dart b/pkgs/test_core/lib/backend.dart
new file mode 100644
index 0000000..f5a3b46
--- /dev/null
+++ b/pkgs/test_core/lib/backend.dart
@@ -0,0 +1,16 @@
+// Copyright (c) 2019, 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.
+
+@Deprecated('package:test_core is not intended for general use. '
+ 'Please use package:test.')
+library;
+
+export 'package:test_api/backend.dart'
+ show Compiler, Metadata, PlatformSelector, Runtime, SuitePlatform;
+
+export 'src/runner/configuration.dart' show Configuration;
+export 'src/runner/configuration/custom_runtime.dart' show CustomRuntime;
+export 'src/runner/configuration/runtime_settings.dart' show RuntimeSettings;
+export 'src/runner/parse_metadata.dart' show parseMetadata;
+export 'src/runner/suite.dart' show SuiteConfiguration;
diff --git a/pkgs/test_core/lib/scaffolding.dart b/pkgs/test_core/lib/scaffolding.dart
new file mode 100644
index 0000000..90304d2
--- /dev/null
+++ b/pkgs/test_core/lib/scaffolding.dart
@@ -0,0 +1,9 @@
+// Copyright (c) 2021, 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.
+
+@Deprecated('package:test_core is not intended for general use. '
+ 'Please use package:test.')
+library;
+
+export 'src/scaffolding.dart';
diff --git a/pkgs/test_core/lib/src/bootstrap/vm.dart b/pkgs/test_core/lib/src/bootstrap/vm.dart
new file mode 100644
index 0000000..05604f1
--- /dev/null
+++ b/pkgs/test_core/lib/src/bootstrap/vm.dart
@@ -0,0 +1,50 @@
+// Copyright (c) 2017, 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 'dart:developer';
+import 'dart:io';
+import 'dart:isolate';
+
+import 'package:stream_channel/isolate_channel.dart';
+import 'package:stream_channel/stream_channel.dart';
+
+import '../runner/plugin/remote_platform_helpers.dart';
+import '../runner/plugin/shared_platform_helpers.dart';
+
+/// Bootstraps a vm test to communicate with the test runner over an isolate.
+void internalBootstrapVmTest(Function Function() getMain, SendPort sendPort) {
+ var platformChannel =
+ MultiChannel<Object?>(IsolateChannel<Object?>.connectSend(sendPort));
+ var testControlChannel = platformChannel.virtualChannel()
+ ..pipe(serializeSuite(getMain));
+ platformChannel.sink.add(testControlChannel.id);
+
+ platformChannel.stream.forEach((message) {
+ assert(message == 'debug');
+ debugger(message: 'Paused by test runner');
+ platformChannel.sink.add('done');
+ });
+}
+
+/// Bootstraps a native executable test to communicate with the test runner over
+/// a socket.
+void internalBootstrapNativeTest(
+ Function Function() getMain, List<String> args) async {
+ if (args.length != 2) {
+ throw StateError(
+ 'Expected exactly two args, a host and a port, but got $args');
+ }
+ var socket = await Socket.connect(args[0], int.parse(args[1]));
+ var platformChannel = MultiChannel<Object?>(jsonSocketStreamChannel(socket));
+ var testControlChannel = platformChannel.virtualChannel()
+ ..pipe(serializeSuite(getMain));
+ platformChannel.sink.add(testControlChannel.id);
+
+ unawaited(platformChannel.stream.forEach((message) {
+ assert(message == 'debug');
+ debugger(message: 'Paused by test runner');
+ platformChannel.sink.add('done');
+ }));
+}
diff --git a/pkgs/test_core/lib/src/direct_run.dart b/pkgs/test_core/lib/src/direct_run.dart
new file mode 100644
index 0000000..c574257
--- /dev/null
+++ b/pkgs/test_core/lib/src/direct_run.dart
@@ -0,0 +1,134 @@
+// Copyright (c) 2020, 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 'dart:collection';
+
+import 'package:path/path.dart' as p;
+import 'package:test_api/backend.dart';
+import 'package:test_api/src/backend/declarer.dart'; //ignore: implementation_imports
+import 'package:test_api/src/backend/group.dart'; //ignore: implementation_imports
+import 'package:test_api/src/backend/group_entry.dart'; //ignore: implementation_imports
+import 'package:test_api/src/backend/invoker.dart'; // ignore: implementation_imports
+import 'package:test_api/src/backend/test.dart'; //ignore: implementation_imports
+
+import 'runner/configuration.dart';
+import 'runner/engine.dart';
+import 'runner/plugin/environment.dart';
+import 'runner/reporter.dart';
+import 'runner/reporter/expanded.dart';
+import 'runner/runner_suite.dart';
+import 'runner/suite.dart';
+import 'util/os.dart';
+import 'util/print_sink.dart';
+
+/// Runs all unskipped test cases declared in [testMain].
+///
+/// Test suite level metadata defined in annotations is not read. No filtering
+/// is applied except for the filtering defined by `solo` or `skip` arguments to
+/// `group` and `test`. Returns [true] if all tests passed.
+Future<bool> directRunTests(FutureOr<void> Function() testMain,
+ {Reporter Function(Engine)? reporterFactory,
+ // TODO: Change the default https://github.com/dart-lang/test/issues/1571
+ bool allowDuplicateTestNames = true}) =>
+ _directRunTests(testMain,
+ reporterFactory: reporterFactory,
+ allowDuplicateTestNames: allowDuplicateTestNames);
+
+/// Runs a single test declared in [testMain] matched by it's full test name.
+///
+/// There must be exactly one test defined with the name [fullTestName]. Note
+/// that not all tests and groups are checked, so a test case that is not be
+/// intended to be run (due to a `solo` on a different test) may still be run
+/// with this API. Only the test names returned by [enumerateTestCases] should
+/// be used to prevent running skipped tests.
+///
+/// Return [true] if the test passes.
+///
+/// If there are no tests matching [fullTestName] a [MissingTestException] is
+/// thrown. If there is more than one test with the name [fullTestName] they
+/// will both be run, then a [DuplicateTestnameException] will be thrown.
+Future<bool> directRunSingleTest(
+ FutureOr<void> Function() testMain, String fullTestName,
+ {Reporter Function(Engine)? reporterFactory}) =>
+ _directRunTests(testMain,
+ reporterFactory: reporterFactory,
+ fullTestName: fullTestName,
+ allowDuplicateTestNames: false);
+
+Future<bool> _directRunTests(FutureOr<void> Function() testMain,
+ {Reporter Function(Engine)? reporterFactory,
+ String? fullTestName,
+ required bool allowDuplicateTestNames}) async {
+ reporterFactory ??= (engine) => ExpandedReporter.watch(engine, PrintSink(),
+ color: Configuration.empty.color, printPath: false, printPlatform: false);
+ final declarer = Declarer(
+ fullTestName: fullTestName,
+ allowDuplicateTestNames: allowDuplicateTestNames);
+ await declarer.declare(testMain);
+
+ final suite = RunnerSuite(
+ const PluginEnvironment(),
+ SuiteConfiguration.empty,
+ declarer.build(),
+ SuitePlatform(Runtime.vm, compiler: null, os: currentOSGuess),
+ path: p.prettyUri(Uri.base));
+
+ final engine = Engine()
+ ..suiteSink.add(suite)
+ ..suiteSink.close();
+
+ reporterFactory(engine);
+
+ final success = await runZoned(() => Invoker.guard(engine.run),
+ zoneValues: {#test.declarer: declarer}) ??
+ false;
+
+ if (fullTestName != null) {
+ final testCount = engine.liveTests.length;
+ if (testCount == 0) {
+ throw MissingTestException(fullTestName);
+ }
+ }
+ return success;
+}
+
+/// Runs [testMain] and returns the names of all declared tests.
+///
+/// Test names declared must be unique. If any test repeats the full name,
+/// including group prefixes, of a prior test a [DuplicateTestNameException]
+/// will be thrown.
+///
+/// Skipped tests are ignored.
+Future<Set<String>> enumerateTestCases(
+ FutureOr<void> Function() testMain) async {
+ final declarer = Declarer();
+ await declarer.declare(testMain);
+
+ final toVisit = Queue<GroupEntry>.of([declarer.build()]);
+ final unskippedTestNames = <String>{};
+ while (toVisit.isNotEmpty) {
+ final current = toVisit.removeLast();
+ if (current is Group) {
+ toVisit.addAll(current.entries.reversed);
+ } else if (current is Test) {
+ if (current.metadata.skip) continue;
+ unskippedTestNames.add(current.name);
+ } else {
+ throw StateError('Unhandled Group Entry: ${current.runtimeType}');
+ }
+ }
+ return unskippedTestNames;
+}
+
+/// An exception thrown when a specific test was requested by name that does not
+/// exist.
+class MissingTestException implements Exception {
+ final String name;
+ MissingTestException(this.name);
+
+ @override
+ String toString() =>
+ 'A test with the name "$name" was not declared in the test suite.';
+}
diff --git a/pkgs/test_core/lib/src/executable.dart b/pkgs/test_core/lib/src/executable.dart
new file mode 100644
index 0000000..eeefd16
--- /dev/null
+++ b/pkgs/test_core/lib/src/executable.dart
@@ -0,0 +1,196 @@
+// Copyright (c) 2015, 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 'dart:io';
+
+import 'package:async/async.dart';
+import 'package:path/path.dart' as p;
+import 'package:source_span/source_span.dart';
+import 'package:stack_trace/stack_trace.dart';
+import 'package:test_api/src/backend/util/pretty_print.dart'; // ignore: implementation_imports
+
+import 'runner.dart';
+import 'runner/application_exception.dart';
+import 'runner/configuration.dart';
+import 'runner/no_tests_found_exception.dart';
+import 'runner/version.dart';
+import 'util/errors.dart';
+import 'util/exit_codes.dart' as exit_codes;
+import 'util/io.dart';
+
+StreamSubscription? signalSubscription;
+bool isShutdown = false;
+
+/// Returns the path to the global test configuration file.
+final String _globalConfigPath = () {
+ if (Platform.environment.containsKey('DART_TEST_CONFIG')) {
+ return Platform.environment['DART_TEST_CONFIG']!;
+ } else if (Platform.operatingSystem == 'windows') {
+ return p.join(Platform.environment['LOCALAPPDATA']!, 'DartTest.yaml');
+ } else {
+ return '${Platform.environment['HOME']}/.dart_test.yaml';
+ }
+}();
+
+Future<void> main(List<String> args) async {
+ await _execute(args);
+ completeShutdown();
+}
+
+// ignore: unreachable_from_main
+Future<void> runTests(List<String> args) async {
+ await _execute(args);
+}
+
+void completeShutdown() {
+ if (isShutdown) return;
+ if (signalSubscription != null) {
+ signalSubscription!.cancel();
+ signalSubscription = null;
+ }
+ isShutdown = true;
+ cancelStdinLines();
+}
+
+Future<void> _execute(List<String> args) async {
+ /// A merged stream of all signals that tell the test runner to shut down
+ /// gracefully.
+ ///
+ /// Signals will only be captured as long as this has an active subscription.
+ /// Otherwise, they'll be handled by Dart's default signal handler, which
+ /// terminates the program immediately.
+ final signals = Platform.isWindows
+ ? ProcessSignal.sigint.watch()
+ : Platform.isFuchsia // Signals don't exist on Fuchsia.
+ ? const Stream<Never>.empty()
+ : StreamGroup.merge(
+ [ProcessSignal.sigterm.watch(), ProcessSignal.sigint.watch()]);
+
+ Configuration configuration;
+ try {
+ configuration = Configuration.parse(args);
+ } on FormatException catch (error) {
+ _printUsage(error.message);
+ exitCode = exit_codes.usage;
+ return;
+ }
+
+ if (configuration.help) {
+ _printUsage();
+ return;
+ }
+
+ if (configuration.version) {
+ var version = testVersion;
+ if (version == null) {
+ stderr.writeln("Couldn't find version number.");
+ exitCode = exit_codes.data;
+ } else {
+ print(version);
+ }
+ return;
+ }
+
+ try {
+ var fileConfiguration = Configuration.empty;
+ if (File(_globalConfigPath).existsSync()) {
+ fileConfiguration = fileConfiguration
+ .merge(Configuration.load(_globalConfigPath, global: true));
+ }
+
+ if (File(configuration.configurationPath).existsSync()) {
+ fileConfiguration = fileConfiguration
+ .merge(Configuration.load(configuration.configurationPath));
+ }
+
+ configuration = fileConfiguration.merge(configuration);
+ } on SourceSpanFormatException catch (error) {
+ stderr.writeln(error.toString(color: configuration.color));
+ exitCode = exit_codes.data;
+ return;
+ } on FormatException catch (error) {
+ stderr.writeln(error.message);
+ exitCode = exit_codes.data;
+ return;
+ } on IOException catch (error) {
+ stderr.writeln(error.toString());
+ exitCode = exit_codes.noInput;
+ return;
+ }
+
+ var undefinedPresets = configuration.chosenPresets
+ .where((preset) => !configuration.knownPresets.contains(preset))
+ .toList();
+ if (undefinedPresets.isNotEmpty) {
+ _printUsage("Undefined ${pluralize('preset', undefinedPresets.length)} "
+ "${toSentence(undefinedPresets.map((preset) => '"$preset"'))}.");
+ exitCode = exit_codes.usage;
+ return;
+ }
+
+ if (!configuration.explicitPaths &&
+ !Directory(configuration.testSelections.keys.single).existsSync()) {
+ _printUsage('No test files were passed and the default "test/" '
+ "directory doesn't exist.");
+ exitCode = exit_codes.data;
+ return;
+ }
+
+ Runner? runner;
+
+ signalSubscription ??= signals.listen((signal) async {
+ completeShutdown();
+ await runner?.close();
+ });
+
+ try {
+ runner = Runner(configuration);
+ exitCode = (await runner.run()) ? 0 : 1;
+ } on ApplicationException catch (error) {
+ stderr.writeln(error.message);
+ exitCode = exit_codes.data;
+ } on SourceSpanFormatException catch (error) {
+ stderr.writeln(error.toString(color: configuration.color));
+ exitCode = exit_codes.data;
+ } on FormatException catch (error) {
+ stderr.writeln(error.message);
+ exitCode = exit_codes.data;
+ } on NoTestsFoundException catch (error) {
+ stderr.writeln(error.message);
+ exitCode = exit_codes.noTestsRan;
+ } catch (error, stackTrace) {
+ stderr.writeln(getErrorMessage(error));
+ stderr.writeln(Trace.from(stackTrace).terse);
+ stderr.writeln('This is an unexpected error. Please file an issue at '
+ 'http://github.com/dart-lang/test\n'
+ 'with the stack trace and instructions for reproducing the error.');
+ exitCode = exit_codes.software;
+ } finally {
+ await runner?.close();
+ }
+
+ return;
+}
+
+/// Print usage information for this command.
+///
+/// If [error] is passed, it's used in place of the usage message and the whole
+/// thing is printed to stderr instead of stdout.
+void _printUsage([String? error]) {
+ var output = stdout;
+
+ var message = 'Runs tests in this package.';
+ if (error != null) {
+ message = error;
+ output = stderr;
+ }
+
+ output.write('''${wordWrap(message)}
+
+Usage: dart test [files or directories...]
+
+${Configuration.usage}
+''');
+}
diff --git a/pkgs/test_core/lib/src/platform.dart b/pkgs/test_core/lib/src/platform.dart
new file mode 100644
index 0000000..af457b4
--- /dev/null
+++ b/pkgs/test_core/lib/src/platform.dart
@@ -0,0 +1,16 @@
+// Copyright (c) 2020, 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.
+
+export 'package:test_api/backend.dart' show Runtime, SuitePlatform;
+export 'package:test_core/src/runner/configuration.dart' show Configuration;
+export 'package:test_core/src/runner/environment.dart'
+ show Environment, PluginEnvironment;
+export 'package:test_core/src/runner/hack_register_platform.dart'
+ show registerPlatformPlugin;
+export 'package:test_core/src/runner/platform.dart' show PlatformPlugin;
+export 'package:test_core/src/runner/plugin/platform_helpers.dart'
+ show deserializeSuite;
+export 'package:test_core/src/runner/runner_suite.dart'
+ show RunnerSuite, RunnerSuiteController;
+export 'package:test_core/src/runner/suite.dart' show SuiteConfiguration;
diff --git a/pkgs/test_core/lib/src/runner.dart b/pkgs/test_core/lib/src/runner.dart
new file mode 100644
index 0000000..ee648d4
--- /dev/null
+++ b/pkgs/test_core/lib/src/runner.dart
@@ -0,0 +1,475 @@
+// Copyright (c) 2015, 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 'dart:io';
+
+import 'package:async/async.dart';
+import 'package:boolean_selector/boolean_selector.dart';
+import 'package:stack_trace/stack_trace.dart';
+import 'package:test_api/backend.dart'
+ show PlatformSelector, Runtime, SuitePlatform;
+import 'package:test_api/src/backend/group.dart'; // ignore: implementation_imports
+import 'package:test_api/src/backend/group_entry.dart'; // ignore: implementation_imports
+import 'package:test_api/src/backend/operating_system.dart'; // ignore: implementation_imports
+import 'package:test_api/src/backend/suite.dart'; // ignore: implementation_imports
+import 'package:test_api/src/backend/test.dart'; // ignore: implementation_imports
+import 'package:test_api/src/backend/util/pretty_print.dart'; // ignore: implementation_imports
+
+import 'runner/configuration.dart';
+import 'runner/configuration/reporters.dart';
+import 'runner/debugger.dart';
+import 'runner/engine.dart';
+import 'runner/load_exception.dart';
+import 'runner/load_suite.dart';
+import 'runner/loader.dart';
+import 'runner/no_tests_found_exception.dart';
+import 'runner/reporter.dart';
+import 'runner/reporter/compact.dart';
+import 'runner/reporter/expanded.dart';
+import 'runner/reporter/multiplex.dart';
+import 'runner/runner_suite.dart';
+import 'util/io.dart';
+
+/// A class that loads and runs tests based on a [Configuration].
+///
+/// This maintains a [Loader] and an [Engine] and passes test suites from one to
+/// the other, as well as printing out tests with a [CompactReporter] or an
+/// [ExpandedReporter].
+class Runner {
+ /// The test runner configuration.
+ final _config = Configuration.current;
+
+ /// The loader that loads the test suites from the filesystem.
+ final _loader = Loader();
+
+ /// The engine that runs the test suites.
+ final Engine _engine;
+
+ /// The reporter that's emitting the test runner's results.
+ final Reporter _reporter;
+
+ /// The subscription to the stream returned by [_loadSuites].
+ StreamSubscription? _suiteSubscription;
+
+ /// The set of suite paths for which [_warnForUnknownTags] has already been
+ /// called.
+ ///
+ /// This is used to avoid printing duplicate warnings when a suite is loaded
+ /// on multiple platforms.
+ final _tagWarningSuites = <String>{};
+
+ /// The current debug operation, if any.
+ ///
+ /// This is stored so that we can cancel it when the runner is closed.
+ CancelableOperation? _debugOperation;
+
+ /// The memoizer for ensuring [close] only runs once.
+ final _closeMemo = AsyncMemoizer<void>();
+ bool get _closed => _closeMemo.hasRun;
+
+ /// Sinks created for each file reporter (if there are any).
+ final List<IOSink> _sinks;
+
+ /// Creates a new runner based on [configuration].
+ factory Runner(Configuration config) => config.asCurrent(() {
+ var engine = Engine(
+ concurrency: config.concurrency,
+ coverage: config.coverage,
+ testRandomizeOrderingSeed: config.testRandomizeOrderingSeed,
+ stopOnFirstFailure: config.stopOnFirstFailure,
+ );
+
+ var sinks = <IOSink>[];
+ Reporter createFileReporter(String reporterName, String filepath) {
+ final sink =
+ (File(filepath)..createSync(recursive: true)).openWrite();
+ sinks.add(sink);
+ return allReporters[reporterName]!.factory(config, engine, sink);
+ }
+
+ return Runner._(
+ engine,
+ MultiplexReporter([
+ // Standard reporter.
+ allReporters[config.reporter]!.factory(config, engine, stdout),
+ // File reporters.
+ for (var reporter in config.fileReporters.keys)
+ createFileReporter(reporter, config.fileReporters[reporter]!),
+ ]),
+ sinks,
+ );
+ });
+
+ Runner._(this._engine, this._reporter, this._sinks);
+
+ /// Starts the runner.
+ ///
+ /// This starts running tests and printing their progress. It returns whether
+ /// or not they ran successfully.
+ Future<bool> run() => _config.asCurrent(() async {
+ if (_closed) {
+ throw StateError('run() may not be called on a closed Runner.');
+ }
+
+ _warnForUnsupportedPlatforms();
+
+ var suites = _loadSuites();
+
+ if (_config.coverage != null) {
+ await Directory(_config.coverage!).create(recursive: true);
+ }
+
+ bool? success;
+ if (_config.pauseAfterLoad) {
+ success = await _loadThenPause(suites);
+ } else {
+ var subscription =
+ _suiteSubscription = suites.listen(_engine.suiteSink.add);
+ var results = await Future.wait(<Future>[
+ subscription
+ .asFuture<void>()
+ .then((_) => _engine.suiteSink.close()),
+ _engine.run()
+ ], eagerError: true);
+ success = results.last as bool?;
+ }
+
+ if (_closed) return false;
+
+ if (_engine.passed.isEmpty &&
+ _engine.failed.isEmpty &&
+ _engine.skipped.isEmpty) {
+ if (_config.globalPatterns.isNotEmpty) {
+ var patterns = toSentence(_config.globalPatterns.map((pattern) =>
+ pattern is RegExp
+ ? 'regular expression "${pattern.pattern}"'
+ : '"$pattern"'));
+ throw NoTestsFoundException('No tests match $patterns.');
+ } else if (_config.includeTags != BooleanSelector.all ||
+ _config.excludeTags != BooleanSelector.none) {
+ throw NoTestsFoundException(
+ 'No tests match the requested tag selectors:\n'
+ ' include: "${_config.includeTags}"\n'
+ ' exclude: "${_config.excludeTags}"');
+ } else {
+ throw NoTestsFoundException('No tests were found.');
+ }
+ }
+
+ return (success ?? false) &&
+ (_engine.passed.isNotEmpty || _engine.skipped.isNotEmpty);
+ });
+
+ /// Emits a warning if the user is trying to run on a platform that's
+ /// unsupported for the entire package.
+ void _warnForUnsupportedPlatforms() {
+ var testOn = _config.suiteDefaults.metadata.testOn;
+ if (testOn == PlatformSelector.all) return;
+
+ var unsupportedRuntimes = _config.suiteDefaults.runtimes
+ .map(_loader.findRuntime)
+ .whereType<Runtime>()
+ .where((runtime) => !testOn.evaluate(currentPlatform(runtime, null)))
+ .toList();
+
+ if (unsupportedRuntimes.isEmpty) return;
+
+ // Human-readable names for all unsupported runtimes.
+ var unsupportedNames = <String>[];
+
+ // If the user tried to run on one or more unsupported browsers, figure out
+ // whether we should warn about the individual browsers or whether all
+ // browsers are unsupported.
+ var unsupportedBrowsers =
+ unsupportedRuntimes.where((platform) => platform.isBrowser);
+ if (unsupportedBrowsers.isNotEmpty) {
+ var supportsAnyBrowser = _loader.allRuntimes
+ .where((runtime) => runtime.isBrowser)
+ .any((runtime) => testOn.evaluate(currentPlatform(runtime, null)));
+
+ if (supportsAnyBrowser) {
+ unsupportedNames
+ .addAll(unsupportedBrowsers.map((runtime) => runtime.name));
+ } else {
+ unsupportedNames.add('browsers');
+ }
+ }
+
+ // If the user tried to run on the VM and it's not supported, figure out if
+ // that's because of the current OS or whether the VM is unsupported.
+ if (unsupportedRuntimes.contains(Runtime.vm)) {
+ var supportsAnyOS = OperatingSystem.all.any((os) => testOn.evaluate(
+ SuitePlatform(Runtime.vm,
+ compiler: null, os: os, inGoogle: inGoogle)));
+
+ if (supportsAnyOS) {
+ unsupportedNames.add(currentOS.name);
+ } else {
+ unsupportedNames.add('the Dart VM');
+ }
+ }
+
+ warn("this package doesn't support running tests on "
+ '${toSentence(unsupportedNames, conjunction: 'or')}.');
+ }
+
+ /// Closes the runner.
+ ///
+ /// This stops any future test suites from running. It will wait for any
+ /// currently-running VM tests, in case they have stuff to clean up on the
+ /// filesystem.
+ Future close() => _closeMemo.runOnce(() async {
+ Timer? timer;
+ if (!_engine.isIdle) {
+ // Wait a bit to print this message, since printing it eagerly looks weird
+ // if the tests then finish immediately.
+ timer = Timer(const Duration(seconds: 1), () {
+ // Pause the reporter while we print to ensure that we don't interfere
+ // with its output.
+ _reporter.pause();
+ print('Waiting for current test(s) to finish.');
+ print('Press Control-C again to terminate immediately.');
+ _reporter.resume();
+ });
+ }
+
+ await _debugOperation?.cancel();
+ await _suiteSubscription?.cancel();
+
+ _suiteSubscription = null;
+
+ // Make sure we close the engine *before* the loader. Otherwise,
+ // LoadSuites provided by the loader may get into bad states.
+ //
+ // We close the loader's browsers while we're closing the engine because
+ // browser tests don't store any state we care about and we want them to
+ // shut down without waiting for their tear-downs.
+ await Future.wait([_loader.closeEphemeral(), _engine.close()]);
+ timer?.cancel();
+ await _loader.close();
+
+ // Flush any IOSinks created for file reporters.
+ await Future.wait(_sinks.map((s) => s.flush().then((_) => s.close())));
+ _sinks.clear();
+ });
+
+ /// Return a stream of [LoadSuite]s in [_config.testSelections].
+ ///
+ /// Only tests that match [_config.patterns] will be included in the
+ /// suites once they're loaded.
+ Stream<LoadSuite> _loadSuites() {
+ return StreamGroup.merge(_config.testSelections.entries.map((pathEntry) {
+ final testPath = pathEntry.key;
+ final testSelections = pathEntry.value;
+ final suiteConfig = _config.suiteDefaults.selectTests(testSelections);
+ if (Directory(testPath).existsSync()) {
+ return _loader.loadDir(testPath, suiteConfig);
+ } else if (File(testPath).existsSync()) {
+ return _loader.loadFile(testPath, suiteConfig);
+ } else {
+ return Stream.fromIterable([
+ LoadSuite.forLoadException(
+ LoadException(testPath, 'Does not exist.'),
+ suiteConfig,
+ ),
+ ]);
+ }
+ })).map((loadSuite) {
+ return loadSuite.changeSuite((suite) {
+ _warnForUnknownTags(suite);
+
+ return _shardSuite(suite.filter((test) {
+ // Skip any tests that don't match all the global patterns.
+ if (!_config.globalPatterns
+ .every((pattern) => test.name.contains(pattern))) {
+ return false;
+ }
+
+ // If the user provided tags, skip tests that don't match all of them.
+ if (!_config.includeTags.evaluate(test.metadata.tags.contains)) {
+ return false;
+ }
+
+ // Skip tests that do match any tags the user wants to exclude.
+ if (_config.excludeTags.evaluate(test.metadata.tags.contains)) {
+ return false;
+ }
+
+ final testSelections = suite.config.testSelections;
+ assert(testSelections.isNotEmpty, 'Tests should have been selected');
+ return testSelections.any((selection) {
+ // Skip tests that don't match all the suite specific patterns.
+ if (!selection.testPatterns
+ .every((pattern) => test.name.contains(pattern))) {
+ return false;
+ }
+ // Skip tests that don't start on `line` or `col` if specified.
+ var line = selection.line;
+ var col = selection.col;
+ if (line == null && col == null) return true;
+ var trace = test.trace;
+ if (trace == null) {
+ throw StateError(
+ 'Cannot filter by line/column for this test suite, no stack'
+ 'trace available.');
+ }
+ var path = suite.path;
+ if (path == null) {
+ throw StateError(
+ 'Cannot filter by line/column for this test suite, no suite'
+ 'path available.');
+ }
+ // The absolute path as it will appear in stack traces.
+ var absoluteSuitePath = File(path).absolute.uri.toFilePath();
+
+ bool matchLineAndCol(Frame frame) {
+ switch (frame.uri.scheme) {
+ case 'file':
+ if (frame.uri.toFilePath() != absoluteSuitePath) {
+ return false;
+ }
+ case 'package':
+ // It is unlikely that the test case is specified in a
+ // package: URI. Ignore this case.
+ return false;
+ default:
+ // Now we can assume that the kernel is compiled using
+ // --filesystem-scheme.
+ // In this case, because we don't know the --filesystem-root, as
+ // long as the file path matches we assume it is the same file.
+ if (!absoluteSuitePath.endsWith(frame.uri.path)) {
+ return false;
+ }
+ }
+ if (line != null && frame.line != line) {
+ return false;
+ }
+ if (col != null && frame.column != col) {
+ return false;
+ }
+ return true;
+ }
+
+ return trace.frames.any(matchLineAndCol);
+ });
+ }));
+ });
+ });
+ }
+
+ /// Prints a warning for any unknown tags referenced in [suite] or its
+ /// children.
+ void _warnForUnknownTags(Suite suite) {
+ if (_tagWarningSuites.contains(suite.path)) return;
+ _tagWarningSuites.add(suite.path!);
+
+ var unknownTags = _collectUnknownTags(suite);
+ if (unknownTags.isEmpty) return;
+
+ var yellow = _config.color ? '\u001b[33m' : '';
+ var bold = _config.color ? '\u001b[1m' : '';
+ var noColor = _config.color ? '\u001b[0m' : '';
+
+ var buffer = StringBuffer()
+ ..write('${yellow}Warning:$noColor ')
+ ..write(unknownTags.length == 1 ? 'A tag was ' : 'Tags were ')
+ ..write('used that ')
+ ..write(unknownTags.length == 1 ? "wasn't " : "weren't ")
+ ..writeln('specified in dart_test.yaml.');
+
+ unknownTags.forEach((tag, entries) {
+ buffer.write(' $bold$tag$noColor was used in');
+
+ if (entries.length == 1) {
+ buffer.writeln(' ${_entryDescription(entries.single)}');
+ return;
+ }
+
+ buffer.write(':');
+ for (var entry in entries) {
+ buffer.write('\n ${_entryDescription(entry)}');
+ }
+ buffer.writeln();
+ });
+
+ print(buffer.toString());
+ }
+
+ /// Collects all tags used by [suite] or its children that aren't also passed
+ /// on the command line.
+ ///
+ /// This returns a map from tag names to lists of entries that use those tags.
+ Map<String, List<GroupEntry>> _collectUnknownTags(Suite suite) {
+ var unknownTags = <String, List<GroupEntry>>{};
+ var currentTags = <String>{};
+
+ void collect(GroupEntry entry) {
+ var newTags = <String>{};
+ for (var unknownTag
+ in entry.metadata.tags.difference(_config.knownTags)) {
+ if (currentTags.contains(unknownTag)) continue;
+ unknownTags.putIfAbsent(unknownTag, () => []).add(entry);
+ newTags.add(unknownTag);
+ }
+
+ if (entry is! Group) return;
+
+ currentTags.addAll(newTags);
+ for (var child in entry.entries) {
+ collect(child);
+ }
+ currentTags.removeAll(newTags);
+ }
+
+ collect(suite.group);
+ return unknownTags;
+ }
+
+ /// Returns a human-readable description of [entry], including its type.
+ String _entryDescription(GroupEntry entry) {
+ if (entry is Test) return 'the test "${entry.name}"';
+ if (entry.name.isNotEmpty) return 'the group "${entry.name}"';
+ return 'the suite itself';
+ }
+
+ /// If sharding is enabled, filters [suite] to only include the tests that
+ /// should be run in this shard.
+ ///
+ /// We just take a slice of the tests in each suite corresponding to the shard
+ /// index. This makes the tests pretty tests across shards, and since the
+ /// tests are continuous, makes us more likely to be able to re-use
+ /// `setUpAll()` logic.
+ RunnerSuite _shardSuite(RunnerSuite suite) {
+ if (_config.totalShards == null) return suite;
+
+ var shardSize = suite.group.testCount / _config.totalShards!;
+ var shardIndex = _config.shardIndex!;
+ var shardStart = (shardSize * shardIndex).round();
+ var shardEnd = (shardSize * (shardIndex + 1)).round();
+
+ var count = -1;
+ var filtered = suite.filter((test) {
+ count++;
+ return count >= shardStart && count < shardEnd;
+ });
+
+ return filtered;
+ }
+
+ /// Loads each suite in [suites] in order, pausing after load for runtimes
+ /// that support debugging.
+ Future<bool> _loadThenPause(Stream<LoadSuite> suites) async {
+ var subscription = _suiteSubscription = suites.asyncMap((loadSuite) async {
+ var operation = _debugOperation = debug(_engine, _reporter, loadSuite);
+ await operation.valueOrCancellation();
+ }).listen(null);
+
+ var results = await Future.wait(<Future>[
+ subscription.asFuture<void>().then((_) => _engine.suiteSink.close()),
+ _engine.run()
+ ], eagerError: true);
+ return results.last as bool;
+ }
+}
diff --git a/pkgs/test_core/lib/src/runner/application_exception.dart b/pkgs/test_core/lib/src/runner/application_exception.dart
new file mode 100644
index 0000000..23155a2
--- /dev/null
+++ b/pkgs/test_core/lib/src/runner/application_exception.dart
@@ -0,0 +1,13 @@
+// Copyright (c) 2015, 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.
+
+/// An expected exception caused by user-controllable circumstances.
+class ApplicationException implements Exception {
+ final String message;
+
+ ApplicationException(this.message);
+
+ @override
+ String toString() => message;
+}
diff --git a/pkgs/test_core/lib/src/runner/compiler_pool.dart b/pkgs/test_core/lib/src/runner/compiler_pool.dart
new file mode 100644
index 0000000..52aa238
--- /dev/null
+++ b/pkgs/test_core/lib/src/runner/compiler_pool.dart
@@ -0,0 +1,57 @@
+// Copyright (c) 2015, 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:async/async.dart';
+import 'package:meta/meta.dart';
+import 'package:pool/pool.dart';
+
+import 'configuration.dart';
+import 'suite.dart';
+
+/// A pool of compiler instances.
+///
+/// This limits the number of compiler instances running concurrently.
+abstract class CompilerPool {
+ /// The test runner configuration.
+ final config = Configuration.current;
+
+ /// The internal pool that controls the number of process running at once.
+ final Pool _pool;
+
+ /// Whether [close] has been called.
+ bool get closed => _closeMemo.hasRun;
+
+ /// The memoizer for running [close] exactly once.
+ final _closeMemo = AsyncMemoizer<void>();
+
+ /// Creates a compiler pool that multiple instances of a compiler at once.
+ CompilerPool() : _pool = Pool(Configuration.current.concurrency);
+
+ /// Compiles [code] to [path] using [_pool] and [compileInternal].
+ ///
+ /// Should not be overridden.
+ Future<void> compile(
+ String code, String path, SuiteConfiguration suiteConfig) =>
+ _pool.withResource(() {
+ if (closed) return null;
+ return compileInternal(code, path, suiteConfig);
+ });
+
+ /// The actual function a given compiler pool should implement to compile a
+ /// suite.
+ @protected
+ Future<void> compileInternal(
+ String code, String path, SuiteConfiguration suiteConfig);
+
+ /// Shuts down the compiler pool, invoking `closeInternal` exactly once.
+ ///
+ /// Should not be overridden.
+ Future<void> close() => _closeMemo.runOnce(closeInternal);
+
+ /// The actual function to shut down the compiler pool, invoked exactly once.
+ @protected
+ Future<void> closeInternal();
+}
diff --git a/pkgs/test_core/lib/src/runner/compiler_selection.dart b/pkgs/test_core/lib/src/runner/compiler_selection.dart
new file mode 100644
index 0000000..70ab553
--- /dev/null
+++ b/pkgs/test_core/lib/src/runner/compiler_selection.dart
@@ -0,0 +1,61 @@
+// 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 'package:source_span/source_span.dart';
+import 'package:test_api/backend.dart';
+
+/// A compiler with which the user has chosen to run tests.
+class CompilerSelection {
+ /// The chosen compiler to use.
+ final Compiler compiler;
+
+ /// The location in the configuration file of this compiler string, or `null`
+ /// if it was defined outside a configuration file (for example, on the
+ /// command line).
+ final SourceSpan? span;
+
+ /// The platform selector for which platforms this compiler should apply to,
+ /// if specified. Defaults to all platforms where the compiler is supported.
+ final PlatformSelector? platformSelector;
+
+ CompilerSelection(String compiler,
+ {required this.platformSelector, required this.span})
+ : compiler = Compiler.builtIn.firstWhere((c) => c.identifier == compiler);
+
+ factory CompilerSelection.parse(String option, {SourceSpan? parentSpan}) {
+ var parts = option.split(':');
+ switch (parts.length) {
+ case 1:
+ _checkValidCompiler(option, parentSpan);
+ return CompilerSelection(option,
+ platformSelector: null, span: parentSpan);
+ case 2:
+ var compiler = parts[1];
+ _checkValidCompiler(compiler, parentSpan);
+ return CompilerSelection(compiler,
+ platformSelector: PlatformSelector.parse(parts[0]),
+ span: parentSpan);
+ default:
+ throw ArgumentError.value(
+ option,
+ '--compiler',
+ 'Must be of the format [<boolean-selector>:]<compiler>, but got '
+ 'more than one `:`.');
+ }
+ }
+
+ @override
+ bool operator ==(Object other) =>
+ other is CompilerSelection && other.compiler == compiler;
+
+ @override
+ int get hashCode => compiler.hashCode;
+}
+
+void _checkValidCompiler(String compiler, SourceSpan? span) {
+ if (Compiler.builtIn.any((c) => c.identifier == compiler)) return;
+ throw SourceSpanFormatException(
+ 'Invalid compiler `$compiler`, must be one of ${Compiler.builtIn.map((c) => c.identifier).join(', ')}',
+ span);
+}
diff --git a/pkgs/test_core/lib/src/runner/configuration.dart b/pkgs/test_core/lib/src/runner/configuration.dart
new file mode 100644
index 0000000..8ba4aa8
--- /dev/null
+++ b/pkgs/test_core/lib/src/runner/configuration.dart
@@ -0,0 +1,1088 @@
+// Copyright (c) 2015, 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 'dart:io';
+
+import 'package:boolean_selector/boolean_selector.dart';
+import 'package:collection/collection.dart';
+import 'package:glob/glob.dart';
+import 'package:path/path.dart' as p;
+import 'package:source_span/source_span.dart';
+import 'package:test_api/scaffolding.dart' show Timeout;
+import 'package:test_api/src/backend/platform_selector.dart'; // ignore: implementation_imports
+import 'package:test_api/src/backend/runtime.dart'; // ignore: implementation_imports
+
+import '../util/io.dart';
+import 'compiler_selection.dart';
+import 'configuration/args.dart' as args;
+import 'configuration/custom_runtime.dart';
+import 'configuration/load.dart';
+import 'configuration/reporters.dart';
+import 'configuration/runtime_settings.dart';
+import 'configuration/utils.dart';
+import 'configuration/values.dart';
+import 'runtime_selection.dart';
+import 'suite.dart';
+
+export 'suite.dart' show TestSelection;
+
+/// The key used to look up [Configuration.current] in a zone.
+final _currentKey = Object();
+
+/// A class that encapsulates the command-line configuration of the test runner.
+class Configuration {
+ /// An empty configuration with only default values.
+ ///
+ /// Using this is slightly more efficient than manually constructing a new
+ /// configuration with no arguments.
+ static final empty = Configuration._unsafe();
+
+ /// The usage string for the command-line arguments.
+ static String get usage => args.usage;
+
+ /// Whether `--help` was passed.
+ bool get help => _help ?? false;
+ final bool? _help;
+
+ /// Custom HTML template file.
+ final String? customHtmlTemplatePath;
+
+ /// Whether `--version` was passed.
+ bool get version => _version ?? false;
+ final bool? _version;
+
+ /// Whether to pause for debugging after loading each test suite.
+ bool get pauseAfterLoad => _pauseAfterLoad ?? false;
+ final bool? _pauseAfterLoad;
+
+ /// Whether to run browsers in their respective debug modes
+ bool get debug => pauseAfterLoad || (_debug ?? false) || coverage != null;
+ final bool? _debug;
+
+ /// The output folder for coverage gathering
+ final String? coverage;
+
+ /// The path to the file from which to load more configuration information.
+ ///
+ /// This is *not* resolved automatically.
+ String get configurationPath => _configurationPath ?? 'dart_test.yaml';
+ final String? _configurationPath;
+
+ /// The name of the reporter to use to display results.
+ String get reporter => _reporter ?? defaultReporter;
+ final String? _reporter;
+
+ /// The map of file reporters where the key is the name of the reporter and
+ /// the value is the filepath to which its output should be written.
+ final Map<String, String> fileReporters;
+
+ /// Whether to disable retries of tests.
+ bool get noRetry => _noRetry ?? false;
+ final bool? _noRetry;
+
+ /// Whether to use command-line color escapes.
+ bool get color => _color ?? canUseSpecialChars;
+ final bool? _color;
+
+ /// How many tests to run concurrently.
+ int get concurrency =>
+ pauseAfterLoad ? 1 : (_concurrency ?? defaultConcurrency);
+ final int? _concurrency;
+
+ /// The index of the current shard, if sharding is in use, or `null` if it's
+ /// not.
+ ///
+ /// Sharding is a technique that allows the Google internal test framework to
+ /// easily split a test run across multiple workers without requiring the
+ /// tests to be modified by the user. When sharding is in use, the runner gets
+ /// a shard index (this field) and a total number of shards, and is expected
+ /// to provide the following guarantees:
+ ///
+ /// * Running the same invocation of the runner, with the same shard index and
+ /// total shards, will run the same set of tests.
+ /// * Across all shards, each test must be run exactly once.
+ ///
+ /// In addition, tests should be balanced across shards as much as possible.
+ final int? shardIndex;
+
+ /// The total number of shards, if sharding is in use, or `null` if it's not.
+ ///
+ /// See [shardIndex] for details.
+ final int? totalShards;
+
+ /// The list of packages to fold when producing [StackTrace]s.
+ Set<String> get foldTraceExcept => _foldTraceExcept ?? {};
+ final Set<String>? _foldTraceExcept;
+
+ /// If non-empty, all packages not in this list will be folded when producing
+ /// [StackTrace]s.
+ Set<String> get foldTraceOnly => _foldTraceOnly ?? {};
+ final Set<String>? _foldTraceOnly;
+
+ /// The paths from which to load tests, and the test cases to run.
+ Map<String, Set<TestSelection>> get testSelections =>
+ _testSelections ??
+ const {
+ 'test': {TestSelection()}
+ };
+ final Map<String, Set<TestSelection>>? _testSelections;
+
+ /// Whether the load paths were passed explicitly or the default was used.
+ bool get explicitPaths => _testSelections != null;
+
+ /// The glob matching the basename of tests to run.
+ ///
+ /// This is used to find tests within a directory.
+ Glob get filename => _filename ?? defaultFilename;
+ final Glob? _filename;
+
+ /// The set of presets to use.
+ ///
+ /// Any chosen presets for the parent configuration are added to the chosen
+ /// preset sets for child configurations as well.
+ ///
+ /// Note that the order of this set matters.
+ final Set<String> chosenPresets;
+
+ /// The set of tags that have been declared in any way in this configuration.
+ late final Set<String> knownTags = UnmodifiableSetView({
+ ...includeTags.variables,
+ ...excludeTags.variables,
+ ...suiteDefaults.knownTags,
+ for (var configuration in presets.values) ...configuration.knownTags
+ });
+
+ /// Only run tests whose tags match this selector.
+ ///
+ /// When [merge]d, this is intersected with the other configuration's included
+ /// tags.
+ final BooleanSelector includeTags;
+
+ /// Do not run tests whose tags match this selector.
+ ///
+ /// When [merge]d, this is unioned with the other configuration's
+ /// excluded tags.
+ final BooleanSelector excludeTags;
+
+ /// Configuration presets.
+ ///
+ /// These are configurations that can be explicitly selected by the user via
+ /// the command line. Preset configuration takes precedence over the base
+ /// configuration.
+ ///
+ /// This is guaranteed not to have any keys that match [chosenPresets]; those
+ /// are resolved when the configuration is constructed.
+ final Map<String, Configuration> presets;
+
+ /// All preset names that are known to be valid.
+ ///
+ /// This includes presets that have already been resolved.
+ Set<String> get knownPresets => _knownPresets ??= UnmodifiableSetView({
+ ...presets.keys,
+ for (var configuration in presets.values) ...configuration.knownPresets
+ });
+ Set<String>? _knownPresets;
+
+ /// Built-in runtimes whose settings are overridden by the user.
+ final Map<String, RuntimeSettings> overrideRuntimes;
+
+ /// Runtimes defined by the user in terms of existing runtimes.
+ final Map<String, CustomRuntime> defineRuntimes;
+
+ /// The default suite-level configuration.
+ final SuiteConfiguration suiteDefaults;
+
+ /// The set of patterns to check test names against in all suites that run.
+ final Set<Pattern> globalPatterns;
+
+ /// The seed used to generate randomness for test case shuffling.
+ ///
+ /// If null or zero no shuffling will occur.
+ /// The same seed will shuffle the tests in the same way every time.
+ final int? testRandomizeOrderingSeed;
+
+ final bool? _stopOnFirstFailure;
+
+ /// Whether to stop running subsequent tests after a test fails.
+ bool get stopOnFirstFailure => _stopOnFirstFailure ?? false;
+
+ /// Returns the current configuration, or a default configuration if no
+ /// current configuration is set.
+ ///
+ /// The current configuration is set using [asCurrent].
+ static Configuration get current =>
+ Zone.current[_currentKey] as Configuration? ?? Configuration._unsafe();
+
+ /// Parses the configuration from [args].
+ ///
+ /// Throws a [FormatException] if [args] are invalid.
+ factory Configuration.parse(List<String> arguments) => args.parse(arguments);
+
+ /// Loads configuration from [path].
+ ///
+ /// If [global] is `true`, this restricts the configuration to rules that are
+ /// supported globally.
+ ///
+ /// Throws an [IOException] if [path] does not exist or cannot be read. Throws
+ /// a [FormatException] if the file contents are invalid.
+ factory Configuration.load(String path, {bool global = false}) {
+ final content = File(path).readAsStringSync();
+ final sourceUrl = p.toUri(path);
+ return parse(content, global: global, sourceUrl: sourceUrl);
+ }
+
+ /// Parses configuration from YAML formatted [content].
+ ///
+ /// If [global] is `true`, this restricts the configuration to rules that are
+ /// supported globally.
+ ///
+ /// If [sourceUrl] is provided it will be set as the source url for the yaml
+ /// document.
+ ///
+ /// Throws a [FormatException] if the content is invalid.
+ factory Configuration.loadFromString(String content,
+ {bool global = false, Uri? sourceUrl}) =>
+ parse(content, global: global, sourceUrl: sourceUrl);
+
+ factory Configuration(
+ {required bool? help,
+ required String? customHtmlTemplatePath,
+ required bool? version,
+ required bool? pauseAfterLoad,
+ required bool? debug,
+ required bool? color,
+ required String? configurationPath,
+ required String? reporter,
+ required Map<String, String>? fileReporters,
+ required String? coverage,
+ required int? concurrency,
+ required int? shardIndex,
+ required int? totalShards,
+ required Map<String, Set<TestSelection>>? testSelections,
+ required Iterable<String>? foldTraceExcept,
+ required Iterable<String>? foldTraceOnly,
+ required Glob? filename,
+ required Iterable<String>? chosenPresets,
+ required Map<String, Configuration>? presets,
+ required Map<String, RuntimeSettings>? overrideRuntimes,
+ required Map<String, CustomRuntime>? defineRuntimes,
+ required bool? noRetry,
+ required int? testRandomizeOrderingSeed,
+ required bool? stopOnFirstFailure,
+
+ // Suite-level configuration
+ required bool? allowDuplicateTestNames,
+ required bool? allowTestRandomization,
+ required bool? jsTrace,
+ required bool? runSkipped,
+ required Iterable<String>? dart2jsArgs,
+ required String? precompiledPath,
+ required Iterable<Pattern>? globalPatterns,
+ required Iterable<CompilerSelection>? compilerSelections,
+ required Iterable<RuntimeSelection>? runtimes,
+ required BooleanSelector? includeTags,
+ required BooleanSelector? excludeTags,
+ required Map<BooleanSelector, SuiteConfiguration>? tags,
+ required Map<PlatformSelector, SuiteConfiguration>? onPlatform,
+ required bool? ignoreTimeouts,
+
+ // Test-level configuration
+ required Timeout? timeout,
+ required bool? verboseTrace,
+ required bool? chainStackTraces,
+ required bool? skip,
+ required int? retry,
+ required String? skipReason,
+ required PlatformSelector? testOn,
+ required Iterable<String>? addTags}) {
+ var chosenPresetSet = chosenPresets?.toSet();
+ var configuration = Configuration._(
+ help: help,
+ customHtmlTemplatePath: customHtmlTemplatePath,
+ version: version,
+ pauseAfterLoad: pauseAfterLoad,
+ debug: debug,
+ color: color,
+ configurationPath: configurationPath,
+ reporter: reporter,
+ fileReporters: fileReporters,
+ coverage: coverage,
+ concurrency: concurrency,
+ shardIndex: shardIndex,
+ totalShards: totalShards,
+ testSelections: testSelections,
+ foldTraceExcept: foldTraceExcept,
+ foldTraceOnly: foldTraceOnly,
+ filename: filename,
+ chosenPresets: chosenPresetSet,
+ presets: _withChosenPresets(presets, chosenPresetSet),
+ overrideRuntimes: overrideRuntimes,
+ defineRuntimes: defineRuntimes,
+ noRetry: noRetry,
+ testRandomizeOrderingSeed: testRandomizeOrderingSeed,
+ stopOnFirstFailure: stopOnFirstFailure,
+ includeTags: includeTags,
+ excludeTags: excludeTags,
+ globalPatterns: globalPatterns,
+ suiteDefaults: SuiteConfiguration(
+ allowDuplicateTestNames: allowDuplicateTestNames,
+ allowTestRandomization: allowTestRandomization,
+ jsTrace: jsTrace,
+ runSkipped: runSkipped,
+ dart2jsArgs: dart2jsArgs,
+ precompiledPath: precompiledPath,
+ compilerSelections: compilerSelections,
+ runtimes: runtimes,
+ tags: tags,
+ onPlatform: onPlatform,
+ ignoreTimeouts: ignoreTimeouts,
+
+ // Test-level configuration
+ timeout: timeout,
+ verboseTrace: verboseTrace,
+ chainStackTraces: chainStackTraces,
+ skip: skip,
+ retry: retry,
+ skipReason: skipReason,
+ testOn: testOn,
+ addTags: addTags));
+ return configuration._resolvePresets();
+ }
+
+ /// A constructor that doesn't require all of its options to be passed.
+ ///
+ /// This should only be used in situations where you really only want to
+ /// configure a specific restricted set of options.
+ factory Configuration._unsafe(
+ {bool? help,
+ String? customHtmlTemplatePath,
+ bool? version,
+ bool? pauseAfterLoad,
+ bool? debug,
+ bool? color,
+ String? configurationPath,
+ String? reporter,
+ Map<String, String>? fileReporters,
+ String? coverage,
+ int? concurrency,
+ int? shardIndex,
+ int? totalShards,
+ Map<String, Set<TestSelection>>? testSelections,
+ Iterable<String>? foldTraceExcept,
+ Iterable<String>? foldTraceOnly,
+ Glob? filename,
+ Iterable<String>? chosenPresets,
+ Map<String, Configuration>? presets,
+ Map<String, RuntimeSettings>? overrideRuntimes,
+ Map<String, CustomRuntime>? defineRuntimes,
+ bool? noRetry,
+ int? testRandomizeOrderingSeed,
+ bool? stopOnFirstFailure,
+
+ // Suite-level configuration
+ bool? allowDuplicateTestNames,
+ bool? allowTestRandomization,
+ bool? jsTrace,
+ bool? runSkipped,
+ Iterable<String>? dart2jsArgs,
+ String? precompiledPath,
+ Iterable<Pattern>? globalPatterns,
+ Iterable<CompilerSelection>? compilerSelections,
+ Iterable<RuntimeSelection>? runtimes,
+ BooleanSelector? includeTags,
+ BooleanSelector? excludeTags,
+ Map<BooleanSelector, SuiteConfiguration>? tags,
+ Map<PlatformSelector, SuiteConfiguration>? onPlatform,
+ bool? ignoreTimeouts,
+
+ // Test-level configuration
+ Timeout? timeout,
+ bool? verboseTrace,
+ bool? chainStackTraces,
+ bool? skip,
+ int? retry,
+ String? skipReason,
+ PlatformSelector? testOn,
+ Iterable<String>? addTags}) =>
+ Configuration(
+ help: help,
+ customHtmlTemplatePath: customHtmlTemplatePath,
+ version: version,
+ pauseAfterLoad: pauseAfterLoad,
+ debug: debug,
+ color: color,
+ configurationPath: configurationPath,
+ reporter: reporter,
+ fileReporters: fileReporters,
+ coverage: coverage,
+ concurrency: concurrency,
+ shardIndex: shardIndex,
+ totalShards: totalShards,
+ testSelections: testSelections,
+ foldTraceExcept: foldTraceExcept,
+ foldTraceOnly: foldTraceOnly,
+ filename: filename,
+ chosenPresets: chosenPresets,
+ presets: presets,
+ overrideRuntimes: overrideRuntimes,
+ defineRuntimes: defineRuntimes,
+ noRetry: noRetry,
+ testRandomizeOrderingSeed: testRandomizeOrderingSeed,
+ stopOnFirstFailure: stopOnFirstFailure,
+ allowDuplicateTestNames: allowDuplicateTestNames,
+ allowTestRandomization: allowTestRandomization,
+ jsTrace: jsTrace,
+ runSkipped: runSkipped,
+ dart2jsArgs: dart2jsArgs,
+ precompiledPath: precompiledPath,
+ globalPatterns: globalPatterns,
+ compilerSelections: compilerSelections,
+ runtimes: runtimes,
+ includeTags: includeTags,
+ excludeTags: excludeTags,
+ tags: tags,
+ onPlatform: onPlatform,
+ ignoreTimeouts: ignoreTimeouts,
+ timeout: timeout,
+ verboseTrace: verboseTrace,
+ chainStackTraces: chainStackTraces,
+ skip: skip,
+ retry: retry,
+ skipReason: skipReason,
+ testOn: testOn,
+ addTags: addTags);
+
+ /// Suite level configuration allowed in the global test config file.
+ ///
+ /// This is per-user configuration and should be limited as such, it should
+ /// not contain options that would change the pass/fail result of any given
+ /// test, or change which tests would run.
+ factory Configuration.globalTest({
+ required bool? verboseTrace,
+ required bool? jsTrace,
+ required Timeout? timeout,
+ required Map<String, Configuration>? presets,
+ required bool? chainStackTraces,
+ required Iterable<String>? foldTraceExcept,
+ required Iterable<String>? foldTraceOnly,
+ }) =>
+ Configuration(
+ foldTraceExcept: foldTraceExcept,
+ foldTraceOnly: foldTraceOnly,
+ jsTrace: jsTrace,
+ timeout: timeout,
+ verboseTrace: verboseTrace,
+ chainStackTraces: chainStackTraces,
+ help: null,
+ customHtmlTemplatePath: null,
+ version: null,
+ pauseAfterLoad: null,
+ debug: null,
+ color: null,
+ configurationPath: null,
+ reporter: null,
+ fileReporters: null,
+ coverage: null,
+ concurrency: null,
+ shardIndex: null,
+ totalShards: null,
+ testSelections: null,
+ filename: null,
+ chosenPresets: null,
+ presets: presets,
+ overrideRuntimes: null,
+ defineRuntimes: null,
+ noRetry: null,
+ testRandomizeOrderingSeed: null,
+ stopOnFirstFailure: null,
+ ignoreTimeouts: null,
+ allowDuplicateTestNames: null,
+ allowTestRandomization: null,
+ runSkipped: null,
+ dart2jsArgs: null,
+ precompiledPath: null,
+ globalPatterns: null,
+ compilerSelections: null,
+ runtimes: null,
+ includeTags: null,
+ excludeTags: null,
+ tags: null,
+ onPlatform: null,
+ skip: null,
+ retry: null,
+ skipReason: null,
+ testOn: null,
+ addTags: null,
+ );
+
+ /// Suite level configuration that is not allowed in the global test
+ /// config file.
+ ///
+ /// This configuration may alter the pass/fail result of a test run, and thus
+ /// should only be configured per package and not at the global level (global
+ /// config is user specific).
+ factory Configuration.localTest({
+ required bool? skip,
+ required int? retry,
+ required String? skipReason,
+ required PlatformSelector? testOn,
+ required Iterable<String>? addTags,
+ required bool? allowDuplicateTestNames,
+ required bool? allowTestRandomization,
+ }) =>
+ Configuration(
+ allowDuplicateTestNames: allowDuplicateTestNames,
+ allowTestRandomization: allowTestRandomization,
+ skip: skip,
+ retry: retry,
+ skipReason: skipReason,
+ testOn: testOn,
+ addTags: addTags,
+ help: null,
+ customHtmlTemplatePath: null,
+ version: null,
+ pauseAfterLoad: null,
+ debug: null,
+ color: null,
+ configurationPath: null,
+ reporter: null,
+ fileReporters: null,
+ coverage: null,
+ concurrency: null,
+ shardIndex: null,
+ totalShards: null,
+ testSelections: null,
+ foldTraceExcept: null,
+ foldTraceOnly: null,
+ filename: null,
+ chosenPresets: null,
+ presets: null,
+ overrideRuntimes: null,
+ defineRuntimes: null,
+ noRetry: null,
+ testRandomizeOrderingSeed: null,
+ stopOnFirstFailure: null,
+ jsTrace: null,
+ runSkipped: null,
+ dart2jsArgs: null,
+ precompiledPath: null,
+ globalPatterns: null,
+ compilerSelections: null,
+ runtimes: null,
+ includeTags: null,
+ excludeTags: null,
+ tags: null,
+ onPlatform: null,
+ ignoreTimeouts: null,
+ timeout: null,
+ verboseTrace: null,
+ chainStackTraces: null,
+ );
+
+ /// Runner configuration that is allowed in the global test config file.
+ ///
+ /// This is per-user configuration and should be limited as such, it should
+ /// not contain options that would change the pass/fail result of any given
+ /// test, or change which tests would run.
+ ///
+ /// Note that [customHtmlTemplatePath] violates this rule, and really should
+ /// not be configurable globally.
+ factory Configuration.globalRunner(
+ {required bool? pauseAfterLoad,
+ required String? customHtmlTemplatePath,
+ required bool? runSkipped,
+ required String? reporter,
+ required Map<String, String>? fileReporters,
+ required int? concurrency,
+ required Iterable<CompilerSelection>? compilerSelections,
+ required Iterable<RuntimeSelection>? runtimes,
+ required Iterable<String>? chosenPresets,
+ required Map<String, RuntimeSettings>? overrideRuntimes}) =>
+ Configuration(
+ customHtmlTemplatePath: customHtmlTemplatePath,
+ pauseAfterLoad: pauseAfterLoad,
+ runSkipped: runSkipped,
+ reporter: reporter,
+ fileReporters: fileReporters,
+ concurrency: concurrency,
+ compilerSelections: compilerSelections,
+ runtimes: runtimes,
+ chosenPresets: chosenPresets,
+ overrideRuntimes: overrideRuntimes,
+ help: null,
+ version: null,
+ debug: null,
+ color: null,
+ configurationPath: null,
+ coverage: null,
+ shardIndex: null,
+ totalShards: null,
+ testSelections: null,
+ foldTraceExcept: null,
+ foldTraceOnly: null,
+ filename: null,
+ presets: null,
+ defineRuntimes: null,
+ noRetry: null,
+ testRandomizeOrderingSeed: null,
+ stopOnFirstFailure: null,
+ allowDuplicateTestNames: null,
+ allowTestRandomization: null,
+ jsTrace: null,
+ dart2jsArgs: null,
+ precompiledPath: null,
+ globalPatterns: null,
+ includeTags: null,
+ excludeTags: null,
+ tags: null,
+ onPlatform: null,
+ ignoreTimeouts: null,
+ timeout: null,
+ verboseTrace: null,
+ chainStackTraces: null,
+ skip: null,
+ retry: null,
+ skipReason: null,
+ testOn: null,
+ addTags: null,
+ );
+
+ /// Runner configuration that is not allowed in the global test config file.
+ ///
+ /// This configuration may alter the pass/fail result of a test run, and thus
+ /// should only be configured per package and not at the global level (global
+ /// config is user specific).
+ factory Configuration.localRunner(
+ {required Iterable<Pattern>? globalPatterns,
+ required Map<String, Set<TestSelection>>? testSelections,
+ required Glob? filename,
+ required BooleanSelector? includeTags,
+ required BooleanSelector? excludeTags,
+ required Map<String, CustomRuntime>? defineRuntimes}) =>
+ Configuration(
+ globalPatterns: globalPatterns,
+ testSelections: testSelections,
+ filename: filename,
+ includeTags: includeTags,
+ excludeTags: excludeTags,
+ defineRuntimes: defineRuntimes,
+ help: null,
+ customHtmlTemplatePath: null,
+ version: null,
+ pauseAfterLoad: null,
+ debug: null,
+ color: null,
+ configurationPath: null,
+ reporter: null,
+ fileReporters: null,
+ coverage: null,
+ concurrency: null,
+ shardIndex: null,
+ totalShards: null,
+ foldTraceExcept: null,
+ foldTraceOnly: null,
+ chosenPresets: null,
+ presets: null,
+ overrideRuntimes: null,
+ noRetry: null,
+ testRandomizeOrderingSeed: null,
+ stopOnFirstFailure: null,
+ allowDuplicateTestNames: null,
+ allowTestRandomization: null,
+ jsTrace: null,
+ runSkipped: null,
+ dart2jsArgs: null,
+ precompiledPath: null,
+ compilerSelections: null,
+ runtimes: null,
+ tags: null,
+ onPlatform: null,
+ ignoreTimeouts: null,
+ timeout: null,
+ verboseTrace: null,
+ chainStackTraces: null,
+ skip: null,
+ retry: null,
+ skipReason: null,
+ testOn: null,
+ addTags: null);
+
+ /// A specialized constructor for configuring only `onPlatform`.
+ factory Configuration.onPlatform(
+ Map<PlatformSelector, SuiteConfiguration> onPlatform) =>
+ Configuration._unsafe(onPlatform: onPlatform);
+
+ factory Configuration.tags(Map<BooleanSelector, SuiteConfiguration> tags) =>
+ Configuration._unsafe(tags: tags);
+
+ static Map<String, Configuration>? _withChosenPresets(
+ Map<String, Configuration>? map, Set<String>? chosenPresets) {
+ if (map == null || chosenPresets == null) return map;
+ return map.map((key, config) => MapEntry(
+ key,
+ config.change(
+ chosenPresets: config.chosenPresets.union(chosenPresets))));
+ }
+
+ /// Creates new Configuration.
+ ///
+ /// Unlike [Configuration.new], this assumes [presets] is already resolved.
+ Configuration._(
+ {required bool? help,
+ required this.customHtmlTemplatePath,
+ required bool? version,
+ required bool? pauseAfterLoad,
+ required bool? debug,
+ required bool? color,
+ required String? configurationPath,
+ required String? reporter,
+ required Map<String, String>? fileReporters,
+ required this.coverage,
+ required int? concurrency,
+ required this.shardIndex,
+ required this.totalShards,
+ required Map<String, Set<TestSelection>>? testSelections,
+ required Iterable<String>? foldTraceExcept,
+ required Iterable<String>? foldTraceOnly,
+ required Glob? filename,
+ required Iterable<String>? chosenPresets,
+ required Map<String, Configuration>? presets,
+ required Map<String, RuntimeSettings>? overrideRuntimes,
+ required Map<String, CustomRuntime>? defineRuntimes,
+ required bool? noRetry,
+ required this.testRandomizeOrderingSeed,
+ required bool? stopOnFirstFailure,
+ required BooleanSelector? includeTags,
+ required BooleanSelector? excludeTags,
+ required Iterable<Pattern>? globalPatterns,
+ required SuiteConfiguration? suiteDefaults})
+ : _help = help,
+ _version = version,
+ _pauseAfterLoad = pauseAfterLoad,
+ _debug = debug,
+ _color = color,
+ _configurationPath = configurationPath,
+ _reporter = reporter,
+ fileReporters = fileReporters ?? {},
+ _concurrency = concurrency,
+ _testSelections = testSelections == null || testSelections.isEmpty
+ ? null
+ : Map.unmodifiable(testSelections),
+ _foldTraceExcept = _set(foldTraceExcept),
+ _foldTraceOnly = _set(foldTraceOnly),
+ _filename = filename,
+ chosenPresets = UnmodifiableSetView(chosenPresets?.toSet() ?? {}),
+ presets = _map(presets),
+ overrideRuntimes = _map(overrideRuntimes),
+ defineRuntimes = _map(defineRuntimes),
+ _noRetry = noRetry,
+ includeTags = includeTags ?? BooleanSelector.all,
+ excludeTags = excludeTags ?? BooleanSelector.none,
+ globalPatterns = globalPatterns == null
+ ? const {}
+ : UnmodifiableSetView(globalPatterns.toSet()),
+ _stopOnFirstFailure = stopOnFirstFailure,
+ suiteDefaults = (() {
+ var config = suiteDefaults ?? SuiteConfiguration.empty;
+ if (pauseAfterLoad == true) {
+ return config.change(ignoreTimeouts: true);
+ }
+ return config;
+ }()) {
+ if (_filename != null && _filename.context.style != p.style) {
+ throw ArgumentError(
+ "filename's context must match the current operating system, was "
+ '${_filename.context.style}.');
+ }
+
+ if ((shardIndex == null) != (totalShards == null)) {
+ throw ArgumentError(
+ 'shardIndex and totalShards may only be passed together.');
+ } else if (shardIndex != null) {
+ RangeError.checkValueInInterval(
+ shardIndex!, 0, totalShards! - 1, 'shardIndex');
+ }
+ }
+
+ /// Creates a new [Configuration] that takes its configuration from
+ /// [SuiteConfiguration].
+ factory Configuration.fromSuiteConfiguration(
+ SuiteConfiguration suiteConfig) =>
+ Configuration._(
+ suiteDefaults: suiteConfig,
+ globalPatterns: null,
+ help: null,
+ customHtmlTemplatePath: null,
+ version: null,
+ pauseAfterLoad: null,
+ debug: null,
+ color: null,
+ configurationPath: null,
+ reporter: null,
+ fileReporters: null,
+ coverage: null,
+ concurrency: null,
+ shardIndex: null,
+ totalShards: null,
+ testSelections: null,
+ foldTraceExcept: null,
+ foldTraceOnly: null,
+ filename: null,
+ chosenPresets: null,
+ presets: null,
+ overrideRuntimes: null,
+ defineRuntimes: null,
+ noRetry: null,
+ testRandomizeOrderingSeed: null,
+ stopOnFirstFailure: null,
+ includeTags: null,
+ excludeTags: null,
+ );
+
+ /// Returns a set from [input].
+ ///
+ /// If [input] is `null` or empty, this returns `null`.
+ static Set<T>? _set<T>(Iterable<T>? input) {
+ if (input == null) return null;
+ var set = Set<T>.from(input);
+ if (set.isEmpty) return null;
+ return set;
+ }
+
+ /// Returns an unmodifiable copy of [input] or an empty unmodifiable map.
+ static Map<K, V> _map<K, V>(Map<K, V>? input) {
+ input ??= {};
+ return Map.unmodifiable(input);
+ }
+
+ /// Runs [body] with this as [Configuration.current].
+ ///
+ /// This is zone-scoped, so this will be the current configuration in any
+ /// asynchronous callbacks transitively created by [body].
+ T asCurrent<T>(T Function() body) =>
+ runZoned(body, zoneValues: {_currentKey: this});
+
+ /// Throws a [FormatException] if this refers to any undefined runtimes.
+ void validateRuntimes(List<Runtime> allRuntimes) {
+ // We don't need to verify [customRuntimes] here because those runtimes
+ // already need to be verified and resolved to create [allRuntimes].
+
+ for (var settings in overrideRuntimes.values) {
+ if (!allRuntimes
+ .any((runtime) => runtime.identifier == settings.identifier)) {
+ throw SourceSpanFormatException(
+ 'Unknown platform "${settings.identifier}".',
+ settings.identifierSpan);
+ }
+ }
+
+ suiteDefaults.validateRuntimes(allRuntimes);
+ for (var config in presets.values) {
+ config.validateRuntimes(allRuntimes);
+ }
+ }
+
+ /// Merges this with [other].
+ ///
+ /// For most fields, if both configurations have values set, [other]'s value
+ /// takes precedence. However, certain fields are merged together instead.
+ /// This is indicated in those fields' documentation.
+ Configuration merge(Configuration other) {
+ if (this == Configuration.empty) return other;
+ if (other == Configuration.empty) return this;
+
+ var foldTraceOnly = other._foldTraceOnly ?? _foldTraceOnly;
+ var foldTraceExcept = other._foldTraceExcept ?? _foldTraceExcept;
+ if (_foldTraceOnly != null) {
+ if (other._foldTraceExcept != null) {
+ foldTraceOnly = _foldTraceOnly.difference(other._foldTraceExcept);
+ } else if (other._foldTraceOnly != null) {
+ foldTraceOnly = other._foldTraceOnly.intersection(_foldTraceOnly);
+ }
+ } else if (_foldTraceExcept != null) {
+ if (other._foldTraceOnly != null) {
+ foldTraceOnly = other._foldTraceOnly.difference(_foldTraceExcept);
+ } else if (other._foldTraceExcept != null) {
+ foldTraceExcept = other._foldTraceExcept.union(_foldTraceExcept);
+ }
+ }
+
+ var result = Configuration._(
+ help: other._help ?? _help,
+ customHtmlTemplatePath:
+ other.customHtmlTemplatePath ?? customHtmlTemplatePath,
+ version: other._version ?? _version,
+ pauseAfterLoad: other._pauseAfterLoad ?? _pauseAfterLoad,
+ debug: other._debug ?? _debug,
+ color: other._color ?? _color,
+ configurationPath: other._configurationPath ?? _configurationPath,
+ reporter: other._reporter ?? _reporter,
+ fileReporters: mergeMaps(fileReporters, other.fileReporters),
+ coverage: other.coverage ?? coverage,
+ concurrency: other._concurrency ?? _concurrency,
+ shardIndex: other.shardIndex ?? shardIndex,
+ totalShards: other.totalShards ?? totalShards,
+ testSelections: other._testSelections ?? _testSelections,
+ foldTraceExcept: foldTraceExcept,
+ foldTraceOnly: foldTraceOnly,
+ filename: other._filename ?? _filename,
+ chosenPresets: chosenPresets.union(other.chosenPresets),
+ presets: _mergeConfigMaps(presets, other.presets),
+ overrideRuntimes: mergeUnmodifiableMaps(
+ overrideRuntimes, other.overrideRuntimes,
+ value: (settings1, settings2) => RuntimeSettings(
+ settings1.identifier,
+ settings1.identifierSpan,
+ [...settings1.settings, ...settings2.settings])),
+ defineRuntimes:
+ mergeUnmodifiableMaps(defineRuntimes, other.defineRuntimes),
+ noRetry: other._noRetry ?? _noRetry,
+ testRandomizeOrderingSeed:
+ other.testRandomizeOrderingSeed ?? testRandomizeOrderingSeed,
+ stopOnFirstFailure: other._stopOnFirstFailure ?? _stopOnFirstFailure,
+ includeTags: includeTags.intersection(other.includeTags),
+ excludeTags: excludeTags.union(other.excludeTags),
+ globalPatterns: globalPatterns.union(other.globalPatterns),
+ suiteDefaults: suiteDefaults.merge(other.suiteDefaults));
+ result = result._resolvePresets();
+
+ // Make sure the merged config preserves any presets that were chosen and
+ // discarded.
+ result._knownPresets = knownPresets.union(other.knownPresets);
+ return result;
+ }
+
+ /// Returns a copy of this configuration with the given fields updated.
+ ///
+ /// Note that unlike [merge], this has no merging behavior—the old value is
+ /// always replaced by the new one.
+ Configuration change(
+ {bool? help,
+ String? customHtmlTemplatePath,
+ bool? version,
+ bool? pauseAfterLoad,
+ bool? debug,
+ bool? color,
+ String? configurationPath,
+ String? reporter,
+ Map<String, String>? fileReporters,
+ String? coverage,
+ int? concurrency,
+ int? shardIndex,
+ int? totalShards,
+ Map<String, Set<TestSelection>>? testSelections,
+ Iterable<String>? exceptPackages,
+ Iterable<String>? onlyPackages,
+ Glob? filename,
+ Iterable<String>? chosenPresets,
+ Map<String, Configuration>? presets,
+ Map<String, RuntimeSettings>? overrideRuntimes,
+ Map<String, CustomRuntime>? defineRuntimes,
+ bool? noRetry,
+ int? testRandomizeOrderingSeed,
+ bool? ignoreTimeouts,
+
+ // Suite-level configuration
+ bool? allowDuplicateTestNames,
+ bool? jsTrace,
+ bool? runSkipped,
+ Iterable<String>? dart2jsArgs,
+ String? precompiledPath,
+ Iterable<RuntimeSelection>? runtimes,
+ BooleanSelector? includeTags,
+ BooleanSelector? excludeTags,
+ Map<BooleanSelector, SuiteConfiguration>? tags,
+ Map<PlatformSelector, SuiteConfiguration>? onPlatform,
+
+ // Test-level configuration
+ Timeout? timeout,
+ bool? verboseTrace,
+ bool? chainStackTraces,
+ bool? skip,
+ String? skipReason,
+ PlatformSelector? testOn,
+ Iterable<String>? addTags}) {
+ var config = Configuration._(
+ help: help ?? _help,
+ customHtmlTemplatePath:
+ customHtmlTemplatePath ?? this.customHtmlTemplatePath,
+ version: version ?? _version,
+ pauseAfterLoad: pauseAfterLoad ?? _pauseAfterLoad,
+ debug: debug ?? _debug,
+ color: color ?? _color,
+ configurationPath: configurationPath ?? _configurationPath,
+ reporter: reporter ?? _reporter,
+ fileReporters: fileReporters ?? this.fileReporters,
+ coverage: coverage ?? this.coverage,
+ concurrency: concurrency ?? _concurrency,
+ shardIndex: shardIndex ?? this.shardIndex,
+ totalShards: totalShards ?? this.totalShards,
+ testSelections: testSelections ?? _testSelections,
+ foldTraceExcept: exceptPackages ?? _foldTraceExcept,
+ foldTraceOnly: onlyPackages ?? _foldTraceOnly,
+ filename: filename ?? _filename,
+ chosenPresets: chosenPresets ?? this.chosenPresets,
+ presets: presets ?? this.presets,
+ overrideRuntimes: overrideRuntimes ?? this.overrideRuntimes,
+ defineRuntimes: defineRuntimes ?? this.defineRuntimes,
+ noRetry: noRetry ?? _noRetry,
+ testRandomizeOrderingSeed:
+ testRandomizeOrderingSeed ?? this.testRandomizeOrderingSeed,
+ stopOnFirstFailure: _stopOnFirstFailure,
+ includeTags: includeTags,
+ excludeTags: excludeTags,
+ globalPatterns: globalPatterns,
+ suiteDefaults: suiteDefaults.change(
+ allowDuplicateTestNames: allowDuplicateTestNames,
+ jsTrace: jsTrace,
+ runSkipped: runSkipped,
+ dart2jsArgs: dart2jsArgs,
+ precompiledPath: precompiledPath,
+ runtimes: runtimes,
+ tags: tags,
+ onPlatform: onPlatform,
+ timeout: timeout,
+ verboseTrace: verboseTrace,
+ chainStackTraces: chainStackTraces,
+ skip: skip,
+ skipReason: skipReason,
+ testOn: testOn,
+ addTags: addTags,
+ ignoreTimeouts: ignoreTimeouts,
+ ));
+ return config._resolvePresets();
+ }
+
+ /// Merges two maps whose values are [Configuration]s.
+ ///
+ /// Any overlapping keys in the maps have their configurations merged in the
+ /// returned map.
+ Map<String, Configuration> _mergeConfigMaps(
+ Map<String, Configuration> map1, Map<String, Configuration> map2) =>
+ mergeMaps(map1, map2,
+ value: (config1, config2) => config1.merge(config2));
+
+ /// Returns a copy of this [Configuration] with all [chosenPresets] resolved
+ /// against [presets].
+ Configuration _resolvePresets() {
+ if (chosenPresets.isEmpty || presets.isEmpty) return this;
+
+ var newPresets = Map<String, Configuration>.from(presets);
+ var merged = chosenPresets.fold(
+ empty,
+ (Configuration merged, preset) =>
+ merged.merge(newPresets.remove(preset) ?? Configuration.empty));
+
+ if (merged == empty) return this;
+ var result = change(presets: newPresets).merge(merged);
+
+ // Make sure the configuration knows about presets that were selected and
+ // thus removed from [newPresets].
+ result._knownPresets =
+ UnmodifiableSetView({...result.knownPresets, ...presets.keys});
+
+ return result;
+ }
+}
diff --git a/pkgs/test_core/lib/src/runner/configuration/args.dart b/pkgs/test_core/lib/src/runner/configuration/args.dart
new file mode 100644
index 0000000..e981bed
--- /dev/null
+++ b/pkgs/test_core/lib/src/runner/configuration/args.dart
@@ -0,0 +1,426 @@
+// Copyright (c) 2016, 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:io';
+import 'dart:math';
+
+import 'package:args/args.dart';
+import 'package:boolean_selector/boolean_selector.dart';
+import 'package:test_api/backend.dart';
+import 'package:test_api/scaffolding.dart' show Timeout;
+
+import '../../util/io.dart';
+import '../compiler_selection.dart';
+import '../configuration.dart';
+import '../runtime_selection.dart';
+import 'reporters.dart';
+import 'values.dart';
+
+/// The parser used to parse the command-line arguments.
+final ArgParser _parser = (() {
+ var parser = ArgParser(allowTrailingOptions: true);
+
+ var allRuntimes = Runtime.builtIn.toList()..remove(Runtime.vm);
+ if (!Platform.isMacOS) allRuntimes.remove(Runtime.safari);
+
+ parser.addFlag('help',
+ abbr: 'h', negatable: false, help: 'Show this usage information.');
+ parser.addFlag('version',
+ negatable: false, help: 'Show the package:test version.');
+
+ // Note that defaultsTo declarations here are only for documentation purposes.
+ // We pass null instead of the default so that it merges properly with the
+ // config file.
+
+ parser.addSeparator('Selecting Tests:');
+ parser.addMultiOption('name',
+ abbr: 'n',
+ help: 'A substring of the name of the test to run.\n'
+ 'Regular expression syntax is supported.\n'
+ 'If passed multiple times, tests must match all substrings.',
+ splitCommas: false);
+ parser.addMultiOption('plain-name',
+ abbr: 'N',
+ help: 'A plain-text substring of the name of the test to run.\n'
+ 'If passed multiple times, tests must match all substrings.',
+ splitCommas: false);
+ parser.addMultiOption('tags',
+ abbr: 't',
+ help: 'Run only tests with all of the specified tags.\n'
+ 'Supports boolean selector syntax.');
+ parser.addMultiOption('tag', hide: true);
+ parser.addMultiOption('exclude-tags',
+ abbr: 'x',
+ help: "Don't run tests with any of the specified tags.\n"
+ 'Supports boolean selector syntax.');
+ parser.addMultiOption('exclude-tag', hide: true);
+ parser.addFlag('run-skipped',
+ help: 'Run skipped tests instead of skipping them.');
+
+ parser.addSeparator('Running Tests:');
+
+ // The UI term "platform" corresponds with the implementation term "runtime".
+ // The [Runtime] class used to be called [TestPlatform], but it was changed to
+ // avoid conflicting with [SuitePlatform]. We decided not to also change the
+ // UI to avoid a painful migration.
+ parser.addMultiOption('platform',
+ abbr: 'p',
+ help: 'The platform(s) on which to run the tests.\n'
+ '[vm (default), '
+ '${allRuntimes.map((runtime) => runtime.identifier).join(", ")}].\n'
+ 'Each platform supports the following compilers:\n'
+ '${Runtime.vm.supportedCompilersText}\n'
+ '${allRuntimes.map((r) => r.supportedCompilersText).join('\n')}');
+ parser.addMultiOption('compiler',
+ abbr: 'c',
+ help: 'The compiler(s) to use to run tests, supported compilers are '
+ '[${Compiler.builtIn.map((c) => c.identifier).join(', ')}].\n'
+ 'Each platform has a default compiler but may support other '
+ 'compilers.\n'
+ 'You can target a compiler to a specific platform using arguments '
+ 'of the following form [<platform-selector>:]<compiler>.\n'
+ 'If a platform is specified but no given compiler is supported for '
+ 'that platform, then it will use its default compiler.');
+ parser.addMultiOption('preset',
+ abbr: 'P', help: 'The configuration preset(s) to use.');
+ parser.addOption('concurrency',
+ abbr: 'j',
+ help: 'The number of concurrent test suites run.',
+ defaultsTo: defaultConcurrency.toString(),
+ valueHelp: 'threads');
+ parser.addOption('total-shards',
+ help: 'The total number of invocations of the test runner being run.');
+ parser.addOption('shard-index',
+ help: 'The index of this test runner invocation (of --total-shards).');
+ parser.addOption('pub-serve',
+ help: '[Removed] The port of a pub serve instance serving "test/".',
+ valueHelp: 'port',
+ hide: true);
+ parser.addOption('timeout',
+ help: 'The default test timeout. For example: 15s, 2x, none',
+ defaultsTo: '30s');
+ parser.addFlag('ignore-timeouts',
+ help: 'Ignore all timeouts (useful if debugging)', negatable: false);
+ parser.addFlag('pause-after-load',
+ help: 'Pause for debugging before any tests execute.\n'
+ 'Implies --concurrency=1, --debug, and --ignore-timeouts.\n'
+ 'Currently only supported for browser tests.',
+ negatable: false);
+ parser.addFlag('debug',
+ help: 'Run the VM and Chrome tests in debug mode.', negatable: false);
+ parser.addOption('coverage',
+ help: 'Gather coverage and output it to the specified directory.\n'
+ 'Implies --debug.',
+ valueHelp: 'directory');
+ parser.addFlag('chain-stack-traces',
+ help: 'Use chained stack traces to provide greater exception details\n'
+ 'especially for asynchronous code. It may be useful to disable\n'
+ 'to provide improved test performance but at the cost of\n'
+ 'debuggability.',
+ defaultsTo: false);
+ parser.addFlag('no-retry',
+ help: "Don't rerun tests that have retry set.",
+ defaultsTo: false,
+ negatable: false);
+ parser.addFlag('use-data-isolate-strategy',
+ help: '**DEPRECATED**: This is now just an alias for --compiler source.',
+ defaultsTo: false,
+ hide: true,
+ negatable: false);
+ parser.addOption('test-randomize-ordering-seed',
+ help: 'Use the specified seed to randomize the execution order of test'
+ ' cases.\n'
+ 'Must be a 32bit unsigned integer or "random".\n'
+ 'If "random", pick a random seed to use.\n'
+ 'If not passed, do not randomize test case execution order.');
+ parser.addFlag('fail-fast',
+ help: 'Stop running tests after the first failure.\n');
+
+ var reporterDescriptions = <String, String>{
+ for (final MapEntry(:key, :value) in allReporters.entries)
+ key: value.description
+ };
+
+ parser.addSeparator('Output:');
+ parser.addOption('reporter',
+ abbr: 'r',
+ help: 'Set how to print test results.',
+ defaultsTo: defaultReporter,
+ allowed: allReporters.keys,
+ allowedHelp: reporterDescriptions,
+ valueHelp: 'option');
+ parser.addOption('file-reporter',
+ help: 'Enable an additional reporter writing test results to a file.\n'
+ 'Should be in the form <reporter>:<filepath>, '
+ 'Example: "json:reports/tests.json"');
+ parser.addFlag('verbose-trace',
+ negatable: false, help: 'Emit stack traces with core library frames.');
+ parser.addFlag('js-trace',
+ negatable: false,
+ help: 'Emit raw JavaScript stack traces for browser tests.');
+ parser.addFlag('color',
+ help: 'Use terminal colors.\n(auto-detected by default)');
+
+ /// The following options are used only by the internal Google test runner.
+ /// They're hidden and not supported as stable API surface outside Google.
+
+ parser.addOption('configuration',
+ help: 'The path to the configuration file.', hide: true);
+ parser.addMultiOption('dart2js-args',
+ help: 'Extra arguments to pass to dart2js.', hide: true);
+
+ // If we're running test/dir/my_test.dart, we'll look for
+ // test/dir/my_test.dart.html in the precompiled directory.
+ parser.addOption('precompiled',
+ help: 'The path to a mirror of the package directory containing HTML '
+ 'that points to precompiled JS.',
+ hide: true);
+
+ return parser;
+})();
+
+/// The usage string for the command-line arguments.
+String get usage => _parser.usage;
+
+/// Parses the configuration from [args].
+///
+/// Throws a [FormatException] if [args] are invalid.
+Configuration parse(List<String> args) => _Parser(args).parse();
+
+void _parseTestSelection(
+ String option, Map<String, Set<TestSelection>> selections) {
+ if (Platform.isWindows) {
+ // If given a path that starts with what looks like a drive letter, convert it
+ // into a file scheme URI. We can't parse using `Uri.file` because we do
+ // support query parameters which aren't valid file uris.
+ if (option.indexOf(':') == 1) {
+ option = 'file:///$option';
+ }
+ }
+ final uri = Uri.parse(option);
+ final path = Uri.decodeComponent(uri.path).stripDriveLetterLeadingSlash;
+ final names = uri.queryParametersAll['name'];
+ final fullName = uri.queryParameters['full-name'];
+ final line = uri.queryParameters['line'];
+ final col = uri.queryParameters['col'];
+
+ if (names != null && names.isNotEmpty && fullName != null) {
+ throw const FormatException(
+ 'Cannot specify both "name=<...>" and "full-name=<...>".',
+ );
+ }
+ final selection = TestSelection(
+ testPatterns: fullName != null
+ ? {RegExp('^${RegExp.escape(fullName)}\$')}
+ : {
+ if (names != null)
+ for (var name in names) RegExp(name)
+ },
+ line: line == null ? null : int.parse(line),
+ col: col == null ? null : int.parse(col),
+ );
+
+ selections.update(path, (selections) => selections..add(selection),
+ ifAbsent: () => {selection});
+}
+
+/// A class for parsing an argument list.
+///
+/// This is used to provide access to the arg results across helper methods.
+class _Parser {
+ /// The parsed options.
+ final ArgResults _options;
+
+ _Parser(List<String> args) : _options = _parser.parse(args);
+
+ List<String> _readMulti(String name) => _options[name] as List<String>;
+
+ /// Returns the parsed configuration.
+ Configuration parse() {
+ var patterns = [
+ for (var value in _readMulti('name'))
+ _wrapFormatException(value, () => RegExp(value), optionName: 'name'),
+ ..._readMulti('plain-name'),
+ ];
+
+ var includeTags = {..._readMulti('tags'), ..._readMulti('tag')}
+ .fold<BooleanSelector>(BooleanSelector.all, (selector, tag) {
+ return selector.intersection(BooleanSelector.parse(tag));
+ });
+
+ var excludeTags = {
+ ..._readMulti('exclude-tags'),
+ ..._readMulti('exclude-tag')
+ }.fold<BooleanSelector>(BooleanSelector.none, (selector, tag) {
+ return selector.union(BooleanSelector.parse(tag));
+ });
+
+ var shardIndex = _parseOption('shard-index', int.parse);
+ var totalShards = _parseOption('total-shards', int.parse);
+ if ((shardIndex == null) != (totalShards == null)) {
+ throw const FormatException(
+ '--shard-index and --total-shards may only be passed together.');
+ } else if (shardIndex != null) {
+ if (shardIndex < 0) {
+ throw const FormatException('--shard-index may not be negative.');
+ } else if (shardIndex >= totalShards!) {
+ throw const FormatException(
+ '--shard-index must be less than --total-shards.');
+ }
+ }
+
+ var reporter = _ifParsed('reporter') as String?;
+
+ var testRandomizeOrderingSeed =
+ _parseOption('test-randomize-ordering-seed', (value) {
+ var seed = value == 'random'
+ ? Random().nextInt(4294967295)
+ : int.parse(value).toUnsigned(32);
+
+ // TODO(#1547): Less hacky way of not breaking the json reporter
+ if (reporter != 'json') {
+ print('Shuffling test order with --test-randomize-ordering-seed=$seed');
+ }
+
+ return seed;
+ });
+
+ var color = _ifParsed<bool>('color') ?? canUseSpecialChars;
+
+ var runtimes =
+ _ifParsed<List<String>>('platform')?.map(RuntimeSelection.new).toList();
+ var compilerSelections = _ifParsed<List<String>>('compiler')
+ ?.map(CompilerSelection.parse)
+ .toList();
+ if (_ifParsed<bool>('use-data-isolate-strategy') == true) {
+ compilerSelections ??= [];
+ compilerSelections.add(CompilerSelection.parse('vm:source'));
+ }
+
+ final paths = _options.rest.isEmpty ? null : _options.rest;
+
+ Map<String, Set<TestSelection>>? selections;
+ if (paths != null) {
+ selections = {};
+ for (final path in paths) {
+ _parseTestSelection(path, selections);
+ }
+ }
+
+ if (_options.wasParsed('pub-serve')) {
+ throw ArgumentError(
+ 'The --pub-serve is no longer supported, if you require it please '
+ 'open an issue at https://github.com/dart-lang/test/issues/new.');
+ }
+
+ return Configuration(
+ help: _ifParsed('help'),
+ version: _ifParsed('version'),
+ verboseTrace: _ifParsed('verbose-trace'),
+ chainStackTraces: _ifParsed('chain-stack-traces'),
+ jsTrace: _ifParsed('js-trace'),
+ pauseAfterLoad: _ifParsed('pause-after-load'),
+ debug: _ifParsed('debug'),
+ color: color,
+ configurationPath: _ifParsed('configuration'),
+ dart2jsArgs: _ifParsed('dart2js-args'),
+ precompiledPath: _ifParsed<String>('precompiled'),
+ reporter: reporter,
+ fileReporters: _parseFileReporterOption(),
+ coverage: _ifParsed('coverage'),
+ concurrency: _parseOption('concurrency', int.parse),
+ shardIndex: shardIndex,
+ totalShards: totalShards,
+ timeout: _parseOption('timeout', Timeout.parse),
+ globalPatterns: patterns,
+ compilerSelections: compilerSelections,
+ runtimes: runtimes,
+ runSkipped: _ifParsed('run-skipped'),
+ chosenPresets: _ifParsed('preset'),
+ testSelections: selections,
+ includeTags: includeTags,
+ excludeTags: excludeTags,
+ noRetry: _ifParsed('no-retry'),
+ testRandomizeOrderingSeed: testRandomizeOrderingSeed,
+ ignoreTimeouts: _ifParsed('ignore-timeouts'),
+ stopOnFirstFailure: _ifParsed('fail-fast'),
+ // Config that isn't supported on the command line
+ addTags: null,
+ allowTestRandomization: null,
+ allowDuplicateTestNames: null,
+ customHtmlTemplatePath: null,
+ defineRuntimes: null,
+ filename: null,
+ foldTraceExcept: null,
+ foldTraceOnly: null,
+ onPlatform: null,
+ overrideRuntimes: null,
+ presets: null,
+ retry: null,
+ skip: null,
+ skipReason: null,
+ testOn: null,
+ tags: null);
+ }
+
+ /// Returns the parsed option for [name], or `null` if none was parsed.
+ ///
+ /// If the user hasn't explicitly chosen a value, we want to pass null values
+ /// to [Configuration.new] so that it considers those fields unset when
+ /// merging with configuration from the config file.
+ T? _ifParsed<T>(String name) =>
+ _options.wasParsed(name) ? _options[name] as T : null;
+
+ /// Runs [parse] on the value of the option [name], and wraps any
+ /// [FormatException] it throws with additional information.
+ T? _parseOption<T>(String name, T Function(String) parse) {
+ if (!_options.wasParsed(name)) return null;
+
+ var value = _options[name];
+ if (value == null) return null;
+
+ return _wrapFormatException(value, () => parse(value as String),
+ optionName: name);
+ }
+
+ Map<String, String>? _parseFileReporterOption() =>
+ _parseOption('file-reporter', (value) {
+ if (!value.contains(':')) {
+ throw const FormatException(
+ 'option must be in the form <reporter>:<filepath>, e.g. '
+ '"json:reports/tests.json"');
+ }
+ final sep = value.indexOf(':');
+ final reporter = value.substring(0, sep);
+ if (!allReporters.containsKey(reporter)) {
+ throw FormatException('"$reporter" is not a supported reporter');
+ }
+ return {reporter: value.substring(sep + 1)};
+ });
+
+ /// Runs [parse], and wraps any [FormatException] it throws with additional
+ /// information.
+ T _wrapFormatException<T>(Object? value, T Function() parse,
+ {String? optionName}) {
+ try {
+ return parse();
+ } on FormatException catch (error) {
+ throw FormatException(
+ 'Couldn\'t parse ${optionName == null ? '' : '--$optionName '}"$value": '
+ '${error.message}');
+ }
+ }
+}
+
+extension _RuntimeDescription on Runtime {
+ String get supportedCompilersText {
+ var message = StringBuffer('[$identifier]: ');
+ message.write('${defaultCompiler.identifier} (default)');
+ for (var compiler in supportedCompilers) {
+ if (compiler == defaultCompiler) continue;
+ message.write(', ${compiler.identifier}');
+ }
+ return message.toString();
+ }
+}
diff --git a/pkgs/test_core/lib/src/runner/configuration/custom_runtime.dart b/pkgs/test_core/lib/src/runner/configuration/custom_runtime.dart
new file mode 100644
index 0000000..d1bd028
--- /dev/null
+++ b/pkgs/test_core/lib/src/runner/configuration/custom_runtime.dart
@@ -0,0 +1,34 @@
+// Copyright (c) 2017, 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 'package:source_span/source_span.dart';
+import 'package:yaml/yaml.dart';
+
+/// A user-defined test runtime, based on an existing runtime but with
+/// different configuration.
+final class CustomRuntime {
+ /// The human-friendly name of the runtime.
+ final String name;
+
+ /// The location that [name] was defined in the configuration file.
+ final SourceSpan nameSpan;
+
+ /// The identifier used to look up the runtime.
+ final String identifier;
+
+ /// The location that [identifier] was defined in the configuration file.
+ final SourceSpan identifierSpan;
+
+ /// The identifier of the runtime that this extends.
+ final String parent;
+
+ /// The location that [parent] was defined in the configuration file.
+ final SourceSpan parentSpan;
+
+ /// The user's settings for this runtime.
+ final YamlMap settings;
+
+ CustomRuntime(this.name, this.nameSpan, this.identifier, this.identifierSpan,
+ this.parent, this.parentSpan, this.settings);
+}
diff --git a/pkgs/test_core/lib/src/runner/configuration/load.dart b/pkgs/test_core/lib/src/runner/configuration/load.dart
new file mode 100644
index 0000000..9877db6
--- /dev/null
+++ b/pkgs/test_core/lib/src/runner/configuration/load.dart
@@ -0,0 +1,656 @@
+// Copyright (c) 2016, 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:io';
+
+import 'package:boolean_selector/boolean_selector.dart';
+import 'package:glob/glob.dart';
+import 'package:path/path.dart' as p;
+import 'package:source_span/source_span.dart';
+import 'package:test_api/scaffolding.dart' show Timeout;
+import 'package:test_api/src/backend/operating_system.dart'; // ignore: implementation_imports
+import 'package:test_api/src/backend/platform_selector.dart'; // ignore: implementation_imports
+import 'package:test_api/src/backend/util/identifier_regex.dart'; // ignore: implementation_imports
+import 'package:yaml/yaml.dart';
+
+import '../../util/errors.dart';
+import '../../util/io.dart';
+import '../../util/pretty_print.dart';
+import '../compiler_selection.dart';
+import '../configuration.dart';
+import '../runtime_selection.dart';
+import '../suite.dart';
+import 'custom_runtime.dart';
+import 'reporters.dart';
+import 'runtime_settings.dart';
+
+/// A regular expression matching a Dart identifier.
+///
+/// This also matches a package name, since they must be Dart identifiers.
+final _identifierRegExp = RegExp(r'[a-zA-Z_]\w*');
+
+/// A regular expression matching allowed package names.
+///
+/// This allows dot-separated valid Dart identifiers. The dots are there for
+/// compatibility with Google's internal Dart packages, but they may not be used
+/// when publishing a package to pub.dev.
+final _packageName =
+ RegExp('^${_identifierRegExp.pattern}(\\.${_identifierRegExp.pattern})*\$');
+
+/// Parses configuration from YAML formatted [content].
+///
+/// If [global] is `true`, this restricts the configuration file to only rules
+/// that are supported globally.
+///
+/// If [sourceUrl] is provided then that will be set as the source url for
+/// the yaml document.
+///
+/// Throws a [FormatException] if the configuration is invalid.
+Configuration parse(String content, {Uri? sourceUrl, bool global = false}) {
+ var document = loadYamlNode(content, sourceUrl: sourceUrl);
+
+ if (document.value == null) return Configuration.empty;
+
+ if (document is! Map) {
+ throw SourceSpanFormatException(
+ 'The configuration must be a YAML map.', document.span, content);
+ }
+
+ var loader =
+ _ConfigurationLoader(document as YamlMap, content, global: global);
+ return loader.load();
+}
+
+/// A helper for [load] that tracks the YAML document.
+class _ConfigurationLoader {
+ /// The parsed configuration document.
+ final YamlMap _document;
+
+ /// The source string for [_document].
+ ///
+ /// Used for error reporting.
+ final String _source;
+
+ /// Whether this is parsing the global configuration file.
+ final bool _global;
+
+ /// Whether runner configuration is allowed at this level.
+ final bool _runnerConfig;
+
+ _ConfigurationLoader(this._document, this._source,
+ {bool global = false, bool runnerConfig = true})
+ : _global = global,
+ _runnerConfig = runnerConfig;
+
+ /// Loads the configuration in [_document].
+ Configuration load() => _loadIncludeConfig()
+ .merge(_loadGlobalTestConfig())
+ .merge(_loadLocalTestConfig())
+ .merge(_loadGlobalRunnerConfig())
+ .merge(_loadLocalRunnerConfig());
+
+ /// If an `include` node is contained in [node], merges and returns [config].
+ Configuration _loadIncludeConfig() {
+ if (!_runnerConfig) {
+ _disallow('include');
+ return Configuration.empty;
+ }
+
+ var includeNode = _document.nodes['include'];
+ if (includeNode == null) return Configuration.empty;
+
+ var includePath = _parseNode(includeNode, 'include path', p.fromUri);
+ var basePath =
+ p.join(p.dirname(p.fromUri(_document.span.sourceUrl)), includePath);
+ try {
+ return Configuration.load(basePath);
+ } on FileSystemException catch (error) {
+ throw SourceSpanFormatException(
+ getErrorMessage(error), includeNode.span, _source);
+ }
+ }
+
+ /// Loads test configuration that's allowed in the global configuration file.
+ Configuration _loadGlobalTestConfig() {
+ var verboseTrace = _getBool('verbose_trace');
+ var chainStackTraces = _getBool('chain_stack_traces');
+ var foldStackFrames = _loadFoldedStackFrames();
+ var jsTrace = _getBool('js_trace');
+
+ var timeout = _parseValue('timeout', Timeout.parse);
+
+ var onPlatform = _getMap('on_platform',
+ key: (keyNode) => _parseNode(keyNode, 'on_platform key',
+ (value) => PlatformSelector.parse(value, keyNode.span)),
+ value: (valueNode) =>
+ _nestedConfig(valueNode, 'on_platform value', runnerConfig: false));
+
+ var onOS = _getMap('on_os',
+ key: (keyNode) {
+ _validate(keyNode, 'on_os key must be a string.',
+ (value) => value is String);
+
+ var os = OperatingSystem.find(keyNode.value as String);
+ if (os != OperatingSystem.none) return os;
+
+ throw SourceSpanFormatException(
+ 'Invalid on_os key: No such operating system.',
+ keyNode.span,
+ _source);
+ },
+ value: (valueNode) => _nestedConfig(valueNode, 'on_os value'));
+
+ var presets = _getMap('presets',
+ key: (keyNode) => _parseIdentifierLike(keyNode, 'presets key'),
+ value: (valueNode) => _nestedConfig(valueNode, 'presets value'));
+
+ var config = Configuration.globalTest(
+ verboseTrace: verboseTrace,
+ jsTrace: jsTrace,
+ timeout: timeout,
+ presets: presets,
+ chainStackTraces: chainStackTraces,
+ foldTraceExcept: foldStackFrames['except'],
+ foldTraceOnly: foldStackFrames['only'])
+ .merge(_extractPresets<PlatformSelector>(
+ onPlatform, Configuration.onPlatform));
+
+ var osConfig = onOS[currentOS];
+ return osConfig == null ? config : config.merge(osConfig);
+ }
+
+ /// Loads test configuration that's not allowed in the global configuration
+ /// file.
+ ///
+ /// If [_global] is `true`, this will error if there are any local test-level
+ /// configuration fields.
+ Configuration _loadLocalTestConfig() {
+ if (_global) {
+ _disallow('skip');
+ _disallow('retry');
+ _disallow('test_on');
+ _disallow('add_tags');
+ _disallow('tags');
+ _disallow('allow_test_randomization');
+ _disallow('allow_duplicate_test_names');
+ return Configuration.empty;
+ }
+
+ var skipRaw = _getValue('skip', 'boolean or string',
+ (value) => (value is bool?) || value is String?);
+ String? skipReason;
+ bool? skip;
+ if (skipRaw is String) {
+ skipReason = skipRaw;
+ skip = true;
+ } else {
+ skip = skipRaw as bool?;
+ }
+
+ var testOn = _parsePlatformSelector('test_on');
+
+ var addTags = _getList(
+ 'add_tags', (tagNode) => _parseIdentifierLike(tagNode, 'Tag name'));
+
+ var tags = _getMap('tags',
+ key: (keyNode) =>
+ _parseNode(keyNode, 'tags key', BooleanSelector.parse),
+ value: (valueNode) =>
+ _nestedConfig(valueNode, 'tag value', runnerConfig: false));
+
+ var retry = _getNonNegativeInt('retry');
+
+ var allowTestRandomization = _getBool('allow_test_randomization');
+
+ var allowDuplicateTestNames = _getBool('allow_duplicate_test_names');
+
+ return Configuration.localTest(
+ skip: skip,
+ retry: retry,
+ skipReason: skipReason,
+ testOn: testOn,
+ addTags: addTags,
+ allowTestRandomization: allowTestRandomization,
+ allowDuplicateTestNames: allowDuplicateTestNames)
+ .merge(_extractPresets<BooleanSelector>(tags, Configuration.tags));
+ }
+
+ /// Loads runner configuration that's allowed in the global configuration
+ /// file.
+ ///
+ /// If [_runnerConfig] is `false`, this will error if there are any
+ /// runner-level configuration fields.
+ Configuration _loadGlobalRunnerConfig() {
+ if (!_runnerConfig) {
+ _disallow('pause_after_load');
+ _disallow('reporter');
+ _disallow('file_reporters');
+ _disallow('concurrency');
+ _disallow('names');
+ _disallow('plain_names');
+ _disallow('platforms');
+ _disallow('add_presets');
+ _disallow('override_platforms');
+ _disallow('include');
+ return Configuration.empty;
+ }
+
+ var pauseAfterLoad = _getBool('pause_after_load');
+ var runSkipped = _getBool('run_skipped');
+
+ var reporter = _getString('reporter');
+ if (reporter != null && !allReporters.keys.contains(reporter)) {
+ _error('Unknown reporter "$reporter".', 'reporter');
+ }
+
+ var fileReporters = _getMap('file_reporters', key: (keyNode) {
+ _validate(keyNode, 'file_reporters key must be a string',
+ (value) => value is String);
+ final reporter = keyNode.value as String;
+ if (!allReporters.keys.contains(reporter)) {
+ _error('Unknown reporter "$reporter".', 'file_reporters');
+ }
+ return reporter;
+ }, value: (valueNode) {
+ _validate(valueNode, 'file_reporters value must be a string',
+ (value) => value is String);
+ return valueNode.value as String;
+ });
+
+ var concurrency = _getInt('concurrency');
+
+ // The UI term "platform" corresponds with the implementation term
+ // "runtime". The [Runtime] class used to be called [TestPlatform], but it
+ // was changed to avoid conflicting with [SuitePlatform]. We decided not to
+ // also change the UI to avoid a painful migration.
+ var runtimes = _getList(
+ 'platforms',
+ (runtimeNode) => RuntimeSelection(
+ _parseIdentifierLike(runtimeNode, 'Platform name'),
+ runtimeNode.span));
+
+ var compilerSelections = _getList(
+ 'compilers',
+ (node) => _parseNode(
+ node,
+ 'compiler',
+ (option) =>
+ CompilerSelection.parse(option, parentSpan: node.span)));
+
+ var chosenPresets = _getList('add_presets',
+ (presetNode) => _parseIdentifierLike(presetNode, 'Preset name'));
+
+ var overrideRuntimes = _loadOverrideRuntimes();
+
+ var customHtmlTemplatePath = _getString('custom_html_template_path');
+
+ return Configuration.globalRunner(
+ pauseAfterLoad: pauseAfterLoad,
+ customHtmlTemplatePath: customHtmlTemplatePath,
+ runSkipped: runSkipped,
+ reporter: reporter,
+ fileReporters: fileReporters,
+ concurrency: concurrency,
+ compilerSelections: compilerSelections,
+ runtimes: runtimes,
+ chosenPresets: chosenPresets,
+ overrideRuntimes: overrideRuntimes);
+ }
+
+ /// Loads the `override_platforms` field.
+ Map<String, RuntimeSettings> _loadOverrideRuntimes() {
+ var runtimesNode =
+ _getNode('override_platforms', 'map', (value) => value is Map)
+ as YamlMap?;
+ if (runtimesNode == null) return const {};
+
+ var runtimes = <String, RuntimeSettings>{};
+ runtimesNode.nodes.forEach((identifierNode, valueNode) {
+ var yamlNode = identifierNode as YamlNode;
+ var identifier = _parseIdentifierLike(yamlNode, 'Platform identifier');
+
+ _validate(valueNode, 'Platform definition must be a map.',
+ (value) => value is Map);
+ var map = valueNode as YamlMap;
+
+ var settings = _expect(map, 'settings');
+ _validate(settings, 'Must be a map.', (value) => value is Map);
+
+ runtimes[identifier] =
+ RuntimeSettings(identifier, yamlNode.span, [settings as YamlMap]);
+ });
+ return runtimes;
+ }
+
+ /// Loads runner configuration that's not allowed in the global configuration
+ /// file.
+ ///
+ /// If [_runnerConfig] is `false` or if [_global] is `true`, this will error
+ /// if there are any local test-level configuration fields.
+ Configuration _loadLocalRunnerConfig() {
+ if (!_runnerConfig || _global) {
+ _disallow('names');
+ _disallow('plain_names');
+ _disallow('paths');
+ _disallow('filename');
+ _disallow('include_tags');
+ _disallow('exclude_tags');
+ _disallow('define_platforms');
+ return Configuration.empty;
+ }
+
+ var patterns = _getList('names', (nameNode) {
+ _validate(nameNode, 'Names must be strings.', (value) => value is String);
+ return _parseNode(nameNode, 'name', RegExp.new);
+ })
+ ..addAll(_getList('plain_names', (nameNode) {
+ _validate(
+ nameNode, 'Names must be strings.', (value) => value is String);
+ return _parseNode(nameNode, 'name', RegExp.new);
+ }));
+
+ var paths = _getList('paths', (pathNode) {
+ _validate(pathNode, 'Paths must be strings.', (value) => value is String);
+ _validate(pathNode, 'Paths must be relative.',
+ (value) => p.url.isRelative(value as String));
+ return _parseNode(pathNode, 'path', p.fromUri);
+ });
+
+ var filename = _parseValue('filename', Glob.new);
+
+ var includeTags = _parseBooleanSelector('include_tags');
+ var excludeTags = _parseBooleanSelector('exclude_tags');
+
+ var defineRuntimes = _loadDefineRuntimes();
+
+ return Configuration.localRunner(
+ globalPatterns: patterns,
+ testSelections: {
+ for (var path in paths) path: const {TestSelection()}
+ },
+ filename: filename,
+ includeTags: includeTags,
+ excludeTags: excludeTags,
+ defineRuntimes: defineRuntimes);
+ }
+
+ /// Returns a map representation of the `fold_stack_frames` configuration.
+ ///
+ /// The key `except` will correspond to the list of packages to fold.
+ /// The key `only` will correspond to the list of packages to keep in a
+ /// test [Chain].
+ Map<String, List<String>> _loadFoldedStackFrames() {
+ var foldOptionSet = false;
+ return _getMap('fold_stack_frames', key: (keyNode) {
+ _validate(keyNode, 'Must be a string', (value) => value is String);
+ _validate(keyNode, 'Must be "only" or "except".',
+ (value) => value == 'only' || value == 'except');
+
+ if (foldOptionSet) {
+ throw SourceSpanFormatException(
+ 'Can only contain one of "only" or "except".',
+ keyNode.span,
+ _source);
+ }
+ foldOptionSet = true;
+ return keyNode.value as String;
+ }, value: (valueNode) {
+ _validate(
+ valueNode,
+ 'Folded packages must be strings.',
+ (valueList) =>
+ valueList is YamlList &&
+ valueList.every((value) => value is String));
+
+ _validate(
+ valueNode,
+ 'Invalid package name.',
+ (valueList) => (valueList as Iterable)
+ .every((value) => _packageName.hasMatch(value as String)));
+
+ return List<String>.from(valueNode.value as Iterable);
+ });
+ }
+
+ /// Loads the `define_platforms` field.
+ Map<String, CustomRuntime> _loadDefineRuntimes() {
+ var runtimesNode =
+ _getNode('define_platforms', 'map', (value) => value is Map)
+ as YamlMap?;
+ if (runtimesNode == null) return const {};
+
+ var runtimes = <String, CustomRuntime>{};
+ runtimesNode.nodes.forEach((identifierNode, valueNode) {
+ var yamlNode = identifierNode as YamlNode;
+ var identifier = _parseIdentifierLike(yamlNode, 'Platform identifier');
+
+ _validate(valueNode, 'Platform definition must be a map.',
+ (value) => value is Map);
+ var map = valueNode as YamlMap;
+
+ var nameNode = _expect(map, 'name');
+ _validate(nameNode, 'Must be a string.', (value) => value is String);
+ var name = nameNode.value as String;
+
+ var parentNode = _expect(map, 'extends');
+ var parent = _parseIdentifierLike(parentNode, 'Platform parent');
+
+ var settings = _expect(map, 'settings');
+ _validate(settings, 'Must be a map.', (value) => value is Map);
+
+ runtimes[identifier] = CustomRuntime(name, nameNode.span, identifier,
+ yamlNode.span, parent, parentNode.span, settings as YamlMap);
+ });
+ return runtimes;
+ }
+
+ /// Throws an exception with [message] if [test] returns `false` when passed
+ /// [node]'s value.
+ void _validate(YamlNode node, String message, bool Function(dynamic) test) {
+ if (test(node.value)) return;
+ throw SourceSpanFormatException(message, node.span, _source);
+ }
+
+ /// Returns the value of the node at [field].
+ ///
+ /// If [typeTest] returns `false` for that value, instead throws an error
+ /// complaining that the field is not a [typeName].
+ Object? _getValue(
+ String field, String typeName, bool Function(dynamic) typeTest) {
+ var value = _document[field];
+ if (value == null || typeTest(value)) return value;
+ _error('$field must be ${a(typeName)}.', field);
+ }
+
+ /// Returns the YAML node at [field].
+ ///
+ /// If [typeTest] returns `false` for that node's value, instead throws an
+ /// error complaining that the field is not a [typeName].
+ ///
+ /// Returns `null` if [field] does not have a node in [_document].
+ YamlNode? _getNode(
+ String field, String typeName, bool Function(dynamic) typeTest) {
+ var node = _document.nodes[field];
+ if (node == null) return null;
+ _validate(node, '$field must be ${a(typeName)}.', typeTest);
+ return node;
+ }
+
+ /// Asserts that [field] is an int and returns its value.
+ int? _getInt(String field) =>
+ _getValue(field, 'int', (value) => value is int?) as int?;
+
+ /// Asserts that [field] is a non-negative int and returns its value.
+ int? _getNonNegativeInt(String field) =>
+ _getValue(field, 'non-negative int', (value) {
+ if (value == null) return true;
+ return value is int && value >= 0;
+ }) as int?;
+
+ /// Asserts that [field] is a boolean and returns its value.
+ bool? _getBool(String field) =>
+ _getValue(field, 'boolean', (value) => value is bool?) as bool?;
+
+ /// Asserts that [field] is a string and returns its value.
+ String? _getString(String field) =>
+ _getValue(field, 'string', (value) => value is String?) as String?;
+
+ /// Asserts that [field] is a list and runs [forElement] for each element it
+ /// contains.
+ ///
+ /// Returns a list of values returned by [forElement].
+ List<T> _getList<T>(String field, T Function(YamlNode) forElement) {
+ var node = _getNode(field, 'list', (value) => value is List) as YamlList?;
+ if (node == null) return [];
+ return node.nodes.map(forElement).toList();
+ }
+
+ /// Asserts that [field] is a map and runs [key] and [value] for each pair.
+ ///
+ /// Returns a map with the keys and values returned by [key] and [value]. Each
+ /// of these defaults to asserting that the value is a string.
+ Map<K, V> _getMap<K, V>(String field,
+ {K Function(YamlNode)? key, V Function(YamlNode)? value}) {
+ var node = _getNode(field, 'map', (value) => value is Map) as YamlMap?;
+ if (node == null) return {};
+
+ key ??= (keyNode) {
+ _validate(
+ keyNode, '$field keys must be strings.', (value) => value is String);
+
+ return keyNode.value as K;
+ };
+
+ value ??= (valueNode) {
+ _validate(valueNode, '$field values must be strings.',
+ (value) => value is String);
+
+ return valueNode.value as V;
+ };
+
+ return node.nodes.map((keyNode, valueNode) =>
+ MapEntry(key!(keyNode as YamlNode), value!(valueNode)));
+ }
+
+ /// Verifies that [node]'s value is an optionally hyphenated Dart identifier,
+ /// and returns it
+ String _parseIdentifierLike(YamlNode node, String name) {
+ _validate(node, '$name must be a string.', (value) => value is String);
+ _validate(node, '$name must be an (optionally hyphenated) Dart identifier.',
+ (value) => (value as String).contains(anchoredHyphenatedIdentifier));
+ return node.value as String;
+ }
+
+ /// Parses [node]'s value as a boolean selector.
+ BooleanSelector? _parseBooleanSelector(String name) =>
+ _parseValue(name, BooleanSelector.parse);
+
+ /// Parses [node]'s value as a platform selector.
+ PlatformSelector? _parsePlatformSelector(String field) {
+ var node = _document.nodes[field];
+ if (node == null) return null;
+ return _parseNode(
+ node, field, (value) => PlatformSelector.parse(value, node.span));
+ }
+
+ /// Asserts that [node] is a string, passes its value to [parse], and returns
+ /// the result.
+ ///
+ /// If [parse] throws a [FormatException], it's wrapped to include [node]'s
+ /// span.
+ T _parseNode<T>(YamlNode node, String name, T Function(String) parse) {
+ _validate(node, '$name must be a string.', (value) => value is String);
+
+ try {
+ return parse(node.value as String);
+ } on FormatException catch (error) {
+ throw SourceSpanFormatException(
+ 'Invalid $name: ${error.message}', node.span, _source);
+ }
+ }
+
+ /// Asserts that [field] is a string, passes it to [parse], and returns the
+ /// result.
+ ///
+ /// If [parse] throws a [FormatException], it's wrapped to include [field]'s
+ /// span.
+ T? _parseValue<T>(String field, T Function(String) parse) {
+ var node = _document.nodes[field];
+ if (node == null) return null;
+ return _parseNode(node, field, parse);
+ }
+
+ /// Parses a nested configuration document.
+ ///
+ /// [name] is the name of the field, which is used for error-handling.
+ /// [runnerConfig] controls whether runner configuration is allowed in the
+ /// nested configuration. It defaults to [_runnerConfig].
+ Configuration _nestedConfig(YamlNode? node, String name,
+ {bool? runnerConfig}) {
+ if (node == null || node.value == null) return Configuration.empty;
+
+ _validate(node, '$name must be a map.', (value) => value is Map);
+ var loader = _ConfigurationLoader(node as YamlMap, _source,
+ global: _global, runnerConfig: runnerConfig ?? _runnerConfig);
+ return loader.load();
+ }
+
+ /// Takes a map that contains [Configuration]s and extracts any
+ /// preset-specific configuration into a parent [Configuration].
+ ///
+ /// This is needed because parameters to [Configuration.new] such as
+ /// `onPlatform` take maps to [SuiteConfiguration]s. [SuiteConfiguration]
+ /// doesn't support preset-specific configuration, so this extracts the preset
+ /// logic into a parent [Configuration], leaving only maps to
+ /// [SuiteConfiguration]s. The [create] function is used to construct
+ /// [Configuration]s from the resolved maps.
+ Configuration _extractPresets<T>(Map<T, Configuration> map,
+ Configuration Function(Map<T, SuiteConfiguration>) create) {
+ if (map.isEmpty) return Configuration.empty;
+
+ var base = <T, SuiteConfiguration>{};
+ var presets = <String, Map<T, SuiteConfiguration>>{};
+ map.forEach((key, config) {
+ base[key] = config.suiteDefaults;
+ config.presets.forEach((preset, presetConfig) {
+ presets.putIfAbsent(preset, () => {})[key] = presetConfig.suiteDefaults;
+ });
+ });
+
+ if (presets.isEmpty) {
+ return base.isEmpty ? Configuration.empty : create(base);
+ } else {
+ var newPresets = presets.map((key, map) => MapEntry(key, create(map)));
+ return create(base).change(presets: newPresets);
+ }
+ }
+
+ /// Asserts that [map] has a field named [field] and returns it.
+ YamlNode _expect(YamlMap map, String field) {
+ var node = map.nodes[field];
+ if (node != null) return node;
+
+ throw SourceSpanFormatException(
+ 'Missing required field "$field".', map.span, _source);
+ }
+
+ /// Throws an error if a field named [field] exists at this level.
+ void _disallow(String field) {
+ if (!_document.containsKey(field)) return;
+
+ throw SourceSpanFormatException(
+ "$field isn't supported here.",
+ // We need the key as a [YamlNode] to get its span.
+ (_document.nodes.keys.firstWhere((key) => key.value == field)
+ as YamlNode)
+ .span,
+ _source);
+ }
+
+ /// Throws a [SourceSpanFormatException] with [message] about [field].
+ Never _error(String message, String field) {
+ throw SourceSpanFormatException(
+ message, _document.nodes[field]!.span, _source);
+ }
+}
diff --git a/pkgs/test_core/lib/src/runner/configuration/reporters.dart b/pkgs/test_core/lib/src/runner/configuration/reporters.dart
new file mode 100644
index 0000000..0f0fe01
--- /dev/null
+++ b/pkgs/test_core/lib/src/runner/configuration/reporters.dart
@@ -0,0 +1,91 @@
+// Copyright (c) 2017, 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:collection';
+import 'dart:io';
+
+import '../../util/io.dart';
+import '../configuration.dart';
+import '../engine.dart';
+import '../reporter.dart';
+import '../reporter/compact.dart';
+import '../reporter/expanded.dart';
+import '../reporter/failures_only.dart';
+import '../reporter/github.dart';
+import '../reporter/json.dart';
+
+/// Constructs a reporter for the provided engine with the provided
+/// configuration.
+typedef ReporterFactory = Reporter Function(Configuration, Engine, StringSink);
+
+/// Container for a reporter description and corresponding factory.
+class ReporterDetails {
+ final String description;
+ final ReporterFactory factory;
+ ReporterDetails(this.description, this.factory);
+}
+
+/// All reporters and their corresponding details.
+final UnmodifiableMapView<String, ReporterDetails> allReporters =
+ UnmodifiableMapView<String, ReporterDetails>(_allReporters);
+
+final _allReporters = <String, ReporterDetails>{
+ 'expanded': ReporterDetails(
+ 'A separate line for each update.',
+ (config, engine, sink) => ExpandedReporter.watch(engine, sink,
+ color: config.color,
+ printPath: config.testSelections.length > 1 ||
+ Directory(config.testSelections.keys.single).existsSync(),
+ printPlatform: config.suiteDefaults.runtimes.length > 1 ||
+ config.suiteDefaults.compilerSelections != null)),
+ 'compact': ReporterDetails(
+ 'A single line, updated continuously.',
+ (config, engine, sink) => CompactReporter.watch(engine, sink,
+ color: config.color,
+ printPath: config.testSelections.length > 1 ||
+ Directory(config.testSelections.keys.single).existsSync(),
+ printPlatform: config.suiteDefaults.runtimes.length > 1 ||
+ config.suiteDefaults.compilerSelections != null)),
+ 'failures-only': ReporterDetails(
+ 'A separate line for failing tests with no output for passing tests',
+ (config, engine, sink) => FailuresOnlyReporter.watch(engine, sink,
+ color: config.color,
+ printPath: config.testSelections.length > 1 ||
+ Directory(config.testSelections.keys.single).existsSync(),
+ printPlatform: config.suiteDefaults.runtimes.length > 1 ||
+ config.suiteDefaults.compilerSelections != null)),
+ 'github': ReporterDetails(
+ 'A custom reporter for GitHub Actions '
+ '(the default reporter when running on GitHub Actions).',
+ (config, engine, sink) => GithubReporter.watch(engine, sink,
+ printPath: config.testSelections.length > 1 ||
+ Directory(config.testSelections.keys.single).existsSync(),
+ printPlatform: config.suiteDefaults.runtimes.length > 1 ||
+ config.suiteDefaults.compilerSelections != null)),
+ 'json': ReporterDetails(
+ 'A machine-readable format (see '
+ 'https://dart.dev/go/test-docs/json_reporter.md).',
+ (config, engine, sink) =>
+ JsonReporter.watch(engine, sink, isDebugRun: config.debug)),
+ 'silent': ReporterDetails(
+ 'A reporter with no output. '
+ 'May be useful when only the exit code is meaningful.',
+ (config, engine, sink) => SilentReporter()),
+};
+
+final defaultReporter = inTestTests
+ ? 'expanded'
+ : inGithubContext
+ ? 'github'
+ : canUseSpecialChars
+ ? 'compact'
+ : 'expanded';
+
+/// **Do not call this function without express permission from the test package
+/// authors**.
+///
+/// This globally registers a reporter.
+void registerReporter(String name, ReporterDetails reporterDetails) {
+ _allReporters[name] = reporterDetails;
+}
diff --git a/pkgs/test_core/lib/src/runner/configuration/runtime_settings.dart b/pkgs/test_core/lib/src/runner/configuration/runtime_settings.dart
new file mode 100644
index 0000000..e366b4d
--- /dev/null
+++ b/pkgs/test_core/lib/src/runner/configuration/runtime_settings.dart
@@ -0,0 +1,26 @@
+// Copyright (c) 2017, 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 'package:source_span/source_span.dart';
+import 'package:yaml/yaml.dart';
+
+import '../plugin/customizable_platform.dart';
+
+/// User-defined settings for a built-in test runtime.
+final class RuntimeSettings {
+ /// The identifier used to look up the runtime being overridden.
+ final String identifier;
+
+ /// The location that [identifier] was defined in the configuration file.
+ final SourceSpan identifierSpan;
+
+ /// The user's settings for this runtime.
+ ///
+ /// This is a list of settings, from most global to most specific, that will
+ /// eventually be merged using [CustomizablePlatform.mergePlatformSettings].
+ final List<YamlMap> settings;
+
+ RuntimeSettings(this.identifier, this.identifierSpan, List<YamlMap> settings)
+ : settings = List.unmodifiable(settings);
+}
diff --git a/pkgs/test_core/lib/src/runner/configuration/utils.dart b/pkgs/test_core/lib/src/runner/configuration/utils.dart
new file mode 100644
index 0000000..d47526c
--- /dev/null
+++ b/pkgs/test_core/lib/src/runner/configuration/utils.dart
@@ -0,0 +1,16 @@
+// Copyright (c) 2021, 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 'package:collection/collection.dart';
+
+/// Like [mergeMaps], but assumes both maps are unmodifiable and so avoids
+/// creating a new map unnecessarily.
+///
+/// The return value *may or may not* be unmodifiable.
+Map<K, V> mergeUnmodifiableMaps<K, V>(Map<K, V> map1, Map<K, V> map2,
+ {V Function(V, V)? value}) {
+ if (map1.isEmpty) return map2;
+ if (map2.isEmpty) return map1;
+ return mergeMaps(map1, map2, value: value);
+}
diff --git a/pkgs/test_core/lib/src/runner/configuration/values.dart b/pkgs/test_core/lib/src/runner/configuration/values.dart
new file mode 100644
index 0000000..6e2f50a
--- /dev/null
+++ b/pkgs/test_core/lib/src/runner/configuration/values.dart
@@ -0,0 +1,19 @@
+// Copyright (c) 2016, 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:io';
+import 'dart:math' as math;
+
+import 'package:glob/glob.dart';
+
+/// The default number of test suites to run at once.
+///
+/// This defaults to half the available processors, since presumably some of
+/// them will be used for the OS and other processes.
+final defaultConcurrency = math.max(1, Platform.numberOfProcessors ~/ 2);
+
+/// The default filename pattern.
+///
+/// This is stored here so that we don't have to recompile it multiple times.
+final defaultFilename = Glob('*_test.dart');
diff --git a/pkgs/test_core/lib/src/runner/console.dart b/pkgs/test_core/lib/src/runner/console.dart
new file mode 100644
index 0000000..3a4d6fa
--- /dev/null
+++ b/pkgs/test_core/lib/src/runner/console.dart
@@ -0,0 +1,109 @@
+// Copyright (c) 2016, 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 'dart:io';
+import 'dart:math' as math;
+
+import 'package:async/async.dart';
+
+import '../util/io.dart';
+
+/// An interactive console for taking user commands.
+class Console {
+ /// The registered commands.
+ final _commands = <String, _Command>{};
+
+ /// The pending next line of standard input, if we're waiting on one.
+ CancelableOperation? _nextLine;
+
+ /// Whether the console is currently running.
+ bool _running = false;
+
+ /// The terminal escape for red text, or the empty string if this is Windows
+ /// or not outputting to a terminal.
+ final String _red;
+
+ /// The terminal escape for bold text, or the empty string if this is
+ /// Windows or not outputting to a terminal.
+ final String _bold;
+
+ /// The terminal escape for removing test coloring, or the empty string if
+ /// this is Windows or not outputting to a terminal.
+ final String _noColor;
+
+ /// Creates a new [Console].
+ ///
+ /// If [color] is true, this uses Unix terminal colors.
+ Console({bool color = true})
+ : _red = color ? '\u001b[31m' : '',
+ _bold = color ? '\u001b[1m' : '',
+ _noColor = color ? '\u001b[0m' : '' {
+ registerCommand('help', 'Displays this help information.', _displayHelp);
+ }
+
+ /// Registers a command to be run whenever the user types [name].
+ ///
+ /// The [description] should be a one-line description of the command to print
+ /// in the help output. The [body] callback will be called when the user types
+ /// the command.
+ void registerCommand(
+ String name, String description, FutureOr<void> Function() body) {
+ if (_commands.containsKey(name)) {
+ throw ArgumentError('The console already has a command named "$name".');
+ }
+
+ _commands[name] = (name: name, description: description, body: body);
+ }
+
+ /// Starts running the console.
+ ///
+ /// This prints the initial prompt and loops while waiting for user input.
+ void start() {
+ _running = true;
+ unawaited(() async {
+ while (_running) {
+ stdout.write('> ');
+ _nextLine = stdinLines.cancelable((queue) => queue.next);
+ var commandName = await _nextLine!.value;
+ _nextLine = null;
+
+ var command = _commands[commandName];
+ if (command == null) {
+ stderr.writeln(
+ '${_red}Unknown command $_bold$commandName$_noColor$_red.'
+ '$_noColor');
+ } else {
+ await command.body();
+ }
+ }
+ }());
+ }
+
+ /// Stops the console running.
+ void stop() {
+ _running = false;
+ if (_nextLine != null) {
+ stdout.writeln();
+ _nextLine!.cancel();
+ }
+ }
+
+ /// Displays the help info for the console commands.
+ void _displayHelp() {
+ var maxCommandLength =
+ _commands.values.map((command) => command.name.length).reduce(math.max);
+
+ for (var command in _commands.values) {
+ var name = command.name.padRight(maxCommandLength + 4);
+ print('$_bold$name$_noColor${command.description}');
+ }
+ }
+}
+
+typedef _Command = ({
+ String name,
+ String description,
+ FutureOr<void> Function() body,
+});
diff --git a/pkgs/test_core/lib/src/runner/coverage.dart b/pkgs/test_core/lib/src/runner/coverage.dart
new file mode 100644
index 0000000..841bdd7
--- /dev/null
+++ b/pkgs/test_core/lib/src/runner/coverage.dart
@@ -0,0 +1,24 @@
+// Copyright (c) 2019, 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:convert';
+import 'dart:io';
+
+import 'package:path/path.dart' as p;
+
+import 'live_suite_controller.dart';
+
+/// Collects coverage and outputs to the [coveragePath] path.
+Future<void> writeCoverage(
+ String coveragePath, LiveSuiteController controller) async {
+ var suite = controller.liveSuite.suite;
+ var coverage = await controller.liveSuite.suite.gatherCoverage();
+ final outfile = File(p.join(coveragePath,
+ '${suite.path}.${suite.platform.runtime.name.toLowerCase()}.json'))
+ ..createSync(recursive: true);
+ final out = outfile.openWrite();
+ out.write(json.encode(coverage));
+ await out.flush();
+ await out.close();
+}
diff --git a/pkgs/test_core/lib/src/runner/coverage_stub.dart b/pkgs/test_core/lib/src/runner/coverage_stub.dart
new file mode 100644
index 0000000..64f69c7
--- /dev/null
+++ b/pkgs/test_core/lib/src/runner/coverage_stub.dart
@@ -0,0 +1,10 @@
+// Copyright (c) 2019, 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 'live_suite_controller.dart';
+
+Future<void> writeCoverage(
+ String coveragePath, LiveSuiteController controller) =>
+ throw UnsupportedError(
+ 'Coverage is only supported through the test runner.');
diff --git a/pkgs/test_core/lib/src/runner/dart2js_compiler_pool.dart b/pkgs/test_core/lib/src/runner/dart2js_compiler_pool.dart
new file mode 100644
index 0000000..a13a65a
--- /dev/null
+++ b/pkgs/test_core/lib/src/runner/dart2js_compiler_pool.dart
@@ -0,0 +1,130 @@
+// Copyright (c) 2022, 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:convert';
+import 'dart:io';
+
+import 'package:path/path.dart' as p;
+
+import '../util/dart.dart';
+import '../util/io.dart';
+import '../util/package_config.dart';
+import 'compiler_pool.dart';
+import 'suite.dart';
+
+/// A regular expression matching the first status line printed by dart2js.
+final _dart2jsStatus =
+ RegExp(r'^Dart file \(.*\) compiled to JavaScript: .*\n?');
+
+/// A pool of `dart2js` instances.
+///
+/// This limits the number of compiler instances running concurrently.
+class Dart2JsCompilerPool extends CompilerPool {
+ /// Extra arguments to pass to dart2js.
+ final List<String> _extraArgs;
+
+ /// The currently-active dart2js processes.
+ final _processes = <Process>{};
+
+ /// Creates a compiler pool that multiple instances of `dart2js` at once.
+ Dart2JsCompilerPool([Iterable<String>? extraArgs])
+ : _extraArgs = extraArgs?.toList() ?? const [];
+
+ /// Compiles [code] to [path].
+ ///
+ /// This wraps the Dart code in the standard browser-testing wrapper.
+ ///
+ /// The returned [Future] will complete once the `dart2js` process completes
+ /// *and* all its output has been printed to the command line.
+ @override
+ Future compileInternal(
+ String code, String path, SuiteConfiguration suiteConfig) {
+ return withTempDir((dir) async {
+ var wrapperPath = p.join(dir, 'runInBrowser.dart');
+ File(wrapperPath).writeAsStringSync(code);
+
+ var args = [
+ 'compile',
+ 'js',
+ for (var experiment in enabledExperiments)
+ '--enable-experiment=$experiment',
+ '--enable-asserts',
+ wrapperPath,
+ '--out=$path',
+ '--packages=${await packageConfigUri}',
+ '--disable-program-split',
+ ..._extraArgs,
+ ...suiteConfig.dart2jsArgs
+ ];
+
+ if (config.color) args.add('--enable-diagnostic-colors');
+
+ var process = await Process.start(Platform.resolvedExecutable, args);
+ if (closed) {
+ process.kill();
+ return;
+ }
+
+ _processes.add(process);
+
+ /// Wait until the process is entirely done to print out any output.
+ /// This can produce a little extra time for users to wait with no
+ /// update, but it also avoids some really nasty-looking interleaved
+ /// output. Write both stdout and stderr to the same buffer in case
+ /// they're intended to be printed in order.
+ var buffer = StringBuffer();
+
+ await Future.wait([
+ process.stdout.transform(utf8.decoder).forEach(buffer.write),
+ process.stderr.transform(utf8.decoder).forEach(buffer.write),
+ ]);
+
+ var exitCode = await process.exitCode;
+ _processes.remove(process);
+ if (closed) return;
+
+ var output = buffer.toString().replaceFirst(_dart2jsStatus, '');
+ if (output.isNotEmpty) print(output);
+
+ if (exitCode != 0) throw 'dart2js failed.';
+
+ _fixSourceMap('$path.map');
+ });
+ }
+
+ /// Fix up the source map at [mapPath] so that it points to absolute file:
+ /// URIs that are resolvable by the browser.
+ void _fixSourceMap(String mapPath) {
+ var map = jsonDecode(File(mapPath).readAsStringSync()) as Map;
+ var root = map['sourceRoot'] as String;
+
+ final mapUri = p.toUri(mapPath);
+ map.cast<String, List<Object?>>().update(
+ 'sources',
+ (sources) => [
+ for (var source in sources)
+ switch (Uri.parse('$root$source')) {
+ Uri(hasScheme: true) && final uri => uri.toString(),
+ Uri(:final path) when path.endsWith('/runInBrowser.dart') => '',
+ final uri => mapUri.resolveUri(uri).toString(),
+ }
+ ],
+ );
+
+ File(mapPath).writeAsStringSync(jsonEncode(map));
+ }
+
+ /// Closes the compiler pool.
+ ///
+ /// This kills all currently-running compilers and ensures that no more will
+ /// be started. It returns a [Future] that completes once all the compilers
+ /// have been killed and all resources released.
+ @override
+ Future<void> closeInternal() async {
+ await Future.wait(_processes.map((process) async {
+ process.kill();
+ await process.exitCode;
+ }));
+ }
+}
diff --git a/pkgs/test_core/lib/src/runner/debugger.dart b/pkgs/test_core/lib/src/runner/debugger.dart
new file mode 100644
index 0000000..5e59d88
--- /dev/null
+++ b/pkgs/test_core/lib/src/runner/debugger.dart
@@ -0,0 +1,219 @@
+// Copyright (c) 2016, 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:async/async.dart';
+
+import '../util/async.dart';
+import '../util/io.dart';
+import 'configuration.dart';
+import 'console.dart';
+import 'engine.dart';
+import 'load_suite.dart';
+import 'reporter.dart';
+import 'runner_suite.dart';
+
+/// Runs [loadSuite] in debugging mode.
+///
+/// Runs the suite's tests using [engine]. The [reporter] should already be
+/// watching [engine], and the [config] should contain the user configuration
+/// for the test runner.
+///
+/// Returns a [CancelableOperation] that will complete once the suite has
+/// finished running. If the operation is canceled, the debugger will clean up
+/// any resources it allocated.
+CancelableOperation debug(
+ Engine engine, Reporter reporter, LoadSuite loadSuite) {
+ _Debugger? debugger;
+ var canceled = false;
+ return CancelableOperation.fromFuture(() async {
+ engine.suiteSink.add(loadSuite.changeSuite((runnerSuite) {
+ engine.pause();
+ return runnerSuite;
+ }));
+
+ var suite = await loadSuite.suite;
+ if (canceled || suite == null) return;
+
+ await (debugger = _Debugger(engine, reporter, suite)).run();
+ }(), onCancel: () {
+ canceled = true;
+ // Make sure the load test finishes so the engine can close.
+ engine.resume();
+ debugger?.close();
+ });
+}
+
+// TODO(nweiz): Test using the console and restarting a test once sdk#25369 is
+// fixed and the VM service client is released
+/// A debugger for a single test suite.
+class _Debugger {
+ /// The test runner configuration.
+ final _config = Configuration.current;
+
+ /// The engine that will run the suite.
+ final Engine _engine;
+
+ /// The reporter that's reporting [_engine]'s progress.
+ final Reporter _reporter;
+
+ /// The suite to run.
+ final RunnerSuite _suite;
+
+ /// The console through which the user can control the debugger.
+ ///
+ /// This is only visible when the test environment is paused, so as not to
+ /// overlap with the reporter's reporting.
+ final Console _console;
+
+ /// A completer that's used to manually unpause the test if the debugger is
+ /// closed.
+ final _pauseCompleter = CancelableCompleter<void>();
+
+ /// The subscription to [_suite.onDebugging].
+ StreamSubscription<bool>? _onDebuggingSubscription;
+
+ /// The subscription to [_suite.environment.onRestart].
+ late final StreamSubscription _onRestartSubscription;
+
+ /// Whether [close] has been called.
+ bool _closed = false;
+
+ bool get _json => _config.reporter == 'json';
+
+ _Debugger(this._engine, this._reporter, this._suite)
+ : _console = Console(color: Configuration.current.color) {
+ _console.registerCommand('restart',
+ 'Restart the current test after it finishes running.', _restartTest);
+
+ _onRestartSubscription = _suite.environment.onRestart.listen((_) {
+ _restartTest();
+ });
+ }
+
+ /// Runs the debugger.
+ ///
+ /// This prints information about the suite's debugger, then once the user has
+ /// had a chance to set breakpoints, runs the suite's tests.
+ Future run() async {
+ try {
+ await _pause();
+ if (_closed) return;
+
+ _onDebuggingSubscription = _suite.onDebugging.listen((debugging) {
+ if (debugging) {
+ _onDebugging();
+ } else {
+ _onNotDebugging();
+ }
+ });
+
+ _engine.resume();
+ await _engine.onIdle.first;
+ } finally {
+ close();
+ }
+ }
+
+ /// Prints URLs for the [_suite]'s debugger and waits for the user to tell the
+ /// suite to run.
+ Future _pause() async {
+ if (!_suite.environment.supportsDebugging) return;
+
+ try {
+ if (!_json) {
+ _reporter.pause();
+
+ var bold = _config.color ? '\u001b[1m' : '';
+ var yellow = _config.color ? '\u001b[33m' : '';
+ var noColor = _config.color ? '\u001b[0m' : '';
+ print('');
+
+ var runtime = _suite.platform.runtime;
+ if (runtime.isDartVM) {
+ var url = _suite.environment.observatoryUrl;
+ if (url == null) {
+ print('${yellow}Observatory URL not found.$noColor');
+ } else {
+ print('Observatory URL: $bold$url$noColor');
+ }
+ }
+
+ if (runtime.isHeadless && !runtime.isDartVM) {
+ var url = _suite.environment.remoteDebuggerUrl;
+ if (url == null) {
+ print('${yellow}Remote debugger URL not found.$noColor');
+ } else {
+ print('Remote debugger URL: $bold$url$noColor');
+ }
+ }
+
+ var buffer = StringBuffer('${bold}The test runner is paused.$noColor ');
+ if (runtime.isDartVM) {
+ buffer.write('Open the Observatory ');
+ } else {
+ if (!runtime.isHeadless) {
+ buffer.write('Open the dev console in $runtime ');
+ } else {
+ buffer.write('Open the remote debugger ');
+ }
+ }
+
+ buffer.write("and set breakpoints. Once you're finished, return to "
+ 'this terminal and press Enter.');
+
+ print(wordWrap(buffer.toString()));
+ }
+
+ await inCompletionOrder([
+ _suite.environment.displayPause(),
+ stdinLines.cancelable((queue) => queue.next),
+ _pauseCompleter.operation
+ ]).first;
+ } finally {
+ if (!_json) _reporter.resume();
+ }
+ }
+
+ /// Handles the environment pausing to debug.
+ ///
+ /// This starts the interactive console.
+ void _onDebugging() {
+ if (!_json) _reporter.pause();
+
+ if (!_json) {
+ print('\nEntering debugging console. Type "help" for help.');
+ }
+ _console.start();
+ }
+
+ /// Handles the environment starting up again.
+ ///
+ /// This closes the interactive console.
+ void _onNotDebugging() {
+ if (!_json) _reporter.resume();
+ _console.stop();
+ }
+
+ /// Restarts the current test.
+ void _restartTest() {
+ if (_engine.active.isEmpty) return;
+ var liveTest = _engine.active.single;
+ _engine.restartTest(liveTest);
+ if (!_json) {
+ print(wordWrap(
+ 'Will restart "${liveTest.test.name}" once it finishes running.'));
+ }
+ }
+
+ /// Closes the debugger and releases its resources.
+ void close() {
+ _pauseCompleter.complete();
+ _closed = true;
+ _onDebuggingSubscription?.cancel();
+ _onRestartSubscription.cancel();
+ _console.stop();
+ }
+}
diff --git a/pkgs/test_core/lib/src/runner/engine.dart b/pkgs/test_core/lib/src/runner/engine.dart
new file mode 100644
index 0000000..6a63627
--- /dev/null
+++ b/pkgs/test_core/lib/src/runner/engine.dart
@@ -0,0 +1,553 @@
+// Copyright (c) 2015, 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 'dart:math';
+
+import 'package:async/async.dart' hide Result;
+import 'package:collection/collection.dart';
+import 'package:pool/pool.dart';
+import 'package:test_api/src/backend/group.dart'; // ignore: implementation_imports
+import 'package:test_api/src/backend/invoker.dart'; // ignore: implementation_imports
+import 'package:test_api/src/backend/live_test.dart'; // ignore: implementation_imports
+import 'package:test_api/src/backend/live_test_controller.dart'; // ignore: implementation_imports
+import 'package:test_api/src/backend/message.dart'; // ignore: implementation_imports
+import 'package:test_api/src/backend/state.dart'; // ignore: implementation_imports
+import 'package:test_api/src/backend/test.dart'; // ignore: implementation_imports
+
+import 'coverage_stub.dart' if (dart.library.io) 'coverage.dart';
+import 'live_suite.dart';
+import 'live_suite_controller.dart';
+import 'load_suite.dart';
+import 'runner_suite.dart';
+import 'util/iterable_set.dart';
+
+/// An [Engine] manages a run that encompasses multiple test suites.
+///
+/// Test suites are provided by passing them into [suiteSink]. Once all suites
+/// have been provided, the user should close [suiteSink] to indicate this.
+/// [run] won't terminate until [suiteSink] is closed. Suites will be run in the
+/// order they're provided to [suiteSink]. Tests within those suites will
+/// likewise be run in the order they're declared.
+///
+/// The current status of every test is visible via [liveTests]. [onTestStarted]
+/// can also be used to be notified when a test is about to be run.
+///
+/// The engine has some special logic for [LoadSuite]s and the tests they
+/// contain, referred to as "load tests". Load tests exist to provide visibility
+/// into the process of loading test files. As long as that process is
+/// proceeding normally users usually don't care about it, so the engine does
+/// not include them in [liveTests] and other collections.
+/// If a load test fails, it will be added to [failed] and [liveTests].
+///
+/// The test suite loaded by a load suite will be automatically be run by the
+/// engine; it doesn't need to be added to [suiteSink] manually.
+///
+/// Load tests will always be emitted through [onTestStarted] so users can watch
+/// their event streams once they start running.
+class Engine {
+ /// Whether [run] has been called yet.
+ var _runCalled = false;
+
+ /// Whether [close] has been called.
+ var _closed = false;
+
+ /// Whether [close] was called before all the tests finished running.
+ ///
+ /// This is `null` if close hasn't been called and the tests are still
+ /// running, `true` if close was called before the tests finished running, and
+ /// `false` if the tests finished running before close was called.
+ bool? _closedBeforeDone;
+
+ /// The coverage output directory.
+ String? _coverage;
+
+ /// The seed used to generate randomness for test case shuffling.
+ ///
+ /// If null or zero no shuffling will occur.
+ /// The same seed will shuffle the tests in the same way every time.
+ int? testRandomizeOrderingSeed;
+
+ /// Whether to stop running tests after a failure.
+ bool _stopOnFirstFailure;
+
+ /// A pool that limits the number of test suites running concurrently.
+ final Pool _runPool;
+
+ /// A completer that will complete when this engine is unpaused.
+ ///
+ /// `null` if this engine is not paused.
+ Completer? _pauseCompleter;
+
+ /// A future that completes once this is unpaused.
+ ///
+ /// If this engine isn't paused, this future completes immediately.
+ Future get _onUnpaused =>
+ _pauseCompleter == null ? Future.value() : _pauseCompleter!.future;
+
+ /// Whether all tests passed or were skipped.
+ ///
+ /// This fires once all tests have completed and [suiteSink] has been closed.
+ /// This will be `null` if [close] was called before all the tests finished
+ /// running.
+ Future<bool?> get success async {
+ await Future.wait(<Future>[_group.future, _runPool.done], eagerError: true);
+ if (_closedBeforeDone!) return null;
+ return liveTests.every((liveTest) =>
+ liveTest.state.result.isPassing &&
+ liveTest.state.status == Status.complete);
+ }
+
+ /// A group of futures for each test suite.
+ final _group = FutureGroup<void>();
+
+ /// All of the engine's stream subscriptions.
+ final _subscriptions = <StreamSubscription>{};
+
+ /// A sink used to pass [RunnerSuite]s in to the engine to run.
+ ///
+ /// Suites may be added as quickly as they're available; the Engine will only
+ /// run as many as necessary at a time based on its concurrency settings.
+ ///
+ /// Suites added to the sink will be closed by the engine based on its
+ /// internal logic.
+ Sink<RunnerSuite> get suiteSink => DelegatingSink(_suiteController.sink);
+ final _suiteController = StreamController<RunnerSuite>();
+
+ /// All the [RunnerSuite]s added to [suiteSink] so far.
+ ///
+ /// Note that if a [LoadSuite] is added, this will only contain that suite,
+ /// not the suite it loads.
+ Set<RunnerSuite> get addedSuites => UnmodifiableSetView(_addedSuites);
+ final _addedSuites = <RunnerSuite>{};
+
+ /// A broadcast stream that emits each [RunnerSuite] as it's added to the
+ /// engine via [suiteSink].
+ ///
+ /// Note that if a [LoadSuite] is added, this will only return that suite, not
+ /// the suite it loads.
+ ///
+ /// This is guaranteed to fire after the suite is added to [addedSuites].
+ Stream<RunnerSuite> get onSuiteAdded => _onSuiteAddedController.stream;
+ final _onSuiteAddedController = StreamController<RunnerSuite>.broadcast();
+
+ /// A broadcast stream that emits each [LiveSuite] as it's loaded.
+ ///
+ /// Note that unlike [onSuiteAdded], for suites that are loaded using
+ /// [LoadSuite]s, both the [LoadSuite] and the suite it loads will eventually
+ /// be emitted by this stream.
+ Stream<LiveSuite> get onSuiteStarted => _onSuiteStartedController.stream;
+ final _onSuiteStartedController = StreamController<LiveSuite>.broadcast();
+
+ /// All the currently-known tests that have run or are running.
+ ///
+ /// These are [LiveTest]s, representing the in-progress state of each test.
+ /// Tests that have not yet begun running are marked [Status.pending]; tests
+ /// that have finished are marked [Status.complete].
+ ///
+ /// This is guaranteed to contain the same tests as the union of [passed],
+ /// [skipped], [failed], and [active].
+ ///
+ /// [LiveTest.run] must not be called on these tests.
+ Set<LiveTest> get liveTests =>
+ UnionSet.from([passed, skipped, failed, IterableSet(active)],
+ disjoint: true);
+
+ /// A stream that emits each [LiveTest] as it's about to start running.
+ ///
+ /// This is guaranteed to fire before [LiveTest.onStateChange] first fires.
+ Stream<LiveTest> get onTestStarted => _onTestStartedGroup.stream;
+ final _onTestStartedGroup = StreamGroup<LiveTest>.broadcast();
+
+ /// The set of tests that have completed and been marked as passing.
+ Set<LiveTest> get passed => _passedGroup.set;
+ final _passedGroup = UnionSetController<LiveTest>(disjoint: true);
+
+ /// The set of tests that have completed and been marked as skipped.
+ Set<LiveTest> get skipped => _skippedGroup.set;
+ final _skippedGroup = UnionSetController<LiveTest>(disjoint: true);
+
+ /// The set of tests that have completed and been marked as failing or error.
+ Set<LiveTest> get failed => _failedGroup.set;
+ final _failedGroup = UnionSetController<LiveTest>(disjoint: true);
+
+ /// The tests that are still running, in the order they began running.
+ List<LiveTest> get active => UnmodifiableListView(_active);
+ final _active = QueueList<LiveTest>();
+
+ /// The suites that are still loading, in the order they began.
+ List<LiveTest> get activeSuiteLoads =>
+ UnmodifiableListView(_activeSuiteLoads);
+ final _activeSuiteLoads = <LiveTest>{};
+
+ /// The set of tests that have been marked for restarting.
+ ///
+ /// This is always a subset of [active]. Once a test in here has finished
+ /// running, it's run again.
+ final _restarted = <LiveTest>{};
+
+ /// Whether this engine is idle—that is, not currently executing a test.
+ bool get isIdle => _group.isIdle;
+
+ /// A broadcast stream that fires an event whenever [isIdle] switches from
+ /// `false` to `true`.
+ Stream get onIdle => _group.onIdle;
+
+ /// Creates an [Engine] that will run all tests provided via [suiteSink].
+ ///
+ /// [concurrency] controls how many suites are loaded and ran at once, and
+ /// defaults to 1.
+ ///
+ /// [testRandomizeOrderingSeed] configures test case shuffling within each
+ /// test suite.
+ /// Any non-zero value will enable shuffling using this value as a seed.
+ /// Omitting this argument or passing `0` disables shuffling.
+ ///
+ /// [coverage] specifies a directory to output coverage information.
+ ///
+ /// If [stopOnFirstFailure] then a single failing test will cause the engine
+ /// to [close] and stop ruunning further tests.
+ Engine({
+ int? concurrency,
+ String? coverage,
+ this.testRandomizeOrderingSeed,
+ bool stopOnFirstFailure = false,
+ }) : _runPool = Pool(concurrency ?? 1),
+ _stopOnFirstFailure = stopOnFirstFailure,
+ _coverage = coverage {
+ _group.future.then((_) {
+ _onTestStartedGroup.close();
+ _onSuiteStartedController.close();
+ _closedBeforeDone ??= false;
+ }).onError((_, __) {
+ // Don't top-level errors. They'll be thrown via [success] anyway.
+ });
+ }
+
+ /// Creates an [Engine] that will run all tests in [suites].
+ ///
+ /// An engine constructed this way will automatically close its [suiteSink],
+ /// meaning that no further suites may be provided.
+ ///
+ /// [concurrency] controls how many suites are run at once. If [runSkipped] is
+ /// `true`, skipped tests will be run as though they weren't skipped.
+ factory Engine.withSuites(List<RunnerSuite> suites,
+ {int? concurrency, String? coverage, bool stopOnFirstFailure = false}) {
+ var engine = Engine(
+ concurrency: concurrency,
+ coverage: coverage,
+ stopOnFirstFailure: stopOnFirstFailure,
+ );
+ for (var suite in suites) {
+ engine.suiteSink.add(suite);
+ }
+ engine.suiteSink.close();
+ return engine;
+ }
+
+ /// Runs all tests in all suites defined by this engine.
+ ///
+ /// This returns `true` if all tests succeed, and `false` otherwise. It will
+ /// only return once all tests have finished running and [suiteSink] has been
+ /// closed.
+ ///
+ /// If [success] completes with `null` this will complete with `null`.
+ Future<bool?> run() {
+ if (_runCalled) {
+ throw StateError('Engine.run() may not be called more than once.');
+ }
+ _runCalled = true;
+
+ var subscription = _suiteController.stream.listen(null);
+ subscription
+ ..onData((suite) {
+ _addedSuites.add(suite);
+ _onSuiteAddedController.add(suite);
+
+ _group.add(() async {
+ var resource = await _runPool.request();
+ LiveSuiteController? controller;
+ try {
+ if (suite is LoadSuite) {
+ await _onUnpaused;
+ controller = await _addLoadSuite(suite);
+ if (controller == null) return;
+ } else {
+ controller = LiveSuiteController(suite);
+ }
+
+ _addLiveSuite(controller.liveSuite);
+
+ if (_closed) return;
+ await _runGroup(controller, controller.liveSuite.suite.group, []);
+ controller.noMoreLiveTests();
+ if (_coverage != null) await writeCoverage(_coverage!, controller);
+ } finally {
+ resource.allowRelease(() => controller?.close());
+ }
+ }());
+ })
+ ..onDone(() {
+ _subscriptions.remove(subscription);
+ _onSuiteAddedController.close();
+ _group.close();
+ _runPool.close();
+ });
+ _subscriptions.add(subscription);
+
+ return success;
+ }
+
+ /// Runs all the entries in [group] in sequence.
+ ///
+ /// [suiteController] is the controller fo the suite that contains [group].
+ /// [parents] is a list of groups that contain [group]. It may be modified,
+ /// but it's guaranteed to be in its original state once this function has
+ /// finished.
+ Future _runGroup(LiveSuiteController suiteController, Group group,
+ List<Group> parents) async {
+ parents.add(group);
+ try {
+ var suiteConfig = suiteController.liveSuite.suite.config;
+ var skipGroup = !suiteConfig.runSkipped && group.metadata.skip;
+ var setUpAllSucceeded = true;
+ if (!skipGroup && group.setUpAll != null) {
+ var liveTest = group.setUpAll!
+ .load(suiteController.liveSuite.suite, groups: parents);
+ await _runLiveTest(suiteController, liveTest, countSuccess: false);
+ setUpAllSucceeded = liveTest.state.result.isPassing;
+ }
+
+ if (!_closed && setUpAllSucceeded) {
+ // shuffle the group entries
+ var entries = group.entries.toList();
+ if (suiteConfig.allowTestRandomization &&
+ testRandomizeOrderingSeed != null &&
+ testRandomizeOrderingSeed! > 0) {
+ entries.shuffle(Random(testRandomizeOrderingSeed));
+ }
+
+ for (var entry in entries) {
+ if (_closed) return;
+
+ if (entry is Group) {
+ await _runGroup(suiteController, entry, parents);
+ } else if (!suiteConfig.runSkipped && entry.metadata.skip) {
+ await _runSkippedTest(suiteController, entry as Test, parents);
+ } else {
+ var test = entry as Test;
+ await _runLiveTest(suiteController,
+ test.load(suiteController.liveSuite.suite, groups: parents));
+ }
+ }
+ }
+
+ // Even if we're closed or setUpAll failed, we want to run all the
+ // teardowns to ensure that any state is properly cleaned up.
+ if (!skipGroup && group.tearDownAll != null) {
+ var liveTest = group.tearDownAll!
+ .load(suiteController.liveSuite.suite, groups: parents);
+ await _runLiveTest(suiteController, liveTest, countSuccess: false);
+ if (_closed) await liveTest.close();
+ }
+ } finally {
+ parents.remove(group);
+ }
+ }
+
+ /// Runs [liveTest] using [suiteController].
+ ///
+ /// If [countSuccess] is `true` (the default), the test is put into [passed]
+ /// if it succeeds. Otherwise, it's removed from [liveTests] entirely.
+ Future _runLiveTest(LiveSuiteController suiteController, LiveTest liveTest,
+ {bool countSuccess = true}) async {
+ await _onUnpaused;
+ _active.add(liveTest);
+
+ var subscription = liveTest.onStateChange.listen(null);
+ subscription
+ ..onData((state) {
+ if (state.status != Status.complete) return;
+ _active.remove(liveTest);
+ })
+ ..onDone(() {
+ _subscriptions.remove(subscription);
+ });
+ _subscriptions.add(subscription);
+
+ suiteController.reportLiveTest(liveTest, countSuccess: countSuccess);
+
+ // Schedule a microtask to ensure that [onTestStarted] fires before the
+ // first [LiveTest.onStateChange] event.
+ await Future.microtask(liveTest.run);
+
+ // Once the test finishes, use [new Future] to do a coarse-grained event
+ // loop pump to avoid starving non-microtask events.
+ await Future(() {});
+
+ if (!_restarted.contains(liveTest)) {
+ if (_stopOnFirstFailure && liveTest.state.result.isFailing) {
+ unawaited(close());
+ }
+ return;
+ }
+ await _runLiveTest(suiteController, liveTest.copy(),
+ countSuccess: countSuccess);
+ _restarted.remove(liveTest);
+ }
+
+ /// Runs a dummy [LiveTest] for a test marked as "skip".
+ ///
+ /// [suiteController] is the controller for the suite that contains [test].
+ /// [parents] is a list of groups that contain [test].
+ Future _runSkippedTest(LiveSuiteController suiteController, Test test,
+ List<Group> parents) async {
+ await _onUnpaused;
+ var skipped = LocalTest(test.name, test.metadata, () {}, trace: test.trace);
+
+ late LiveTestController controller;
+ controller =
+ LiveTestController(suiteController.liveSuite.suite, skipped, () {
+ controller.setState(const State(Status.running, Result.success));
+ controller.setState(const State(Status.running, Result.skipped));
+
+ if (skipped.metadata.skipReason != null) {
+ controller
+ .message(Message.skip('Skip: ${skipped.metadata.skipReason}'));
+ }
+
+ controller.setState(const State(Status.complete, Result.skipped));
+ controller.completer.complete();
+ }, () {}, groups: parents);
+
+ return await _runLiveTest(suiteController, controller);
+ }
+
+ /// Closes [liveTest] and tells the engine to re-run it once it's done
+ /// running.
+ ///
+ /// Returns the same future as [LiveTest.close].
+ Future restartTest(LiveTest liveTest) async {
+ if (_activeSuiteLoads.contains(liveTest)) {
+ throw ArgumentError("Can't restart a load test.");
+ }
+
+ if (!_active.contains(liveTest)) {
+ throw StateError("Can't restart inactive test "
+ '"${liveTest.test.name}".');
+ }
+
+ _restarted.add(liveTest);
+ _active.remove(liveTest);
+ await liveTest.close();
+ }
+
+ /// Runs [suite] and returns the [LiveSuiteController] for the suite it loads.
+ ///
+ /// Returns `null` if the suite fails to load.
+ Future<LiveSuiteController?> _addLoadSuite(LoadSuite suite) async {
+ var controller = LiveSuiteController(suite);
+ _addLiveSuite(controller.liveSuite);
+
+ var liveTest = suite.test.load(suite);
+ _activeSuiteLoads.add(liveTest);
+
+ var subscription = liveTest.onStateChange.listen(null);
+ subscription
+ ..onData((state) {
+ if (state.status != Status.complete) return;
+ _activeSuiteLoads.remove(liveTest);
+ })
+ ..onDone(() {
+ _subscriptions.remove(subscription);
+ });
+ _subscriptions.add(subscription);
+
+ controller.reportLiveTest(liveTest, countSuccess: false);
+ controller.noMoreLiveTests();
+
+ // Schedule a microtask to ensure that [onTestStarted] fires before the
+ // first [LiveTest.onStateChange] event.
+ await Future.microtask(liveTest.run);
+
+ var innerSuite = await suite.suite;
+ if (innerSuite == null) return null;
+
+ var innerController = LiveSuiteController(innerSuite);
+ unawaited(innerController.liveSuite.onClose.whenComplete(() {
+ // When the main suite is closed, close the load suite and its test as
+ // well. This doesn't release any resources, but it does close streams
+ // which indicates that the load test won't experience an error in the
+ // future.
+ liveTest.close();
+ controller.close();
+ }));
+
+ return innerController;
+ }
+
+ /// Add [liveSuite] and the information it exposes to the engine's
+ /// informational streams and collections.
+ void _addLiveSuite(LiveSuite liveSuite) {
+ _onSuiteStartedController.add(liveSuite);
+
+ _onTestStartedGroup.add(liveSuite.onTestStarted);
+ _passedGroup.add(liveSuite.passed);
+ _skippedGroup.add(liveSuite.skipped);
+ _failedGroup.add(liveSuite.failed);
+ }
+
+ /// Pauses the engine.
+ ///
+ /// This pauses all streams and keeps any new suites from being loaded or
+ /// tests from being run until [resume] is called.
+ ///
+ /// This does nothing if the engine is already paused. Pauses are *not*
+ /// cumulative.
+ void pause() {
+ if (_pauseCompleter != null) return;
+ _pauseCompleter = Completer();
+ for (var subscription in _subscriptions) {
+ subscription.pause();
+ }
+ }
+
+ void resume() {
+ if (_pauseCompleter == null) return;
+ _pauseCompleter!.complete();
+ _pauseCompleter = null;
+ for (var subscription in _subscriptions) {
+ subscription.resume();
+ }
+ }
+
+ /// Signals that the caller is done paying attention to test results and the
+ /// engine should release any resources it has allocated.
+ ///
+ /// Any actively-running tests are also closed. VM tests are allowed to finish
+ /// running so that any modifications they've made to the filesystem can be
+ /// cleaned up.
+ ///
+ /// **Note that closing the engine is not the same as closing [suiteSink].**
+ /// Closing [suiteSink] indicates that no more input will be provided, closing
+ /// the engine indicates that no more output should be emitted.
+ Future close() async {
+ _closed = true;
+ if (_closedBeforeDone != null) _closedBeforeDone = true;
+ await _suiteController.close();
+ await _onSuiteAddedController.close();
+
+ // Close the running tests first so that we're sure to wait for them to
+ // finish before we close their suites and cause them to become unloaded.
+ var allLiveTests = liveTests.toSet()..addAll(_activeSuiteLoads);
+ var futures = allLiveTests.map((liveTest) => liveTest.close()).toList();
+
+ // Closing the run pool will close the test suites as soon as their tests
+ // are done. For browser suites this is effectively immediate since their
+ // tests shut down as soon as they're closed, but for VM suites we may need
+ // to wait for tearDowns or tearDownAlls to run.
+ futures.add(_runPool.close());
+ await Future.wait(futures, eagerError: true);
+ }
+}
diff --git a/pkgs/test_core/lib/src/runner/environment.dart b/pkgs/test_core/lib/src/runner/environment.dart
new file mode 100644
index 0000000..7fcba66
--- /dev/null
+++ b/pkgs/test_core/lib/src/runner/environment.dart
@@ -0,0 +1,55 @@
+// Copyright (c) 2015, 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:async/async.dart';
+
+/// The abstract class of environments in which test suites are
+/// loaded—specifically, browsers and the Dart VM.
+abstract class Environment {
+ /// Whether this environment supports interactive debugging.
+ bool get supportsDebugging;
+
+ /// The URL of the Dart VM Observatory for this environment, or `null` if this
+ /// environment doesn't run the Dart VM or the URL couldn't be detected.
+ Uri? get observatoryUrl;
+
+ /// The URL of the remote debugger for this environment, or `null` if it isn't
+ /// enabled.
+ Uri? get remoteDebuggerUrl;
+
+ /// A broadcast stream that emits a `null` event whenever the user tells the
+ /// environment to restart the current test once it's finished.
+ ///
+ /// Never emits an error, and never closes.
+ Stream get onRestart;
+
+ /// Displays information indicating that the test runner is paused.
+ ///
+ /// The returned operation will complete when the user takes action within the
+ /// environment that should unpause the runner. If the runner is unpaused
+ /// elsewhere, the operation should be canceled.
+ CancelableOperation displayPause();
+}
+
+/// The default environment for platform plugins.
+class PluginEnvironment implements Environment {
+ @override
+ final supportsDebugging = false;
+ @override
+ Stream get onRestart => StreamController<void>.broadcast().stream;
+
+ const PluginEnvironment();
+
+ @override
+ Uri? get observatoryUrl => null;
+
+ @override
+ Uri? get remoteDebuggerUrl => null;
+
+ @override
+ CancelableOperation displayPause() => throw UnsupportedError(
+ 'PluginEnvironment.displayPause is not supported.');
+}
diff --git a/pkgs/test_core/lib/src/runner/hack_register_platform.dart b/pkgs/test_core/lib/src/runner/hack_register_platform.dart
new file mode 100644
index 0000000..f5a618d
--- /dev/null
+++ b/pkgs/test_core/lib/src/runner/hack_register_platform.dart
@@ -0,0 +1,36 @@
+// Copyright (c) 2016, 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 'dart:collection';
+
+import 'package:test_api/src/backend/runtime.dart'; // ignore: implementation_imports
+import 'platform.dart';
+
+/// The functions to use to load [_platformPlugins] in all loaders.
+///
+/// **Do not access this outside the test package**.
+final platformCallbacks =
+ UnmodifiableMapView<Runtime, FutureOr<PlatformPlugin> Function()>(
+ _platformCallbacks);
+final _platformCallbacks = <Runtime, FutureOr<PlatformPlugin> Function()>{};
+
+/// **Do not call this function without express permission from the test package
+/// authors**.
+///
+/// Registers a [PlatformPlugin] for [runtimes].
+///
+/// This globally registers a plugin for all [Loader]s. When the runner first
+/// requests that a suite be loaded for one of the given runtimes, this will
+/// call [plugin] to load the platform plugin. It may return either a
+/// [PlatformPlugin] or a `Future<PlatformPlugin>`. That plugin is then
+/// preserved and used to load all suites for all matching runtimes.
+///
+/// This overwrites the default plugins for those runtimes.
+void registerPlatformPlugin(
+ Iterable<Runtime> runtimes, FutureOr<PlatformPlugin> Function() plugin) {
+ for (var runtime in runtimes) {
+ _platformCallbacks[runtime] = plugin;
+ }
+}
diff --git a/pkgs/test_core/lib/src/runner/hybrid_listener.dart b/pkgs/test_core/lib/src/runner/hybrid_listener.dart
new file mode 100644
index 0000000..6a521db
--- /dev/null
+++ b/pkgs/test_core/lib/src/runner/hybrid_listener.dart
@@ -0,0 +1,96 @@
+// Copyright (c) 2016, 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 'dart:isolate';
+
+import 'package:async/async.dart';
+import 'package:stack_trace/stack_trace.dart';
+import 'package:stream_channel/isolate_channel.dart';
+import 'package:stream_channel/stream_channel.dart';
+import 'package:test_api/backend.dart' show RemoteException;
+import 'package:test_api/src/utils.dart'; // ignore: implementation_imports
+
+/// A sink transformer that wraps data and error events so that errors can be
+/// decoded after being JSON-serialized.
+final _transformer = StreamSinkTransformer<dynamic, dynamic>.fromHandlers(
+ handleData: (data, sink) {
+ ensureJsonEncodable(data);
+ sink.add({'type': 'data', 'data': data});
+}, handleError: (error, stackTrace, sink) {
+ sink.add(
+ {'type': 'error', 'error': RemoteException.serialize(error, stackTrace)});
+});
+
+/// Runs the body of a hybrid isolate and communicates its messages, errors, and
+/// prints to the main isolate.
+///
+/// The [getMain] function returns the `hybridMain()` method. It's wrapped in a
+/// closure so that, if the method undefined, we can catch the error and notify
+/// the caller of it.
+///
+/// The [data] argument contains two values: a [SendPort] that communicates with
+/// the main isolate, and a message to pass to `hybridMain()`.
+void listen(Function Function() getMain, List data) {
+ var channel = IsolateChannel<Object?>.connectSend(data.first as SendPort);
+ var message = data.last;
+
+ Chain.capture(() {
+ runZoned(() {
+ dynamic /*Function*/ main;
+ try {
+ main = getMain();
+ } on NoSuchMethodError catch (_) {
+ _sendError(channel, 'No top-level hybridMain() function defined.');
+ return;
+ } catch (error, stackTrace) {
+ _sendError(channel, error, stackTrace);
+ return;
+ }
+
+ if (main is! Function) {
+ _sendError(channel, 'Top-level hybridMain is not a function.');
+ return;
+ } else if (main is! void Function(StreamChannel) &&
+ main is! void Function(StreamChannel, Never)) {
+ if (main is void Function(StreamChannel<Never>) ||
+ main is void Function(StreamChannel<Never>, Never)) {
+ _sendError(
+ channel,
+ 'The first parameter to the top-level hybridMain() must be a '
+ 'StreamChannel<dynamic> or StreamChannel<Object?>. More specific '
+ 'types such as StreamChannel<Object> are not supported.');
+ } else {
+ _sendError(channel,
+ 'Top-level hybridMain() function must take one or two arguments.');
+ }
+ return;
+ }
+
+ // Wrap [channel] before passing it to user code so that we can wrap
+ // errors and distinguish user data events from control events sent by the
+ // listener.
+ var transformedChannel = channel.transformSink(_transformer);
+ if (main is void Function(StreamChannel)) {
+ main(transformedChannel);
+ } else {
+ main(transformedChannel, message);
+ }
+ }, zoneSpecification: ZoneSpecification(print: (_, __, ___, line) {
+ channel.sink.add({'type': 'print', 'line': line});
+ }));
+ }, onError: (error, stackTrace) async {
+ _sendError(channel, error, stackTrace);
+ await channel.sink.close();
+ Isolate.current.kill();
+ });
+}
+
+/// Sends a message over [channel] indicating an error from user code.
+void _sendError(StreamChannel channel, Object error, [StackTrace? stackTrace]) {
+ channel.sink.add({
+ 'type': 'error',
+ 'error': RemoteException.serialize(error, stackTrace ?? Chain.current())
+ });
+}
diff --git a/pkgs/test_core/lib/src/runner/live_suite.dart b/pkgs/test_core/lib/src/runner/live_suite.dart
new file mode 100644
index 0000000..771655d
--- /dev/null
+++ b/pkgs/test_core/lib/src/runner/live_suite.dart
@@ -0,0 +1,77 @@
+// Copyright (c) 2016, 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 'package:collection/collection.dart';
+
+import 'package:test_api/src/backend/live_test.dart'; // ignore: implementation_imports
+
+import 'runner_suite.dart';
+
+/// A view of the execution of a test suite.
+///
+/// This is distinct from [Suite] because it represents the progress of running
+/// a suite rather than the suite's contents. It provides events and collections
+/// that give the caller a view into the suite's current state.
+abstract class LiveSuite {
+ /// The suite that's being run.
+ RunnerSuite get suite;
+
+ /// A [Future] that completes once the suite is complete.
+ ///
+ /// Note that even once this completes, the suite may still be running code
+ /// asynchronously. A suite is considered complete once all of its tests are
+ /// complete, but it's possible for a test to continue running even after it's
+ /// been marked complete—see [LiveTest.isComplete] for details.
+ ///
+ /// The [onClose] future can be used to determine when the suite and its tests
+ /// are guaranteed to emit no more events.
+ Future get onComplete;
+
+ /// Whether the suite has been closed.
+ ///
+ /// If this is `true`, no code is running for the suite or any of its tests.
+ /// At this point, the caller can be sure that the suites' tests are all in
+ /// fixed states that will not change in the future.
+ bool get isClosed;
+
+ /// A [Future] that completes when the suite has been closed.
+ ///
+ /// Once this completes, no code is running for the suite or any of its tests.
+ /// At this point, the caller can be sure that the suites' tests are all in
+ /// fixed states that will not change in the future.
+ Future get onClose;
+
+ /// All the currently-known tests in this suite that have run or are running.
+ ///
+ /// This is guaranteed to contain the same tests as the union of [passed],
+ /// [skipped], [failed], and [active].
+ Set<LiveTest> get liveTests => UnionSet.from([
+ passed,
+ skipped,
+ failed,
+ if (active != null) {active!}
+ ]);
+
+ /// A stream that emits each [LiveTest] in this suite as it's about to start
+ /// running.
+ ///
+ /// This is guaranteed to fire before [LiveTest.onStateChange] first fires. It
+ /// will close once all tests the user has selected are run.
+ Stream<LiveTest> get onTestStarted;
+
+ /// The set of tests in this suite that have completed and been marked as
+ /// passing.
+ Set<LiveTest> get passed;
+
+ /// The set of tests in this suite that have completed and been marked as
+ /// skipped.
+ Set<LiveTest> get skipped;
+
+ /// The set of tests in this suite that have completed and been marked as
+ /// failing or error.
+ Set<LiveTest> get failed;
+
+ /// The currently running test in this suite, or `null` if no test is running.
+ LiveTest? get active;
+}
diff --git a/pkgs/test_core/lib/src/runner/live_suite_controller.dart b/pkgs/test_core/lib/src/runner/live_suite_controller.dart
new file mode 100644
index 0000000..15bc797
--- /dev/null
+++ b/pkgs/test_core/lib/src/runner/live_suite_controller.dart
@@ -0,0 +1,154 @@
+// Copyright (c) 2016, 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:async/async.dart' hide Result;
+import 'package:collection/collection.dart';
+import 'package:test_api/src/backend/live_test.dart'; // ignore: implementation_imports
+import 'package:test_api/src/backend/state.dart'; // ignore: implementation_imports
+
+import 'live_suite.dart';
+import 'runner_suite.dart';
+
+/// An implementation of [LiveSuite] that's controlled by a
+/// [LiveSuiteController].
+class _LiveSuite extends LiveSuite {
+ final LiveSuiteController _controller;
+
+ @override
+ RunnerSuite get suite => _controller._suite;
+
+ @override
+ Future get onComplete => _controller._onCompleteGroup.future;
+
+ @override
+ bool get isClosed => _controller._onCloseCompleter.isCompleted;
+
+ @override
+ Future get onClose => _controller._onCloseCompleter.future;
+
+ @override
+ Stream<LiveTest> get onTestStarted =>
+ _controller._onTestStartedController.stream;
+
+ @override
+ Set<LiveTest> get passed => UnmodifiableSetView(_controller._passed);
+
+ @override
+ Set<LiveTest> get skipped => UnmodifiableSetView(_controller._skipped);
+
+ @override
+ Set<LiveTest> get failed => UnmodifiableSetView(_controller._failed);
+
+ @override
+ LiveTest? get active => _controller._active;
+
+ _LiveSuite(this._controller);
+}
+
+/// A controller that drives a [LiveSuite].
+///
+/// This is a utility class to make it easier for [Engine] to create the
+/// [LiveSuite]s exposed by various APIs. The [LiveSuite] is accessible through
+/// [LiveSuiteController.liveSuite]. When a live test is run, it should be
+/// passed to [reportLiveTest], and once tests are finished being run for this
+/// suite, [noMoreLiveTests] should be called. Once the suite should be torn
+/// down, [close] should be called.
+class LiveSuiteController {
+ /// The [LiveSuite] being controlled.
+ late final liveSuite = _LiveSuite(this);
+
+ /// The suite that's being run.
+ final RunnerSuite _suite;
+
+ /// The future group that backs [LiveSuite.onComplete].
+ ///
+ /// This contains all the futures from tests that are run in this suite.
+ final _onCompleteGroup = FutureGroup<void>();
+
+ /// The completer that backs [LiveSuite.onClose].
+ ///
+ /// This is completed when the live suite is closed.
+ final _onCloseCompleter = Completer<void>();
+
+ /// The controller for [LiveSuite.onTestStarted].
+ final _onTestStartedController =
+ StreamController<LiveTest>.broadcast(sync: true);
+
+ /// The set that backs [LiveTest.passed].
+ final _passed = <LiveTest>{};
+
+ /// The set that backs [LiveTest.skipped].
+ final _skipped = <LiveTest>{};
+
+ /// The set that backs [LiveTest.failed].
+ final _failed = <LiveTest>{};
+
+ /// The test exposed through [LiveTest.active].
+ LiveTest? _active;
+
+ /// Creates a controller for a live suite representing running the tests in
+ /// [suite].
+ ///
+ /// Once this is called, the controller assumes responsibility for closing the
+ /// suite. The caller should call [LiveSuiteController.close] rather than
+ /// calling [RunnerSuite.close] directly.
+ LiveSuiteController(this._suite);
+
+ /// Reports the status of [liveTest] through [liveSuite].
+ ///
+ /// The live test is assumed to be a member of this suite. If [countSuccess]
+ /// is `true` (the default), the test is put into [passed] if it succeeds.
+ /// Otherwise, it's removed from [liveTests] entirely.
+ ///
+ /// Throws a [StateError] if called after [noMoreLiveTests].
+ void reportLiveTest(LiveTest liveTest, {bool countSuccess = true}) {
+ if (_onTestStartedController.isClosed) {
+ throw StateError("Can't call reportLiveTest() after noMoreTests().");
+ }
+
+ assert(liveTest.suite == _suite);
+ assert(_active == null);
+
+ _active = liveTest;
+
+ liveTest.onStateChange.listen((state) {
+ if (state.status != Status.complete) return;
+ _active = null;
+
+ if (state.result == Result.skipped) {
+ _skipped.add(liveTest);
+ } else if (state.result != Result.success) {
+ _passed.remove(liveTest);
+ _failed.add(liveTest);
+ } else if (countSuccess) {
+ _passed.add(liveTest);
+ // A passing test that was once failing was retried
+ _failed.remove(liveTest);
+ }
+ });
+
+ _onTestStartedController.add(liveTest);
+
+ _onCompleteGroup.add(liveTest.onComplete);
+ }
+
+ /// Indicates that all the live tests that are going to be provided for this
+ /// suite have already been provided.
+ void noMoreLiveTests() {
+ _onTestStartedController.close();
+ _onCompleteGroup.close();
+ }
+
+ /// Closes the underlying suite.
+ Future close() => _closeMemo.runOnce(() async {
+ try {
+ await _suite.close();
+ } finally {
+ _onCloseCompleter.complete();
+ }
+ });
+ final _closeMemo = AsyncMemoizer<void>();
+}
diff --git a/pkgs/test_core/lib/src/runner/load_exception.dart b/pkgs/test_core/lib/src/runner/load_exception.dart
new file mode 100644
index 0000000..3fbd462
--- /dev/null
+++ b/pkgs/test_core/lib/src/runner/load_exception.dart
@@ -0,0 +1,34 @@
+// Copyright (c) 2015, 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 'package:source_span/source_span.dart';
+
+import '../util/errors.dart';
+
+class LoadException implements Exception {
+ final String path;
+
+ final Object innerError;
+
+ LoadException(this.path, this.innerError);
+
+ @override
+ String toString({bool color = false}) {
+ var buffer = StringBuffer();
+ if (color) buffer.write('\u001b[31m'); // red
+ buffer.write('Failed to load "$path":');
+ if (color) buffer.write('\u001b[0m'); // no color
+
+ var innerString = getErrorMessage(innerError);
+ if (innerError is SourceSpanException) {
+ innerString = (innerError as SourceSpanException)
+ .toString(color: color)
+ .replaceFirst(' of $path', '');
+ }
+
+ buffer.write(innerString.contains('\n') ? '\n' : ' ');
+ buffer.write(innerString);
+ return buffer.toString();
+ }
+}
diff --git a/pkgs/test_core/lib/src/runner/load_suite.dart b/pkgs/test_core/lib/src/runner/load_suite.dart
new file mode 100644
index 0000000..633739a
--- /dev/null
+++ b/pkgs/test_core/lib/src/runner/load_suite.dart
@@ -0,0 +1,220 @@
+// Copyright (c) 2015, 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:stack_trace/stack_trace.dart';
+import 'package:test_api/scaffolding.dart' show Timeout;
+import 'package:test_api/src/backend/group.dart'; // ignore: implementation_imports
+import 'package:test_api/src/backend/invoker.dart'; // ignore: implementation_imports
+import 'package:test_api/src/backend/metadata.dart'; // ignore: implementation_imports
+import 'package:test_api/src/backend/runtime.dart'; // ignore: implementation_imports
+import 'package:test_api/src/backend/suite.dart'; // ignore: implementation_imports
+import 'package:test_api/src/backend/suite_platform.dart'; // ignore: implementation_imports
+import 'package:test_api/src/backend/test.dart'; // ignore: implementation_imports
+
+import '../util/io_stub.dart' if (dart.library.io) '../util/io.dart';
+import 'load_exception.dart';
+import 'plugin/environment.dart';
+import 'runner_suite.dart';
+import 'suite.dart';
+
+/// The timeout for loading a test suite.
+///
+/// We want this to be long enough that even a very large application being
+/// compiled with dart2js doesn't trigger it, but short enough that it fires
+/// before the host kills it. For example, Google's Forge service has a
+/// 15-minute timeout.
+final _timeout = const Duration(minutes: 12);
+
+/// A [Suite] emitted by a [Loader] that provides a test-like interface for
+/// loading a test file.
+///
+/// This is used to expose the current status of test loading to the user. It's
+/// important to provide users visibility into what's taking a long time and
+/// where failures occur. And since some tests may be loaded at the same time as
+/// others are run, it's useful to provide that visibility in the form of a test
+/// suite so that it can integrate well into the existing reporting interface
+/// without too much extra logic.
+///
+/// A suite is constructed with logic necessary to produce a test suite. As with
+/// a normal test body, this logic isn't run until [LiveTest.run] is called. The
+/// suite itself is returned by [suite] once it's available, but any errors or
+/// prints will be emitted through the running [LiveTest].
+class LoadSuite extends Suite implements RunnerSuite {
+ @override
+ final environment = const PluginEnvironment();
+ @override
+ final SuiteConfiguration config;
+ @override
+ final isDebugging = false;
+ @override
+ final onDebugging = StreamController<bool>().stream;
+
+ @override
+ bool get isLoadSuite => true;
+
+ /// A future that completes to the loaded suite once the suite's test has been
+ /// run and completed successfully.
+ ///
+ /// This will return `null` if the suite is unavailable for some reason (for
+ /// example if an error occurred while loading it).
+ Future<RunnerSuite?> get suite async => (await _suiteAndZone)?.suite;
+
+ /// A future that completes to a pair of [suite] and the load test's [Zone].
+ ///
+ /// This will return `null` if the suite is unavailable for some reason (for
+ /// example if an error occurred while loading it).
+ final Future<({RunnerSuite suite, Zone zone})?> _suiteAndZone;
+
+ /// Returns the test that loads the suite.
+ ///
+ /// Load suites are guaranteed to only contain one test. This is a utility
+ /// method for accessing it directly.
+ Test get test => group.entries.single as Test;
+
+ /// Creates a load suite named [name] on [platform].
+ ///
+ /// [body] may return either a [RunnerSuite] or a [Future] that completes to a
+ /// [RunnerSuite]. Its return value is forwarded through [suite], although if
+ /// it throws an error that will be forwarded through the suite's test.
+ ///
+ /// If the the load test is closed before [body] is complete, it will close
+ /// the suite returned by [body] once it completes.
+ factory LoadSuite(String name, SuiteConfiguration config,
+ SuitePlatform platform, FutureOr<RunnerSuite?> Function() body,
+ {String? path}) {
+ var completer = Completer<({RunnerSuite suite, Zone zone})?>.sync();
+ return LoadSuite._(name, config, platform, () {
+ var invoker = Invoker.current;
+ invoker!.addOutstandingCallback();
+
+ unawaited(() async {
+ RunnerSuite? suite;
+ try {
+ suite = await body();
+ } catch (_) {
+ invoker.removeOutstandingCallback();
+ rethrow;
+ }
+ if (completer.isCompleted) {
+ // If the load test has already been closed, close the suite it
+ // generated.
+ await suite?.close();
+ return;
+ }
+
+ completer.complete(
+ suite == null ? null : (suite: suite, zone: Zone.current));
+ invoker.removeOutstandingCallback();
+ }());
+
+ // If the test completes before the body callback, either an out-of-band
+ // error occurred or the test was canceled. Either way, we return a `null`
+ // suite.
+ invoker.liveTest.onComplete.then((_) {
+ if (!completer.isCompleted) completer.complete();
+ });
+
+ // If the test is forcibly closed, let it complete, since load tests don't
+ // have timeouts.
+ invoker.onClose.then((_) => invoker.removeOutstandingCallback());
+ }, completer.future, path: path, ignoreTimeouts: config.ignoreTimeouts);
+ }
+
+ /// A utility constructor for a load suite that just throws [exception].
+ ///
+ /// The suite's name will be based on [exception]'s path.
+ factory LoadSuite.forLoadException(
+ LoadException exception, SuiteConfiguration? config,
+ {SuitePlatform? platform, StackTrace? stackTrace}) {
+ stackTrace ??= Trace.current();
+
+ return LoadSuite(
+ 'loading ${exception.path}',
+ config ?? SuiteConfiguration.empty,
+ platform ?? currentPlatform(Runtime.vm, null),
+ () => Future.error(exception, stackTrace),
+ path: exception.path);
+ }
+
+ /// A utility constructor for a load suite that just emits [suite].
+ factory LoadSuite.forSuite(RunnerSuite suite) {
+ return LoadSuite(
+ 'loading ${suite.path}', suite.config, suite.platform, () => suite,
+ path: suite.path);
+ }
+
+ LoadSuite._(String name, this.config, SuitePlatform platform,
+ void Function() body, this._suiteAndZone,
+ {required bool ignoreTimeouts, String? path})
+ : super(
+ Group.root(
+ [LocalTest(name, Metadata(timeout: Timeout(_timeout)), body)]),
+ platform,
+ path: path,
+ ignoreTimeouts: ignoreTimeouts);
+
+ /// A constructor used by [changeSuite].
+ LoadSuite._changeSuite(LoadSuite old, this._suiteAndZone)
+ : config = old.config,
+ super(old.group, old.platform,
+ path: old.path, ignoreTimeouts: old.ignoreTimeouts);
+
+ /// A constructor used by [filter].
+ LoadSuite._filtered(LoadSuite old, Group filtered)
+ : config = old.config,
+ _suiteAndZone = old._suiteAndZone,
+ super(old.group, old.platform,
+ path: old.path, ignoreTimeouts: old.ignoreTimeouts);
+
+ /// Creates a new [LoadSuite] that's identical to this one, but that
+ /// transforms [suite] once it's loaded.
+ ///
+ /// If [suite] completes to `null`, [change] won't be run. [change] is run
+ /// within the load test's zone, so any errors or prints it emits will be
+ /// associated with that test.
+ LoadSuite changeSuite(RunnerSuite? Function(RunnerSuite) change) {
+ return LoadSuite._changeSuite(this, _suiteAndZone.then((pair) {
+ if (pair == null) return null;
+
+ var (:suite, :zone) = pair;
+ RunnerSuite? newSuite;
+ zone.runGuarded(() {
+ newSuite = change(suite);
+ });
+ return newSuite == null ? null : (suite: newSuite!, zone: zone);
+ }));
+ }
+
+ /// Runs the test and returns the suite.
+ ///
+ /// Rather than emitting errors through a [LiveTest], this just pipes them
+ /// through the return value.
+ Future<RunnerSuite?> getSuite() async {
+ var liveTest = test.load(this);
+ liveTest.onMessage.listen((message) => print(message.text));
+ await liveTest.run();
+
+ if (liveTest.errors.isEmpty) return await suite;
+
+ var error = liveTest.errors.first;
+ await Future<void>.error(error.error, error.stackTrace);
+ throw 'unreachable';
+ }
+
+ @override
+ LoadSuite filter(bool Function(Test) callback) {
+ var filtered = group.filter(callback);
+ filtered ??= Group.root([], metadata: metadata);
+ return LoadSuite._filtered(this, filtered);
+ }
+
+ @override
+ Future close() async {}
+
+ @override
+ Future<Map<String, dynamic>> gatherCoverage() =>
+ throw UnsupportedError('Coverage is not supported for LoadSuite tests.');
+}
diff --git a/pkgs/test_core/lib/src/runner/loader.dart b/pkgs/test_core/lib/src/runner/loader.dart
new file mode 100644
index 0000000..c37105d
--- /dev/null
+++ b/pkgs/test_core/lib/src/runner/loader.dart
@@ -0,0 +1,297 @@
+// Copyright (c) 2015, 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 'dart:io';
+
+import 'package:async/async.dart';
+import 'package:path/path.dart' as p;
+import 'package:source_span/source_span.dart';
+import 'package:test_api/src/backend/group.dart'; // ignore: implementation_imports
+import 'package:test_api/src/backend/invoker.dart'; // ignore: implementation_imports
+import 'package:test_api/src/backend/runtime.dart'; // ignore: implementation_imports
+import 'package:yaml/yaml.dart';
+
+import '../util/io.dart';
+import 'compiler_selection.dart';
+import 'configuration.dart';
+import 'hack_register_platform.dart';
+import 'load_exception.dart';
+import 'load_suite.dart';
+import 'parse_metadata.dart';
+import 'platform.dart';
+import 'plugin/customizable_platform.dart';
+import 'plugin/environment.dart';
+import 'runner_suite.dart';
+import 'suite.dart';
+import 'vm/platform.dart';
+
+/// A class for finding test files and loading them into a runnable form.
+class Loader {
+ /// The test runner configuration.
+ final _config = Configuration.current;
+
+ /// All suites that have been created by the loader.
+ final _suites = <RunnerSuite>{};
+
+ /// Memoizers for platform plugins, indexed by the runtimes they support.
+ final _platformPlugins = <Runtime, AsyncMemoizer<PlatformPlugin>>{};
+
+ /// The functions to use to load [_platformPlugins].
+ ///
+ /// These are passed to the plugins' async memoizers when a plugin is needed.
+ final _platformCallbacks = <Runtime, FutureOr<PlatformPlugin> Function()>{};
+
+ /// A map of all runtimes registered in [_platformCallbacks], indexed by
+ /// their string identifiers.
+ final _runtimesByIdentifier = <String, Runtime>{};
+
+ /// The user-provided settings for runtimes, as a list of settings that will
+ /// be merged together using [CustomizablePlatform.mergePlatformSettings].
+ final _runtimeSettings = <Runtime, List<YamlMap>>{};
+
+ /// The user-provided settings for runtimes.
+ final _parsedRuntimeSettings = <Runtime, Object>{};
+
+ /// All plaforms supported by this [Loader].
+ List<Runtime> get allRuntimes => List.unmodifiable(_platformCallbacks.keys);
+
+ /// The runtime variables supported by this loader, in addition the default
+ /// variables that are always supported.
+ Iterable<String> get _runtimeVariables =>
+ _platformCallbacks.keys.map((runtime) => runtime.identifier);
+
+ /// Creates a new loader that loads tests on platforms defined in
+ /// [Configuration.current].
+ Loader() {
+ _registerPlatformPlugin([Runtime.vm], VMPlatform.new);
+
+ platformCallbacks.forEach((runtime, plugin) {
+ _registerPlatformPlugin([runtime], plugin);
+ });
+
+ _registerCustomRuntimes();
+
+ _config.validateRuntimes(allRuntimes);
+
+ _registerRuntimeOverrides();
+ }
+
+ /// Registers a [PlatformPlugin] for [runtimes].
+ void _registerPlatformPlugin(
+ Iterable<Runtime> runtimes, FutureOr<PlatformPlugin> Function() plugin) {
+ var memoizer = AsyncMemoizer<PlatformPlugin>();
+ for (var runtime in runtimes) {
+ _platformPlugins[runtime] = memoizer;
+ _platformCallbacks[runtime] = plugin;
+ _runtimesByIdentifier[runtime.identifier] = runtime;
+ }
+ }
+
+ /// Registers user-defined runtimes from [Configuration.defineRuntimes].
+ void _registerCustomRuntimes() {
+ for (var customRuntime in _config.defineRuntimes.values) {
+ if (_runtimesByIdentifier.containsKey(customRuntime.identifier)) {
+ throw SourceSpanFormatException(
+ wordWrap(
+ 'The platform "${customRuntime.identifier}" already exists. '
+ 'Use override_platforms to override it.'),
+ customRuntime.identifierSpan);
+ }
+
+ var parent = _runtimesByIdentifier[customRuntime.parent];
+ if (parent == null) {
+ throw SourceSpanFormatException(
+ 'Unknown platform.', customRuntime.parentSpan);
+ }
+
+ var runtime = parent.extend(customRuntime.name, customRuntime.identifier);
+ _platformPlugins[runtime] = _platformPlugins[parent]!;
+ _platformCallbacks[runtime] = _platformCallbacks[parent]!;
+ _runtimesByIdentifier[runtime.identifier] = runtime;
+
+ _runtimeSettings[runtime] = [customRuntime.settings];
+ }
+ }
+
+ /// Registers users' runtime settings from [Configuration.overrideRuntimes].
+ void _registerRuntimeOverrides() {
+ for (var settings in _config.overrideRuntimes.values) {
+ var runtime = _runtimesByIdentifier[settings.identifier];
+ _runtimeSettings
+ .putIfAbsent(runtime!, () => [])
+ .addAll(settings.settings);
+ }
+ }
+
+ /// Returns the [Runtime] registered with this loader that's identified
+ /// by [identifier], or `null` if none can be found.
+ Runtime? findRuntime(String identifier) => _runtimesByIdentifier[identifier];
+
+ /// Loads all test suites in [dir] according to [suiteConfig].
+ ///
+ /// This will load tests from files that match the global configuration's
+ /// filename glob. Any tests that fail to load will be emitted as
+ /// [LoadException]s.
+ ///
+ /// This emits [LoadSuite]s that must then be run to emit the actual
+ /// [RunnerSuite]s defined in the file.
+ Stream<LoadSuite> loadDir(String dir, SuiteConfiguration suiteConfig) {
+ return StreamGroup.merge(
+ Directory(dir).listSync(recursive: true).map((entry) {
+ if (entry is! File || !_config.filename.matches(p.basename(entry.path))) {
+ return const Stream.empty();
+ }
+
+ return loadFile(entry.path, suiteConfig);
+ }));
+ }
+
+ /// Loads a test suite from the file at [path] according to [suiteConfig].
+ ///
+ /// This emits [LoadSuite]s that must then be run to emit the actual
+ /// [RunnerSuite]s defined in the file.
+ ///
+ /// This will emit a [LoadException] if the file fails to load.
+ Stream<LoadSuite> loadFile(
+ String path, SuiteConfiguration suiteConfig) async* {
+ try {
+ suiteConfig = suiteConfig.merge(SuiteConfiguration.fromMetadata(
+ parseMetadata(
+ path, File(path).readAsStringSync(), _runtimeVariables.toSet())));
+ } on ArgumentError catch (_) {
+ // Ignore the analyzer's error, since its formatting is much worse than
+ // the VM's or dart2js's.
+ } on FormatException catch (error, stackTrace) {
+ yield LoadSuite.forLoadException(LoadException(path, error), suiteConfig,
+ stackTrace: stackTrace);
+ return;
+ }
+
+ if (_config.excludeTags.evaluate(suiteConfig.metadata.tags.contains)) {
+ return;
+ }
+
+ for (var runtimeName in suiteConfig.runtimes) {
+ var runtime = findRuntime(runtimeName);
+ if (runtime == null) {
+ throw ArgumentError.value(runtimeName, 'platform', 'Unknown platform');
+ }
+ final compilers = {
+ for (var selection
+ in suiteConfig.compilerSelections ?? <CompilerSelection>[])
+ if (runtime.supportedCompilers.contains(selection.compiler) &&
+ (selection.platformSelector == null ||
+ selection.platformSelector!
+ .evaluate(currentPlatform(runtime, selection.compiler))))
+ selection.compiler,
+ };
+ if (compilers.isEmpty) compilers.add(runtime.defaultCompiler);
+
+ for (var compiler in compilers) {
+ var platform = currentPlatform(runtime, compiler);
+ if (!suiteConfig.metadata.testOn.evaluate(platform)) continue;
+
+ var platformConfig = suiteConfig.forPlatform(platform);
+
+ // Don't load a skipped suite.
+ if (platformConfig.metadata.skip && !platformConfig.runSkipped) {
+ yield LoadSuite.forSuite(RunnerSuite(
+ const PluginEnvironment(),
+ platformConfig,
+ Group.root([LocalTest('(suite)', platformConfig.metadata, () {})],
+ metadata: platformConfig.metadata),
+ platform,
+ path: path));
+ continue;
+ }
+
+ yield LoadSuite('loading $path', platformConfig, platform, () async {
+ var memo = _platformPlugins[platform.runtime]!;
+
+ var retriesLeft = suiteConfig.metadata.retry;
+ while (true) {
+ try {
+ var plugin =
+ await memo.runOnce(_platformCallbacks[platform.runtime]!);
+ _customizePlatform(plugin, platform.runtime);
+ var suite = await plugin.load(path, platform, platformConfig,
+ {'platformVariables': _runtimeVariables.toList()});
+ if (suite != null) _suites.add(suite);
+ return suite;
+ } on Object catch (error, stackTrace) {
+ if (retriesLeft > 0) {
+ retriesLeft--;
+ print('Retrying load of $path in 1s ($retriesLeft remaining)');
+ await Future<void>.delayed(const Duration(seconds: 1));
+ continue;
+ }
+ if (error is LoadException) {
+ rethrow;
+ }
+ await Future<void>.error(LoadException(path, error), stackTrace);
+ return null;
+ }
+ }
+ }, path: path);
+ }
+ }
+ }
+
+ /// Passes user-defined settings to [plugin] if necessary.
+ void _customizePlatform(PlatformPlugin plugin, Runtime runtime) {
+ var parsed = _parsedRuntimeSettings[runtime];
+ if (parsed != null) {
+ (plugin as CustomizablePlatform).customizePlatform(runtime, parsed);
+ return;
+ }
+
+ var settings = _runtimeSettings[runtime];
+ if (settings == null) return;
+
+ if (plugin is CustomizablePlatform) {
+ parsed = settings
+ .map(plugin.parsePlatformSettings)
+ .reduce(plugin.mergePlatformSettings);
+ plugin.customizePlatform(runtime, parsed);
+ _parsedRuntimeSettings[runtime] = parsed;
+ } else {
+ String identifier;
+ SourceSpan span;
+ if (runtime.isChild) {
+ identifier = runtime.parent!.identifier;
+ span = _config.defineRuntimes[runtime.identifier]!.parentSpan;
+ } else {
+ identifier = runtime.identifier;
+ span = _config.overrideRuntimes[runtime.identifier]!.identifierSpan;
+ }
+
+ throw SourceSpanFormatException(
+ 'The "$identifier" platform can\'t be customized.', span);
+ }
+ }
+
+ Future closeEphemeral() async {
+ await Future.wait(_platformPlugins.values.map((memo) async {
+ if (!memo.hasRun) return;
+ await (await memo.future).closeEphemeral();
+ }));
+ }
+
+ /// Closes the loader and releases all resources allocated by it.
+ Future close() => _closeMemo.runOnce(() async {
+ await Future.wait([
+ Future.wait(_platformPlugins.values.map((memo) async {
+ if (!memo.hasRun) return;
+ await (await memo.future).close();
+ })),
+ Future.wait(_suites.map((suite) => suite.close()))
+ ]);
+
+ _platformPlugins.clear();
+ _platformCallbacks.clear();
+ _suites.clear();
+ });
+ final _closeMemo = AsyncMemoizer<void>();
+}
diff --git a/pkgs/test_core/lib/src/runner/no_tests_found_exception.dart b/pkgs/test_core/lib/src/runner/no_tests_found_exception.dart
new file mode 100644
index 0000000..0f65837
--- /dev/null
+++ b/pkgs/test_core/lib/src/runner/no_tests_found_exception.dart
@@ -0,0 +1,13 @@
+// Copyright (c) 2021, 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.
+
+/// An expected exception thrown when there were no tests found to run.
+class NoTestsFoundException implements Exception {
+ final String message;
+
+ NoTestsFoundException(this.message);
+
+ @override
+ String toString() => message;
+}
diff --git a/pkgs/test_core/lib/src/runner/package_version.dart b/pkgs/test_core/lib/src/runner/package_version.dart
new file mode 100644
index 0000000..0ce77d3
--- /dev/null
+++ b/pkgs/test_core/lib/src/runner/package_version.dart
@@ -0,0 +1,23 @@
+// Copyright (c) 2020, 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 'package:package_config/package_config.dart';
+import 'package:path/path.dart' as p;
+
+import '../util/detaching_future.dart';
+import '../util/package_config.dart';
+
+/// A comment which forces the language version to be that of the current
+/// packages default.
+///
+/// If the cwd is not a package, this returns an empty string which ends up
+/// defaulting to the current sdk version.
+Future<String> get rootPackageLanguageVersionComment =>
+ _rootPackageLanguageVersionComment.asFuture;
+final _rootPackageLanguageVersionComment = DetachingFuture(() async {
+ var packageConfig = await loadPackageConfigUri(await packageConfigUri);
+ var rootPackage = packageConfig.packageOf(Uri.file(p.absolute('foo.dart')));
+ if (rootPackage == null) return '// <unknown-language-version>';
+ return '// @dart=${rootPackage.languageVersion}';
+}());
diff --git a/pkgs/test_core/lib/src/runner/parse_metadata.dart b/pkgs/test_core/lib/src/runner/parse_metadata.dart
new file mode 100644
index 0000000..fd2b5ee
--- /dev/null
+++ b/pkgs/test_core/lib/src/runner/parse_metadata.dart
@@ -0,0 +1,514 @@
+// Copyright (c) 2015, 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 'package:analyzer/dart/analysis/utilities.dart';
+import 'package:analyzer/dart/ast/ast.dart';
+import 'package:path/path.dart' as p;
+import 'package:source_span/source_span.dart';
+import 'package:test_api/scaffolding.dart' show Timeout;
+import 'package:test_api/src/backend/metadata.dart'; // ignore: implementation_imports
+import 'package:test_api/src/backend/platform_selector.dart'; // ignore: implementation_imports
+import 'package:test_api/src/backend/util/identifier_regex.dart'; // ignore: implementation_imports
+
+import '../util/dart.dart';
+
+/// Parse the test metadata for the test file at [path] with [contents].
+///
+/// The [platformVariables] are the set of variables that are valid for platform
+/// selectors in suite metadata, in addition to the built-in variables that are
+/// allowed everywhere.
+///
+/// Throws an [AnalysisError] if parsing fails or a [FormatException] if the
+/// test annotations are incorrect.
+Metadata parseMetadata(
+ String path, String contents, Set<String> platformVariables) =>
+ _Parser(path, contents, platformVariables).parse();
+
+/// A parser for test suite metadata.
+class _Parser {
+ /// The path to the test suite.
+ final String _path;
+
+ /// The set of variables that are valid for platform selectors, in addition to
+ /// the built-in variables that are allowed everywhere.
+ final Set<String> _platformVariables;
+
+ /// All annotations at the top of the file.
+ late final List<Annotation> _annotations;
+
+ /// All prefixes defined by imports in this file.
+ late final Set<String> _prefixes;
+
+ /// The actual contents of the file.
+ final String _contents;
+
+ /// The language version override comment if one was present, otherwise null.
+ String? _languageVersionComment;
+
+ _Parser(this._path, this._contents, this._platformVariables) {
+ var result =
+ parseString(content: _contents, path: _path, throwIfDiagnostics: false);
+ var directives = result.unit.directives;
+ _annotations = directives.isEmpty ? [] : directives.first.metadata;
+ _languageVersionComment = result.unit.languageVersionToken?.value();
+
+ // We explicitly *don't* just look for "package:test" imports here,
+ // because it could be re-exported from another library.
+ _prefixes = directives
+ .map((directive) {
+ if (directive is ImportDirective) {
+ return directive.prefix?.name;
+ } else {
+ return null;
+ }
+ })
+ .whereType<String>()
+ .toSet();
+ }
+
+ /// Parses the metadata.
+ Metadata parse() {
+ Timeout? timeout;
+ PlatformSelector? testOn;
+ Object? /*String|bool*/ skip;
+ Map<PlatformSelector, Metadata>? onPlatform;
+ Set<String>? tags;
+ int? retry;
+
+ for (var annotation in _annotations) {
+ var pair =
+ _resolveConstructor(annotation.name, annotation.constructorName);
+ var (name, constructorName) = pair;
+
+ if (name == 'TestOn') {
+ _assertSingle(testOn, 'TestOn', annotation);
+ testOn = _parseTestOn(annotation);
+ } else if (name == 'Timeout') {
+ _assertSingle(timeout, 'Timeout', annotation);
+ timeout = _parseTimeout(annotation, constructorName);
+ } else if (name == 'Skip') {
+ _assertSingle(skip, 'Skip', annotation);
+ skip = _parseSkip(annotation);
+ } else if (name == 'OnPlatform') {
+ _assertSingle(onPlatform, 'OnPlatform', annotation);
+ onPlatform = _parseOnPlatform(annotation);
+ } else if (name == 'Tags') {
+ _assertSingle(tags, 'Tags', annotation);
+ tags = _parseTags(annotation);
+ } else if (name == 'Retry') {
+ retry = _parseRetry(annotation);
+ }
+ }
+
+ return Metadata(
+ testOn: testOn,
+ timeout: timeout,
+ skip: skip == null ? null : true,
+ skipReason: skip is String ? skip : null,
+ onPlatform: onPlatform,
+ tags: tags,
+ retry: retry,
+ languageVersionComment: _languageVersionComment);
+ }
+
+ /// Parses a `@TestOn` annotation.
+ ///
+ /// [annotation] is the annotation.
+ PlatformSelector _parseTestOn(Annotation annotation) =>
+ _parsePlatformSelector(annotation.arguments!.arguments.first);
+
+ /// Parses an [expression] that should contain a string representing a
+ /// [PlatformSelector].
+ PlatformSelector _parsePlatformSelector(Expression expression) {
+ var literal = _parseString(expression);
+ return _contextualize(
+ literal,
+ () => PlatformSelector.parse(literal.stringValue!)
+ ..validate(_platformVariables));
+ }
+
+ /// Parses a `@Retry` annotation.
+ ///
+ /// [annotation] is the annotation.
+ int _parseRetry(Annotation annotation) =>
+ _parseInt(annotation.arguments!.arguments.first);
+
+ /// Parses a `@Timeout` annotation.
+ ///
+ /// [annotation] is the annotation. [constructorName] is the name of the named
+ /// constructor for the annotation, if any.
+ Timeout _parseTimeout(Annotation annotation, String? constructorName) {
+ if (constructorName == 'none') {
+ return Timeout.none;
+ }
+
+ var args = annotation.arguments!.arguments;
+ if (constructorName == null) return Timeout(_parseDuration(args.first));
+ return Timeout.factor(_parseNum(args.first));
+ }
+
+ /// Parses a `Timeout` constructor.
+ Timeout _parseTimeoutConstructor(Expression constructor) {
+ var name = _findConstructorName(constructor, 'Timeout');
+ var arguments = _parseArguments(constructor);
+ if (name == null) return Timeout(_parseDuration(arguments.first));
+ if (name == 'factor') return Timeout.factor(_parseNum(arguments.first));
+ throw SourceSpanFormatException('Invalid timeout', _spanFor(constructor));
+ }
+
+ /// Parses a `@Skip` annotation.
+ ///
+ /// [annotation] is the annotation.
+ ///
+ /// Returns either `true` or a reason string.
+ dynamic _parseSkip(Annotation annotation) {
+ var args = annotation.arguments!.arguments;
+ return args.isEmpty ? true : _parseString(args.first).stringValue;
+ }
+
+ /// Parses a `Skip` constructor.
+ ///
+ /// Returns either `true` or a reason string.
+ dynamic _parseSkipConstructor(Expression constructor) {
+ _findConstructorName(constructor, 'Skip');
+ var arguments = _parseArguments(constructor);
+ return arguments.isEmpty ? true : _parseString(arguments.first).stringValue;
+ }
+
+ /// Parses a `@Tags` annotation.
+ ///
+ /// [annotation] is the annotation.
+ Set<String> _parseTags(Annotation annotation) {
+ return _parseList(annotation.arguments!.arguments.first)
+ .map((tagExpression) {
+ var name = _parseString(tagExpression).stringValue!;
+ if (name.contains(anchoredHyphenatedIdentifier)) return name;
+
+ throw SourceSpanFormatException(
+ 'Invalid tag name. Tags must be (optionally hyphenated) Dart '
+ 'identifiers.',
+ _spanFor(tagExpression));
+ }).toSet();
+ }
+
+ /// Parses an `@OnPlatform` annotation.
+ ///
+ /// [annotation] is the annotation.
+ Map<PlatformSelector, Metadata> _parseOnPlatform(Annotation annotation) {
+ return _parseMap(annotation.arguments!.arguments.first,
+ key: _parsePlatformSelector, value: (value) {
+ var expressions = <AstNode>[];
+ if (value is ListLiteral) {
+ expressions = _parseList(value);
+ } else if (value is InstanceCreationExpression ||
+ value is PrefixedIdentifier ||
+ value is MethodInvocation) {
+ expressions = [value];
+ } else {
+ throw SourceSpanFormatException(
+ 'Expected a Timeout, Skip, or List of those.', _spanFor(value));
+ }
+
+ Timeout? timeout;
+ Object? skip;
+ for (var expression in expressions) {
+ if (expression is InstanceCreationExpression) {
+ var className = expression.constructorName.type.name2.lexeme;
+
+ if (className == 'Timeout') {
+ _assertSingle(timeout, 'Timeout', expression);
+ timeout = _parseTimeoutConstructor(expression);
+ continue;
+ } else if (className == 'Skip') {
+ _assertSingle(skip, 'Skip', expression);
+ skip = _parseSkipConstructor(expression);
+ continue;
+ }
+ } else if (expression is PrefixedIdentifier &&
+ expression.prefix.name == 'Timeout') {
+ if (expression.identifier.name != 'none') {
+ throw SourceSpanFormatException(
+ 'Undefined value.', _spanFor(expression));
+ }
+
+ _assertSingle(timeout, 'Timeout', expression);
+ timeout = Timeout.none;
+ continue;
+ } else if (expression is MethodInvocation) {
+ var className =
+ _typeNameFromMethodInvocation(expression, ['Timeout', 'Skip']);
+ if (className == 'Timeout') {
+ _assertSingle(timeout, 'Timeout', expression);
+ timeout = _parseTimeoutConstructor(expression);
+ continue;
+ } else if (className == 'Skip') {
+ _assertSingle(skip, 'Skip', expression);
+ skip = _parseSkipConstructor(expression);
+ continue;
+ }
+ }
+
+ throw SourceSpanFormatException(
+ 'Expected a Timeout or Skip.', _spanFor(expression));
+ }
+
+ return Metadata.parse(timeout: timeout, skip: skip);
+ });
+ }
+
+ /// Parses a `const Duration` expression.
+ Duration _parseDuration(Expression expression) {
+ _findConstructorName(expression, 'Duration');
+
+ var arguments = _parseArguments(expression);
+ var values = _parseNamedArguments(arguments)
+ .map((key, value) => MapEntry(key, _parseInt(value)));
+
+ return Duration(
+ days: values['days'] ?? 0,
+ hours: values['hours'] ?? 0,
+ minutes: values['minutes'] ?? 0,
+ seconds: values['seconds'] ?? 0,
+ milliseconds: values['milliseconds'] ?? 0,
+ microseconds: values['microseconds'] ?? 0);
+ }
+
+ Map<String, Expression> _parseNamedArguments(
+ NodeList<Expression> arguments) =>
+ {
+ for (var a in arguments.whereType<NamedExpression>())
+ a.name.label.name: a.expression
+ };
+
+ /// Asserts that [existing] is null.
+ ///
+ /// [name] is the name of the annotation and [node] is its location, used for
+ /// error reporting.
+ void _assertSingle(Object? existing, String name, AstNode node) {
+ if (existing == null) return;
+ throw SourceSpanFormatException(
+ 'Only a single $name may be used.', _spanFor(node));
+ }
+
+ NodeList<Expression> _parseArguments(Expression expression) {
+ if (expression is InstanceCreationExpression) {
+ return expression.argumentList.arguments;
+ }
+ if (expression is MethodInvocation) {
+ return expression.argumentList.arguments;
+ }
+ throw SourceSpanFormatException(
+ 'Expected an instantiation', _spanFor(expression));
+ }
+
+ /// Resolves a constructor name from its type [identifier] and its
+ /// [constructorName].
+ ///
+ /// Since the parsed file isn't fully resolved, this is necessary to
+ /// disambiguate between prefixed names and named constructors.
+ (String, String?) _resolveConstructor(
+ Identifier identifier, SimpleIdentifier? constructorName) {
+ // The syntax is ambiguous between named constructors and prefixed
+ // annotations, so we need to resolve that ambiguity using the known
+ // prefixes. The analyzer parses "new x.y()" as prefix "x", annotation "y",
+ // and named constructor null. It parses "new x.y.z()" as prefix "x",
+ // annotation "y", and named constructor "z".
+ String className;
+ String? namedConstructor;
+ if (identifier is PrefixedIdentifier &&
+ !_prefixes.contains(identifier.prefix.name) &&
+ constructorName == null) {
+ className = identifier.prefix.name;
+ namedConstructor = identifier.identifier.name;
+ } else {
+ className = identifier is PrefixedIdentifier
+ ? identifier.identifier.name
+ : identifier.name;
+ if (constructorName != null) namedConstructor = constructorName.name;
+ }
+ return (className, namedConstructor);
+ }
+
+ /// Parses a constructor invocation for [className].
+ ///
+ /// Returns the name of the named constructor used, or null if the default
+ /// constructor is used.
+ /// If [expression] is not an instantiation of a [className] throws.
+ String? _findConstructorName(Expression expression, String className) {
+ if (expression is InstanceCreationExpression) {
+ return _findConstructorNameFromInstantiation(expression, className);
+ }
+ if (expression is MethodInvocation) {
+ return _findConstructorNameFromMethod(expression, className);
+ }
+ throw SourceSpanFormatException(
+ 'Expected a $className.', _spanFor(expression));
+ }
+
+ String? _findConstructorNameFromInstantiation(
+ InstanceCreationExpression constructor, String className) {
+ var actualClassName = constructor.constructorName.type.name2.lexeme;
+ var constructorName = constructor.constructorName.name?.name;
+
+ if (actualClassName != className) {
+ throw SourceSpanFormatException(
+ 'Expected a $className.', _spanFor(constructor));
+ }
+
+ return constructorName;
+ }
+
+ String? _findConstructorNameFromMethod(
+ MethodInvocation constructor, String className) {
+ var target = constructor.target;
+ if (target != null) {
+ // target could be an import prefix or a different class. Assume that
+ // named constructor on a different class won't match the class name we
+ // are looking for.
+ // Example: `test.Timeout()`
+ if (constructor.methodName.name == className) return null;
+ // target is an optionally prefixed class, method is named constructor
+ // Examples: `Timeout.factor(2)`, `test.Timeout.factor(2)`
+ String? parsedName;
+ if (target is SimpleIdentifier) parsedName = target.name;
+ if (target is PrefixedIdentifier) parsedName = target.identifier.name;
+ if (parsedName != className) {
+ throw SourceSpanFormatException(
+ 'Expected a $className.', _spanFor(constructor));
+ }
+ return constructor.methodName.name;
+ }
+ // No target, must be an unnamed constructor
+ // Example `Timeout()`
+ if (constructor.methodName.name != className) {
+ throw SourceSpanFormatException(
+ 'Expected a $className.', _spanFor(constructor));
+ }
+ return null;
+ }
+
+ /// Returns a type from [candidates] that _may_ be a type instantiated by
+ /// [constructor].
+ ///
+ /// This can be fooled - for instance the invocation `foo.Bar()` may look like
+ /// a prefixed instantiation of a `Bar` even though it is a named constructor
+ /// instantiation of a `foo`, or a method invocation on a variable `foo`, or
+ /// ...
+ ///
+ /// Similarly `Baz.another` may look like the named constructor invocation of
+ /// a `Baz`even though it is a prefixed instantiation of an `another`, or a
+ /// method invocation on a variable `Baz`, or ...
+ String? _typeNameFromMethodInvocation(
+ MethodInvocation constructor, List<String> candidates) {
+ var methodName = constructor.methodName.name;
+ // Examples: `Timeout()`, `test.Timeout()`
+ if (candidates.contains(methodName)) return methodName;
+ var target = constructor.target;
+ // Example: `SomeOtherClass()`
+ if (target == null) return null;
+ if (target is SimpleIdentifier) {
+ // Example: `Timeout.factor()`
+ if (candidates.contains(target.name)) return target.name;
+ }
+ if (target is PrefixedIdentifier) {
+ // Looks like `some_prefix.SomeTarget.someMethod` - "SomeTarget" is the
+ // only potential type name.
+ // Example: `test.Timeout.factor()`
+ if (candidates.contains(target.identifier.name)) {
+ return target.identifier.name;
+ }
+ }
+ return null;
+ }
+
+ /// Parses a Map literal.
+ ///
+ /// By default, returns [Expression] keys and values. These can be overridden
+ /// with the [key] and [value] parameters.
+ Map<K, V> _parseMap<K, V>(Expression expression,
+ {K Function(Expression)? key, V Function(Expression)? value}) {
+ key ??= (expression) => expression as K;
+ value ??= (expression) => expression as V;
+
+ if (expression is! SetOrMapLiteral) {
+ throw SourceSpanFormatException('Expected a Map.', _spanFor(expression));
+ }
+
+ var map = <K, V>{};
+ for (var element in expression.elements) {
+ if (element is MapLiteralEntry) {
+ map[key(element.key)] = value(element.value);
+ } else {
+ throw SourceSpanFormatException(
+ 'Expected a map entry.', _spanFor(element));
+ }
+ }
+ return map;
+ }
+
+ /// Parses a List literal.
+ List<Expression> _parseList(Expression expression) {
+ if (expression is! ListLiteral) {
+ throw SourceSpanFormatException('Expected a List.', _spanFor(expression));
+ }
+
+ var list = expression;
+
+ return list.elements.map((e) {
+ if (e is! Expression) {
+ throw SourceSpanFormatException(
+ 'Expected only literal elements.', _spanFor(e));
+ }
+ return e;
+ }).toList();
+ }
+
+ /// Parses a constant number literal.
+ num _parseNum(Expression expression) {
+ if (expression is IntegerLiteral && expression.value != null) {
+ return expression.value!;
+ }
+ if (expression is DoubleLiteral) return expression.value;
+ throw SourceSpanFormatException('Expected a number.', _spanFor(expression));
+ }
+
+ /// Parses a constant int literal.
+ int _parseInt(Expression expression) {
+ if (expression is IntegerLiteral && expression.value != null) {
+ return expression.value!;
+ }
+ throw SourceSpanFormatException(
+ 'Expected an integer.', _spanFor(expression));
+ }
+
+ /// Parses a constant String literal.
+ StringLiteral _parseString(Expression expression) {
+ if (expression is StringLiteral && expression.stringValue != null) {
+ return expression;
+ }
+ throw SourceSpanFormatException(
+ 'Expected a String literal.', _spanFor(expression));
+ }
+
+ /// Creates a [SourceSpan] for [node].
+ SourceSpan _spanFor(AstNode node) {
+ // Load a SourceFile from scratch here since we're only ever going to emit
+ // one error per file anyway.
+ return SourceFile.fromString(_contents, url: p.toUri(_path))
+ .span(node.offset, node.end);
+ }
+
+ /// Runs [fn] and contextualizes any [SourceSpanFormatException]s that occur
+ /// in it relative to [literal].
+ T _contextualize<T>(StringLiteral literal, T Function() fn) {
+ try {
+ return fn();
+ } on SourceSpanFormatException catch (error) {
+ var file = SourceFile.fromString(_contents, url: p.toUri(_path));
+ var span = contextualizeSpan(error.span!, literal, file);
+ if (span == null) rethrow;
+ throw SourceSpanFormatException(error.message, span);
+ }
+ }
+}
diff --git a/pkgs/test_core/lib/src/runner/platform.dart b/pkgs/test_core/lib/src/runner/platform.dart
new file mode 100644
index 0000000..3048052
--- /dev/null
+++ b/pkgs/test_core/lib/src/runner/platform.dart
@@ -0,0 +1,43 @@
+// Copyright (c) 2016, 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 'package:test_api/src/backend/suite_platform.dart'; // ignore: implementation_imports
+
+import 'environment.dart';
+import 'runner_suite.dart';
+import 'suite.dart';
+
+/// A class that defines a platform for which test suites can be loaded.
+///
+/// A minimal plugin must define [loadChannel], which connects to a client in
+/// which the tests are defined. This is enough to support most of the test
+/// runner's functionality.
+///
+/// In order to support interactive debugging, a plugin must override [load] as
+/// well, which returns a [RunnerSuite] that can contain a custom [Environment]
+/// and control debugging metadata such as [RunnerSuite.isDebugging] and
+/// [RunnerSuite.onDebugging]. The plugin must create this suite by calling the
+/// [deserializeSuite] helper function.
+///
+/// A platform plugin can be registered by passing it to [Loader.new]'s
+/// `plugins` parameter.
+abstract class PlatformPlugin {
+ /// Loads the runner suite for the test file at [path] using [platform], with
+ /// [suiteConfig] encoding the suite-specific configuration.
+ ///
+ /// By default, this just calls [loadChannel] and passes its result to
+ /// [deserializeSuite]. However, it can be overridden to provide more
+ /// fine-grained control over the [RunnerSuite], including providing a custom
+ /// implementation of [Environment].
+ ///
+ /// Subclasses overriding this method must call [deserializeSuite] in
+ /// `platform_helpers.dart` to obtain a [RunnerSuiteController]. They must
+ /// pass the opaque [message] parameter to the [deserializeSuite] call.
+ Future<RunnerSuite?> load(String path, SuitePlatform platform,
+ SuiteConfiguration suiteConfig, Map<String, Object?> message);
+
+ Future closeEphemeral() async {}
+
+ Future close() async {}
+}
diff --git a/pkgs/test_core/lib/src/runner/plugin/customizable_platform.dart b/pkgs/test_core/lib/src/runner/plugin/customizable_platform.dart
new file mode 100644
index 0000000..0ded7ae
--- /dev/null
+++ b/pkgs/test_core/lib/src/runner/plugin/customizable_platform.dart
@@ -0,0 +1,55 @@
+// Copyright (c) 2017, 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 'package:test_api/src/backend/runtime.dart'; // ignore: implementation_imports
+import 'package:yaml/yaml.dart';
+
+import './../platform.dart';
+
+/// An interface for [PlatformPlugin]s that support per-platform customization.
+///
+/// If a [PlatformPlugin] implements this, the user will be able to override the
+/// [Runtime]s it supports using the
+/// [`override_platforms`][override_platforms] configuration field, and define
+/// new runtimes based on them using the [`define_platforms`][define_platforms]
+/// field. The custom settings will be passed to the plugin using
+/// [customizePlatform].
+///
+/// [override_platforms]: https://github.com/dart-lang/test/blob/master/pkgs/test/doc/configuration.md#override_platforms
+/// [define_platforms]: https://github.com/dart-lang/test/blob/master/pkgs/test/doc/configuration.md#define_platforms
+///
+/// Plugins that implement this **must** support children of recognized runtimes
+/// (created by [Runtime.extend]) in their [load] methods.
+abstract class CustomizablePlatform<T extends Object> extends PlatformPlugin {
+ /// Parses user-provided [settings] for a custom platform into a
+ /// plugin-defined format.
+ ///
+ /// The [settings] come from a user's configuration file. The parsed output
+ /// will be passed to [customizePlatform].
+ ///
+ /// Subclasses should throw [SourceSpanFormatException]s if [settings]
+ /// contains invalid configuration. Unrecognized fields should be ignored if
+ /// possible.
+ T parsePlatformSettings(YamlMap settings);
+
+ /// Merges [settings1] with [settings2] and returns a new settings object that
+ /// includes the configuration of both.
+ ///
+ /// When the settings conflict, [settings2] should take priority.
+ ///
+ /// This is used to merge global settings with local settings, or a custom
+ /// platform's settings with its parent's.
+ T mergePlatformSettings(T settings1, T settings2);
+
+ /// Defines user-provided [settings] for [runtime].
+ ///
+ /// The [runtime] is a runtime this plugin was declared to accept when
+ /// registered with [Loader.registerPlatformPlugin], or a runtime whose
+ /// [Runtime.parent] is one of those runtimes. Subclasses should customize the
+ /// behavior for these runtimes when [loadChannel] or [load] is called with
+ /// the given [runtime], using the [settings] which are parsed by
+ /// [parsePlatformSettings]. This is guaranteed to be called before either
+ /// `load` method.
+ void customizePlatform(Runtime runtime, T settings);
+}
diff --git a/pkgs/test_core/lib/src/runner/plugin/environment.dart b/pkgs/test_core/lib/src/runner/plugin/environment.dart
new file mode 100644
index 0000000..7558d62
--- /dev/null
+++ b/pkgs/test_core/lib/src/runner/plugin/environment.dart
@@ -0,0 +1,29 @@
+// Copyright (c) 2016, 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:async/async.dart';
+
+import '../environment.dart';
+
+/// The default environment for platform plugins.
+class PluginEnvironment implements Environment {
+ @override
+ final supportsDebugging = false;
+ @override
+ Stream<void> get onRestart => StreamController<void>.broadcast().stream;
+
+ const PluginEnvironment();
+
+ @override
+ Uri? get observatoryUrl => null;
+
+ @override
+ Uri? get remoteDebuggerUrl => null;
+
+ @override
+ CancelableOperation displayPause() => throw UnsupportedError(
+ 'PluginEnvironment.displayPause is not supported.');
+}
diff --git a/pkgs/test_core/lib/src/runner/plugin/platform_helpers.dart b/pkgs/test_core/lib/src/runner/plugin/platform_helpers.dart
new file mode 100644
index 0000000..450dedb
--- /dev/null
+++ b/pkgs/test_core/lib/src/runner/plugin/platform_helpers.dart
@@ -0,0 +1,162 @@
+// Copyright (c) 2016, 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 'dart:io';
+
+import 'package:stack_trace/stack_trace.dart';
+import 'package:stream_channel/stream_channel.dart';
+import 'package:test_api/backend.dart'
+ show Metadata, RemoteException, SuitePlatform;
+import 'package:test_api/src/backend/group.dart'; // ignore: implementation_imports
+import 'package:test_api/src/backend/test.dart'; // ignore: implementation_imports
+
+import '../configuration.dart';
+import '../environment.dart';
+import '../load_exception.dart';
+import '../runner_suite.dart';
+import '../runner_test.dart';
+import '../suite.dart';
+
+/// A helper method for creating a [RunnerSuiteController] containing tests
+/// that communicate over [channel].
+///
+/// This returns a controller so that the caller has a chance to control the
+/// runner suite's debugging state based on plugin-specific logic.
+///
+/// If the suite is closed, this will close [channel].
+///
+/// The [message] parameter is an opaque object passed from the runner to
+/// [PlatformPlugin.load]. Plugins shouldn't interact with it other than to pass
+/// it on to [deserializeSuite].
+///
+/// If [mapper] is passed, it will be used to adjust stack traces for any errors
+/// emitted by tests.
+///
+/// [gatherCoverage] is a callback which returns a hit-map containing merged
+/// coverage report suitable for use with `package:coverage`.
+RunnerSuiteController deserializeSuite(
+ String path,
+ SuitePlatform platform,
+ SuiteConfiguration suiteConfig,
+ Environment environment,
+ StreamChannel<Object?> channel,
+ Object /*Map<String, Object?>*/ message,
+ {Future<Map<String, dynamic>> Function()? gatherCoverage}) {
+ var disconnector = Disconnector<Object?>();
+ var suiteChannel = MultiChannel<Object?>(channel.transform(disconnector));
+
+ suiteChannel.sink.add(<String, Object?>{
+ 'type': 'initial',
+ 'platform': platform.serialize(),
+ 'metadata': suiteConfig.metadata.serialize(),
+ 'asciiGlyphs': Platform.isWindows,
+ 'path': path,
+ 'collectTraces': Configuration.current.reporter == 'json' ||
+ Configuration.current.fileReporters.containsKey('json') ||
+ suiteConfig.testSelections.any(
+ (selection) => selection.line != null || selection.col != null),
+ 'noRetry': Configuration.current.noRetry,
+ 'foldTraceExcept': Configuration.current.foldTraceExcept.toList(),
+ 'foldTraceOnly': Configuration.current.foldTraceOnly.toList(),
+ 'allowDuplicateTestNames': suiteConfig.allowDuplicateTestNames,
+ 'ignoreTimeouts': suiteConfig.ignoreTimeouts,
+ ...message as Map<String, dynamic>,
+ });
+
+ var completer = Completer<Group>();
+
+ var loadSuiteZone = Zone.current;
+ void handleError(Object error, StackTrace stackTrace) {
+ disconnector.disconnect();
+
+ if (completer.isCompleted) {
+ // If we've already provided a controller, send the error to the
+ // LoadSuite. This will cause the virtual load test to fail, which will
+ // notify the user of the error.
+ loadSuiteZone.handleUncaughtError(error, stackTrace);
+ } else {
+ completer.completeError(error, stackTrace);
+ }
+ }
+
+ suiteChannel.stream.cast<Map<String, Object?>>().listen(
+ (response) {
+ switch (response['type'] as String) {
+ case 'print':
+ print(response['line']);
+ break;
+
+ case 'loadException':
+ handleError(LoadException(path, response['message'] as Object),
+ Trace.current());
+ break;
+
+ case 'error':
+ var asyncError = RemoteException.deserialize(
+ response['error'] as Map<String, dynamic>);
+ handleError(
+ LoadException(path, asyncError.error), asyncError.stackTrace);
+ break;
+
+ case 'success':
+ var deserializer = _Deserializer(suiteChannel);
+ completer.complete(
+ deserializer.deserializeGroup(response['root'] as Map));
+ break;
+ }
+ },
+ onError: handleError,
+ onDone: () {
+ if (completer.isCompleted) return;
+ completer.completeError(
+ LoadException(path, 'Connection closed before test suite loaded.'),
+ Trace.current());
+ });
+
+ return RunnerSuiteController(
+ environment, suiteConfig, suiteChannel, completer.future, platform,
+ path: path,
+ onClose: () => disconnector.disconnect().onError(handleError),
+ gatherCoverage: gatherCoverage);
+}
+
+/// A utility class for storing state while deserializing tests.
+class _Deserializer {
+ /// The channel over which tests communicate.
+ final MultiChannel _channel;
+
+ _Deserializer(this._channel);
+
+ /// Deserializes [group] into a concrete [Group].
+ Group deserializeGroup(Map group) {
+ var metadata = Metadata.deserialize(group['metadata'] as Map);
+ return Group(
+ group['name'] as String,
+ (group['entries'] as List).map((entry) {
+ var map = entry as Map;
+ if (map['type'] == 'group') return deserializeGroup(map);
+ return _deserializeTest(map)!;
+ }),
+ metadata: metadata,
+ trace: group['trace'] == null
+ ? null
+ : Trace.parse(group['trace'] as String),
+ setUpAll: _deserializeTest(group['setUpAll'] as Map?),
+ tearDownAll: _deserializeTest(group['tearDownAll'] as Map?));
+ }
+
+ /// Deserializes [test] into a concrete [Test] class.
+ ///
+ /// Returns `null` if [test] is `null`.
+ Test? _deserializeTest(Map? test) {
+ if (test == null) return null;
+
+ var metadata = Metadata.deserialize(test['metadata'] as Map);
+ var trace =
+ test['trace'] == null ? null : Trace.parse(test['trace'] as String);
+ var testChannel = _channel.virtualChannel((test['channel'] as num).toInt());
+ return RunnerTest(test['name'] as String, metadata, trace, testChannel);
+ }
+}
diff --git a/pkgs/test_core/lib/src/runner/plugin/remote_platform_helpers.dart b/pkgs/test_core/lib/src/runner/plugin/remote_platform_helpers.dart
new file mode 100644
index 0000000..8eb2b76
--- /dev/null
+++ b/pkgs/test_core/lib/src/runner/plugin/remote_platform_helpers.dart
@@ -0,0 +1,51 @@
+// Copyright (c) 2016, 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 'package:stream_channel/stream_channel.dart';
+import 'package:test_api/backend.dart'
+ show RemoteListener, StackTraceFormatter, StackTraceMapper;
+
+/// Returns a channel that will emit a serialized representation of the tests
+/// defined in [getMain].
+///
+/// This channel is used to control the tests. Platform plugins should forward
+/// it `deserializeSuite`. It's guaranteed to communicate using only
+/// JSON-serializable values.
+///
+/// Any errors thrown within [getMain], synchronously or not, will be forwarded
+/// to the load test for this suite. Prints will similarly be forwarded to that
+/// test's print stream.
+///
+/// If [hidePrints] is `true` (the default), calls to `print()` within this
+/// suite will not be forwarded to the parent zone's print handler. However, the
+/// caller may want them to be forwarded in (for example) a browser context
+/// where they'll be visible in the development console.
+///
+/// If [beforeLoad] is passed, it's called before the tests have been declared
+/// for this worker.
+StreamChannel<Object?> serializeSuite(Function Function() getMain,
+ {bool hidePrints = true,
+ Future Function(
+ StreamChannel<Object?> Function(String name) suiteChannel)?
+ beforeLoad}) =>
+ RemoteListener.start(
+ getMain,
+ hidePrints: hidePrints,
+ beforeLoad: beforeLoad,
+ );
+
+/// Sets the stack trace mapper for the current test suite.
+///
+/// This is used to convert JavaScript stack traces into their Dart equivalents
+/// using source maps. It should be set before any tests run, usually in the
+/// `onLoad()` callback to [serializeSuite].
+void setStackTraceMapper(StackTraceMapper mapper) {
+ var formatter = StackTraceFormatter.current;
+ if (formatter == null) {
+ throw StateError(
+ 'setStackTraceMapper() may only be called within a test worker.');
+ }
+
+ formatter.configure(mapper: mapper);
+}
diff --git a/pkgs/test_core/lib/src/runner/plugin/shared_platform_helpers.dart b/pkgs/test_core/lib/src/runner/plugin/shared_platform_helpers.dart
new file mode 100644
index 0000000..4fdcf23
--- /dev/null
+++ b/pkgs/test_core/lib/src/runner/plugin/shared_platform_helpers.dart
@@ -0,0 +1,21 @@
+// 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:convert';
+import 'dart:io';
+
+import 'package:async/async.dart';
+import 'package:stream_channel/stream_channel.dart';
+
+/// Converts a raw [Socket] into a [StreamChannel] of JSON objects.
+///
+/// JSON messages are separated by newlines.
+StreamChannel<Object?> jsonSocketStreamChannel(Socket socket) =>
+ StreamChannel.withGuarantees(socket, socket)
+ .cast<List<int>>()
+ .transform(StreamChannelTransformer.fromCodec(utf8))
+ .transformStream(const LineSplitter())
+ .transformSink(StreamSinkTransformer.fromHandlers(
+ handleData: (original, sink) => sink.add('$original\n')))
+ .transform(jsonDocument);
diff --git a/pkgs/test_core/lib/src/runner/reporter.dart b/pkgs/test_core/lib/src/runner/reporter.dart
new file mode 100644
index 0000000..b179337
--- /dev/null
+++ b/pkgs/test_core/lib/src/runner/reporter.dart
@@ -0,0 +1,31 @@
+// Copyright (c) 2015, 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.
+
+/// An interface for classes that watch the progress of an Engine and report it
+/// to the user.
+///
+/// A reporter should subscribe to the Engine's events as soon as it's created.
+abstract class Reporter {
+ /// Pauses the reporter's output.
+ ///
+ /// Subclasses should buffer any events from the engine while they're paused.
+ /// They should also ensure that this does nothing if the reporter is already
+ /// paused.
+ void pause();
+
+ /// Resumes the reporter's output after being [paused].
+ ///
+ /// Subclasses should ensure that this does nothing if the reporter isn't
+ /// paused.
+ void resume();
+}
+
+/// A reporter that prints nothing.
+class SilentReporter implements Reporter {
+ @override
+ void pause() {}
+
+ @override
+ void resume() {}
+}
diff --git a/pkgs/test_core/lib/src/runner/reporter/compact.dart b/pkgs/test_core/lib/src/runner/reporter/compact.dart
new file mode 100644
index 0000000..13ccd11
--- /dev/null
+++ b/pkgs/test_core/lib/src/runner/reporter/compact.dart
@@ -0,0 +1,446 @@
+// Copyright (c) 2015, 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 'dart:io';
+import 'dart:isolate';
+
+import 'package:test_api/src/backend/live_test.dart'; // ignore: implementation_imports
+import 'package:test_api/src/backend/message.dart'; // ignore: implementation_imports
+import 'package:test_api/src/backend/state.dart'; // ignore: implementation_imports
+
+import '../../util/io.dart';
+import '../../util/pretty_print.dart';
+import '../../util/pretty_print.dart' as utils;
+import '../engine.dart';
+import '../load_exception.dart';
+import '../load_suite.dart';
+import '../reporter.dart';
+
+/// A reporter that prints test results to the console in a single
+/// continuously-updating line.
+class CompactReporter implements Reporter {
+ /// Whether the reporter should emit terminal color escapes.
+ final bool _color;
+
+ /// The terminal escape for green text, or the empty string if this is Windows
+ /// or not outputting to a terminal.
+ final String _green;
+
+ /// The terminal escape for red text, or the empty string if this is Windows
+ /// or not outputting to a terminal.
+ final String _red;
+
+ /// The terminal escape for yellow text, or the empty string if this is
+ /// Windows or not outputting to a terminal.
+ final String _yellow;
+
+ /// The terminal escape for gray text, or the empty string if this is
+ /// Windows or not outputting to a terminal.
+ final String _gray;
+
+ /// The terminal escape code for cyan text, or the empty string if this is
+ /// Windows or not outputting to a terminal.
+ final String _cyan;
+
+ /// The terminal escape for bold text, or the empty string if this is
+ /// Windows or not outputting to a terminal.
+ final String _bold;
+
+ /// The terminal escape for removing test coloring, or the empty string if
+ /// this is Windows or not outputting to a terminal.
+ final String _noColor;
+
+ /// The engine used to run the tests.
+ final Engine _engine;
+
+ /// Whether the path to each test's suite should be printed.
+ final bool _printPath;
+
+ /// Whether the platform each test is running on should be printed.
+ final bool _printPlatform;
+
+ /// A stopwatch that tracks the duration of the full run.
+ final _stopwatch = Stopwatch();
+
+ /// Whether we've started [_stopwatch].
+ ///
+ /// We can't just use `_stopwatch.isRunning` because the stopwatch is stopped
+ /// when the reporter is paused.
+ var _stopwatchStarted = false;
+
+ /// The size of `_engine.passed` last time a progress notification was
+ /// printed.
+ int _lastProgressPassed = 0;
+
+ /// The size of `_engine.skipped` last time a progress notification was
+ /// printed.
+ int? _lastProgressSkipped;
+
+ /// The size of `_engine.failed` last time a progress notification was
+ /// printed.
+ int? _lastProgressFailed;
+
+ /// The duration of the test run in seconds last time a progress notification
+ /// was printed.
+ int? _lastProgressElapsed;
+
+ /// The message printed for the last progress notification.
+ String? _lastProgressMessage;
+
+ /// The suffix added to the last progress notification.
+ String? _lastProgressSuffix;
+
+ /// Whether the message printed for the last progress notification was
+ /// truncated.
+ bool? _lastProgressTruncated;
+
+ // Whether a newline has been printed since the last progress line.
+ var _printedNewline = true;
+
+ /// Whether the reporter is paused.
+ var _paused = false;
+
+ // Whether a notice should be logged about enabling stack trace chaining at
+ // the end of all tests running.
+ var _shouldPrintStackTraceChainingNotice = false;
+
+ /// The set of all subscriptions to various streams.
+ final _subscriptions = <StreamSubscription>{};
+
+ final StringSink _sink;
+
+ /// Watches the tests run by [engine] and prints their results to the
+ /// terminal.
+ ///
+ /// If [color] is `true`, this will use terminal colors; if it's `false`, it
+ /// won't. If [printPath] is `true`, this will print the path name as part of
+ /// the test description. Likewise, if [printPlatform] is `true`, this will
+ /// print the platform as part of the test description.
+ static CompactReporter watch(Engine engine, StringSink sink,
+ {required bool color,
+ required bool printPath,
+ required bool printPlatform}) =>
+ CompactReporter._(engine, sink,
+ color: color, printPath: printPath, printPlatform: printPlatform);
+
+ CompactReporter._(this._engine, this._sink,
+ {required bool color,
+ required bool printPath,
+ required bool printPlatform})
+ : _printPath = printPath,
+ _printPlatform = printPlatform,
+ _color = color,
+ _green = color ? '\u001b[32m' : '',
+ _red = color ? '\u001b[31m' : '',
+ _yellow = color ? '\u001b[33m' : '',
+ _gray = color ? '\u001b[90m' : '',
+ _cyan = color ? '\u001b[36m' : '',
+ _bold = color ? '\u001b[1m' : '',
+ _noColor = color ? '\u001b[0m' : '' {
+ _subscriptions.add(_engine.onTestStarted.listen(_onTestStarted));
+
+ // Convert the future to a stream so that the subscription can be paused or
+ // canceled.
+ _subscriptions.add(_engine.success.asStream().listen(_onDone));
+ }
+
+ @override
+ void pause() {
+ if (_paused) return;
+ _paused = true;
+
+ if (!_printedNewline) _sink.writeln('');
+ _printedNewline = true;
+ _stopwatch.stop();
+
+ // Force the next message to be printed, even if it's identical to the
+ // previous one. If the reporter was paused, text was probably printed
+ // during the pause.
+ _lastProgressMessage = null;
+
+ for (var subscription in _subscriptions) {
+ subscription.pause();
+ }
+ }
+
+ @override
+ void resume() {
+ if (!_paused) return;
+ _paused = false;
+
+ if (_stopwatchStarted) _stopwatch.start();
+
+ for (var subscription in _subscriptions) {
+ subscription.resume();
+ }
+ }
+
+ void _cancel() {
+ for (var subscription in _subscriptions) {
+ subscription.cancel();
+ }
+ _subscriptions.clear();
+ }
+
+ /// A callback called when the engine begins running [liveTest].
+ void _onTestStarted(LiveTest liveTest) {
+ if (!_stopwatchStarted) {
+ _stopwatchStarted = true;
+ _stopwatch.start();
+
+ // Keep updating the time even when nothing else is happening.
+ _subscriptions.add(Stream<void>.periodic(const Duration(seconds: 1))
+ .listen((_) => _progressLine(_lastProgressMessage ?? '')));
+ }
+
+ // If this is the first test or suite load to start, print a progress line
+ // so the user knows what's running.
+ if ((_engine.active.length == 1 && _engine.active.first == liveTest) ||
+ (_engine.active.isEmpty &&
+ _engine.activeSuiteLoads.length == 1 &&
+ _engine.activeSuiteLoads.first == liveTest)) {
+ _progressLine(_description(liveTest));
+ }
+
+ _subscriptions.add(liveTest.onStateChange
+ .listen((state) => _onStateChange(liveTest, state)));
+
+ _subscriptions.add(liveTest.onError
+ .listen((error) => _onError(liveTest, error.error, error.stackTrace)));
+
+ _subscriptions.add(liveTest.onMessage.listen((message) {
+ _progressLine(_description(liveTest), truncate: false);
+ if (!_printedNewline) _sink.writeln('');
+ _printedNewline = true;
+
+ var text = message.text;
+ if (message.type == MessageType.skip) text = ' $_yellow$text$_noColor';
+ _sink.writeln(text);
+ }));
+
+ liveTest.onComplete.then((_) {
+ var result = liveTest.state.result;
+ if (result != Result.error && result != Result.failure) return;
+ var quotedName = Platform.isWindows
+ ? '"${liveTest.test.name.replaceAll('"', '"""')}"'
+ : "'${liveTest.test.name.replaceAll("'", r"'\''")}'";
+ _sink.writeln('');
+ _sink.writeln('$_bold${_cyan}To run this test again:$_noColor '
+ '${Platform.executable} test ${liveTest.suite.path} '
+ '-p ${liveTest.suite.platform.runtime.identifier} '
+ '--plain-name $quotedName');
+ });
+ }
+
+ /// A callback called when [liveTest]'s state becomes [state].
+ void _onStateChange(LiveTest liveTest, State state) {
+ if (state.status != Status.complete) return;
+
+ // Errors are printed in [onError]; no need to print them here as well.
+ if (state.result == Result.failure) return;
+ if (state.result == Result.error) return;
+
+ // Always display the name of the oldest active test, unless testing
+ // is finished in which case display the last test to complete.
+ if (_engine.active.isEmpty) {
+ _progressLine(_description(liveTest));
+ } else {
+ _progressLine(_description(_engine.active.first));
+ }
+ }
+
+ /// A callback called when [liveTest] throws [error].
+ void _onError(LiveTest liveTest, Object error, StackTrace stackTrace) {
+ if (!liveTest.test.metadata.chainStackTraces &&
+ !liveTest.suite.isLoadSuite) {
+ _shouldPrintStackTraceChainingNotice = true;
+ }
+
+ if (liveTest.state.status != Status.complete) return;
+
+ _progressLine(_description(liveTest),
+ truncate: false, suffix: ' $_bold$_red[E]$_noColor');
+ if (!_printedNewline) _sink.writeln('');
+ _printedNewline = true;
+
+ if (error is! LoadException) {
+ _sink.writeln(indent(error.toString()));
+ _sink.writeln(indent('$stackTrace'));
+ return;
+ }
+
+ // TODO - what type is this?
+ _sink.writeln(indent(error.toString(color: _color)));
+
+ // Only print stack traces for load errors that come from the user's code.
+ if (error.innerError is! IOException &&
+ error.innerError is! IsolateSpawnException &&
+ error.innerError is! FormatException &&
+ error.innerError is! String) {
+ _sink.writeln(indent('$stackTrace'));
+ }
+ }
+
+ /// A callback called when the engine is finished running tests.
+ ///
+ /// [success] will be `true` if all tests passed, `false` if some tests
+ /// failed, and `null` if the engine was closed prematurely.
+ void _onDone(bool? success) {
+ _cancel();
+ _stopwatch.stop();
+
+ // A null success value indicates that the engine was closed before the
+ // tests finished running, probably because of a signal from the user. We
+ // shouldn't print summary information, we should just make sure the
+ // terminal cursor is on its own line.
+ if (success == null) {
+ if (!_printedNewline) _sink.writeln('');
+ _printedNewline = true;
+ return;
+ }
+
+ if (_engine.liveTests.isEmpty) {
+ if (!_printedNewline) _sink.write('\r');
+ var message = 'No tests ran.';
+ _sink.write(message);
+
+ // Add extra padding to overwrite any load messages.
+ if (!_printedNewline) _sink.write(' ' * (lineLength - message.length));
+ _sink.writeln('');
+ } else if (!success) {
+ for (var liveTest in _engine.active) {
+ _progressLine(_description(liveTest),
+ truncate: false,
+ suffix: ' - did not complete $_bold$_red[E]$_noColor');
+ _sink.writeln('');
+ }
+ _progressLine('Some tests failed.', color: _red);
+ _sink.writeln('');
+ } else if (_engine.passed.isEmpty) {
+ _progressLine('All tests skipped.');
+ _sink.writeln('');
+ } else {
+ _progressLine('All tests passed!');
+ _sink.writeln('');
+ }
+
+ if (_shouldPrintStackTraceChainingNotice) {
+ _sink
+ ..writeln('')
+ ..writeln('Consider enabling the flag chain-stack-traces to '
+ 'receive more detailed exceptions.\n'
+ "For example, 'dart test --chain-stack-traces'.");
+ }
+ }
+
+ /// Prints a line representing the current state of the tests.
+ ///
+ /// [message] goes after the progress report, and may be truncated to fit the
+ /// entire line within [lineLength]. If [color] is passed, it's used as the
+ /// color for [message]. If [suffix] is passed, it's added to the end of
+ /// [message].
+ bool _progressLine(String message,
+ {String? color, bool truncate = true, String? suffix}) {
+ var elapsed = _stopwatch.elapsed.inSeconds;
+
+ // Print nothing if nothing has changed since the last progress line.
+ if (_engine.passed.length == _lastProgressPassed &&
+ _engine.skipped.length == _lastProgressSkipped &&
+ _engine.failed.length == _lastProgressFailed &&
+ message == _lastProgressMessage &&
+ // Don't re-print just because a suffix was removed.
+ (suffix == null || suffix == _lastProgressSuffix) &&
+ // Don't re-print just because the message became re-truncated, because
+ // that doesn't add information.
+ (truncate || !_lastProgressTruncated!) &&
+ // If we printed a newline, that means the last line *wasn't* a progress
+ // line. In that case, we don't want to print a new progress line just
+ // because the elapsed time changed.
+ (_printedNewline || elapsed == _lastProgressElapsed)) {
+ return false;
+ }
+
+ _lastProgressPassed = _engine.passed.length;
+ _lastProgressSkipped = _engine.skipped.length;
+ _lastProgressFailed = _engine.failed.length;
+ _lastProgressElapsed = elapsed;
+ _lastProgressMessage = message;
+ _lastProgressSuffix = suffix;
+ _lastProgressTruncated = truncate;
+
+ if (suffix != null) message += suffix;
+ color ??= '';
+ var duration = _stopwatch.elapsed;
+ var buffer = StringBuffer();
+
+ // \r moves back to the beginning of the current line.
+ buffer.write('\r${_timeString(duration)} ');
+ buffer.write(_green);
+ buffer.write('+');
+ buffer.write(_engine.passed.length);
+ buffer.write(_noColor);
+
+ if (_engine.skipped.isNotEmpty) {
+ buffer.write(_yellow);
+ buffer.write(' ~');
+ buffer.write(_engine.skipped.length);
+ buffer.write(_noColor);
+ }
+
+ if (_engine.failed.isNotEmpty) {
+ buffer.write(_red);
+ buffer.write(' -');
+ buffer.write(_engine.failed.length);
+ buffer.write(_noColor);
+ }
+
+ buffer.write(': ');
+ buffer.write(color);
+
+ // Ensure the line fits within [lineLength]. [buffer] includes the color
+ // escape sequences too. Because these sequences are not visible characters,
+ // we make sure they are not counted towards the limit.
+ var length = withoutColors(buffer.toString()).length;
+ if (truncate) message = utils.truncate(message, lineLength - length);
+ buffer.write(message);
+ buffer.write(_noColor);
+
+ // Pad the rest of the line so that it looks erased.
+ buffer.write(' ' * (lineLength - withoutColors(buffer.toString()).length));
+ _sink.write(buffer.toString());
+
+ _printedNewline = false;
+ return true;
+ }
+
+ /// Returns a representation of [duration] as `MM:SS`.
+ String _timeString(Duration duration) {
+ return "${duration.inMinutes.toString().padLeft(2, '0')}:"
+ "${(duration.inSeconds % 60).toString().padLeft(2, '0')}";
+ }
+
+ /// Returns a description of [liveTest].
+ ///
+ /// This differs from the test's own description in that it may also include
+ /// the suite's name.
+ String _description(LiveTest liveTest) {
+ var name = liveTest.test.name;
+
+ if (_printPath &&
+ liveTest.suite is! LoadSuite &&
+ liveTest.suite.path != null) {
+ name = '${liveTest.suite.path}: $name';
+ }
+
+ if (_printPlatform) {
+ name = '[${liveTest.suite.platform.runtime.name}, '
+ '${liveTest.suite.platform.compiler.name}] $name';
+ }
+
+ if (liveTest.suite is LoadSuite) name = '$_bold$_gray$name$_noColor';
+
+ return name;
+ }
+}
diff --git a/pkgs/test_core/lib/src/runner/reporter/expanded.dart b/pkgs/test_core/lib/src/runner/reporter/expanded.dart
new file mode 100644
index 0000000..be2016c
--- /dev/null
+++ b/pkgs/test_core/lib/src/runner/reporter/expanded.dart
@@ -0,0 +1,347 @@
+// Copyright (c) 2015, 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:test_api/src/backend/live_test.dart'; // ignore: implementation_imports
+import 'package:test_api/src/backend/message.dart'; // ignore: implementation_imports
+import 'package:test_api/src/backend/state.dart'; // ignore: implementation_imports
+
+import '../../util/pretty_print.dart';
+import '../engine.dart';
+import '../load_exception.dart';
+import '../load_suite.dart';
+import '../reporter.dart';
+
+/// A reporter that prints each test on its own line.
+///
+/// This is currently used in place of [CompactReporter] by `lib/test.dart`,
+/// which can't transitively import `dart:io` but still needs access to a runner
+/// so that test files can be run directly. This means that until issue 6943 is
+/// fixed, this must not import `dart:io`.
+class ExpandedReporter implements Reporter {
+ /// Whether the reporter should emit terminal color escapes.
+ final bool _color;
+
+ /// The terminal escape for green text, or the empty string if this is Windows
+ /// or not outputting to a terminal.
+ final String _green;
+
+ /// The terminal escape for red text, or the empty string if this is Windows
+ /// or not outputting to a terminal.
+ final String _red;
+
+ /// The terminal escape for yellow text, or the empty string if this is
+ /// Windows or not outputting to a terminal.
+ final String _yellow;
+
+ /// The terminal escape for gray text, or the empty string if this is
+ /// Windows or not outputting to a terminal.
+ final String _gray;
+
+ /// The terminal escape for bold text, or the empty string if this is
+ /// Windows or not outputting to a terminal.
+ final String _bold;
+
+ /// The terminal escape for removing test coloring, or the empty string if
+ /// this is Windows or not outputting to a terminal.
+ final String _noColor;
+
+ /// The engine used to run the tests.
+ final Engine _engine;
+
+ /// Whether the path to each test's suite should be printed.
+ final bool _printPath;
+
+ /// Whether the platform each test is running on should be printed.
+ final bool _printPlatform;
+
+ /// A stopwatch that tracks the duration of the full run.
+ final _stopwatch = Stopwatch();
+
+ /// The size of `_engine.passed` last time a progress notification was
+ /// printed.
+ int _lastProgressPassed = 0;
+
+ /// The size of `_engine.skipped` last time a progress notification was
+ /// printed.
+ int _lastProgressSkipped = 0;
+
+ /// The size of `_engine.failed` last time a progress notification was
+ /// printed.
+ int _lastProgressFailed = 0;
+
+ /// The message printed for the last progress notification.
+ String _lastProgressMessage = '';
+
+ /// The suffix added to the last progress notification.
+ String? _lastProgressSuffix;
+
+ /// Whether the reporter is paused.
+ var _paused = false;
+
+ // Whether a notice should be logged about enabling stack trace chaining at
+ // the end of all tests running.
+ var _shouldPrintStackTraceChainingNotice = false;
+
+ /// The set of all subscriptions to various streams.
+ final _subscriptions = <StreamSubscription>{};
+
+ final StringSink _sink;
+
+ /// Watches the tests run by [engine] and prints their results to the
+ /// terminal.
+ ///
+ /// If [color] is `true`, this will use terminal colors; if it's `false`, it
+ /// won't. If [printPath] is `true`, this will print the path name as part of
+ /// the test description. Likewise, if [printPlatform] is `true`, this will
+ /// print the platform as part of the test description.
+ static ExpandedReporter watch(Engine engine, StringSink sink,
+ {required bool color,
+ required bool printPath,
+ required bool printPlatform}) =>
+ ExpandedReporter._(engine, sink,
+ color: color, printPath: printPath, printPlatform: printPlatform);
+
+ ExpandedReporter._(this._engine, this._sink,
+ {required bool color,
+ required bool printPath,
+ required bool printPlatform})
+ : _printPath = printPath,
+ _printPlatform = printPlatform,
+ _color = color,
+ _green = color ? '\u001b[32m' : '',
+ _red = color ? '\u001b[31m' : '',
+ _yellow = color ? '\u001b[33m' : '',
+ _gray = color ? '\u001b[90m' : '',
+ _bold = color ? '\u001b[1m' : '',
+ _noColor = color ? '\u001b[0m' : '' {
+ _subscriptions.add(_engine.onTestStarted.listen(_onTestStarted));
+
+ // Convert the future to a stream so that the subscription can be paused or
+ // canceled.
+ _subscriptions.add(_engine.success.asStream().listen(_onDone));
+ }
+
+ @override
+ void pause() {
+ if (_paused) return;
+ _paused = true;
+
+ _stopwatch.stop();
+
+ for (var subscription in _subscriptions) {
+ subscription.pause();
+ }
+ }
+
+ @override
+ void resume() {
+ if (!_paused) return;
+
+ _stopwatch.start();
+
+ for (var subscription in _subscriptions) {
+ subscription.resume();
+ }
+ }
+
+ void _cancel() {
+ for (var subscription in _subscriptions) {
+ subscription.cancel();
+ }
+ _subscriptions.clear();
+ }
+
+ /// A callback called when the engine begins running [liveTest].
+ void _onTestStarted(LiveTest liveTest) {
+ if (liveTest.suite is! LoadSuite) {
+ if (!_stopwatch.isRunning) _stopwatch.start();
+
+ // If this is the first non-load test to start, print a progress line so
+ // the user knows what's running.
+ if (_engine.active.length == 1) _progressLine(_description(liveTest));
+
+ // The engine surfaces load tests when there are no other tests running,
+ // but because the expanded reporter's output is always visible, we don't
+ // emit information about them unless they fail.
+ _subscriptions.add(liveTest.onStateChange
+ .listen((state) => _onStateChange(liveTest, state)));
+ } else if (_engine.active.isEmpty &&
+ _engine.activeSuiteLoads.length == 1 &&
+ _engine.activeSuiteLoads.first == liveTest &&
+ liveTest.test.name.startsWith('loading ')) {
+ // Print a progress line for ongoing suite loading synthetic test since it
+ // may be slow (or stuck) depending on the platform.
+ _progressLine(_description(liveTest));
+ }
+
+ _subscriptions.add(liveTest.onError
+ .listen((error) => _onError(liveTest, error.error, error.stackTrace)));
+
+ _subscriptions.add(liveTest.onMessage.listen((message) {
+ _progressLine(_description(liveTest));
+ var text = message.text;
+ if (message.type == MessageType.skip) text = ' $_yellow$text$_noColor';
+ _sink.writeln(text);
+ }));
+ }
+
+ /// A callback called when [liveTest]'s state becomes [state].
+ void _onStateChange(LiveTest liveTest, State state) {
+ if (state.status != Status.complete) return;
+
+ // If any tests are running, display the name of the oldest active
+ // test.
+ if (_engine.active.isNotEmpty) {
+ _progressLine(_description(_engine.active.first));
+ }
+ }
+
+ /// A callback called when [liveTest] throws [error].
+ void _onError(LiveTest liveTest, Object error, StackTrace stackTrace) {
+ if (!liveTest.test.metadata.chainStackTraces &&
+ !liveTest.suite.isLoadSuite) {
+ _shouldPrintStackTraceChainingNotice = true;
+ }
+
+ if (liveTest.state.status != Status.complete) return;
+
+ _progressLine(_description(liveTest), suffix: ' $_bold$_red[E]$_noColor');
+
+ if (error is! LoadException) {
+ _sink
+ ..writeln(indent('$error'))
+ ..writeln(indent('$stackTrace'));
+ return;
+ }
+
+ // TODO - what type is this?
+ _sink.writeln(indent(error.toString(color: _color)));
+
+ // Only print stack traces for load errors that come from the user's code.
+ if (error.innerError is! FormatException && error.innerError is! String) {
+ _sink.writeln(indent('$stackTrace'));
+ }
+ }
+
+ /// A callback called when the engine is finished running tests.
+ ///
+ /// [success] will be `true` if all tests passed, `false` if some tests
+ /// failed, and `null` if the engine was closed prematurely.
+ void _onDone(bool? success) {
+ _cancel();
+ // A null success value indicates that the engine was closed before the
+ // tests finished running, probably because of a signal from the user, in
+ // which case we shouldn't print summary information.
+ if (success == null) return;
+
+ if (_engine.liveTests.isEmpty) {
+ _sink.writeln('No tests ran.');
+ } else if (!success) {
+ for (var liveTest in _engine.active) {
+ _progressLine(_description(liveTest),
+ suffix: ' - did not complete $_bold$_red[E]$_noColor');
+ }
+ _progressLine('Some tests failed.', color: _red);
+ } else if (_engine.passed.isEmpty) {
+ _progressLine('All tests skipped.');
+ } else {
+ _progressLine('All tests passed!');
+ }
+
+ if (_shouldPrintStackTraceChainingNotice) {
+ _sink
+ ..writeln('')
+ ..writeln('Consider enabling the flag chain-stack-traces to '
+ 'receive more detailed exceptions.\n'
+ "For example, 'dart test --chain-stack-traces'.");
+ }
+ }
+
+ /// Prints a line representing the current state of the tests.
+ ///
+ /// [message] goes after the progress report. If [color] is passed, it's used
+ /// as the color for [message]. If [suffix] is passed, it's added to the end
+ /// of [message].
+ void _progressLine(String message, {String? color, String? suffix}) {
+ // Print nothing if nothing has changed since the last progress line.
+ if (_engine.passed.length == _lastProgressPassed &&
+ _engine.skipped.length == _lastProgressSkipped &&
+ _engine.failed.length == _lastProgressFailed &&
+ message == _lastProgressMessage &&
+ // Don't re-print just because a suffix was removed.
+ (suffix == null || suffix == _lastProgressSuffix)) {
+ return;
+ }
+
+ _lastProgressPassed = _engine.passed.length;
+ _lastProgressSkipped = _engine.skipped.length;
+ _lastProgressFailed = _engine.failed.length;
+ _lastProgressMessage = message;
+ _lastProgressSuffix = suffix;
+
+ if (suffix != null) message += suffix;
+ color ??= '';
+ var duration = _stopwatch.elapsed;
+ var buffer = StringBuffer();
+
+ // \r moves back to the beginning of the current line.
+ buffer.write('${_timeString(duration)} ');
+ buffer.write(_green);
+ buffer.write('+');
+ buffer.write(_engine.passed.length);
+ buffer.write(_noColor);
+
+ if (_engine.skipped.isNotEmpty) {
+ buffer.write(_yellow);
+ buffer.write(' ~');
+ buffer.write(_engine.skipped.length);
+ buffer.write(_noColor);
+ }
+
+ if (_engine.failed.isNotEmpty) {
+ buffer.write(_red);
+ buffer.write(' -');
+ buffer.write(_engine.failed.length);
+ buffer.write(_noColor);
+ }
+
+ buffer.write(': ');
+ buffer.write(color);
+ buffer.write(message);
+ buffer.write(_noColor);
+
+ _sink.writeln(buffer.toString());
+ }
+
+ /// Returns a representation of [duration] as `MM:SS`.
+ String _timeString(Duration duration) {
+ return "${duration.inMinutes.toString().padLeft(2, '0')}:"
+ "${(duration.inSeconds % 60).toString().padLeft(2, '0')}";
+ }
+
+ /// Returns a description of [liveTest].
+ ///
+ /// This differs from the test's own description in that it may also include
+ /// the suite's name.
+ String _description(LiveTest liveTest) {
+ var name = liveTest.test.name;
+
+ if (_printPath &&
+ liveTest.suite is! LoadSuite &&
+ liveTest.suite.path != null) {
+ name = '${liveTest.suite.path}: $name';
+ }
+
+ if (_printPlatform) {
+ name = '[${liveTest.suite.platform.runtime.name}, '
+ '${liveTest.suite.platform.compiler.name}] $name';
+ }
+
+ if (liveTest.suite is LoadSuite) name = '$_bold$_gray$name$_noColor';
+
+ return name;
+ }
+}
diff --git a/pkgs/test_core/lib/src/runner/reporter/failures_only.dart b/pkgs/test_core/lib/src/runner/reporter/failures_only.dart
new file mode 100644
index 0000000..b6b85e7
--- /dev/null
+++ b/pkgs/test_core/lib/src/runner/reporter/failures_only.dart
@@ -0,0 +1,295 @@
+// Copyright (c) 2024, 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:test_api/src/backend/live_test.dart'; // ignore: implementation_imports
+import 'package:test_api/src/backend/message.dart'; // ignore: implementation_imports
+import 'package:test_api/src/backend/state.dart'; // ignore: implementation_imports
+
+import '../../util/pretty_print.dart';
+import '../engine.dart';
+import '../load_exception.dart';
+import '../load_suite.dart';
+import '../reporter.dart';
+
+/// A reporter that only prints when a test fails.
+class FailuresOnlyReporter implements Reporter {
+ /// Whether the reporter should emit terminal color escapes.
+ final bool _color;
+
+ /// The terminal escape for green text, or the empty string if this is Windows
+ /// or not outputting to a terminal.
+ final String _green;
+
+ /// The terminal escape for red text, or the empty string if this is Windows
+ /// or not outputting to a terminal.
+ final String _red;
+
+ /// The terminal escape for yellow text, or the empty string if this is
+ /// Windows or not outputting to a terminal.
+ final String _yellow;
+
+ /// The terminal escape for gray text, or the empty string if this is
+ /// Windows or not outputting to a terminal.
+ final String _gray;
+
+ /// The terminal escape for bold text, or the empty string if this is
+ /// Windows or not outputting to a terminal.
+ final String _bold;
+
+ /// The terminal escape for removing test coloring, or the empty string if
+ /// this is Windows or not outputting to a terminal.
+ final String _noColor;
+
+ /// The engine used to run the tests.
+ final Engine _engine;
+
+ /// Whether the path to each test's suite should be printed.
+ final bool _printPath;
+
+ /// Whether the platform each test is running on should be printed.
+ final bool _printPlatform;
+
+ /// The size of `_engine.passed` last time a progress notification was
+ /// printed.
+ int _lastProgressPassed = 0;
+
+ /// The size of `_engine.skipped` last time a progress notification was
+ /// printed.
+ int _lastProgressSkipped = 0;
+
+ /// The size of `_engine.failed` last time a progress notification was
+ /// printed.
+ int _lastProgressFailed = 0;
+
+ /// The message printed for the last progress notification.
+ String _lastProgressMessage = '';
+
+ /// The suffix added to the last progress notification.
+ String? _lastProgressSuffix;
+
+ /// Whether the reporter is paused.
+ var _paused = false;
+
+ // Whether a notice should be logged about enabling stack trace chaining at
+ // the end of all tests running.
+ var _shouldPrintStackTraceChainingNotice = false;
+
+ /// The set of all subscriptions to various streams.
+ final _subscriptions = <StreamSubscription>{};
+
+ final StringSink _sink;
+
+ /// Watches the tests run by [engine] and prints their results to the
+ /// terminal.
+ ///
+ /// If [color] is `true`, this will use terminal colors; if it's `false`, it
+ /// won't. If [printPath] is `true`, this will print the path name as part of
+ /// the test description. Likewise, if [printPlatform] is `true`, this will
+ /// print the platform as part of the test description.
+ static FailuresOnlyReporter watch(Engine engine, StringSink sink,
+ {required bool color,
+ required bool printPath,
+ required bool printPlatform}) =>
+ FailuresOnlyReporter._(engine, sink,
+ color: color, printPath: printPath, printPlatform: printPlatform);
+
+ FailuresOnlyReporter._(this._engine, this._sink,
+ {required bool color,
+ required bool printPath,
+ required bool printPlatform})
+ : _printPath = printPath,
+ _printPlatform = printPlatform,
+ _color = color,
+ _green = color ? '\u001b[32m' : '',
+ _red = color ? '\u001b[31m' : '',
+ _yellow = color ? '\u001b[33m' : '',
+ _gray = color ? '\u001b[90m' : '',
+ _bold = color ? '\u001b[1m' : '',
+ _noColor = color ? '\u001b[0m' : '' {
+ _subscriptions.add(_engine.onTestStarted.listen(_onTestStarted));
+
+ // Convert the future to a stream so that the subscription can be paused or
+ // canceled.
+ _subscriptions.add(_engine.success.asStream().listen(_onDone));
+ }
+
+ @override
+ void pause() {
+ if (_paused) return;
+ _paused = true;
+
+ for (var subscription in _subscriptions) {
+ subscription.pause();
+ }
+ }
+
+ @override
+ void resume() {
+ if (!_paused) return;
+
+ for (var subscription in _subscriptions) {
+ subscription.resume();
+ }
+ }
+
+ void _cancel() {
+ for (var subscription in _subscriptions) {
+ subscription.cancel();
+ }
+ _subscriptions.clear();
+ }
+
+ /// A callback called when the engine begins running [liveTest].
+ void _onTestStarted(LiveTest liveTest) {
+ _subscriptions.add(liveTest.onError
+ .listen((error) => _onError(liveTest, error.error, error.stackTrace)));
+
+ _subscriptions.add(liveTest.onMessage.listen((message) {
+ // TODO - Should this suppress output? Behave like printOnFailure?
+ _progressLine(_description(liveTest));
+ var text = message.text;
+ if (message.type == MessageType.skip) text = ' $_yellow$text$_noColor';
+ _sink.writeln(text);
+ }));
+ }
+
+ /// A callback called when [liveTest] throws [error].
+ void _onError(LiveTest liveTest, Object error, StackTrace stackTrace) {
+ if (!liveTest.test.metadata.chainStackTraces &&
+ !liveTest.suite.isLoadSuite) {
+ _shouldPrintStackTraceChainingNotice = true;
+ }
+
+ if (liveTest.state.status != Status.complete) return;
+
+ _progressLine(_description(liveTest), suffix: ' $_bold$_red[E]$_noColor');
+
+ if (error is! LoadException) {
+ _sink
+ ..writeln(indent('$error'))
+ ..writeln(indent('$stackTrace'));
+ return;
+ }
+
+ // TODO - what type is this?
+ _sink.writeln(indent(error.toString(color: _color)));
+
+ // Only print stack traces for load errors that come from the user's code.
+ if (error.innerError is! FormatException && error.innerError is! String) {
+ _sink.writeln(indent('$stackTrace'));
+ }
+ }
+
+ /// A callback called when the engine is finished running tests.
+ ///
+ /// [success] will be `true` if all tests passed, `false` if some tests
+ /// failed, and `null` if the engine was closed prematurely.
+ void _onDone(bool? success) {
+ _cancel();
+ // A null success value indicates that the engine was closed before the
+ // tests finished running, probably because of a signal from the user, in
+ // which case we shouldn't print summary information.
+ if (success == null) return;
+
+ if (_engine.liveTests.isEmpty) {
+ _sink.writeln('No tests ran.');
+ } else if (!success) {
+ for (var liveTest in _engine.active) {
+ _progressLine(_description(liveTest),
+ suffix: ' - did not complete $_bold$_red[E]$_noColor');
+ }
+ _progressLine('Some tests failed.', color: _red);
+ } else if (_engine.passed.isEmpty) {
+ _progressLine('All tests skipped.');
+ } else {
+ _progressLine('All tests passed!');
+ }
+
+ if (_shouldPrintStackTraceChainingNotice) {
+ _sink
+ ..writeln('')
+ ..writeln('Consider enabling the flag chain-stack-traces to '
+ 'receive more detailed exceptions.\n'
+ "For example, 'dart test --chain-stack-traces'.");
+ }
+ }
+
+ /// Prints a line representing the current state of the tests.
+ ///
+ /// [message] goes after the progress report. If [color] is passed, it's used
+ /// as the color for [message]. If [suffix] is passed, it's added to the end
+ /// of [message].
+ void _progressLine(String message, {String? color, String? suffix}) {
+ // Print nothing if nothing has changed since the last progress line.
+ if (_engine.passed.length == _lastProgressPassed &&
+ _engine.skipped.length == _lastProgressSkipped &&
+ _engine.failed.length == _lastProgressFailed &&
+ message == _lastProgressMessage &&
+ // Don't re-print just because a suffix was removed.
+ (suffix == null || suffix == _lastProgressSuffix)) {
+ return;
+ }
+
+ _lastProgressPassed = _engine.passed.length;
+ _lastProgressSkipped = _engine.skipped.length;
+ _lastProgressFailed = _engine.failed.length;
+ _lastProgressMessage = message;
+ _lastProgressSuffix = suffix;
+
+ if (suffix != null) message += suffix;
+ color ??= '';
+ var buffer = StringBuffer();
+
+ buffer.write(_green);
+ buffer.write('+');
+ buffer.write(_engine.passed.length);
+ buffer.write(_noColor);
+
+ if (_engine.skipped.isNotEmpty) {
+ buffer.write(_yellow);
+ buffer.write(' ~');
+ buffer.write(_engine.skipped.length);
+ buffer.write(_noColor);
+ }
+
+ if (_engine.failed.isNotEmpty) {
+ buffer.write(_red);
+ buffer.write(' -');
+ buffer.write(_engine.failed.length);
+ buffer.write(_noColor);
+ }
+
+ buffer.write(': ');
+ buffer.write(color);
+ buffer.write(message);
+ buffer.write(_noColor);
+
+ _sink.writeln(buffer.toString());
+ }
+
+ /// Returns a description of [liveTest].
+ ///
+ /// This differs from the test's own description in that it may also include
+ /// the suite's name.
+ String _description(LiveTest liveTest) {
+ var name = liveTest.test.name;
+
+ if (_printPath &&
+ liveTest.suite is! LoadSuite &&
+ liveTest.suite.path != null) {
+ name = '${liveTest.suite.path}: $name';
+ }
+
+ if (_printPlatform) {
+ name = '[${liveTest.suite.platform.runtime.name}, '
+ '${liveTest.suite.platform.compiler.name}] $name';
+ }
+
+ if (liveTest.suite is LoadSuite) name = '$_bold$_gray$name$_noColor';
+
+ return name;
+ }
+}
diff --git a/pkgs/test_core/lib/src/runner/reporter/github.dart b/pkgs/test_core/lib/src/runner/reporter/github.dart
new file mode 100644
index 0000000..5249817
--- /dev/null
+++ b/pkgs/test_core/lib/src/runner/reporter/github.dart
@@ -0,0 +1,239 @@
+// Copyright (c) 2022, 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.
+
+// ignore_for_file: implementation_imports
+
+import 'dart:async';
+
+import 'package:test_api/src/backend/live_test.dart';
+import 'package:test_api/src/backend/message.dart';
+import 'package:test_api/src/backend/state.dart';
+import 'package:test_api/src/backend/util/pretty_print.dart';
+
+import '../engine.dart';
+import '../load_suite.dart';
+import '../reporter.dart';
+
+/// A reporter that prints test output using formatting for Github Actions.
+///
+/// See
+/// https://docs.github.com/en/actions/using-workflows/workflow-commands-for-github-actions
+/// for a description of the output format, and
+/// https://github.com/dart-lang/test/issues/1415 for discussions about this
+/// implementation.
+class GithubReporter implements Reporter {
+ /// The engine used to run the tests.
+ final Engine _engine;
+
+ /// Whether the path to each test's suite should be printed.
+ final bool _printPath;
+
+ /// Whether the platform each test is running on should be printed.
+ final bool _printPlatform;
+
+ /// Whether the reporter is paused.
+ var _paused = false;
+
+ /// The set of all subscriptions to various streams.
+ final _subscriptions = <StreamSubscription>{};
+
+ final StringSink _sink;
+
+ final Map<LiveTest, List<Message>> _testMessages = {};
+
+ final Set<LiveTest> _completedTests = {};
+
+ /// Watches the tests run by [engine] and prints their results as JSON.
+ static GithubReporter watch(
+ Engine engine,
+ StringSink sink, {
+ required bool printPath,
+ required bool printPlatform,
+ }) =>
+ GithubReporter._(engine, sink, printPath, printPlatform);
+
+ GithubReporter._(
+ this._engine, this._sink, this._printPath, this._printPlatform) {
+ _subscriptions.add(_engine.onTestStarted.listen(_onTestStarted));
+ _subscriptions.add(_engine.success.asStream().listen(_onDone));
+
+ // Add a spacer between pre-test output and the test results.
+ _sink.writeln();
+ }
+
+ @override
+ void pause() {
+ if (_paused) return;
+ _paused = true;
+
+ for (var subscription in _subscriptions) {
+ subscription.pause();
+ }
+ }
+
+ @override
+ void resume() {
+ if (!_paused) return;
+ _paused = false;
+
+ for (var subscription in _subscriptions) {
+ subscription.resume();
+ }
+ }
+
+ void _cancel() {
+ for (var subscription in _subscriptions) {
+ subscription.cancel();
+ }
+ _subscriptions.clear();
+ }
+
+ /// A callback called when the engine begins running [liveTest].
+ void _onTestStarted(LiveTest liveTest) {
+ // Convert the future to a stream so that the subscription can be paused or
+ // canceled.
+ _subscriptions.add(
+ liveTest.onComplete.asStream().listen((_) => _onComplete(liveTest)));
+
+ _subscriptions.add(liveTest.onError
+ .listen((error) => _onError(liveTest, error.error, error.stackTrace)));
+
+ // Collect messages from tests as they are emitted.
+ _subscriptions.add(liveTest.onMessage.listen((message) {
+ if (_completedTests.contains(liveTest)) {
+ // The test has already completed and it's previous messages were
+ // written out; ensure this post-completion output is not lost.
+ _sink.writeln(message.text);
+ } else {
+ _testMessages.putIfAbsent(liveTest, () => []).add(message);
+ }
+ }));
+ }
+
+ /// A callback called when [liveTest] finishes running.
+ void _onComplete(LiveTest test) {
+ final errors = test.errors;
+ final messages = _testMessages[test] ?? [];
+ final skipped = test.state.result == Result.skipped;
+ final failed = errors.isNotEmpty;
+ final loadSuite = test.suite is LoadSuite;
+ final synthetic = loadSuite ||
+ test.individualName == '(setUpAll)' ||
+ test.individualName == '(tearDownAll)';
+
+ // Mark this test as having completed.
+ _completedTests.add(test);
+
+ // Don't emit any info for loadSuite, setUpAll, or tearDownAll tests
+ // unless they contain errors or other info.
+ if (synthetic && (errors.isEmpty && messages.isEmpty)) {
+ return;
+ }
+
+ // For now, we use the same icon for both tests and test-like structures
+ // (loadSuite, setUpAll, tearDownAll).
+ var defaultIcon = synthetic ? _GithubMarkup.passed : _GithubMarkup.passed;
+ final prefix = failed
+ ? _GithubMarkup.failed
+ : skipped
+ ? _GithubMarkup.skipped
+ : defaultIcon;
+ final statusSuffix = failed
+ ? ' (failed)'
+ : skipped
+ ? ' (skipped)'
+ : '';
+
+ var name = test.test.name;
+ if (!loadSuite) {
+ if (_printPath && test.suite.path != null) {
+ name = '${test.suite.path}: $name';
+ }
+ }
+ if (_printPlatform) {
+ name = '[${test.suite.platform.runtime.name}, '
+ '${test.suite.platform.compiler.name}] $name';
+ }
+ if (messages.isEmpty && errors.isEmpty) {
+ _sink.writeln('$prefix $name$statusSuffix');
+ } else {
+ _sink.writeln(_GithubMarkup.startGroup('$prefix $name$statusSuffix'));
+ for (var message in messages) {
+ _sink.writeln(message.text);
+ }
+ for (var error in errors) {
+ _sink.writeln('${error.error}');
+ _sink.writeln(error.stackTrace.toString().trimRight());
+ }
+ _sink.writeln(_GithubMarkup.endGroup);
+ }
+ }
+
+ /// A callback called when [test] throws [error].
+ void _onError(LiveTest test, Object error, StackTrace stackTrace) {
+ if (_completedTests.contains(test)) {
+ final loadSuite = test.suite is LoadSuite;
+
+ final prefix = _GithubMarkup.failed;
+ final statusSuffix = ' (failed after test completion)';
+
+ var name = test.test.name;
+ if (!loadSuite) {
+ if (_printPath && test.suite.path != null) {
+ name = '${test.suite.path}: $name';
+ }
+ }
+ if (_printPlatform) {
+ name = '[${test.suite.platform.runtime.name}, '
+ '${test.suite.platform.compiler.name}] $name';
+ }
+
+ _sink.writeln(_GithubMarkup.startGroup('$prefix $name$statusSuffix'));
+ _sink.writeln('$error');
+ _sink.writeln(stackTrace.toString().trimRight());
+ _sink.writeln(_GithubMarkup.endGroup);
+ }
+ }
+
+ void _onDone(bool? success) {
+ _cancel();
+
+ _sink.writeln();
+
+ final hadFailures = _engine.failed.isNotEmpty;
+ final message = StringBuffer('${_engine.passed.length} '
+ '${pluralize('test', _engine.passed.length)} passed');
+ if (_engine.failed.isNotEmpty) {
+ message.write(', ${_engine.failed.length} failed');
+ }
+ if (_engine.skipped.isNotEmpty) {
+ message.write(', ${_engine.skipped.length} skipped');
+ }
+ message.write('.');
+ _sink.writeln(
+ hadFailures
+ ? _GithubMarkup.error(message.toString())
+ : '${_GithubMarkup.success} $message',
+ );
+ }
+}
+
+abstract class _GithubMarkup {
+ // Char sets avilable at https://www.compart.com/en/unicode/.
+ static const String passed = '✅';
+ static const String skipped = '❎';
+ static const String failed = '❌';
+ // The 'synthetic' icon is currently not used but is something to consider in
+ // order to draw a distinction between user tests and test-like supporting
+ // infrastructure.
+ // static const String synthetic = '⏺';
+ static const String success = '🎉';
+
+ static String startGroup(String title) =>
+ '::group::${title.replaceAll('\n', ' ')}';
+
+ static final String endGroup = '::endgroup::';
+
+ static String error(String message) => '::error::$message';
+}
diff --git a/pkgs/test_core/lib/src/runner/reporter/json.dart b/pkgs/test_core/lib/src/runner/reporter/json.dart
new file mode 100644
index 0000000..672f806
--- /dev/null
+++ b/pkgs/test_core/lib/src/runner/reporter/json.dart
@@ -0,0 +1,324 @@
+// Copyright (c) 2015, 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 'dart:convert';
+import 'dart:io' show pid;
+
+import 'package:collection/collection.dart';
+import 'package:path/path.dart' as p;
+import 'package:stack_trace/stack_trace.dart';
+import 'package:test_api/hooks.dart' // ignore: implementation_imports
+ show
+ TestFailure;
+import 'package:test_api/src/backend/compiler.dart'; // ignore: implementation_imports
+import 'package:test_api/src/backend/group.dart'; // ignore: implementation_imports
+import 'package:test_api/src/backend/live_test.dart'; // ignore: implementation_imports
+import 'package:test_api/src/backend/metadata.dart'; // ignore: implementation_imports
+import 'package:test_api/src/backend/state.dart'; // ignore: implementation_imports
+import 'package:test_api/src/backend/suite.dart'; // ignore: implementation_imports
+
+import '../../platform.dart';
+import '../engine.dart';
+import '../load_suite.dart';
+import '../reporter.dart';
+import '../version.dart';
+
+/// A reporter that prints machine-readable JSON-formatted test results.
+class JsonReporter implements Reporter {
+ /// Whether the test runner will pause for debugging.
+ final bool _isDebugRun;
+
+ /// The engine used to run the tests.
+ final Engine _engine;
+
+ /// A stopwatch that tracks the duration of the full run.
+ final _stopwatch = Stopwatch();
+
+ /// Whether we've started [_stopwatch].
+ ///
+ /// We can't just use `_stopwatch.isRunning` because the stopwatch is stopped
+ /// when the reporter is paused.
+ var _stopwatchStarted = false;
+
+ /// An expando that associates unique IDs with [LiveTest]s.
+ final _liveTestIDs = <LiveTest, int>{};
+
+ /// An expando that associates unique IDs with [Suite]s.
+ final _suiteIDs = <Suite, int>{};
+
+ /// An expando that associates unique IDs with [Group]s.
+ final _groupIDs = <Group, int>{};
+
+ /// The next ID to associate with a [LiveTest].
+ var _nextID = 0;
+
+ /// Whether the reporter is paused.
+ var _paused = false;
+
+ /// The set of all subscriptions to various streams.
+ final _subscriptions = <StreamSubscription>{};
+
+ final StringSink _sink;
+
+ /// Watches the tests run by [engine] and prints their results as JSON.
+ static JsonReporter watch(Engine engine, StringSink sink,
+ {required bool isDebugRun}) =>
+ JsonReporter._(engine, sink, isDebugRun);
+
+ JsonReporter._(this._engine, this._sink, this._isDebugRun) {
+ _subscriptions.add(_engine.onTestStarted.listen(_onTestStarted));
+
+ // Convert the future to a stream so that the subscription can be paused or
+ // canceled.
+ _subscriptions.add(_engine.success.asStream().listen(_onDone));
+
+ _subscriptions.add(_engine.onSuiteAdded.listen(null, onDone: () {
+ _emit('allSuites', {
+ 'count': _engine.addedSuites.length,
+ 'time': _stopwatch.elapsed.inMilliseconds
+ });
+ }));
+
+ _emit('start',
+ {'protocolVersion': '0.1.1', 'runnerVersion': testVersion, 'pid': pid});
+ }
+
+ @override
+ void pause() {
+ if (_paused) return;
+ _paused = true;
+
+ _stopwatch.stop();
+
+ for (var subscription in _subscriptions) {
+ subscription.pause();
+ }
+ }
+
+ @override
+ void resume() {
+ if (!_paused) return;
+ _paused = false;
+
+ if (_stopwatchStarted) _stopwatch.start();
+
+ for (var subscription in _subscriptions) {
+ subscription.resume();
+ }
+ }
+
+ void _cancel() {
+ for (var subscription in _subscriptions) {
+ subscription.cancel();
+ }
+ _subscriptions.clear();
+ }
+
+ /// A callback called when the engine begins running [liveTest].
+ void _onTestStarted(LiveTest liveTest) {
+ if (!_stopwatchStarted) {
+ _stopwatchStarted = true;
+ _stopwatch.start();
+ }
+
+ var suiteID = _idForSuite(liveTest.suite);
+
+ // Don't emit groups for load suites. They're always empty and they provide
+ // unnecessary clutter.
+ var groupIDs = liveTest.suite is LoadSuite
+ ? <int>[]
+ : _idsForGroups(liveTest.groups, liveTest.suite);
+
+ var suiteConfig = _configFor(liveTest.suite);
+ var id = _nextID++;
+ _liveTestIDs[liveTest] = id;
+ _emit('testStart', {
+ 'test': {
+ 'id': id,
+ 'name': liveTest.test.name,
+ 'suiteID': suiteID,
+ 'groupIDs': groupIDs,
+ 'metadata': _serializeMetadata(suiteConfig, liveTest.test.metadata),
+ ..._frameInfo(suiteConfig, liveTest.test.trace, liveTest.suite.platform,
+ liveTest.suite.path!),
+ }
+ });
+
+ // Convert the future to a stream so that the subscription can be paused or
+ // canceled.
+ _subscriptions.add(
+ liveTest.onComplete.asStream().listen((_) => _onComplete(liveTest)));
+
+ _subscriptions.add(liveTest.onError
+ .listen((error) => _onError(liveTest, error.error, error.stackTrace)));
+
+ _subscriptions.add(liveTest.onMessage.listen((message) {
+ _emit('print', {
+ 'testID': id,
+ 'messageType': message.type.name,
+ 'message': message.text
+ });
+ }));
+ }
+
+ /// Returns an ID for [suite].
+ ///
+ /// If [suite] doesn't have an ID yet, this assigns one and emits a new event
+ /// for that suite.
+ int _idForSuite(Suite suite) {
+ if (_suiteIDs.containsKey(suite)) return _suiteIDs[suite]!;
+
+ var id = _nextID++;
+ _suiteIDs[suite] = id;
+
+ // Give the load suite's suite the same ID, because it doesn't have any
+ // different metadata.
+ if (suite is LoadSuite) {
+ suite.suite.then((runnerSuite) {
+ if (runnerSuite == null) return;
+ _suiteIDs[runnerSuite] = id;
+ if (!_isDebugRun) return;
+
+ // TODO(nweiz): test this when we have a library for communicating with
+ // the Chrome remote debugger, or when we have VM debug support.
+ _emit('debug', {
+ 'suiteID': id,
+ 'observatory': runnerSuite.environment.observatoryUrl?.toString(),
+ 'remoteDebugger':
+ runnerSuite.environment.remoteDebuggerUrl?.toString(),
+ });
+ });
+ }
+
+ _emit('suite', {
+ 'suite': <String, Object?>{
+ 'id': id,
+ 'platform': suite.platform.runtime.identifier,
+ 'path': suite.path
+ }
+ });
+ return id;
+ }
+
+ /// Returns a list of the IDs for all the groups in [groups], which are
+ /// contained in the suite identified by [suiteID].
+ ///
+ /// If a group doesn't have an ID yet, this assigns one and emits a new event
+ /// for that group.
+ List<int> _idsForGroups(Iterable<Group> groups, Suite suite) {
+ int? parentID;
+ return groups.map((group) {
+ if (_groupIDs.containsKey(group)) {
+ return parentID = _groupIDs[group]!;
+ }
+
+ var id = _nextID++;
+ _groupIDs[group] = id;
+
+ var suiteConfig = _configFor(suite);
+ _emit('group', {
+ 'group': {
+ 'id': id,
+ 'suiteID': _idForSuite(suite),
+ 'parentID': parentID,
+ 'name': group.name,
+ 'metadata': _serializeMetadata(suiteConfig, group.metadata),
+ 'testCount': group.testCount,
+ ..._frameInfo(suiteConfig, group.trace, suite.platform, suite.path!)
+ }
+ });
+ parentID = id;
+ return id;
+ }).toList();
+ }
+
+ /// Serializes [metadata] into a JSON-protocol-compatible map.
+ Map _serializeMetadata(SuiteConfiguration suiteConfig, Metadata metadata) =>
+ suiteConfig.runSkipped
+ ? {'skip': false, 'skipReason': null}
+ : {'skip': metadata.skip, 'skipReason': metadata.skipReason};
+
+ /// A callback called when [liveTest] finishes running.
+ void _onComplete(LiveTest liveTest) {
+ _emit('testDone', {
+ 'testID': _liveTestIDs[liveTest],
+ 'result': _normalizeTestResult(liveTest),
+ 'skipped': liveTest.state.result == Result.skipped,
+ 'hidden': !_engine.liveTests.contains(liveTest)
+ });
+ }
+
+ String _normalizeTestResult(LiveTest liveTest) {
+ // For backwards-compatibility, report skipped tests as successes.
+ if (liveTest.state.result == Result.skipped) return 'success';
+ // if test is still active, it was probably cancelled
+ if (_engine.active.contains(liveTest)) return 'error';
+ return liveTest.state.result.toString();
+ }
+
+ /// A callback called when [liveTest] throws [error].
+ void _onError(LiveTest liveTest, Object error, StackTrace stackTrace) {
+ _emit('error', {
+ 'testID': _liveTestIDs[liveTest],
+ 'error': error.toString(),
+ 'stackTrace': '$stackTrace',
+ 'isFailure': error is TestFailure
+ });
+ }
+
+ /// A callback called when the engine is finished running tests.
+ ///
+ /// [success] will be `true` if all tests passed, `false` if some tests
+ /// failed, and `null` if the engine was closed prematurely.
+ void _onDone(bool? success) {
+ _cancel();
+ _stopwatch.stop();
+
+ _emit('done', {'success': success});
+ }
+
+ /// Returns the configuration for [suite].
+ ///
+ /// If [suite] is a [RunnerSuite], this returns [RunnerSuite.config].
+ /// Otherwise, it returns [SuiteConfiguration.empty].
+ SuiteConfiguration _configFor(Suite suite) =>
+ suite is RunnerSuite ? suite.config : SuiteConfiguration.empty;
+
+ /// Emits an event with the given type and attributes.
+ void _emit(String type, Map attributes) {
+ attributes['type'] = type;
+ attributes['time'] = _stopwatch.elapsed.inMilliseconds;
+ _sink.writeln(jsonEncode(attributes));
+ }
+
+ /// Returns a map with the line, column, and URL information for the first
+ /// frame of [trace], as well as the first line in the original file.
+ ///
+ /// If javascript traces are enabled and the test is on a javascript platform,
+ /// or if the [trace] is null or empty, then the line, column, and url will
+ /// all be `null`.
+ Map<String, dynamic> _frameInfo(SuiteConfiguration suiteConfig, Trace? trace,
+ SuitePlatform platform, String suitePath) {
+ var absoluteSuitePath = p.canonicalize(p.absolute(suitePath));
+ var frame = trace?.frames.first;
+ if (frame == null || (suiteConfig.jsTrace && platform.compiler.isJS)) {
+ return {'line': null, 'column': null, 'url': null};
+ }
+
+ var rootFrame = trace?.frames.firstWhereOrNull((frame) =>
+ frame.uri.scheme == 'file' &&
+ p.canonicalize(frame.uri.toFilePath()) == absoluteSuitePath);
+ return {
+ 'line': frame.line,
+ 'column': frame.column,
+ 'url': frame.uri.toString(),
+ if (rootFrame != null && rootFrame != frame) ...{
+ 'root_line': rootFrame.line,
+ 'root_column': rootFrame.column,
+ 'root_url': rootFrame.uri.toString(),
+ }
+ };
+ }
+}
diff --git a/pkgs/test_core/lib/src/runner/reporter/multiplex.dart b/pkgs/test_core/lib/src/runner/reporter/multiplex.dart
new file mode 100644
index 0000000..59a9841
--- /dev/null
+++ b/pkgs/test_core/lib/src/runner/reporter/multiplex.dart
@@ -0,0 +1,25 @@
+// Copyright (c) 2020, 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 '../reporter.dart';
+
+class MultiplexReporter implements Reporter {
+ Iterable<Reporter> delegates;
+
+ MultiplexReporter(this.delegates);
+
+ @override
+ void pause() {
+ for (var d in delegates) {
+ d.pause();
+ }
+ }
+
+ @override
+ void resume() {
+ for (var d in delegates) {
+ d.resume();
+ }
+ }
+}
diff --git a/pkgs/test_core/lib/src/runner/runner_suite.dart b/pkgs/test_core/lib/src/runner/runner_suite.dart
new file mode 100644
index 0000000..dcceb6b
--- /dev/null
+++ b/pkgs/test_core/lib/src/runner/runner_suite.dart
@@ -0,0 +1,175 @@
+// Copyright (c) 2015, 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:async/async.dart';
+import 'package:stream_channel/stream_channel.dart';
+import 'package:test_api/src/backend/group.dart'; // ignore: implementation_imports
+import 'package:test_api/src/backend/suite.dart'; // ignore: implementation_imports
+import 'package:test_api/src/backend/suite_platform.dart'; // ignore: implementation_imports
+import 'package:test_api/src/backend/test.dart'; // ignore: implementation_imports
+
+import 'environment.dart';
+import 'suite.dart';
+
+/// A suite produced and consumed by the test runner that has runner-specific
+/// logic and lifecycle management.
+///
+/// This is separated from [Suite] because the backend library (which will
+/// eventually become its own package) is primarily for test code itself to use,
+/// for which the [RunnerSuite] APIs don't make sense.
+///
+/// A [RunnerSuite] can be produced and controlled using a
+/// [RunnerSuiteController].
+class RunnerSuite extends Suite {
+ final RunnerSuiteController _controller;
+
+ /// The environment in which this suite runs.
+ Environment get environment => _controller._environment;
+
+ /// The configuration for this suite.
+ SuiteConfiguration get config => _controller._config;
+
+ /// Whether the suite is paused for debugging.
+ ///
+ /// When using a dev inspector, this may also mean that the entire browser is
+ /// paused.
+ bool get isDebugging => _controller._isDebugging;
+
+ /// A broadcast stream that emits an event whenever the suite is paused for
+ /// debugging or resumed afterwards.
+ ///
+ /// The event is `true` when debugging starts and `false` when it ends.
+ Stream<bool> get onDebugging => _controller._onDebuggingController.stream;
+
+ /// A shortcut constructor for creating a [RunnerSuite] that never goes into
+ /// debugging mode and doesn't support suite channels.
+ factory RunnerSuite(Environment environment, SuiteConfiguration config,
+ Group group, SuitePlatform platform,
+ {String? path, void Function()? onClose}) {
+ var controller =
+ RunnerSuiteController._local(environment, config, onClose: onClose);
+ var suite = RunnerSuite._(controller, group, platform, path: path);
+ controller._suite = Future.value(suite);
+ return suite;
+ }
+
+ RunnerSuite._(this._controller, Group group, SuitePlatform platform,
+ {String? path})
+ : super(group, platform,
+ path: path, ignoreTimeouts: _controller._config.ignoreTimeouts);
+
+ @override
+ RunnerSuite filter(bool Function(Test) callback) {
+ var filtered = group.filter(callback);
+ filtered ??= Group.root([], metadata: metadata);
+ return RunnerSuite._(_controller, filtered, platform, path: path);
+ }
+
+ /// Closes the suite and releases any resources associated with it.
+ Future close() => _controller._close();
+
+ /// Collects a hit-map containing merged coverage.
+ ///
+ /// Result is suitable for input to the coverage formatters provided by
+ /// `package:coverage`.
+ Future<Map<String, dynamic>> gatherCoverage() async =>
+ (await _controller._gatherCoverage?.call()) ?? {};
+}
+
+/// A class that exposes and controls a [RunnerSuite].
+class RunnerSuiteController {
+ /// The suite controlled by this controller.
+ Future<RunnerSuite> get suite => _suite;
+ late final Future<RunnerSuite> _suite;
+
+ /// The backing value for [suite.environment].
+ final Environment _environment;
+
+ /// The configuration for this suite.
+ final SuiteConfiguration _config;
+
+ /// A channel that communicates with the remote suite.
+ final MultiChannel? _suiteChannel;
+
+ /// The function to call when the suite is closed.
+ final FutureOr<void> Function()? _onClose;
+
+ /// The backing value for [suite.isDebugging].
+ bool _isDebugging = false;
+
+ /// The controller for [suite.onDebugging].
+ final _onDebuggingController = StreamController<bool>.broadcast();
+
+ /// The channel names that have already been used.
+ final _channelNames = <String>{};
+
+ /// Collects a hit-map containing merged coverage.
+ final Future<Map<String, dynamic>> Function()? _gatherCoverage;
+
+ RunnerSuiteController(this._environment, this._config, this._suiteChannel,
+ Future<Group> groupFuture, SuitePlatform platform,
+ {String? path,
+ void Function()? onClose,
+ Future<Map<String, dynamic>> Function()? gatherCoverage})
+ : _onClose = onClose,
+ _gatherCoverage = gatherCoverage {
+ _suite = groupFuture
+ .then((group) => RunnerSuite._(this, group, platform, path: path));
+ }
+
+ /// Used by [RunnerSuite.new] to create a runner suite that's not loaded from
+ /// an external source.
+ RunnerSuiteController._local(this._environment, this._config,
+ {void Function()? onClose,
+ Future<Map<String, dynamic>> Function()? gatherCoverage})
+ : _suiteChannel = null,
+ _onClose = onClose,
+ _gatherCoverage = gatherCoverage;
+
+ /// Sets whether the suite is paused for debugging.
+ ///
+ /// If this is different than [suite.isDebugging], this will automatically
+ /// send out an event along [suite.onDebugging].
+ void setDebugging(bool debugging) {
+ if (debugging == _isDebugging) return;
+ _isDebugging = debugging;
+ _onDebuggingController.add(debugging);
+ }
+
+ /// Returns a channel that communicates with the remote suite.
+ ///
+ /// This connects to a channel created by code in the test worker calling the
+ /// `suiteChannel` argument from a `beforeLoad` callback to `serializeSuite`
+ /// with the same name.
+ /// It can be used used to send and receive any JSON-serializable object.
+ ///
+ /// This is exposed on the [RunnerSuiteController] so that runner plugins can
+ /// communicate with the workers they spawn before the associated [suite] is
+ /// fully loaded.
+ StreamChannel channel(String name) {
+ if (!_channelNames.add(name)) {
+ throw StateError('Duplicate RunnerSuite.channel() connection "$name".');
+ }
+
+ var suiteChannel = _suiteChannel;
+ if (suiteChannel == null) {
+ throw StateError('No suite channel set up but one was requested.');
+ }
+
+ var channel = suiteChannel.virtualChannel();
+ suiteChannel.sink
+ .add({'type': 'suiteChannel', 'name': name, 'id': channel.id});
+ return channel;
+ }
+
+ /// The backing function for [suite.close].
+ Future _close() => _closeMemo.runOnce(() async {
+ await _onDebuggingController.close();
+ var onClose = _onClose;
+ if (onClose != null) await onClose();
+ });
+ final _closeMemo = AsyncMemoizer<void>();
+}
diff --git a/pkgs/test_core/lib/src/runner/runner_test.dart b/pkgs/test_core/lib/src/runner/runner_test.dart
new file mode 100644
index 0000000..2823983
--- /dev/null
+++ b/pkgs/test_core/lib/src/runner/runner_test.dart
@@ -0,0 +1,108 @@
+// Copyright (c) 2015, 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:stack_trace/stack_trace.dart';
+import 'package:stream_channel/stream_channel.dart';
+import 'package:test_api/backend.dart'
+ show Metadata, RemoteException, SuitePlatform;
+import 'package:test_api/src/backend/group.dart'; // ignore: implementation_imports
+import 'package:test_api/src/backend/live_test.dart'; // ignore: implementation_imports
+import 'package:test_api/src/backend/live_test_controller.dart'; // ignore: implementation_imports
+import 'package:test_api/src/backend/message.dart'; // ignore: implementation_imports
+import 'package:test_api/src/backend/state.dart'; // ignore: implementation_imports
+import 'package:test_api/src/backend/suite.dart'; // ignore: implementation_imports
+import 'package:test_api/src/backend/test.dart'; // ignore: implementation_imports
+
+import 'spawn_hybrid.dart';
+
+/// A test running remotely, controlled by a stream channel.
+class RunnerTest extends Test {
+ @override
+ final String name;
+ @override
+ final Metadata metadata;
+ @override
+ final Trace? trace;
+
+ /// The channel used to communicate with the test's `RemoteListener`.
+ final MultiChannel _channel;
+
+ RunnerTest(this.name, this.metadata, this.trace, this._channel);
+
+ @override
+ LiveTest load(Suite suite, {Iterable<Group>? groups}) {
+ late final LiveTestController controller;
+ late final VirtualChannel testChannel;
+ controller = LiveTestController(suite, this, () {
+ controller.setState(const State(Status.running, Result.success));
+
+ testChannel = _channel.virtualChannel();
+ _channel.sink.add({'command': 'run', 'channel': testChannel.id});
+
+ testChannel.stream.listen((message) {
+ final msg = message as Map;
+ switch (msg['type'] as String) {
+ case 'error':
+ var asyncError = RemoteException.deserialize(
+ msg['error'] as Map<String, dynamic>);
+ var stackTrace = asyncError.stackTrace;
+ controller.addError(asyncError.error, stackTrace);
+ break;
+
+ case 'state-change':
+ controller.setState(State(Status.parse(msg['status'] as String),
+ Result.parse(msg['result'] as String)));
+ break;
+
+ case 'message':
+ controller.message(Message(
+ MessageType.parse(msg['message-type'] as String),
+ msg['text'] as String));
+ break;
+
+ case 'complete':
+ controller.completer.complete();
+ break;
+
+ case 'spawn-hybrid-uri':
+ // When we kill the isolate that the test lives in, that will close
+ // this virtual channel and cause the spawned isolate to close as
+ // well.
+ spawnHybridUri(msg['url'] as String, msg['message'], suite).pipe(
+ testChannel.virtualChannel((msg['channel'] as num).toInt()));
+ break;
+ }
+ }, onDone: () {
+ // When the test channel closes—presumably because the browser
+ // closed—mark the test as complete no matter what.
+ if (controller.completer.isCompleted) return;
+ controller.completer.complete();
+ });
+ }, () {
+ // If the test has finished running, just disconnect the channel.
+ if (controller.completer.isCompleted) {
+ testChannel.sink.close();
+ return;
+ }
+
+ unawaited(() async {
+ // If the test is still running, send it a message telling it to shut
+ // down ASAP. This causes the [Invoker] to eagerly throw exceptions
+ // whenever the test touches it.
+ testChannel.sink.add({'command': 'close'});
+ await controller.completer.future;
+ await testChannel.sink.close();
+ }());
+ }, groups: groups);
+ return controller;
+ }
+
+ @override
+ Test? forPlatform(SuitePlatform platform) {
+ if (!metadata.testOn.evaluate(platform)) return null;
+ return RunnerTest(name, metadata.forPlatform(platform), trace, _channel);
+ }
+}
diff --git a/pkgs/test_core/lib/src/runner/runtime_selection.dart b/pkgs/test_core/lib/src/runner/runtime_selection.dart
new file mode 100644
index 0000000..7f64a5c
--- /dev/null
+++ b/pkgs/test_core/lib/src/runner/runtime_selection.dart
@@ -0,0 +1,25 @@
+// Copyright (c) 2017, 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 'package:source_span/source_span.dart';
+
+/// A runtime on which the user has chosen to run tests.
+class RuntimeSelection {
+ /// The name of the runtime.
+ final String name;
+
+ /// The location in the configuration file of this runtime string, or `null`
+ /// if it was defined outside a configuration file (for example, on the
+ /// command line).
+ final SourceSpan? span;
+
+ RuntimeSelection(this.name, [this.span]);
+
+ @override
+ bool operator ==(Object other) =>
+ other is RuntimeSelection && other.name == name;
+
+ @override
+ int get hashCode => name.hashCode;
+}
diff --git a/pkgs/test_core/lib/src/runner/spawn_hybrid.dart b/pkgs/test_core/lib/src/runner/spawn_hybrid.dart
new file mode 100644
index 0000000..ed236b0
--- /dev/null
+++ b/pkgs/test_core/lib/src/runner/spawn_hybrid.dart
@@ -0,0 +1,167 @@
+// Copyright (c) 2016, 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:io';
+import 'dart:isolate';
+
+import 'package:analyzer/dart/analysis/utilities.dart';
+import 'package:async/async.dart';
+import 'package:path/path.dart' as p;
+import 'package:stream_channel/isolate_channel.dart';
+import 'package:stream_channel/stream_channel.dart';
+import 'package:test_api/backend.dart' show RemoteException;
+import 'package:test_api/src/backend/suite.dart'; // ignore: implementation_imports
+
+import '../util/dart.dart' as dart;
+import '../util/package_config.dart';
+import 'package_version.dart';
+
+/// Spawns a hybrid isolate from [url] with the given [message], and returns a
+/// [StreamChannel] that communicates with it.
+///
+/// This connects the main isolate to the hybrid isolate, whereas
+/// `lib/src/frontend/spawn_hybrid.dart` connects the test isolate to the main
+/// isolate.
+///
+/// If [uri] is relative, it will be interpreted relative to the `file:` URL
+/// for [suite]. If it's root-relative (that is, if it begins with `/`) it will
+/// be interpreted relative to the root of the package (the directory that
+/// contains `pubspec.yaml`, *not* the `test/` directory). If it's a `package:`
+/// URL, it will be resolved using the current package's dependency
+/// constellation.
+StreamChannel spawnHybridUri(String url, Object? message, Suite suite) {
+ return StreamChannelCompleter.fromFuture(() async {
+ url = await _normalizeUrl(url, suite);
+ var port = ReceivePort();
+ var onExitPort = ReceivePort();
+ try {
+ var code = '''
+ ${await _languageVersionCommentFor(url)}
+
+ import "package:test_core/src/runner/hybrid_listener.dart";
+
+ import "${url.replaceAll(r'$', '%24')}" as lib;
+
+ void main(_, List data) => listen(() => lib.hybridMain, data);
+ ''';
+
+ var isolate = await dart.runInIsolate(code, [port.sendPort, message],
+ onExit: onExitPort.sendPort);
+
+ // Ensure that we close [port] and [channel] when the isolate exits.
+ var disconnector = Disconnector<void>();
+ onExitPort.listen((_) {
+ disconnector.disconnect();
+ port.close();
+ onExitPort.close();
+ });
+
+ return IsolateChannel<Object?>.connectReceive(port)
+ .transform(disconnector)
+ .transformSink(StreamSinkTransformer.fromHandlers(handleDone: (sink) {
+ // If the user closes the stream channel, kill the isolate.
+ isolate.kill();
+ port.close();
+ onExitPort.close();
+ sink.close();
+ }));
+ } catch (error, stackTrace) {
+ port.close();
+ onExitPort.close();
+
+ // Make sure any errors in spawning the isolate are forwarded to the test.
+ return StreamChannel(
+ Stream.fromFuture(Future.value({
+ 'type': 'error',
+ 'error': RemoteException.serialize(error, stackTrace)
+ })),
+ NullStreamSink<void>());
+ }
+ }());
+}
+
+/// Normalizes [url] to an absolute url, resolving `package:` urls with the
+/// current package config.
+///
+/// If [url] has a scheme other than `package:`, then it is returned as is.
+///
+/// Follows the rules for relative/absolute paths outlined in [spawnHybridUri].
+Future<String> _normalizeUrl(String url, Suite suite) async {
+ final parsedUri = Uri.parse(url);
+
+ switch (parsedUri.scheme) {
+ case '':
+ var isRootRelative = parsedUri.path.startsWith('/');
+
+ if (isRootRelative) {
+ // We assume that the current path is the package root. `pub run`
+ // enforces this currently, but at some point it would probably be good
+ // to pass in an explicit root.
+ return p.url
+ .join(p.toUri(p.current).toString(), parsedUri.path.substring(1));
+ } else {
+ var suitePath = suite.path!;
+ return p.url.join(
+ p.url.dirname(p.toUri(p.absolute(suitePath)).toString()),
+ parsedUri.toString());
+ }
+ case 'package':
+ final resolvedUri = await Isolate.resolvePackageUri(parsedUri);
+ if (resolvedUri == null) {
+ throw ArgumentError.value(
+ url, 'uri', 'Could not resolve the package URI');
+ }
+ return resolvedUri.toString();
+ default:
+ return url;
+ }
+}
+
+/// Computes the a language version comment for the library at [uri].
+///
+/// If there is a language version comment in the file, that is returned.
+///
+/// If the URI has a `data` scheme, a comment representing the language version of
+/// the current package is returned.
+///
+/// Otherwise a comment representing the default version from the
+/// [currentPackageConfig] is returned.
+///
+/// If no default language version is known (the URI scheme is not recognized
+/// for instance), then an empty string is returned.
+Future<String> _languageVersionCommentFor(String url) async {
+ var parsedUri = Uri.parse(url);
+
+ // Returns the explicit language version comment if one exists.
+ var result = parseString(
+ content: await _readUri(parsedUri),
+ path: parsedUri.scheme == 'data' ? null : p.fromUri(parsedUri),
+ throwIfDiagnostics: false);
+ var languageVersionComment = result.unit.languageVersionToken?.value();
+ if (languageVersionComment != null) return languageVersionComment.toString();
+
+ // Returns the default language version for the package if one exists.
+ if (parsedUri.scheme.isEmpty || parsedUri.scheme == 'file') {
+ var packageConfig = await currentPackageConfig;
+ var package = packageConfig.packageOf(parsedUri);
+ var version = package?.languageVersion;
+ if (version != null) return '// @dart=$version';
+ }
+
+ // Returns the root package language version for `data` URIs. These are
+ // assumed to be from `spawnHybridCode` calls.
+ if (parsedUri.scheme == 'data') {
+ return await rootPackageLanguageVersionComment;
+ }
+
+ // Fall back on no language comment.
+ return '';
+}
+
+Future<String> _readUri(Uri uri) async => switch (uri.scheme) {
+ '' || 'file' => await File.fromUri(uri).readAsString(),
+ 'data' => uri.data!.contentAsString(),
+ _ => throw ArgumentError.value(uri, 'uri',
+ 'Only data and file uris (as well as relative paths) are supported'),
+ };
diff --git a/pkgs/test_core/lib/src/runner/suite.dart b/pkgs/test_core/lib/src/runner/suite.dart
new file mode 100644
index 0000000..b5ee0be
--- /dev/null
+++ b/pkgs/test_core/lib/src/runner/suite.dart
@@ -0,0 +1,498 @@
+// Copyright (c) 2016, 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 'package:boolean_selector/boolean_selector.dart';
+import 'package:collection/collection.dart';
+import 'package:source_span/source_span.dart';
+import 'package:test_api/scaffolding.dart' show Timeout;
+import 'package:test_api/src/backend/metadata.dart'; // ignore: implementation_imports
+import 'package:test_api/src/backend/platform_selector.dart'; // ignore: implementation_imports
+import 'package:test_api/src/backend/runtime.dart'; // ignore: implementation_imports
+import 'package:test_api/src/backend/suite_platform.dart'; // ignore: implementation_imports
+
+import 'compiler_selection.dart';
+import 'runtime_selection.dart';
+
+/// A filter on tests cases to run within a test suite.
+///
+/// The tests that match a test selection should match all available criteria. A
+/// suite run may include multiple test selections, and a test should run if it
+/// matches any test selection.
+///
+/// An empty [TestSelection()] will run all tests in the suite.
+final class TestSelection {
+ /// The patterns to check against test case names.
+ ///
+ /// Only run tests which match all the patterns.
+ final Set<Pattern> testPatterns;
+
+ /// Only run tests that originate from this line in the test suite.
+ final int? line;
+
+ /// Only run tests that originate from this column in the test suite.
+ final int? col;
+
+ const TestSelection({this.testPatterns = const {}, this.line, this.col});
+}
+
+/// Suite-level configuration.
+///
+/// This tracks configuration that can differ from suite to suite.
+final class SuiteConfiguration {
+ /// Empty configuration with only default values.
+ ///
+ /// Using this is slightly more efficient than manually constructing a new
+ /// configuration with no arguments.
+ static final empty = SuiteConfiguration._(
+ allowDuplicateTestNames: null,
+ allowTestRandomization: null,
+ jsTrace: null,
+ runSkipped: null,
+ dart2jsArgs: null,
+ testSelections: const {},
+ precompiledPath: null,
+ runtimes: null,
+ compilerSelections: null,
+ tags: null,
+ onPlatform: null,
+ metadata: null,
+ ignoreTimeouts: null);
+
+ /// Whether or not duplicate test (or group) names are allowed within the same
+ /// test suite.
+ //
+ // TODO: Change the default https://github.com/dart-lang/test/issues/1571
+ bool get allowDuplicateTestNames => _allowDuplicateTestNames ?? true;
+ final bool? _allowDuplicateTestNames;
+
+ /// Whether test randomization should be allowed for this test.
+ bool get allowTestRandomization => _allowTestRandomization ?? true;
+ final bool? _allowTestRandomization;
+
+ /// Whether JavaScript stack traces should be left as-is or converted to
+ /// Dart-like traces.
+ bool get jsTrace => _jsTrace ?? false;
+ final bool? _jsTrace;
+
+ /// Whether skipped tests should be run.
+ bool get runSkipped => _runSkipped ?? false;
+ final bool? _runSkipped;
+
+ /// The path to a mirror of this package containing HTML that points to
+ /// precompiled JS.
+ ///
+ /// This is used by the internal Google test runner so that test compilation
+ /// can more effectively make use of Google's build tools.
+ final String? precompiledPath;
+
+ /// Additional arguments to pass to dart2js.
+ ///
+ /// Note that this if multiple suites run the same JavaScript on different
+ /// runtimes, and they have different [dart2jsArgs], only one (undefined)
+ /// suite's arguments will be used.
+ final List<String> dart2jsArgs;
+
+ /// The selections for which tests to run in a suite.
+ ///
+ /// If empty, no tests have been selected for this suite.
+ /// Tests must be selected once for a suite before the suite can run.
+ /// When merging suite configurations, only one, or neither, should have tests
+ /// already selected.
+ ///
+ /// A test should run within a suite if it matches any selection in
+ /// [testSelections].
+ final Set<TestSelection> testSelections;
+
+ /// The set of compiler selections for running tests.
+ final List<CompilerSelection>? compilerSelections;
+
+ /// The set of runtimes on which to run tests.
+ List<String> get runtimes => _runtimes == null
+ ? const ['vm']
+ : List.unmodifiable(_runtimes.map((runtime) => runtime.name));
+ final List<RuntimeSelection>? _runtimes;
+
+ /// Configuration for particular tags.
+ ///
+ /// The keys are tag selectors, and the values are configurations for tests
+ /// whose tags match those selectors.
+ final Map<BooleanSelector, SuiteConfiguration> tags;
+
+ /// Configuration for particular platforms.
+ ///
+ /// The keys are platform selectors, and the values are configurations for
+ /// those platforms. These configuration should only contain test-level
+ /// configuration fields, but that isn't enforced.
+ final Map<PlatformSelector, SuiteConfiguration> onPlatform;
+
+ /// The global test metadata derived from this configuration.
+ Metadata get metadata {
+ if (tags.isEmpty && onPlatform.isEmpty) return _metadata;
+ return _metadata.change(
+ forTag: tags.map((key, config) => MapEntry(key, config.metadata)),
+ onPlatform:
+ onPlatform.map((key, config) => MapEntry(key, config.metadata)));
+ }
+
+ final Metadata _metadata;
+
+ /// The set of tags that have been declared in any way in this configuration.
+ late final Set<String> knownTags = UnmodifiableSetView({
+ ..._metadata.tags,
+ for (var selector in tags.keys) ...selector.variables,
+ for (var configuration in tags.values) ...configuration.knownTags,
+ for (var configuration in onPlatform.values) ...configuration.knownTags,
+ });
+
+ /// Whether or not timeouts should be ignored.
+ final bool? _ignoreTimeouts;
+ bool get ignoreTimeouts => _ignoreTimeouts ?? false;
+
+ factory SuiteConfiguration(
+ {required bool? allowDuplicateTestNames,
+ required bool? allowTestRandomization,
+ required bool? jsTrace,
+ required bool? runSkipped,
+ required Iterable<String>? dart2jsArgs,
+ required String? precompiledPath,
+ required Iterable<CompilerSelection>? compilerSelections,
+ required Iterable<RuntimeSelection>? runtimes,
+ required Map<BooleanSelector, SuiteConfiguration>? tags,
+ required Map<PlatformSelector, SuiteConfiguration>? onPlatform,
+ required bool? ignoreTimeouts,
+
+ // Test-level configuration
+ required Timeout? timeout,
+ required bool? verboseTrace,
+ required bool? chainStackTraces,
+ required bool? skip,
+ required int? retry,
+ required String? skipReason,
+ required PlatformSelector? testOn,
+ required Iterable<String>? addTags}) {
+ var config = SuiteConfiguration._(
+ allowDuplicateTestNames: allowDuplicateTestNames,
+ allowTestRandomization: allowTestRandomization,
+ jsTrace: jsTrace,
+ runSkipped: runSkipped,
+ dart2jsArgs: dart2jsArgs,
+ testSelections: const {},
+ precompiledPath: precompiledPath,
+ compilerSelections: compilerSelections,
+ runtimes: runtimes,
+ tags: tags,
+ onPlatform: onPlatform,
+ ignoreTimeouts: ignoreTimeouts,
+ metadata: Metadata(
+ timeout: timeout,
+ verboseTrace: verboseTrace,
+ chainStackTraces: chainStackTraces,
+ skip: skip,
+ retry: retry,
+ skipReason: skipReason,
+ testOn: testOn,
+ tags: addTags));
+ return config._resolveTags();
+ }
+
+ /// A constructor that doesn't require all of its options to be passed.
+ ///
+ /// This should only be used in situations where you really only want to
+ /// configure a specific restricted set of options.
+ factory SuiteConfiguration._unsafe(
+ {bool? allowDuplicateTestNames,
+ bool? allowTestRandomization,
+ bool? jsTrace,
+ bool? runSkipped,
+ Iterable<String>? dart2jsArgs,
+ String? precompiledPath,
+ Iterable<CompilerSelection>? compilerSelections,
+ Iterable<RuntimeSelection>? runtimes,
+ Map<BooleanSelector, SuiteConfiguration>? tags,
+ Map<PlatformSelector, SuiteConfiguration>? onPlatform,
+ bool? ignoreTimeouts,
+
+ // Test-level configuration
+ Timeout? timeout,
+ bool? verboseTrace,
+ bool? chainStackTraces,
+ bool? skip,
+ int? retry,
+ String? skipReason,
+ PlatformSelector? testOn,
+ Iterable<String>? addTags}) =>
+ SuiteConfiguration(
+ allowDuplicateTestNames: allowDuplicateTestNames,
+ allowTestRandomization: allowTestRandomization,
+ jsTrace: jsTrace,
+ runSkipped: runSkipped,
+ dart2jsArgs: dart2jsArgs,
+ precompiledPath: precompiledPath,
+ compilerSelections: compilerSelections,
+ runtimes: runtimes,
+ tags: tags,
+ onPlatform: onPlatform,
+ ignoreTimeouts: ignoreTimeouts,
+ timeout: timeout,
+ verboseTrace: verboseTrace,
+ chainStackTraces: chainStackTraces,
+ skip: skip,
+ retry: retry,
+ skipReason: skipReason,
+ testOn: testOn,
+ addTags: addTags);
+
+ /// A specialized constructor for only configuring the runtimes.
+ factory SuiteConfiguration.runtimes(Iterable<RuntimeSelection> runtimes) =>
+ SuiteConfiguration._unsafe(runtimes: runtimes);
+
+ /// A specialized constructor for only configuring runSkipped.
+ factory SuiteConfiguration.runSkipped(bool runSkipped) =>
+ SuiteConfiguration._unsafe(runSkipped: runSkipped);
+
+ /// A specialized constructor for only configuring the timeout.
+ factory SuiteConfiguration.timeout(Timeout timeout) =>
+ SuiteConfiguration._unsafe(timeout: timeout);
+
+ /// Creates new SuiteConfiguration.
+ ///
+ /// Unlike [SuiteConfiguration.new], this assumes [tags] is already
+ /// resolved.
+ SuiteConfiguration._({
+ required bool? allowDuplicateTestNames,
+ required bool? allowTestRandomization,
+ required bool? jsTrace,
+ required bool? runSkipped,
+ required Iterable<String>? dart2jsArgs,
+ required this.testSelections,
+ required this.precompiledPath,
+ required Iterable<CompilerSelection>? compilerSelections,
+ required Iterable<RuntimeSelection>? runtimes,
+ required Map<BooleanSelector, SuiteConfiguration>? tags,
+ required Map<PlatformSelector, SuiteConfiguration>? onPlatform,
+ required Metadata? metadata,
+ required bool? ignoreTimeouts,
+ }) : _allowDuplicateTestNames = allowDuplicateTestNames,
+ _allowTestRandomization = allowTestRandomization,
+ _jsTrace = jsTrace,
+ _runSkipped = runSkipped,
+ dart2jsArgs = _list(dart2jsArgs) ?? const [],
+ _runtimes = _list(runtimes),
+ compilerSelections = _list(compilerSelections),
+ tags = _map(tags),
+ onPlatform = _map(onPlatform),
+ _ignoreTimeouts = ignoreTimeouts,
+ _metadata = metadata ?? Metadata.empty;
+
+ /// Creates a new [SuiteConfiguration] that takes its configuration from
+ /// [metadata].
+ factory SuiteConfiguration.fromMetadata(Metadata metadata) =>
+ SuiteConfiguration._(
+ tags: metadata.forTag.map((key, child) =>
+ MapEntry(key, SuiteConfiguration.fromMetadata(child))),
+ onPlatform: metadata.onPlatform.map((key, child) =>
+ MapEntry(key, SuiteConfiguration.fromMetadata(child))),
+ metadata: metadata.change(forTag: {}, onPlatform: {}),
+ allowDuplicateTestNames: null,
+ allowTestRandomization: null,
+ jsTrace: null,
+ runSkipped: null,
+ dart2jsArgs: null,
+ testSelections: const {},
+ precompiledPath: null,
+ runtimes: null,
+ compilerSelections: null,
+ ignoreTimeouts: null,
+ );
+
+ /// Returns an unmodifiable copy of [input].
+ ///
+ /// If [input] is `null` or empty, this returns `null`.
+ static List<T>? _list<T>(Iterable<T>? input) {
+ if (input == null) return null;
+ var list = List<T>.unmodifiable(input);
+ if (list.isEmpty) return null;
+ return list;
+ }
+
+ /// Returns an unmodifiable copy of [input] or an empty unmodifiable map.
+ static Map<K, V> _map<K, V>(Map<K, V>? input) {
+ if (input == null || input.isEmpty) return const <Never, Never>{};
+ return Map.unmodifiable(input);
+ }
+
+ /// Merges this with [other].
+ ///
+ /// For most fields, if both configurations have values set, [other]'s value
+ /// takes precedence. However, certain fields are merged together instead.
+ /// This is indicated in those fields' documentation.
+ SuiteConfiguration merge(SuiteConfiguration other) {
+ if (this == SuiteConfiguration.empty) return other;
+ if (other == SuiteConfiguration.empty) return this;
+ assert(testSelections.isEmpty || other.testSelections.isEmpty);
+
+ var config = SuiteConfiguration._(
+ allowDuplicateTestNames:
+ other._allowDuplicateTestNames ?? _allowDuplicateTestNames,
+ allowTestRandomization:
+ other._allowTestRandomization ?? _allowTestRandomization,
+ jsTrace: other._jsTrace ?? _jsTrace,
+ runSkipped: other._runSkipped ?? _runSkipped,
+ dart2jsArgs: dart2jsArgs.toList()..addAll(other.dart2jsArgs),
+ testSelections:
+ testSelections.isEmpty ? other.testSelections : testSelections,
+ precompiledPath: other.precompiledPath ?? precompiledPath,
+ compilerSelections: other.compilerSelections ?? compilerSelections,
+ runtimes: other._runtimes ?? _runtimes,
+ tags: _mergeConfigMaps(tags, other.tags),
+ onPlatform: _mergeConfigMaps(onPlatform, other.onPlatform),
+ ignoreTimeouts: other._ignoreTimeouts ?? _ignoreTimeouts,
+ metadata: metadata.merge(other.metadata));
+ return config._resolveTags();
+ }
+
+ /// Returns a copy of this configuration with the given fields updated.
+ ///
+ /// Note that unlike [merge], this has no merging behavior—the old value is
+ /// always replaced by the new one.
+ SuiteConfiguration change(
+ {bool? allowDuplicateTestNames,
+ bool? allowTestRandomization,
+ bool? jsTrace,
+ bool? runSkipped,
+ Iterable<String>? dart2jsArgs,
+ String? precompiledPath,
+ Iterable<CompilerSelection>? compilerSelections,
+ Iterable<RuntimeSelection>? runtimes,
+ Map<BooleanSelector, SuiteConfiguration>? tags,
+ Map<PlatformSelector, SuiteConfiguration>? onPlatform,
+ bool? ignoreTimeouts,
+
+ // Test-level configuration
+ Timeout? timeout,
+ bool? verboseTrace,
+ bool? chainStackTraces,
+ bool? skip,
+ int? retry,
+ String? skipReason,
+ PlatformSelector? testOn,
+ Iterable<String>? addTags}) {
+ var config = SuiteConfiguration._(
+ allowDuplicateTestNames:
+ allowDuplicateTestNames ?? _allowDuplicateTestNames,
+ allowTestRandomization:
+ allowTestRandomization ?? _allowTestRandomization,
+ jsTrace: jsTrace ?? _jsTrace,
+ runSkipped: runSkipped ?? _runSkipped,
+ dart2jsArgs: dart2jsArgs?.toList() ?? this.dart2jsArgs,
+ testSelections: testSelections,
+ precompiledPath: precompiledPath ?? this.precompiledPath,
+ compilerSelections: compilerSelections ?? this.compilerSelections,
+ runtimes: runtimes ?? _runtimes,
+ tags: tags ?? this.tags,
+ onPlatform: onPlatform ?? this.onPlatform,
+ ignoreTimeouts: ignoreTimeouts ?? _ignoreTimeouts,
+ metadata: _metadata.change(
+ timeout: timeout,
+ verboseTrace: verboseTrace,
+ chainStackTraces: chainStackTraces,
+ skip: skip,
+ retry: retry,
+ skipReason: skipReason,
+ testOn: testOn,
+ tags: addTags?.toSet()));
+ return config._resolveTags();
+ }
+
+ /// Assign the selection of tests that should run for this suite.
+ ///
+ /// Test selections must be chosen only once per suite, once a
+ /// SuiteConfiguration has test slections this method should not be called
+ /// again.
+ ///
+ /// [testSelections] must not be empty.
+ SuiteConfiguration selectTests(Set<TestSelection> testSelections) {
+ assert(this.testSelections.isEmpty);
+ assert(testSelections.isNotEmpty);
+ return SuiteConfiguration._(
+ testSelections: testSelections,
+ allowDuplicateTestNames: _allowDuplicateTestNames,
+ allowTestRandomization: _allowTestRandomization,
+ jsTrace: _jsTrace,
+ runSkipped: _runSkipped,
+ dart2jsArgs: dart2jsArgs,
+ precompiledPath: precompiledPath,
+ compilerSelections: compilerSelections,
+ runtimes: _runtimes,
+ tags: tags,
+ onPlatform: onPlatform,
+ ignoreTimeouts: _ignoreTimeouts,
+ metadata: _metadata);
+ }
+
+ /// Throws a [FormatException] if this refers to any undefined runtimes.
+ void validateRuntimes(List<Runtime> allRuntimes) {
+ var validVariables =
+ allRuntimes.map((runtime) => runtime.identifier).toSet();
+ _metadata.validatePlatformSelectors(validVariables);
+
+ var runtimes = _runtimes;
+ if (runtimes != null) {
+ for (var selection in runtimes) {
+ if (!allRuntimes
+ .any((runtime) => runtime.identifier == selection.name)) {
+ if (selection.span != null) {
+ throw SourceSpanFormatException(
+ 'Unknown platform "${selection.name}".', selection.span);
+ } else {
+ throw FormatException('Unknown platform "${selection.name}".');
+ }
+ }
+ }
+ }
+
+ onPlatform.forEach((selector, config) {
+ selector.validate(validVariables);
+ config.validateRuntimes(allRuntimes);
+ });
+ }
+
+ /// Returns a copy of this with all platform-specific configuration from
+ /// [onPlatform] resolved.
+ SuiteConfiguration forPlatform(SuitePlatform platform) {
+ if (onPlatform.isEmpty) return this;
+
+ var config = this;
+ onPlatform.forEach((platformSelector, platformConfig) {
+ if (!platformSelector.evaluate(platform)) return;
+ config = config.merge(platformConfig);
+ });
+ return config.change(onPlatform: {});
+ }
+
+ /// Merges two maps whose values are [SuiteConfiguration]s.
+ ///
+ /// Any overlapping keys in the maps have their configurations merged in the
+ /// returned map.
+ Map<T, SuiteConfiguration> _mergeConfigMaps<T>(
+ Map<T, SuiteConfiguration> map1, Map<T, SuiteConfiguration> map2) =>
+ mergeMaps(map1, map2,
+ value: (config1, config2) => config1.merge(config2));
+
+ SuiteConfiguration _resolveTags() {
+ // If there's no tag-specific configuration, or if none of it applies, just
+ // return the configuration as-is.
+ if (_metadata.tags.isEmpty || tags.isEmpty) return this;
+
+ // Otherwise, resolve the tag-specific components.
+ var newTags = Map<BooleanSelector, SuiteConfiguration>.from(tags);
+ var merged = tags.keys.fold(empty, (SuiteConfiguration merged, selector) {
+ if (!selector.evaluate(_metadata.tags.contains)) return merged;
+ return merged.merge(newTags.remove(selector)!);
+ });
+
+ if (merged == empty) return this;
+ return change(tags: newTags).merge(merged);
+ }
+}
diff --git a/pkgs/test_core/lib/src/runner/util/iterable_set.dart b/pkgs/test_core/lib/src/runner/util/iterable_set.dart
new file mode 100644
index 0000000..09335ba
--- /dev/null
+++ b/pkgs/test_core/lib/src/runner/util/iterable_set.dart
@@ -0,0 +1,44 @@
+// Copyright (c) 2016, 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:collection';
+
+import 'package:collection/collection.dart';
+
+/// An unmodifiable [Set] view backed by an arbitrary [Iterable].
+///
+/// Note that contrary to most APIs that take iterables, this does not convert
+/// its argument to another collection before use. This means that if it's
+/// lazily-generated, that generation will happen for every operation.
+///
+/// Note also that set operations that are usually expected to be `O(1)` or
+/// `O(log(n))`, such as [contains], may be `O(n)` for many underlying iterable
+/// types. As such, this should only be used for small iterables.
+class IterableSet<E> with SetMixin<E>, UnmodifiableSetMixin<E> {
+ /// The base iterable that set operations forward to.
+ final Iterable<E> _base;
+
+ @override
+ int get length => _base.length;
+
+ @override
+ Iterator<E> get iterator => _base.iterator;
+
+ /// Creates a [Set] view of [base].
+ IterableSet(this._base);
+
+ @override
+ bool contains(Object? element) => _base.contains(element);
+
+ @override
+ E? lookup(Object? element) {
+ for (var e in _base) {
+ if (e == element) return e;
+ }
+ return null;
+ }
+
+ @override
+ Set<E> toSet() => _base.toSet();
+}
diff --git a/pkgs/test_core/lib/src/runner/version.dart b/pkgs/test_core/lib/src/runner/version.dart
new file mode 100644
index 0000000..3eab242
--- /dev/null
+++ b/pkgs/test_core/lib/src/runner/version.dart
@@ -0,0 +1,60 @@
+// Copyright (c) 2015, 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:io';
+
+import 'package:yaml/yaml.dart';
+
+/// The version number of the test runner, or `null` if it couldn't be loaded.
+///
+/// This is a semantic version, optionally followed by a space and additional
+/// data about its source.
+final String? testVersion = (() {
+ dynamic lockfile;
+ try {
+ lockfile = loadYaml(File('pubspec.lock').readAsStringSync());
+ } on FormatException catch (_) {
+ return null;
+ } on IOException catch (_) {
+ return null;
+ }
+
+ if (lockfile is! Map) return null;
+ var packages = lockfile['packages'];
+ if (packages is! Map) return null;
+ var package = packages['test'];
+ if (package is! Map) return null;
+
+ var source = package['source'];
+ if (source is! String) return null;
+
+ switch (source) {
+ case 'hosted':
+ var version = package['version'];
+ return (version is String) ? version : null;
+
+ case 'git':
+ var version = package['version'];
+ if (version is! String) return null;
+ var description = package['description'];
+ if (description is! Map) return null;
+ var ref = description['resolved-ref'];
+ if (ref is! String) return null;
+
+ return '$version (${ref.substring(0, 7)})';
+
+ case 'path':
+ var version = package['version'];
+ if (version is! String) return null;
+ var description = package['description'];
+ if (description is! Map) return null;
+ var path = description['path'];
+ if (path is! String) return null;
+
+ return '$version (from $path)';
+
+ default:
+ return null;
+ }
+})();
diff --git a/pkgs/test_core/lib/src/runner/vm/environment.dart b/pkgs/test_core/lib/src/runner/vm/environment.dart
new file mode 100644
index 0000000..76cc2fd
--- /dev/null
+++ b/pkgs/test_core/lib/src/runner/vm/environment.dart
@@ -0,0 +1,42 @@
+// Copyright (c) 2018, 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:async/async.dart';
+import 'package:vm_service/vm_service.dart';
+
+import '../environment.dart'; // ignore: implementation_imports
+
+/// The environment in which VM tests are loaded.
+class VMEnvironment implements Environment {
+ @override
+ final supportsDebugging = true;
+ @override
+ final Uri observatoryUrl;
+
+ /// The VM service isolate object used to control this isolate.
+ final IsolateRef _isolate;
+ final VmService _client;
+
+ VMEnvironment(this.observatoryUrl, this._isolate, this._client);
+
+ @override
+ Uri? get remoteDebuggerUrl => null;
+
+ @override
+ Stream<void> get onRestart => StreamController<void>.broadcast().stream;
+
+ @override
+ CancelableOperation<void> displayPause() {
+ var completer =
+ CancelableCompleter<void>(onCancel: () => _client.resume(_isolate.id!));
+
+ completer.complete(_client.pause(_isolate.id!).then((_) => _client
+ .onDebugEvent
+ .firstWhere((event) => event.kind == EventKind.kResume)));
+
+ return completer.operation;
+ }
+}
diff --git a/pkgs/test_core/lib/src/runner/vm/platform.dart b/pkgs/test_core/lib/src/runner/vm/platform.dart
new file mode 100644
index 0000000..506909d
--- /dev/null
+++ b/pkgs/test_core/lib/src/runner/vm/platform.dart
@@ -0,0 +1,357 @@
+// Copyright (c) 2016, 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 'dart:convert';
+import 'dart:developer';
+import 'dart:io';
+import 'dart:isolate';
+
+import 'package:async/async.dart';
+import 'package:coverage/coverage.dart';
+import 'package:path/path.dart' as p;
+import 'package:stream_channel/isolate_channel.dart';
+import 'package:stream_channel/stream_channel.dart';
+import 'package:test_api/backend.dart';
+import 'package:vm_service/vm_service.dart' hide Isolate;
+import 'package:vm_service/vm_service_io.dart';
+
+import '../../runner/configuration.dart';
+import '../../runner/environment.dart';
+import '../../runner/load_exception.dart';
+import '../../runner/platform.dart';
+import '../../runner/plugin/platform_helpers.dart';
+import '../../runner/plugin/shared_platform_helpers.dart';
+import '../../runner/runner_suite.dart';
+import '../../runner/suite.dart';
+import '../../util/io.dart';
+import '../../util/package_config.dart';
+import '../package_version.dart';
+import 'environment.dart';
+import 'test_compiler.dart';
+
+var _shouldPauseAfterTests = false;
+
+/// A platform that loads tests in isolates spawned within this Dart process.
+class VMPlatform extends PlatformPlugin {
+ /// The test runner configuration.
+ final _config = Configuration.current;
+ final _compiler = TestCompiler(
+ p.join(p.current, '.dart_tool', 'test', 'incremental_kernel'));
+ final _closeMemo = AsyncMemoizer<void>();
+ final _tempDir = Directory.systemTemp.createTempSync('dart_test.vm.');
+
+ @override
+ Future<RunnerSuite?> load(String path, SuitePlatform platform,
+ SuiteConfiguration suiteConfig, Map<String, Object?> message) async {
+ assert(platform.runtime == Runtime.vm);
+
+ _setupPauseAfterTests();
+
+ MultiChannel outerChannel;
+ var cleanupCallbacks = <void Function()>[];
+ Isolate? isolate;
+ if (platform.compiler == Compiler.exe) {
+ var serverSocket = await ServerSocket.bind('localhost', 0);
+ Process process;
+ try {
+ process =
+ await _spawnExecutable(path, suiteConfig.metadata, serverSocket);
+ } catch (error) {
+ unawaited(serverSocket.close());
+ rethrow;
+ }
+ process.stdout.listen(stdout.add);
+ process.stderr.listen(stderr.add);
+ var socket = await serverSocket.first;
+ outerChannel = MultiChannel<Object?>(jsonSocketStreamChannel(socket));
+ cleanupCallbacks
+ ..add(serverSocket.close)
+ ..add(process.kill);
+ } else {
+ var receivePort = ReceivePort();
+ try {
+ isolate = await _spawnIsolate(path, receivePort.sendPort,
+ suiteConfig.metadata, platform.compiler);
+ if (isolate == null) return null;
+ } catch (error) {
+ receivePort.close();
+ rethrow;
+ }
+ outerChannel = MultiChannel(IsolateChannel.connectReceive(receivePort));
+ cleanupCallbacks.add(isolate.kill);
+ }
+ cleanupCallbacks.add(outerChannel.sink.close);
+
+ VmService? client;
+ StreamSubscription<Event>? eventSub;
+ // Typical test interaction will go across `channel`, `outerChannel` adds
+ // additional communication directly between the test bootstrapping and this
+ // platform to enable pausing after tests for debugging.
+ var outerQueue = StreamQueue(outerChannel.stream);
+ var channelId = (await outerQueue.next) as int;
+ var channel = outerChannel.virtualChannel(channelId).transformStream(
+ StreamTransformer.fromHandlers(handleDone: (sink) async {
+ if (_shouldPauseAfterTests) {
+ outerChannel.sink.add('debug');
+ await outerQueue.next;
+ }
+ for (var fn in cleanupCallbacks) {
+ fn();
+ }
+ unawaited(eventSub?.cancel());
+ unawaited(client?.dispose());
+ sink.close();
+ }));
+
+ Environment? environment;
+ IsolateRef? isolateRef;
+ if (_config.debug) {
+ if (platform.compiler == Compiler.exe) {
+ throw UnsupportedError(
+ 'Unable to debug tests compiled to `exe` (tried to debug $path with '
+ 'the `exe` compiler).');
+ }
+ var info =
+ await Service.controlWebServer(enable: true, silenceOutput: true);
+ // ignore: deprecated_member_use, Remove when SDK constraint is at 3.2.0
+ var isolateID = Service.getIsolateID(isolate!)!;
+
+ var libraryPath = (await absoluteUri(path)).toString();
+ var serverUri = info.serverUri!;
+ client = await vmServiceConnectUri(_wsUriFor(serverUri).toString());
+ var isolateNumber = int.parse(isolateID.split('/').last);
+ isolateRef = (await client.getVM())
+ .isolates!
+ .firstWhere((isolate) => isolate.number == isolateNumber.toString());
+ await client.setName(isolateRef.id!, path);
+ var libraryRef = (await client.getIsolate(isolateRef.id!))
+ .libraries!
+ .firstWhere((library) => library.uri == libraryPath);
+ var url = _observatoryUrlFor(serverUri, isolateRef.id!, libraryRef.id!);
+ environment = VMEnvironment(url, isolateRef, client);
+ }
+
+ environment ??= const PluginEnvironment();
+
+ var controller = deserializeSuite(
+ path, platform, suiteConfig, environment, channel.cast(), message,
+ gatherCoverage: () => _gatherCoverage(environment!));
+
+ if (isolateRef != null) {
+ await client!.streamListen('Debug');
+ eventSub = client.onDebugEvent.listen((event) {
+ if (event.kind == EventKind.kResume) {
+ controller.setDebugging(false);
+ } else if (event.kind == EventKind.kPauseInterrupted ||
+ event.kind == EventKind.kPauseBreakpoint ||
+ event.kind == EventKind.kPauseException) {
+ controller.setDebugging(true);
+ }
+ });
+ }
+
+ return await controller.suite;
+ }
+
+ @override
+ Future close() => _closeMemo.runOnce(() => Future.wait([
+ _compiler.dispose(),
+ _tempDir.deleteWithRetry(),
+ ]));
+
+ /// Compiles [path] to a native executable and spawns it as a process.
+ ///
+ /// Sets up a communication channel as well by passing command line arguments
+ /// for the host and port of [socket].
+ Future<Process> _spawnExecutable(
+ String path, Metadata suiteMetadata, ServerSocket socket) async {
+ if (_config.suiteDefaults.precompiledPath != null) {
+ throw UnsupportedError(
+ 'Precompiled native executable tests are not supported at this time');
+ }
+ var executable = await _compileToNative(path, suiteMetadata);
+ return await Process.start(
+ executable, [socket.address.host, socket.port.toString()]);
+ }
+
+ /// Compiles [path] to a native executable using `dart compile exe`.
+ Future<String> _compileToNative(String path, Metadata suiteMetadata) async {
+ var bootstrapPath = await _bootstrapNativeTestFile(
+ path,
+ suiteMetadata.languageVersionComment ??
+ await rootPackageLanguageVersionComment);
+ var output = File(p.setExtension(bootstrapPath, '.exe'));
+ var processResult = await Process.run(Platform.resolvedExecutable, [
+ 'compile',
+ 'exe',
+ bootstrapPath,
+ '--output',
+ output.path,
+ '--packages',
+ (await packageConfigUri).toFilePath(),
+ ]);
+ if (processResult.exitCode != 0 || !(await output.exists())) {
+ throw LoadException(path, '''
+exitCode: ${processResult.exitCode}
+stdout: ${processResult.stdout}
+stderr: ${processResult.stderr}''');
+ }
+ return output.path;
+ }
+
+ /// Spawns an isolate with the current configuration and passes it [message].
+ ///
+ /// This isolate connects an [IsolateChannel] to [message] and sends the
+ /// serialized tests over that channel.
+ ///
+ /// Returns `null` if an exception occurs but [close] has already been called.
+ Future<Isolate?> _spawnIsolate(String path, SendPort message,
+ Metadata suiteMetadata, Compiler compiler) async {
+ try {
+ var precompiledPath = _config.suiteDefaults.precompiledPath;
+ if (precompiledPath != null) {
+ return _spawnPrecompiledIsolate(
+ path, message, precompiledPath, compiler);
+ }
+ return switch (compiler) {
+ Compiler.kernel => _spawnIsolateWithUri(
+ await _compileToKernel(path, suiteMetadata), message),
+ Compiler.source => _spawnIsolateWithUri(
+ await _bootstrapIsolateTestFile(
+ path,
+ suiteMetadata.languageVersionComment ??
+ await rootPackageLanguageVersionComment),
+ message),
+ _ => throw StateError(
+ 'Unsupported compiler $compiler for the VM platform'),
+ };
+ } catch (_) {
+ if (_closeMemo.hasRun) return null;
+ rethrow;
+ }
+ }
+
+ /// Compiles [path] to kernel and returns the uri to the compiled dill.
+ Future<Uri> _compileToKernel(String path, Metadata suiteMetadata) async {
+ final response =
+ await _compiler.compile(await absoluteUri(path), suiteMetadata);
+ var compiledDill = response.kernelOutputUri?.toFilePath();
+ if (compiledDill == null || response.errorCount > 0) {
+ throw LoadException(path, response.compilerOutput ?? 'unknown error');
+ }
+ return absoluteUri(compiledDill);
+ }
+
+ /// Runs [uri] in an isolate, passing [message].
+ Future<Isolate> _spawnIsolateWithUri(Uri uri, SendPort message) async {
+ return await Isolate.spawnUri(uri, [], message,
+ packageConfig: await packageConfigUri, checked: true);
+ }
+
+ Future<Isolate> _spawnPrecompiledIsolate(String testPath, SendPort message,
+ String precompiledPath, Compiler compiler) async {
+ var testUri =
+ await absoluteUri('${p.join(precompiledPath, testPath)}.vm_test.dart');
+ testUri = testUri.replace(path: testUri.path.stripDriveLetterLeadingSlash);
+
+ switch (compiler) {
+ case Compiler.kernel:
+ // Load `.dill` files from their absolute file path.
+ var dillUri = (await Isolate.resolvePackageUri(testUri.replace(
+ path:
+ '${testUri.path.substring(0, testUri.path.length - '.dart'.length)}'
+ '.vm.app.dill')))!;
+ if (await File.fromUri(dillUri).exists()) {
+ testUri = dillUri;
+ }
+ // TODO: Compile to kernel manually here? Otherwise we aren't compiling
+ // with kernel when we technically should be, based on the compiler
+ // setting.
+ break;
+ case Compiler.source:
+ // Just leave test uri as is.
+ break;
+ default:
+ throw StateError('Unsupported compiler for the VM platform $compiler.');
+ }
+ File? packageConfig =
+ File(p.join(precompiledPath, '.dart_tool/package_config.json'));
+ if (!(await packageConfig.exists())) {
+ packageConfig = File(p.join(precompiledPath, '.packages'));
+ if (!(await packageConfig.exists())) {
+ packageConfig = null;
+ }
+ }
+ return await Isolate.spawnUri(testUri, [], message,
+ packageConfig: packageConfig?.uri, checked: true);
+ }
+
+ /// Bootstraps the test at [testPath] and writes its contents to a temporary
+ /// file.
+ ///
+ /// Returns the [Uri] to the created file.
+ Future<Uri> _bootstrapIsolateTestFile(
+ String testPath, String languageVersionComment) async {
+ var file = File(p.join(
+ _tempDir.path, p.setExtension(testPath, '.bootstrap.isolate.dart')));
+ if (!file.existsSync()) {
+ file
+ ..createSync(recursive: true)
+ ..writeAsStringSync(testBootstrapContents(
+ testUri: await absoluteUri(testPath),
+ languageVersionComment: languageVersionComment,
+ packageConfigUri: await packageConfigUri,
+ testType: VmTestType.isolate,
+ ));
+ }
+ return file.uri;
+ }
+
+ /// Bootstraps the test at [testPath] for native execution and writes its
+ /// contents to a temporary file.
+ ///
+ /// Returns the path to the created file.
+ Future<String> _bootstrapNativeTestFile(
+ String testPath, String languageVersionComment) async {
+ var file = File(p.join(
+ _tempDir.path, p.setExtension(testPath, '.bootstrap.native.dart')));
+ if (!file.existsSync()) {
+ file
+ ..createSync(recursive: true)
+ ..writeAsStringSync(testBootstrapContents(
+ testUri: await absoluteUri(testPath),
+ languageVersionComment: languageVersionComment,
+ packageConfigUri: await packageConfigUri,
+ testType: VmTestType.process,
+ ));
+ }
+ return file.path;
+ }
+}
+
+Future<Map<String, dynamic>> _gatherCoverage(Environment environment) async {
+ final isolateId = Uri.parse(environment.observatoryUrl!.fragment)
+ .queryParameters['isolateId'];
+ return await collect(environment.observatoryUrl!, false, false, false, {},
+ isolateIds: {isolateId!});
+}
+
+Uri _wsUriFor(Uri observatoryUrl) =>
+ observatoryUrl.replace(scheme: 'ws').resolve('ws');
+
+Uri _observatoryUrlFor(Uri base, String isolateId, String id) => base.replace(
+ fragment: Uri(
+ path: '/inspect',
+ queryParameters: {'isolateId': isolateId, 'objectId': id}).toString());
+
+var _hasRegistered = false;
+void _setupPauseAfterTests() {
+ if (_hasRegistered) return;
+ _hasRegistered = true;
+ registerExtension('ext.test.pauseAfterTests', (_, __) async {
+ _shouldPauseAfterTests = true;
+ return ServiceExtensionResponse.result(jsonEncode({}));
+ });
+}
diff --git a/pkgs/test_core/lib/src/runner/vm/test_compiler.dart b/pkgs/test_core/lib/src/runner/vm/test_compiler.dart
new file mode 100644
index 0000000..56fbbd2
--- /dev/null
+++ b/pkgs/test_core/lib/src/runner/vm/test_compiler.dart
@@ -0,0 +1,238 @@
+// Copyright (c) 2020, 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 'dart:convert';
+import 'dart:io';
+
+import 'package:async/async.dart';
+import 'package:frontend_server_client/frontend_server_client.dart';
+import 'package:path/path.dart' as p;
+import 'package:pool/pool.dart';
+import 'package:test_api/backend.dart';
+
+import '../../util/dart.dart';
+import '../../util/io.dart';
+import '../../util/package_config.dart';
+import '../package_version.dart';
+
+class CompilationResponse {
+ final String? compilerOutput;
+ final int errorCount;
+ final Uri? kernelOutputUri;
+
+ const CompilationResponse(
+ {this.compilerOutput, this.errorCount = 0, this.kernelOutputUri});
+
+ static const _wasShutdown = CompilationResponse(
+ errorCount: 1, compilerOutput: 'Compiler no longer active.');
+}
+
+class TestCompiler {
+ final _closeMemo = AsyncMemoizer<void>();
+
+ /// Each language version that appears in test files gets its own compiler,
+ /// to ensure that all language modes are supported (such as sound and
+ /// unsound null safety).
+ final _compilerForLanguageVersion =
+ <String, _TestCompilerForLanguageVersion>{};
+
+ /// A prefix used for the dill files for each compiler that is created.
+ final String _dillCachePrefix;
+
+ /// No work is done until the first call to [compile] is received, at which
+ /// point the compiler process is started.
+ TestCompiler(this._dillCachePrefix);
+
+ /// Compiles [mainDart], using a separate compiler per language version of
+ /// the tests.
+ Future<CompilationResponse> compile(Uri mainDart, Metadata metadata) async {
+ if (_closeMemo.hasRun) return CompilationResponse._wasShutdown;
+ var languageVersionComment = metadata.languageVersionComment ??
+ await rootPackageLanguageVersionComment;
+ var compiler = _compilerForLanguageVersion.putIfAbsent(
+ languageVersionComment,
+ () => _TestCompilerForLanguageVersion(
+ _dillCachePrefix, languageVersionComment));
+ return compiler.compile(mainDart);
+ }
+
+ Future<void> dispose() => _closeMemo.runOnce(() => Future.wait([
+ for (var compiler in _compilerForLanguageVersion.values)
+ compiler.dispose(),
+ ]));
+}
+
+class _TestCompilerForLanguageVersion {
+ final _closeMemo = AsyncMemoizer<void>();
+ final _compilePool = Pool(1);
+ final String _dillCachePath;
+ FrontendServerClient? _frontendServerClient;
+ final String _languageVersionComment;
+ late final _outputDill =
+ File(p.join(_outputDillDirectory.path, 'output.dill'));
+ final _outputDillDirectory =
+ Directory.systemTemp.createTempSync('dart_test.kernel.');
+ // Used to create unique file names for final kernel files.
+ int _compileNumber = 0;
+ // The largest incremental dill file we created, will be cached under
+ // the `.dart_tool` dir at the end of compilation.
+ File? _dillToCache;
+
+ _TestCompilerForLanguageVersion(
+ String dillCachePrefix, this._languageVersionComment)
+ : _dillCachePath = '$dillCachePrefix.'
+ '${_dillCacheSuffix(_languageVersionComment, enabledExperiments)}';
+
+ Future<CompilationResponse> compile(Uri mainUri) =>
+ _compilePool.withResource(() => _compile(mainUri));
+
+ Future<CompilationResponse> _compile(Uri mainUri) async {
+ _compileNumber++;
+ if (_closeMemo.hasRun) return CompilationResponse._wasShutdown;
+ CompileResult? compilerOutput;
+ final tempFile = File(p.join(_outputDillDirectory.path, 'test.dart'))
+ ..writeAsStringSync(testBootstrapContents(
+ testUri: mainUri,
+ packageConfigUri: await packageConfigUri,
+ languageVersionComment: _languageVersionComment,
+ testType: VmTestType.isolate,
+ ));
+ final testCache = File(_dillCachePath);
+
+ try {
+ if (_frontendServerClient == null) {
+ if (await testCache.exists()) {
+ await testCache.copy(_outputDill.path);
+ }
+ compilerOutput = await _createCompiler(tempFile.uri);
+ } else {
+ compilerOutput =
+ await _frontendServerClient!.compile(<Uri>[tempFile.uri]);
+ }
+ } catch (e, s) {
+ if (_closeMemo.hasRun) return CompilationResponse._wasShutdown;
+ return CompilationResponse(errorCount: 1, compilerOutput: '$e\n$s');
+ } finally {
+ _frontendServerClient?.accept();
+ _frontendServerClient?.reset();
+ }
+
+ // The client is guaranteed initialized at this point.
+ final outputPath = compilerOutput?.dillOutput;
+ if (outputPath == null) {
+ return CompilationResponse(
+ compilerOutput: compilerOutput?.compilerOutputLines.join('\n'),
+ errorCount: compilerOutput?.errorCount ?? 0);
+ }
+
+ final outputFile = File(outputPath);
+ final kernelReadyToRun =
+ await outputFile.copy('${tempFile.path}_$_compileNumber.dill');
+ // Keep the `_dillToCache` file up-to-date and use the size of the
+ // kernel file as an approximation for how many packages are included.
+ // Larger files are preferred, since re-using more packages will reduce the
+ // number of files the frontend server needs to load and parse.
+ if (_dillToCache == null ||
+ (_dillToCache!.lengthSync() < kernelReadyToRun.lengthSync())) {
+ _dillToCache = kernelReadyToRun;
+ }
+
+ return CompilationResponse(
+ compilerOutput: compilerOutput?.compilerOutputLines.join('\n'),
+ errorCount: compilerOutput?.errorCount ?? 0,
+ kernelOutputUri: kernelReadyToRun.absolute.uri);
+ }
+
+ Future<CompileResult?> _createCompiler(Uri testUri) async {
+ final platformDill = 'lib/_internal/vm_platform_strong.dill';
+ final sdkRoot =
+ p.relative(p.dirname(p.dirname(Platform.resolvedExecutable)));
+ final packageConfigUriAwaited = await packageConfigUri;
+
+ // If we have native assets for the host os in JIT mode, they are here.
+ Uri? nativeAssetsYaml;
+ if (enabledExperiments.contains('native-assets')) {
+ nativeAssetsYaml = packageConfigUriAwaited.resolve('native_assets.yaml');
+ if (!await File.fromUri(nativeAssetsYaml).exists()) {
+ nativeAssetsYaml = null;
+ }
+ }
+
+ var client = _frontendServerClient = await FrontendServerClient.start(
+ testUri.toString(),
+ _outputDill.path,
+ platformDill,
+ enabledExperiments: enabledExperiments,
+ sdkRoot: sdkRoot,
+ packagesJson: packageConfigUriAwaited.toFilePath(),
+ nativeAssets: nativeAssetsYaml?.toFilePath(),
+ printIncrementalDependencies: false,
+ );
+ return client.compile();
+ }
+
+ Future<void> dispose() => _closeMemo.runOnce(() async {
+ await _compilePool.close();
+ if (_dillToCache != null) {
+ var testCache = File(_dillCachePath);
+ if (!testCache.parent.existsSync()) {
+ testCache.parent.createSync(recursive: true);
+ }
+ _dillToCache!.copySync(_dillCachePath);
+ }
+ _frontendServerClient?.kill();
+ _frontendServerClient = null;
+ if (_outputDillDirectory.existsSync()) {
+ await _outputDillDirectory.deleteWithRetry();
+ }
+ });
+}
+
+/// Computes a unique dill cache suffix for each [languageVersionComment]
+/// and [enabledExperiments] combination.
+String _dillCacheSuffix(
+ String languageVersionComment, List<String> enabledExperiments) {
+ var identifierString =
+ StringBuffer(languageVersionComment.replaceAll(' ', ''));
+ for (var experiment in enabledExperiments) {
+ identifierString.writeln(experiment);
+ }
+ return base64.encode(utf8.encode(identifierString.toString()));
+}
+
+/// Creates bootstrap file contents for running [testUri].
+///
+/// The [bootstrapType] argument should be either 'Vm' or 'Native' depending on
+/// which `internalBootstrap*Test` function should be used.
+String testBootstrapContents({
+ required Uri testUri,
+ required String languageVersionComment,
+ required Uri packageConfigUri,
+ required VmTestType testType,
+}) {
+ final (mainArgs, forwardedArgName, bootstrapType) = switch (testType) {
+ VmTestType.isolate => ('_, SendPort sendPort', 'sendPort', 'Vm'),
+ VmTestType.process => ('List<String> args', 'args', 'Native'),
+ };
+ return '''
+ $languageVersionComment
+
+ import 'dart:isolate';
+
+ import 'package:test_core/src/bootstrap/vm.dart';
+
+ import '$testUri' as test;
+
+ // This variable is read at runtime through the VM service and is unsafe to
+ // remove.
+ const packageConfigLocation = '$packageConfigUri';
+
+ void main($mainArgs) {
+ internalBootstrap${bootstrapType}Test(() => test.main, $forwardedArgName);
+ }
+ ''';
+}
+
+enum VmTestType { isolate, process }
diff --git a/pkgs/test_core/lib/src/runner/wasm_compiler_pool.dart b/pkgs/test_core/lib/src/runner/wasm_compiler_pool.dart
new file mode 100644
index 0000000..c4318f5
--- /dev/null
+++ b/pkgs/test_core/lib/src/runner/wasm_compiler_pool.dart
@@ -0,0 +1,96 @@
+// Copyright (c) 2022, 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:convert';
+import 'dart:io';
+
+import 'package:path/path.dart' as p;
+
+import '../util/dart.dart';
+import '../util/io.dart';
+import '../util/package_config.dart';
+import 'compiler_pool.dart';
+import 'suite.dart';
+
+/// A pool of `dart2wasm` compiler instances.
+///
+/// This limits the number of compiler instances running concurrently.
+class WasmCompilerPool extends CompilerPool {
+ /// Extra arguments to pass to `dart compile js`.
+ final List<String> _extraArgs;
+
+ /// The currently-active dart2wasm processes.
+ final _processes = <Process>{};
+
+ WasmCompilerPool([this._extraArgs = const []]);
+
+ /// Compiles [code] to [path].
+ ///
+ /// This wraps the Dart code in the standard browser-testing wrapper.
+ ///
+ /// The returned [Future] will complete once the `dart2wasm` process completes
+ /// *and* all its output has been printed to the command line.
+ @override
+ Future compileInternal(
+ String code, String path, SuiteConfiguration suiteConfig) {
+ return withTempDir((dir) async {
+ final wrapperPath = p.join(dir, 'main.dart');
+ File(wrapperPath).writeAsStringSync(code);
+ final outWasmPath = '$path.wasm';
+ final process = await Process.start(Platform.resolvedExecutable, [
+ 'compile',
+ 'wasm',
+ '--enable-asserts',
+ '--packages=${(await packageConfigUri).toFilePath()}',
+ for (var experiment in enabledExperiments)
+ '--enable-experiment=$experiment',
+ '-O0',
+ ..._extraArgs,
+ '-o',
+ outWasmPath,
+ wrapperPath,
+ ]);
+ if (closed) {
+ process.kill();
+ return;
+ }
+
+ _processes.add(process);
+
+ /// Wait until the process is entirely done to print out any output.
+ /// This can produce a little extra time for users to wait with no
+ /// update, but it also avoids some really nasty-looking interleaved
+ /// output. Write both stdout and stderr to the same buffer in case
+ /// they're intended to be printed in order.
+ var buffer = StringBuffer();
+
+ await Future.wait([
+ process.stdout.transform(utf8.decoder).forEach(buffer.write),
+ process.stderr.transform(utf8.decoder).forEach(buffer.write),
+ ]);
+
+ var exitCode = await process.exitCode;
+ _processes.remove(process);
+ if (closed) return;
+
+ var output = buffer.toString();
+ if (output.isNotEmpty) print(output);
+
+ if (exitCode != 0) throw StateError('dart2wasm failed.');
+ });
+ }
+
+ /// Closes the compiler pool.
+ ///
+ /// This kills all currently-running compilers and ensures that no more will
+ /// be started. It returns a [Future] that completes once all the compilers
+ /// have been killed and all resources released.
+ @override
+ Future<void> closeInternal() async {
+ await Future.wait(_processes.map((process) async {
+ process.kill();
+ await process.exitCode;
+ }));
+ }
+}
diff --git a/pkgs/test_core/lib/src/scaffolding.dart b/pkgs/test_core/lib/src/scaffolding.dart
new file mode 100644
index 0000000..31b3d89
--- /dev/null
+++ b/pkgs/test_core/lib/src/scaffolding.dart
@@ -0,0 +1,295 @@
+// Copyright (c) 2021, 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:meta/meta.dart' show doNotSubmit, isTest, isTestGroup;
+import 'package:path/path.dart' as p;
+import 'package:test_api/backend.dart';
+import 'package:test_api/scaffolding.dart' show Timeout, pumpEventQueue;
+import 'package:test_api/src/backend/declarer.dart'; // ignore: implementation_imports
+import 'package:test_api/src/backend/invoker.dart'; // ignore: implementation_imports
+
+import 'runner/engine.dart';
+import 'runner/plugin/environment.dart';
+import 'runner/reporter/expanded.dart';
+import 'runner/runner_suite.dart';
+import 'runner/suite.dart';
+import 'util/os.dart';
+import 'util/print_sink.dart';
+
+// Hide implementations which don't support being run directly.
+// This file is an almost direct copy of import below, but with the global
+// declarer added.
+export 'package:test_api/scaffolding.dart'
+ hide group, setUp, setUpAll, tearDown, tearDownAll, test;
+
+/// The global declarer.
+///
+/// This is used if a test file is run directly, rather than through the runner.
+Declarer? _globalDeclarer;
+
+/// Gets the declarer for the current scope.
+///
+/// When using the runner, this returns the [Zone]-scoped declarer that's set by
+/// [RemoteListener]. If the test file is run directly, this returns
+/// [_globalDeclarer] (and sets it up on the first call).
+Declarer get _declarer {
+ var declarer = Declarer.current;
+ if (declarer != null) return declarer;
+ if (_globalDeclarer != null) return _globalDeclarer!;
+
+ // Since there's no Zone-scoped declarer, the test file is being run directly.
+ // In order to run the tests, we set up our own Declarer via
+ // [_globalDeclarer], and pump the event queue as a best effort to wait for
+ // all tests to be defined before starting them.
+ _globalDeclarer = Declarer(isStandalone: true);
+
+ () async {
+ await pumpEventQueue();
+
+ var suite = RunnerSuite(
+ const PluginEnvironment(),
+ SuiteConfiguration.empty,
+ _globalDeclarer!.build(),
+ SuitePlatform(Runtime.vm, compiler: null, os: currentOSGuess),
+ path: p.prettyUri(Uri.base));
+
+ var engine = Engine();
+ engine.suiteSink.add(suite);
+ engine.suiteSink.close();
+ ExpandedReporter.watch(engine, PrintSink(),
+ color: true, printPath: false, printPlatform: false);
+
+ var success = await runZoned(() => Invoker.guard(engine.run),
+ zoneValues: {#test.declarer: _globalDeclarer});
+ if (success == true) return null;
+ print('');
+ unawaited(Future.error('Dummy exception to set exit code.'));
+ }();
+
+ return _globalDeclarer!;
+}
+
+// TODO(nweiz): This and other top-level functions should throw exceptions if
+// they're called after the declarer has finished declaring.
+/// Creates a new test case with the given description (converted to a string)
+/// and body.
+///
+/// The description will be added to the descriptions of any surrounding
+/// [group]s. If [testOn] is passed, it's parsed as a [platform selector][]; the
+/// test will only be run on matching platforms.
+///
+/// [platform selector]: https://github.com/dart-lang/test/tree/master/pkgs/test#platform-selectors
+///
+/// If [timeout] is passed, it's used to modify or replace the default timeout
+/// of 30 seconds. Timeout modifications take precedence in suite-group-test
+/// order, so [timeout] will also modify any timeouts set on the group or suite.
+///
+/// If [skip] is a String or `true`, the test is skipped. If it's a String, it
+/// should explain why the test is skipped; this reason will be printed instead
+/// of running the test. If a call to [test] is nested within a [group], a
+/// non-null `skip` parameter for the `test` will take precedence over the skip
+/// parameter in the `group`. For instance, if a `group` is set to `skip: true`,
+/// but a `test` within it is configured as `skip: false`, the `test` will not
+/// be skipped. A suite level `@Skip()` annotation cannot be overridden with
+/// `skip` arguments to `test` or `group`.
+///
+/// If [tags] is passed, it declares user-defined tags that are applied to the
+/// test. These tags can be used to select or skip the test on the command line,
+/// or to do bulk test configuration. All tags should be declared in the
+/// [package configuration file][configuring tags]. The parameter can be an
+/// [Iterable] of tag names, or a [String] representing a single tag.
+///
+/// If [retry] is passed, the test will be retried the provided number of times
+/// before being marked as a failure.
+///
+/// [configuring tags]: https://github.com/dart-lang/test/blob/master/pkgs/test/doc/configuration.md#configuring-tags
+///
+/// [onPlatform] allows tests to be configured on a platform-by-platform
+/// basis. It's a map from strings that are parsed as [PlatformSelector]s to
+/// annotation classes: [Timeout], [Skip], or lists of those. These
+/// annotations apply only on the given platforms. For example:
+///
+/// test('potentially slow test', () {
+/// // ...
+/// }, onPlatform: {
+/// // This test is especially slow on Windows.
+/// 'windows': Timeout.factor(2),
+/// 'browser': [
+/// Skip('TODO: add browser support'),
+/// // This will be slow on browsers once it works on them.
+/// Timeout.factor(2)
+/// ]
+/// });
+///
+/// If multiple platforms match, the annotations apply in order as through
+/// they were in nested groups.
+///
+/// If the `solo` flag is `true`, only tests and groups marked as
+/// "solo" will be be run. This only restricts tests *within this test
+/// suite*—tests in other suites will run as normal. We recommend that users
+/// avoid this flag if possible and instead use the test runner flag `-n` to
+/// filter tests by name.
+@isTest
+void test(Object? description, dynamic Function() body,
+ {String? testOn,
+ Timeout? timeout,
+ Object? skip,
+ Object? tags,
+ Map<String, dynamic>? onPlatform,
+ int? retry,
+ // TODO(https://github.com/dart-lang/test/issues/2205): Remove deprecated.
+ @Deprecated('Debug only') @doNotSubmit bool solo = false}) {
+ _declarer.test(description.toString(), body,
+ testOn: testOn,
+ timeout: timeout,
+ skip: skip,
+ onPlatform: onPlatform,
+ tags: tags,
+ retry: retry,
+ solo: solo);
+
+ // Force dart2js not to inline this function. We need it to be separate from
+ // `main()` in JS stack traces in order to properly determine the line and
+ // column where the test was defined. See sdk#26705.
+ return;
+ return; // ignore: dead_code
+}
+
+/// Creates a group of tests.
+///
+/// A group's description (converted to a string) is included in the descriptions
+/// of any tests or sub-groups it contains. [setUp] and [tearDown] are also scoped
+/// to the containing group.
+///
+/// If [testOn] is passed, it's parsed as a [platform selector][]; the test will
+/// only be run on matching platforms.
+///
+/// [platform selector]: https://github.com/dart-lang/test/tree/master/pkgs/test#platform-selectors
+///
+/// If [timeout] is passed, it's used to modify or replace the default timeout
+/// of 30 seconds. Timeout modifications take precedence in suite-group-test
+/// order, so [timeout] will also modify any timeouts set on the suite, and will
+/// be modified by any timeouts set on individual tests.
+///
+/// If [skip] is a String or `true`, the group is skipped. If it's a String, it
+/// should explain why the group is skipped; this reason will be printed instead
+/// of running the group's tests.
+///
+/// If [tags] is passed, it declares user-defined tags that are applied to the
+/// test. These tags can be used to select or skip the test on the command line,
+/// or to do bulk test configuration. All tags should be declared in the
+/// [package configuration file][configuring tags]. The parameter can be an
+/// [Iterable] of tag names, or a [String] representing a single tag.
+///
+/// [configuring tags]: https://github.com/dart-lang/test/blob/master/pkgs/test/doc/configuration.md#configuring-tags
+///
+/// [onPlatform] allows groups to be configured on a platform-by-platform
+/// basis. It's a map from strings that are parsed as [PlatformSelector]s to
+/// annotation classes: [Timeout], [Skip], or lists of those. These
+/// annotations apply only on the given platforms. For example:
+///
+/// group('potentially slow tests', () {
+/// // ...
+/// }, onPlatform: {
+/// // These tests are especially slow on Windows.
+/// 'windows': Timeout.factor(2),
+/// 'browser': [
+/// Skip('TODO: add browser support'),
+/// // They'll be slow on browsers once it works on them.
+/// Timeout.factor(2)
+/// ]
+/// });
+///
+/// If multiple platforms match, the annotations apply in order as through
+/// they were in nested groups.
+///
+/// If the `solo` flag is `true`, only tests and groups marked as
+/// "solo" will be be run. This only restricts tests *within this test
+/// suite*—tests in other suites will run as normal. We recommend that users
+/// avoid this flag if possible, and instead use the test runner flag `-n` to
+/// filter tests by name.
+@isTestGroup
+void group(Object? description, dynamic Function() body,
+ {String? testOn,
+ Timeout? timeout,
+ Object? skip,
+ Object? tags,
+ Map<String, dynamic>? onPlatform,
+ int? retry,
+ // TODO(https://github.com/dart-lang/test/issues/2205): Remove deprecated.
+ @Deprecated('Debug only') @doNotSubmit bool solo = false}) {
+ _declarer.group(description.toString(), body,
+ testOn: testOn,
+ timeout: timeout,
+ skip: skip,
+ tags: tags,
+ onPlatform: onPlatform,
+ retry: retry,
+ solo: solo);
+
+ // Force dart2js not to inline this function. We need it to be separate from
+ // `main()` in JS stack traces in order to properly determine the line and
+ // column where the test was defined. See sdk#26705.
+ return;
+ return; // ignore: dead_code
+}
+
+/// Registers a function to be run before tests.
+///
+/// This function will be called before each test is run. [callback] may be
+/// asynchronous; if so, it must return a [Future].
+///
+/// If this is called within a test group, it applies only to tests in that
+/// group. [callback] will be run after any set-up callbacks in parent groups or
+/// at the top level.
+///
+/// Each callback at the top level or in a given group will be run in the order
+/// they were declared.
+void setUp(dynamic Function() callback) => _declarer.setUp(callback);
+
+/// Registers a function to be run after tests.
+///
+/// This function will be called after each test is run. [callback] may be
+/// asynchronous; if so, it must return a [Future].
+///
+/// If this is called within a test group, it applies only to tests in that
+/// group. [callback] will be run before any tear-down callbacks in parent
+/// groups or at the top level.
+///
+/// Each callback at the top level or in a given group will be run in the
+/// reverse of the order they were declared.
+///
+/// See also [addTearDown], which adds tear-downs to a running test.
+void tearDown(dynamic Function() callback) => _declarer.tearDown(callback);
+
+/// Registers a function to be run once before all tests.
+///
+/// [callback] may be asynchronous; if so, it must return a [Future].
+///
+/// If this is called within a test group, [callback] will run before all tests
+/// in that group. It will be run after any [setUpAll] callbacks in parent
+/// groups or at the top level. It won't be run if none of the tests in the
+/// group are run.
+///
+/// **Note**: This function makes it very easy to accidentally introduce hidden
+/// dependencies between tests that should be isolated. In general, you should
+/// prefer [setUp], and only use [setUpAll] if the callback is prohibitively
+/// slow.
+void setUpAll(dynamic Function() callback) => _declarer.setUpAll(callback);
+
+/// Registers a function to be run once after all tests.
+///
+/// If this is called within a test group, [callback] will run after all tests
+/// in that group. It will be run before any [tearDownAll] callbacks in parent
+/// groups or at the top level. It won't be run if none of the tests in the
+/// group are run.
+///
+/// **Note**: This function makes it very easy to accidentally introduce hidden
+/// dependencies between tests that should be isolated. In general, you should
+/// prefer [tearDown], and only use [tearDownAll] if the callback is
+/// prohibitively slow.
+void tearDownAll(dynamic Function() callback) =>
+ _declarer.tearDownAll(callback);
diff --git a/pkgs/test_core/lib/src/util/async.dart b/pkgs/test_core/lib/src/util/async.dart
new file mode 100644
index 0000000..036d2b1
--- /dev/null
+++ b/pkgs/test_core/lib/src/util/async.dart
@@ -0,0 +1,32 @@
+// Copyright (c) 2021, 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:async/async.dart';
+
+/// Returns a single-subscription stream that emits the results of [operations]
+/// in the order they complete.
+///
+/// If the subscription is canceled, any pending operations are canceled as
+/// well.
+Stream<T> inCompletionOrder<T>(Iterable<CancelableOperation<T>> operations) {
+ var operationSet = operations.toSet();
+ var controller = StreamController<T>(
+ sync: true,
+ onCancel: () =>
+ Future.wait(operationSet.map((operation) => operation.cancel())));
+
+ for (var operation in operationSet) {
+ operation.value
+ .then((value) => controller.add(value))
+ .onError(controller.addError)
+ .whenComplete(() {
+ operationSet.remove(operation);
+ if (operationSet.isEmpty) controller.close();
+ });
+ }
+
+ return controller.stream;
+}
diff --git a/pkgs/test_core/lib/src/util/dart.dart b/pkgs/test_core/lib/src/util/dart.dart
new file mode 100644
index 0000000..5a1546c
--- /dev/null
+++ b/pkgs/test_core/lib/src/util/dart.dart
@@ -0,0 +1,91 @@
+// Copyright (c) 2015, 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:convert';
+import 'dart:io';
+import 'dart:isolate';
+
+import 'package:analyzer/dart/ast/ast.dart';
+import 'package:source_span/source_span.dart';
+
+import '../util/package_config.dart';
+import 'string_literal_iterator.dart';
+
+/// Runs [code] in an isolate.
+///
+/// [code] should be the contents of a Dart entrypoint. It may contain imports;
+/// they will be resolved in the same context as the host isolate. [message] is
+/// passed to the [main] method of the code being run; the caller is responsible
+/// for using this to establish communication with the isolate.
+Future<Isolate> runInIsolate(String code, Object message,
+ {SendPort? onExit}) async =>
+ Isolate.spawnUri(
+ Uri.dataFromString(code, mimeType: 'application/dart', encoding: utf8),
+ [],
+ message,
+ packageConfig: await packageConfigUri,
+ checked: true,
+ onExit: onExit);
+
+/// Takes a span whose source is the value of a string that has been parsed from
+/// a Dart file and returns the corresponding span from within that Dart file.
+///
+/// For example, suppose a Dart file contains `@Eval("1 + a")`. The
+/// [StringLiteral] `"1 + a"` is extracted; this is [context]. Its contents are
+/// then parsed, producing an error pointing to [span]:
+///
+/// line 1, column 5:
+/// 1 + a
+/// ^
+///
+/// This span isn't very useful, since it only shows the location within the
+/// [StringLiteral]'s value. So it's passed to [contextualizeSpan] along with
+/// [context] and [file] (which contains the source of the entire Dart file),
+/// which then returns:
+///
+/// line 4, column 12 of file.dart:
+/// @Eval("1 + a")
+/// ^
+///
+/// This properly handles multiline literals, adjacent literals, and literals
+/// containing escape sequences. It does not support interpolated literals.
+///
+/// This will return `null` if [context] contains an invalid string or does not
+/// contain [span].
+SourceSpan? contextualizeSpan(
+ SourceSpan span, StringLiteral context, SourceFile file) {
+ var contextRunes = StringLiteralIterator(context)..moveNext();
+
+ for (var i = 0; i < span.start.offset; i++) {
+ if (!contextRunes.moveNext()) return null;
+ }
+
+ var start = contextRunes.offset;
+ for (var spanRune in span.text.runes) {
+ if (spanRune != contextRunes.current) return null;
+ contextRunes.moveNext();
+ }
+
+ return file.span(start, contextRunes.offset);
+}
+
+/// Parses and returns the currently enabled experiments from
+/// [Platform.executableArguments].
+final List<String> enabledExperiments = () {
+ var experiments = <String>[];
+ var itr = Platform.executableArguments.iterator;
+ while (itr.moveNext()) {
+ var arg = itr.current;
+ if (arg == '--enable-experiment') {
+ if (!itr.moveNext()) break;
+ experiments.add(itr.current);
+ } else if (arg.startsWith('--enable-experiment=')) {
+ var parts = arg.split('=');
+ if (parts.length == 2) {
+ experiments.addAll(parts[1].split(','));
+ }
+ }
+ }
+ return experiments;
+}();
diff --git a/pkgs/test_core/lib/src/util/detaching_future.dart b/pkgs/test_core/lib/src/util/detaching_future.dart
new file mode 100644
index 0000000..594f313
--- /dev/null
+++ b/pkgs/test_core/lib/src/util/detaching_future.dart
@@ -0,0 +1,32 @@
+// Copyright (c) 2020, 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.
+
+/// A handle on a [Future] that detaches from the original evaluation context
+/// after it has resolved.
+///
+/// A [Future] holds the Zone it was created in and may hold references to
+/// `async` functions that `await` it. When a future is stored in a static
+/// variable it won't be garbage collected which means all zone variables and
+/// variables in async functions get leaked. [DetachingFuture] works around this
+/// by forgetting the original [Future] after it has resolved, and wrapping the
+/// resolved value with `Future.value` for later calls.
+///
+/// https://github.com/dart-lang/sdk/issues/42457
+/// https://github.com/dart-lang/sdk/issues/42458
+///
+/// In the case of a future that resolves to an error the original future is
+/// retained.
+class DetachingFuture<T> {
+ late T _value;
+ Future<T>? _inProgress;
+
+ DetachingFuture(Future<T> inProgress) : _inProgress = inProgress {
+ inProgress.then((result) {
+ _value = result;
+ _inProgress = null;
+ });
+ }
+
+ Future<T> get asFuture => _inProgress ?? Future.value(_value);
+}
diff --git a/pkgs/test_core/lib/src/util/errors.dart b/pkgs/test_core/lib/src/util/errors.dart
new file mode 100644
index 0000000..7ebea6e
--- /dev/null
+++ b/pkgs/test_core/lib/src/util/errors.dart
@@ -0,0 +1,14 @@
+// Copyright (c) 2021, 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.
+
+/// A regular expression to match the exception prefix that some exceptions'
+/// [Object.toString] values contain.
+final _exceptionPrefix = RegExp(r'^([A-Z][a-zA-Z]*)?(Exception|Error): ');
+
+/// Get a string description of an exception.
+///
+/// Many exceptions include the exception class name at the beginning of their
+/// [toString], so we remove that if it exists.
+String getErrorMessage(Object error) =>
+ error.toString().replaceFirst(_exceptionPrefix, '');
diff --git a/pkgs/test_core/lib/src/util/exit_codes.dart b/pkgs/test_core/lib/src/util/exit_codes.dart
new file mode 100644
index 0000000..7c8b2db
--- /dev/null
+++ b/pkgs/test_core/lib/src/util/exit_codes.dart
@@ -0,0 +1,59 @@
+// Copyright (c) 2015, 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.
+
+/// Exit code constants.
+///
+/// From [the BSD sysexits manpage][manpage]. Not every constant here is used.
+///
+/// [manpage]: http://www.freebsd.org/cgi/man.cgi?query=sysexits
+/// The command completely successfully.
+const success = 0;
+
+/// The command was used incorrectly.
+const usage = 64;
+
+/// The input data was incorrect.
+const data = 65;
+
+/// An input file did not exist or was unreadable.
+const noInput = 66;
+
+/// The user specified did not exist.
+const noUser = 67;
+
+/// The host specified did not exist.
+const noHost = 68;
+
+/// A service is unavailable.
+const unavailable = 69;
+
+/// An internal software error has been detected.
+const software = 70;
+
+/// An operating system error has been detected.
+const os = 71;
+
+/// Some system file did not exist or was unreadable.
+const osFile = 72;
+
+/// A user-specified output file cannot be created.
+const cantCreate = 73;
+
+/// An error occurred while doing I/O on some file.
+const io = 74;
+
+/// Temporary failure, indicating something that is not really an error.
+const tempFail = 75;
+
+/// The remote system returned something invalid during a protocol exchange.
+const protocol = 76;
+
+/// The user did not have sufficient permissions.
+const noPerm = 77;
+
+/// Something was unconfigured or mis-configured.
+const config = 78;
+
+/// No tests were ran.
+const noTestsRan = 79;
diff --git a/pkgs/test_core/lib/src/util/io.dart b/pkgs/test_core/lib/src/util/io.dart
new file mode 100644
index 0000000..a082dd3
--- /dev/null
+++ b/pkgs/test_core/lib/src/util/io.dart
@@ -0,0 +1,267 @@
+// Copyright (c) 2015, 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 'dart:convert';
+import 'dart:core' as core;
+import 'dart:core';
+import 'dart:io';
+import 'dart:math';
+
+import 'package:async/async.dart';
+import 'package:path/path.dart' as p;
+import 'package:test_api/src/backend/compiler.dart'; // ignore: implementation_imports
+import 'package:test_api/src/backend/operating_system.dart'; // ignore: implementation_imports
+import 'package:test_api/src/backend/runtime.dart'; // ignore: implementation_imports
+import 'package:test_api/src/backend/suite_platform.dart'; // ignore: implementation_imports
+
+import 'pretty_print.dart';
+
+/// The default line length for output when there isn't a terminal attached to
+/// stdout.
+const _defaultLineLength = 200;
+
+/// Whether the test runner is running on Google-internal infrastructure.
+final bool inGoogle = Platform.version.contains('(google3)');
+
+/// The maximum line length for output.
+final int lineLength = () {
+ try {
+ return stdout.terminalColumns;
+ } on UnsupportedError {
+ // This can throw an [UnsupportedError] if we're running in a JS context
+ // where `dart:io` is unavailable.
+ return _defaultLineLength;
+ } on StdoutException {
+ return _defaultLineLength;
+ }
+}();
+
+/// The root directory of the Dart SDK.
+final String sdkDir = p.dirname(p.dirname(Platform.resolvedExecutable));
+
+/// The current operating system.
+final currentOS = OperatingSystem.findByIoName(Platform.operatingSystem);
+
+/// Returns a [SuitePlatform] with the given [runtime], and with
+/// [SuitePlatform.os] and [inGoogle] determined automatically.
+///
+/// If [runtime] is a browser, this will set [SuitePlatform.os] to
+/// [OperatingSystem.none].
+// TODO: https://github.com/dart-lang/test/issues/2119 - require compiler
+SuitePlatform currentPlatform(Runtime runtime, [Compiler? compiler]) =>
+ SuitePlatform(runtime,
+ compiler: compiler,
+ os: runtime.isBrowser ? OperatingSystem.none : currentOS,
+ inGoogle: inGoogle);
+
+/// A transformer that decodes bytes using UTF-8 and splits them on newlines.
+final lineSplitter = StreamTransformer<List<int>, String>(
+ (stream, cancelOnError) => utf8.decoder
+ .bind(stream)
+ .transform(const LineSplitter())
+ .listen(null, cancelOnError: cancelOnError));
+
+/// A queue of lines of standard input.
+///
+/// Also returns an empty stream for Fuchsia since Fuchsia components can't
+/// access stdin.
+StreamQueue<String> get stdinLines =>
+ _stdinLines ??= StreamQueue(Platform.isFuchsia
+ ? const Stream<String>.empty()
+ : lineSplitter.bind(stdin));
+
+StreamQueue<String>? _stdinLines;
+
+/// Call cancel on [stdinLines], but only if it's been accessed previously.
+void cancelStdinLines() => _stdinLines?.cancel(immediate: true);
+
+/// Whether this is being run as a subprocess in the test package's own tests.
+bool inTestTests = Platform.environment['_DART_TEST_TESTING'] == 'true';
+
+/// The root directory below which to nest temporary directories created by the
+/// test runner.
+///
+/// This is configurable so that the test code can validate that the runner
+/// cleans up after itself fully.
+final _tempDir = Platform.environment.containsKey('_UNITTEST_TEMP_DIR')
+ ? Platform.environment['_UNITTEST_TEMP_DIR']!
+ : Directory.systemTemp.path;
+
+/// Whether or not the current terminal supports ansi escape codes.
+///
+/// Otherwise only printable ASCII characters should be used.
+bool get canUseSpecialChars =>
+ (!Platform.isWindows || stdout.supportsAnsiEscapes) && !inTestTests;
+
+/// Detect whether we're running in a Github Actions context.
+///
+/// See
+/// https://docs.github.com/en/actions/learn-github-actions/environment-variables.
+bool get inGithubContext => Platform.environment['GITHUB_ACTIONS'] == 'true';
+
+/// Creates a temporary directory and returns its path.
+String createTempDir() =>
+ Directory(_tempDir).createTempSync('dart_test_').resolveSymbolicLinksSync();
+
+/// Creates a temporary directory and passes its path to [fn].
+///
+/// Once the [Future] returned by [fn] completes, the temporary directory and
+/// all its contents are deleted. [fn] can also return `null`, in which case
+/// the temporary directory is deleted immediately afterwards.
+///
+/// Returns a future that completes to the value that the future returned from
+/// [fn] completes to.
+Future withTempDir(Future Function(String) fn) {
+ return Future.sync(() {
+ var tempDir = createTempDir();
+ return Future.sync(() => fn(tempDir))
+ .whenComplete(() => Directory(tempDir).deleteWithRetry());
+ });
+}
+
+/// Wraps [text] so that it fits within [lineLength].
+///
+/// This preserves existing newlines and doesn't consider terminal color escapes
+/// part of a word's length. It only splits words on spaces, not on other sorts
+/// of whitespace.
+String wordWrap(String text) {
+ return text.split('\n').map((originalLine) {
+ var buffer = StringBuffer();
+ var lengthSoFar = 0;
+ for (var word in originalLine.split(' ')) {
+ var wordLength = withoutColors(word).length;
+ if (wordLength > lineLength) {
+ if (lengthSoFar != 0) buffer.writeln();
+ buffer.writeln(word);
+ } else if (lengthSoFar == 0) {
+ buffer.write(word);
+ lengthSoFar = wordLength;
+ } else if (lengthSoFar + 1 + wordLength > lineLength) {
+ buffer.writeln();
+ buffer.write(word);
+ lengthSoFar = wordLength;
+ } else {
+ buffer.write(' $word');
+ lengthSoFar += 1 + wordLength;
+ }
+ }
+ return buffer.toString();
+ }).join('\n');
+}
+
+/// Print a warning containing [message].
+///
+/// This automatically wraps lines if they get too long. If [color] is passed,
+/// it controls whether the warning header is color; otherwise, it defaults to
+/// [canUseSpecialChars].
+///
+/// If [print] is `true`, this prints the message using [print] to associate it
+/// with the current test. Otherwise, it prints it using [stderr].
+void warn(String message, {bool? color, bool print = false}) {
+ color ??= canUseSpecialChars;
+ var header = color ? '\u001b[33mWarning:\u001b[0m' : 'Warning:';
+ (print ? core.print : stderr.writeln)(wordWrap('$header $message\n'));
+}
+
+/// Repeatedly finds a probably-unused port on localhost and passes it to
+/// [tryPort] until it binds successfully.
+///
+/// [tryPort] should return a non-`null` value or a Future completing to a
+/// non-`null` value once it binds successfully. This value will be returned
+/// by [getUnusedPort] in turn.
+///
+/// This is necessary for ensuring that our port binding isn't flaky for
+/// applications that don't print out the bound port.
+Future<T> getUnusedPort<T extends Object>(
+ FutureOr<T> Function(int port) tryPort) async {
+ T? value;
+ await Future.doWhile(() async {
+ value = await tryPort(await getUnsafeUnusedPort());
+ return value == null;
+ });
+ return value!;
+}
+
+/// Whether this computer supports binding to IPv6 addresses.
+var _maySupportIPv6 = true;
+
+/// Returns a port that is probably, but not definitely, not in use.
+///
+/// This has a built-in race condition: another process may bind this port at
+/// any time after this call has returned. If at all possible, callers should
+/// use [getUnusedPort] instead.
+Future<int> getUnsafeUnusedPort() async {
+ late int port;
+ if (_maySupportIPv6) {
+ try {
+ final socket = await ServerSocket.bind(InternetAddress.loopbackIPv6, 0,
+ v6Only: true);
+ port = socket.port;
+ await socket.close();
+ } on SocketException {
+ _maySupportIPv6 = false;
+ }
+ }
+ if (!_maySupportIPv6) {
+ final socket = await RawServerSocket.bind(InternetAddress.loopbackIPv4, 0);
+ port = socket.port;
+ await socket.close();
+ }
+ return port;
+}
+
+/// Returns the full URL of the Chrome remote debugger for the main page.
+///
+/// This takes the [base] remote debugger URL (which points to a browser-wide
+/// page) and uses its JSON API to find the resolved URL for debugging the host
+/// page.
+Future<Uri> getRemoteDebuggerUrl(Uri base) async {
+ try {
+ var client = HttpClient();
+ var request = await client.getUrl(base.resolve('/json/list'));
+ var response = await request.close();
+ var jsonObject =
+ await json.fuse(utf8).decoder.bind(response).single as List;
+ return base
+ .resolve((jsonObject.first as Map)['devtoolsFrontendUrl'] as String);
+ } catch (_) {
+ // If we fail to talk to the remote debugger protocol, give up and return
+ // the raw URL rather than crashing.
+ return base;
+ }
+}
+
+extension RetryDelete on FileSystemEntity {
+ Future<void> deleteWithRetry() async {
+ var attempt = 0;
+ while (true) {
+ try {
+ await delete(recursive: true);
+ return;
+ } on FileSystemException {
+ if (attempt == 2) rethrow;
+ attempt++;
+ await Future<void>.delayed(
+ Duration(milliseconds: pow(10, attempt).toInt()));
+ }
+ }
+ }
+}
+
+extension WindowsFilePaths on String {
+ /// Strip out the leading slash before the drive letter on windows.
+ ///
+ /// In some windows environments full paths get passed with `/` before the
+ /// drive letter. Normalize paths to exclude this slash when it exists.
+ String get stripDriveLetterLeadingSlash {
+ if (Platform.isWindows &&
+ startsWith('/') &&
+ length >= 3 &&
+ this[2] == ':') {
+ return substring(1);
+ }
+ return this;
+ }
+}
diff --git a/pkgs/test_core/lib/src/util/io_stub.dart b/pkgs/test_core/lib/src/util/io_stub.dart
new file mode 100644
index 0000000..7953877
--- /dev/null
+++ b/pkgs/test_core/lib/src/util/io_stub.dart
@@ -0,0 +1,11 @@
+// Copyright (c) 2018, 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 'package:test_api/src/backend/compiler.dart'; // ignore: implementation_imports
+import 'package:test_api/src/backend/runtime.dart'; // ignore: implementation_imports
+import 'package:test_api/src/backend/suite_platform.dart'; // ignore: implementation_imports
+
+SuitePlatform currentPlatform(Runtime runtime, Compiler? compiler) =>
+ throw UnsupportedError(
+ 'Getting the current platform is only supported where dart:io exists');
diff --git a/pkgs/test_core/lib/src/util/os.dart b/pkgs/test_core/lib/src/util/os.dart
new file mode 100644
index 0000000..3db1608
--- /dev/null
+++ b/pkgs/test_core/lib/src/util/os.dart
@@ -0,0 +1,30 @@
+// Copyright (c) 2021, 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 'package:path/path.dart' as p;
+import 'package:test_api/src/backend/operating_system.dart'; // ignore: implementation_imports
+
+/// Directories that are specific to OS X.
+///
+/// This is used to try to distinguish OS X and Linux in [currentOSGuess].
+final _macOSDirectories = {
+ '/Applications',
+ '/Library',
+ '/Network',
+ '/System',
+ '/Users',
+};
+
+/// Returns the best guess for the current operating system without using
+/// `dart:io`.
+///
+/// This is useful for running test files directly and skipping tests as
+/// appropriate. The only OS-specific information we have is the current path,
+/// which we try to use to figure out the OS.
+final OperatingSystem currentOSGuess = (() {
+ if (p.style == p.Style.url) return OperatingSystem.none;
+ if (p.style == p.Style.windows) return OperatingSystem.windows;
+ if (_macOSDirectories.any(p.current.startsWith)) return OperatingSystem.macOS;
+ return OperatingSystem.linux;
+})();
diff --git a/pkgs/test_core/lib/src/util/package_config.dart b/pkgs/test_core/lib/src/util/package_config.dart
new file mode 100644
index 0000000..c33dda6
--- /dev/null
+++ b/pkgs/test_core/lib/src/util/package_config.dart
@@ -0,0 +1,39 @@
+// Copyright (c) 2020, 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:io';
+import 'dart:isolate';
+
+import 'package:package_config/package_config.dart';
+import 'package:path/path.dart' as p;
+
+/// The [PackageConfig] parsed from the current isolates package config file.
+final Future<PackageConfig> currentPackageConfig = () async {
+ return loadPackageConfigUri(await packageConfigUri);
+}();
+
+final Future<Uri> packageConfigUri = () async {
+ var uri = await Isolate.packageConfig;
+ if (uri == null) {
+ throw StateError('Unable to find a package config');
+ }
+ return uri;
+}();
+
+final _originalWorkingDirectory = Directory.current.uri;
+
+/// Returns an `package:` URI for [path] if it is in a package, otherwise
+/// returns an absolute file URI.
+Future<Uri> absoluteUri(String path) async {
+ final uri = p.toUri(path);
+ final absoluteUri =
+ uri.isAbsolute ? uri : _originalWorkingDirectory.resolveUri(uri);
+ try {
+ final packageConfig = await currentPackageConfig;
+ return packageConfig.toPackageUri(absoluteUri) ?? absoluteUri;
+ } on StateError {
+ // Workaround for a missing package config.
+ return absoluteUri;
+ }
+}
diff --git a/pkgs/test_core/lib/src/util/pretty_print.dart b/pkgs/test_core/lib/src/util/pretty_print.dart
new file mode 100644
index 0000000..f425629
--- /dev/null
+++ b/pkgs/test_core/lib/src/util/pretty_print.dart
@@ -0,0 +1,71 @@
+// Copyright (c) 2021, 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.
+
+/// A regular expression matching terminal color codes.
+final _colorCode = RegExp('\u001b\\[[0-9;]+m');
+
+/// Returns [str] without any color codes.
+String withoutColors(String str) => str.replaceAll(_colorCode, '');
+
+/// A regular expression matching a single vowel.
+final _vowel = RegExp('[aeiou]');
+
+/// Returns [noun] with an indefinite article ("a" or "an") added, based on
+/// whether its first letter is a vowel.
+String a(String noun) => noun.startsWith(_vowel) ? 'an $noun' : 'a $noun';
+
+/// Indent each line in [string] by 2 spaces.
+String indent(String text) {
+ var lines = text.split('\n');
+ if (lines.length == 1) return ' $text';
+
+ var buffer = StringBuffer();
+
+ for (var line in lines.take(lines.length - 1)) {
+ buffer.writeln(' $line');
+ }
+ buffer.write(' ${lines.last}');
+ return buffer.toString();
+}
+
+/// Truncates [text] to fit within [maxLength].
+///
+/// This will try to truncate along word boundaries and preserve words both at
+/// the beginning and the end of [text].
+String truncate(String text, int maxLength) {
+ // Return the full message if it fits.
+ if (text.length <= maxLength) return text;
+
+ // If we can fit the first and last three words, do so.
+ var words = text.split(' ');
+ if (words.length > 1) {
+ var i = words.length;
+ var length = words.first.length + 4;
+ do {
+ i--;
+ length += 1 + words[i].length;
+ } while (length <= maxLength && i > 0);
+ if (length > maxLength || i == 0) i++;
+ if (i < words.length - 4) {
+ // Require at least 3 words at the end.
+ var buffer = StringBuffer();
+ buffer.write(words.first);
+ buffer.write(' ...');
+ for (; i < words.length; i++) {
+ buffer.write(' ');
+ buffer.write(words[i]);
+ }
+ return buffer.toString();
+ }
+ }
+
+ // Otherwise truncate to return the trailing text, but attempt to start at
+ // the beginning of a word.
+ var result = text.substring(text.length - maxLength + 4);
+ var firstSpace = result.indexOf(' ');
+ if (firstSpace > 0) {
+ result = result.substring(firstSpace);
+ }
+ return '...$result';
+}
diff --git a/pkgs/test_core/lib/src/util/print_sink.dart b/pkgs/test_core/lib/src/util/print_sink.dart
new file mode 100644
index 0000000..ebb2fe8
--- /dev/null
+++ b/pkgs/test_core/lib/src/util/print_sink.dart
@@ -0,0 +1,39 @@
+// Copyright (c) 2019, 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.
+
+class PrintSink implements StringSink {
+ final _buffer = StringBuffer();
+
+ @override
+ void write(Object? obj) {
+ _buffer.write(obj);
+ _flush();
+ }
+
+ @override
+ void writeAll(Iterable objects, [String separator = '']) {
+ _buffer.writeAll(objects, separator);
+ _flush();
+ }
+
+ @override
+ void writeCharCode(int charCode) {
+ _buffer.writeCharCode(charCode);
+ _flush();
+ }
+
+ @override
+ void writeln([Object? obj = '']) {
+ _buffer.writeln(obj ?? '');
+ _flush();
+ }
+
+ /// [print] if the content available ends with a newline.
+ void _flush() {
+ if ('$_buffer'.endsWith('\n')) {
+ print(_buffer);
+ _buffer.clear();
+ }
+ }
+}
diff --git a/pkgs/test_core/lib/src/util/stack_trace_mapper.dart b/pkgs/test_core/lib/src/util/stack_trace_mapper.dart
new file mode 100644
index 0000000..9d4248d
--- /dev/null
+++ b/pkgs/test_core/lib/src/util/stack_trace_mapper.dart
@@ -0,0 +1,81 @@
+// Copyright (c) 2015, 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 'package:source_map_stack_trace/source_map_stack_trace.dart' as mapper;
+import 'package:source_maps/source_maps.dart';
+import 'package:test_api/backend.dart' show StackTraceMapper;
+
+/// A class for mapping JS stack traces to Dart stack traces using source maps.
+class JSStackTraceMapper implements StackTraceMapper {
+ /// The parsed source map.
+ ///
+ /// This is initialized lazily in `mapStackTrace()`.
+ Mapping? _mapping;
+
+ /// The same package resolution information as was passed to dart2js.
+ final Map<String, Uri>? _packageMap;
+
+ /// The URL of the SDK root from which dart2js loaded its sources.
+ final Uri? _sdkRoot;
+
+ /// The contents of the source map.
+ final String _mapContents;
+
+ /// The URL of the source map.
+ final Uri? _mapUrl;
+
+ JSStackTraceMapper(this._mapContents,
+ {Uri? mapUrl, Map<String, Uri>? packageMap, Uri? sdkRoot})
+ : _mapUrl = mapUrl,
+ _packageMap = packageMap,
+ _sdkRoot = sdkRoot;
+
+ /// Converts [trace] into a Dart stack trace.
+ @override
+ StackTrace mapStackTrace(StackTrace trace) {
+ var mapping = _mapping ??= parseExtended(_mapContents, mapUrl: _mapUrl);
+ return mapper.mapStackTrace(mapping, trace,
+ packageMap: _packageMap, sdkRoot: _sdkRoot);
+ }
+
+ /// Returns a Map representation which is suitable for JSON serialization.
+ @override
+ Map<String, dynamic> serialize() {
+ return {
+ 'mapContents': _mapContents,
+ 'sdkRoot': _sdkRoot?.toString(),
+ 'packageConfigMap': _serializePackageConfigMap(_packageMap),
+ 'mapUrl': _mapUrl?.toString(),
+ };
+ }
+
+ /// Returns a [StackTraceMapper] contained in the provided serialized
+ /// representation.
+ static StackTraceMapper? deserialize(Map? serialized) {
+ if (serialized == null) return null;
+ var deserialized = _deserializePackageConfigMap(
+ (serialized['packageConfigMap'] as Map).cast<String, String>());
+
+ return JSStackTraceMapper(serialized['mapContents'] as String,
+ sdkRoot: Uri.parse(serialized['sdkRoot'] as String),
+ packageMap: deserialized,
+ mapUrl: Uri.parse(serialized['mapUrl'] as String));
+ }
+
+ /// Converts a [packageConfigMap] into a format suitable for JSON
+ /// serialization.
+ static Map<String, String>? _serializePackageConfigMap(
+ Map<String, Uri>? packageConfigMap) {
+ if (packageConfigMap == null) return null;
+ return packageConfigMap.map((key, value) => MapEntry(key, '$value'));
+ }
+
+ /// Converts a serialized package config map into a format suitable for
+ /// the [PackageResolver]
+ static Map<String, Uri>? _deserializePackageConfigMap(
+ Map<String, String>? serialized) {
+ if (serialized == null) return null;
+ return serialized.map((key, value) => MapEntry(key, Uri.parse(value)));
+ }
+}
diff --git a/pkgs/test_core/lib/src/util/string_literal_iterator.dart b/pkgs/test_core/lib/src/util/string_literal_iterator.dart
new file mode 100644
index 0000000..d58f64a
--- /dev/null
+++ b/pkgs/test_core/lib/src/util/string_literal_iterator.dart
@@ -0,0 +1,245 @@
+// Copyright (c) 2015, 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:collection';
+
+import 'package:analyzer/dart/ast/ast.dart';
+
+// ASCII character codes.
+
+const _zero = 0x30;
+const _nine = 0x39;
+const _backslash = 0x5C;
+const _openCurly = 0x7B;
+const _closeCurly = 0x7D;
+const _capitalA = 0x41;
+const _capitalZ = 0x5A;
+const _a = 0x61;
+const _n = 0x6E;
+const _r = 0x72;
+const _f = 0x66;
+const _b = 0x62;
+const _t = 0x74;
+const _u = 0x75;
+const _v = 0x76;
+const _x = 0x78;
+const _z = 0x7A;
+const _newline = 0xA;
+const _carriageReturn = 0xD;
+const _formFeed = 0xC;
+const _backspace = 0x8;
+const _tab = 0x9;
+const _verticalTab = 0xB;
+
+/// An iterator over the runes in the value of a [StringLiteral].
+///
+/// In addition to exposing the values of the runes themselves, this also
+/// exposes the offset of the current rune in the Dart source file.
+class StringLiteralIterator implements Iterator<int> {
+ @override
+ int get current => _current!;
+ int? _current;
+
+ /// The offset of the beginning of [current] in the Dart source file that
+ /// contains the string literal.
+ ///
+ /// Before iteration begins, this points to the character before the first
+ /// rune.
+ int get offset => _offset;
+ late int _offset;
+
+ /// The offset of the next rune.
+ ///
+ /// This isn't necessarily just `offset + 1`, since a single rune may be
+ /// represented by multiple characters in the source file, or a string literal
+ /// may be composed of several adjacent string literals.
+ int? _nextOffset;
+
+ /// All [SimpleStringLiteral]s that compose the input literal.
+ ///
+ /// If the input literal is itself a [SimpleStringLiteral], this just contains
+ /// that literal; otherwise, the literal is an [AdjacentStrings], and this
+ /// contains its component literals.
+ final _strings = Queue<SimpleStringLiteral>();
+
+ /// Whether this is a raw string that begins with `r`.
+ ///
+ /// This is necessary for knowing how to parse escape sequences.
+ bool? _isRaw;
+
+ /// The iterator over the runes in the Dart source file.
+ ///
+ /// When switching to a new string in [_strings], this is updated to point to
+ /// that string's component runes.
+ Iterator<int>? _runes;
+
+ /// The result of the last call to `_runes.moveNext`.
+ bool _runesHasCurrent = false;
+
+ /// Creates a new [StringLiteralIterator] iterating over the contents of
+ /// [literal].
+ ///
+ /// Throws an [ArgumentError] if [literal] contains interpolated strings.
+ StringLiteralIterator(StringLiteral literal) {
+ if (literal is StringInterpolation) {
+ throw ArgumentError("Can't iterate over an interpolated string.");
+ } else if (literal is SimpleStringLiteral) {
+ _strings.add(literal);
+ } else {
+ assert(literal is AdjacentStrings);
+
+ for (var string in (literal as AdjacentStrings).strings) {
+ if (string is StringInterpolation) {
+ throw ArgumentError("Can't iterate over an interpolated string.");
+ }
+ _strings.add(string as SimpleStringLiteral);
+ }
+ }
+
+ _offset = _strings.first.contentsOffset - 1;
+ }
+
+ @override
+ bool moveNext() {
+ // If we're at beginning of a [SimpleStringLiteral], move forward until
+ // there's actually text to consume.
+ while (_runes == null || !_runesHasCurrent) {
+ if (_strings.isEmpty) {
+ // Move the offset past the end of the text.
+ _offset = _nextOffset!;
+ _current = null;
+ return false;
+ }
+
+ var string = _strings.removeFirst();
+ var start = string.contentsOffset - string.offset;
+
+ // Compensate for the opening and closing quotes.
+ var end = start +
+ string.literal.lexeme.length -
+ 2 * (string.isMultiline ? 3 : 1) -
+ (string.isRaw ? 1 : 0);
+ var text = string.literal.lexeme.substring(start, end);
+
+ _nextOffset = string.contentsOffset;
+ _isRaw = string.isRaw;
+ _runes = text.runes.iterator;
+ _runesHasCurrent = _runes!.moveNext();
+ }
+
+ _offset = _nextOffset!;
+ _current = _nextRune();
+ if (_current != null) return true;
+
+ // If we encounter a parse failure, stop moving forward immediately.
+ _strings.clear();
+ return false;
+ }
+
+ /// Consume and return the next rune.
+ int? _nextRune() {
+ if (_isRaw! || _runes!.current != _backslash) {
+ var rune = _runes!.current;
+ _moveRunesNext();
+ return (rune < 0) ? null : rune;
+ }
+
+ if (!_moveRunesNext()) return null;
+ return _parseEscapeSequence();
+ }
+
+ /// Parse an escape sequence in the underlying Dart text.
+ ///
+ /// This assumes that a backslash has already been consumed. It leaves the
+ /// [_runes] cursor on the first character after the escape sequence.
+ int? _parseEscapeSequence() {
+ switch (_runes!.current) {
+ case _n:
+ _moveRunesNext();
+ return _newline;
+ case _r:
+ _moveRunesNext();
+ return _carriageReturn;
+ case _f:
+ _moveRunesNext();
+ return _formFeed;
+ case _b:
+ _moveRunesNext();
+ return _backspace;
+ case _t:
+ _moveRunesNext();
+ return _tab;
+ case _v:
+ _moveRunesNext();
+ return _verticalTab;
+ case _x:
+ if (!_moveRunesNext()) return null;
+ return _parseHex(2);
+ case _u:
+ if (!_moveRunesNext()) return null;
+ if (_runes!.current != _openCurly) return _parseHex(4);
+ if (!_moveRunesNext()) return null;
+
+ var number = _parseHexSequence();
+ if (_runes!.current != _closeCurly) return null;
+ if (!_moveRunesNext()) return null;
+ return number;
+ default:
+ var rune = _runes!.current;
+ _moveRunesNext();
+ return rune;
+ }
+ }
+
+ /// Parse a variable-length sequence of hexadecimal digits and returns their
+ /// value as an [int].
+ ///
+ /// This parses digits as they appear in a unicode escape sequence: one to six
+ /// hex digits.
+ int? _parseHexSequence() {
+ var number = _parseHexDigit(_runes!.current);
+ if (number == null) return null;
+ if (!_moveRunesNext()) return null;
+
+ for (var i = 0; i < 5; i++) {
+ var digit = _parseHexDigit(_runes!.current);
+ if (digit == null) break;
+ number = number! * 16 + digit;
+ if (!_moveRunesNext()) return null;
+ }
+
+ return number;
+ }
+
+ /// Parses [digits] hexadecimal digits and returns their value as an [int].
+ int? _parseHex(int digits) {
+ var number = 0;
+ for (var i = 0; i < digits; i++) {
+ if (_runes!.current == -1) return null;
+ var digit = _parseHexDigit(_runes!.current);
+ if (digit == null) return null;
+ number = number * 16 + digit;
+ _moveRunesNext();
+ }
+ return number;
+ }
+
+ /// Parses a single hexadecimal digit.
+ int? _parseHexDigit(int rune) {
+ if (rune < _zero) return null;
+ if (rune <= _nine) return rune - _zero;
+ if (rune < _capitalA) return null;
+ if (rune <= _capitalZ) return 10 + rune - _capitalA;
+ if (rune < _a) return null;
+ if (rune <= _z) return 10 + rune - _a;
+ return null;
+ }
+
+ /// Move [_runes] to the next rune and update [_nextOffset].
+ bool _moveRunesNext() {
+ var result = _runesHasCurrent = _runes!.moveNext();
+ _nextOffset = _nextOffset! + 1;
+ return result;
+ }
+}
diff --git a/pkgs/test_core/lib/test_core.dart b/pkgs/test_core/lib/test_core.dart
new file mode 100644
index 0000000..b1df09d
--- /dev/null
+++ b/pkgs/test_core/lib/test_core.dart
@@ -0,0 +1,11 @@
+// Copyright (c) 2013, 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.
+
+@Deprecated('package:test_core is not intended for general use. '
+ 'Please use package:test.')
+library;
+
+export 'package:test_api/hooks.dart' show TestFailure;
+
+export 'scaffolding.dart';
diff --git a/pkgs/test_core/mono_pkg.yaml b/pkgs/test_core/mono_pkg.yaml
new file mode 100644
index 0000000..9ef7927
--- /dev/null
+++ b/pkgs/test_core/mono_pkg.yaml
@@ -0,0 +1,17 @@
+# See https://pub.dev/packages/mono_repo
+
+sdk:
+- dev
+
+stages:
+- analyze_and_format:
+ - group:
+ - format
+ - analyze: --fatal-infos
+ - group:
+ - analyze
+ sdk: pubspec
+- unit_test:
+ - group:
+ - command: dart test
+ sdk: [dev, pubspec]
diff --git a/pkgs/test_core/pubspec.yaml b/pkgs/test_core/pubspec.yaml
new file mode 100644
index 0000000..d08e24c
--- /dev/null
+++ b/pkgs/test_core/pubspec.yaml
@@ -0,0 +1,35 @@
+name: test_core
+version: 0.6.8
+description: A basic library for writing tests and running them on the VM.
+repository: https://github.com/dart-lang/test/tree/master/pkgs/test_core
+resolution: workspace
+
+environment:
+ sdk: ^3.5.0
+
+dependencies:
+ analyzer: '>=6.0.0 <8.0.0'
+ args: ^2.0.0
+ async: ^2.5.0
+ boolean_selector: ^2.1.0
+ collection: ^1.15.0
+ coverage: ^1.0.0
+ frontend_server_client: '>=3.2.0 <5.0.0'
+ glob: ^2.0.0
+ io: ^1.0.0
+ meta: ^1.3.0
+ package_config: ^2.0.0
+ path: ^1.8.0
+ pool: ^1.5.0
+ source_map_stack_trace: ^2.1.0
+ source_maps: ^0.10.10
+ source_span: ^1.8.0
+ stack_trace: ^1.10.0
+ stream_channel: ^2.1.0
+ # Use an exact version until the test_api package is stable.
+ test_api: 0.7.4
+ vm_service: ">=6.0.0 <16.0.0"
+ yaml: ^3.0.0
+
+dev_dependencies:
+ test: any
diff --git a/pkgs/test_core/test/runner/vm/test_compiler_test.dart b/pkgs/test_core/test/runner/vm/test_compiler_test.dart
new file mode 100644
index 0000000..a6e50ef
--- /dev/null
+++ b/pkgs/test_core/test/runner/vm/test_compiler_test.dart
@@ -0,0 +1,25 @@
+// Copyright (c) 2024, 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:convert';
+
+import 'package:test/test.dart';
+import 'package:test_core/src/runner/vm/test_compiler.dart';
+
+void main() {
+ group('VM test templates', () {
+ test('include package config URI variable', () async {
+ // This variable is read through the VM service and should not be removed.
+ final template = testBootstrapContents(
+ testUri: Uri.file('foo.dart'),
+ languageVersionComment: '// version comment',
+ packageConfigUri: Uri.file('package_config.json'),
+ testType: VmTestType.isolate,
+ );
+ final lines = LineSplitter.split(template).map((line) => line.trim());
+ expect(lines,
+ contains("const packageConfigLocation = 'package_config.json';"));
+ });
+ });
+}
diff --git a/pubspec.yaml b/pubspec.yaml
new file mode 100644
index 0000000..2e08374
--- /dev/null
+++ b/pubspec.yaml
@@ -0,0 +1,14 @@
+name: test_workspace
+publish_to: none
+environment:
+ sdk: ^3.5.0
+workspace:
+ - integration_tests/regression
+ - integration_tests/spawn_hybrid
+ - integration_tests/wasm
+ - pkgs/checks
+ - pkgs/test
+ - pkgs/test_api
+ - pkgs/test_core
+dev_dependencies:
+ dart_flutter_team_lints: ^3.1.0
diff --git a/tool/ci.sh b/tool/ci.sh
new file mode 100755
index 0000000..040c70d
--- /dev/null
+++ b/tool/ci.sh
@@ -0,0 +1,167 @@
+#!/bin/bash
+# Created with package:mono_repo v6.6.2
+
+# Support built in commands on windows out of the box.
+
+# When it is a flutter repo (check the pubspec.yaml for "sdk: flutter")
+# then "flutter pub" is called instead of "dart pub".
+# This assumes that the Flutter SDK has been installed in a previous step.
+function pub() {
+ if grep -Fq "sdk: flutter" "${PWD}/pubspec.yaml"; then
+ command flutter pub "$@"
+ else
+ command dart pub "$@"
+ fi
+}
+
+function format() {
+ command dart format "$@"
+}
+
+# When it is a flutter repo (check the pubspec.yaml for "sdk: flutter")
+# then "flutter analyze" is called instead of "dart analyze".
+# This assumes that the Flutter SDK has been installed in a previous step.
+function analyze() {
+ if grep -Fq "sdk: flutter" "${PWD}/pubspec.yaml"; then
+ command flutter analyze "$@"
+ else
+ command dart analyze "$@"
+ fi
+}
+
+if [[ -z ${PKGS} ]]; then
+ echo -e '\033[31mPKGS environment variable must be set! - TERMINATING JOB\033[0m'
+ exit 64
+fi
+
+if [[ "$#" == "0" ]]; then
+ echo -e '\033[31mAt least one task argument must be provided! - TERMINATING JOB\033[0m'
+ exit 64
+fi
+
+SUCCESS_COUNT=0
+declare -a FAILURES
+
+for PKG in ${PKGS}; do
+ echo -e "\033[1mPKG: ${PKG}\033[22m"
+ EXIT_CODE=0
+ pushd "${PKG}" >/dev/null || EXIT_CODE=$?
+
+ if [[ ${EXIT_CODE} -ne 0 ]]; then
+ echo -e "\033[31mPKG: '${PKG}' does not exist - TERMINATING JOB\033[0m"
+ exit 64
+ fi
+
+ dart pub upgrade || EXIT_CODE=$?
+
+ if [[ ${EXIT_CODE} -ne 0 ]]; then
+ echo -e "\033[31mPKG: ${PKG}; 'dart pub upgrade' - FAILED (${EXIT_CODE})\033[0m"
+ FAILURES+=("${PKG}; 'dart pub upgrade'")
+ else
+ for TASK in "$@"; do
+ EXIT_CODE=0
+ echo
+ echo -e "\033[1mPKG: ${PKG}; TASK: ${TASK}\033[22m"
+ case ${TASK} in
+ analyze_0)
+ echo 'dart analyze --fatal-infos'
+ dart analyze --fatal-infos || EXIT_CODE=$?
+ ;;
+ analyze_1)
+ echo 'dart analyze'
+ dart analyze || EXIT_CODE=$?
+ ;;
+ command_00)
+ echo 'dart test'
+ dart test || EXIT_CODE=$?
+ ;;
+ command_01)
+ echo 'xvfb-run -s "-screen 0 1024x768x24" dart test --preset travis --total-shards 5 --shard-index 0'
+ xvfb-run -s "-screen 0 1024x768x24" dart test --preset travis --total-shards 5 --shard-index 0 || EXIT_CODE=$?
+ ;;
+ command_02)
+ echo 'xvfb-run -s "-screen 0 1024x768x24" dart test --preset travis --total-shards 5 --shard-index 1'
+ xvfb-run -s "-screen 0 1024x768x24" dart test --preset travis --total-shards 5 --shard-index 1 || EXIT_CODE=$?
+ ;;
+ command_03)
+ echo 'xvfb-run -s "-screen 0 1024x768x24" dart test --preset travis --total-shards 5 --shard-index 2'
+ xvfb-run -s "-screen 0 1024x768x24" dart test --preset travis --total-shards 5 --shard-index 2 || EXIT_CODE=$?
+ ;;
+ command_04)
+ echo 'xvfb-run -s "-screen 0 1024x768x24" dart test --preset travis --total-shards 5 --shard-index 3'
+ xvfb-run -s "-screen 0 1024x768x24" dart test --preset travis --total-shards 5 --shard-index 3 || EXIT_CODE=$?
+ ;;
+ command_05)
+ echo 'xvfb-run -s "-screen 0 1024x768x24" dart test --preset travis --total-shards 5 --shard-index 4'
+ xvfb-run -s "-screen 0 1024x768x24" dart test --preset travis --total-shards 5 --shard-index 4 || EXIT_CODE=$?
+ ;;
+ command_06)
+ echo 'dart test --preset travis --total-shards 5 --shard-index 0'
+ dart test --preset travis --total-shards 5 --shard-index 0 || EXIT_CODE=$?
+ ;;
+ command_07)
+ echo 'dart test --preset travis --total-shards 5 --shard-index 1'
+ dart test --preset travis --total-shards 5 --shard-index 1 || EXIT_CODE=$?
+ ;;
+ command_08)
+ echo 'dart test --preset travis --total-shards 5 --shard-index 2'
+ dart test --preset travis --total-shards 5 --shard-index 2 || EXIT_CODE=$?
+ ;;
+ command_09)
+ echo 'dart test --preset travis --total-shards 5 --shard-index 3'
+ dart test --preset travis --total-shards 5 --shard-index 3 || EXIT_CODE=$?
+ ;;
+ command_10)
+ echo 'dart test --preset travis --total-shards 5 --shard-index 4'
+ dart test --preset travis --total-shards 5 --shard-index 4 || EXIT_CODE=$?
+ ;;
+ command_11)
+ echo 'dart test --preset travis -x browser'
+ dart test --preset travis -x browser || EXIT_CODE=$?
+ ;;
+ format)
+ echo 'dart format --output=none --set-exit-if-changed .'
+ dart format --output=none --set-exit-if-changed . || EXIT_CODE=$?
+ ;;
+ test_1)
+ echo 'dart test -p chrome,vm,node'
+ dart test -p chrome,vm,node || EXIT_CODE=$?
+ ;;
+ test_2)
+ echo 'dart test --timeout=60s'
+ dart test --timeout=60s || EXIT_CODE=$?
+ ;;
+ *)
+ echo -e "\033[31mUnknown TASK '${TASK}' - TERMINATING JOB\033[0m"
+ exit 64
+ ;;
+ esac
+
+ if [[ ${EXIT_CODE} -ne 0 ]]; then
+ echo -e "\033[31mPKG: ${PKG}; TASK: ${TASK} - FAILED (${EXIT_CODE})\033[0m"
+ FAILURES+=("${PKG}; TASK: ${TASK}")
+ else
+ echo -e "\033[32mPKG: ${PKG}; TASK: ${TASK} - SUCCEEDED\033[0m"
+ SUCCESS_COUNT=$((SUCCESS_COUNT + 1))
+ fi
+
+ done
+ fi
+
+ echo
+ echo -e "\033[32mSUCCESS COUNT: ${SUCCESS_COUNT}\033[0m"
+
+ if [ ${#FAILURES[@]} -ne 0 ]; then
+ echo -e "\033[31mFAILURES: ${#FAILURES[@]}\033[0m"
+ for i in "${FAILURES[@]}"; do
+ echo -e "\033[31m $i\033[0m"
+ done
+ fi
+
+ popd >/dev/null || exit 70
+ echo
+done
+
+if [ ${#FAILURES[@]} -ne 0 ]; then
+ exit 1
+fi
