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
40namespace blink {
41
42class Database;
43class EventTarget;
44class InjectedScript;
45class InstrumentingAgents;
46class JSONValue;
47class Node;
48class ScriptDebugServer;
49class ScriptValue;
50class Storage;
51
52struct 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
59class InjectedScriptHost : public RefCountedWillBeGarbageCollectedFinalized<InjectedScriptHost>, public ScriptWrappable {
60    DEFINE_WRAPPERTYPEINFO();
61public:
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
98private:
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