WebCore/bindings/v8/WorkerContextExecutionProxy.h

   1 /*
   2  * Copyright (C) 2009 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
  32 #ifndef WorkerContextExecutionProxy_h
  33 #define WorkerContextExecutionProxy_h
  34
  35 #if ENABLE(WORKERS)
  36
  37 #include <v8.h>
  38 #include "ScriptValue.h"
  39 #include "V8EventListenerList.h"
  40 #include "V8Index.h"
  41 #include <wtf/OwnPtr.h>
  42 #include <wtf/Vector.h>
  43
  44 namespace WebCore {
  45
  46     class Event;
  47     class EventTarget;
  48     class V8EventListener;
  49     class V8WorkerContextEventListener;
  50     class WorkerContext;
  51
  52     struct WorkerContextExecutionState {
  53         WorkerContextExecutionState() : hadException(false), lineNumber(0) { }
  54
  55         bool hadException;
  56         ScriptValue exception;
  57         String errorMessage;
  58         int lineNumber;
  59         String sourceURL;
  60     };
  61
  62     class WorkerContextExecutionProxy {
  63     public:
  64         WorkerContextExecutionProxy(WorkerContext*);
  65         ~WorkerContextExecutionProxy();
  66
  67         // FIXME: following function should have camelCased names once V8 code-generating script is migrated.
  68         v8::Local<v8::Context> GetContext() { return v8::Local<v8::Context>::New(m_context); }
  69         v8::Local<v8::Function> GetConstructor(V8ClassIndex::V8WrapperType);
  70         void RemoveEventListener(V8EventListener*);
  71
  72         static v8::Handle<v8::Value> ToV8Object(V8ClassIndex::V8WrapperType type, void* impl);
  73         static v8::Handle<v8::Value> EventToV8Object(Event* event);
  74         static v8::Handle<v8::Value> EventTargetToV8Object(EventTarget* target);
  75         static v8::Handle<v8::Value> WorkerContextToV8Object(WorkerContext* wc);
  76
  77         // Finds/creates event listener wrappers.
  78         PassRefPtr<V8EventListener> findOrCreateEventListener(v8::Local<v8::Value> listener, bool isInline, bool findOnly);
  79         PassRefPtr<V8EventListener> findOrCreateObjectEventListener(v8::Local<v8::Value> object, bool isInline, bool findOnly);
  80
  81         // Track the event so that we can detach it from the JS wrapper when a worker
  82         // terminates. This is needed because we need to be able to dispose these
  83         // events and releases references to their event targets: WorkerContext.
  84         void trackEvent(Event*);
  85
  86         // Evaluate a script file in the current execution environment.
  87         ScriptValue evaluate(const String& script, const String& fileName, int baseLine, WorkerContextExecutionState*);
  88
  89         // Returns WorkerContext object.
  90         WorkerContext* workerContext() { return m_workerContext; }
  91
  92         // Returns WorkerContextExecutionProxy object of the currently executing context. 0 will be returned if the current executing context is not the worker context.
  93         static WorkerContextExecutionProxy* retrieve();
  94
  95     private:
  96         void initV8IfNeeded();
  97         void initContextIfNeeded();
  98         void dispose();
  99         PassRefPtr<V8EventListener> findOrCreateEventListenerHelper(v8::Local<v8::Value> object, bool isInline, bool findOnly, bool createObjectEventListener);
 100
 101         // Run an already compiled script.
 102         v8::Local<v8::Value> runScript(v8::Handle<v8::Script>);
 103
 104         static v8::Local<v8::Object> toV8(V8ClassIndex::V8WrapperType descType, V8ClassIndex::V8WrapperType cptrType, void* impl);
 105
 106         static bool forgetV8EventObject(Event*);
 107
 108         WorkerContext* m_workerContext;
 109         v8::Persistent<v8::Context> m_context;
 110         int m_recursion;
 111
 112         OwnPtr<V8EventListenerList> m_listeners;
 113         Vector<Event*> m_events;
 114     };
 115
 116 } // namespace WebCore
 117
 118 #endif // ENABLE(WORKERS)
 119
 120 #endif // WorkerContextExecutionProxy_h