API functions returning Promises should not throw exceptions.

Source/bindings/v8/ScriptPromise.h

 /*
  * Copyright (C) 2013 Google Inc. All rights reserved.
  *
  * 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
@@ skipping 13 matching lines @@
  * 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.
  */
 
 #ifndef ScriptPromise_h
 #define ScriptPromise_h
 
-#include "bindings/v8/ScopedPersistent.h"
-#include "bindings/v8/ScriptFunction.h"
 #include "bindings/v8/ScriptValue.h"
-#include "bindings/v8/V8ScriptRunner.h"
+#include "bindings/v8/V8ThrowException.h"
 #include "wtf/Forward.h"
+#include "wtf/PassOwnPtr.h"
+#include "wtf/text/WTFString.h"
 #include <v8.h>
 
 namespace WebCore {
 
+class ExceptionState;
 class ExecutionContext;
+class ScriptFunction;
 
 // ScriptPromise is the class for representing Promise values in C++ world.
 // ScriptPromise holds a Promise.
 // So holding a ScriptPromise as a member variable in DOM object causes
 // memory leaks since it has a reference from C++ to V8.
 //
 class ScriptPromise {
 public:
     // Constructs an empty promise.
     ScriptPromise() { }
@@ skipping 36 matching lines @@
 
     void clear()
     {
         m_promise.clear();
     }
 
     // Constructs and returns a ScriptPromise from |value|.
     // if |value| is not a Promise object, returns a Promise object
     // resolved with |value|.
     static ScriptPromise cast(const ScriptValue& /*value*/);
+    static ScriptPromise cast(v8::Handle<v8::Value>, v8::Isolate*);
+
+    static ScriptPromise reject(const ScriptValue&);
+    static ScriptPromise reject(v8::Handle<v8::Value>, v8::Isolate*);
+
+    // static functions each of which returns a ScriptPromise rejected with
+    // the given error.
+    // They coresspond to functions in V8Binding.h, such as throwError,
+    // throwTypeError, etc.
+    static ScriptPromise rejectWithError(V8ErrorType, const String&, v8::Isolate*);
+    static ScriptPromise rejectWithError(v8::Handle<v8::Value>, v8::Isolate*);
+    static ScriptPromise rejectWithTypeError(const String&, v8::Isolate*);
+    static ScriptPromise rejectWithArityTypeErrorForMethod(
+        const char* method, const char* type, unsigned expected, unsigned providedLeastNumMandatoryParams, v8::Isolate*);
+    static ScriptPromise rejectWithArityTypeErrorForConstructor(
+        const char* type, unsigned expected, unsigned providedLeastNumMandatoryParams, v8::Isolate*);
+    static ScriptPromise rejectWithArityTypeError(ExceptionState&, unsigned expected, unsigned providedLeastNumMandatoryParams);
 
 private:
     ScriptValue m_promise;
 };
 
 } // namespace WebCore
 
 
 #endif // ScriptPromise_h