| /* |
| * Copyright (C) 2013 Google Inc. All rights reserved. |
| * |
| * Redistribution and use in source and binary forms, with or without |
| * modification, are permitted provided that the following conditions are |
| * met: |
| * |
| * * Redistributions of source code must retain the above copyright |
| * notice, this list of conditions and the following disclaimer. |
| * * Redistributions in binary form must reproduce the above |
| * copyright notice, this list of conditions and the following disclaimer |
| * in the documentation and/or other materials provided with the |
| * distribution. |
| * * Neither the name of Google Inc. nor the names of its |
| * contributors may be used to endorse or promote products derived from |
| * this software without specific prior written permission. |
| * |
| * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
| * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
| * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
| * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
| * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
| * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
| * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
| * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
| * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
| * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
| * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
| */ |
| |
| #ifndef FetchContext_h |
| #define FetchContext_h |
| |
| #include "platform/PlatformExport.h" |
| #include "platform/heap/Handle.h" |
| #include "platform/loader/fetch/FetchInitiatorInfo.h" |
| #include "platform/loader/fetch/FetchParameters.h" |
| #include "platform/loader/fetch/Resource.h" |
| #include "platform/loader/fetch/ResourceLoadPriority.h" |
| #include "platform/loader/fetch/ResourceLoadScheduler.h" |
| #include "platform/loader/fetch/ResourceRequest.h" |
| #include "platform/network/ContentSecurityPolicyParsers.h" |
| #include "platform/scheduler/public/frame_scheduler.h" |
| #include "platform/weborigin/SecurityViolationReportingPolicy.h" |
| #include "platform/wtf/Forward.h" |
| #include "platform/wtf/Noncopyable.h" |
| #include "public/platform/Platform.h" |
| #include "public/platform/WebApplicationCacheHost.h" |
| #include "public/platform/WebURLLoader.h" |
| #include "public/platform/WebURLRequest.h" |
| #include "public/platform/modules/fetch/fetch_api_request.mojom-shared.h" |
| #include "services/network/public/mojom/request_context_frame_type.mojom-shared.h" |
| |
| namespace blink { |
| |
| class ClientHintsPreferences; |
| class KURL; |
| class MHTMLArchive; |
| class PlatformProbeSink; |
| class ResourceError; |
| class ResourceResponse; |
| class ResourceTimingInfo; |
| |
| enum FetchResourceType { kFetchMainResource, kFetchSubresource }; |
| |
| // The FetchContext is an interface for performing context specific processing |
| // in response to events in the ResourceFetcher. The ResourceFetcher or its job |
| // class, ResourceLoader, may call the methods on a FetchContext. |
| // |
| // Any processing that depends on components outside platform/loader/fetch/ |
| // should be implemented on a subclass of this interface, and then exposed to |
| // the ResourceFetcher via this interface. |
| class PLATFORM_EXPORT FetchContext |
| : public GarbageCollectedFinalized<FetchContext> { |
| WTF_MAKE_NONCOPYABLE(FetchContext); |
| |
| public: |
| // This enum corresponds to blink::MessageSource. We have this not to |
| // introduce any dependency to core/. |
| // |
| // Currently only kJSMessageSource is used, but not to impress readers that |
| // AddConsoleMessage() call from FetchContext() should always use it, which is |
| // not true, we ask users of the Add.*ConsoleMessage() methods to explicitly |
| // specify the MessageSource to use. |
| // |
| // Extend this when needed. |
| enum LogSource { kJSSource }; |
| |
| static FetchContext& NullInstance(); |
| |
| virtual ~FetchContext() = default; |
| |
| virtual void Trace(blink::Visitor*); |
| |
| virtual bool IsFrameFetchContext() { return false; } |
| |
| virtual void AddAdditionalRequestHeaders(ResourceRequest&, FetchResourceType); |
| |
| // Called when the ResourceFetcher observes a data: URI load that contains an |
| // octothorpe ('#') character. This is a temporary method to support an Intent |
| // to Deprecate for spec incompliant handling of '#' characters in data URIs. |
| // |
| // TODO(crbug.com/123004): Remove once we have enough data for the I2D. |
| virtual void RecordDataUriWithOctothorpe() {} |
| |
| // Returns the cache policy for the resource. ResourceRequest is not passed as |
| // a const reference as a header needs to be added for doc.write blocking |
| // intervention. |
| virtual mojom::FetchCacheMode ResourceRequestCachePolicy( |
| const ResourceRequest&, |
| Resource::Type, |
| FetchParameters::DeferOption) const; |
| |
| virtual void DispatchDidChangeResourcePriority(unsigned long identifier, |
| ResourceLoadPriority, |
| int intra_priority_value); |
| |
| // This internally dispatches WebFrameClient::willSendRequest and hooks |
| // request interceptors like ServiceWorker and ApplicationCache. |
| // This may modify the request. |
| enum class RedirectType { kForRedirect, kNotForRedirect }; |
| virtual void PrepareRequest(ResourceRequest&, RedirectType); |
| |
| // The last callback before a request is actually sent to the browser process. |
| // TODO(https://crbug.com/632580): make this take const ResourceRequest&. |
| virtual void DispatchWillSendRequest( |
| unsigned long identifier, |
| ResourceRequest&, |
| const ResourceResponse& redirect_response, |
| Resource::Type, |
| const FetchInitiatorInfo& = FetchInitiatorInfo()); |
| virtual void DispatchDidLoadResourceFromMemoryCache(unsigned long identifier, |
| const ResourceRequest&, |
| const ResourceResponse&); |
| enum class ResourceResponseType { kNotFromMemoryCache, kFromMemoryCache }; |
| virtual void DispatchDidReceiveResponse( |
| unsigned long identifier, |
| const ResourceResponse&, |
| network::mojom::RequestContextFrameType, |
| WebURLRequest::RequestContext, |
| Resource*, |
| ResourceResponseType); |
| virtual void DispatchDidReceiveData(unsigned long identifier, |
| const char* data, |
| int data_length); |
| virtual void DispatchDidReceiveEncodedData(unsigned long identifier, |
| int encoded_data_length); |
| virtual void DispatchDidDownloadData(unsigned long identifier, |
| int data_length, |
| int encoded_data_length); |
| virtual void DispatchDidFinishLoading(unsigned long identifier, |
| double finish_time, |
| int64_t encoded_data_length, |
| int64_t decoded_body_length, |
| bool blocked_cross_site_document); |
| virtual void DispatchDidFail(const KURL&, |
| unsigned long identifier, |
| const ResourceError&, |
| int64_t encoded_data_length, |
| bool is_internal_request); |
| |
| virtual bool ShouldLoadNewResource(Resource::Type) const { return false; } |
| |
| // Called when a resource load is first requested, which may not be when the |
| // load actually begins. |
| virtual void RecordLoadingActivity(const ResourceRequest&, |
| Resource::Type, |
| const AtomicString& fetch_initiator_name); |
| |
| virtual void DidLoadResource(Resource*); |
| |
| virtual void AddResourceTiming(const ResourceTimingInfo&); |
| virtual bool AllowImage(bool, const KURL&) const { return false; } |
| virtual ResourceRequestBlockedReason CanRequest( |
| Resource::Type, |
| const ResourceRequest&, |
| const KURL&, |
| const ResourceLoaderOptions&, |
| SecurityViolationReportingPolicy, |
| FetchParameters::OriginRestriction, |
| ResourceRequest::RedirectStatus) const { |
| return ResourceRequestBlockedReason::kOther; |
| } |
| virtual ResourceRequestBlockedReason CheckCSPForRequest( |
| WebURLRequest::RequestContext, |
| const KURL&, |
| const ResourceLoaderOptions&, |
| SecurityViolationReportingPolicy, |
| ResourceRequest::RedirectStatus) const { |
| return ResourceRequestBlockedReason::kOther; |
| } |
| virtual ResourceRequestBlockedReason CheckResponseNosniff( |
| WebURLRequest::RequestContext, |
| const ResourceResponse&) const { |
| return ResourceRequestBlockedReason::kOther; |
| } |
| |
| virtual bool IsControlledByServiceWorker() const { return false; } |
| virtual int64_t ServiceWorkerID() const { return -1; } |
| virtual int ApplicationCacheHostID() const { |
| return WebApplicationCacheHost::kAppCacheNoHostId; |
| } |
| |
| virtual bool IsMainFrame() const { return true; } |
| virtual bool DefersLoading() const { return false; } |
| virtual bool IsLoadComplete() const { return false; } |
| virtual bool UpdateTimingInfoForIFrameNavigation(ResourceTimingInfo*) { |
| return false; |
| } |
| |
| virtual void AddWarningConsoleMessage(const String&, LogSource) const; |
| virtual void AddErrorConsoleMessage(const String&, LogSource) const; |
| |
| virtual const SecurityOrigin* GetSecurityOrigin() const { return nullptr; } |
| |
| // Populates the ResourceRequest using the given values and information |
| // stored in the FetchContext implementation. Used by ResourceFetcher to |
| // prepare a ResourceRequest instance at the start of resource loading. |
| virtual void PopulateResourceRequest(Resource::Type, |
| const ClientHintsPreferences&, |
| const FetchParameters::ResourceWidth&, |
| ResourceRequest&); |
| |
| virtual MHTMLArchive* Archive() const { return nullptr; } |
| |
| PlatformProbeSink* GetPlatformProbeSink() const { |
| return platform_probe_sink_; |
| } |
| |
| virtual std::unique_ptr<WebURLLoader> CreateURLLoader( |
| const ResourceRequest&, |
| scoped_refptr<base::SingleThreadTaskRunner>, |
| const ResourceLoaderOptions&) { |
| NOTREACHED(); |
| return nullptr; |
| } |
| |
| // Returns the initial throttling policy used by the associated |
| // ResourceLoadScheduler. |
| virtual ResourceLoadScheduler::ThrottlingPolicy InitialLoadThrottlingPolicy() |
| const { |
| return ResourceLoadScheduler::ThrottlingPolicy::kNormal; |
| } |
| |
| virtual bool IsDetached() const { return false; } |
| |
| // Obtains FrameScheduler instance that is used in the attached frame. |
| // May return nullptr if a frame is not attached or detached. |
| virtual FrameScheduler* GetFrameScheduler() const { return nullptr; } |
| |
| // Returns a task runner intended for loading tasks. Should work even in a |
| // worker context, where FrameScheduler doesn't exist, but the returned |
| // base::SingleThreadTaskRunner will not work after the context detaches |
| // (after Detach() is called, this will return a generic timer suitable for |
| // post-detach actions like keepalive requests. |
| virtual scoped_refptr<base::SingleThreadTaskRunner> GetLoadingTaskRunner() { |
| return Platform::Current()->CurrentThread()->GetTaskRunner(); |
| } |
| |
| // Called when the underlying context is detached. Note that some |
| // FetchContexts continue working after detached (e.g., for fetch() operations |
| // with "keepalive" specified). |
| // Returns a "detached" fetch context which can be null. |
| virtual FetchContext* Detach() { return nullptr; } |
| |
| // Returns the updated priority of the resource based on the experiments that |
| // may be currently enabled. |
| virtual ResourceLoadPriority ModifyPriorityForExperiments( |
| ResourceLoadPriority priority) const { |
| return priority; |
| } |
| |
| // Returns if the |resource_url| is identified as ad. |
| virtual bool IsAdResource( |
| const KURL& resource_url, |
| Resource::Type type, |
| WebURLRequest::RequestContext request_context) const { |
| return false; |
| } |
| |
| protected: |
| FetchContext(); |
| |
| private: |
| Member<PlatformProbeSink> platform_probe_sink_; |
| }; |
| |
| } // namespace blink |
| |
| #endif |
