/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */ /* vim: set ts=8 sts=2 et sw=2 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 http://mozilla.org/MPL/2.0/. */ #ifndef mozilla_dom_workers_workerprivate_h__ #define mozilla_dom_workers_workerprivate_h__ #include "Workers.h" #include "nsIContentSecurityPolicy.h" #include "nsILoadGroup.h" #include "nsIWorkerDebugger.h" #include "nsPIDOMWindow.h" #include "mozilla/CondVar.h" #include "mozilla/DOMEventTargetHelper.h" #include "mozilla/TimeStamp.h" #include "mozilla/dom/BindingDeclarations.h" #include "nsAutoPtr.h" #include "nsCycleCollectionParticipant.h" #include "nsDataHashtable.h" #include "nsHashKeys.h" #include "nsRefPtrHashtable.h" #include "nsString.h" #include "nsTArray.h" #include "nsThreadUtils.h" #include "nsTObserverArray.h" #include "mozilla/dom/StructuredCloneTags.h" #include "Queue.h" #include "WorkerFeature.h" class JSAutoStructuredCloneBuffer; class nsIChannel; class nsIDocument; class nsIEventTarget; class nsIPrincipal; class nsIScriptContext; class nsISerializable; class nsIThread; class nsIThreadInternal; class nsITimer; class nsIURI; namespace JS { struct RuntimeStats; } namespace mozilla { namespace dom { class Function; } namespace ipc { class PrincipalInfo; } } struct PRThread; class ReportDebuggerErrorRunnable; BEGIN_WORKERS_NAMESPACE class AutoSyncLoopHolder; class MessagePort; class SharedWorker; class ServiceWorkerClientInfo; class WorkerControlRunnable; class WorkerDebugger; class WorkerDebuggerGlobalScope; class WorkerGlobalScope; class WorkerPrivate; class WorkerRunnable; class WorkerThread; // SharedMutex is a small wrapper around an (internal) reference-counted Mutex // object. It exists to avoid changing a lot of code to use Mutex* instead of // Mutex&. class SharedMutex { typedef mozilla::Mutex Mutex; class RefCountedMutex final : public Mutex { public: explicit RefCountedMutex(const char* aName) : Mutex(aName) { } NS_INLINE_DECL_THREADSAFE_REFCOUNTING(RefCountedMutex) private: ~RefCountedMutex() { } }; nsRefPtr mMutex; public: explicit SharedMutex(const char* aName) : mMutex(new RefCountedMutex(aName)) { } SharedMutex(SharedMutex& aOther) : mMutex(aOther.mMutex) { } operator Mutex&() { return *mMutex; } operator const Mutex&() const { return *mMutex; } void AssertCurrentThreadOwns() const { mMutex->AssertCurrentThreadOwns(); } }; template class WorkerPrivateParent : public DOMEventTargetHelper { protected: class EventTarget; friend class EventTarget; typedef mozilla::ipc::PrincipalInfo PrincipalInfo; public: struct LocationInfo { nsCString mHref; nsCString mProtocol; nsCString mHost; nsCString mHostname; nsCString mPort; nsCString mPathname; nsCString mSearch; nsCString mHash; nsString mOrigin; }; protected: typedef mozilla::ErrorResult ErrorResult; SharedMutex mMutex; mozilla::CondVar mCondVar; mozilla::CondVar mMemoryReportCondVar; // Protected by mMutex. nsRefPtr mEventTarget; nsTArray> mPreStartRunnables; private: WorkerPrivate* mParent; nsString mScriptURL; nsCString mSharedWorkerName; LocationInfo mLocationInfo; // The lifetime of these objects within LoadInfo is managed explicitly; // they do not need to be cycle collected. WorkerLoadInfo mLoadInfo; Atomic mLoadingWorkerScript; // Only used for top level workers. nsTArray> mQueuedRunnables; // Protected by mMutex. JSSettings mJSSettings; // Only touched on the parent thread (currently this is always the main // thread as SharedWorkers are always top-level). nsDataHashtable mSharedWorkers; uint64_t mBusyCount; uint64_t mMessagePortSerial; Status mParentStatus; bool mParentFrozen; bool mIsChromeWorker; bool mMainThreadObjectsForgotten; WorkerType mWorkerType; TimeStamp mCreationTimeStamp; DOMHighResTimeStamp mCreationTimeHighRes; TimeStamp mNowBaseTimeStamp; DOMHighResTimeStamp mNowBaseTimeHighRes; protected: // The worker is owned by its thread, which is represented here. This is set // in Construct() and emptied by WorkerFinishedRunnable, and conditionally // traversed by the cycle collector if the busy count is zero. nsRefPtr mSelfRef; WorkerPrivateParent(JSContext* aCx, WorkerPrivate* aParent, const nsAString& aScriptURL, bool aIsChromeWorker, WorkerType aWorkerType, const nsACString& aSharedWorkerName, WorkerLoadInfo& aLoadInfo); ~WorkerPrivateParent(); private: Derived* ParentAsWorkerPrivate() const { return static_cast(const_cast(this)); } // aCx is null when called from the finalizer bool NotifyPrivate(JSContext* aCx, Status aStatus); // aCx is null when called from the finalizer bool TerminatePrivate(JSContext* aCx) { return NotifyPrivate(aCx, Terminating); } void PostMessageInternal(JSContext* aCx, JS::Handle aMessage, const Optional>& aTransferable, bool aToMessagePort, uint64_t aMessagePortSerial, ServiceWorkerClientInfo* aClientInfo, ErrorResult& aRv); nsresult DispatchPrivate(WorkerRunnable* aRunnable, nsIEventTarget* aSyncLoopTarget); public: virtual JSObject* WrapObject(JSContext* aCx, JS::Handle aGivenProto) override; NS_DECL_ISUPPORTS_INHERITED NS_DECL_CYCLE_COLLECTION_SCRIPT_HOLDER_CLASS_INHERITED(WorkerPrivateParent, DOMEventTargetHelper) void EnableDebugger(); void DisableDebugger(); void ClearSelfRef() { AssertIsOnParentThread(); MOZ_ASSERT(mSelfRef); mSelfRef = nullptr; } nsresult Dispatch(WorkerRunnable* aRunnable) { return DispatchPrivate(aRunnable, nullptr); } nsresult DispatchControlRunnable(WorkerControlRunnable* aWorkerControlRunnable); nsresult DispatchDebuggerRunnable(WorkerRunnable* aDebuggerRunnable); already_AddRefed MaybeWrapAsWorkerRunnable(nsIRunnable* aRunnable); already_AddRefed GetEventTarget(); // May be called on any thread... bool Start(); // Called on the parent thread. bool Notify(JSContext* aCx, Status aStatus) { return NotifyPrivate(aCx, aStatus); } bool Cancel(JSContext* aCx) { return Notify(aCx, Canceling); } bool Kill(JSContext* aCx) { return Notify(aCx, Killing); } // We can assume that an nsPIDOMWindow will be available for Freeze, Thaw // as these are only used for globals going in and out of the bfcache. bool Freeze(JSContext* aCx, nsPIDOMWindow* aWindow); bool Thaw(JSContext* aCx, nsPIDOMWindow* aWindow); bool Terminate(JSContext* aCx) { AssertIsOnParentThread(); return TerminatePrivate(aCx); } bool Close(); bool ModifyBusyCount(JSContext* aCx, bool aIncrease); void ForgetOverridenLoadGroup(nsCOMPtr& aLoadGroupOut); void ForgetMainThreadObjects(nsTArray >& aDoomed); void PostMessage(JSContext* aCx, JS::Handle aMessage, const Optional >& aTransferable, ErrorResult& aRv) { PostMessageInternal(aCx, aMessage, aTransferable, false, 0, nullptr, aRv); } void PostMessageToServiceWorker(JSContext* aCx, JS::Handle aMessage, const Optional>& aTransferable, nsAutoPtr& aClientInfo, ErrorResult& aRv); void PostMessageToMessagePort(JSContext* aCx, uint64_t aMessagePortSerial, JS::Handle aMessage, const Optional >& aTransferable, ErrorResult& aRv); bool DispatchMessageEventToMessagePort( JSContext* aCx, uint64_t aMessagePortSerial, JSAutoStructuredCloneBuffer&& aBuffer, nsTArray>& aClonedObjects); void UpdateRuntimeOptions(JSContext* aCx, const JS::RuntimeOptions& aRuntimeOptions); void UpdateLanguages(JSContext* aCx, const nsTArray& aLanguages); void UpdatePreference(JSContext* aCx, WorkerPreference aPref, bool aValue); void UpdateJSWorkerMemoryParameter(JSContext* aCx, JSGCParamKey key, uint32_t value); #ifdef JS_GC_ZEAL void UpdateGCZeal(JSContext* aCx, uint8_t aGCZeal, uint32_t aFrequency); #endif void GarbageCollect(JSContext* aCx, bool aShrinking); void CycleCollect(JSContext* aCx, bool aDummy); void OfflineStatusChangeEvent(JSContext* aCx, bool aIsOffline); bool RegisterSharedWorker(JSContext* aCx, SharedWorker* aSharedWorker); void UnregisterSharedWorker(JSContext* aCx, SharedWorker* aSharedWorker); void BroadcastErrorToSharedWorkers(JSContext* aCx, const nsAString& aMessage, const nsAString& aFilename, const nsAString& aLine, uint32_t aLineNumber, uint32_t aColumnNumber, uint32_t aFlags); void WorkerScriptLoaded(); void QueueRunnable(nsIRunnable* aRunnable) { AssertIsOnMainThread(); mQueuedRunnables.AppendElement(aRunnable); } WorkerPrivate* GetParent() const { return mParent; } bool IsFrozen() const { AssertIsOnParentThread(); return mParentFrozen; } bool IsAcceptingEvents() { AssertIsOnParentThread(); MutexAutoLock lock(mMutex); return mParentStatus < Terminating; } Status ParentStatus() const { mMutex.AssertCurrentThreadOwns(); return mParentStatus; } JSContext* ParentJSContext() const; nsIScriptContext* GetScriptContext() const { AssertIsOnMainThread(); return mLoadInfo.mScriptContext; } const nsString& ScriptURL() const { return mScriptURL; } const nsCString& Domain() const { return mLoadInfo.mDomain; } bool IsFromWindow() const { return mLoadInfo.mFromWindow; } uint64_t WindowID() const { return mLoadInfo.mWindowID; } uint64_t ServiceWorkerID() const { return mLoadInfo.mServiceWorkerID; } nsIURI* GetBaseURI() const { AssertIsOnMainThread(); return mLoadInfo.mBaseURI; } void SetBaseURI(nsIURI* aBaseURI); nsIURI* GetResolvedScriptURI() const { AssertIsOnMainThread(); return mLoadInfo.mResolvedScriptURI; } const nsString& ServiceWorkerCacheName() const { MOZ_ASSERT(IsServiceWorker()); AssertIsOnMainThread(); return mLoadInfo.mServiceWorkerCacheName; } const ChannelInfo& GetChannelInfo() const { MOZ_ASSERT(IsServiceWorker()); return mLoadInfo.mChannelInfo; } void SetChannelInfo(const ChannelInfo& aChannelInfo) { MOZ_ASSERT(IsServiceWorker()); AssertIsOnMainThread(); MOZ_ASSERT(!mLoadInfo.mChannelInfo.IsInitialized()); MOZ_ASSERT(aChannelInfo.IsInitialized()); mLoadInfo.mChannelInfo = aChannelInfo; } void InitChannelInfo(nsIChannel* aChannel) { mLoadInfo.mChannelInfo.InitFromChannel(aChannel); } void InitChannelInfo(const ChannelInfo& aChannelInfo) { mLoadInfo.mChannelInfo = aChannelInfo; } // This is used to handle importScripts(). When the worker is first loaded // and executed, it happens in a sync loop. At this point it sets // mLoadingWorkerScript to true. importScripts() calls that occur during the // execution run in nested sync loops and so this continues to return true, // leading to these scripts being cached offline. // mLoadingWorkerScript is set to false when the top level loop ends. // importScripts() in function calls or event handlers are always fetched // from the network. bool LoadScriptAsPartOfLoadingServiceWorkerScript() { MOZ_ASSERT(IsServiceWorker()); return mLoadingWorkerScript; } void SetLoadingWorkerScript(bool aLoadingWorkerScript) { // any thread MOZ_ASSERT(IsServiceWorker()); mLoadingWorkerScript = aLoadingWorkerScript; } TimeStamp CreationTimeStamp() const { return mCreationTimeStamp; } DOMHighResTimeStamp CreationTimeHighRes() const { return mCreationTimeHighRes; } TimeStamp NowBaseTimeStamp() const { return mNowBaseTimeStamp; } DOMHighResTimeStamp NowBaseTimeHighRes() const { return mNowBaseTimeHighRes; } nsIPrincipal* GetPrincipal() const { AssertIsOnMainThread(); return mLoadInfo.mPrincipal; } nsILoadGroup* GetLoadGroup() const { AssertIsOnMainThread(); return mLoadInfo.mLoadGroup; } // This method allows the principal to be retrieved off the main thread. // Principals are main-thread objects so the caller must ensure that all // access occurs on the main thread. nsIPrincipal* GetPrincipalDontAssertMainThread() const { return mLoadInfo.mPrincipal; } void SetPrincipal(nsIPrincipal* aPrincipal, nsILoadGroup* aLoadGroup); bool UsesSystemPrincipal() const { return mLoadInfo.mPrincipalIsSystem; } bool IsInPrivilegedApp() const { return mLoadInfo.mIsInPrivilegedApp; } bool IsInCertifiedApp() const { return mLoadInfo.mIsInCertifiedApp; } const PrincipalInfo& GetPrincipalInfo() const { return *mLoadInfo.mPrincipalInfo; } already_AddRefed ForgetWorkerChannel() { AssertIsOnMainThread(); return mLoadInfo.mChannel.forget(); } nsIDocument* GetDocument() const; nsPIDOMWindow* GetWindow() { AssertIsOnMainThread(); return mLoadInfo.mWindow; } nsIContentSecurityPolicy* GetCSP() const { AssertIsOnMainThread(); return mLoadInfo.mCSP; } void SetCSP(nsIContentSecurityPolicy* aCSP) { AssertIsOnMainThread(); mLoadInfo.mCSP = aCSP; } bool IsEvalAllowed() const { return mLoadInfo.mEvalAllowed; } void SetEvalAllowed(bool aEvalAllowed) { mLoadInfo.mEvalAllowed = aEvalAllowed; } bool GetReportCSPViolations() const { return mLoadInfo.mReportCSPViolations; } bool XHRParamsAllowed() const { return mLoadInfo.mXHRParamsAllowed; } void SetXHRParamsAllowed(bool aAllowed) { mLoadInfo.mXHRParamsAllowed = aAllowed; } LocationInfo& GetLocationInfo() { return mLocationInfo; } void CopyJSSettings(JSSettings& aSettings) { mozilla::MutexAutoLock lock(mMutex); aSettings = mJSSettings; } void CopyJSCompartmentOptions(JS::CompartmentOptions& aOptions) { mozilla::MutexAutoLock lock(mMutex); aOptions = IsChromeWorker() ? mJSSettings.chrome.compartmentOptions : mJSSettings.content.compartmentOptions; } // The ability to be a chrome worker is orthogonal to the type of // worker [Dedicated|Shared|Service]. bool IsChromeWorker() const { return mIsChromeWorker; } WorkerType Type() const { return mWorkerType; } bool IsDedicatedWorker() const { return mWorkerType == WorkerTypeDedicated; } bool IsSharedWorker() const { return mWorkerType == WorkerTypeShared; } bool IsServiceWorker() const { return mWorkerType == WorkerTypeService; } const nsCString& SharedWorkerName() const { return mSharedWorkerName; } uint64_t NextMessagePortSerial() { AssertIsOnMainThread(); return mMessagePortSerial++; } bool IsIndexedDBAllowed() const { return mLoadInfo.mIndexedDBAllowed; } void GetAllSharedWorkers(nsTArray>& aSharedWorkers); void CloseSharedWorkersForWindow(nsPIDOMWindow* aWindow); void UpdateOverridenLoadGroup(nsILoadGroup* aBaseLoadGroup); IMPL_EVENT_HANDLER(message) IMPL_EVENT_HANDLER(error) #ifdef DEBUG void AssertIsOnParentThread() const; void AssertInnerWindowIsCorrect() const; #else void AssertIsOnParentThread() const { } void AssertInnerWindowIsCorrect() const { } #endif }; class WorkerDebugger : public nsIWorkerDebugger { friend class ::ReportDebuggerErrorRunnable; mozilla::Mutex mMutex; mozilla::CondVar mCondVar; // Protected by mMutex WorkerPrivate* mWorkerPrivate; bool mIsEnabled; // Only touched on the main thread. bool mIsInitialized; bool mIsFrozen; nsTArray> mListeners; public: explicit WorkerDebugger(WorkerPrivate* aWorkerPrivate); NS_DECL_THREADSAFE_ISUPPORTS NS_DECL_NSIWORKERDEBUGGER void AssertIsOnParentThread(); void WaitIsEnabled(bool aIsEnabled); void Enable(); void Disable(); void Freeze(); void Thaw(); void PostMessageToDebugger(const nsAString& aMessage); void ReportErrorToDebugger(const nsAString& aFilename, uint32_t aLineno, const nsAString& aMessage); private: virtual ~WorkerDebugger(); void NotifyIsEnabled(bool aIsEnabled); void FreezeOnMainThread(); void ThawOnMainThread(); void PostMessageToDebuggerOnMainThread(const nsAString& aMessage); void ReportErrorToDebuggerOnMainThread(const nsAString& aFilename, uint32_t aLineno, const nsAString& aMessage); }; class WorkerPrivate : public WorkerPrivateParent { friend class WorkerPrivateParent; typedef WorkerPrivateParent ParentType; friend class AutoSyncLoopHolder; struct TimeoutInfo; class MemoryReporter; friend class MemoryReporter; friend class WorkerThread; enum GCTimerMode { PeriodicTimer = 0, IdleTimer, NoTimer }; nsRefPtr mDebugger; Queue mControlQueue; Queue mDebuggerQueue; // Touched on multiple threads, protected with mMutex. JSContext* mJSContext; nsRefPtr mCrossThreadDispatcher; nsTArray> mUndispatchedRunnablesForSyncLoop; nsRefPtr mThread; PRThread* mPRThread; // Things touched on worker thread only. nsRefPtr mScope; nsRefPtr mDebuggerScope; nsTArray mChildWorkers; nsTObserverArray mFeatures; nsTArray> mTimeouts; uint32_t mDebuggerEventLoopLevel; struct SyncLoopInfo { explicit SyncLoopInfo(EventTarget* aEventTarget); nsRefPtr mEventTarget; bool mCompleted; bool mResult; #ifdef DEBUG bool mHasRun; #endif }; // This is only modified on the worker thread, but in DEBUG builds // AssertValidSyncLoop function iterates it on other threads. Therefore // modifications are done with mMutex held *only* in DEBUG builds. nsTArray> mSyncLoopStack; struct PreemptingRunnableInfo; nsTArray mPreemptingRunnableInfos; nsCOMPtr mTimer; nsCOMPtr mGCTimer; nsCOMPtr mPeriodicGCTimerTarget; nsCOMPtr mIdleGCTimerTarget; nsRefPtr mMemoryReporter; nsRefPtrHashtable mWorkerPorts; TimeStamp mKillTime; uint32_t mErrorHandlerRecursionCount; uint32_t mNextTimeoutId; Status mStatus; bool mFrozen; bool mTimerRunning; bool mRunningExpiredTimeouts; bool mCloseHandlerStarted; bool mCloseHandlerFinished; bool mMemoryReporterRunning; bool mBlockedForMemoryReporter; bool mCancelAllPendingRunnables; bool mPeriodicGCTimerRunning; bool mIdleGCTimerRunning; bool mWorkerScriptExecutedSuccessfully; bool mPreferences[WORKERPREF_COUNT]; bool mOnLine; protected: ~WorkerPrivate(); public: static already_AddRefed Constructor(const GlobalObject& aGlobal, const nsAString& aScriptURL, ErrorResult& aRv); static already_AddRefed Constructor(const GlobalObject& aGlobal, const nsAString& aScriptURL, bool aIsChromeWorker, WorkerType aWorkerType, const nsACString& aSharedWorkerName, WorkerLoadInfo* aLoadInfo, ErrorResult& aRv); static already_AddRefed Constructor(JSContext* aCx, const nsAString& aScriptURL, bool aIsChromeWorker, WorkerType aWorkerType, const nsACString& aSharedWorkerName, WorkerLoadInfo* aLoadInfo, ErrorResult& aRv); static bool WorkerAvailable(JSContext* /* unused */, JSObject* /* unused */); enum LoadGroupBehavior { InheritLoadGroup, OverrideLoadGroup }; static nsresult GetLoadInfo(JSContext* aCx, nsPIDOMWindow* aWindow, WorkerPrivate* aParent, const nsAString& aScriptURL, bool aIsChromeWorker, LoadGroupBehavior aLoadGroupBehavior, WorkerLoadInfo* aLoadInfo); static void OverrideLoadInfoLoadGroup(WorkerLoadInfo& aLoadInfo); WorkerDebugger* Debugger() const { AssertIsOnMainThread(); MOZ_ASSERT(mDebugger); return mDebugger; } void DoRunLoop(JSContext* aCx); bool InterruptCallback(JSContext* aCx); nsresult IsOnCurrentThread(bool* aIsOnCurrentThread); bool CloseInternal(JSContext* aCx) { AssertIsOnWorkerThread(); return NotifyInternal(aCx, Closing); } bool FreezeInternal(JSContext* aCx); bool ThawInternal(JSContext* aCx); void TraceTimeouts(const TraceCallbacks& aCallbacks, void* aClosure) const; bool ModifyBusyCountFromWorker(JSContext* aCx, bool aIncrease); bool AddChildWorker(JSContext* aCx, ParentType* aChildWorker); void RemoveChildWorker(JSContext* aCx, ParentType* aChildWorker); bool AddFeature(JSContext* aCx, WorkerFeature* aFeature); void RemoveFeature(JSContext* aCx, WorkerFeature* aFeature); void NotifyFeatures(JSContext* aCx, Status aStatus); bool HasActiveFeatures() { return !(mChildWorkers.IsEmpty() && mTimeouts.IsEmpty() && mFeatures.IsEmpty()); } void PostMessageToParent(JSContext* aCx, JS::Handle aMessage, const Optional>& aTransferable, ErrorResult& aRv) { PostMessageToParentInternal(aCx, aMessage, aTransferable, false, 0, aRv); } void PostMessageToParentMessagePort( JSContext* aCx, uint64_t aMessagePortSerial, JS::Handle aMessage, const Optional>& aTransferable, ErrorResult& aRv); void EnterDebuggerEventLoop(); void LeaveDebuggerEventLoop(); void PostMessageToDebugger(const nsAString& aMessage); void SetDebuggerImmediate(JSContext* aCx, Function& aHandler, ErrorResult& aRv); void ReportErrorToDebugger(const nsAString& aFilename, uint32_t aLineno, const nsAString& aMessage); bool NotifyInternal(JSContext* aCx, Status aStatus); void ReportError(JSContext* aCx, const char* aMessage, JSErrorReport* aReport); int32_t SetTimeout(JSContext* aCx, Function* aHandler, const nsAString& aStringHandler, int32_t aTimeout, const Sequence& aArguments, bool aIsInterval, ErrorResult& aRv); void ClearTimeout(int32_t aId); bool RunExpiredTimeouts(JSContext* aCx); bool RescheduleTimeoutTimer(JSContext* aCx); void CloseHandlerStarted() { AssertIsOnWorkerThread(); mCloseHandlerStarted = true; } void CloseHandlerFinished() { AssertIsOnWorkerThread(); mCloseHandlerFinished = true; } void UpdateRuntimeOptionsInternal(JSContext* aCx, const JS::RuntimeOptions& aRuntimeOptions); void UpdateLanguagesInternal(JSContext* aCx, const nsTArray& aLanguages); void UpdatePreferenceInternal(JSContext* aCx, WorkerPreference aPref, bool aValue); void UpdateJSWorkerMemoryParameterInternal(JSContext* aCx, JSGCParamKey key, uint32_t aValue); enum WorkerRanOrNot { WorkerNeverRan = 0, WorkerRan }; void ScheduleDeletion(WorkerRanOrNot aRanOrNot); bool BlockAndCollectRuntimeStats(JS::RuntimeStats* aRtStats, bool aAnonymize); #ifdef JS_GC_ZEAL void UpdateGCZealInternal(JSContext* aCx, uint8_t aGCZeal, uint32_t aFrequency); #endif void GarbageCollectInternal(JSContext* aCx, bool aShrinking, bool aCollectChildren); void CycleCollectInternal(JSContext* aCx, bool aCollectChildren); void OfflineStatusChangeEventInternal(JSContext* aCx, bool aIsOffline); JSContext* GetJSContext() const { AssertIsOnWorkerThread(); return mJSContext; } WorkerGlobalScope* GlobalScope() const { AssertIsOnWorkerThread(); return mScope; } WorkerDebuggerGlobalScope* DebuggerGlobalScope() const { AssertIsOnWorkerThread(); return mDebuggerScope; } void SetThread(WorkerThread* aThread); void AssertIsOnWorkerThread() const #ifdef DEBUG ; #else { } #endif WorkerCrossThreadDispatcher* GetCrossThreadDispatcher(); // This may block! void BeginCTypesCall(); // This may block! void EndCTypesCall(); void BeginCTypesCallback() { // If a callback is beginning then we need to do the exact same thing as // when a ctypes call ends. EndCTypesCall(); } void EndCTypesCallback() { // If a callback is ending then we need to do the exact same thing as // when a ctypes call begins. BeginCTypesCall(); } bool ConnectMessagePort(JSContext* aCx, uint64_t aMessagePortSerial); void DisconnectMessagePort(uint64_t aMessagePortSerial); MessagePort* GetMessagePort(uint64_t aMessagePortSerial); WorkerGlobalScope* GetOrCreateGlobalScope(JSContext* aCx); WorkerDebuggerGlobalScope* CreateDebuggerGlobalScope(JSContext* aCx); bool RegisterBindings(JSContext* aCx, JS::Handle aGlobal); bool DumpEnabled() const { AssertIsOnWorkerThread(); return mPreferences[WORKERPREF_DUMP]; } bool DOMCachesEnabled() const { AssertIsOnWorkerThread(); return mPreferences[WORKERPREF_DOM_CACHES]; } bool ServiceWorkersEnabled() const { AssertIsOnWorkerThread(); return mPreferences[WORKERPREF_SERVICEWORKERS]; } bool OnLine() const { AssertIsOnWorkerThread(); return mOnLine; } void StopSyncLoop(nsIEventTarget* aSyncLoopTarget, bool aResult); bool AllPendingRunnablesShouldBeCanceled() const { return mCancelAllPendingRunnables; } void ClearMainEventQueue(WorkerRanOrNot aRanOrNot); void OnProcessNextEvent(uint32_t aRecursionDepth); void AfterProcessNextEvent(uint32_t aRecursionDepth); void AssertValidSyncLoop(nsIEventTarget* aSyncLoopTarget) #ifdef DEBUG ; #else { } #endif void SetWorkerScriptExecutedSuccessfully() { AssertIsOnWorkerThread(); // Should only be called once! MOZ_ASSERT(!mWorkerScriptExecutedSuccessfully); mWorkerScriptExecutedSuccessfully = true; } // Only valid after CompileScriptRunnable has finished running! bool WorkerScriptExecutedSuccessfully() const { AssertIsOnWorkerThread(); return mWorkerScriptExecutedSuccessfully; } // Just like nsIAppShell::RunBeforeNextEvent. May only be called on the worker // thread. bool RunBeforeNextEvent(nsIRunnable* aRunnable); private: WorkerPrivate(JSContext* aCx, WorkerPrivate* aParent, const nsAString& aScriptURL, bool aIsChromeWorker, WorkerType aWorkerType, const nsACString& aSharedWorkerName, WorkerLoadInfo& aLoadInfo); bool MayContinueRunning() { AssertIsOnWorkerThread(); Status status; { MutexAutoLock lock(mMutex); status = mStatus; } if (status >= Killing) { return false; } if (status >= Running) { return mKillTime.IsNull() || RemainingRunTimeMS() > 0; } return true; } uint32_t RemainingRunTimeMS() const; void CancelAllTimeouts(JSContext* aCx); bool ScheduleKillCloseEventRunnable(JSContext* aCx); bool ProcessAllControlRunnables() { MutexAutoLock lock(mMutex); return ProcessAllControlRunnablesLocked(); } bool ProcessAllControlRunnablesLocked(); void EnableMemoryReporter(); void DisableMemoryReporter(); void WaitForWorkerEvents(PRIntervalTime interval = PR_INTERVAL_NO_TIMEOUT); void PostMessageToParentInternal(JSContext* aCx, JS::Handle aMessage, const Optional>& aTransferable, bool aToMessagePort, uint64_t aMessagePortSerial, ErrorResult& aRv); void GetAllPreferences(bool aPreferences[WORKERPREF_COUNT]) const { AssertIsOnWorkerThread(); memcpy(aPreferences, mPreferences, WORKERPREF_COUNT * sizeof(bool)); } already_AddRefed CreateNewSyncLoop(); bool RunCurrentSyncLoop(); bool DestroySyncLoop(uint32_t aLoopIndex, nsIThreadInternal* aThread = nullptr); void InitializeGCTimers(); void SetGCTimerMode(GCTimerMode aMode); void ShutdownGCTimers(); }; // This class is only used to trick the DOM bindings. We never create // instances of it, and static_casting to it is fine since it doesn't add // anything to WorkerPrivate. class ChromeWorkerPrivate : public WorkerPrivate { public: static already_AddRefed Constructor(const GlobalObject& aGlobal, const nsAString& aScriptURL, ErrorResult& rv); static bool WorkerAvailable(JSContext* aCx, JSObject* /* unused */); private: ChromeWorkerPrivate() = delete; ChromeWorkerPrivate(const ChromeWorkerPrivate& aRHS) = delete; ChromeWorkerPrivate& operator =(const ChromeWorkerPrivate& aRHS) = delete; }; WorkerPrivate* GetWorkerPrivateFromContext(JSContext* aCx); WorkerPrivate* GetCurrentThreadWorkerPrivate(); bool IsCurrentThreadRunningChromeWorker(); JSContext* GetCurrentThreadJSContext(); enum WorkerStructuredDataType { DOMWORKER_SCTAG_BLOB = SCTAG_DOM_MAX, DOMWORKER_SCTAG_FORMDATA = SCTAG_DOM_MAX + 1, DOMWORKER_SCTAG_END }; const JSStructuredCloneCallbacks* WorkerStructuredCloneCallbacks(bool aMainRuntime); const JSStructuredCloneCallbacks* ChromeWorkerStructuredCloneCallbacks(bool aMainRuntime); class AutoSyncLoopHolder { WorkerPrivate* mWorkerPrivate; nsCOMPtr mTarget; uint32_t mIndex; public: explicit AutoSyncLoopHolder(WorkerPrivate* aWorkerPrivate) : mWorkerPrivate(aWorkerPrivate) , mTarget(aWorkerPrivate->CreateNewSyncLoop()) , mIndex(aWorkerPrivate->mSyncLoopStack.Length() - 1) { aWorkerPrivate->AssertIsOnWorkerThread(); } ~AutoSyncLoopHolder() { if (mWorkerPrivate) { mWorkerPrivate->AssertIsOnWorkerThread(); mWorkerPrivate->StopSyncLoop(mTarget, false); mWorkerPrivate->DestroySyncLoop(mIndex); } } bool Run() { WorkerPrivate* workerPrivate = mWorkerPrivate; mWorkerPrivate = nullptr; workerPrivate->AssertIsOnWorkerThread(); return workerPrivate->RunCurrentSyncLoop(); } nsIEventTarget* EventTarget() const { return mTarget; } }; END_WORKERS_NAMESPACE #endif /* mozilla_dom_workers_workerprivate_h__ */