Home | History | Annotate | Download | only in inspector 
      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/PassOwnPtr.h"
     36 #include "wtf/RefCounted.h"
     37 #include "wtf/Vector.h"
     38 #include "wtf/text/WTFString.h"
     39 
     40 namespace WebCore {
     41 
     42 class Database;
     43 class EventTarget;
     44 class InjectedScript;
     45 class InstrumentingAgents;
     46 class JSONValue;
     47 class Node;
     48 class ScriptDebugServer;
     49 class ScriptValue;
     50 class Storage;
     51 
     52 struct EventListenerInfo;
     53 
     54 // SECURITY NOTE: Although the InjectedScriptHost is intended for use solely by the inspector,
     55 // a reference to the InjectedScriptHost may be leaked to the page being inspected. Thus, the
     56 // InjectedScriptHost must never implemment methods that have more power over the page than the
     57 // page already has itself (e.g. origin restriction bypasses).
     58 
     59 class InjectedScriptHost : public RefCounted<InjectedScriptHost>, public ScriptWrappable {
     60 public:
     61     static PassRefPtr<InjectedScriptHost> create();
     62     ~InjectedScriptHost();
     63 
     64     void init(InstrumentingAgents* instrumentingAgents, ScriptDebugServer* scriptDebugServer)
     65     {
     66         m_instrumentingAgents = instrumentingAgents;
     67         m_scriptDebugServer = scriptDebugServer;
     68     }
     69 
     70     static Node* scriptValueAsNode(ScriptState*, ScriptValue);
     71     static ScriptValue nodeAsScriptValue(ScriptState*, Node*);
     72 
     73     void disconnect();
     74 
     75     class InspectableObject {
     76         WTF_MAKE_FAST_ALLOCATED;
     77     public:
     78         virtual ScriptValue get(ScriptState*);
     79         virtual ~InspectableObject() { }
     80     };
     81     void addInspectedObject(PassOwnPtr<InspectableObject>);
     82     void clearInspectedObjects();
     83     InspectableObject* inspectedObject(unsigned num);
     84 
     85     void inspectImpl(PassRefPtr<JSONValue> objectToInspect, PassRefPtr<JSONValue> hints);
     86     void getEventListenersImpl(EventTarget*, Vector<EventListenerInfo>& listenersArray);
     87 
     88     void clearConsoleMessages();
     89     void debugFunction(const String& scriptId, int lineNumber, int columnNumber);
     90     void undebugFunction(const String& scriptId, int lineNumber, int columnNumber);
     91     void monitorFunction(const String& scriptId, int lineNumber, int columnNumber, const String& functionName);
     92     void unmonitorFunction(const String& scriptId, int lineNumber, int columnNumber);
     93 
     94     ScriptDebugServer& scriptDebugServer() { return *m_scriptDebugServer; }
     95 
     96 private:
     97     InjectedScriptHost();
     98 
     99     InstrumentingAgents* m_instrumentingAgents;
    100     ScriptDebugServer* m_scriptDebugServer;
    101     Vector<OwnPtr<InspectableObject> > m_inspectedObjects;
    102     OwnPtr<InspectableObject> m_defaultInspectableObject;
    103 };
    104 
    105 } // namespace WebCore
    106 
    107 #endif // !defined(InjectedScriptHost_h)
    108