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/common/resource_request_body.h"
14 #include "content/public/common/color_suggestion.h"
15 #include "content/public/common/common_param_traits.h"
16 #include "content/public/common/context_menu_params.h"
17 #include "content/public/common/frame_navigate_params.h"
18 #include "content/public/common/javascript_message_type.h"
19 #include "content/public/common/page_state.h"
20 #include "ipc/ipc_message_macros.h"
21 #include "ui/gfx/ipc/gfx_param_traits.h"
24 #undef IPC_MESSAGE_EXPORT
25 #define IPC_MESSAGE_EXPORT CONTENT_EXPORT
27 #define IPC_MESSAGE_START FrameMsgStart
29 IPC_ENUM_TRAITS_MIN_MAX_VALUE(AccessibilityMode,
31 AccessibilityModeComplete)
32 IPC_ENUM_TRAITS_MIN_MAX_VALUE(content::JavaScriptMessageType,
33 content::JAVASCRIPT_MESSAGE_TYPE_ALERT,
34 content::JAVASCRIPT_MESSAGE_TYPE_PROMPT)
35 IPC_ENUM_TRAITS_MAX_VALUE(FrameMsg_Navigate_Type::Value,
36 FrameMsg_Navigate_Type::NAVIGATE_TYPE_LAST)
37 IPC_ENUM_TRAITS_MAX_VALUE(blink::WebContextMenuData::MediaType,
38 blink::WebContextMenuData::MediaTypeLast)
39 IPC_ENUM_TRAITS_MAX_VALUE(ui::MenuSourceType, ui::MENU_SOURCE_TYPE_LAST)
41 IPC_STRUCT_TRAITS_BEGIN(content::ColorSuggestion)
42 IPC_STRUCT_TRAITS_MEMBER(color)
43 IPC_STRUCT_TRAITS_MEMBER(label)
44 IPC_STRUCT_TRAITS_END()
46 IPC_STRUCT_TRAITS_BEGIN(content::ContextMenuParams)
47 IPC_STRUCT_TRAITS_MEMBER(media_type)
48 IPC_STRUCT_TRAITS_MEMBER(x)
49 IPC_STRUCT_TRAITS_MEMBER(y)
50 IPC_STRUCT_TRAITS_MEMBER(link_url)
51 IPC_STRUCT_TRAITS_MEMBER(link_text)
52 IPC_STRUCT_TRAITS_MEMBER(unfiltered_link_url)
53 IPC_STRUCT_TRAITS_MEMBER(src_url)
54 IPC_STRUCT_TRAITS_MEMBER(has_image_contents)
55 IPC_STRUCT_TRAITS_MEMBER(page_url)
56 IPC_STRUCT_TRAITS_MEMBER(keyword_url)
57 IPC_STRUCT_TRAITS_MEMBER(frame_url)
58 IPC_STRUCT_TRAITS_MEMBER(frame_page_state)
59 IPC_STRUCT_TRAITS_MEMBER(media_flags)
60 IPC_STRUCT_TRAITS_MEMBER(selection_text)
61 IPC_STRUCT_TRAITS_MEMBER(suggested_filename)
62 IPC_STRUCT_TRAITS_MEMBER(misspelled_word)
63 IPC_STRUCT_TRAITS_MEMBER(misspelling_hash)
64 IPC_STRUCT_TRAITS_MEMBER(dictionary_suggestions)
65 IPC_STRUCT_TRAITS_MEMBER(spellcheck_enabled)
66 IPC_STRUCT_TRAITS_MEMBER(is_editable)
67 IPC_STRUCT_TRAITS_MEMBER(writing_direction_default)
68 IPC_STRUCT_TRAITS_MEMBER(writing_direction_left_to_right)
69 IPC_STRUCT_TRAITS_MEMBER(writing_direction_right_to_left)
70 IPC_STRUCT_TRAITS_MEMBER(edit_flags)
71 IPC_STRUCT_TRAITS_MEMBER(security_info)
72 IPC_STRUCT_TRAITS_MEMBER(frame_charset)
73 IPC_STRUCT_TRAITS_MEMBER(referrer_policy)
74 IPC_STRUCT_TRAITS_MEMBER(custom_context)
75 IPC_STRUCT_TRAITS_MEMBER(custom_items)
76 IPC_STRUCT_TRAITS_MEMBER(source_type)
77 #if defined(OS_ANDROID)
78 IPC_STRUCT_TRAITS_MEMBER(selection_start)
79 IPC_STRUCT_TRAITS_MEMBER(selection_end)
81 IPC_STRUCT_TRAITS_END()
83 IPC_STRUCT_TRAITS_BEGIN(content::CustomContextMenuContext)
84 IPC_STRUCT_TRAITS_MEMBER(is_pepper_menu)
85 IPC_STRUCT_TRAITS_MEMBER(request_id)
86 IPC_STRUCT_TRAITS_MEMBER(render_widget_id)
87 IPC_STRUCT_TRAITS_MEMBER(link_followed)
88 IPC_STRUCT_TRAITS_END()
90 IPC_STRUCT_BEGIN(FrameHostMsg_DidFailProvisionalLoadWithError_Params)
91 // Error code as reported in the DidFailProvisionalLoad callback.
92 IPC_STRUCT_MEMBER(int, error_code)
93 // An error message generated from the error_code. This can be an empty
94 // string if we were unable to find a meaningful description.
95 IPC_STRUCT_MEMBER(base::string16, error_description)
96 // The URL that the error is reported for.
97 IPC_STRUCT_MEMBER(GURL, url)
98 // True if the failure is the result of navigating to a POST again
99 // and we're going to show the POST interstitial.
100 IPC_STRUCT_MEMBER(bool, showing_repost_interstitial)
103 IPC_STRUCT_TRAITS_BEGIN(content::FrameNavigateParams)
104 IPC_STRUCT_TRAITS_MEMBER(page_id)
105 IPC_STRUCT_TRAITS_MEMBER(url)
106 IPC_STRUCT_TRAITS_MEMBER(base_url)
107 IPC_STRUCT_TRAITS_MEMBER(referrer)
108 IPC_STRUCT_TRAITS_MEMBER(transition)
109 IPC_STRUCT_TRAITS_MEMBER(redirects)
110 IPC_STRUCT_TRAITS_MEMBER(should_update_history)
111 IPC_STRUCT_TRAITS_MEMBER(searchable_form_url)
112 IPC_STRUCT_TRAITS_MEMBER(searchable_form_encoding)
113 IPC_STRUCT_TRAITS_MEMBER(contents_mime_type)
114 IPC_STRUCT_TRAITS_MEMBER(socket_address)
115 IPC_STRUCT_TRAITS_END()
117 // Parameters structure for FrameHostMsg_DidCommitProvisionalLoad, which has
118 // too many data parameters to be reasonably put in a predefined IPC message.
119 IPC_STRUCT_BEGIN_WITH_PARENT(FrameHostMsg_DidCommitProvisionalLoad_Params,
120 content::FrameNavigateParams)
121 IPC_STRUCT_TRAITS_PARENT(content::FrameNavigateParams)
123 // Information regarding the security of the connection (empty if the
124 // connection was not secure).
125 IPC_STRUCT_MEMBER(std::string, security_info)
127 // The gesture that initiated this navigation.
128 IPC_STRUCT_MEMBER(content::NavigationGesture, gesture)
130 // True if this was a post request.
131 IPC_STRUCT_MEMBER(bool, is_post)
133 // The POST body identifier. -1 if it doesn't exist.
134 IPC_STRUCT_MEMBER(int64, post_id)
136 // Whether the frame navigation resulted in no change to the documents within
137 // the page. For example, the navigation may have just resulted in scrolling
138 // to a named anchor.
139 IPC_STRUCT_MEMBER(bool, was_within_same_page)
141 // The status code of the HTTP request.
142 IPC_STRUCT_MEMBER(int, http_status_code)
144 // True if the connection was proxied. In this case, socket_address
145 // will represent the address of the proxy, rather than the remote host.
146 IPC_STRUCT_MEMBER(bool, was_fetched_via_proxy)
148 // Serialized history item state to store in the navigation entry.
149 IPC_STRUCT_MEMBER(content::PageState, page_state)
151 // Original request's URL.
152 IPC_STRUCT_MEMBER(GURL, original_request_url)
154 // User agent override used to navigate.
155 IPC_STRUCT_MEMBER(bool, is_overriding_user_agent)
157 // Notifies the browser that for this navigation, the session history was
158 // successfully cleared.
159 IPC_STRUCT_MEMBER(bool, history_list_was_cleared)
161 // The routing_id of the render view associated with the navigation.
162 // We need to track the RenderViewHost routing_id because of downstream
163 // dependencies (crbug.com/392171 DownloadRequestHandle, SaveFileManager,
164 // ResourceDispatcherHostImpl, MediaStreamUIProxy,
165 // SpeechRecognitionDispatcherHost and possibly others). They look up the view
166 // based on the ID stored in the resource requests. Once those dependencies
167 // are unwound or moved to RenderFrameHost (crbug.com/304341) we can move the
168 // client to be based on the routing_id of the RenderFrameHost.
169 IPC_STRUCT_MEMBER(int, render_view_routing_id)
172 IPC_STRUCT_BEGIN(FrameMsg_Navigate_Params)
173 // The page_id for this navigation, or -1 if it is a new navigation. Back,
174 // Forward, and Reload navigations should have a valid page_id. If the load
175 // succeeds, then this page_id will be reflected in the resultant
176 // FrameHostMsg_DidCommitProvisionalLoad message.
177 IPC_STRUCT_MEMBER(int32, page_id)
179 // If page_id is -1, then pending_history_list_offset will also be -1.
180 // Otherwise, it contains the offset into the history list corresponding to
181 // the current navigation.
182 IPC_STRUCT_MEMBER(int, pending_history_list_offset)
184 // Informs the RenderView of where its current page contents reside in
185 // session history and the total size of the session history list.
186 IPC_STRUCT_MEMBER(int, current_history_list_offset)
187 IPC_STRUCT_MEMBER(int, current_history_list_length)
189 // Informs the RenderView the session history should be cleared. In that
190 // case, the RenderView needs to notify the browser that the clearing was
191 // succesful when the navigation commits.
192 IPC_STRUCT_MEMBER(bool, should_clear_history_list)
195 IPC_STRUCT_MEMBER(GURL, url)
197 // Base URL for use in WebKit's SubstituteData.
198 // Is only used with data: URLs.
199 IPC_STRUCT_MEMBER(GURL, base_url_for_data_url)
201 // History URL for use in WebKit's SubstituteData.
202 // Is only used with data: URLs.
203 IPC_STRUCT_MEMBER(GURL, history_url_for_data_url)
205 // The URL to send in the "Referer" header field. Can be empty if there is
207 IPC_STRUCT_MEMBER(content::Referrer, referrer)
209 // Any redirect URLs that occurred before |url|. Useful for cross-process
210 // navigations; defaults to empty.
211 IPC_STRUCT_MEMBER(std::vector<GURL>, redirects)
213 // The type of transition.
214 IPC_STRUCT_MEMBER(content::PageTransition, transition)
216 // Informs the RenderView the pending navigation should replace the current
217 // history entry when it commits. This is used for cross-process redirects so
218 // the transferred navigation can recover the navigation state.
219 IPC_STRUCT_MEMBER(bool, should_replace_current_entry)
221 // Opaque history state (received by ViewHostMsg_UpdateState).
222 IPC_STRUCT_MEMBER(content::PageState, page_state)
224 // Type of navigation.
225 IPC_STRUCT_MEMBER(FrameMsg_Navigate_Type::Value, navigation_type)
227 // The time the request was created. This is used by the old performance
228 // infrastructure to set up DocumentState associated with the RenderView.
229 // TODO(ppi): make it go away.
230 IPC_STRUCT_MEMBER(base::Time, request_time)
232 // Extra headers (separated by \n) to send during the request.
233 IPC_STRUCT_MEMBER(std::string, extra_headers)
235 // The following two members identify a previous request that has been
236 // created before this navigation is being transferred to a new render view.
237 // This serves the purpose of recycling the old request.
238 // Unless this refers to a transferred navigation, these values are -1 and -1.
239 IPC_STRUCT_MEMBER(int, transferred_request_child_id)
240 IPC_STRUCT_MEMBER(int, transferred_request_request_id)
242 // Whether or not we should allow the url to download.
243 IPC_STRUCT_MEMBER(bool, allow_download)
245 // Whether or not the user agent override string should be used.
246 IPC_STRUCT_MEMBER(bool, is_overriding_user_agent)
248 // True if this was a post request.
249 IPC_STRUCT_MEMBER(bool, is_post)
251 // If is_post is true, holds the post_data information from browser. Empty
253 IPC_STRUCT_MEMBER(std::vector<unsigned char>, browser_initiated_post_data)
255 // Whether or not this url should be allowed to access local file://
257 IPC_STRUCT_MEMBER(bool, can_load_local_resources)
259 // If not empty, which frame to navigate.
260 IPC_STRUCT_MEMBER(std::string, frame_to_navigate)
262 // The navigationStart time to expose through the Navigation Timing API to JS.
263 IPC_STRUCT_MEMBER(base::TimeTicks, browser_navigation_start)
266 IPC_STRUCT_BEGIN(FrameHostMsg_OpenURL_Params)
267 IPC_STRUCT_MEMBER(GURL, url)
268 IPC_STRUCT_MEMBER(content::Referrer, referrer)
269 IPC_STRUCT_MEMBER(WindowOpenDisposition, disposition)
270 IPC_STRUCT_MEMBER(bool, should_replace_current_entry)
271 IPC_STRUCT_MEMBER(bool, user_gesture)
274 IPC_STRUCT_BEGIN(FrameHostMsg_BeginNavigation_Params)
275 // The request method: GET, POST, etc.
276 IPC_STRUCT_MEMBER(std::string, method)
278 // The requested URL.
279 IPC_STRUCT_MEMBER(GURL, url)
281 // The referrer to use (may be empty).
282 IPC_STRUCT_MEMBER(GURL, referrer)
284 // The referrer policy to use.
285 IPC_STRUCT_MEMBER(blink::WebReferrerPolicy, referrer_policy)
287 // Additional HTTP request headers.
288 IPC_STRUCT_MEMBER(std::string, headers)
290 // net::URLRequest load flags (net::LOAD_NORMAL) by default).
291 IPC_STRUCT_MEMBER(int, load_flags)
293 // Optional resource request body (may be null).
294 IPC_STRUCT_MEMBER(scoped_refptr<content::ResourceRequestBody>,
297 // True if the request was user initiated.
298 IPC_STRUCT_MEMBER(bool, has_user_gesture)
300 IPC_STRUCT_MEMBER(content::PageTransition, transition_type)
302 // Whether this navigation should replace the current session history entry on
304 IPC_STRUCT_MEMBER(bool, should_replace_current_entry)
306 // Whether or not we should allow the URL to download.
307 IPC_STRUCT_MEMBER(bool, allow_download)
310 // -----------------------------------------------------------------------------
311 // Messages sent from the browser to the renderer.
313 // When HW accelerated buffers are swapped in an out-of-process child frame
314 // renderer, the message is forwarded to the embedding frame to notify it of
315 // a new texture available for compositing. When the buffer has finished
316 // presenting, a FrameHostMsg_BuffersSwappedACK should be sent back to
317 // gpu host that produced this buffer.
319 // This is used in the non-ubercomp HW accelerated compositing path.
320 IPC_MESSAGE_ROUTED1(FrameMsg_BuffersSwapped,
321 FrameMsg_BuffersSwapped_Params /* params */)
323 // Notifies the embedding frame that a new CompositorFrame is ready to be
324 // presented. When the frame finishes presenting, a matching
325 // FrameHostMsg_CompositorFrameSwappedACK should be sent back to the
326 // RenderViewHost that was produced the CompositorFrame.
328 // This is used in the ubercomp compositing path.
329 IPC_MESSAGE_ROUTED1(FrameMsg_CompositorFrameSwapped,
330 FrameMsg_CompositorFrameSwapped_Params /* params */)
332 // Notifies the embedding frame that the process rendering the child frame's
333 // contents has terminated.
334 IPC_MESSAGE_ROUTED0(FrameMsg_ChildFrameProcessGone)
336 // Sent in response to a FrameHostMsg_ContextMenu to let the renderer know that
337 // the menu has been closed.
338 IPC_MESSAGE_ROUTED1(FrameMsg_ContextMenuClosed,
339 content::CustomContextMenuContext /* custom_context */)
341 // Executes custom context menu action that was provided from Blink.
342 IPC_MESSAGE_ROUTED2(FrameMsg_CustomContextMenuAction,
343 content::CustomContextMenuContext /* custom_context */,
344 unsigned /* action */)
346 // Instructs the renderer to create a new RenderFrame object with |routing_id|.
347 // The new frame should be created as a child of the object identified by
348 // |parent_routing_id| or as top level if that is MSG_ROUTING_NONE.
349 IPC_MESSAGE_CONTROL2(FrameMsg_NewFrame,
350 int /* routing_id */,
351 int /* parent_routing_id */)
353 // Instructs the renderer to create a new RenderFrameProxy object with
354 // |routing_id|. The new proxy should be created as a child of the object
355 // identified by |parent_routing_id| or as top level if that is
357 IPC_MESSAGE_CONTROL3(FrameMsg_NewFrameProxy,
358 int /* routing_id */,
359 int /* parent_routing_id */,
360 int /* render_view_routing_id */)
362 // Tells the renderer to perform the specified navigation, interrupting any
363 // existing navigation.
364 IPC_MESSAGE_ROUTED1(FrameMsg_Navigate, FrameMsg_Navigate_Params)
366 // Instructs the renderer to invoke the frame's beforeunload event handler.
367 // Expects the result to be returned via FrameHostMsg_BeforeUnload_ACK.
368 IPC_MESSAGE_ROUTED0(FrameMsg_BeforeUnload)
370 // Instructs the frame to swap out for a cross-site transition, including
371 // running the unload event handler and creating a RenderFrameProxy with the
372 // given |proxy_routing_id|. Expects a SwapOut_ACK message when finished.
373 IPC_MESSAGE_ROUTED1(FrameMsg_SwapOut,
374 int /* proxy_routing_id */)
376 // Request for the renderer to insert CSS into the frame.
377 IPC_MESSAGE_ROUTED1(FrameMsg_CSSInsertRequest,
378 std::string /* css */)
380 // Request for the renderer to execute JavaScript in the frame's context.
382 // javascript is the string containing the JavaScript to be executed in the
383 // target frame's context.
385 // If the third parameter is true the result is sent back to the browser using
386 // the message FrameHostMsg_JavaScriptExecuteResponse.
387 // FrameHostMsg_JavaScriptExecuteResponse is passed the ID parameter so that the
388 // host can uniquely identify the request.
389 IPC_MESSAGE_ROUTED3(FrameMsg_JavaScriptExecuteRequest,
390 base::string16, /* javascript */
392 bool /* if true, a reply is requested */)
394 // Selects between the given start and end offsets in the currently focused
396 IPC_MESSAGE_ROUTED2(FrameMsg_SetEditableSelectionOffsets,
400 // Requests a navigation to the supplied markup, in an iframe with sandbox
402 IPC_MESSAGE_ROUTED1(FrameMsg_SetupTransitionView,
403 std::string /* markup */)
405 // Tells the renderer to hide the elements specified by the supplied CSS
406 // selector, and activates any exiting-transition stylesheets.
407 IPC_MESSAGE_ROUTED1(FrameMsg_BeginExitTransition,
408 std::string /* css_selector */)
410 // Tells the renderer to reload the frame, optionally ignoring the cache while
412 IPC_MESSAGE_ROUTED1(FrameMsg_Reload,
413 bool /* ignore_cache */)
415 // Notifies the color chooser client that the user selected a color.
416 IPC_MESSAGE_ROUTED2(FrameMsg_DidChooseColorResponse, unsigned, SkColor)
418 // Notifies the color chooser client that the color chooser has ended.
419 IPC_MESSAGE_ROUTED1(FrameMsg_DidEndColorChooser, unsigned)
421 // Notifies the corresponding RenderFrameProxy object to replace itself with the
422 // RenderFrame object it is associated with.
423 IPC_MESSAGE_ROUTED0(FrameMsg_DeleteProxy)
425 // Request the text surrounding the selection with a |max_length|. The response
426 // will be sent via FrameHostMsg_TextSurroundingSelectionResponse.
427 IPC_MESSAGE_ROUTED1(FrameMsg_TextSurroundingSelectionRequest,
428 size_t /* max_length */)
430 // Tells the renderer to insert a link to the specified stylesheet. This is
431 // needed to support navigation transitions.
432 IPC_MESSAGE_ROUTED1(FrameMsg_AddStyleSheetByURL, std::string)
434 // Change the accessibility mode in the renderer process.
435 IPC_MESSAGE_ROUTED1(FrameMsg_SetAccessibilityMode,
438 // -----------------------------------------------------------------------------
439 // Messages sent from the renderer to the browser.
441 // Blink and JavaScript error messages to log to the console
443 IPC_MESSAGE_ROUTED4(FrameHostMsg_AddMessageToConsole,
444 int32, /* log level */
445 base::string16, /* msg */
446 int32, /* line number */
447 base::string16 /* source id */ )
449 // Sent by the renderer when a child frame is created in the renderer.
451 // Each of these messages will have a corresponding FrameHostMsg_Detach message
452 // sent when the frame is detached from the DOM.
453 IPC_SYNC_MESSAGE_CONTROL2_1(FrameHostMsg_CreateChildFrame,
454 int32 /* parent_routing_id */,
455 std::string /* frame_name */,
456 int32 /* new_routing_id */)
458 // Sent by the renderer to the parent RenderFrameHost when a child frame is
459 // detached from the DOM.
460 IPC_MESSAGE_ROUTED0(FrameHostMsg_Detach)
462 // Sent by the renderer when the frame becomes focused.
463 IPC_MESSAGE_ROUTED0(FrameHostMsg_FrameFocused)
465 // Sent when the renderer starts a provisional load for a frame.
466 // |is_transition_navigation| signals that the frame has defined transition
467 // elements which can be animated by the navigation destination to provide
468 // a transition effect during load.
469 IPC_MESSAGE_ROUTED2(FrameHostMsg_DidStartProvisionalLoadForFrame,
471 bool /* is_transition_navigation */)
473 // Sent when the renderer fails a provisional load with an error.
474 IPC_MESSAGE_ROUTED1(FrameHostMsg_DidFailProvisionalLoadWithError,
475 FrameHostMsg_DidFailProvisionalLoadWithError_Params)
477 // Sent when a provisional load on the main frame redirects.
478 IPC_MESSAGE_ROUTED3(FrameHostMsg_DidRedirectProvisionalLoad,
480 GURL /* source_url*/,
481 GURL /* target_url */)
483 // Notifies the browser that a frame in the view has changed. This message
484 // has a lot of parameters and is packed/unpacked by functions defined in
485 // render_messages.h.
486 IPC_MESSAGE_ROUTED1(FrameHostMsg_DidCommitProvisionalLoad,
487 FrameHostMsg_DidCommitProvisionalLoad_Params)
489 // Notifies the browser that a document has been loaded.
490 IPC_MESSAGE_ROUTED0(FrameHostMsg_DidFinishDocumentLoad)
492 IPC_MESSAGE_ROUTED3(FrameHostMsg_DidFailLoadWithError,
493 GURL /* validated_url */,
494 int /* error_code */,
495 base::string16 /* error_description */)
497 // Sent when the renderer starts loading the page. |to_different_document| will
498 // be true unless the load is a fragment navigation, or triggered by
499 // history.pushState/replaceState.
500 IPC_MESSAGE_ROUTED1(FrameHostMsg_DidStartLoading,
501 bool /* to_different_document */)
503 // Sent when the renderer is done loading a page.
504 IPC_MESSAGE_ROUTED0(FrameHostMsg_DidStopLoading)
506 // Sent when the renderer changed the progress of a load.
507 IPC_MESSAGE_ROUTED1(FrameHostMsg_DidChangeLoadProgress,
508 double /* load_progress */)
510 // Requests that the given URL be opened in the specified manner.
511 IPC_MESSAGE_ROUTED1(FrameHostMsg_OpenURL, FrameHostMsg_OpenURL_Params)
513 // Notifies the browser that a frame finished loading.
514 IPC_MESSAGE_ROUTED1(FrameHostMsg_DidFinishLoad,
515 GURL /* validated_url */)
517 // Sent when after the onload handler has been invoked for the document
518 // in this frame. Sent for top-level frames.
519 IPC_MESSAGE_ROUTED0(FrameHostMsg_DocumentOnLoadCompleted)
521 // Notifies that the initial empty document of a view has been accessed.
522 // After this, it is no longer safe to show a pending navigation's URL without
523 // making a URL spoof possible.
524 IPC_MESSAGE_ROUTED0(FrameHostMsg_DidAccessInitialDocument)
526 // Sent when the frame sets its opener to null, disowning it for the lifetime of
527 // the window. Sent for top-level frames.
528 IPC_MESSAGE_ROUTED0(FrameHostMsg_DidDisownOpener)
530 // Changes the title for the page in the UI when the page is navigated or the
531 // title changes. Sent for top-level frames.
532 IPC_MESSAGE_ROUTED3(FrameHostMsg_UpdateTitle,
534 base::string16 /* title */,
535 blink::WebTextDirection /* title direction */)
537 // Change the encoding name of the page in UI when the page has detected
538 // proper encoding name. Sent for top-level frames.
539 IPC_MESSAGE_ROUTED1(FrameHostMsg_UpdateEncoding,
540 std::string /* new encoding name */)
542 // Following message is used to communicate the values received by the
543 // callback binding the JS to Cpp.
544 // An instance of browser that has an automation host listening to it can
545 // have a javascript send a native value (string, number, boolean) to the
546 // listener in Cpp. (DomAutomationController)
547 IPC_MESSAGE_ROUTED2(FrameHostMsg_DomOperationResponse,
548 std::string /* json_string */,
549 int /* automation_id */)
551 // Sent to the browser when the renderer detects it is blocked on a pepper
552 // plugin message for too long. This is also sent when it becomes unhung
553 // (according to the value of is_hung). The browser can give the user the
554 // option of killing the plugin.
555 IPC_MESSAGE_ROUTED3(FrameHostMsg_PepperPluginHung,
556 int /* plugin_child_id */,
557 base::FilePath /* path */,
560 // Sent by the renderer process to indicate that a plugin instance has crashed.
561 // Note: |plugin_pid| should not be trusted. The corresponding process has
562 // probably died. Moreover, the ID may have been reused by a new process. Any
563 // usage other than displaying it in a prompt to the user is very likely to be
565 IPC_MESSAGE_ROUTED2(FrameHostMsg_PluginCrashed,
566 base::FilePath /* plugin_path */,
567 base::ProcessId /* plugin_pid */)
569 // Return information about a plugin for the given URL and MIME
570 // type. If there is no matching plugin, |found| is false.
571 // |actual_mime_type| is the actual mime type supported by the
573 IPC_SYNC_MESSAGE_CONTROL4_3(FrameHostMsg_GetPluginInfo,
574 int /* render_frame_id */,
577 std::string /* mime_type */,
579 content::WebPluginInfo /* plugin info */,
580 std::string /* actual_mime_type */)
582 // A renderer sends this to the browser process when it wants to
583 // create a plugin. The browser will create the plugin process if
584 // necessary, and will return a handle to the channel on success.
585 // On error an empty string is returned.
586 IPC_SYNC_MESSAGE_CONTROL4_2(FrameHostMsg_OpenChannelToPlugin,
587 int /* render_frame_id */,
590 std::string /* mime_type */,
591 IPC::ChannelHandle /* channel_handle */,
592 content::WebPluginInfo /* info */)
594 // Acknowledge that we presented a HW buffer and provide a sync point
595 // to specify the location in the command stream when the compositor
596 // is no longer using it.
598 // See FrameMsg_BuffersSwapped.
599 IPC_MESSAGE_ROUTED1(FrameHostMsg_BuffersSwappedACK,
600 FrameHostMsg_BuffersSwappedACK_Params /* params */)
602 // Acknowledge that we presented an ubercomp frame.
604 // See FrameMsg_CompositorFrameSwapped
605 IPC_MESSAGE_ROUTED1(FrameHostMsg_CompositorFrameSwappedACK,
606 FrameHostMsg_CompositorFrameSwappedACK_Params /* params */)
608 // Provides the result from handling BeforeUnload. |proceed| matches the return
609 // value of the frame's beforeunload handler: true if the user decided to
610 // proceed with leaving the page.
611 IPC_MESSAGE_ROUTED3(FrameHostMsg_BeforeUnload_ACK,
613 base::TimeTicks /* before_unload_start_time */,
614 base::TimeTicks /* before_unload_end_time */)
616 // Indicates that the current frame has swapped out, after a SwapOut message.
617 IPC_MESSAGE_ROUTED0(FrameHostMsg_SwapOut_ACK)
619 IPC_MESSAGE_ROUTED1(FrameHostMsg_ReclaimCompositorResources,
620 FrameHostMsg_ReclaimCompositorResources_Params /* params */)
622 // Forwards an input event to a child.
623 // TODO(nick): Temporary bridge, revisit once the browser process can route
624 // input directly to subframes. http://crbug.com/339659
625 IPC_MESSAGE_ROUTED1(FrameHostMsg_ForwardInputEvent,
626 IPC::WebInputEventPointer /* event */)
628 // Used to tell the parent that the user right clicked on an area of the
629 // content area, and a context menu should be shown for it. The params
630 // object contains information about the node(s) that were selected when the
631 // user right clicked.
632 IPC_MESSAGE_ROUTED1(FrameHostMsg_ContextMenu, content::ContextMenuParams)
634 // Initial drawing parameters for a child frame that has been swapped out to
636 IPC_MESSAGE_ROUTED2(FrameHostMsg_InitializeChildFrame,
637 gfx::Rect /* frame_rect */,
638 float /* scale_factor */)
640 // Response for FrameMsg_JavaScriptExecuteRequest, sent when a reply was
641 // requested. The ID is the parameter supplied to
642 // FrameMsg_JavaScriptExecuteRequest. The result has the value returned by the
643 // script as its only element, one of Null, Boolean, Integer, Real, Date, or
645 IPC_MESSAGE_ROUTED2(FrameHostMsg_JavaScriptExecuteResponse,
647 base::ListValue /* result */)
649 // A request to run a JavaScript dialog.
650 IPC_SYNC_MESSAGE_ROUTED4_2(FrameHostMsg_RunJavaScriptMessage,
651 base::string16 /* in - alert message */,
652 base::string16 /* in - default prompt */,
653 GURL /* in - originating page URL */,
654 content::JavaScriptMessageType /* in - type */,
655 bool /* out - success */,
656 base::string16 /* out - user_input field */)
658 // Displays a dialog to confirm that the user wants to navigate away from the
659 // page. Replies true if yes, and false otherwise. The reply string is ignored,
660 // but is included so that we can use OnJavaScriptMessageBoxClosed.
661 IPC_SYNC_MESSAGE_ROUTED3_2(FrameHostMsg_RunBeforeUnloadConfirm,
662 GURL, /* in - originating frame URL */
663 base::string16 /* in - alert message */,
664 bool /* in - is a reload */,
665 bool /* out - success */,
666 base::string16 /* out - This is ignored.*/)
668 // Asks the browser to open the color chooser.
669 IPC_MESSAGE_ROUTED3(FrameHostMsg_OpenColorChooser,
672 std::vector<content::ColorSuggestion> /* suggestions */)
674 // Asks the browser to end the color chooser.
675 IPC_MESSAGE_ROUTED1(FrameHostMsg_EndColorChooser, int /* id */)
677 // Change the selected color in the color chooser.
678 IPC_MESSAGE_ROUTED2(FrameHostMsg_SetSelectedColorInColorChooser,
682 // Notifies the browser that media has started/stopped playing.
683 IPC_MESSAGE_ROUTED3(FrameHostMsg_MediaPlayingNotification,
684 int64 /* player_cookie, distinguishes instances */,
685 bool /* has_video */,
686 bool /* has_audio */)
688 IPC_MESSAGE_ROUTED1(FrameHostMsg_MediaPausedNotification,
689 int64 /* player_cookie, distinguishes instances */)
691 // Notify browser the theme color has been changed.
692 IPC_MESSAGE_ROUTED1(FrameHostMsg_DidChangeThemeColor,
693 SkColor /* theme_color */)
695 // Response for FrameMsg_TextSurroundingSelectionRequest, |startOffset| and
696 // |endOffset| are the offsets of the selection in the returned |content|.
697 IPC_MESSAGE_ROUTED3(FrameHostMsg_TextSurroundingSelectionResponse,
698 base::string16, /* content */
699 size_t, /* startOffset */
700 size_t /* endOffset */)
702 // Notifies the browser that the renderer has a pending navigation transition.
703 // The string parameters are all UTF8.
704 IPC_MESSAGE_CONTROL4(FrameHostMsg_AddNavigationTransitionData,
705 int /* render_frame_id */,
706 std::string /* allowed_destination_host_pattern */,
707 std::string /* selector */,
708 std::string /* markup */)
710 // Tells the browser to perform a navigation.
711 IPC_MESSAGE_ROUTED1(FrameHostMsg_BeginNavigation,
712 FrameHostMsg_BeginNavigation_Params)
714 // Sent once a paint happens after the first non empty layout. In other words
715 // after the frame has painted something.
716 IPC_MESSAGE_ROUTED0(FrameHostMsg_DidFirstVisuallyNonEmptyPaint)