src/third_party/WebKit/Source/core/inspector/InjectedScriptHost.h

   1 /*
   2  * Copyright (C) 2007 Apple Inc. All rights reserved.
   3  * Copyright (C) 2009 Google Inc. All rights reserved.
   4  *
   5  * Redistribution and use in source and binary forms, with or without
   6  * modification, are permitted provided that the following conditions
   7  * are met:
   8  *
   9  * 1.  Redistributions of source code must retain the above copyright
  10  *     notice, this list of conditions and the following disclaimer.
  11  * 2.  Redistributions in binary form must reproduce the above copyright
  12  *     notice, this list of conditions and the following disclaimer in the
  13  *     documentation and/or other materials provided with the distribution.
  14  * 3.  Neither the name of Apple Computer, Inc. ("Apple") nor the names of
  15  *     its contributors may be used to endorse or promote products derived
  16  *     from this software without specific prior written permission.
  17  *
  18  * THIS SOFTWARE IS PROVIDED BY APPLE AND ITS CONTRIBUTORS "AS IS" AND ANY
  19  * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  20  * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  21  * DISCLAIMED. IN NO EVENT SHALL APPLE OR ITS CONTRIBUTORS BE LIABLE FOR ANY
  22  * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
  23  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
  24  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
  25  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  26  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  27  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  28  */
  29
  30 #ifndef InjectedScriptHost_h
  31 #define InjectedScriptHost_h
  32
  33 #include "bindings/v8/ScriptState.h"
  34 #include "bindings/v8/ScriptWrappable.h"
  35 #include "wtf/RefCounted.h"
  36 #include "wtf/Vector.h"
  37
  38 namespace WebCore {
  39
  40 class Database;
  41 class EventTarget;
  42 class InjectedScript;
  43 class InstrumentingAgents;
  44 class JSONValue;
  45 class Node;
  46 class ScriptDebugServer;
  47 class ScriptValue;
  48 class Storage;
  49
  50 struct EventListenerInfo;
  51
  52 // SECURITY NOTE: Although the InjectedScriptHost is intended for use solely by the inspector,
  53 // a reference to the InjectedScriptHost may be leaked to the page being inspected. Thus, the
  54 // InjectedScriptHost must never implemment methods that have more power over the page than the
  55 // page already has itself (e.g. origin restriction bypasses).
  56
  57 class InjectedScriptHost : public RefCounted<InjectedScriptHost>, public ScriptWrappable {
  58 public:
  59     static PassRefPtr<InjectedScriptHost> create();
  60     ~InjectedScriptHost();
  61
  62     void init(InstrumentingAgents* instrumentingAgents, ScriptDebugServer* scriptDebugServer)
  63     {
  64         m_instrumentingAgents = instrumentingAgents;
  65         m_scriptDebugServer = scriptDebugServer;
  66     }
  67
  68     static Node* scriptValueAsNode(ScriptValue);
  69     static ScriptValue nodeAsScriptValue(ScriptState*, Node*);
  70
  71     void disconnect();
  72
  73     class InspectableObject {
  74         WTF_MAKE_FAST_ALLOCATED;
  75     public:
  76         virtual ScriptValue get(ScriptState*);
  77         virtual ~InspectableObject() { }
  78     };
  79     void addInspectedObject(PassOwnPtr<InspectableObject>);
  80     void clearInspectedObjects();
  81     InspectableObject* inspectedObject(unsigned int num);
  82
  83     void inspectImpl(PassRefPtr<JSONValue> objectToInspect, PassRefPtr<JSONValue> hints);
  84     void getEventListenersImpl(EventTarget*, Vector<EventListenerInfo>& listenersArray);
  85
  86     void clearConsoleMessages();
  87     void debugFunction(const String& scriptId, int lineNumber, int columnNumber);
  88     void undebugFunction(const String& scriptId, int lineNumber, int columnNumber);
  89     void monitorFunction(const String& scriptId, int lineNumber, int columnNumber, const String& functionName);
  90     void unmonitorFunction(const String& scriptId, int lineNumber, int columnNumber);
  91
  92     ScriptDebugServer& scriptDebugServer() { return *m_scriptDebugServer; }
  93
  94 private:
  95     InjectedScriptHost();
  96
  97     InstrumentingAgents* m_instrumentingAgents;
  98     ScriptDebugServer* m_scriptDebugServer;
  99     Vector<OwnPtr<InspectableObject> > m_inspectedObjects;
 100     OwnPtr<InspectableObject> m_defaultInspectableObject;
 101 };
 102
 103 } // namespace WebCore
 104
 105 #endif // !defined(InjectedScriptHost_h)