Forwarding POST body into renderer after a cross-site transfer.

content/public/browser/navigation_handle.h

 // Copyright 2015 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef CONTENT_PUBLIC_BROWSER_NAVIGATION_HANDLE_H_
 #define CONTENT_PUBLIC_BROWSER_NAVIGATION_HANDLE_H_
 
 #include <memory>
 
 #include "content/common/content_export.h"
@@ skipping 71 matching lines @@
   // browser process. Corresponds to Navigation Timing API.
   virtual const base::TimeTicks& NavigationStart() = 0;
 
   // Parameters available at network request start time ------------------------
   //
   // The following parameters are only available when the network request is
   // made for the navigation (or at commit time if no network request is made).
   // This corresponds to NavigationThrottle::WillSendRequest. They should not
   // be queried before that.
 
-  // Whether the navigation is a POST or a GET. This may change during the
-  // navigation when encountering a server redirect.
+  // Whether the navigation is done using HTTP POST method. This may change
+  // during the navigation (e.g. after encountering a server redirect).

[Łukasz Anforowicz, 2016/06/02 22:07:04]

It was misleading (IMO) to say "GET", when in reality the alternative to "HTTP
POST" is "whatever default protocol is used for the scheme" (i.e. it won't be
"GET" for file: or data: URIs).

+  //
+  // Note: page and frame navigations can only be done using HTTP POST or HTTP
+  // GET methods (and using other, scheme-specific protocols for non-http(s) URI
+  // schemes like data: or file:).  Therefore //content public API exposes only
+  // |bool IsPost()| as opposed to |const std::string& GetMethod()| method.
   virtual bool IsPost() = 0;
 
   // Returns a sanitized version of the referrer for this request.
   virtual const Referrer& GetReferrer() = 0;
 
   // Whether the navigation was initiated by a user gesture. Note that this
   // will return false for browser-initiated navigations.
   // TODO(clamy): when PlzNavigate launches, this should return true for
   // browser-initiated navigations.
   virtual bool HasUserGesture() = 0;
@@ skipping 76 matching lines @@
 
   // The NavigationData that the embedder returned from
   // ResourceDispatcherHostDelegate::GetNavigationData during commit. This will
   // be a clone of the NavigationData.
   virtual NavigationData* GetNavigationData() = 0;
 };
 
 }  // namespace content
 
 #endif  // CONTENT_PUBLIC_BROWSER_NAVIGATION_HANDLE_H_