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 "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"
  22 #include "url/gurl.h"
  23
  24 #undef IPC_MESSAGE_EXPORT
  25 #define IPC_MESSAGE_EXPORT CONTENT_EXPORT
  26
  27 #define IPC_MESSAGE_START FrameMsgStart
  28
  29 IPC_ENUM_TRAITS_MIN_MAX_VALUE(AccessibilityMode,
  30                               AccessibilityModeOff,
  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)
  40
  41 IPC_STRUCT_TRAITS_BEGIN(content::ColorSuggestion)
  42   IPC_STRUCT_TRAITS_MEMBER(color)
  43   IPC_STRUCT_TRAITS_MEMBER(label)
  44 IPC_STRUCT_TRAITS_END()
  45
  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)
  80 #endif
  81 IPC_STRUCT_TRAITS_END()
  82
  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()
  89
  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)
 101 IPC_STRUCT_END()
 102
 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()
 116
 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)
 122
 123   // Information regarding the security of the connection (empty if the
 124   // connection was not secure).
 125   IPC_STRUCT_MEMBER(std::string, security_info)
 126
 127   // The gesture that initiated this navigation.
 128   IPC_STRUCT_MEMBER(content::NavigationGesture, gesture)
 129
 130   // True if this was a post request.
 131   IPC_STRUCT_MEMBER(bool, is_post)
 132
 133   // The POST body identifier. -1 if it doesn't exist.
 134   IPC_STRUCT_MEMBER(int64, post_id)
 135
 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)
 140
 141   // The status code of the HTTP request.
 142   IPC_STRUCT_MEMBER(int, http_status_code)
 143
 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)
 147
 148   // Serialized history item state to store in the navigation entry.
 149   IPC_STRUCT_MEMBER(content::PageState, page_state)
 150
 151   // Original request's URL.
 152   IPC_STRUCT_MEMBER(GURL, original_request_url)
 153
 154   // User agent override used to navigate.
 155   IPC_STRUCT_MEMBER(bool, is_overriding_user_agent)
 156
 157   // Notifies the browser that for this navigation, the session history was
 158   // successfully cleared.
 159   IPC_STRUCT_MEMBER(bool, history_list_was_cleared)
 160
 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)
 170 IPC_STRUCT_END()
 171
 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)
 178
 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)
 183
 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)
 188
 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)
 193
 194   // The URL to load.
 195   IPC_STRUCT_MEMBER(GURL, url)
 196
 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)
 200
 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)
 204
 205   // The URL to send in the "Referer" header field. Can be empty if there is
 206   // no referrer.
 207   IPC_STRUCT_MEMBER(content::Referrer, referrer)
 208
 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)
 212
 213   // The type of transition.
 214   IPC_STRUCT_MEMBER(ui::PageTransition, transition)
 215
 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)
 220
 221   // Opaque history state (received by ViewHostMsg_UpdateState).
 222   IPC_STRUCT_MEMBER(content::PageState, page_state)
 223
 224   // Type of navigation.
 225   IPC_STRUCT_MEMBER(FrameMsg_Navigate_Type::Value, navigation_type)
 226
 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)
 231
 232   // Extra headers (separated by \n) to send during the request.
 233   IPC_STRUCT_MEMBER(std::string, extra_headers)
 234
 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)
 241
 242   // Whether or not we should allow the url to download.
 243   IPC_STRUCT_MEMBER(bool, allow_download)
 244
 245   // Whether or not the user agent override string should be used.
 246   IPC_STRUCT_MEMBER(bool, is_overriding_user_agent)
 247
 248   // True if this was a post request.
 249   IPC_STRUCT_MEMBER(bool, is_post)
 250
 251   // If is_post is true, holds the post_data information from browser. Empty
 252   // otherwise.
 253   IPC_STRUCT_MEMBER(std::vector<unsigned char>, browser_initiated_post_data)
 254
 255   // Whether or not this url should be allowed to access local file://
 256   // resources.
 257   IPC_STRUCT_MEMBER(bool, can_load_local_resources)
 258
 259   // If not empty, which frame to navigate.
 260   IPC_STRUCT_MEMBER(std::string, frame_to_navigate)
 261
 262   // The navigationStart time to expose through the Navigation Timing API to JS.
 263   IPC_STRUCT_MEMBER(base::TimeTicks, browser_navigation_start)
 264 IPC_STRUCT_END()
 265
 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)
 272 IPC_STRUCT_END()
 273
 274 // PlzNavigate
 275 IPC_STRUCT_BEGIN(FrameHostMsg_BeginNavigation_Params)
 276   // The request method: GET, POST, etc.
 277   IPC_STRUCT_MEMBER(std::string, method)
 278
 279   // The requested URL.
 280   IPC_STRUCT_MEMBER(GURL, url)
 281
 282   // The referrer to use (may be empty).
 283   IPC_STRUCT_MEMBER(content::Referrer, referrer)
 284
 285   // Additional HTTP request headers.
 286   IPC_STRUCT_MEMBER(std::string, headers)
 287
 288   // net::URLRequest load flags (net::LOAD_NORMAL) by default).
 289   IPC_STRUCT_MEMBER(int, load_flags)
 290
 291   // Optional resource request body (may be null).
 292   IPC_STRUCT_MEMBER(scoped_refptr<content::ResourceRequestBody>,
 293                     request_body)
 294
 295   // True if the request was user initiated.
 296   IPC_STRUCT_MEMBER(bool, has_user_gesture)
 297
 298   IPC_STRUCT_MEMBER(ui::PageTransition, transition_type)
 299
 300   // Whether this navigation should replace the current session history entry on
 301   // commit.
 302   IPC_STRUCT_MEMBER(bool, should_replace_current_entry)
 303
 304   // Whether or not we should allow the URL to download.
 305   IPC_STRUCT_MEMBER(bool, allow_download)
 306 IPC_STRUCT_END()
 307
 308 #if defined(OS_MACOSX) || defined(OS_ANDROID)
 309 // This message is used for supporting popup menus on Mac OS X and Android using
 310 // native controls. See the FrameHostMsg_ShowPopup message.
 311 IPC_STRUCT_BEGIN(FrameHostMsg_ShowPopup_Params)
 312   // Position on the screen.
 313   IPC_STRUCT_MEMBER(gfx::Rect, bounds)
 314
 315   // The height of each item in the menu.
 316   IPC_STRUCT_MEMBER(int, item_height)
 317
 318   // The size of the font to use for those items.
 319   IPC_STRUCT_MEMBER(double, item_font_size)
 320
 321   // The currently selected (displayed) item in the menu.
 322   IPC_STRUCT_MEMBER(int, selected_item)
 323
 324   // The entire list of items in the popup menu.
 325   IPC_STRUCT_MEMBER(std::vector<content::MenuItem>, popup_items)
 326
 327   // Whether items should be right-aligned.
 328   IPC_STRUCT_MEMBER(bool, right_aligned)
 329
 330   // Whether this is a multi-select popup.
 331   IPC_STRUCT_MEMBER(bool, allow_multiple_selection)
 332 IPC_STRUCT_END()
 333 #endif
 334
 335 // -----------------------------------------------------------------------------
 336 // Messages sent from the browser to the renderer.
 337
 338 // Notifies the embedding frame that a new CompositorFrame is ready to be
 339 // presented. When the frame finishes presenting, a matching
 340 // FrameHostMsg_CompositorFrameSwappedACK should be sent back to the
 341 // RenderViewHost that was produced the CompositorFrame.
 342 //
 343 // This is used in the ubercomp compositing path.
 344 IPC_MESSAGE_ROUTED1(FrameMsg_CompositorFrameSwapped,
 345                     FrameMsg_CompositorFrameSwapped_Params /* params */)
 346
 347 // Notifies the embedding frame that the process rendering the child frame's
 348 // contents has terminated.
 349 IPC_MESSAGE_ROUTED0(FrameMsg_ChildFrameProcessGone)
 350
 351 // Sent in response to a FrameHostMsg_ContextMenu to let the renderer know that
 352 // the menu has been closed.
 353 IPC_MESSAGE_ROUTED1(FrameMsg_ContextMenuClosed,
 354                     content::CustomContextMenuContext /* custom_context */)
 355
 356 // Executes custom context menu action that was provided from Blink.
 357 IPC_MESSAGE_ROUTED2(FrameMsg_CustomContextMenuAction,
 358                     content::CustomContextMenuContext /* custom_context */,
 359                     unsigned /* action */)
 360
 361 // Requests that the RenderFrame or RenderFrameProxy sets its opener to null.
 362 IPC_MESSAGE_ROUTED0(FrameMsg_DisownOpener)
 363
 364 // Instructs the renderer to create a new RenderFrame object with |routing_id|.
 365 // The new frame should be created as a child of the object identified by
 366 // |parent_routing_id| or as top level if that is MSG_ROUTING_NONE.
 367 IPC_MESSAGE_CONTROL2(FrameMsg_NewFrame,
 368                      int /* routing_id */,
 369                      int /* parent_routing_id */)
 370
 371 // Instructs the renderer to create a new RenderFrameProxy object with
 372 // |routing_id|. The new proxy should be created as a child of the object
 373 // identified by |parent_routing_id| or as top level if that is
 374 // MSG_ROUTING_NONE.
 375 IPC_MESSAGE_CONTROL3(FrameMsg_NewFrameProxy,
 376                      int /* routing_id */,
 377                      int /* parent_routing_id */,
 378                      int /* render_view_routing_id */)
 379
 380 // Tells the renderer to perform the specified navigation, interrupting any
 381 // existing navigation.
 382 IPC_MESSAGE_ROUTED1(FrameMsg_Navigate, FrameMsg_Navigate_Params)
 383
 384 // Instructs the renderer to invoke the frame's beforeunload event handler.
 385 // Expects the result to be returned via FrameHostMsg_BeforeUnload_ACK.
 386 IPC_MESSAGE_ROUTED0(FrameMsg_BeforeUnload)
 387
 388 // Instructs the frame to swap out for a cross-site transition, including
 389 // running the unload event handler and creating a RenderFrameProxy with the
 390 // given |proxy_routing_id|. Expects a SwapOut_ACK message when finished.
 391 IPC_MESSAGE_ROUTED1(FrameMsg_SwapOut,
 392                     int /* proxy_routing_id */)
 393
 394 // Instructs the frame to stop the load in progress, if any.
 395 IPC_MESSAGE_ROUTED0(FrameMsg_Stop)
 396
 397 // Request for the renderer to insert CSS into the frame.
 398 IPC_MESSAGE_ROUTED1(FrameMsg_CSSInsertRequest,
 399                     std::string  /* css */)
 400
 401 // Request for the renderer to execute JavaScript in the frame's context.
 402 //
 403 // javascript is the string containing the JavaScript to be executed in the
 404 // target frame's context.
 405 //
 406 // If the third parameter is true the result is sent back to the browser using
 407 // the message FrameHostMsg_JavaScriptExecuteResponse.
 408 // FrameHostMsg_JavaScriptExecuteResponse is passed the ID parameter so that the
 409 // host can uniquely identify the request.
 410 IPC_MESSAGE_ROUTED3(FrameMsg_JavaScriptExecuteRequest,
 411                     base::string16,  /* javascript */
 412                     int,  /* ID */
 413                     bool  /* if true, a reply is requested */)
 414
 415 // ONLY FOR TESTS: Same as above but adds a fake UserGestureindicator around
 416 // execution. (crbug.com/408426)
 417 IPC_MESSAGE_ROUTED3(FrameMsg_JavaScriptExecuteRequestForTests,
 418                     base::string16,  /* javascript */
 419                     int,  /* ID */
 420                     bool  /* if true, a reply is requested */)
 421
 422 // Selects between the given start and end offsets in the currently focused
 423 // editable field.
 424 IPC_MESSAGE_ROUTED2(FrameMsg_SetEditableSelectionOffsets,
 425                     int /* start */,
 426                     int /* end */)
 427
 428 // Requests a navigation to the supplied markup, in an iframe with sandbox
 429 // attributes.
 430 IPC_MESSAGE_ROUTED1(FrameMsg_SetupTransitionView,
 431                     std::string /* markup */)
 432
 433 // Tells the renderer to hide the elements specified by the supplied CSS
 434 // selector, and activates any exiting-transition stylesheets.
 435 IPC_MESSAGE_ROUTED1(FrameMsg_BeginExitTransition,
 436                     std::string /* css_selector */)
 437
 438 // Tells the renderer to reload the frame, optionally ignoring the cache while
 439 // doing so.
 440 IPC_MESSAGE_ROUTED1(FrameMsg_Reload,
 441                     bool /* ignore_cache */)
 442
 443 // Notifies the color chooser client that the user selected a color.
 444 IPC_MESSAGE_ROUTED2(FrameMsg_DidChooseColorResponse, unsigned, SkColor)
 445
 446 // Notifies the color chooser client that the color chooser has ended.
 447 IPC_MESSAGE_ROUTED1(FrameMsg_DidEndColorChooser, unsigned)
 448
 449 // Notifies the corresponding RenderFrameProxy object to replace itself with the
 450 // RenderFrame object it is associated with.
 451 IPC_MESSAGE_ROUTED0(FrameMsg_DeleteProxy)
 452
 453 // Request the text surrounding the selection with a |max_length|. The response
 454 // will be sent via FrameHostMsg_TextSurroundingSelectionResponse.
 455 IPC_MESSAGE_ROUTED1(FrameMsg_TextSurroundingSelectionRequest,
 456                     size_t /* max_length */)
 457
 458 // Tells the renderer to insert a link to the specified stylesheet. This is
 459 // needed to support navigation transitions.
 460 IPC_MESSAGE_ROUTED1(FrameMsg_AddStyleSheetByURL, std::string)
 461
 462 // Change the accessibility mode in the renderer process.
 463 IPC_MESSAGE_ROUTED1(FrameMsg_SetAccessibilityMode,
 464                     AccessibilityMode)
 465
 466 #if defined(OS_ANDROID)
 467
 468 // External popup menus.
 469 IPC_MESSAGE_ROUTED2(FrameMsg_SelectPopupMenuItems,
 470                     bool /* user canceled the popup */,
 471                     std::vector<int> /* selected indices */)
 472
 473 #elif defined(OS_MACOSX)
 474
 475 // External popup menus.
 476 IPC_MESSAGE_ROUTED1(FrameMsg_SelectPopupMenuItem,
 477                     int /* selected index, -1 means no selection */)
 478
 479 #endif
 480
 481 // -----------------------------------------------------------------------------
 482 // Messages sent from the renderer to the browser.
 483
 484 // Blink and JavaScript error messages to log to the console
 485 // or debugger UI.
 486 IPC_MESSAGE_ROUTED4(FrameHostMsg_AddMessageToConsole,
 487                     int32, /* log level */
 488                     base::string16, /* msg */
 489                     int32, /* line number */
 490                     base::string16 /* source id */ )
 491
 492 // Sent by the renderer when a child frame is created in the renderer.
 493 //
 494 // Each of these messages will have a corresponding FrameHostMsg_Detach message
 495 // sent when the frame is detached from the DOM.
 496 IPC_SYNC_MESSAGE_CONTROL2_1(FrameHostMsg_CreateChildFrame,
 497                             int32 /* parent_routing_id */,
 498                             std::string /* frame_name */,
 499                             int32 /* new_routing_id */)
 500
 501 // Sent by the renderer to the parent RenderFrameHost when a child frame is
 502 // detached from the DOM.
 503 IPC_MESSAGE_ROUTED0(FrameHostMsg_Detach)
 504
 505 // Sent by the renderer when the frame becomes focused.
 506 IPC_MESSAGE_ROUTED0(FrameHostMsg_FrameFocused)
 507
 508 // Sent when the renderer starts a provisional load for a frame.
 509 // |is_transition_navigation| signals that the frame has defined transition
 510 // elements which can be animated by the navigation destination to provide
 511 // a transition effect during load.
 512 IPC_MESSAGE_ROUTED2(FrameHostMsg_DidStartProvisionalLoadForFrame,
 513                     GURL /* url */,
 514                     bool /* is_transition_navigation */)
 515
 516 // Sent when the renderer fails a provisional load with an error.
 517 IPC_MESSAGE_ROUTED1(FrameHostMsg_DidFailProvisionalLoadWithError,
 518                     FrameHostMsg_DidFailProvisionalLoadWithError_Params)
 519
 520 // Sent when a provisional load on the main frame redirects.
 521 IPC_MESSAGE_ROUTED3(FrameHostMsg_DidRedirectProvisionalLoad,
 522                     int /* page_id */,
 523                     GURL /* source_url*/,
 524                     GURL /* target_url */)
 525
 526 // Notifies the browser that a frame in the view has changed. This message
 527 // has a lot of parameters and is packed/unpacked by functions defined in
 528 // render_messages.h.
 529 IPC_MESSAGE_ROUTED1(FrameHostMsg_DidCommitProvisionalLoad,
 530                     FrameHostMsg_DidCommitProvisionalLoad_Params)
 531
 532 // Notifies the browser that a document has been loaded.
 533 IPC_MESSAGE_ROUTED0(FrameHostMsg_DidFinishDocumentLoad)
 534
 535 IPC_MESSAGE_ROUTED3(FrameHostMsg_DidFailLoadWithError,
 536                     GURL /* validated_url */,
 537                     int /* error_code */,
 538                     base::string16 /* error_description */)
 539
 540 // Sent when the renderer starts loading the page. |to_different_document| will
 541 // be true unless the load is a fragment navigation, or triggered by
 542 // history.pushState/replaceState.
 543 IPC_MESSAGE_ROUTED1(FrameHostMsg_DidStartLoading,
 544                     bool /* to_different_document */)
 545
 546 // Sent when the renderer is done loading a page.
 547 IPC_MESSAGE_ROUTED0(FrameHostMsg_DidStopLoading)
 548
 549 // Sent when the renderer changed the progress of a load.
 550 IPC_MESSAGE_ROUTED1(FrameHostMsg_DidChangeLoadProgress,
 551                     double /* load_progress */)
 552
 553 // Requests that the given URL be opened in the specified manner.
 554 IPC_MESSAGE_ROUTED1(FrameHostMsg_OpenURL, FrameHostMsg_OpenURL_Params)
 555
 556 // Notifies the browser that a frame finished loading.
 557 IPC_MESSAGE_ROUTED1(FrameHostMsg_DidFinishLoad,
 558                     GURL /* validated_url */)
 559
 560 // Sent when after the onload handler has been invoked for the document
 561 // in this frame. Sent for top-level frames.
 562 IPC_MESSAGE_ROUTED0(FrameHostMsg_DocumentOnLoadCompleted)
 563
 564 // Notifies that the initial empty document of a view has been accessed.
 565 // After this, it is no longer safe to show a pending navigation's URL without
 566 // making a URL spoof possible.
 567 IPC_MESSAGE_ROUTED0(FrameHostMsg_DidAccessInitialDocument)
 568
 569 // Sent when the frame sets its opener to null, disowning it for the lifetime of
 570 // the window. Sent for top-level frames.
 571 IPC_MESSAGE_ROUTED0(FrameHostMsg_DidDisownOpener)
 572
 573 // Notifies the browser that a page id was assigned.
 574 IPC_MESSAGE_ROUTED1(FrameHostMsg_DidAssignPageId,
 575                     int32 /* page_id */)
 576
 577 // Changes the title for the page in the UI when the page is navigated or the
 578 // title changes. Sent for top-level frames.
 579 IPC_MESSAGE_ROUTED3(FrameHostMsg_UpdateTitle,
 580                     int32 /* page_id */,
 581                     base::string16 /* title */,
 582                     blink::WebTextDirection /* title direction */)
 583
 584 // Change the encoding name of the page in UI when the page has detected
 585 // proper encoding name. Sent for top-level frames.
 586 IPC_MESSAGE_ROUTED1(FrameHostMsg_UpdateEncoding,
 587                     std::string /* new encoding name */)
 588
 589 // Following message is used to communicate the values received by the
 590 // callback binding the JS to Cpp.
 591 // An instance of browser that has an automation host listening to it can
 592 // have a javascript send a native value (string, number, boolean) to the
 593 // listener in Cpp. (DomAutomationController)
 594 IPC_MESSAGE_ROUTED2(FrameHostMsg_DomOperationResponse,
 595                     std::string  /* json_string */,
 596                     int  /* automation_id */)
 597
 598 // Sent to the browser when the renderer detects it is blocked on a pepper
 599 // plugin message for too long. This is also sent when it becomes unhung
 600 // (according to the value of is_hung). The browser can give the user the
 601 // option of killing the plugin.
 602 IPC_MESSAGE_ROUTED3(FrameHostMsg_PepperPluginHung,
 603                     int /* plugin_child_id */,
 604                     base::FilePath /* path */,
 605                     bool /* is_hung */)
 606
 607 // Sent by the renderer process to indicate that a plugin instance has crashed.
 608 // Note: |plugin_pid| should not be trusted. The corresponding process has
 609 // probably died. Moreover, the ID may have been reused by a new process. Any
 610 // usage other than displaying it in a prompt to the user is very likely to be
 611 // wrong.
 612 IPC_MESSAGE_ROUTED2(FrameHostMsg_PluginCrashed,
 613                     base::FilePath /* plugin_path */,
 614                     base::ProcessId /* plugin_pid */)
 615
 616 // Return information about a plugin for the given URL and MIME
 617 // type. If there is no matching plugin, |found| is false.
 618 // |actual_mime_type| is the actual mime type supported by the
 619 // found plugin.
 620 IPC_SYNC_MESSAGE_CONTROL4_3(FrameHostMsg_GetPluginInfo,
 621                             int /* render_frame_id */,
 622                             GURL /* url */,
 623                             GURL /* page_url */,
 624                             std::string /* mime_type */,
 625                             bool /* found */,
 626                             content::WebPluginInfo /* plugin info */,
 627                             std::string /* actual_mime_type */)
 628
 629 // A renderer sends this to the browser process when it wants to
 630 // create a plugin.  The browser will create the plugin process if
 631 // necessary, and will return a handle to the channel on success.
 632 // On error an empty string is returned.
 633 IPC_SYNC_MESSAGE_CONTROL4_2(FrameHostMsg_OpenChannelToPlugin,
 634                             int /* render_frame_id */,
 635                             GURL /* url */,
 636                             GURL /* page_url */,
 637                             std::string /* mime_type */,
 638                             IPC::ChannelHandle /* channel_handle */,
 639                             content::WebPluginInfo /* info */)
 640
 641 // Acknowledge that we presented an ubercomp frame.
 642 //
 643 // See FrameMsg_CompositorFrameSwapped
 644 IPC_MESSAGE_ROUTED1(FrameHostMsg_CompositorFrameSwappedACK,
 645                     FrameHostMsg_CompositorFrameSwappedACK_Params /* params */)
 646
 647 // Provides the result from handling BeforeUnload.  |proceed| matches the return
 648 // value of the frame's beforeunload handler: true if the user decided to
 649 // proceed with leaving the page.
 650 IPC_MESSAGE_ROUTED3(FrameHostMsg_BeforeUnload_ACK,
 651                     bool /* proceed */,
 652                     base::TimeTicks /* before_unload_start_time */,
 653                     base::TimeTicks /* before_unload_end_time */)
 654
 655 // Indicates that the current frame has swapped out, after a SwapOut message.
 656 IPC_MESSAGE_ROUTED0(FrameHostMsg_SwapOut_ACK)
 657
 658 IPC_MESSAGE_ROUTED1(FrameHostMsg_ReclaimCompositorResources,
 659                     FrameHostMsg_ReclaimCompositorResources_Params /* params */)
 660
 661 // Forwards an input event to a child.
 662 // TODO(nick): Temporary bridge, revisit once the browser process can route
 663 // input directly to subframes. http://crbug.com/339659
 664 IPC_MESSAGE_ROUTED1(FrameHostMsg_ForwardInputEvent,
 665                     IPC::WebInputEventPointer /* event */)
 666
 667 // Used to tell the parent that the user right clicked on an area of the
 668 // content area, and a context menu should be shown for it. The params
 669 // object contains information about the node(s) that were selected when the
 670 // user right clicked.
 671 IPC_MESSAGE_ROUTED1(FrameHostMsg_ContextMenu, content::ContextMenuParams)
 672
 673 // Initial drawing parameters for a child frame that has been swapped out to
 674 // another process.
 675 IPC_MESSAGE_ROUTED2(FrameHostMsg_InitializeChildFrame,
 676                     gfx::Rect /* frame_rect */,
 677                     float /* scale_factor */)
 678
 679 // Response for FrameMsg_JavaScriptExecuteRequest, sent when a reply was
 680 // requested. The ID is the parameter supplied to
 681 // FrameMsg_JavaScriptExecuteRequest. The result has the value returned by the
 682 // script as its only element, one of Null, Boolean, Integer, Real, Date, or
 683 // String.
 684 IPC_MESSAGE_ROUTED2(FrameHostMsg_JavaScriptExecuteResponse,
 685                     int  /* id */,
 686                     base::ListValue  /* result */)
 687
 688 // A request to run a JavaScript dialog.
 689 IPC_SYNC_MESSAGE_ROUTED4_2(FrameHostMsg_RunJavaScriptMessage,
 690                            base::string16     /* in - alert message */,
 691                            base::string16     /* in - default prompt */,
 692                            GURL               /* in - originating page URL */,
 693                            content::JavaScriptMessageType /* in - type */,
 694                            bool               /* out - success */,
 695                            base::string16     /* out - user_input field */)
 696
 697 // Displays a dialog to confirm that the user wants to navigate away from the
 698 // page. Replies true if yes, and false otherwise. The reply string is ignored,
 699 // but is included so that we can use OnJavaScriptMessageBoxClosed.
 700 IPC_SYNC_MESSAGE_ROUTED3_2(FrameHostMsg_RunBeforeUnloadConfirm,
 701                            GURL,           /* in - originating frame URL */
 702                            base::string16  /* in - alert message */,
 703                            bool            /* in - is a reload */,
 704                            bool            /* out - success */,
 705                            base::string16  /* out - This is ignored.*/)
 706
 707 // Asks the browser to open the color chooser.
 708 IPC_MESSAGE_ROUTED3(FrameHostMsg_OpenColorChooser,
 709                     int /* id */,
 710                     SkColor /* color */,
 711                     std::vector<content::ColorSuggestion> /* suggestions */)
 712
 713 // Asks the browser to end the color chooser.
 714 IPC_MESSAGE_ROUTED1(FrameHostMsg_EndColorChooser, int /* id */)
 715
 716 // Change the selected color in the color chooser.
 717 IPC_MESSAGE_ROUTED2(FrameHostMsg_SetSelectedColorInColorChooser,
 718                     int /* id */,
 719                     SkColor /* color */)
 720
 721 // Notifies the browser that media has started/stopped playing.
 722 IPC_MESSAGE_ROUTED3(FrameHostMsg_MediaPlayingNotification,
 723                     int64 /* player_cookie, distinguishes instances */,
 724                     bool /* has_video */,
 725                     bool /* has_audio */)
 726
 727 IPC_MESSAGE_ROUTED1(FrameHostMsg_MediaPausedNotification,
 728                     int64 /* player_cookie, distinguishes instances */)
 729
 730 // Notify browser the theme color has been changed.
 731 IPC_MESSAGE_ROUTED1(FrameHostMsg_DidChangeThemeColor,
 732                     SkColor /* theme_color */)
 733
 734 // Response for FrameMsg_TextSurroundingSelectionRequest, |startOffset| and
 735 // |endOffset| are the offsets of the selection in the returned |content|.
 736 IPC_MESSAGE_ROUTED3(FrameHostMsg_TextSurroundingSelectionResponse,
 737                     base::string16,  /* content */
 738                     size_t, /* startOffset */
 739                     size_t /* endOffset */)
 740
 741 // Notifies the browser that the renderer has a pending navigation transition.
 742 // The string parameters are all UTF8.
 743 IPC_MESSAGE_CONTROL4(FrameHostMsg_AddNavigationTransitionData,
 744                      int /* render_frame_id */,
 745                      std::string  /* allowed_destination_host_pattern */,
 746                      std::string  /* selector */,
 747                      std::string  /* markup */)
 748
 749 // Tells the browser to perform a navigation.
 750 IPC_MESSAGE_ROUTED1(FrameHostMsg_BeginNavigation,
 751                     FrameHostMsg_BeginNavigation_Params)
 752
 753 // Sent once a paint happens after the first non empty layout. In other words
 754 // after the frame has painted something.
 755 IPC_MESSAGE_ROUTED0(FrameHostMsg_DidFirstVisuallyNonEmptyPaint)
 756
 757 #if defined(OS_MACOSX) || defined(OS_ANDROID)
 758
 759 // Message to show/hide a popup menu using native controls.
 760 IPC_MESSAGE_ROUTED1(FrameHostMsg_ShowPopup,
 761                     FrameHostMsg_ShowPopup_Params)
 762 IPC_MESSAGE_ROUTED0(FrameHostMsg_HidePopup)
 763
 764 #endif