content/common/frame_messages.h

   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.
   4
   5 // IPC messages for interacting with frames.
   6 // Multiply-included message file, hence no include guard.
   7
   8 #include "cc/surfaces/surface_id.h"
   9 #include "cc/surfaces/surface_sequence.h"
  10 #include "content/common/content_export.h"
  11 #include "content/common/content_param_traits.h"
  12 #include "content/common/frame_message_enums.h"
  13 #include "content/common/frame_param.h"
  14 #include "content/common/frame_replication_state.h"
  15 #include "content/common/navigation_gesture.h"
  16 #include "content/common/navigation_params.h"
  17 #include "content/common/resource_request_body.h"
  18 #include "content/public/common/color_suggestion.h"
  19 #include "content/public/common/common_param_traits.h"
  20 #include "content/public/common/console_message_level.h"
  21 #include "content/public/common/context_menu_params.h"
  22 #include "content/public/common/frame_navigate_params.h"
  23 #include "content/public/common/javascript_message_type.h"
  24 #include "content/public/common/message_port_types.h"
  25 #include "content/public/common/page_state.h"
  26 #include "content/public/common/resource_response.h"
  27 #include "content/public/common/transition_element.h"
  28 #include "ipc/ipc_message_macros.h"
  29 #include "third_party/WebKit/public/web/WebTreeScopeType.h"
  30 #include "ui/gfx/ipc/gfx_param_traits.h"
  31 #include "url/gurl.h"
  32 #include "url/origin.h"
  33
  34 #undef IPC_MESSAGE_EXPORT
  35 #define IPC_MESSAGE_EXPORT CONTENT_EXPORT
  36
  37 #define IPC_MESSAGE_START FrameMsgStart
  38
  39 IPC_ENUM_TRAITS_MIN_MAX_VALUE(AccessibilityMode,
  40                               AccessibilityModeOff,
  41                               AccessibilityModeComplete)
  42 IPC_ENUM_TRAITS_MIN_MAX_VALUE(content::JavaScriptMessageType,
  43                               content::JAVASCRIPT_MESSAGE_TYPE_ALERT,
  44                               content::JAVASCRIPT_MESSAGE_TYPE_PROMPT)
  45 IPC_ENUM_TRAITS_MAX_VALUE(FrameMsg_Navigate_Type::Value,
  46                           FrameMsg_Navigate_Type::NAVIGATE_TYPE_LAST)
  47 IPC_ENUM_TRAITS_MAX_VALUE(FrameMsg_UILoadMetricsReportType::Value,
  48                           FrameMsg_UILoadMetricsReportType::REPORT_TYPE_LAST)
  49 IPC_ENUM_TRAITS_MAX_VALUE(blink::WebContextMenuData::MediaType,
  50                           blink::WebContextMenuData::MediaTypeLast)
  51 IPC_ENUM_TRAITS_MAX_VALUE(blink::WebContextMenuData::InputFieldType,
  52                           blink::WebContextMenuData::InputFieldTypeLast)
  53 IPC_ENUM_TRAITS(blink::WebSandboxFlags)  // Bitmask.
  54 IPC_ENUM_TRAITS_MAX_VALUE(blink::WebTreeScopeType,
  55                           blink::WebTreeScopeType::Last)
  56 IPC_ENUM_TRAITS_MAX_VALUE(ui::MenuSourceType, ui::MENU_SOURCE_TYPE_LAST)
  57
  58 IPC_STRUCT_TRAITS_BEGIN(content::ColorSuggestion)
  59   IPC_STRUCT_TRAITS_MEMBER(color)
  60   IPC_STRUCT_TRAITS_MEMBER(label)
  61 IPC_STRUCT_TRAITS_END()
  62
  63 IPC_STRUCT_TRAITS_BEGIN(content::ContextMenuParams)
  64   IPC_STRUCT_TRAITS_MEMBER(media_type)
  65   IPC_STRUCT_TRAITS_MEMBER(x)
  66   IPC_STRUCT_TRAITS_MEMBER(y)
  67   IPC_STRUCT_TRAITS_MEMBER(link_url)
  68   IPC_STRUCT_TRAITS_MEMBER(link_text)
  69   IPC_STRUCT_TRAITS_MEMBER(unfiltered_link_url)
  70   IPC_STRUCT_TRAITS_MEMBER(src_url)
  71   IPC_STRUCT_TRAITS_MEMBER(has_image_contents)
  72   IPC_STRUCT_TRAITS_MEMBER(properties)
  73   IPC_STRUCT_TRAITS_MEMBER(page_url)
  74   IPC_STRUCT_TRAITS_MEMBER(keyword_url)
  75   IPC_STRUCT_TRAITS_MEMBER(frame_url)
  76   IPC_STRUCT_TRAITS_MEMBER(frame_page_state)
  77   IPC_STRUCT_TRAITS_MEMBER(media_flags)
  78   IPC_STRUCT_TRAITS_MEMBER(selection_text)
  79   IPC_STRUCT_TRAITS_MEMBER(title_text)
  80   IPC_STRUCT_TRAITS_MEMBER(suggested_filename)
  81   IPC_STRUCT_TRAITS_MEMBER(misspelled_word)
  82   IPC_STRUCT_TRAITS_MEMBER(misspelling_hash)
  83   IPC_STRUCT_TRAITS_MEMBER(dictionary_suggestions)
  84   IPC_STRUCT_TRAITS_MEMBER(spellcheck_enabled)
  85   IPC_STRUCT_TRAITS_MEMBER(is_editable)
  86   IPC_STRUCT_TRAITS_MEMBER(writing_direction_default)
  87   IPC_STRUCT_TRAITS_MEMBER(writing_direction_left_to_right)
  88   IPC_STRUCT_TRAITS_MEMBER(writing_direction_right_to_left)
  89   IPC_STRUCT_TRAITS_MEMBER(edit_flags)
  90   IPC_STRUCT_TRAITS_MEMBER(security_info)
  91   IPC_STRUCT_TRAITS_MEMBER(frame_charset)
  92   IPC_STRUCT_TRAITS_MEMBER(referrer_policy)
  93   IPC_STRUCT_TRAITS_MEMBER(custom_context)
  94   IPC_STRUCT_TRAITS_MEMBER(custom_items)
  95   IPC_STRUCT_TRAITS_MEMBER(source_type)
  96 #if defined(OS_ANDROID)
  97   IPC_STRUCT_TRAITS_MEMBER(selection_start)
  98   IPC_STRUCT_TRAITS_MEMBER(selection_end)
  99 #endif
 100   IPC_STRUCT_TRAITS_MEMBER(input_field_type)
 101 IPC_STRUCT_TRAITS_END()
 102
 103 IPC_STRUCT_TRAITS_BEGIN(content::CustomContextMenuContext)
 104   IPC_STRUCT_TRAITS_MEMBER(is_pepper_menu)
 105   IPC_STRUCT_TRAITS_MEMBER(request_id)
 106   IPC_STRUCT_TRAITS_MEMBER(render_widget_id)
 107   IPC_STRUCT_TRAITS_MEMBER(link_followed)
 108 IPC_STRUCT_TRAITS_END()
 109
 110 IPC_STRUCT_TRAITS_BEGIN(content::TransitionElement)
 111   IPC_STRUCT_TRAITS_MEMBER(id)
 112   IPC_STRUCT_TRAITS_MEMBER(rect)
 113 IPC_STRUCT_TRAITS_END()
 114
 115
 116 IPC_STRUCT_BEGIN(FrameHostMsg_DidFailProvisionalLoadWithError_Params)
 117   // Error code as reported in the DidFailProvisionalLoad callback.
 118   IPC_STRUCT_MEMBER(int, error_code)
 119   // An error message generated from the error_code. This can be an empty
 120   // string if we were unable to find a meaningful description.
 121   IPC_STRUCT_MEMBER(base::string16, error_description)
 122   // The URL that the error is reported for.
 123   IPC_STRUCT_MEMBER(GURL, url)
 124   // True if the failure is the result of navigating to a POST again
 125   // and we're going to show the POST interstitial.
 126   IPC_STRUCT_MEMBER(bool, showing_repost_interstitial)
 127 IPC_STRUCT_END()
 128
 129 IPC_STRUCT_TRAITS_BEGIN(content::FrameNavigateParams)
 130   IPC_STRUCT_TRAITS_MEMBER(page_id)
 131   IPC_STRUCT_TRAITS_MEMBER(nav_entry_id)
 132   IPC_STRUCT_TRAITS_MEMBER(url)
 133   IPC_STRUCT_TRAITS_MEMBER(base_url)
 134   IPC_STRUCT_TRAITS_MEMBER(referrer)
 135   IPC_STRUCT_TRAITS_MEMBER(transition)
 136   IPC_STRUCT_TRAITS_MEMBER(redirects)
 137   IPC_STRUCT_TRAITS_MEMBER(should_update_history)
 138   IPC_STRUCT_TRAITS_MEMBER(searchable_form_url)
 139   IPC_STRUCT_TRAITS_MEMBER(searchable_form_encoding)
 140   IPC_STRUCT_TRAITS_MEMBER(contents_mime_type)
 141   IPC_STRUCT_TRAITS_MEMBER(socket_address)
 142 IPC_STRUCT_TRAITS_END()
 143
 144 // Parameters structure for FrameHostMsg_DidCommitProvisionalLoad, which has
 145 // too many data parameters to be reasonably put in a predefined IPC message.
 146 IPC_STRUCT_BEGIN_WITH_PARENT(FrameHostMsg_DidCommitProvisionalLoad_Params,
 147                              content::FrameNavigateParams)
 148   IPC_STRUCT_TRAITS_PARENT(content::FrameNavigateParams)
 149
 150   // This is the value from the browser (copied from the navigation request)
 151   // indicating whether it intended to make a new entry. TODO(avi): Remove this
 152   // when the pending entry situation is made sane and the browser keeps them
 153   // around long enough to match them via nav_entry_id.
 154   IPC_STRUCT_MEMBER(bool, intended_as_new_entry)
 155
 156   // Whether this commit created a new entry.
 157   IPC_STRUCT_MEMBER(bool, did_create_new_entry)
 158
 159   // Information regarding the security of the connection (empty if the
 160   // connection was not secure).
 161   IPC_STRUCT_MEMBER(std::string, security_info)
 162
 163   // The gesture that initiated this navigation.
 164   IPC_STRUCT_MEMBER(content::NavigationGesture, gesture)
 165
 166   // True if this was a post request.
 167   IPC_STRUCT_MEMBER(bool, is_post)
 168
 169   // The POST body identifier. -1 if it doesn't exist.
 170   IPC_STRUCT_MEMBER(int64, post_id)
 171
 172   // Whether the frame navigation resulted in no change to the documents within
 173   // the page. For example, the navigation may have just resulted in scrolling
 174   // to a named anchor.
 175   IPC_STRUCT_MEMBER(bool, was_within_same_page)
 176
 177   // The status code of the HTTP request.
 178   IPC_STRUCT_MEMBER(int, http_status_code)
 179
 180   // This flag is used to warn if the renderer is displaying an error page,
 181   // so that we can set the appropriate page type.
 182   IPC_STRUCT_MEMBER(bool, url_is_unreachable)
 183
 184   // True if the connection was proxied.  In this case, socket_address
 185   // will represent the address of the proxy, rather than the remote host.
 186   IPC_STRUCT_MEMBER(bool, was_fetched_via_proxy)
 187
 188   // Serialized history item state to store in the navigation entry.
 189   IPC_STRUCT_MEMBER(content::PageState, page_state)
 190
 191   // Original request's URL.
 192   IPC_STRUCT_MEMBER(GURL, original_request_url)
 193
 194   // User agent override used to navigate.
 195   IPC_STRUCT_MEMBER(bool, is_overriding_user_agent)
 196
 197   // Notifies the browser that for this navigation, the session history was
 198   // successfully cleared.
 199   IPC_STRUCT_MEMBER(bool, history_list_was_cleared)
 200
 201   // The routing_id of the render view associated with the navigation.
 202   // We need to track the RenderViewHost routing_id because of downstream
 203   // dependencies (crbug.com/392171 DownloadRequestHandle, SaveFileManager,
 204   // ResourceDispatcherHostImpl, MediaStreamUIProxy,
 205   // SpeechRecognitionDispatcherHost and possibly others). They look up the view
 206   // based on the ID stored in the resource requests. Once those dependencies
 207   // are unwound or moved to RenderFrameHost (crbug.com/304341) we can move the
 208   // client to be based on the routing_id of the RenderFrameHost.
 209   IPC_STRUCT_MEMBER(int, render_view_routing_id)
 210
 211   // Origin of the frame.  This will be replicated to any associated
 212   // RenderFrameProxies.
 213   IPC_STRUCT_MEMBER(url::Origin, origin)
 214
 215   // How navigation metrics starting on UI action for this load should be
 216   // reported.
 217   IPC_STRUCT_MEMBER(FrameMsg_UILoadMetricsReportType::Value, report_type)
 218
 219   // Timestamp at which the UI action that triggered the navigation originated.
 220   IPC_STRUCT_MEMBER(base::TimeTicks, ui_timestamp)
 221 IPC_STRUCT_END()
 222
 223 IPC_STRUCT_BEGIN(FrameMsg_PostMessage_Params)
 224   // Whether the data format is supplied as serialized script value, or as
 225   // a simple string. If it is a raw string, must be converted from string to a
 226   // WebSerializedScriptValue in the renderer process.
 227   IPC_STRUCT_MEMBER(bool, is_data_raw_string)
 228
 229   // The serialized script value.
 230   IPC_STRUCT_MEMBER(base::string16, data)
 231
 232   // When sent to the browser, this is the routing ID of the source frame in
 233   // the source process.  The browser replaces it with the routing ID of the
 234   // equivalent frame proxy in the destination process.
 235   IPC_STRUCT_MEMBER(int, source_routing_id)
 236
 237   // When sent from the browser, this is the routing ID of the source view in
 238   // the destination process.  This currently exists only to support legacy
 239   // postMessage to Android WebView and will be removed once crbug.com/473258
 240   // is fixed.
 241   IPC_STRUCT_MEMBER(int, source_view_routing_id)
 242
 243   // The origin of the source frame.
 244   IPC_STRUCT_MEMBER(base::string16, source_origin)
 245
 246   // The origin for the message's target.
 247   IPC_STRUCT_MEMBER(base::string16, target_origin)
 248
 249   // Information about the MessagePorts this message contains.
 250   IPC_STRUCT_MEMBER(std::vector<content::TransferredMessagePort>, message_ports)
 251   IPC_STRUCT_MEMBER(std::vector<int>, new_routing_ids)
 252 IPC_STRUCT_END()
 253
 254 IPC_STRUCT_TRAITS_BEGIN(content::CommonNavigationParams)
 255   IPC_STRUCT_TRAITS_MEMBER(url)
 256   IPC_STRUCT_TRAITS_MEMBER(referrer)
 257   IPC_STRUCT_TRAITS_MEMBER(transition)
 258   IPC_STRUCT_TRAITS_MEMBER(navigation_type)
 259   IPC_STRUCT_TRAITS_MEMBER(allow_download)
 260   IPC_STRUCT_TRAITS_MEMBER(ui_timestamp)
 261   IPC_STRUCT_TRAITS_MEMBER(report_type)
 262   IPC_STRUCT_TRAITS_MEMBER(base_url_for_data_url)
 263   IPC_STRUCT_TRAITS_MEMBER(history_url_for_data_url)
 264 IPC_STRUCT_TRAITS_END()
 265
 266 IPC_STRUCT_TRAITS_BEGIN(content::BeginNavigationParams)
 267   IPC_STRUCT_TRAITS_MEMBER(method)
 268   IPC_STRUCT_TRAITS_MEMBER(headers)
 269   IPC_STRUCT_TRAITS_MEMBER(load_flags)
 270   IPC_STRUCT_TRAITS_MEMBER(has_user_gesture)
 271 IPC_STRUCT_TRAITS_END()
 272
 273 IPC_STRUCT_TRAITS_BEGIN(content::StartNavigationParams)
 274   IPC_STRUCT_TRAITS_MEMBER(is_post)
 275   IPC_STRUCT_TRAITS_MEMBER(extra_headers)
 276   IPC_STRUCT_TRAITS_MEMBER(browser_initiated_post_data)
 277   IPC_STRUCT_TRAITS_MEMBER(should_replace_current_entry)
 278   IPC_STRUCT_TRAITS_MEMBER(transferred_request_child_id)
 279   IPC_STRUCT_TRAITS_MEMBER(transferred_request_request_id)
 280 IPC_STRUCT_TRAITS_END()
 281
 282 IPC_STRUCT_TRAITS_BEGIN(content::RequestNavigationParams)
 283   IPC_STRUCT_TRAITS_MEMBER(is_overriding_user_agent)
 284   IPC_STRUCT_TRAITS_MEMBER(browser_navigation_start)
 285   IPC_STRUCT_TRAITS_MEMBER(redirects)
 286   IPC_STRUCT_TRAITS_MEMBER(can_load_local_resources)
 287   IPC_STRUCT_TRAITS_MEMBER(request_time)
 288   IPC_STRUCT_TRAITS_MEMBER(page_state)
 289   IPC_STRUCT_TRAITS_MEMBER(page_id)
 290   IPC_STRUCT_TRAITS_MEMBER(nav_entry_id)
 291   IPC_STRUCT_TRAITS_MEMBER(has_committed_real_load)
 292   IPC_STRUCT_TRAITS_MEMBER(intended_as_new_entry)
 293   IPC_STRUCT_TRAITS_MEMBER(pending_history_list_offset)
 294   IPC_STRUCT_TRAITS_MEMBER(current_history_list_offset)
 295   IPC_STRUCT_TRAITS_MEMBER(current_history_list_length)
 296   IPC_STRUCT_TRAITS_MEMBER(should_clear_history_list)
 297 IPC_STRUCT_TRAITS_END()
 298
 299 IPC_STRUCT_TRAITS_BEGIN(content::FrameReplicationState)
 300   IPC_STRUCT_TRAITS_MEMBER(origin)
 301   IPC_STRUCT_TRAITS_MEMBER(sandbox_flags)
 302   IPC_STRUCT_TRAITS_MEMBER(name)
 303 IPC_STRUCT_TRAITS_END()
 304
 305 IPC_STRUCT_BEGIN(FrameMsg_NewFrame_WidgetParams)
 306   // Gives the routing ID for the RenderWidget that will be attached to the
 307   // new RenderFrame. If the RenderFrame does not need a RenderWidget, this
 308   // is MSG_ROUTING_NONE and the other parameters are not read.
 309   IPC_STRUCT_MEMBER(int, routing_id)
 310
 311   // Identifier for the output surface for the new RenderWidget.
 312   IPC_STRUCT_MEMBER(int, surface_id)
 313
 314   // Tells the new RenderWidget whether it is initially hidden.
 315   IPC_STRUCT_MEMBER(bool, hidden)
 316 IPC_STRUCT_END()
 317
 318 IPC_STRUCT_BEGIN(FrameMsg_NewFrame_Params)
 319   // Specifies the routing ID of the new RenderFrame object.
 320   IPC_STRUCT_MEMBER(int, routing_id)
 321
 322   // The new frame should be created as a child of the object
 323   // identified by |parent_routing_id| or as top level if that is
 324   // MSG_ROUTING_NONE.
 325   IPC_STRUCT_MEMBER(int, parent_routing_id)
 326
 327   // Identifies the previous sibling of the new frame, so that the new frame is
 328   // inserted into the correct place in the frame tree.  If this is
 329   // MSG_ROUTING_NONE, the frame will be created as the leftmost child of its
 330   // parent frame, in front of any other children.
 331   IPC_STRUCT_MEMBER(int, previous_sibling_routing_id)
 332
 333   // If a valid |proxy_routing_id| is provided, the new frame will be
 334   // configured to replace the proxy on commit.
 335   IPC_STRUCT_MEMBER(int, proxy_routing_id)
 336
 337   // When the new frame has a parent, |replication_state| holds the new frame's
 338   // properties replicated from the process rendering the parent frame, such as
 339   // the new frame's sandbox flags.
 340   IPC_STRUCT_MEMBER(content::FrameReplicationState, replication_state)
 341
 342   // Specifies properties for a new RenderWidget that will be attached to the
 343   // new RenderFrame (if one is needed).
 344   IPC_STRUCT_MEMBER(FrameMsg_NewFrame_WidgetParams, widget_params)
 345 IPC_STRUCT_END()
 346
 347 IPC_STRUCT_BEGIN(FrameHostMsg_OpenURL_Params)
 348   IPC_STRUCT_MEMBER(GURL, url)
 349   IPC_STRUCT_MEMBER(content::Referrer, referrer)
 350   IPC_STRUCT_MEMBER(WindowOpenDisposition, disposition)
 351   IPC_STRUCT_MEMBER(bool, should_replace_current_entry)
 352   IPC_STRUCT_MEMBER(bool, user_gesture)
 353 IPC_STRUCT_END()
 354
 355 IPC_STRUCT_BEGIN(FrameMsg_TextTrackSettings_Params)
 356   // Background color of the text track.
 357   IPC_STRUCT_MEMBER(std::string, text_track_background_color)
 358
 359   // Font family of the text track text.
 360   IPC_STRUCT_MEMBER(std::string, text_track_font_family)
 361
 362   // Font style of the text track text.
 363   IPC_STRUCT_MEMBER(std::string, text_track_font_style)
 364
 365   // Font variant of the text track text.
 366   IPC_STRUCT_MEMBER(std::string, text_track_font_variant)
 367
 368   // Color of the text track text.
 369   IPC_STRUCT_MEMBER(std::string, text_track_text_color)
 370
 371   // Text shadow (edge style) of the text track text.
 372   IPC_STRUCT_MEMBER(std::string, text_track_text_shadow)
 373
 374   // Size of the text track text.
 375   IPC_STRUCT_MEMBER(std::string, text_track_text_size)
 376 IPC_STRUCT_END()
 377
 378 #if defined(OS_MACOSX) || defined(OS_ANDROID)
 379 // This message is used for supporting popup menus on Mac OS X and Android using
 380 // native controls. See the FrameHostMsg_ShowPopup message.
 381 IPC_STRUCT_BEGIN(FrameHostMsg_ShowPopup_Params)
 382   // Position on the screen.
 383   IPC_STRUCT_MEMBER(gfx::Rect, bounds)
 384
 385   // The height of each item in the menu.
 386   IPC_STRUCT_MEMBER(int, item_height)
 387
 388   // The size of the font to use for those items.
 389   IPC_STRUCT_MEMBER(double, item_font_size)
 390
 391   // The currently selected (displayed) item in the menu.
 392   IPC_STRUCT_MEMBER(int, selected_item)
 393
 394   // The entire list of items in the popup menu.
 395   IPC_STRUCT_MEMBER(std::vector<content::MenuItem>, popup_items)
 396
 397   // Whether items should be right-aligned.
 398   IPC_STRUCT_MEMBER(bool, right_aligned)
 399
 400   // Whether this is a multi-select popup.
 401   IPC_STRUCT_MEMBER(bool, allow_multiple_selection)
 402 IPC_STRUCT_END()
 403 #endif
 404
 405 // -----------------------------------------------------------------------------
 406 // Messages sent from the browser to the renderer.
 407
 408 // Notifies the embedding frame that a new CompositorFrame is ready to be
 409 // presented. When the frame finishes presenting, a matching
 410 // FrameHostMsg_CompositorFrameSwappedACK should be sent back to the
 411 // RenderViewHost that was produced the CompositorFrame.
 412 //
 413 // This is used in the ubercomp compositing path.
 414 IPC_MESSAGE_ROUTED1(FrameMsg_CompositorFrameSwapped,
 415                     FrameMsg_CompositorFrameSwapped_Params /* params */)
 416
 417 IPC_MESSAGE_ROUTED4(FrameMsg_SetChildFrameSurface,
 418                     cc::SurfaceId /* surface_id */,
 419                     gfx::Size /* frame_size */,
 420                     float /* scale_factor */,
 421                     cc::SurfaceSequence /* sequence */)
 422
 423 // Notifies the embedding frame that the process rendering the child frame's
 424 // contents has terminated.
 425 IPC_MESSAGE_ROUTED0(FrameMsg_ChildFrameProcessGone)
 426
 427 // Sent in response to a FrameHostMsg_ContextMenu to let the renderer know that
 428 // the menu has been closed.
 429 IPC_MESSAGE_ROUTED1(FrameMsg_ContextMenuClosed,
 430                     content::CustomContextMenuContext /* custom_context */)
 431
 432 // Executes custom context menu action that was provided from Blink.
 433 IPC_MESSAGE_ROUTED2(FrameMsg_CustomContextMenuAction,
 434                     content::CustomContextMenuContext /* custom_context */,
 435                     unsigned /* action */)
 436
 437 // Requests that the RenderFrame or RenderFrameProxy sets its opener to null.
 438 IPC_MESSAGE_ROUTED0(FrameMsg_DisownOpener)
 439
 440 // Requests that the RenderFrame send back a response after waiting for the
 441 // commit, activation and frame swap of the current DOM tree in blink.
 442 IPC_MESSAGE_ROUTED1(FrameMsg_VisualStateRequest, uint64 /* id */)
 443
 444 // Instructs the renderer to create a new RenderFrame object.
 445 IPC_MESSAGE_CONTROL1(FrameMsg_NewFrame, FrameMsg_NewFrame_Params /* params */)
 446
 447 // Instructs the renderer to create a new RenderFrameProxy object with
 448 // |routing_id|. The new proxy should be created as a child of the object
 449 // identified by |parent_routing_id| or as top level if that is
 450 // MSG_ROUTING_NONE.
 451 IPC_MESSAGE_CONTROL4(FrameMsg_NewFrameProxy,
 452                      int /* routing_id */,
 453                      int /* parent_routing_id */,
 454                      int /* render_view_routing_id */,
 455                      content::FrameReplicationState /* replication_state */)
 456
 457 // Tells the renderer to perform the specified navigation, interrupting any
 458 // existing navigation.
 459 IPC_MESSAGE_ROUTED3(FrameMsg_Navigate,
 460                     content::CommonNavigationParams, /* common_params */
 461                     content::StartNavigationParams,  /* start_params */
 462                     content::RequestNavigationParams /* request_params */)
 463
 464 // Instructs the renderer to invoke the frame's beforeunload event handler.
 465 // Expects the result to be returned via FrameHostMsg_BeforeUnload_ACK.
 466 IPC_MESSAGE_ROUTED0(FrameMsg_BeforeUnload)
 467
 468 // Instructs the frame to swap out for a cross-site transition, including
 469 // running the unload event handler and creating a RenderFrameProxy with the
 470 // given |proxy_routing_id|. Expects a SwapOut_ACK message when finished.
 471 IPC_MESSAGE_ROUTED3(FrameMsg_SwapOut,
 472                     int /* proxy_routing_id */,
 473                     bool /* is_loading */,
 474                     content::FrameReplicationState /* replication_state */)
 475
 476 // Instructs the frame to stop the load in progress, if any.
 477 IPC_MESSAGE_ROUTED0(FrameMsg_Stop)
 478
 479 // A message sent to RenderFrameProxy to indicate that its corresponding
 480 // RenderFrame has started loading a document.
 481 IPC_MESSAGE_ROUTED0(FrameMsg_DidStartLoading)
 482
 483 // A message sent to RenderFrameProxy to indicate that its corresponding
 484 // RenderFrame has completed loading.
 485 IPC_MESSAGE_ROUTED0(FrameMsg_DidStopLoading)
 486
 487 // Request for the renderer to insert CSS into the frame.
 488 IPC_MESSAGE_ROUTED1(FrameMsg_CSSInsertRequest,
 489                     std::string  /* css */)
 490
 491 // Add message to the devtools console.
 492 IPC_MESSAGE_ROUTED2(FrameMsg_AddMessageToConsole,
 493                     content::ConsoleMessageLevel /* level */,
 494                     std::string /* message */)
 495
 496 // Request for the renderer to execute JavaScript in the frame's context.
 497 //
 498 // javascript is the string containing the JavaScript to be executed in the
 499 // target frame's context.
 500 //
 501 // If the third parameter is true the result is sent back to the browser using
 502 // the message FrameHostMsg_JavaScriptExecuteResponse.
 503 // FrameHostMsg_JavaScriptExecuteResponse is passed the ID parameter so that the
 504 // host can uniquely identify the request.
 505 IPC_MESSAGE_ROUTED3(FrameMsg_JavaScriptExecuteRequest,
 506                     base::string16,  /* javascript */
 507                     int,  /* ID */
 508                     bool  /* if true, a reply is requested */)
 509
 510 // ONLY FOR TESTS: Same as above but adds a fake UserGestureindicator around
 511 // execution. (crbug.com/408426)
 512 IPC_MESSAGE_ROUTED4(FrameMsg_JavaScriptExecuteRequestForTests,
 513                     base::string16,  /* javascript */
 514                     int,  /* ID */
 515                     bool, /* if true, a reply is requested */
 516                     bool  /* if true, a user gesture indicator is created */)
 517
 518 // Same as FrameMsg_JavaScriptExecuteRequest above except the script is
 519 // run in the isolated world specified by the fourth parameter.
 520 IPC_MESSAGE_ROUTED4(FrameMsg_JavaScriptExecuteRequestInIsolatedWorld,
 521                     base::string16, /* javascript */
 522                     int, /* ID */
 523                     bool, /* if true, a reply is requested */
 524                     int /* world_id */)
 525
 526 // Selects between the given start and end offsets in the currently focused
 527 // editable field.
 528 IPC_MESSAGE_ROUTED2(FrameMsg_SetEditableSelectionOffsets,
 529                     int /* start */,
 530                     int /* end */)
 531
 532 // Requests a navigation to the supplied markup, in an iframe with sandbox
 533 // attributes.
 534 IPC_MESSAGE_ROUTED1(FrameMsg_SetupTransitionView,
 535                     std::string /* markup */)
 536
 537 // Tells the renderer to hide the elements specified by the supplied CSS
 538 // selector, and activates any exiting-transition stylesheets.
 539 IPC_MESSAGE_ROUTED2(FrameMsg_BeginExitTransition,
 540                     std::string /* css_selector */,
 541                     bool /* exit_to_native_app */)
 542
 543 // Tell the renderer to revert the exit transition done before
 544 IPC_MESSAGE_ROUTED0(FrameMsg_RevertExitTransition)
 545
 546 // Tell the renderer to hide transition elements.
 547 IPC_MESSAGE_ROUTED1(FrameMsg_HideTransitionElements,
 548                     std::string /* css_selector */)
 549
 550 // Tell the renderer to hide transition elements.
 551 IPC_MESSAGE_ROUTED1(FrameMsg_ShowTransitionElements,
 552                     std::string /* css_selector */)
 553
 554 // Tells the renderer to reload the frame, optionally ignoring the cache while
 555 // doing so.
 556 IPC_MESSAGE_ROUTED1(FrameMsg_Reload,
 557                     bool /* ignore_cache */)
 558
 559 // Notifies the color chooser client that the user selected a color.
 560 IPC_MESSAGE_ROUTED2(FrameMsg_DidChooseColorResponse, unsigned, SkColor)
 561
 562 // Notifies the color chooser client that the color chooser has ended.
 563 IPC_MESSAGE_ROUTED1(FrameMsg_DidEndColorChooser, unsigned)
 564
 565 // Notifies the corresponding RenderFrameProxy object to replace itself with the
 566 // RenderFrame object it is associated with.
 567 IPC_MESSAGE_ROUTED0(FrameMsg_DeleteProxy)
 568
 569 // Request the text surrounding the selection with a |max_length|. The response
 570 // will be sent via FrameHostMsg_TextSurroundingSelectionResponse.
 571 IPC_MESSAGE_ROUTED1(FrameMsg_TextSurroundingSelectionRequest,
 572                     size_t /* max_length */)
 573
 574 // Tells the renderer to insert a link to the specified stylesheet. This is
 575 // needed to support navigation transitions.
 576 IPC_MESSAGE_ROUTED1(FrameMsg_AddStyleSheetByURL, std::string)
 577
 578 // Change the accessibility mode in the renderer process.
 579 IPC_MESSAGE_ROUTED1(FrameMsg_SetAccessibilityMode,
 580                     AccessibilityMode)
 581
 582 // Dispatch a load event in the iframe element containing this frame.
 583 IPC_MESSAGE_ROUTED0(FrameMsg_DispatchLoad)
 584
 585 // Notifies the frame that its parent has changed the frame's sandbox flags.
 586 IPC_MESSAGE_ROUTED1(FrameMsg_DidUpdateSandboxFlags, blink::WebSandboxFlags)
 587
 588 // Update a proxy's window.name property.  Used when the frame's name is
 589 // changed in another process.
 590 IPC_MESSAGE_ROUTED1(FrameMsg_DidUpdateName, std::string /* name */)
 591
 592 // Update a proxy's replicated origin.  Used when the frame is navigated to a
 593 // new origin.
 594 IPC_MESSAGE_ROUTED1(FrameMsg_DidUpdateOrigin, url::Origin /* origin */)
 595
 596 // Send to the RenderFrame to set text track style settings.
 597 // Sent for top-level frames.
 598 IPC_MESSAGE_ROUTED1(FrameMsg_SetTextTrackSettings,
 599                     FrameMsg_TextTrackSettings_Params /* params */)
 600
 601 // Posts a message from a frame in another process to the current renderer.
 602 IPC_MESSAGE_ROUTED1(FrameMsg_PostMessageEvent, FrameMsg_PostMessage_Params)
 603
 604 #if defined(OS_ANDROID)
 605
 606 // External popup menus.
 607 IPC_MESSAGE_ROUTED2(FrameMsg_SelectPopupMenuItems,
 608                     bool /* user canceled the popup */,
 609                     std::vector<int> /* selected indices */)
 610
 611 #elif defined(OS_MACOSX)
 612
 613 // External popup menus.
 614 IPC_MESSAGE_ROUTED1(FrameMsg_SelectPopupMenuItem,
 615                     int /* selected index, -1 means no selection */)
 616
 617 #endif
 618
 619 // PlzNavigate
 620 // Tells the renderer that a navigation is ready to commit.  The renderer should
 621 // request |stream_url| to get access to the stream containing the body of the
 622 // response.
 623 IPC_MESSAGE_ROUTED4(FrameMsg_CommitNavigation,
 624                     content::ResourceResponseHead,   /* response */
 625                     GURL,                            /* stream_url */
 626                     content::CommonNavigationParams, /* common_params */
 627                     content::RequestNavigationParams /* request_params */)
 628
 629 // PlzNavigate
 630 // Tells the renderer that a navigation failed with the error code |error_code|
 631 // and that the renderer should display an appropriate error page.
 632 IPC_MESSAGE_ROUTED4(FrameMsg_FailedNavigation,
 633                     content::CommonNavigationParams,  /* common_params */
 634                     content::RequestNavigationParams, /* request_params */
 635                     bool,                             /* stale_copy_in_cache */
 636                     int                               /* error_code */)
 637
 638 #if defined(ENABLE_PLUGINS)
 639 // Notifies the renderer of updates to the Plugin Power Saver origin whitelist.
 640 IPC_MESSAGE_ROUTED1(FrameMsg_UpdatePluginContentOriginWhitelist,
 641                     std::set<GURL> /* origin_whitelist */)
 642 #endif  // defined(ENABLE_PLUGINS)
 643
 644 // -----------------------------------------------------------------------------
 645 // Messages sent from the renderer to the browser.
 646
 647 // Blink and JavaScript error messages to log to the console
 648 // or debugger UI.
 649 IPC_MESSAGE_ROUTED4(FrameHostMsg_AddMessageToConsole,
 650                     int32, /* log level */
 651                     base::string16, /* msg */
 652                     int32, /* line number */
 653                     base::string16 /* source id */ )
 654
 655 // Sent by the renderer when a child frame is created in the renderer.
 656 //
 657 // Each of these messages will have a corresponding FrameHostMsg_Detach message
 658 // sent when the frame is detached from the DOM.
 659 IPC_SYNC_MESSAGE_CONTROL4_1(FrameHostMsg_CreateChildFrame,
 660                             int32 /* parent_routing_id */,
 661                             blink::WebTreeScopeType /* scope */,
 662                             std::string /* frame_name */,
 663                             blink::WebSandboxFlags /* sandbox flags */,
 664                             int32 /* new_routing_id */)
 665
 666 // Sent by the renderer to the parent RenderFrameHost when a child frame is
 667 // detached from the DOM.
 668 IPC_MESSAGE_ROUTED0(FrameHostMsg_Detach)
 669
 670 // Indicates the renderer process is gone.  This actually is sent by the
 671 // browser process to itself, but keeps the interface cleaner.
 672 IPC_MESSAGE_ROUTED2(FrameHostMsg_RenderProcessGone,
 673                     int, /* this really is base::TerminationStatus */
 674                     int /* exit_code */)
 675
 676 // Sent by the renderer when the frame becomes focused.
 677 IPC_MESSAGE_ROUTED0(FrameHostMsg_FrameFocused)
 678
 679 // Sent when the renderer starts a provisional load for a frame.
 680 IPC_MESSAGE_ROUTED1(FrameHostMsg_DidStartProvisionalLoadForFrame,
 681                     GURL /* url */)
 682
 683 // Sent when the renderer fails a provisional load with an error.
 684 IPC_MESSAGE_ROUTED1(FrameHostMsg_DidFailProvisionalLoadWithError,
 685                     FrameHostMsg_DidFailProvisionalLoadWithError_Params)
 686
 687 // Notifies the browser that a frame in the view has changed. This message
 688 // has a lot of parameters and is packed/unpacked by functions defined in
 689 // render_messages.h.
 690 IPC_MESSAGE_ROUTED1(FrameHostMsg_DidCommitProvisionalLoad,
 691                     FrameHostMsg_DidCommitProvisionalLoad_Params)
 692
 693 // Notifies the browser that a document has been loaded.
 694 IPC_MESSAGE_ROUTED0(FrameHostMsg_DidFinishDocumentLoad)
 695
 696 IPC_MESSAGE_ROUTED3(FrameHostMsg_DidFailLoadWithError,
 697                     GURL /* validated_url */,
 698                     int /* error_code */,
 699                     base::string16 /* error_description */)
 700
 701 // Sent when the renderer decides to ignore a navigation.
 702 IPC_MESSAGE_ROUTED0(FrameHostMsg_DidDropNavigation)
 703
 704 // Sent when the renderer starts loading the page. |to_different_document| will
 705 // be true unless the load is a fragment navigation, or triggered by
 706 // history.pushState/replaceState.
 707 IPC_MESSAGE_ROUTED1(FrameHostMsg_DidStartLoading,
 708                     bool /* to_different_document */)
 709
 710 // Sent when the renderer is done loading a page.
 711 IPC_MESSAGE_ROUTED0(FrameHostMsg_DidStopLoading)
 712
 713 // Sent when the frame changes its window.name.
 714 IPC_MESSAGE_ROUTED1(FrameHostMsg_DidChangeName, std::string /* name */)
 715
 716 // Sent when the renderer changed the progress of a load.
 717 IPC_MESSAGE_ROUTED1(FrameHostMsg_DidChangeLoadProgress,
 718                     double /* load_progress */)
 719
 720 // Requests that the given URL be opened in the specified manner.
 721 IPC_MESSAGE_ROUTED1(FrameHostMsg_OpenURL, FrameHostMsg_OpenURL_Params)
 722
 723 // Notifies the browser that a frame finished loading.
 724 IPC_MESSAGE_ROUTED1(FrameHostMsg_DidFinishLoad,
 725                     GURL /* validated_url */)
 726
 727 // Sent when after the onload handler has been invoked for the document
 728 // in this frame. Sent for top-level frames. |report_type| and |ui_timestamp|
 729 // are used to report navigation metrics starting on the ui input event that
 730 // triggered the navigation timestamp.
 731 IPC_MESSAGE_ROUTED2(FrameHostMsg_DocumentOnLoadCompleted,
 732                     FrameMsg_UILoadMetricsReportType::Value /* report_type */,
 733                     base::TimeTicks /* ui_timestamp */)
 734
 735 // Notifies that the initial empty document of a view has been accessed.
 736 // After this, it is no longer safe to show a pending navigation's URL without
 737 // making a URL spoof possible.
 738 IPC_MESSAGE_ROUTED0(FrameHostMsg_DidAccessInitialDocument)
 739
 740 // Sent when the frame sets its opener to null, disowning it for the lifetime of
 741 // the window. Sent for top-level frames.
 742 IPC_MESSAGE_ROUTED0(FrameHostMsg_DidDisownOpener)
 743
 744 // Notifies the browser that a page id was assigned.
 745 IPC_MESSAGE_ROUTED1(FrameHostMsg_DidAssignPageId,
 746                     int32 /* page_id */)
 747
 748 // Notifies the browser that sandbox flags have changed for a subframe of this
 749 // frame.
 750 IPC_MESSAGE_ROUTED2(FrameHostMsg_DidChangeSandboxFlags,
 751                     int32 /* subframe_routing_id */,
 752                     blink::WebSandboxFlags /* updated_flags */)
 753
 754 // Changes the title for the page in the UI when the page is navigated or the
 755 // title changes. Sent for top-level frames.
 756 IPC_MESSAGE_ROUTED2(FrameHostMsg_UpdateTitle,
 757                     base::string16 /* title */,
 758                     blink::WebTextDirection /* title direction */)
 759
 760 // Change the encoding name of the page in UI when the page has detected
 761 // proper encoding name. Sent for top-level frames.
 762 IPC_MESSAGE_ROUTED1(FrameHostMsg_UpdateEncoding,
 763                     std::string /* new encoding name */)
 764
 765 // Following message is used to communicate the values received by the
 766 // callback binding the JS to Cpp.
 767 // An instance of browser that has an automation host listening to it can
 768 // have a javascript send a native value (string, number, boolean) to the
 769 // listener in Cpp. (DomAutomationController)
 770 IPC_MESSAGE_ROUTED2(FrameHostMsg_DomOperationResponse,
 771                     std::string  /* json_string */,
 772                     int  /* automation_id */)
 773
 774 // Used to set a cookie. The cookie is set asynchronously, but will be
 775 // available to a subsequent FrameHostMsg_GetCookies request.
 776 IPC_MESSAGE_CONTROL4(FrameHostMsg_SetCookie,
 777                      int /* render_frame_id */,
 778                      GURL /* url */,
 779                      GURL /* first_party_for_cookies */,
 780                      std::string /* cookie */)
 781
 782 // Used to get cookies for the given URL. This may block waiting for a
 783 // previous SetCookie message to be processed.
 784 IPC_SYNC_MESSAGE_CONTROL3_1(FrameHostMsg_GetCookies,
 785                             int /* render_frame_id */,
 786                             GURL /* url */,
 787                             GURL /* first_party_for_cookies */,
 788                             std::string /* cookies */)
 789
 790 // Used to check if cookies are enabled for the given URL. This may block
 791 // waiting for a previous SetCookie message to be processed.
 792 IPC_SYNC_MESSAGE_CONTROL3_1(FrameHostMsg_CookiesEnabled,
 793                             int /* render_frame_id */,
 794                             GURL /* url */,
 795                             GURL /* first_party_for_cookies */,
 796                             bool /* cookies_enabled */)
 797
 798 #if defined(ENABLE_PLUGINS)
 799 // Notification sent from a renderer to the browser that a Pepper plugin
 800 // instance is created in the DOM.
 801 IPC_MESSAGE_ROUTED0(FrameHostMsg_PepperInstanceCreated)
 802
 803 // Notification sent from a renderer to the browser that a Pepper plugin
 804 // instance is deleted from the DOM.
 805 IPC_MESSAGE_ROUTED0(FrameHostMsg_PepperInstanceDeleted)
 806
 807 // Sent to the browser when the renderer detects it is blocked on a pepper
 808 // plugin message for too long. This is also sent when it becomes unhung
 809 // (according to the value of is_hung). The browser can give the user the
 810 // option of killing the plugin.
 811 IPC_MESSAGE_ROUTED3(FrameHostMsg_PepperPluginHung,
 812                     int /* plugin_child_id */,
 813                     base::FilePath /* path */,
 814                     bool /* is_hung */)
 815
 816 // Sent by the renderer process to indicate that a plugin instance has crashed.
 817 // Note: |plugin_pid| should not be trusted. The corresponding process has
 818 // probably died. Moreover, the ID may have been reused by a new process. Any
 819 // usage other than displaying it in a prompt to the user is very likely to be
 820 // wrong.
 821 IPC_MESSAGE_ROUTED2(FrameHostMsg_PluginCrashed,
 822                     base::FilePath /* plugin_path */,
 823                     base::ProcessId /* plugin_pid */)
 824
 825 // Return information about a plugin for the given URL and MIME
 826 // type. If there is no matching plugin, |found| is false.
 827 // |actual_mime_type| is the actual mime type supported by the
 828 // found plugin.
 829 IPC_SYNC_MESSAGE_CONTROL4_3(FrameHostMsg_GetPluginInfo,
 830                             int /* render_frame_id */,
 831                             GURL /* url */,
 832                             GURL /* page_url */,
 833                             std::string /* mime_type */,
 834                             bool /* found */,
 835                             content::WebPluginInfo /* plugin info */,
 836                             std::string /* actual_mime_type */)
 837
 838 // A renderer sends this to the browser process when it wants to temporarily
 839 // whitelist an origin's plugin content as essential. This temporary whitelist
 840 // is specific to a top level frame, and is cleared when the whitelisting
 841 // RenderFrame is destroyed.
 842 IPC_MESSAGE_ROUTED1(FrameHostMsg_PluginContentOriginAllowed,
 843                     GURL /* content_origin */)
 844 #endif  // defined(ENABLE_PLUGINS)
 845
 846 // A renderer sends this to the browser process when it wants to
 847 // create a plugin.  The browser will create the plugin process if
 848 // necessary, and will return a handle to the channel on success.
 849 // On error an empty string is returned.
 850 IPC_SYNC_MESSAGE_CONTROL4_2(FrameHostMsg_OpenChannelToPlugin,
 851                             int /* render_frame_id */,
 852                             GURL /* url */,
 853                             GURL /* page_url */,
 854                             std::string /* mime_type */,
 855                             IPC::ChannelHandle /* channel_handle */,
 856                             content::WebPluginInfo /* info */)
 857
 858 // Acknowledge that we presented an ubercomp frame.
 859 //
 860 // See FrameMsg_CompositorFrameSwapped
 861 IPC_MESSAGE_ROUTED1(FrameHostMsg_CompositorFrameSwappedACK,
 862                     FrameHostMsg_CompositorFrameSwappedACK_Params /* params */)
 863
 864 // Satisfies a Surface destruction dependency associated with |sequence|.
 865 IPC_MESSAGE_ROUTED1(FrameHostMsg_SatisfySequence,
 866                     cc::SurfaceSequence /* sequence */)
 867
 868 // Creates a destruction dependency for the Surface specified by the given
 869 // |surface_id|.
 870 IPC_MESSAGE_ROUTED2(FrameHostMsg_RequireSequence,
 871                     cc::SurfaceId /* surface_id */,
 872                     cc::SurfaceSequence /* sequence */)
 873
 874 // Provides the result from handling BeforeUnload.  |proceed| matches the return
 875 // value of the frame's beforeunload handler: true if the user decided to
 876 // proceed with leaving the page.
 877 IPC_MESSAGE_ROUTED3(FrameHostMsg_BeforeUnload_ACK,
 878                     bool /* proceed */,
 879                     base::TimeTicks /* before_unload_start_time */,
 880                     base::TimeTicks /* before_unload_end_time */)
 881
 882 // Indicates that the current frame has swapped out, after a SwapOut message.
 883 IPC_MESSAGE_ROUTED0(FrameHostMsg_SwapOut_ACK)
 884
 885 IPC_MESSAGE_ROUTED1(FrameHostMsg_ReclaimCompositorResources,
 886                     FrameHostMsg_ReclaimCompositorResources_Params /* params */)
 887
 888 // Forwards an input event to a child.
 889 // TODO(nick): Temporary bridge, revisit once the browser process can route
 890 // input directly to subframes. http://crbug.com/339659
 891 IPC_MESSAGE_ROUTED1(FrameHostMsg_ForwardInputEvent,
 892                     IPC::WebInputEventPointer /* event */)
 893
 894 // Used to tell the parent that the user right clicked on an area of the
 895 // content area, and a context menu should be shown for it. The params
 896 // object contains information about the node(s) that were selected when the
 897 // user right clicked.
 898 IPC_MESSAGE_ROUTED1(FrameHostMsg_ContextMenu, content::ContextMenuParams)
 899
 900 // Initial drawing parameters for a child frame that has been swapped out to
 901 // another process.
 902 IPC_MESSAGE_ROUTED2(FrameHostMsg_InitializeChildFrame,
 903                     gfx::Rect /* frame_rect */,
 904                     float /* scale_factor */)
 905
 906 // Response for FrameMsg_JavaScriptExecuteRequest, sent when a reply was
 907 // requested. The ID is the parameter supplied to
 908 // FrameMsg_JavaScriptExecuteRequest. The result has the value returned by the
 909 // script as its only element, one of Null, Boolean, Integer, Real, Date, or
 910 // String.
 911 IPC_MESSAGE_ROUTED2(FrameHostMsg_JavaScriptExecuteResponse,
 912                     int  /* id */,
 913                     base::ListValue  /* result */)
 914
 915 // A request to run a JavaScript dialog.
 916 IPC_SYNC_MESSAGE_ROUTED4_2(FrameHostMsg_RunJavaScriptMessage,
 917                            base::string16     /* in - alert message */,
 918                            base::string16     /* in - default prompt */,
 919                            GURL               /* in - originating page URL */,
 920                            content::JavaScriptMessageType /* in - type */,
 921                            bool               /* out - success */,
 922                            base::string16     /* out - user_input field */)
 923
 924 // Displays a dialog to confirm that the user wants to navigate away from the
 925 // page. Replies true if yes, and false otherwise. The reply string is ignored,
 926 // but is included so that we can use OnJavaScriptMessageBoxClosed.
 927 IPC_SYNC_MESSAGE_ROUTED3_2(FrameHostMsg_RunBeforeUnloadConfirm,
 928                            GURL,           /* in - originating frame URL */
 929                            base::string16  /* in - alert message */,
 930                            bool            /* in - is a reload */,
 931                            bool            /* out - success */,
 932                            base::string16  /* out - This is ignored.*/)
 933
 934 // Asks the browser to open the color chooser.
 935 IPC_MESSAGE_ROUTED3(FrameHostMsg_OpenColorChooser,
 936                     int /* id */,
 937                     SkColor /* color */,
 938                     std::vector<content::ColorSuggestion> /* suggestions */)
 939
 940 // Asks the browser to end the color chooser.
 941 IPC_MESSAGE_ROUTED1(FrameHostMsg_EndColorChooser, int /* id */)
 942
 943 // Change the selected color in the color chooser.
 944 IPC_MESSAGE_ROUTED2(FrameHostMsg_SetSelectedColorInColorChooser,
 945                     int /* id */,
 946                     SkColor /* color */)
 947
 948 // Notifies the browser that media has started/stopped playing.
 949 IPC_MESSAGE_ROUTED4(FrameHostMsg_MediaPlayingNotification,
 950                     int64 /* player_cookie, distinguishes instances */,
 951                     bool /* has_video */,
 952                     bool /* has_audio */,
 953                     bool /* is_remote */)
 954
 955 IPC_MESSAGE_ROUTED1(FrameHostMsg_MediaPausedNotification,
 956                     int64 /* player_cookie, distinguishes instances */)
 957
 958 // Notify browser the theme color has been changed.
 959 IPC_MESSAGE_ROUTED1(FrameHostMsg_DidChangeThemeColor,
 960                     SkColor /* theme_color */)
 961
 962 // Response for FrameMsg_TextSurroundingSelectionRequest, |startOffset| and
 963 // |endOffset| are the offsets of the selection in the returned |content|.
 964 IPC_MESSAGE_ROUTED3(FrameHostMsg_TextSurroundingSelectionResponse,
 965                     base::string16,  /* content */
 966                     size_t, /* startOffset */
 967                     size_t /* endOffset */)
 968
 969 // PlzNavigate
 970 // Tells the browser to perform a navigation.
 971 IPC_MESSAGE_ROUTED3(FrameHostMsg_BeginNavigation,
 972                     content::CommonNavigationParams,
 973                     content::BeginNavigationParams,
 974                     scoped_refptr<content::ResourceRequestBody>)
 975
 976 // Sent once a paint happens after the first non empty layout. In other words
 977 // after the frame has painted something.
 978 IPC_MESSAGE_ROUTED0(FrameHostMsg_DidFirstVisuallyNonEmptyPaint)
 979
 980 // Sent as a response to FrameMsg_VisualStateRequest.
 981 // The message is delivered using RenderWidget::QueueMessage.
 982 IPC_MESSAGE_ROUTED1(FrameHostMsg_VisualStateResponse, uint64 /* id */)
 983
 984 // Puts the browser into "tab fullscreen" mode for the sending renderer.
 985 // See the comment in chrome/browser/ui/browser.h for more details.
 986 IPC_MESSAGE_ROUTED1(FrameHostMsg_ToggleFullscreen, bool /* enter_fullscreen */)
 987
 988 // Dispatch a load event for this frame in the iframe element of an
 989 // out-of-process parent frame.
 990 IPC_MESSAGE_ROUTED0(FrameHostMsg_DispatchLoad)
 991
 992 // Sent to the browser from a frame proxy to post a message to the frame's
 993 // active renderer.
 994 IPC_MESSAGE_ROUTED1(FrameHostMsg_RouteMessageEvent,
 995                     FrameMsg_PostMessage_Params)
 996
 997 #if defined(OS_MACOSX) || defined(OS_ANDROID)
 998
 999 // Message to show/hide a popup menu using native controls.
1000 IPC_MESSAGE_ROUTED1(FrameHostMsg_ShowPopup,
1001                     FrameHostMsg_ShowPopup_Params)
1002 IPC_MESSAGE_ROUTED0(FrameHostMsg_HidePopup)
1003
1004 #endif