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/core/v8/ScriptState.h"
     34 #include "bindings/core/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 blink {
     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 RefCountedWillBeGarbageCollectedFinalized<InjectedScriptHost>, public ScriptWrappable {
     60     DEFINE_WRAPPERTYPEINFO();
     61 public:
     62     static PassRefPtrWillBeRawPtr<InjectedScriptHost> create();
     63     ~InjectedScriptHost();
     64     void trace(Visitor*);
     65 
     66     void init(InstrumentingAgents* instrumentingAgents, ScriptDebugServer* scriptDebugServer)
     67     {
     68         m_instrumentingAgents = instrumentingAgents;
     69         m_scriptDebugServer = scriptDebugServer;
     70     }
     71 
     72     static Node* scriptValueAsNode(ScriptState*, ScriptValue);
     73     static ScriptValue nodeAsScriptValue(ScriptState*, Node*);
     74 
     75     void disconnect();
     76 
     77     class InspectableObject {
     78         WTF_MAKE_FAST_ALLOCATED;
     79     public:
     80         virtual ScriptValue get(ScriptState*);
     81         virtual ~InspectableObject() { }
     82     };
     83     void addInspectedObject(PassOwnPtr<InspectableObject>);
     84     void clearInspectedObjects();
     85     InspectableObject* inspectedObject(unsigned num);
     86 
     87     void inspectImpl(PassRefPtr<JSONValue> objectToInspect, PassRefPtr<JSONValue> hints);
     88     void getEventListenersImpl(EventTarget*, Vector<EventListenerInfo>& listenersArray);
     89 
     90     void clearConsoleMessages();
     91     void debugFunction(const String& scriptId, int lineNumber, int columnNumber);
     92     void undebugFunction(const String& scriptId, int lineNumber, int columnNumber);
     93     void monitorFunction(const String& scriptId, int lineNumber, int columnNumber, const String& functionName);
     94     void unmonitorFunction(const String& scriptId, int lineNumber, int columnNumber);
     95 
     96     ScriptDebugServer& scriptDebugServer() { return *m_scriptDebugServer; }
     97 
     98 private:
     99     InjectedScriptHost();
    100 
    101     RawPtrWillBeMember<InstrumentingAgents> m_instrumentingAgents;
    102     ScriptDebugServer* m_scriptDebugServer;
    103     Vector<OwnPtr<InspectableObject> > m_inspectedObjects;
    104     OwnPtr<InspectableObject> m_defaultInspectableObject;
    105 };
    106 
    107 } // namespace blink
    108 
    109 #endif // InjectedScriptHost_h
    110