Support throwing Throwable as-is (PHP 7+)

Author: clue

README.md

@@ -75,17 +75,17 @@ Once the promise is fulfilled, this function will return whatever the promise
 resolved to.
 
 Once the promise is rejected, this will throw whatever the promise rejected
-with. If the promise did not reject with an `Exception`, then this function
-will throw an `UnexpectedValueException` instead.
+with. If the promise did not reject with an `Exception` or `Throwable` (PHP 7+),
+then this function will throw an `UnexpectedValueException` instead.
 
 ```php
 try {
     $result = React\Async\await($promise);
     // promise successfully fulfilled with $result
     echo 'Result: ' . $result;
-} catch (Exception $exception) {
-    // promise rejected with $exception
-    echo 'ERROR: ' . $exception->getMessage();
+} catch (Throwable $e) {
+    // promise rejected with $e
+    echo 'Error: ' . $e->getMessage();
 }
 ```
 

src/functions.php

@@ -28,23 +28,25 @@
  * resolved to.
  *
  * Once the promise is rejected, this will throw whatever the promise rejected
- * with. If the promise did not reject with an `Exception`, then this function
- * will throw an `UnexpectedValueException` instead.
+ * with. If the promise did not reject with an `Exception` or `Throwable` (PHP 7+),
+ * then this function will throw an `UnexpectedValueException` instead.
  *
  * ```php
  * try {
  *     $result = React\Async\await($promise, $loop);
  *     // promise successfully fulfilled with $result
  *     echo 'Result: ' . $result;
- * } catch (Exception $exception) {
- *     // promise rejected with $exception
- *     echo 'ERROR: ' . $exception->getMessage();
+ * } catch (Throwable $e) {
+ *     // promise rejected with $e
+ *     echo 'Error: ' . $e->getMessage();
  * }
  * ```
  *
  * @param PromiseInterface $promise
  * @return mixed returns whatever the promise resolves to
- * @throws \Exception when the promise is rejected
+ * @throws \Exception when the promise is rejected with an `Exception`
+ * @throws \Throwable when the promise is rejected with a `Throwable` (PHP 7+)
+ * @throws \UnexpectedValueException when the promise is rejected with an unexpected value (Promise API v1 or v2 only)
  */
 function await(PromiseInterface $promise)
 {
@@ -76,16 +78,11 @@ function ($error) use (&$exception, &$rejected, &$wait) {
     }
 
     if ($rejected) {
+        // promise is rejected with an unexpected value (Promise API v1 or v2 only)
         if (!$exception instanceof \Exception && !$exception instanceof \Throwable) {
             $exception = new \UnexpectedValueException(
                 'Promise rejected with unexpected value of type ' . (is_object($exception) ? get_class($exception) : gettype($exception))
             );
-        } elseif (!$exception instanceof \Exception) {
-            $exception = new \UnexpectedValueException(
-                'Promise rejected with unexpected ' . get_class($exception) . ': ' . $exception->getMessage(),
-                $exception->getCode(),
-                $exception
-            );
         }
 
         throw $exception;

tests/AwaitTest.php

@@ -44,20 +44,12 @@ public function testAwaitOneRejectedWithNullWillWrapInUnexpectedValueException()
     /**
      * @requires PHP 7
      */
-    public function testAwaitOneRejectedWithPhp7ErrorWillWrapInUnexpectedValueExceptionWithPrevious()
+    public function testAwaitRejectedWithPhp7ErrorWillThrowOriginalError()
     {
         $promise = Promise\reject(new \Error('Test', 42));
 
-        try {
-            React\Async\await($promise);
-            $this->fail();
-        } catch (\UnexpectedValueException $e) {
-            $this->assertEquals('Promise rejected with unexpected Error: Test', $e->getMessage());
-            $this->assertEquals(42, $e->getCode());
-            $this->assertInstanceOf('Throwable', $e->getPrevious());
-            $this->assertEquals('Test', $e->getPrevious()->getMessage());
-            $this->assertEquals(42, $e->getPrevious()->getCode());
-        }
+        $this->setExpectedException('Error', 'Test', 42);
+        React\Async\await($promise);
     }
 
     public function testAwaitOneResolved()