Added the ability for testrunner to start the HTTP server with a random port and communicate that p…

pkg/unittest/unittest.dart

 // Copyright (c) 2011, the Dart project authors.  Please see the AUTHORS file
 // for 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 library for writing dart unit tests.
  *
  * To import this library, specify the relative path to
  * pkg/unittest/unittest.dart.
  *
@@ skipping 201 matching lines @@
 // imply that the test fails). We can't do it without also changing
 // the testrunner and test.dart though.
 const PASS  = 'pass';
 const FAIL  = 'fail';
 const ERROR = 'error';
 
 /** If set, then all other test cases will be ignored. */
 TestCase _soloTest;
 
 /**
+ * A map that can be used to communicate state between a test driver
+ * or main() function and the tests, particularly when these two
+ * are otherwise independent. For example, a test driver that starts
+ * an HTTP server and then runs tests that access that server could use
+ * this as a way of communicating the server port to the tests.
+ */
+Map testState = {};
+
+/**
  * (Deprecated) Evaluates the [function] and validates that it throws an
  * exception. If [callback] is provided, then it will be invoked with the
  * thrown exception. The callback may do any validation it wants. In addition,
  * if it returns `false`, that also indicates an expectation failure.
  */
 void expectThrow(function, [bool callback(exception)]) {
   bool threw = false;
   try {
     function();
   } catch (e) {
@@ skipping 645 matching lines @@
 }
 
 /** Enable a test by ID. */
 void enableTest(int testId) => _setTestEnabledState(testId, true);
 
 /** Disable a test by ID. */
 void disableTest(int testId) => _setTestEnabledState(testId, false);
 
 /** Signature for a test function. */
 typedef void TestFunction();