1  /*
 2   * Copyright (C) 2016 Apple Inc. All rights reserved.
 3   *
 4   * Redistribution and use in source and binary forms, with or without
 5   * modification, are permitted provided that the following conditions
 6   * are met:
 7   * 1. Redistributions of source code must retain the above copyright
 8   *    notice, this list of conditions and the following disclaimer.
 9   * 2. Redistributions in binary form must reproduce the above copyright
10   *    notice, this list of conditions and the following disclaimer in the
11   *    documentation and/or other materials provided with the distribution.
12   *
13   * THIS SOFTWARE IS PROVIDED BY APPLE INC. ``AS IS'' AND ANY
14   * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15   * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
16   * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL APPLE INC. OR
17   * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
18   * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
19   * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
20   * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
21   * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
22   * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
23   * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
24   */
25  
26  #ifndef APIUtils_h
27  #define APIUtils_h
28  
29  #include "CatchScope.h"
30  #include "Exception.h"
31  #include "JSCJSValue.h"
32  #include "JSGlobalObjectInspectorController.h"
33  #include "JSValueRef.h"
34  
35  enum class ExceptionStatus {
36      DidThrow,
37      DidNotThrow
38  };
39  
40  inline ExceptionStatus handleExceptionIfNeeded(JSC::CatchScope& scope, JSContextRef ctx, JSValueRef* returnedExceptionRef)
41  {
42      JSC::JSGlobalObject* globalObject = toJS(ctx);
43      if (UNLIKELY(scope.exception())) {
44          JSC::Exception* exception = scope.exception();
45          if (returnedExceptionRef)
46              *returnedExceptionRef = toRef(globalObject, exception->value());
47          scope.clearException();
48  #if ENABLE(REMOTE_INSPECTOR)
49          globalObject->inspectorController().reportAPIException(globalObject, exception);
50  #endif
51          return ExceptionStatus::DidThrow;
52      }
53      return ExceptionStatus::DidNotThrow;
54  }
55  
56  inline void setException(JSContextRef ctx, JSValueRef* returnedExceptionRef, JSC::JSValue exception)
57  {
58      JSC::JSGlobalObject* globalObject = toJS(ctx);
59      if (returnedExceptionRef)
60          *returnedExceptionRef = toRef(globalObject, exception);
61  #if ENABLE(REMOTE_INSPECTOR)
62      JSC::VM& vm = getVM(globalObject);
63      globalObject->inspectorController().reportAPIException(globalObject, JSC::Exception::create(vm, exception));
64  #endif
65  }
66  
67  #endif /* APIUtils_h */