/* This Source Code Form is subject to the terms of the Mozilla Public *License,v.2.0.IfacopyoftheMPLwasnotdistributedwiththis
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
class nsDocShell; class nsICookieJarSettings; class nsIPolicyContainer; class nsINode; class nsPIDOMWindowOuter;
namespace mozilla {
namespace dom { class PerformanceStorage; class XMLHttpRequestMainThread; class CanonicalBrowsingContext; class WindowGlobalParent;
} // namespace dom
namespace net { class EarlyHintPreloader; class LoadInfoArgs; class LoadInfo; class WebTransportSessionProxy;
} // namespace net
namespace ipc { // we have to forward declare that function so we can use it as a friend.
nsresult LoadInfoArgsToLoadInfo(const mozilla::net::LoadInfoArgs& aLoadInfoArgs, const nsACString& aOriginRemoteType,
nsINode* aCspToInheritLoadingContext,
net::LoadInfo** outLoadInfo);
// Heads-up: LoadInfoToLoadInfoArgs still needs to be manually updated.
namespace net {
using RedirectHistoryArray = nsTArray<nsCOMPtr<nsIRedirectHistoryEntry>>;
/** *ClassthatprovidesannsILoadInfoimplementation.
*/ class LoadInfo final : public nsILoadInfo { template <typename T, typename... Args> friend already_AddRefed<T> mozilla::MakeAndAddRef(Args&&... aArgs);
public:
NS_DECL_ISUPPORTS
NS_DECL_NSILOADINFO
// Currently used for most load types, but prefer the specialized // factories below when possible. aLoadingPrincipal MUST NOT BE NULL. static mozilla::Result<already_AddRefed<LoadInfo>, nsresult> Create(
nsIPrincipal* aLoadingPrincipal, nsIPrincipal* aTriggeringPrincipal,
nsINode* aLoadingContext, nsSecurityFlags aSecurityFlags,
nsContentPolicyType aContentPolicyType, const Maybe<mozilla::dom::ClientInfo>& aLoadingClientInfo =
Maybe<mozilla::dom::ClientInfo>(), const Maybe<mozilla::dom::ServiceWorkerDescriptor>& aController =
Maybe<mozilla::dom::ServiceWorkerDescriptor>(),
uint32_t aSandboxFlags = 0);
// Used for TYPE_FRAME or TYPE_IFRAME load. static already_AddRefed<LoadInfo> CreateForFrame(
dom::CanonicalBrowsingContext* aBrowsingContext,
nsIPrincipal* aTriggeringPrincipal, const nsACString& aTriggeringRemoteType, nsSecurityFlags aSecurityFlags,
uint32_t aSandboxFlags);
// Use for non-{TYPE_DOCUMENT|TYPE_FRAME|TYPE_IFRAME} load. static already_AddRefed<LoadInfo> CreateForNonDocument(
dom::WindowGlobalParent* aParentWGP, nsIPrincipal* aTriggeringPrincipal,
nsContentPolicyType aContentPolicyType, nsSecurityFlags aSecurityFlags,
uint32_t aSandboxFlags);
// Constructor used for TYPE_DOCUMENT loads which have a different // loadingContext than other loads. This ContextForTopLevelLoad is // only used for content policy checks.
LoadInfo(nsPIDOMWindowOuter* aOuterWindow, nsIURI* aURI,
nsIPrincipal* aTriggeringPrincipal,
nsISupports* aContextForTopLevelLoad, nsSecurityFlags aSecurityFlags,
uint32_t aSandboxFlags);
private: // Use factory function Create. // aLoadingPrincipal MUST NOT BE NULL.
LoadInfo(nsIPrincipal* aLoadingPrincipal, nsIPrincipal* aTriggeringPrincipal,
nsINode* aLoadingContext, nsSecurityFlags aSecurityFlags,
nsContentPolicyType aContentPolicyType, const Maybe<mozilla::dom::ClientInfo>& aLoadingClientInfo, const Maybe<mozilla::dom::ServiceWorkerDescriptor>& aController,
uint32_t aSandboxFlags);
// Use factory function CreateForDocument // Used for TYPE_DOCUMENT load.
LoadInfo(dom::CanonicalBrowsingContext* aBrowsingContext, nsIURI* aURI,
nsIPrincipal* aTriggeringPrincipal, const nsACString& aTriggeringRemoteType, const OriginAttributes& aOriginAttributes,
nsSecurityFlags aSecurityFlags, uint32_t aSandboxFlags);
// Use factory function CreateForFrame // Used for TYPE_FRAME or TYPE_IFRAME load.
LoadInfo(dom::CanonicalBrowsingContext* aBrowsingContext,
nsIPrincipal* aTriggeringPrincipal, const nsACString& aTriggeringRemoteType,
nsSecurityFlags aSecurityFlags, uint32_t aSandboxFlags);
// Used for loads initiated by DocumentLoadListener that are not // TYPE_DOCUMENT | TYPE_FRAME | TYPE_FRAME.
LoadInfo(dom::WindowGlobalParent* aParentWGP,
nsIPrincipal* aTriggeringPrincipal, const nsACString& aTriggeringRemoteType,
nsContentPolicyType aContentPolicyType,
nsSecurityFlags aSecurityFlags, uint32_t aSandboxFlags);
public: // Compute a list of ancestor principals and BrowsingContext IDs. // See methods AncestorPrincipals and AncestorBrowsingContextIDs // in nsILoadInfo.idl for details. staticvoid ComputeAncestors(
dom::CanonicalBrowsingContext* aBC,
nsTArray<nsCOMPtr<nsIPrincipal>>& aAncestorPrincipals,
nsTArray<uint64_t>& aBrowsingContextIDs);
// create an exact copy of the loadinfo
already_AddRefed<nsILoadInfo> Clone() const;
// hands off!!! don't use CloneWithNewSecFlags unless you know // exactly what you are doing - it should only be used within // nsBaseChannel::Redirect()
already_AddRefed<nsILoadInfo> CloneWithNewSecFlags(
nsSecurityFlags aSecurityFlags) const; // creates a copy of the loadinfo which is appropriate to use for a // separate request. I.e. not for a redirect or an inner channel, but // when a separate request is made with the same security properties.
already_AddRefed<nsILoadInfo> CloneForNewRequest() const;
// The `nsContentPolicyType GetExternalContentPolicyType()` version // in the base class is hidden by the implementation of // `GetExternalContentPolicyType(nsContentPolicyType* aResult)` in // LoadInfo.cpp. Explicit mark it visible.
using nsILoadInfo::GetExternalContentPolicyType;
// Hands off from the cspToInherit functionality! // // For navigations, GetCSPToInherit returns what the spec calls the // "request's client's global object's CSP list", or more precisely // a snapshot of it taken when the navigation starts. For // navigations that need to inherit their CSP, this is the right CSP // to use for the new document. We need a way to transfer the CSP // from the docshell (where the navigation starts) to the point where // the new document is created and decides whether to inherit its // CSP, and this is the mechanism we use for that. // // For example: // A document with a CSP triggers a new top-level data: URI load. // We pass the CSP of the document that triggered the load all the // way to docshell. Within docshell we call SetCSPToInherit() on the // loadinfo. Within Document::InitCSP() we check if the newly created // document needs to inherit the CSP. If so, we call // GetCSPToInherit() and set the inherited CSP as the CSP for the new // document. Please note that any additonal Meta CSP in that document // will be merged into that CSP. Any subresource loads within that // document subesquently will receive the correct CSP by querying // loadinfo->GetCsp() from that point on. void SetPolicyContainerToInherit(
nsIPolicyContainer* aPolicyContainerToInherit);
private: // Private constructor that is only allowed to be called from within // mozilla::ipc::LoadInfoArgsToLoadInfo declared as friends undeneath. // In e10s we can not serialize nsINode, hence we store the innerWindowID. // Please note that aRedirectChain uses swapElements.
LoadInfo(nsIPrincipal* aLoadingPrincipal, nsIPrincipal* aTriggeringPrincipal,
nsIPrincipal* aPrincipalToInherit, nsIPrincipal* aTopLevelPrincipal,
nsIURI* aResultPrincipalURI,
nsICookieJarSettings* aCookieJarSettings,
nsIPolicyContainer* aPolicyContainerToInherit, const Maybe<dom::FeaturePolicyInfo>& aContainerFeaturePolicyInfo, const nsACString& aTriggeringRemoteType, const nsID& aSandboxedNullPrincipalID, const Maybe<mozilla::dom::ClientInfo>& aClientInfo, const Maybe<mozilla::dom::ClientInfo>& aReservedClientInfo, const Maybe<mozilla::dom::ClientInfo>& aInitialClientInfo, const Maybe<mozilla::dom::ServiceWorkerDescriptor>& aController,
nsSecurityFlags aSecurityFlags, uint32_t aSandboxFlags,
nsContentPolicyType aContentPolicyType, bool aServiceWorkerTaintingSynthesized, LoadTainting aTainting,
// This function is the *only* function which can change the securityflags // of a loadinfo. It only exists because of the XHR code. Don't call it // from anywhere else! void SetIncludeCookiesSecFlag(); friendclass mozilla::dom::XMLHttpRequestMainThread;
// nsDocShell::OpenInitializedChannel, EarlyHintPreloader::OpenChannel and // WebTransportSessionProxy::AsyncConnectWithClient need to update the // loadInfo with the correct browsingContext. friendclass ::nsDocShell; friendclass mozilla::net::EarlyHintPreloader; friendclass mozilla::net::WebTransportSessionProxy; void UpdateBrowsingContextID(uint64_t aBrowsingContextID) {
mBrowsingContextID = aBrowsingContextID;
} void UpdateFrameBrowsingContextID(uint64_t aFrameBrowsingContextID) {
mFrameBrowsingContextID = aFrameBrowsingContextID;
}
// if you add a member, please also update the copy constructor and consider // if it should be merged from parent channel through // ParentLoadInfoForwarderArgs.
nsCOMPtr<nsIPrincipal> mLoadingPrincipal;
nsCOMPtr<nsIPrincipal> mTriggeringPrincipal;
nsCOMPtr<nsIPrincipal> mPrincipalToInherit;
nsCOMPtr<nsIPrincipal> mTopLevelPrincipal;
nsCOMPtr<nsIURI> mResultPrincipalURI;
nsCOMPtr<nsIURI> mChannelCreationOriginalURI;
nsCOMPtr<nsICSPEventListener> mCSPEventListener;
nsCOMPtr<nsICookieJarSettings> mCookieJarSettings;
nsCOMPtr<nsIPolicyContainer> mPolicyContainerToInherit;
Maybe<dom::FeaturePolicyInfo> mContainerFeaturePolicyInfo;
nsCString mTriggeringRemoteType;
nsID mSandboxedNullPrincipalID;
Maybe<RFPTargetSet> mOverriddenFingerprintingSettings; #ifdef DEBUG // A boolean used to ensure the mOverriddenFingerprintingSettings is set // before use it. bool mOverriddenFingerprintingSettingsIsSet = false; #endif
bool mSkipHTTPSUpgrade = false;
}; // This is exposed solely for testing purposes and should not be used outside of // LoadInfo
already_AddRefed<nsIPrincipal> CreateTruncatedPrincipal(nsIPrincipal*);
Die Informationen auf dieser Webseite wurden
nach bestem Wissen sorgfältig zusammengestellt. Es wird jedoch weder Vollständigkeit, noch Richtigkeit,
noch Qualität der bereit gestellten Informationen zugesichert.
Bemerkung:
Die farbliche Syntaxdarstellung und die Messung sind noch experimentell.