| /* |
| * 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 THIRD_PARTY_BLINK_PUBLIC_WEB_MODULES_SERVICE_WORKER_WEB_SERVICE_WORKER_CONTEXT_CLIENT_H_ |
| #define THIRD_PARTY_BLINK_PUBLIC_WEB_MODULES_SERVICE_WORKER_WEB_SERVICE_WORKER_CONTEXT_CLIENT_H_ |
| |
| #include <memory> |
| |
| #include "base/time/time.h" |
| #include "third_party/blink/public/mojom/service_worker/service_worker_event_status.mojom-shared.h" |
| #include "third_party/blink/public/platform/modules/service_worker/web_service_worker_stream_handle.h" |
| #include "third_party/blink/public/platform/web_feature.mojom-shared.h" |
| #include "third_party/blink/public/platform/web_url.h" |
| #include "third_party/blink/public/platform/web_worker_fetch_context.h" |
| #include "v8/include/v8.h" |
| |
| namespace blink { |
| |
| struct WebPaymentHandlerResponse; |
| class WebServiceWorkerContextProxy; |
| class WebServiceWorkerNetworkProvider; |
| class WebServiceWorkerResponse; |
| class WebString; |
| |
| // WebServiceWorkerContextClient is a "client" of a service worker execution |
| // context. This interface is implemented by the embedder and allows the |
| // embedder to communicate with the service worker execution context. It is |
| // created on the main thread and then passed on to the worker thread by a newly |
| // created ServiceWorkerGlobalScope. |
| // |
| // Unless otherwise noted, all methods of this class are called on the worker |
| // thread. |
| class WebServiceWorkerContextClient { |
| public: |
| virtual ~WebServiceWorkerContextClient() = default; |
| |
| // ServiceWorker has prepared everything for script loading and is now ready |
| // for DevTools inspection. |
| virtual void WorkerReadyForInspection() {} |
| |
| // Starting the worker failed. This could happen when loading the worker |
| // script failed, or the worker was asked to terminate before startup |
| // completed. Called on the main thread. |
| virtual void WorkerContextFailedToStart() {} |
| |
| // The worker started but it could not execute because loading the |
| // installed script failed. |
| virtual void FailedToLoadInstalledScript() {} |
| |
| // The worker script successfully loaded. Called on the main thread when the |
| // script is served from ResourceLoader or on the worker thread when the |
| // script is served via WebServiceWorkerInstalledScriptsManager. |
| // |
| // This may be called before or after WorkerContextStarted(). Script |
| // evaluation does not start until WillEvaluateScript(). |
| virtual void WorkerScriptLoaded() {} |
| |
| // Called when a WorkerGlobalScope was created for the worker thread. This |
| // also gives a proxy to the embedder to talk to the newly created |
| // WorkerGlobalScope. The proxy is owned by WorkerGlobalScope and should not |
| // be destroyed by the caller. No proxy methods should be called after |
| // willDestroyWorkerContext() is called. |
| // |
| // This may be called before or after WorkerScriptLoaded(). Script evaluation |
| // does not start until WillEvaluateScript(). |
| virtual void WorkerContextStarted(WebServiceWorkerContextProxy*) {} |
| |
| // Called immediately before V8 script evaluation starts for the main script. |
| // This means all setup is finally complete: the script has been loaded, the |
| // worker thread has started, the script has been passed to the worker thread, |
| // and CSP and ReferrerPolicy information has been set on the worker thread. |
| virtual void WillEvaluateScript() {} |
| |
| // Called when initial script evaluation finished for the main script. |
| // |success| is true if the evaluation completed with no uncaught exception. |
| virtual void DidEvaluateScript(bool success) {} |
| |
| // Called when the worker context is initialized. This is probably called |
| // after WorkerContextStarted(). (WorkerThread::InitializeOnWorkerThread() |
| // calls WorkerContextStarted() via |
| // WorkerReportingProxy::DidCreateWorkerGlobalScope(), |
| // and then initializes the worker context if "needed" and calls |
| // DidInitializeWorkerContext(), but it's not clear when the context would |
| // already be initialized.) |
| // |
| // This function is used to support service workers in Chrome extensions. |
| // |
| // TODO(nhiroki): Can you clarify this code and comment? |
| virtual void DidInitializeWorkerContext(v8::Local<v8::Context> context) {} |
| |
| // WorkerGlobalScope is about to be destroyed. The client should clear |
| // the WebServiceWorkerGlobalScopeProxy when this is called. |
| virtual void WillDestroyWorkerContext(v8::Local<v8::Context> context) {} |
| |
| // WorkerGlobalScope was destroyed and the worker is ready to be terminated. |
| virtual void WorkerContextDestroyed() {} |
| |
| // Called when some API to be recorded in UseCounter is called on the worker |
| // global scope. |
| virtual void CountFeature(mojom::WebFeature feature) {} |
| |
| // Called when the WorkerGlobalScope had an error or an exception. |
| virtual void ReportException(const WebString& error_message, |
| int line_number, |
| int column_number, |
| const WebString& source_url) {} |
| |
| // Called when a console message was written. |
| virtual void ReportConsoleMessage(int source, |
| int level, |
| const WebString& message, |
| int line_number, |
| const WebString& source_url) {} |
| |
| // Called after an 'activate' event completed. |
| virtual void DidHandleActivateEvent(int event_id, |
| mojom::ServiceWorkerEventStatus, |
| base::TimeTicks event_dispatch_time) {} |
| |
| // Called after Background Fetch events (dispatched via |
| // WebServiceWorkerContextProxy) are handled by the service worker. |
| virtual void DidHandleBackgroundFetchAbortEvent( |
| int event_id, |
| mojom::ServiceWorkerEventStatus, |
| base::TimeTicks event_dispatch_time) {} |
| virtual void DidHandleBackgroundFetchClickEvent( |
| int event_id, |
| mojom::ServiceWorkerEventStatus, |
| base::TimeTicks event_dispatch_time) {} |
| virtual void DidHandleBackgroundFetchFailEvent( |
| int event_id, |
| mojom::ServiceWorkerEventStatus, |
| base::TimeTicks event_dispatch_time) {} |
| virtual void DidHandleBackgroundFetchSuccessEvent( |
| int event_id, |
| mojom::ServiceWorkerEventStatus, |
| base::TimeTicks event_dispatch_time) {} |
| |
| // Called after 'cookiechange' events are handled by the service worker. |
| virtual void DidHandleCookieChangeEvent(int event_id, |
| mojom::ServiceWorkerEventStatus, |
| base::TimeTicks event_dispatch_time) { |
| } |
| |
| // Called after ExtendableMessageEvent was handled by the service worker. |
| virtual void DidHandleExtendableMessageEvent( |
| int event_id, |
| mojom::ServiceWorkerEventStatus, |
| base::TimeTicks event_dispatch_time) {} |
| |
| // RespondToFetchEvent* will be called after the service worker returns a |
| // response to a FetchEvent, and DidHandleFetchEvent will be called after the |
| // end of FetchEvent's lifecycle. |fetch_event_id| is the id that was passed |
| // to DispatchFetchEvent. |
| |
| // Used when respondWith() is not called. Tells the browser to fall back to |
| // native fetch. |
| virtual void RespondToFetchEventWithNoResponse( |
| int fetch_event_id, |
| base::TimeTicks event_dispatch_time, |
| base::TimeTicks respond_with_settled_time) {} |
| // Responds to the fetch event with |response|. |
| virtual void RespondToFetchEvent(int fetch_event_id, |
| const WebServiceWorkerResponse& response, |
| base::TimeTicks event_dispatch_time, |
| base::TimeTicks respond_with_settled_time) {} |
| // Responds to the fetch event with |response|, where body is |
| // |body_as_stream|. |
| virtual void RespondToFetchEventWithResponseStream( |
| int fetch_event_id, |
| const WebServiceWorkerResponse& response, |
| WebServiceWorkerStreamHandle* body_as_stream, |
| base::TimeTicks event_dispatch_time, |
| base::TimeTicks respond_with_settled_time) {} |
| virtual void DidHandleFetchEvent(int fetch_event_id, |
| mojom::ServiceWorkerEventStatus, |
| base::TimeTicks event_dispatch_time) {} |
| |
| // Called after InstallEvent (dispatched via WebServiceWorkerContextProxy) is |
| // handled by the service worker. |
| virtual void DidHandleInstallEvent(int install_event_id, |
| mojom::ServiceWorkerEventStatus, |
| base::TimeTicks event_dispatch_time) {} |
| |
| // Called after NotificationClickEvent (dispatched via |
| // WebServiceWorkerContextProxy) is handled by the service worker. |
| virtual void DidHandleNotificationClickEvent( |
| int event_id, |
| mojom::ServiceWorkerEventStatus, |
| base::TimeTicks event_dispatch_time) {} |
| |
| // Called after NotificationCloseEvent (dispatched via |
| // WebServiceWorkerContextProxy) is handled by the service worker. |
| virtual void DidHandleNotificationCloseEvent( |
| int event_id, |
| mojom::ServiceWorkerEventStatus, |
| base::TimeTicks event_dispatch_time) {} |
| |
| // Called after PushEvent (dispatched via WebServiceWorkerContextProxy) is |
| // handled by the service worker. |
| virtual void DidHandlePushEvent(int push_event_id, |
| mojom::ServiceWorkerEventStatus, |
| base::TimeTicks event_dispatch_time) {} |
| |
| // Called after SyncEvent (dispatched via WebServiceWorkerContextProxy) is |
| // handled by the service worker. |
| virtual void DidHandleSyncEvent(int sync_event_id, |
| mojom::ServiceWorkerEventStatus, |
| base::TimeTicks event_dispatch_time) {} |
| |
| // RespondToAbortPaymentEvent will be called after the service worker |
| // returns a response to a AbortPaymentEvent, and DidHandleAbortPaymentEvent |
| // will be called after the end of AbortPaymentEvent's lifecycle. |
| // |event_id| is the id that was passed to DispatchAbortPaymentEvent. |
| virtual void RespondToAbortPaymentEvent(int event_id, |
| bool abort_payment, |
| base::TimeTicks event_dispatch_time) { |
| } |
| // Called after AbortPaymentEvent (dispatched |
| // via WebServiceWorkerContextProxy) is handled by the service worker. |
| virtual void DidHandleAbortPaymentEvent(int abort_payment_event_id, |
| mojom::ServiceWorkerEventStatus, |
| base::TimeTicks event_dispatch_time) { |
| } |
| |
| // RespondToCanMakePaymentEvent will be called after the service worker |
| // returns a response to a CanMakePaymentEvent, and |
| // DidHandleCanMakePaymentEvent will be called after the end of |
| // CanMakePaymentEvent's lifecycle. |event_id| is the id that was passed |
| // to DispatchCanMakePaymentEvent. |
| virtual void RespondToCanMakePaymentEvent( |
| int event_id, |
| bool can_make_payment, |
| base::TimeTicks event_dispatch_time) {} |
| // Called after CanMakePaymentEvent (dispatched |
| // via WebServiceWorkerContextProxy) is handled by the service worker. |
| virtual void DidHandleCanMakePaymentEvent( |
| int payment_request_event_id, |
| mojom::ServiceWorkerEventStatus, |
| base::TimeTicks event_dispatch_time) {} |
| |
| // RespondToPaymentRequestEvent will be called after the service worker |
| // returns a response to a PaymentRequestEvent, and |
| // DidHandlePaymentRequestEvent will be called after the end of |
| // PaymentRequestEvent's lifecycle. |event_id| is the id that was passed |
| // to DispatchPaymentRequestEvent. |
| virtual void RespondToPaymentRequestEvent( |
| int event_id, |
| const WebPaymentHandlerResponse& response, |
| base::TimeTicks event_dispatch_time) {} |
| // Called after PaymentRequestEvent (dispatched via |
| // WebServiceWorkerContextProxy) is handled by the service worker. |
| virtual void DidHandlePaymentRequestEvent( |
| int payment_request_event_id, |
| mojom::ServiceWorkerEventStatus, |
| base::TimeTicks event_dispatch_time) {} |
| |
| // Called on the main thread. |
| virtual std::unique_ptr<WebServiceWorkerNetworkProvider> |
| CreateServiceWorkerNetworkProvider() = 0; |
| |
| // Creates a WebWorkerFetchContext for a service worker. This is called on the |
| // main thread. |
| virtual std::unique_ptr<blink::WebWorkerFetchContext> |
| CreateServiceWorkerFetchContext(WebServiceWorkerNetworkProvider*) { |
| return nullptr; |
| } |
| }; |
| |
| } // namespace blink |
| |
| #endif // THIRD_PARTY_BLINK_PUBLIC_WEB_MODULES_SERVICE_WORKER_WEB_SERVICE_WORKER_CONTEXT_CLIENT_H_ |