Add embedder-specific headers to HTTP CONNECT tunnel request

net/http/http_proxy_tunnel_delegate.h

+// Copyright 2014 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 NET_HTTP_HTTP_PROXY_TUNNEL_DELEGATE_H_
+#define NET_HTTP_HTTP_PROXY_TUNNEL_DELEGATE_H_
+
+#include "net/base/net_export.h"
+
+namespace net {
+
+class HttpRequestHeaders;
+class HttpResponseHeaders;
+class HostPortPair;
+
+// Delegate for requests to set up an HTTPS tunnel using the HTTP CONNECT
+// method.
+class NET_EXPORT HttpProxyTunnelDelegate {
+ public:
+  // Called immediately before a proxy tunnel request is sent.
+  // Provides the embedder an opportunity to add extra request headers.

[mef, 2014/09/05 17:22:51]

Would it make sense to comment on parameters here and below, or are they
sufficiently self-explanatory?

+  virtual void OnBeforeRequest(const HostPortPair& proxy_server,
+                               HttpRequestHeaders* extra_headers) = 0;
+
+  // Called after the response headers for the tunnel request are received.
+  virtual void OnHeadersReceived(
+      const HostPortPair& origin,
+      const HostPortPair& proxy_server,
+      const HttpResponseHeaders& response_headers) = 0;
+};
+
+}
+
+#endif  // NET_HTTP_HTTP_PROXY_TUNNEL_DELEGATE_H_