1 /* 2 * Copyright (C) 2013 Google 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 are 6 * met: 7 * 8 * * Redistributions of source code must retain the above copyright 9 * notice, this list of conditions and the following disclaimer. 10 * * Redistributions in binary form must reproduce the above 11 * copyright notice, this list of conditions and the following disclaimer 12 * in the documentation and/or other materials provided with the 13 * distribution. 14 * * Neither the name of Google Inc. nor the names of its 15 * contributors may be used to endorse or promote products derived from 16 * this software without specific prior written permission. 17 * 18 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 19 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 20 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 21 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 22 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 23 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 24 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 25 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 26 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 27 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 28 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 29 */ 30 31 #ifndef ExceptionState_h 32 #define ExceptionState_h 33 34 #include "bindings/core/v8/ScopedPersistent.h" 35 #include "bindings/core/v8/ScriptPromise.h" 36 #include "bindings/core/v8/V8ThrowException.h" 37 #include "wtf/Noncopyable.h" 38 #include "wtf/text/WTFString.h" 39 #include <v8.h> 40 41 namespace blink { 42 43 typedef int ExceptionCode; 44 class ScriptState; 45 46 class ExceptionState { 47 WTF_MAKE_NONCOPYABLE(ExceptionState); 48 public: 49 enum Context { 50 ConstructionContext, 51 ExecutionContext, 52 DeletionContext, 53 GetterContext, 54 SetterContext, 55 EnumerationContext, 56 QueryContext, 57 IndexedGetterContext, 58 IndexedSetterContext, 59 IndexedDeletionContext, 60 UnknownContext, // FIXME: Remove this once we've flipped over to the new API. 61 }; 62 ExceptionState(Context context,const char * propertyName,const char * interfaceName,const v8::Handle<v8::Object> & creationContext,v8::Isolate * isolate)63 ExceptionState(Context context, const char* propertyName, const char* interfaceName, const v8::Handle<v8::Object>& creationContext, v8::Isolate* isolate) 64 : m_code(0) 65 , m_context(context) 66 , m_propertyName(propertyName) 67 , m_interfaceName(interfaceName) 68 , m_creationContext(creationContext) 69 , m_isolate(isolate) { } 70 ExceptionState(Context context,const char * interfaceName,const v8::Handle<v8::Object> & creationContext,v8::Isolate * isolate)71 ExceptionState(Context context, const char* interfaceName, const v8::Handle<v8::Object>& creationContext, v8::Isolate* isolate) 72 : m_code(0) 73 , m_context(context) 74 , m_propertyName(0) 75 , m_interfaceName(interfaceName) 76 , m_creationContext(creationContext) 77 , m_isolate(isolate) { ASSERT(m_context == ConstructionContext || m_context == EnumerationContext || m_context == IndexedSetterContext || m_context == IndexedGetterContext || m_context == IndexedDeletionContext); } 78 79 virtual void throwDOMException(const ExceptionCode&, const String& message); 80 virtual void throwTypeError(const String& message); 81 virtual void throwSecurityError(const String& sanitizedMessage, const String& unsanitizedMessage = String()); 82 virtual void throwRangeError(const String& message); 83 hadException()84 bool hadException() const { return !m_exception.isEmpty() || m_code; } 85 void clearException(); 86 code()87 ExceptionCode code() const { return m_code; } message()88 const String& message() const { return m_message; } 89 throwIfNeeded()90 bool throwIfNeeded() 91 { 92 if (!hadException()) 93 return false; 94 throwException(); 95 return true; 96 } 97 98 // This method clears out the exception which |this| has. 99 ScriptPromise reject(ScriptState*); 100 context()101 Context context() const { return m_context; } propertyName()102 const char* propertyName() const { return m_propertyName; } interfaceName()103 const char* interfaceName() const { return m_interfaceName; } 104 rethrowV8Exception(v8::Handle<v8::Value> value)105 void rethrowV8Exception(v8::Handle<v8::Value> value) 106 { 107 setException(value); 108 } 109 110 protected: 111 ExceptionCode m_code; 112 Context m_context; 113 String m_message; 114 const char* m_propertyName; 115 const char* m_interfaceName; 116 117 private: 118 void setException(v8::Handle<v8::Value>); 119 void throwException(); 120 121 String addExceptionContext(const String&) const; 122 123 ScopedPersistent<v8::Value> m_exception; 124 v8::Handle<v8::Object> m_creationContext; 125 v8::Isolate* m_isolate; 126 }; 127 128 // Used if exceptions can/should not be directly thrown. 129 class NonThrowableExceptionState FINAL : public ExceptionState { 130 public: NonThrowableExceptionState()131 NonThrowableExceptionState(): ExceptionState(ExceptionState::UnknownContext, 0, 0, v8::Handle<v8::Object>(), v8::Isolate::GetCurrent()) { } 132 virtual void throwDOMException(const ExceptionCode&, const String& message) OVERRIDE; 133 virtual void throwTypeError(const String& message = String()) OVERRIDE; 134 virtual void throwSecurityError(const String& sanitizedMessage, const String& unsanitizedMessage = String()) OVERRIDE; 135 virtual void throwRangeError(const String& message) OVERRIDE; 136 }; 137 138 // Used if any exceptions thrown are ignorable. 139 class TrackExceptionState FINAL : public ExceptionState { 140 public: TrackExceptionState()141 TrackExceptionState(): ExceptionState(ExceptionState::UnknownContext, 0, 0, v8::Handle<v8::Object>(), v8::Isolate::GetCurrent()) { } 142 virtual void throwDOMException(const ExceptionCode&, const String& message) OVERRIDE; 143 virtual void throwTypeError(const String& message = String()) OVERRIDE; 144 virtual void throwSecurityError(const String& sanitizedMessage, const String& unsanitizedMessage = String()) OVERRIDE; 145 virtual void throwRangeError(const String& message) OVERRIDE; 146 }; 147 148 } // namespace blink 149 150 #endif // ExceptionState_h 151