Blink roll 174933:174969
[chromium-blink-merge.git] / content / common / frame_messages.h
blob2fd20c73e8fe3aa5399080592840662843f2d24d
1 // Copyright 2013 The Chromium Authors. All rights reserved.
2 // Use of this source code is governed by a BSD-style license that can be
3 // found in the LICENSE file.
5 // IPC messages for interacting with frames.
6 // Multiply-included message file, hence no include guard.
8 #include "content/common/content_export.h"
9 #include "content/common/content_param_traits.h"
10 #include "content/common/frame_message_enums.h"
11 #include "content/common/frame_param.h"
12 #include "content/common/navigation_gesture.h"
13 #include "content/public/common/color_suggestion.h"
14 #include "content/public/common/common_param_traits.h"
15 #include "content/public/common/context_menu_params.h"
16 #include "content/public/common/frame_navigate_params.h"
17 #include "content/public/common/javascript_message_type.h"
18 #include "content/public/common/page_state.h"
19 #include "ipc/ipc_message_macros.h"
20 #include "url/gurl.h"
22 #undef IPC_MESSAGE_EXPORT
23 #define IPC_MESSAGE_EXPORT CONTENT_EXPORT
25 #define IPC_MESSAGE_START FrameMsgStart
27 IPC_ENUM_TRAITS_MIN_MAX_VALUE(content::JavaScriptMessageType,
28 content::JAVASCRIPT_MESSAGE_TYPE_ALERT,
29 content::JAVASCRIPT_MESSAGE_TYPE_PROMPT)
30 IPC_ENUM_TRAITS_MAX_VALUE(FrameMsg_Navigate_Type::Value,
31 FrameMsg_Navigate_Type::NAVIGATE_TYPE_LAST)
32 IPC_ENUM_TRAITS_MAX_VALUE(blink::WebContextMenuData::MediaType,
33 blink::WebContextMenuData::MediaTypeLast)
34 IPC_ENUM_TRAITS_MAX_VALUE(ui::MenuSourceType, ui::MENU_SOURCE_TYPE_LAST)
36 IPC_STRUCT_TRAITS_BEGIN(content::ColorSuggestion)
37 IPC_STRUCT_TRAITS_MEMBER(color)
38 IPC_STRUCT_TRAITS_MEMBER(label)
39 IPC_STRUCT_TRAITS_END()
41 IPC_STRUCT_TRAITS_BEGIN(content::ContextMenuParams)
42 IPC_STRUCT_TRAITS_MEMBER(media_type)
43 IPC_STRUCT_TRAITS_MEMBER(x)
44 IPC_STRUCT_TRAITS_MEMBER(y)
45 IPC_STRUCT_TRAITS_MEMBER(link_url)
46 IPC_STRUCT_TRAITS_MEMBER(link_text)
47 IPC_STRUCT_TRAITS_MEMBER(unfiltered_link_url)
48 IPC_STRUCT_TRAITS_MEMBER(src_url)
49 IPC_STRUCT_TRAITS_MEMBER(has_image_contents)
50 IPC_STRUCT_TRAITS_MEMBER(page_url)
51 IPC_STRUCT_TRAITS_MEMBER(keyword_url)
52 IPC_STRUCT_TRAITS_MEMBER(frame_url)
53 IPC_STRUCT_TRAITS_MEMBER(frame_page_state)
54 IPC_STRUCT_TRAITS_MEMBER(media_flags)
55 IPC_STRUCT_TRAITS_MEMBER(selection_text)
56 IPC_STRUCT_TRAITS_MEMBER(misspelled_word)
57 IPC_STRUCT_TRAITS_MEMBER(misspelling_hash)
58 IPC_STRUCT_TRAITS_MEMBER(dictionary_suggestions)
59 IPC_STRUCT_TRAITS_MEMBER(spellcheck_enabled)
60 IPC_STRUCT_TRAITS_MEMBER(is_editable)
61 IPC_STRUCT_TRAITS_MEMBER(writing_direction_default)
62 IPC_STRUCT_TRAITS_MEMBER(writing_direction_left_to_right)
63 IPC_STRUCT_TRAITS_MEMBER(writing_direction_right_to_left)
64 IPC_STRUCT_TRAITS_MEMBER(edit_flags)
65 IPC_STRUCT_TRAITS_MEMBER(security_info)
66 IPC_STRUCT_TRAITS_MEMBER(frame_charset)
67 IPC_STRUCT_TRAITS_MEMBER(referrer_policy)
68 IPC_STRUCT_TRAITS_MEMBER(custom_context)
69 IPC_STRUCT_TRAITS_MEMBER(custom_items)
70 IPC_STRUCT_TRAITS_MEMBER(source_type)
71 #if defined(OS_ANDROID)
72 IPC_STRUCT_TRAITS_MEMBER(selection_start)
73 IPC_STRUCT_TRAITS_MEMBER(selection_end)
74 #endif
75 IPC_STRUCT_TRAITS_END()
77 IPC_STRUCT_TRAITS_BEGIN(content::CustomContextMenuContext)
78 IPC_STRUCT_TRAITS_MEMBER(is_pepper_menu)
79 IPC_STRUCT_TRAITS_MEMBER(request_id)
80 IPC_STRUCT_TRAITS_MEMBER(render_widget_id)
81 IPC_STRUCT_TRAITS_END()
83 IPC_STRUCT_BEGIN(FrameHostMsg_DidFailProvisionalLoadWithError_Params)
84 // The WebFrame's uniqueName().
85 IPC_STRUCT_MEMBER(base::string16, frame_unique_name)
86 // Error code as reported in the DidFailProvisionalLoad callback.
87 IPC_STRUCT_MEMBER(int, error_code)
88 // An error message generated from the error_code. This can be an empty
89 // string if we were unable to find a meaningful description.
90 IPC_STRUCT_MEMBER(base::string16, error_description)
91 // The URL that the error is reported for.
92 IPC_STRUCT_MEMBER(GURL, url)
93 // True if the failure is the result of navigating to a POST again
94 // and we're going to show the POST interstitial.
95 IPC_STRUCT_MEMBER(bool, showing_repost_interstitial)
96 IPC_STRUCT_END()
98 IPC_STRUCT_TRAITS_BEGIN(content::FrameNavigateParams)
99 IPC_STRUCT_TRAITS_MEMBER(page_id)
100 IPC_STRUCT_TRAITS_MEMBER(url)
101 IPC_STRUCT_TRAITS_MEMBER(base_url)
102 IPC_STRUCT_TRAITS_MEMBER(referrer)
103 IPC_STRUCT_TRAITS_MEMBER(transition)
104 IPC_STRUCT_TRAITS_MEMBER(redirects)
105 IPC_STRUCT_TRAITS_MEMBER(should_update_history)
106 IPC_STRUCT_TRAITS_MEMBER(searchable_form_url)
107 IPC_STRUCT_TRAITS_MEMBER(searchable_form_encoding)
108 IPC_STRUCT_TRAITS_MEMBER(contents_mime_type)
109 IPC_STRUCT_TRAITS_MEMBER(socket_address)
110 IPC_STRUCT_TRAITS_END()
112 // Parameters structure for FrameHostMsg_DidCommitProvisionalLoad, which has
113 // too many data parameters to be reasonably put in a predefined IPC message.
114 IPC_STRUCT_BEGIN_WITH_PARENT(FrameHostMsg_DidCommitProvisionalLoad_Params,
115 content::FrameNavigateParams)
116 IPC_STRUCT_TRAITS_PARENT(content::FrameNavigateParams)
117 // The WebFrame's uniqueName().
118 IPC_STRUCT_MEMBER(base::string16, frame_unique_name)
120 // Information regarding the security of the connection (empty if the
121 // connection was not secure).
122 IPC_STRUCT_MEMBER(std::string, security_info)
124 // The gesture that initiated this navigation.
125 IPC_STRUCT_MEMBER(content::NavigationGesture, gesture)
127 // True if this was a post request.
128 IPC_STRUCT_MEMBER(bool, is_post)
130 // The POST body identifier. -1 if it doesn't exist.
131 IPC_STRUCT_MEMBER(int64, post_id)
133 // Whether the frame navigation resulted in no change to the documents within
134 // the page. For example, the navigation may have just resulted in scrolling
135 // to a named anchor.
136 IPC_STRUCT_MEMBER(bool, was_within_same_page)
138 // The status code of the HTTP request.
139 IPC_STRUCT_MEMBER(int, http_status_code)
141 // True if the connection was proxied. In this case, socket_address
142 // will represent the address of the proxy, rather than the remote host.
143 IPC_STRUCT_MEMBER(bool, was_fetched_via_proxy)
145 // Serialized history item state to store in the navigation entry.
146 IPC_STRUCT_MEMBER(content::PageState, page_state)
148 // Original request's URL.
149 IPC_STRUCT_MEMBER(GURL, original_request_url)
151 // User agent override used to navigate.
152 IPC_STRUCT_MEMBER(bool, is_overriding_user_agent)
154 // Notifies the browser that for this navigation, the session history was
155 // successfully cleared.
156 IPC_STRUCT_MEMBER(bool, history_list_was_cleared)
157 IPC_STRUCT_END()
159 IPC_STRUCT_BEGIN(FrameMsg_Navigate_Params)
160 // The page_id for this navigation, or -1 if it is a new navigation. Back,
161 // Forward, and Reload navigations should have a valid page_id. If the load
162 // succeeds, then this page_id will be reflected in the resultant
163 // FrameHostMsg_DidCommitProvisionalLoad message.
164 IPC_STRUCT_MEMBER(int32, page_id)
166 // If page_id is -1, then pending_history_list_offset will also be -1.
167 // Otherwise, it contains the offset into the history list corresponding to
168 // the current navigation.
169 IPC_STRUCT_MEMBER(int, pending_history_list_offset)
171 // Informs the RenderView of where its current page contents reside in
172 // session history and the total size of the session history list.
173 IPC_STRUCT_MEMBER(int, current_history_list_offset)
174 IPC_STRUCT_MEMBER(int, current_history_list_length)
176 // Informs the RenderView the session history should be cleared. In that
177 // case, the RenderView needs to notify the browser that the clearing was
178 // succesful when the navigation commits.
179 IPC_STRUCT_MEMBER(bool, should_clear_history_list)
181 // The URL to load.
182 IPC_STRUCT_MEMBER(GURL, url)
184 // Base URL for use in WebKit's SubstituteData.
185 // Is only used with data: URLs.
186 IPC_STRUCT_MEMBER(GURL, base_url_for_data_url)
188 // History URL for use in WebKit's SubstituteData.
189 // Is only used with data: URLs.
190 IPC_STRUCT_MEMBER(GURL, history_url_for_data_url)
192 // The URL to send in the "Referer" header field. Can be empty if there is
193 // no referrer.
194 IPC_STRUCT_MEMBER(content::Referrer, referrer)
196 // Any redirect URLs that occurred before |url|. Useful for cross-process
197 // navigations; defaults to empty.
198 IPC_STRUCT_MEMBER(std::vector<GURL>, redirects)
200 // The type of transition.
201 IPC_STRUCT_MEMBER(content::PageTransition, transition)
203 // Informs the RenderView the pending navigation should replace the current
204 // history entry when it commits. This is used for cross-process redirects so
205 // the transferred navigation can recover the navigation state.
206 IPC_STRUCT_MEMBER(bool, should_replace_current_entry)
208 // Opaque history state (received by ViewHostMsg_UpdateState).
209 IPC_STRUCT_MEMBER(content::PageState, page_state)
211 // Type of navigation.
212 IPC_STRUCT_MEMBER(FrameMsg_Navigate_Type::Value, navigation_type)
214 // The time the request was created
215 IPC_STRUCT_MEMBER(base::Time, request_time)
217 // Extra headers (separated by \n) to send during the request.
218 IPC_STRUCT_MEMBER(std::string, extra_headers)
220 // The following two members identify a previous request that has been
221 // created before this navigation is being transferred to a new render view.
222 // This serves the purpose of recycling the old request.
223 // Unless this refers to a transferred navigation, these values are -1 and -1.
224 IPC_STRUCT_MEMBER(int, transferred_request_child_id)
225 IPC_STRUCT_MEMBER(int, transferred_request_request_id)
227 // Whether or not we should allow the url to download.
228 IPC_STRUCT_MEMBER(bool, allow_download)
230 // Whether or not the user agent override string should be used.
231 IPC_STRUCT_MEMBER(bool, is_overriding_user_agent)
233 // True if this was a post request.
234 IPC_STRUCT_MEMBER(bool, is_post)
236 // If is_post is true, holds the post_data information from browser. Empty
237 // otherwise.
238 IPC_STRUCT_MEMBER(std::vector<unsigned char>, browser_initiated_post_data)
240 // Whether or not this url should be allowed to access local file://
241 // resources.
242 IPC_STRUCT_MEMBER(bool, can_load_local_resources)
244 // If not empty, which frame to navigate.
245 IPC_STRUCT_MEMBER(std::string, frame_to_navigate)
247 // The navigationStart time to expose to JS for this navigation.
248 IPC_STRUCT_MEMBER(base::TimeTicks, browser_navigation_start)
249 IPC_STRUCT_END()
251 IPC_STRUCT_BEGIN(FrameHostMsg_OpenURL_Params)
252 IPC_STRUCT_MEMBER(GURL, url)
253 IPC_STRUCT_MEMBER(content::Referrer, referrer)
254 IPC_STRUCT_MEMBER(WindowOpenDisposition, disposition)
255 IPC_STRUCT_MEMBER(bool, should_replace_current_entry)
256 IPC_STRUCT_MEMBER(bool, user_gesture)
257 IPC_STRUCT_END()
259 // -----------------------------------------------------------------------------
260 // Messages sent from the browser to the renderer.
262 // When HW accelerated buffers are swapped in an out-of-process child frame
263 // renderer, the message is forwarded to the embedding frame to notify it of
264 // a new texture available for compositing. When the buffer has finished
265 // presenting, a FrameHostMsg_BuffersSwappedACK should be sent back to
266 // gpu host that produced this buffer.
268 // This is used in the non-ubercomp HW accelerated compositing path.
269 IPC_MESSAGE_ROUTED1(FrameMsg_BuffersSwapped,
270 FrameMsg_BuffersSwapped_Params /* params */)
272 // Notifies the embedding frame that a new CompositorFrame is ready to be
273 // presented. When the frame finishes presenting, a matching
274 // FrameHostMsg_CompositorFrameSwappedACK should be sent back to the
275 // RenderViewHost that was produced the CompositorFrame.
277 // This is used in the ubercomp compositing path.
278 IPC_MESSAGE_ROUTED1(FrameMsg_CompositorFrameSwapped,
279 FrameMsg_CompositorFrameSwapped_Params /* params */)
281 // Notifies the embedding frame that the process rendering the child frame's
282 // contents has terminated.
283 IPC_MESSAGE_ROUTED0(FrameMsg_ChildFrameProcessGone)
285 // Sent in response to a FrameHostMsg_ContextMenu to let the renderer know that
286 // the menu has been closed.
287 IPC_MESSAGE_ROUTED1(FrameMsg_ContextMenuClosed,
288 content::CustomContextMenuContext /* custom_context */)
290 // Executes custom context menu action that was provided from Blink.
291 IPC_MESSAGE_ROUTED2(FrameMsg_CustomContextMenuAction,
292 content::CustomContextMenuContext /* custom_context */,
293 unsigned /* action */)
295 // Tells the renderer to perform the specified navigation, interrupting any
296 // existing navigation.
297 IPC_MESSAGE_ROUTED1(FrameMsg_Navigate, FrameMsg_Navigate_Params)
299 // Instructs the renderer to invoke the frame's beforeunload event handler.
300 // Expects the result to be returned via FrameHostMsg_BeforeUnload_ACK.
301 IPC_MESSAGE_ROUTED0(FrameMsg_BeforeUnload)
303 // Instructs the frame to swap out for a cross-site transition, including
304 // running the unload event handler and creating a RenderFrameProxy with the
305 // given |proxy_routing_id|. Expects a SwapOut_ACK message when finished.
306 IPC_MESSAGE_ROUTED1(FrameMsg_SwapOut,
307 int /* proxy_routing_id */)
309 // Request for the renderer to insert CSS into the frame.
310 IPC_MESSAGE_ROUTED1(FrameMsg_CSSInsertRequest,
311 std::string /* css */)
313 // Request for the renderer to execute JavaScript in the frame's context.
315 // javascript is the string containing the JavaScript to be executed in the
316 // target frame's context.
318 // If the third parameter is true the result is sent back to the browser using
319 // the message FrameHostMsg_JavaScriptExecuteResponse.
320 // FrameHostMsg_JavaScriptExecuteResponse is passed the ID parameter so that the
321 // host can uniquely identify the request.
322 IPC_MESSAGE_ROUTED3(FrameMsg_JavaScriptExecuteRequest,
323 base::string16, /* javascript */
324 int, /* ID */
325 bool /* if true, a reply is requested */)
327 // Selects between the given start and end offsets in the currently focused
328 // editable field.
329 IPC_MESSAGE_ROUTED2(FrameMsg_SetEditableSelectionOffsets,
330 int /* start */,
331 int /* end */)
333 // Sets the text composition to be between the given start and end offsets in
334 // the currently focused editable field.
335 IPC_MESSAGE_ROUTED3(FrameMsg_SetCompositionFromExistingText,
336 int /* start */,
337 int /* end */,
338 std::vector<blink::WebCompositionUnderline> /* underlines */)
340 // Deletes the current selection plus the specified number of characters before
341 // and after the selection or caret.
342 IPC_MESSAGE_ROUTED2(FrameMsg_ExtendSelectionAndDelete,
343 int /* before */,
344 int /* after */)
346 // Tells the renderer to reload the frame, optionally ignoring the cache while
347 // doing so.
348 IPC_MESSAGE_ROUTED1(FrameMsg_Reload,
349 bool /* ignore_cache */)
351 // Notifies the color chooser client that the user selected a color.
352 IPC_MESSAGE_ROUTED2(FrameMsg_DidChooseColorResponse, unsigned, SkColor)
354 // Notifies the color chooser client that the color chooser has ended.
355 IPC_MESSAGE_ROUTED1(FrameMsg_DidEndColorChooser, unsigned)
357 // Notifies the corresponding RenderFrameProxy object to replace itself with the
358 // RenderFrame object it is associated with.
359 IPC_MESSAGE_ROUTED0(FrameMsg_DeleteProxy)
361 // -----------------------------------------------------------------------------
362 // Messages sent from the renderer to the browser.
364 // Blink and JavaScript error messages to log to the console
365 // or debugger UI.
366 IPC_MESSAGE_ROUTED4(FrameHostMsg_AddMessageToConsole,
367 int32, /* log level */
368 base::string16, /* msg */
369 int32, /* line number */
370 base::string16 /* source id */ )
372 // Sent by the renderer when a child frame is created in the renderer.
374 // Each of these messages will have a corresponding FrameHostMsg_Detach message
375 // sent when the frame is detached from the DOM.
376 IPC_SYNC_MESSAGE_CONTROL2_1(FrameHostMsg_CreateChildFrame,
377 int32 /* parent_routing_id */,
378 std::string /* frame_name */,
379 int32 /* new_routing_id */)
381 // Sent by the renderer to the parent RenderFrameHost when a child frame is
382 // detached from the DOM.
383 IPC_MESSAGE_ROUTED0(FrameHostMsg_Detach)
385 // Sent by the renderer when the frame becomes focused.
386 IPC_MESSAGE_ROUTED0(FrameHostMsg_FrameFocused)
388 // Sent when the renderer starts a provisional load for a frame.
389 IPC_MESSAGE_ROUTED2(FrameHostMsg_DidStartProvisionalLoadForFrame,
390 int32 /* parent_routing_id */,
391 GURL /* url */)
393 // Sent when the renderer fails a provisional load with an error.
394 IPC_MESSAGE_ROUTED1(FrameHostMsg_DidFailProvisionalLoadWithError,
395 FrameHostMsg_DidFailProvisionalLoadWithError_Params)
397 // Sent when a provisional load on the main frame redirects.
398 IPC_MESSAGE_ROUTED3(FrameHostMsg_DidRedirectProvisionalLoad,
399 int /* page_id */,
400 GURL /* source_url*/,
401 GURL /* target_url */)
403 // Notifies the browser that a frame in the view has changed. This message
404 // has a lot of parameters and is packed/unpacked by functions defined in
405 // render_messages.h.
406 IPC_MESSAGE_ROUTED1(FrameHostMsg_DidCommitProvisionalLoad,
407 FrameHostMsg_DidCommitProvisionalLoad_Params)
409 // Notifies the browser that a document has been loaded.
410 IPC_MESSAGE_ROUTED0(FrameHostMsg_DidFinishDocumentLoad)
412 IPC_MESSAGE_ROUTED3(FrameHostMsg_DidFailLoadWithError,
413 GURL /* validated_url */,
414 int /* error_code */,
415 base::string16 /* error_description */)
417 // Sent when the renderer starts loading the page. |to_different_document| will
418 // be true unless the load is a fragment navigation, or triggered by
419 // history.pushState/replaceState.
420 IPC_MESSAGE_ROUTED1(FrameHostMsg_DidStartLoading,
421 bool /* to_different_document */)
423 // Sent when the renderer is done loading a page.
424 IPC_MESSAGE_ROUTED0(FrameHostMsg_DidStopLoading)
426 // Sent when the renderer changed the progress of a load.
427 IPC_MESSAGE_ROUTED1(FrameHostMsg_DidChangeLoadProgress,
428 double /* load_progress */)
430 // Requests that the given URL be opened in the specified manner.
431 IPC_MESSAGE_ROUTED1(FrameHostMsg_OpenURL, FrameHostMsg_OpenURL_Params)
433 // Notifies the browser that a frame finished loading.
434 IPC_MESSAGE_ROUTED1(FrameHostMsg_DidFinishLoad,
435 GURL /* validated_url */)
437 // Sent when after the onload handler has been invoked for the document
438 // in this frame. Sent for top-level frames.
439 IPC_MESSAGE_ROUTED0(FrameHostMsg_DocumentOnLoadCompleted)
441 // Notifies that the initial empty document of a view has been accessed.
442 // After this, it is no longer safe to show a pending navigation's URL without
443 // making a URL spoof possible.
444 IPC_MESSAGE_ROUTED0(FrameHostMsg_DidAccessInitialDocument)
446 // Sent when the frame sets its opener to null, disowning it for the lifetime of
447 // the window. Sent for top-level frames.
448 IPC_MESSAGE_ROUTED0(FrameHostMsg_DidDisownOpener)
450 // Changes the title for the page in the UI when the page is navigated or the
451 // title changes. Sent for top-level frames.
452 IPC_MESSAGE_ROUTED3(FrameHostMsg_UpdateTitle,
453 int32 /* page_id */,
454 base::string16 /* title */,
455 blink::WebTextDirection /* title direction */)
457 // Change the encoding name of the page in UI when the page has detected
458 // proper encoding name. Sent for top-level frames.
459 IPC_MESSAGE_ROUTED1(FrameHostMsg_UpdateEncoding,
460 std::string /* new encoding name */)
462 // Following message is used to communicate the values received by the
463 // callback binding the JS to Cpp.
464 // An instance of browser that has an automation host listening to it can
465 // have a javascript send a native value (string, number, boolean) to the
466 // listener in Cpp. (DomAutomationController)
467 IPC_MESSAGE_ROUTED2(FrameHostMsg_DomOperationResponse,
468 std::string /* json_string */,
469 int /* automation_id */)
471 // Sent to the browser when the renderer detects it is blocked on a pepper
472 // plugin message for too long. This is also sent when it becomes unhung
473 // (according to the value of is_hung). The browser can give the user the
474 // option of killing the plugin.
475 IPC_MESSAGE_ROUTED3(FrameHostMsg_PepperPluginHung,
476 int /* plugin_child_id */,
477 base::FilePath /* path */,
478 bool /* is_hung */)
480 // Sent by the renderer process to indicate that a plugin instance has crashed.
481 // Note: |plugin_pid| should not be trusted. The corresponding process has
482 // probably died. Moreover, the ID may have been reused by a new process. Any
483 // usage other than displaying it in a prompt to the user is very likely to be
484 // wrong.
485 IPC_MESSAGE_ROUTED2(FrameHostMsg_PluginCrashed,
486 base::FilePath /* plugin_path */,
487 base::ProcessId /* plugin_pid */)
489 // Return information about a plugin for the given URL and MIME
490 // type. If there is no matching plugin, |found| is false.
491 // |actual_mime_type| is the actual mime type supported by the
492 // found plugin.
493 IPC_SYNC_MESSAGE_CONTROL4_3(FrameHostMsg_GetPluginInfo,
494 int /* render_frame_id */,
495 GURL /* url */,
496 GURL /* page_url */,
497 std::string /* mime_type */,
498 bool /* found */,
499 content::WebPluginInfo /* plugin info */,
500 std::string /* actual_mime_type */)
502 // A renderer sends this to the browser process when it wants to
503 // create a plugin. The browser will create the plugin process if
504 // necessary, and will return a handle to the channel on success.
505 // On error an empty string is returned.
506 IPC_SYNC_MESSAGE_CONTROL4_2(FrameHostMsg_OpenChannelToPlugin,
507 int /* render_frame_id */,
508 GURL /* url */,
509 GURL /* page_url */,
510 std::string /* mime_type */,
511 IPC::ChannelHandle /* channel_handle */,
512 content::WebPluginInfo /* info */)
514 // Acknowledge that we presented a HW buffer and provide a sync point
515 // to specify the location in the command stream when the compositor
516 // is no longer using it.
518 // See FrameMsg_BuffersSwapped.
519 IPC_MESSAGE_ROUTED1(FrameHostMsg_BuffersSwappedACK,
520 FrameHostMsg_BuffersSwappedACK_Params /* params */)
522 // Acknowledge that we presented an ubercomp frame.
524 // See FrameMsg_CompositorFrameSwapped
525 IPC_MESSAGE_ROUTED1(FrameHostMsg_CompositorFrameSwappedACK,
526 FrameHostMsg_CompositorFrameSwappedACK_Params /* params */)
528 // Provides the result from handling BeforeUnload. |proceed| matches the return
529 // value of the frame's beforeunload handler: true if the user decided to
530 // proceed with leaving the page.
531 IPC_MESSAGE_ROUTED3(FrameHostMsg_BeforeUnload_ACK,
532 bool /* proceed */,
533 base::TimeTicks /* before_unload_start_time */,
534 base::TimeTicks /* before_unload_end_time */)
536 // Indicates that the current frame has swapped out, after a SwapOut message.
537 IPC_MESSAGE_ROUTED0(FrameHostMsg_SwapOut_ACK)
539 IPC_MESSAGE_ROUTED1(FrameHostMsg_ReclaimCompositorResources,
540 FrameHostMsg_ReclaimCompositorResources_Params /* params */)
542 // Forwards an input event to a child.
543 // TODO(nick): Temporary bridge, revisit once the browser process can route
544 // input directly to subframes. http://crbug.com/339659
545 IPC_MESSAGE_ROUTED1(FrameHostMsg_ForwardInputEvent,
546 IPC::WebInputEventPointer /* event */)
548 // Used to tell the parent that the user right clicked on an area of the
549 // content area, and a context menu should be shown for it. The params
550 // object contains information about the node(s) that were selected when the
551 // user right clicked.
552 IPC_MESSAGE_ROUTED1(FrameHostMsg_ContextMenu, content::ContextMenuParams)
554 // Initial drawing parameters for a child frame that has been swapped out to
555 // another process.
556 IPC_MESSAGE_ROUTED2(FrameHostMsg_InitializeChildFrame,
557 gfx::Rect /* frame_rect */,
558 float /* scale_factor */)
560 // Response for FrameMsg_JavaScriptExecuteRequest, sent when a reply was
561 // requested. The ID is the parameter supplied to
562 // FrameMsg_JavaScriptExecuteRequest. The result has the value returned by the
563 // script as its only element, one of Null, Boolean, Integer, Real, Date, or
564 // String.
565 IPC_MESSAGE_ROUTED2(FrameHostMsg_JavaScriptExecuteResponse,
566 int /* id */,
567 base::ListValue /* result */)
569 // A request to run a JavaScript dialog.
570 IPC_SYNC_MESSAGE_ROUTED4_2(FrameHostMsg_RunJavaScriptMessage,
571 base::string16 /* in - alert message */,
572 base::string16 /* in - default prompt */,
573 GURL /* in - originating page URL */,
574 content::JavaScriptMessageType /* in - type */,
575 bool /* out - success */,
576 base::string16 /* out - user_input field */)
578 // Displays a dialog to confirm that the user wants to navigate away from the
579 // page. Replies true if yes, and false otherwise. The reply string is ignored,
580 // but is included so that we can use OnJavaScriptMessageBoxClosed.
581 IPC_SYNC_MESSAGE_ROUTED3_2(FrameHostMsg_RunBeforeUnloadConfirm,
582 GURL, /* in - originating frame URL */
583 base::string16 /* in - alert message */,
584 bool /* in - is a reload */,
585 bool /* out - success */,
586 base::string16 /* out - This is ignored.*/)
588 // Asks the browser to open the color chooser.
589 IPC_MESSAGE_ROUTED3(FrameHostMsg_OpenColorChooser,
590 int /* id */,
591 SkColor /* color */,
592 std::vector<content::ColorSuggestion> /* suggestions */)
594 // Asks the browser to end the color chooser.
595 IPC_MESSAGE_ROUTED1(FrameHostMsg_EndColorChooser, int /* id */)
597 // Change the selected color in the color chooser.
598 IPC_MESSAGE_ROUTED2(FrameHostMsg_SetSelectedColorInColorChooser,
599 int /* id */,
600 SkColor /* color */)
602 // Notifies the browser that media has started/stopped playing.
603 IPC_MESSAGE_ROUTED3(FrameHostMsg_MediaPlayingNotification,
604 int64 /* player_cookie, distinguishes instances */,
605 bool /* has_video */,
606 bool /* has_audio */)
608 IPC_MESSAGE_ROUTED1(FrameHostMsg_MediaPausedNotification,
609 int64 /* player_cookie, distinguishes instances */)