Add mechanism to escape from js runtime

Author: pinepain

src/Exceptions/EscapableException.php

@@ -0,0 +1,42 @@
+<?php declare(strict_types=1);
+
+/*
+ * This file is part of the pinepain/js-sandbox PHP library.
+ *
+ * Copyright (c) 2016-2017 Bogdan Padalko <pinepain@gmail.com>
+ *
+ * Licensed under the MIT license: http://opensource.org/licenses/MIT
+ *
+ * For the full copyright and license information, please view the
+ * LICENSE file that was distributed with this source or visit
+ * http://opensource.org/licenses/MIT
+ */
+
+
+namespace Pinepain\JsSandbox\Exceptions;
+
+
+use Throwable;
+
+
+class EscapableException extends Exception
+{
+    /**
+     * @var Throwable
+     */
+    private $original;
+
+
+    public function __construct(Throwable $original)
+    {
+        $this->original = $original;
+    }
+
+    /**
+     * @return Throwable
+     */
+    public function getOriginal(): Throwable
+    {
+        return $this->original;
+    }
+}

src/Wrappers/CallbackGuards/CallbackGuard.php

@@ -16,6 +16,7 @@
 namespace Pinepain\JsSandbox\Wrappers\CallbackGuards;
 
 
+use Pinepain\JsSandbox\Exceptions\EscapableException;
 use Pinepain\JsSandbox\Exceptions\NativeException;
 use Throwable;
 use V8\CallbackInfoInterface;
@@ -57,6 +58,8 @@ public function guard(callable $callback): callable
                 }
             } catch (NativeException $e) {
                 $isolate->throwException($context, ExceptionManager::createError($context, new StringValue($isolate, $e->getMessage())), $e);
+            } catch (EscapableException $e) {
+                throw $e->getOriginal();
             } catch (Throwable $e) {
                 // UNEXPECTED
                 $message = $this->getMessageFromException($e);