blob: 3837cf4da133dc28901dbcbd2177894ef0cc0ceb [file] [log] [blame]
// Copyright (c) 2011 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_REQUEST_INFO_H__
#define NET_HTTP_HTTP_REQUEST_INFO_H__
#include <string>
#include "base/optional.h"
#include "net/base/idempotency.h"
#include "net/base/net_export.h"
#include "net/base/network_isolation_key.h"
#include "net/base/privacy_mode.h"
#include "net/http/http_request_headers.h"
#include "net/socket/socket_tag.h"
#include "net/traffic_annotation/network_traffic_annotation.h"
#include "url/gurl.h"
#include "url/origin.h"
namespace net {
class UploadDataStream;
struct NET_EXPORT HttpRequestInfo {
HttpRequestInfo();
HttpRequestInfo(const HttpRequestInfo& other);
~HttpRequestInfo();
// The requested URL.
GURL url;
// The method to use (GET, POST, etc.).
std::string method;
// This key is used to isolate requests from different contexts in accessing
// shared network resources like the cache.
NetworkIsolationKey network_isolation_key;
// True if it is a subframe's document resource.
bool is_subframe_document_resource;
// Any extra request headers (including User-Agent).
HttpRequestHeaders extra_headers;
// Any upload data.
UploadDataStream* upload_data_stream;
// Any load flags (see load_flags.h).
int load_flags;
// If enabled, then request must be sent over connection that cannot be
// tracked by the server (e.g. without channel id).
PrivacyMode privacy_mode;
// Whether secure DNS should be disabled for the request.
bool disable_secure_dns;
// Tag applied to all sockets used to service request.
SocketTag socket_tag;
// Network traffic annotation received from URL request.
net::MutableNetworkTrafficAnnotationTag traffic_annotation;
// Reporting upload nesting depth of this request.
//
// If the request is not a Reporting upload, the depth is 0.
//
// If the request is a Reporting upload, the depth is the max of the depth
// of the requests reported within it plus 1.
int reporting_upload_depth;
// This may the top frame origin associated with a request, or it may be the
// top frame site. Or it may be nullptr. Only used for histograms.
//
// TODO(https://crbug.com/1136054): Investigate migrating the one consumer of
// this to NetworkIsolationKey::TopFrameSite(). That gives more consistent
/// behavior, and may still provide useful metrics.
base::Optional<url::Origin> possibly_top_frame_origin;
// Idempotency of the request, which determines that if it is safe to enable
// 0-RTT for the request. By default, 0-RTT is only enabled for safe
// HTTP methods, i.e., GET, HEAD, OPTIONS, and TRACE. For other methods,
// enabling 0-RTT may cause security issues since a network observer can
// replay the request. If the request has any side effects, those effects can
// happen multiple times. It is only safe to enable the 0-RTT if it is known
// that the request is idempotent.
net::Idempotency idempotency;
};
} // namespace net
#endif // NET_HTTP_HTTP_REQUEST_INFO_H__