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/v8/ScopedPersistent.h" 35 #include "bindings/v8/V8ThrowException.h" 36 #include "wtf/Noncopyable.h" 37 #include "wtf/text/WTFString.h" 38 #include <v8.h> 39 40 namespace WebCore { 41 42 typedef int ExceptionCode; 43 44 class ExceptionState { 45 WTF_MAKE_NONCOPYABLE(ExceptionState); 46 public: 47 enum Context { 48 ConstructionContext, 49 ExecutionContext, 50 DeletionContext, 51 GetterContext, 52 SetterContext, 53 UnknownContext, // FIXME: Remove this once we've flipped over to the new API. 54 }; 55 ExceptionState(const v8::Handle<v8::Object> & creationContext,v8::Isolate * isolate)56 explicit ExceptionState(const v8::Handle<v8::Object>& creationContext, v8::Isolate* isolate) 57 : m_code(0) 58 , m_context(UnknownContext) 59 , m_propertyName(0) 60 , m_interfaceName(0) 61 , m_creationContext(creationContext) 62 , m_isolate(isolate) { } 63 ExceptionState(Context context,const char * propertyName,const char * interfaceName,const v8::Handle<v8::Object> & creationContext,v8::Isolate * isolate)64 ExceptionState(Context context, const char* propertyName, const char* interfaceName, const v8::Handle<v8::Object>& creationContext, v8::Isolate* isolate) 65 : m_code(0) 66 , m_context(context) 67 , m_propertyName(propertyName) 68 , m_interfaceName(interfaceName) 69 , m_creationContext(creationContext) 70 , m_isolate(isolate) { } 71 ExceptionState(Context context,const char * interfaceName,const v8::Handle<v8::Object> & creationContext,v8::Isolate * isolate)72 ExceptionState(Context context, const char* interfaceName, const v8::Handle<v8::Object>& creationContext, v8::Isolate* isolate) 73 : m_code(0) 74 , m_context(context) 75 , m_propertyName(0) 76 , m_interfaceName(interfaceName) 77 , m_creationContext(creationContext) 78 , m_isolate(isolate) { ASSERT(m_context == ConstructionContext); } 79 80 virtual void throwDOMException(const ExceptionCode&, const String& message); 81 virtual void throwTypeError(const String& message); 82 virtual void throwSecurityError(const String& sanitizedMessage, const String& unsanitizedMessage = String()); 83 84 // Please don't use these methods. Use ::throwDOMException and ::throwTypeError, and pass in a useful exception message. throwUninformativeAndGenericDOMException(const ExceptionCode & ec)85 virtual void throwUninformativeAndGenericDOMException(const ExceptionCode& ec) { throwDOMException(ec, String()); } throwUninformativeAndGenericTypeError()86 virtual void throwUninformativeAndGenericTypeError() { throwTypeError(String()); } 87 hadException()88 bool hadException() const { return !m_exception.isEmpty() || m_code; } 89 void clearException(); 90 code()91 ExceptionCode code() const { return m_code; } 92 throwIfNeeded()93 bool throwIfNeeded() 94 { 95 if (m_exception.isEmpty()) { 96 if (!m_code) 97 return false; 98 throwUninformativeAndGenericDOMException(m_code); 99 } 100 101 V8ThrowException::throwError(m_exception.newLocal(m_isolate), m_isolate); 102 return true; 103 } 104 context()105 Context context() const { return m_context; } propertyName()106 const char* propertyName() const { return m_propertyName; } interfaceName()107 const char* interfaceName() const { return m_interfaceName; } 108 109 protected: 110 ExceptionCode m_code; 111 Context m_context; 112 const char* m_propertyName; 113 const char* m_interfaceName; 114 115 private: 116 void setException(v8::Handle<v8::Value>); 117 118 String addExceptionContext(const String&) const; 119 120 ScopedPersistent<v8::Value> m_exception; 121 v8::Handle<v8::Object> m_creationContext; 122 v8::Isolate* m_isolate; 123 }; 124 125 class TrackExceptionState : public ExceptionState { 126 public: TrackExceptionState()127 TrackExceptionState(): ExceptionState(v8::Handle<v8::Object>(), 0) { } 128 virtual void throwDOMException(const ExceptionCode&, const String& message) OVERRIDE FINAL; 129 virtual void throwTypeError(const String& message = String()) OVERRIDE FINAL; 130 virtual void throwSecurityError(const String& sanitizedMessage, const String& unsanitizedMessage = String()) OVERRIDE FINAL; 131 }; 132 133 } // namespace WebCore 134 135 #endif // ExceptionState_h 136