1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
|
// Copyright (c) 2012 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
// Developer tools consist of the following parts:
//
// DevToolsAgent lives in the renderer of an inspected page and provides access
// to the pages resources, DOM, v8 etc. by means of IPC messages.
//
// DevToolsClient is a thin delegate that lives in the tools front-end
// renderer and converts IPC messages to frontend method calls and allows the
// frontend to send messages to the DevToolsAgent.
//
// All the messages are routed through browser process. There is a
// DevToolsManager living in the browser process that is responsible for
// routing logistics. It is also capable of sending direct messages to the
// agent rather than forwarding messages between agents and clients only.
//
// Chain of communication between the components may be described by the
// following diagram:
// ----------------------------
// | (tools frontend |
// | renderer process) |
// | | --------------------
// |tools <--> DevToolsClient+<-- IPC -->+ (browser process) |
// |frontend | | |
// ---------------------------- ---------+----------
// ^
// |
// IPC
// |
// v
// --------------------------+--------
// | inspected page <--> DevToolsAgent |
// | |
// | (inspected page renderer process) |
// -----------------------------------
//
// This file describes developer tools message types.
// Multiply-included message file, no standard include guard.
#include <map>
#include <string>
#include "content/common/content_export.h"
#include "content/public/common/console_message_level.h"
#include "ipc/ipc_message_macros.h"
#undef IPC_MESSAGE_EXPORT
#define IPC_MESSAGE_EXPORT CONTENT_EXPORT
#define IPC_MESSAGE_START DevToolsMsgStart
// These are messages sent from DevToolsAgent to DevToolsClient through the
// browser.
// Agent -> Client message chunk.
// |is_first| marks the first chunk, comes with the |message_size| for
// total message size.
// |is_last| marks the last chunk. |call_id|, |session_id| and |post_state|
// are optional parameters passed with the last chunk of the protocol
// response.
IPC_STRUCT_BEGIN(DevToolsMessageChunk)
IPC_STRUCT_MEMBER(bool, is_first)
IPC_STRUCT_MEMBER(bool, is_last)
IPC_STRUCT_MEMBER(int, message_size)
IPC_STRUCT_MEMBER(int, session_id)
IPC_STRUCT_MEMBER(int, call_id)
IPC_STRUCT_MEMBER(std::string, data)
IPC_STRUCT_MEMBER(std::string, post_state)
IPC_STRUCT_END()
// Sends response from the agent to the client. Supports chunked encoding.
IPC_MESSAGE_ROUTED1(DevToolsClientMsg_DispatchOnInspectorFrontend,
DevToolsMessageChunk /* message */)
//-----------------------------------------------------------------------------
// These are messages sent from DevToolsClient to DevToolsAgent through the
// browser.
// Tells agent that there is a client host connected to it.
IPC_MESSAGE_ROUTED2(DevToolsAgentMsg_Attach,
std::string /* host_id */,
int /* session_id */)
// Tells agent that a client host was disconnected from another agent and
// connected to this one.
IPC_MESSAGE_ROUTED3(DevToolsAgentMsg_Reattach,
std::string /* host_id */,
int /* session_id */,
std::string /* agent_state */)
// Tells agent that there is no longer a client host connected to it.
IPC_MESSAGE_ROUTED0(DevToolsAgentMsg_Detach)
// WebKit-level transport.
IPC_MESSAGE_ROUTED2(DevToolsAgentMsg_DispatchOnInspectorBackend,
int /* session_id */,
std::string /* message */)
// Inspect element with the given coordinates.
IPC_MESSAGE_ROUTED2(DevToolsAgentMsg_InspectElement,
int /* x */,
int /* y */)
// ACK for DevToolsAgentHostMsg_RequestNewWindow message.
IPC_MESSAGE_ROUTED1(DevToolsAgentMsg_RequestNewWindow_ACK,
bool /* success */)
//-----------------------------------------------------------------------------
// These are messages sent from renderer's DevToolsAgent to browser.
// Requests new DevTools window being opened for frame in the same process
// with given routing id.
IPC_MESSAGE_ROUTED1(DevToolsAgentHostMsg_RequestNewWindow,
int /* frame_route_id */)
//-----------------------------------------------------------------------------
// These are messages sent from the browser to the renderer.
// RenderViewHostDelegate::RenderViewCreated method sends this message to a
// new renderer to notify it that it will host developer tools UI and should
// set up all neccessary bindings and create DevToolsClient instance that
// will handle communication with inspected page DevToolsAgent.
IPC_MESSAGE_ROUTED1(DevToolsMsg_SetupDevToolsClient,
std::string /* compatibility script */)
//-----------------------------------------------------------------------------
// These are messages sent from the renderer to the browser.
// Transport from Inspector frontend to frontend host.
IPC_MESSAGE_ROUTED1(DevToolsHostMsg_DispatchOnEmbedder,
std::string /* message */)
|
