Source code

Revision control

Copy as Markdown

Other Tools

/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
/* vim: set sw=2 ts=8 et tw=80 : */
/* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at */
#ifndef mozilla_net_HttpBaseChannel_h
#define mozilla_net_HttpBaseChannel_h
#include <utility>
#include "OpaqueResponseUtils.h"
#include "mozilla/AtomicBitfields.h"
#include "mozilla/Atomics.h"
#include "mozilla/dom/DOMTypes.h"
#include "mozilla/DataMutex.h"
#include "mozilla/net/DNS.h"
#include "mozilla/net/NeckoChannelParams.h"
#include "mozilla/net/NeckoCommon.h"
#include "mozilla/net/PrivateBrowsingChannel.h"
#include "nsCOMPtr.h"
#include "nsHashPropertyBag.h"
#include "nsHttp.h"
#include "nsHttpHandler.h"
#include "nsHttpRequestHead.h"
#include "nsIClassOfService.h"
#include "nsIClassifiedChannel.h"
#include "nsIConsoleReportCollector.h"
#include "nsIEncodedChannel.h"
#include "nsIForcePendingChannel.h"
#include "nsIFormPOSTActionChannel.h"
#include "nsIHttpChannel.h"
#include "nsIHttpChannelInternal.h"
#include "nsILoadInfo.h"
#include "nsIResumableChannel.h"
#include "nsIStringEnumerator.h"
#include "nsISupportsPriority.h"
#include "nsIThrottledInputChannel.h"
#include "nsITimedChannel.h"
#include "nsITraceableChannel.h"
#include "nsITransportSecurityInfo.h"
#include "nsIURI.h"
#include "nsIUploadChannel2.h"
#include "nsStringEnumerator.h"
#include "nsStringFwd.h"
#include "nsTArray.h"
#include "nsThreadUtils.h"
{ \
0x9d5cde03, 0xe6e9, 0x4612, { \
0xbf, 0xef, 0xbb, 0x66, 0xf3, 0xbb, 0x74, 0x46 \
} \
class nsIProgressEventSink;
class nsISecurityConsoleMessage;
class nsIPrincipal;
namespace mozilla {
namespace dom {
class PerformanceStorage;
class ContentParent;
} // namespace dom
class LogCollector;
namespace net {
extern mozilla::LazyLogModule gHttpLog;
class OpaqueResponseBlocker;
class PreferredAlternativeDataTypeParams;
enum CacheDisposition : uint8_t {
kCacheUnresolved = 0,
kCacheHit = 1,
kCacheHitViaReval = 2,
kCacheMissedViaReval = 3,
kCacheMissed = 4,
kCacheUnknown = 5
// These need to be kept in sync with
// "browser.opaqueResponseBlocking.filterFetchResponse"
enum class OpaqueResponseFilterFetch { Never, AllowedByORB, BlockedByORB, All };
* This class is a partial implementation of nsIHttpChannel. It contains code
* shared by nsHttpChannel and HttpChannelChild.
* - Note that this class has nothing to do with nsBaseChannel, which is an
* earlier effort at a base class for channels that somehow never made it all
* the way to the HTTP channel.
class HttpBaseChannel : public nsHashPropertyBag,
public nsIEncodedChannel,
public nsIHttpChannel,
public nsIHttpChannelInternal,
public nsIFormPOSTActionChannel,
public nsIUploadChannel2,
public nsISupportsPriority,
public nsIClassOfService,
public nsIResumableChannel,
public nsITraceableChannel,
public PrivateBrowsingChannel<HttpBaseChannel>,
public nsITimedChannel,
public nsIForcePendingChannel,
public nsIConsoleReportCollector,
public nsIThrottledInputChannel,
public nsIClassifiedChannel {
virtual ~HttpBaseChannel();
[[nodiscard]] virtual nsresult Init(nsIURI* aURI, uint32_t aCaps,
nsProxyInfo* aProxyInfo,
uint32_t aProxyResolveFlags,
nsIURI* aProxyURI, uint64_t aChannelId,
ExtContentPolicyType aContentPolicyType,
nsILoadInfo* aLoadInfo);
// nsIRequest
NS_IMETHOD GetName(nsACString& aName) override;
NS_IMETHOD IsPending(bool* aIsPending) override;
NS_IMETHOD GetStatus(nsresult* aStatus) override;
NS_IMETHOD GetLoadGroup(nsILoadGroup** aLoadGroup) override;
NS_IMETHOD SetLoadGroup(nsILoadGroup* aLoadGroup) override;
NS_IMETHOD GetLoadFlags(nsLoadFlags* aLoadFlags) override;
NS_IMETHOD SetLoadFlags(nsLoadFlags aLoadFlags) override;
NS_IMETHOD GetTRRMode(nsIRequest::TRRMode* aTRRMode) override;
NS_IMETHOD SetTRRMode(nsIRequest::TRRMode aTRRMode) override;
NS_IMETHOD SetDocshellUserAgentOverride();
// nsIChannel
NS_IMETHOD GetOriginalURI(nsIURI** aOriginalURI) override;
NS_IMETHOD SetOriginalURI(nsIURI* aOriginalURI) override;
NS_IMETHOD GetURI(nsIURI** aURI) override;
NS_IMETHOD GetOwner(nsISupports** aOwner) override;
NS_IMETHOD SetOwner(nsISupports* aOwner) override;
NS_IMETHOD GetLoadInfo(nsILoadInfo** aLoadInfo) override;
NS_IMETHOD SetLoadInfo(nsILoadInfo* aLoadInfo) override;
NS_IMETHOD GetIsDocument(bool* aIsDocument) override;
NS_IMETHOD GetNotificationCallbacks(
nsIInterfaceRequestor** aCallbacks) override;
NS_IMETHOD SetNotificationCallbacks(
nsIInterfaceRequestor* aCallbacks) override;
NS_IMETHOD GetContentType(nsACString& aContentType) override;
NS_IMETHOD SetContentType(const nsACString& aContentType) override;
NS_IMETHOD GetContentCharset(nsACString& aContentCharset) override;
NS_IMETHOD SetContentCharset(const nsACString& aContentCharset) override;
NS_IMETHOD GetContentDisposition(uint32_t* aContentDisposition) override;
NS_IMETHOD SetContentDisposition(uint32_t aContentDisposition) override;
NS_IMETHOD GetContentDispositionFilename(
nsAString& aContentDispositionFilename) override;
NS_IMETHOD SetContentDispositionFilename(
const nsAString& aContentDispositionFilename) override;
NS_IMETHOD GetContentDispositionHeader(
nsACString& aContentDispositionHeader) override;
NS_IMETHOD GetContentLength(int64_t* aContentLength) override;
NS_IMETHOD SetContentLength(int64_t aContentLength) override;
NS_IMETHOD Open(nsIInputStream** aResult) override;
NS_IMETHOD GetBlockAuthPrompt(bool* aValue) override;
NS_IMETHOD SetBlockAuthPrompt(bool aValue) override;
NS_IMETHOD GetCanceled(bool* aCanceled) override;
// nsIEncodedChannel
NS_IMETHOD GetApplyConversion(bool* value) override;
NS_IMETHOD SetApplyConversion(bool value) override;
NS_IMETHOD GetContentEncodings(nsIUTF8StringEnumerator** aEncodings) override;
NS_IMETHOD DoApplyContentConversions(nsIStreamListener* aNextListener,
nsIStreamListener** aNewNextListener,
nsISupports* aCtxt) override;
NS_IMETHOD SetHasContentDecompressed(bool value) override;
NS_IMETHOD GetHasContentDecompressed(bool* value) override;
// HttpBaseChannel::nsIHttpChannel
NS_IMETHOD GetRequestMethod(nsACString& aMethod) override;
NS_IMETHOD SetRequestMethod(const nsACString& aMethod) override;
NS_IMETHOD GetReferrerInfo(nsIReferrerInfo** aReferrerInfo) override;
NS_IMETHOD SetReferrerInfo(nsIReferrerInfo* aReferrerInfo) override;
NS_IMETHOD SetReferrerInfoWithoutClone(
nsIReferrerInfo* aReferrerInfo) override;
NS_IMETHOD GetRequestHeader(const nsACString& aHeader,
nsACString& aValue) override;
NS_IMETHOD SetRequestHeader(const nsACString& aHeader,
const nsACString& aValue, bool aMerge) override;
NS_IMETHOD SetNewReferrerInfo(const nsACString& aUrl,
nsIReferrerInfo::ReferrerPolicyIDL aPolicy,
bool aSendReferrer) override;
NS_IMETHOD SetEmptyRequestHeader(const nsACString& aHeader) override;
NS_IMETHOD VisitRequestHeaders(nsIHttpHeaderVisitor* visitor) override;
NS_IMETHOD VisitNonDefaultRequestHeaders(
nsIHttpHeaderVisitor* visitor) override;
NS_IMETHOD ShouldStripRequestBodyHeader(const nsACString& aMethod,
bool* aResult) override;
NS_IMETHOD GetResponseHeader(const nsACString& header,
nsACString& value) override;
NS_IMETHOD SetResponseHeader(const nsACString& header,
const nsACString& value, bool merge) override;
NS_IMETHOD VisitResponseHeaders(nsIHttpHeaderVisitor* visitor) override;
NS_IMETHOD GetOriginalResponseHeader(const nsACString& aHeader,
nsIHttpHeaderVisitor* aVisitor) override;
NS_IMETHOD VisitOriginalResponseHeaders(
nsIHttpHeaderVisitor* aVisitor) override;
NS_IMETHOD GetAllowSTS(bool* value) override;
NS_IMETHOD SetAllowSTS(bool value) override;
NS_IMETHOD GetRedirectionLimit(uint32_t* value) override;
NS_IMETHOD SetRedirectionLimit(uint32_t value) override;
NS_IMETHOD IsNoStoreResponse(bool* value) override;
NS_IMETHOD IsNoCacheResponse(bool* value) override;
NS_IMETHOD IsPrivateResponse(bool* value) override;
NS_IMETHOD GetResponseStatus(uint32_t* aValue) override;
NS_IMETHOD GetResponseStatusText(nsACString& aValue) override;
NS_IMETHOD GetRequestSucceeded(bool* aValue) override;
NS_IMETHOD RedirectTo(nsIURI* newURI) override;
NS_IMETHOD UpgradeToSecure() override;
NS_IMETHOD GetRequestContextID(uint64_t* aRCID) override;
NS_IMETHOD GetTransferSize(uint64_t* aTransferSize) override;
NS_IMETHOD GetRequestSize(uint64_t* aRequestSize) override;
NS_IMETHOD GetDecodedBodySize(uint64_t* aDecodedBodySize) override;
NS_IMETHOD GetEncodedBodySize(uint64_t* aEncodedBodySize) override;
NS_IMETHOD GetSupportsHTTP3(bool* aSupportsHTTP3) override;
NS_IMETHOD GetHasHTTPSRR(bool* aHasHTTPSRR) override;
NS_IMETHOD SetRequestContextID(uint64_t aRCID) override;
NS_IMETHOD GetIsMainDocumentChannel(bool* aValue) override;
NS_IMETHOD SetIsMainDocumentChannel(bool aValue) override;
NS_IMETHOD GetProtocolVersion(nsACString& aProtocolVersion) override;
NS_IMETHOD GetChannelId(uint64_t* aChannelId) override;
NS_IMETHOD SetChannelId(uint64_t aChannelId) override;
NS_IMETHOD GetTopLevelContentWindowId(uint64_t* aContentWindowId) override;
NS_IMETHOD SetTopLevelContentWindowId(uint64_t aContentWindowId) override;
NS_IMETHOD GetBrowserId(uint64_t* aId) override;
NS_IMETHOD SetBrowserId(uint64_t aId) override;
NS_IMETHOD GetIsProxyUsed(bool* aIsProxyUsed) override;
using nsIClassifiedChannel::IsThirdPartyTrackingResource;
virtual void SetSource(UniquePtr<ProfileChunkedBuffer> aSource) override {
mSource = std::move(aSource);
// nsIHttpChannelInternal
NS_IMETHOD GetDocumentURI(nsIURI** aDocumentURI) override;
NS_IMETHOD SetDocumentURI(nsIURI* aDocumentURI) override;
NS_IMETHOD GetRequestVersion(uint32_t* major, uint32_t* minor) override;
NS_IMETHOD GetResponseVersion(uint32_t* major, uint32_t* minor) override;
NS_IMETHOD SetCookie(const nsACString& aCookieHeader) override;
NS_IMETHOD GetThirdPartyFlags(uint32_t* aForce) override;
NS_IMETHOD SetThirdPartyFlags(uint32_t aForce) override;
NS_IMETHOD GetForceAllowThirdPartyCookie(bool* aForce) override;
NS_IMETHOD SetForceAllowThirdPartyCookie(bool aForce) override;
NS_IMETHOD GetChannelIsForDownload(bool* aChannelIsForDownload) override;
NS_IMETHOD SetChannelIsForDownload(bool aChannelIsForDownload) override;
NS_IMETHOD SetCacheKeysRedirectChain(nsTArray<nsCString>* cacheKeys) override;
NS_IMETHOD GetLocalAddress(nsACString& addr) override;
NS_IMETHOD GetLocalPort(int32_t* port) override;
NS_IMETHOD GetRemoteAddress(nsACString& addr) override;
NS_IMETHOD GetRemotePort(int32_t* port) override;
NS_IMETHOD GetOnlyConnect(bool* aOnlyConnect) override;
NS_IMETHOD SetConnectOnly() override;
NS_IMETHOD GetAllowSpdy(bool* aAllowSpdy) override;
NS_IMETHOD SetAllowSpdy(bool aAllowSpdy) override;
NS_IMETHOD GetAllowHttp3(bool* aAllowHttp3) override;
NS_IMETHOD SetAllowHttp3(bool aAllowHttp3) override;
NS_IMETHOD GetAllowAltSvc(bool* aAllowAltSvc) override;
NS_IMETHOD SetAllowAltSvc(bool aAllowAltSvc) override;
NS_IMETHOD GetBeConservative(bool* aBeConservative) override;
NS_IMETHOD SetBeConservative(bool aBeConservative) override;
NS_IMETHOD GetBypassProxy(bool* aBypassProxy) override;
NS_IMETHOD SetBypassProxy(bool aBypassProxy) override;
bool BypassProxy();
NS_IMETHOD GetIsTRRServiceChannel(bool* aTRR) override;
NS_IMETHOD SetIsTRRServiceChannel(bool aTRR) override;
NS_IMETHOD GetIsResolvedByTRR(bool* aResolvedByTRR) override;
NS_IMETHOD GetEffectiveTRRMode(
nsIRequest::TRRMode* aEffectiveTRRMode) override;
NS_IMETHOD GetTrrSkipReason(nsITRRSkipReason::value* aTrrSkipReason) override;
NS_IMETHOD GetIsLoadedBySocketProcess(bool* aResult) override;
NS_IMETHOD GetIsOCSP(bool* value) override;
NS_IMETHOD SetIsOCSP(bool value) override;
NS_IMETHOD GetTlsFlags(uint32_t* aTlsFlags) override;
NS_IMETHOD SetTlsFlags(uint32_t aTlsFlags) override;
NS_IMETHOD GetApiRedirectToURI(nsIURI** aApiRedirectToURI) override;
[[nodiscard]] virtual nsresult AddSecurityMessage(
const nsAString& aMessageTag, const nsAString& aMessageCategory);
NS_IMETHOD TakeAllSecurityMessages(
nsCOMArray<nsISecurityConsoleMessage>& aMessages) override;
NS_IMETHOD GetResponseTimeoutEnabled(bool* aEnable) override;
NS_IMETHOD SetResponseTimeoutEnabled(bool aEnable) override;
NS_IMETHOD GetInitialRwin(uint32_t* aRwin) override;
NS_IMETHOD SetInitialRwin(uint32_t aRwin) override;
NS_IMETHOD ForcePending(bool aForcePending) override;
NS_IMETHOD GetLastModifiedTime(PRTime* lastModifiedTime) override;
NS_IMETHOD GetCorsIncludeCredentials(bool* aInclude) override;
NS_IMETHOD SetCorsIncludeCredentials(bool aInclude) override;
NS_IMETHOD GetRequestMode(dom::RequestMode* aRequestMode) override;
NS_IMETHOD SetRequestMode(dom::RequestMode aRequestMode) override;
NS_IMETHOD GetRedirectMode(uint32_t* aRedirectMode) override;
NS_IMETHOD SetRedirectMode(uint32_t aRedirectMode) override;
NS_IMETHOD GetFetchCacheMode(uint32_t* aFetchCacheMode) override;
NS_IMETHOD SetFetchCacheMode(uint32_t aFetchCacheMode) override;
NS_IMETHOD GetTopWindowURI(nsIURI** aTopWindowURI) override;
NS_IMETHOD SetTopWindowURIIfUnknown(nsIURI* aTopWindowURI) override;
NS_IMETHOD GetProxyURI(nsIURI** proxyURI) override;
virtual void SetCorsPreflightParameters(
const nsTArray<nsCString>& unsafeHeaders,
bool aShouldStripRequestBodyHeader) override;
virtual void SetAltDataForChild(bool aIsForChild) override;
virtual void DisableAltDataCache() override {
NS_IMETHOD GetConnectionInfoHashKey(
nsACString& aConnectionInfoHashKey) override;
NS_IMETHOD GetIntegrityMetadata(nsAString& aIntegrityMetadata) override;
NS_IMETHOD SetIntegrityMetadata(const nsAString& aIntegrityMetadata) override;
NS_IMETHOD GetLastRedirectFlags(uint32_t* aValue) override;
NS_IMETHOD SetLastRedirectFlags(uint32_t aValue) override;
NS_IMETHOD GetNavigationStartTimeStamp(TimeStamp* aTimeStamp) override;
NS_IMETHOD SetNavigationStartTimeStamp(TimeStamp aTimeStamp) override;
NS_IMETHOD CancelByURLClassifier(nsresult aErrorCode) override;
NS_IMETHOD SetIPv4Disabled(void) override;
NS_IMETHOD SetIPv6Disabled(void) override;
NS_IMETHOD GetCrossOriginOpenerPolicy(
nsILoadInfo::CrossOriginOpenerPolicy* aCrossOriginOpenerPolicy) override;
NS_IMETHOD ComputeCrossOriginOpenerPolicy(
nsILoadInfo::CrossOriginOpenerPolicy aInitiatorPolicy,
nsILoadInfo::CrossOriginOpenerPolicy* aOutPolicy) override;
NS_IMETHOD HasCrossOriginOpenerPolicyMismatch(bool* aIsMismatch) override;
NS_IMETHOD GetResponseEmbedderPolicy(
bool aIsOriginTrialCoepCredentiallessEnabled,
nsILoadInfo::CrossOriginEmbedderPolicy* aOutPolicy) override;
inline void CleanRedirectCacheChainIfNecessary() {
auto redirectedCachekeys = mRedirectedCachekeys.Lock();
redirectedCachekeys.ref() = nullptr;
NS_IMETHOD HTTPUpgrade(const nsACString& aProtocolName,
nsIHttpUpgradeListener* aListener) override;
void DoDiagnosticAssertWhenOnStopNotCalledOnDestroy() override;
NS_IMETHOD SetWaitForHTTPSSVCRecord() override;
NS_IMETHOD SetEarlyHintPreloaderId(uint64_t aEarlyHintPreloaderId) override;
NS_IMETHOD GetEarlyHintPreloaderId(uint64_t* aEarlyHintPreloaderId) override;
NS_IMETHOD SetEarlyHintLinkType(uint32_t aEarlyHintLinkType) override;
NS_IMETHOD GetEarlyHintLinkType(uint32_t* aEarlyHintLinkType) override;
NS_IMETHOD SetIsUserAgentHeaderModified(bool value) override;
NS_IMETHOD GetIsUserAgentHeaderModified(bool* value) override;
NS_IMETHOD SetClassicScriptHintCharset(
const nsAString& aClassicScriptHintCharset) override;
NS_IMETHOD GetClassicScriptHintCharset(
nsAString& aClassicScriptHintCharset) override;
NS_IMETHOD SetDocumentCharacterSet(
const nsAString& aDocumentCharacterSet) override;
NS_IMETHOD GetDocumentCharacterSet(nsAString& aDocumentCharacterSet) override;
virtual void SetConnectionInfo(
mozilla::net::nsHttpConnectionInfo* aCI) override;
// nsISupportsPriority
NS_IMETHOD GetPriority(int32_t* value) override;
NS_IMETHOD AdjustPriority(int32_t delta) override;
// nsIClassOfService
NS_IMETHOD GetClassFlags(uint32_t* outFlags) override {
*outFlags = mClassOfService.Flags();
return NS_OK;
NS_IMETHOD GetIncremental(bool* outIncremental) override {
*outIncremental = mClassOfService.Incremental();
return NS_OK;
// nsIResumableChannel
NS_IMETHOD GetEntityID(nsACString& aEntityID) override;
// nsIConsoleReportCollector
void AddConsoleReport(uint32_t aErrorFlags, const nsACString& aCategory,
nsContentUtils::PropertiesFile aPropertiesFile,
const nsACString& aSourceFileURI, uint32_t aLineNumber,
uint32_t aColumnNumber, const nsACString& aMessageName,
const nsTArray<nsString>& aStringParams) override;
void FlushReportsToConsole(
uint64_t aInnerWindowID,
ReportAction aAction = ReportAction::Forget) override;
void FlushReportsToConsoleForServiceWorkerScope(
const nsACString& aScope,
ReportAction aAction = ReportAction::Forget) override;
void FlushConsoleReports(
dom::Document* aDocument,
ReportAction aAction = ReportAction::Forget) override;
void FlushConsoleReports(
nsILoadGroup* aLoadGroup,
ReportAction aAction = ReportAction::Forget) override;
void FlushConsoleReports(nsIConsoleReportCollector* aCollector) override;
void StealConsoleReports(
nsTArray<net::ConsoleReportCollected>& aReports) override;
void ClearConsoleReports() override;
class nsContentEncodings : public nsStringEnumeratorBase {
using nsStringEnumeratorBase::GetNext;
nsContentEncodings(nsIHttpChannel* aChannel, const char* aEncodingHeader);
virtual ~nsContentEncodings() = default;
[[nodiscard]] nsresult PrepareForNext(void);
// We do not own the buffer. The channel owns it.
const char* mEncodingHeader;
const char* mCurStart; // points to start of current header
const char* mCurEnd; // points to end of current header
// Hold a ref to our channel so that it can't go away and take the
// header with it.
nsCOMPtr<nsIHttpChannel> mChannel;
bool mReady;
nsHttpResponseHead* GetResponseHead() const { return mResponseHead.get(); }
nsHttpRequestHead* GetRequestHead() { return &mRequestHead; }
nsHttpHeaderArray* GetResponseTrailers() const {
return mResponseTrailers.get();
void SetDummyChannelForImageCache();
const NetAddr& GetSelfAddr() { return mSelfAddr; }
const NetAddr& GetPeerAddr() { return mPeerAddr; }
[[nodiscard]] nsresult OverrideSecurityInfo(
nsITransportSecurityInfo* aSecurityInfo);
void LogORBError(const nsAString& aReason,
const OpaqueResponseBlockedTelemetryReason aTelemetryReason);
public: /* Necko internal use only... */
int64_t GetAltDataLength() { return mAltDataLength; }
bool IsNavigation();
bool IsDeliveringAltData() const { return LoadDeliveringAltData(); }
static void PropagateReferenceIfNeeded(nsIURI* aURI,
nsCOMPtr<nsIURI>& aRedirectURI);
// Return whether upon a redirect code of httpStatus for method, the
// request method should be rewritten to GET.
static bool ShouldRewriteRedirectToGET(
uint32_t httpStatus, nsHttpRequestHead::ParsedMethodType method);
// Like nsIEncodedChannel::DoApplyConversions except context is set to
// mListenerContext.
[[nodiscard]] nsresult DoApplyContentConversions(
nsIStreamListener* aNextListener, nsIStreamListener** aNewNextListener);
void AddClassificationFlags(uint32_t aClassificationFlags,
bool aIsThirdParty);
const uint64_t& ChannelId() const { return mChannelId; }
nsresult InternalSetUploadStream(nsIInputStream* uploadStream,
int64_t aContentLength = -1,
bool aSetContentLengthHeader = false);
void SetUploadStreamHasHeaders(bool hasHeaders) {
virtual nsresult SetReferrerHeader(const nsACString& aReferrer,
bool aRespectBeforeConnect = true) {
if (aRespectBeforeConnect) {
return mRequestHead.SetHeader(nsHttp::Referer, aReferrer);
nsresult ClearReferrerHeader() {
return mRequestHead.ClearHeader(nsHttp::Referer);
void SetTopWindowURI(nsIURI* aTopWindowURI) { mTopWindowURI = aTopWindowURI; }
// Set referrerInfo and compute the referrer header if neccessary.
// Pass true for aSetOriginal if this is a new referrer and should
// overwrite the 'original' value, false if this is a mutation (like
// stripping the path).
nsresult SetReferrerInfoInternal(nsIReferrerInfo* aReferrerInfo, bool aClone,
bool aCompute, bool aRespectBeforeConnect);
struct ReplacementChannelConfig {
ReplacementChannelConfig() = default;
explicit ReplacementChannelConfig(
const dom::ReplacementChannelConfigInit& aInit);
uint32_t redirectFlags = 0;
ClassOfService classOfService = {0, false};
Maybe<bool> privateBrowsing = Nothing();
Maybe<nsCString> method;
nsCOMPtr<nsIReferrerInfo> referrerInfo;
Maybe<dom::TimedChannelInfo> timedChannelInfo;
nsCOMPtr<nsIInputStream> uploadStream;
uint64_t uploadStreamLength = 0;
bool uploadStreamHasHeaders = false;
Maybe<nsCString> contentType;
Maybe<nsCString> contentLength;
dom::ReplacementChannelConfigInit Serialize();
enum class ReplacementReason {
// Create a ReplacementChannelConfig object that can be used to duplicate the
// current channel.
ReplacementChannelConfig CloneReplacementChannelConfig(
bool aPreserveMethod, uint32_t aRedirectFlags, ReplacementReason aReason);
static void ConfigureReplacementChannel(nsIChannel*,
const ReplacementChannelConfig&,
// Called before we create the redirect target channel.
already_AddRefed<nsILoadInfo> CloneLoadInfoForRedirect(
nsIURI* aNewURI, uint32_t aRedirectFlags);
// True if we've already applied content conversion to the data
// passed to mListener.
bool HasAppliedConversion() { return LoadHasAppliedConversion(); }
bool HasRedirectTaintedOrigin() { return LoadTaintedOriginFlag(); }
bool ChannelBlockedByOpaqueResponse() const {
return mChannelBlockedByOpaqueResponse;
bool CachedOpaqueResponseBlockingPref() const {
return mCachedOpaqueResponseBlockingPref;
TimeStamp GetOnStartRequestStartTime() const {
return mOnStartRequestStartTime;
TimeStamp GetDataAvailableStartTime() const {
return mOnDataAvailableStartTime;
TimeStamp GetOnStopRequestStartTime() const {
return mOnStopRequestStartTime;
nsresult GetTopWindowURI(nsIURI* aURIBeingLoaded, nsIURI** aTopWindowURI);
// Handle notifying listener, removing from loadgroup if request failed.
void DoNotifyListener();
virtual void DoNotifyListenerCleanup() = 0;
// drop reference to listener, its callbacks, and the progress sink
virtual void ReleaseListeners();
// Call AsyncAbort().
virtual void DoAsyncAbort(nsresult aStatus) = 0;
// This is fired only when a cookie is created due to the presence of
// Set-Cookie header in the response header of any network request.
// This notification will come only after the "http-on-examine-response"
// was fired.
void NotifySetCookie(const nsACString& aCookie);
void MaybeReportTimingData();
nsIURI* GetReferringPage();
nsPIDOMWindowInner* GetInnerDOMWindow();
void AddCookiesToRequest();
[[nodiscard]] virtual nsresult SetupReplacementChannel(
nsIURI*, nsIChannel*, bool preserveMethod, uint32_t redirectFlags);
bool IsNewChannelSameOrigin(nsIChannel* aNewChannel);
// WHATWG Fetch Standard 4.4. HTTP-redirect fetch, step 10
virtual bool ShouldTaintReplacementChannelOrigin(nsIChannel* aNewChannel,
uint32_t aRedirectFlags);
// bundle calling OMR observers and marking flag into one function
inline void CallOnModifyRequestObservers() {
// Helper function to simplify getting notification callbacks.
template <class T>
void GetCallback(nsCOMPtr<T>& aResult) {
NS_QueryNotificationCallbacks(mCallbacks, mLoadGroup,
// Redirect tracking
// Checks whether or not aURI and mOriginalURI share the same domain.
virtual bool SameOriginWithOriginalUri(nsIURI* aURI);
[[nodiscard]] bool BypassServiceWorker() const;
// Returns true if this channel should intercept the network request and
// prepare for a possible synthesized response instead.
bool ShouldIntercept(nsIURI* aURI = nullptr);
#ifdef DEBUG
// Check if mPrivateBrowsingId matches between LoadInfo and LoadContext.
void AssertPrivateBrowsingId();
static void CallTypeSniffers(void* aClosure, const uint8_t* aData,
uint32_t aCount);
nsresult CheckRedirectLimit(uint32_t aRedirectFlags) const;
bool MaybeWaitForUploadStreamNormalization(nsIStreamListener* aListener,
nsISupports* aContext);
void MaybeFlushConsoleReports();
bool IsBrowsingContextDiscarded() const;
nsresult ProcessCrossOriginEmbedderPolicyHeader();
nsresult ProcessCrossOriginResourcePolicyHeader();
nsresult ComputeCrossOriginOpenerPolicyMismatch();
nsresult ProcessCrossOriginSecurityHeaders();
nsresult ValidateMIMEType();
bool ShouldFilterOpaqueResponse(OpaqueResponseFilterFetch aFilterType) const;
bool ShouldBlockOpaqueResponse() const;
OpaqueResponse BlockOrFilterOpaqueResponse(
OpaqueResponseBlocker* aORB, const nsAString& aReason,
const OpaqueResponseBlockedTelemetryReason aTelemetryReason,
const char* aFormat, ...);
OpaqueResponse PerformOpaqueResponseSafelistCheckBeforeSniff();
OpaqueResponse PerformOpaqueResponseSafelistCheckAfterSniff(
const nsACString& aContentType, bool aNoSniff);
bool NeedOpaqueResponseAllowedCheckAfterSniff() const;
void BlockOpaqueResponseAfterSniff(
const nsAString& aReason,
const OpaqueResponseBlockedTelemetryReason aTelemetryReason);
void AllowOpaqueResponseAfterSniff();
void SetChannelBlockedByOpaqueResponse();
bool Http3Allowed() const;
friend class OpaqueResponseBlocker;
friend class PrivateBrowsingChannel<HttpBaseChannel>;
friend class InterceptFailedOnStop;
friend class HttpChannelParent;
// this section is for main-thread-only object
// all the references need to be proxy released on main thread.
nsCOMPtr<nsIURI> mURI;
nsCOMPtr<nsIURI> mOriginalURI;
nsCOMPtr<nsIURI> mDocumentURI;
nsCOMPtr<nsILoadGroup> mLoadGroup;
nsCOMPtr<nsILoadInfo> mLoadInfo;
nsCOMPtr<nsIInterfaceRequestor> mCallbacks;
nsCOMPtr<nsIProgressEventSink> mProgressSink;
nsCOMPtr<nsIReferrerInfo> mReferrerInfo;
nsCOMPtr<nsIURI> mAPIRedirectToURI;
nsCOMPtr<nsIURI> mProxyURI;
nsCOMPtr<nsIPrincipal> mPrincipal;
nsCOMPtr<nsIURI> mTopWindowURI;
nsCOMPtr<nsIStreamListener> mListener;
// An instance of nsHTTPCompressConv
nsCOMPtr<nsIStreamListener> mCompressListener;
nsCOMPtr<nsIEventTarget> mCurrentThread;
RefPtr<OpaqueResponseBlocker> mORB;
// Proxy release all members above on main thread.
void ReleaseMainThreadOnlyReferences();
void ExplicitSetUploadStreamLength(uint64_t aContentLength,
bool aSetContentLengthHeader);
void MaybeResumeAsyncOpen();
nsCString mSpec; // ASCII encoded URL spec
nsCString mContentTypeHint;
nsCString mContentCharsetHint;
nsCString mUserSetCookieHeader;
// HTTP Upgrade Data
nsCString mUpgradeProtocol;
// Resumable channel specific data
nsCString mEntityID;
// The initiator type (for this resource) - how was the resource referenced in
// the HTML file.
nsString mInitiatorType;
// Holds the name of the preferred alt-data type for each contentType.
nsTArray<PreferredAlternativeDataTypeParams> mPreferredCachedAltDataTypes;
// Holds the name of the alternative data type the channel returned.
nsCString mAvailableCachedAltDataType;
nsString mIntegrityMetadata;
// Classified channel's matched information
nsCString mMatchedList;
nsCString mMatchedProvider;
nsCString mMatchedFullHash;
nsTArray<nsCString> mMatchedTrackingLists;
nsTArray<nsCString> mMatchedTrackingFullHashes;
nsCOMPtr<nsISupports> mOwner;
nsHttpRequestHead mRequestHead;
// Upload throttling.
nsCOMPtr<nsIInputChannelThrottleQueue> mThrottleQueue;
nsCOMPtr<nsIInputStream> mUploadStream;
UniquePtr<nsHttpResponseHead> mResponseHead;
UniquePtr<nsHttpHeaderArray> mResponseTrailers;
RefPtr<nsHttpConnectionInfo> mConnectionInfo;
nsCOMPtr<nsIProxyInfo> mProxyInfo;
nsCOMPtr<nsITransportSecurityInfo> mSecurityInfo;
nsCOMPtr<nsIHttpUpgradeListener> mUpgradeProtocolCallback;
UniquePtr<nsString> mContentDispositionFilename;
nsCOMPtr<nsIConsoleReportCollector> mReportCollector;
RefPtr<nsHttpHandler> mHttpHandler; // keep gHttpHandler alive
// Accessed on MainThread and Cache2 IO thread
DataMutex<UniquePtr<nsTArray<nsCString>>> mRedirectedCachekeys{
nsCOMPtr<nsIRequestContext> mRequestContext;
NetAddr mSelfAddr;
NetAddr mPeerAddr;
nsTArray<std::pair<nsString, nsString>> mSecurityConsoleMessages;
nsTArray<nsCString> mUnsafeHeaders;
// A time value equal to the starting time of the fetch that initiates the
// redirect.
mozilla::TimeStamp mRedirectStartTimeStamp;
// A time value equal to the time immediately after receiving the last byte of
// the response of the last redirect.
mozilla::TimeStamp mRedirectEndTimeStamp;
PRTime mChannelCreationTime;
TimeStamp mChannelCreationTimestamp;
TimeStamp mAsyncOpenTime;
TimeStamp mCacheReadStart;
TimeStamp mCacheReadEnd;
TimeStamp mLaunchServiceWorkerStart;
TimeStamp mLaunchServiceWorkerEnd;
TimeStamp mDispatchFetchEventStart;
TimeStamp mDispatchFetchEventEnd;
TimeStamp mHandleFetchEventStart;
TimeStamp mHandleFetchEventEnd;
TimeStamp mOnStartRequestStartTime;
TimeStamp mOnDataAvailableStartTime;
TimeStamp mOnStopRequestStartTime;
// copied from the transaction before we null out mTransaction
// so that the timing can still be queried from OnStopRequest
TimingStruct mTransactionTimings;
// Gets computed during ComputeCrossOriginOpenerPolicyMismatch so we have
// the channel's policy even if we don't know policy initiator.
nsILoadInfo::CrossOriginOpenerPolicy mComputedCrossOriginOpenerPolicy;
uint64_t mStartPos;
uint64_t mTransferSize;
uint64_t mRequestSize;
uint64_t mDecodedBodySize;
// True only when the channel supports any of the versions of HTTP3
bool mSupportsHTTP3;
uint64_t mEncodedBodySize;
uint64_t mRequestContextID;
// ID of the top-level document's inner window this channel is being
// originated from.
uint64_t mContentWindowId;
uint64_t mBrowserId;
int64_t mAltDataLength;
uint64_t mChannelId;
uint64_t mReqContentLength;
Atomic<nsresult, ReleaseAcquire> mStatus;
// Use Release-Acquire ordering to ensure the OMT ODA is ignored while channel
// is canceled on main thread.
Atomic<bool, ReleaseAcquire> mCanceled;
Atomic<uint32_t, ReleaseAcquire> mFirstPartyClassificationFlags;
Atomic<uint32_t, ReleaseAcquire> mThirdPartyClassificationFlags;
// mutex to guard members accessed during OnDataFinished in
// HttpChannelChild.cpp
Mutex mOnDataFinishedMutex{"HttpChannelChild::OnDataFinishedMutex"};
UniquePtr<ProfileChunkedBuffer> mSource;
uint32_t mLoadFlags;
uint32_t mCaps;
ClassOfService mClassOfService;
// This should be set the the actual TRR mode used to resolve the request.
// Is initially set to TRR_DEFAULT_MODE, but should be updated to the actual
// mode used by the request
nsIRequest::TRRMode mEffectiveTRRMode = nsIRequest::TRR_DEFAULT_MODE;
TRRSkippedReason mTRRSkipReason = TRRSkippedReason::TRR_UNSET;
void SetEarlyHints(
nsTArray<mozilla::net::EarlyHintConnectArgs>&& aEarlyHints);
nsTArray<mozilla::net::EarlyHintConnectArgs>&& TakeEarlyHints();
// Storing Http 103 Early Hint preloads. The parent process is responsible to
// start the early hint preloads, but the http child needs to be able to look
// them up. They are sent via IPC and stored in this variable. This is set on
// main document channel
nsTArray<EarlyHintConnectArgs> mEarlyHints;
// EarlyHintRegistrar id to connect back to the preload. Set on preload
// channels started from the above list
uint64_t mEarlyHintPreloaderId = 0;
uint32_t mEarlyHintLinkType = 0;
nsString mClassicScriptHintCharset;
nsString mDocumentCharacterSet;
// clang-format off
MOZ_ATOMIC_BITFIELDS(mAtomicBitfields1, 32, (
(uint32_t, UpgradeToSecure, 1),
(uint32_t, ApplyConversion, 1),
// Set to true if DoApplyContentConversions has been applied to
// our default mListener.
(uint32_t, HasAppliedConversion, 1),
(uint32_t, IsPending, 1),
(uint32_t, WasOpened, 1),
// if 1 all "http-on-{opening|modify|etc}-request" observers have been
// called.
(uint32_t, RequestObserversCalled, 1),
(uint32_t, ResponseHeadersModified, 1),
(uint32_t, AllowSTS, 1),
(uint32_t, ThirdPartyFlags, 3),
(uint32_t, UploadStreamHasHeaders, 1),
(uint32_t, ChannelIsForDownload, 1),
(uint32_t, TracingEnabled, 1),
// True if timing collection is enabled
(uint32_t, TimingEnabled, 1),
(uint32_t, ReportTiming, 1),
(uint32_t, AllowSpdy, 1),
(uint32_t, AllowHttp3, 1),
(uint32_t, AllowAltSvc, 1),
// !!! This is also used by the URL classifier to exempt channels from
// classification. If this is changed or removed, make sure we also update
// NS_ShouldClassifyChannel accordingly !!!
(uint32_t, BeConservative, 1),
// If the current channel is used to as a TRR connection.
(uint32_t, IsTRRServiceChannel, 1),
// If the request was performed to a TRR resolved IP address.
// Will be false if loading the resource does not create a connection
// (for example when it's loaded from the cache).
(uint32_t, ResolvedByTRR, 1),
(uint32_t, ResponseTimeoutEnabled, 1),
// A flag that should be false only if a cross-domain redirect occurred
(uint32_t, AllRedirectsSameOrigin, 1),
// Is 1 if no redirects have occured or if all redirects
// pass the Resource Timing timing-allow-check
(uint32_t, AllRedirectsPassTimingAllowCheck, 1),
// True if this channel was intercepted and could receive a synthesized
// response.
(uint32_t, ResponseCouldBeSynthesized, 1),
(uint32_t, BlockAuthPrompt, 1),
// If true, we behave as if the LOAD_FROM_CACHE flag has been set.
// Used to enforce that flag's behavior but not expose it externally.
(uint32_t, AllowStaleCacheContent, 1),
// If true, we behave as if the VALIDATE_ALWAYS flag has been set.
// Used to force validate the cached content.
(uint32_t, ForceValidateCacheContent, 1),
// If true, we prefer the LOAD_FROM_CACHE flag over LOAD_BYPASS_CACHE or
(uint32_t, PreferCacheLoadOverBypass, 1),
(uint32_t, IsProxyUsed, 1)
// Broken up into two bitfields to avoid alignment requirements of uint64_t.
// (Too many bits used for one uint32_t.)
MOZ_ATOMIC_BITFIELDS(mAtomicBitfields2, 32, (
// True iff this request has been calculated in its request context as
// a non tail request. We must remove it again when this channel is done.
(uint32_t, AddedAsNonTailRequest, 1),
// True if AsyncOpen() is called when the upload stream normalization or
// length is still unknown. AsyncOpen() will be retriggered when
// normalization is complete and length has been determined.
(uint32_t, AsyncOpenWaitingForStreamNormalization, 1),
// Defaults to true. This is set to false when it is no longer possible
// to upgrade the request to a secure channel.
(uint32_t, UpgradableToSecure, 1),
// Tainted origin flag of a request, specified by
// WHATWG Fetch Standard 2.2.5.
(uint32_t, TaintedOriginFlag, 1),
// If the channel is being used to check OCSP
(uint32_t, IsOCSP, 1),
// Used by system requests such as remote settings and updates to
// retry requests without proxies.
(uint32_t, BypassProxy, 1),
// Indicate whether the response of this channel is coming from
// socket process.
(uint32_t, LoadedBySocketProcess, 1),
// Indicates whether the user-agent header has been modifed since the channel
// was created.
(uint32_t, IsUserAgentHeaderModified, 1)
// clang-format on
// An opaque flags for non-standard behavior of the TLS system.
// It is unlikely this will need to be set outside of telemetry studies
// relating to the TLS implementation.
uint32_t mTlsFlags;
// Current suspension depth for this channel object
uint32_t mSuspendCount;
// Per channel transport window override (0 means no override)
uint32_t mInitialRwin;
uint32_t mProxyResolveFlags;
uint32_t mContentDispositionHint;
dom::RequestMode mRequestMode;
uint32_t mRedirectMode;
// If this channel was created as the result of a redirect, then this value
// will reflect the redirect flags passed to the SetupReplacementChannel()
// method.
uint32_t mLastRedirectFlags;
int16_t mPriority;
uint8_t mRedirectionLimit;
// Performance tracking
// Number of redirects that has occurred.
int8_t mRedirectCount;
// Number of internal redirects that has occurred.
int8_t mInternalRedirectCount;
enum class SnifferCategoryType {
NetContent = 0,
SnifferCategoryType mSnifferCategoryType = SnifferCategoryType::NetContent;
// Used to ensure the same pref value is being used across the
// lifetime of this http channel.
const bool mCachedOpaqueResponseBlockingPref;
bool mChannelBlockedByOpaqueResponse;
bool mDummyChannelForImageCache;
bool mHasContentDecompressed;
// clang-format off
MOZ_ATOMIC_BITFIELDS(mAtomicBitfields3, 8, (
(bool, AsyncOpenTimeOverriden, 1),
(bool, ForcePending, 1),
// true if the channel is deliving alt-data.
(bool, DeliveringAltData, 1),
(bool, CorsIncludeCredentials, 1),
// These parameters are used to ensure that we do not call OnStartRequest
// and OnStopRequest more than once.
(bool, OnStartRequestCalled, 1),
(bool, OnStopRequestCalled, 1),
// Defaults to false. Is set to true at the begining of OnStartRequest.
// Used to ensure methods can't be called before OnStartRequest.
(bool, AfterOnStartRequestBegun, 1),
(bool, RequireCORSPreflight, 1)
// Broken up into two bitfields to avoid alignment requirements of uint16_t.
// (Too many bits used for one uint8_t.)
MOZ_ATOMIC_BITFIELDS(mAtomicBitfields4, 8, (
// This flag will be true if the consumer is requesting alt-data AND the
// consumer is in the child process.
(bool, AltDataForChild, 1),
// This flag will be true if the consumer cannot process alt-data. This
// is used in the webextension StreamFilter handler. If true, we bypass
// using alt-data for the request.
(bool, DisableAltDataCache, 1),
(bool, ForceMainDocumentChannel, 1),
// This is set true if the channel is waiting for upload stream
// normalization or the InputStreamLengthHelper::GetAsyncLength callback.
(bool, PendingUploadStreamNormalization, 1),
// Set to true if our listener has indicated that it requires
// content conversion to be done by us.
(bool, ListenerRequiresContentConversion, 1),
// True if this is a navigation to a page with a different cross origin
// opener policy ( see ComputeCrossOriginOpenerPolicyMismatch )
(uint32_t, HasCrossOriginOpenerPolicyMismatch, 1),
// True if HTTPS RR is used during the connection establishment of this
// channel.
(uint32_t, HasHTTPSRR, 1),
// Ensures that ProcessCrossOriginSecurityHeadersCalled has been called
// before calling CallOnStartRequest.
(uint32_t, ProcessCrossOriginSecurityHeadersCalled, 1)
// clang-format on
bool EnsureRequestContextID();
bool EnsureRequestContext();
// Adds/removes this channel as a non-tailed request in its request context
// these helpers ensure we add it only once and remove it only when added
// via AddedAsNonTailRequest member tracking.
void AddAsNonTailRequest();
void RemoveAsNonTailRequest();
void EnsureBrowserId();
// Share some code while working around C++'s absurd inability to handle casting
// of member functions between base/derived types.
// - We want to store member function pointer to call at resume time, but one
// such function--HandleAsyncAbort--we want to share between the
// nsHttpChannel/HttpChannelChild. Can't define it in base class, because
// then we'd have to cast member function ptr between base/derived class
// types. Sigh...
template <class T>
class HttpAsyncAborter {
explicit HttpAsyncAborter(T* derived)
: mThis(derived), mCallOnResume(nullptr) {}
// Aborts channel: calls OnStart/Stop with provided status, removes channel
// from loadGroup.
[[nodiscard]] nsresult AsyncAbort(nsresult status);
// Does most the actual work.
void HandleAsyncAbort();
// AsyncCall calls a member function asynchronously (via an event).
// retval isn't refcounted and is set only when event was successfully
// posted, the event is returned for the purpose of cancelling when needed
[[nodiscard]] virtual nsresult AsyncCall(
void (T::*funcPtr)(), nsRunnableMethod<T>** retval = nullptr);
T* mThis;
// Function to be called at resume time
std::function<nsresult(T*)> mCallOnResume;
template <class T>
[[nodiscard]] nsresult HttpAsyncAborter<T>::AsyncAbort(nsresult status) {
MOZ_LOG(gHttpLog, LogLevel::Debug,
("HttpAsyncAborter::AsyncAbort [this=%p status=%" PRIx32 "]\n", mThis,
mThis->mStatus = status;
// if this fails? Callers ignore our return value anyway....
return AsyncCall(&T::HandleAsyncAbort);
// Each subclass needs to define its own version of this (which just calls this
// base version), else we wind up casting base/derived member function ptrs
template <class T>
inline void HttpAsyncAborter<T>::HandleAsyncAbort() {
MOZ_ASSERT(!mCallOnResume, "How did that happen?");
if (mThis->mSuspendCount) {
gHttpLog, LogLevel::Debug,
("Waiting until resume to do async notification [this=%p]\n", mThis));
mCallOnResume = [](T* self) {
return NS_OK;
// finally remove ourselves from the load group.
if (mThis->mLoadGroup) {
mThis->mLoadGroup->RemoveRequest(mThis, nullptr, mThis->mStatus);
template <class T>
nsresult HttpAsyncAborter<T>::AsyncCall(void (T::*funcPtr)(),
nsRunnableMethod<T>** retval) {
nsresult rv;
RefPtr<nsRunnableMethod<T>> event =
NewRunnableMethod("net::HttpAsyncAborter::AsyncCall", mThis, funcPtr);
rv = NS_DispatchToCurrentThread(event);
if (NS_SUCCEEDED(rv) && retval) {
*retval = event;
return rv;
class ProxyReleaseRunnable final : public mozilla::Runnable {
explicit ProxyReleaseRunnable(nsTArray<nsCOMPtr<nsISupports>>&& aDoomed)
: Runnable("ProxyReleaseRunnable"), mDoomed(std::move(aDoomed)) {}
Run() override {
return NS_OK;
virtual ~ProxyReleaseRunnable() = default;
nsTArray<nsCOMPtr<nsISupports>> mDoomed;
} // namespace net
} // namespace mozilla
#endif // mozilla_net_HttpBaseChannel_h