diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-19 00:47:55 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-19 00:47:55 +0000 |
commit | 26a029d407be480d791972afb5975cf62c9360a6 (patch) | |
tree | f435a8308119effd964b339f76abb83a57c29483 /dom/base/nsPIDOMWindow.h | |
parent | Initial commit. (diff) | |
download | firefox-26a029d407be480d791972afb5975cf62c9360a6.tar.xz firefox-26a029d407be480d791972afb5975cf62c9360a6.zip |
Adding upstream version 124.0.1.upstream/124.0.1
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'dom/base/nsPIDOMWindow.h')
-rw-r--r-- | dom/base/nsPIDOMWindow.h | 1194 |
1 files changed, 1194 insertions, 0 deletions
diff --git a/dom/base/nsPIDOMWindow.h b/dom/base/nsPIDOMWindow.h new file mode 100644 index 0000000000..4fd24e0010 --- /dev/null +++ b/dom/base/nsPIDOMWindow.h @@ -0,0 +1,1194 @@ +/* -*- 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 nsPIDOMWindow_h__ +#define nsPIDOMWindow_h__ + +#include "nsIDOMWindow.h" +#include "mozIDOMWindow.h" + +#include "nsCOMPtr.h" +#include "nsTArray.h" +#include "Units.h" +#include "mozilla/dom/EventTarget.h" +#include "mozilla/EventForwards.h" +#include "mozilla/Maybe.h" +#include "js/TypeDecls.h" +#include "nsRefPtrHashtable.h" +#include "nsILoadInfo.h" +#include "mozilla/MozPromise.h" + +// Only fired for inner windows. +#define DOM_WINDOW_DESTROYED_TOPIC "dom-window-destroyed" +#define DOM_WINDOW_FROZEN_TOPIC "dom-window-frozen" +#define DOM_WINDOW_THAWED_TOPIC "dom-window-thawed" + +class nsGlobalWindowInner; +class nsGlobalWindowOuter; +class nsIArray; +class nsIBaseWindow; +class nsIChannel; +class nsIContent; +class nsIContentSecurityPolicy; +class nsICSSDeclaration; +class nsIDocShell; +class nsIDocShellTreeOwner; +class nsDocShellLoadState; +class nsIPrincipal; +class nsIRunnable; +class nsIScriptTimeoutHandler; +class nsISerialEventTarget; +class nsIURI; +class nsIWebBrowserChrome; +class nsPIDOMWindowInner; +class nsPIDOMWindowOuter; +class nsPIWindowRoot; + +using SuspendTypes = uint32_t; + +namespace mozilla::dom { +class AudioContext; +class BrowsingContext; +class BrowsingContextGroup; +class ClientInfo; +class ClientState; +class ContentFrameMessageManager; +class DocGroup; +class Document; +class Element; +class Location; +class MediaDevices; +class MediaKeys; +class Navigator; +class Performance; +class Selection; +class ServiceWorker; +class ServiceWorkerDescriptor; +class Timeout; +class TimeoutManager; +class WindowContext; +class WindowGlobalChild; +class CustomElementRegistry; +enum class CallerType : uint32_t; +} // namespace mozilla::dom + +enum class FullscreenReason { + // Toggling the fullscreen mode requires trusted context. + ForFullscreenMode, + // Fullscreen API is the API provided to untrusted content. + ForFullscreenAPI, + // This reason can only be used with exiting fullscreen. + // It is otherwise identical to eForFullscreenAPI except it would + // suppress the fullscreen transition. + ForForceExitFullscreen +}; + +// Must be kept in sync with xpcom/rust/xpcom/src/interfaces/nonidl.rs +#define NS_PIDOMWINDOWINNER_IID \ + { \ + 0x775dabc9, 0x8f43, 0x4277, { \ + 0x9a, 0xdb, 0xf1, 0x99, 0x0d, 0x77, 0xcf, 0xfb \ + } \ + } + +// Must be kept in sync with xpcom/rust/xpcom/src/interfaces/nonidl.rs +#define NS_PIDOMWINDOWOUTER_IID \ + { \ + 0x769693d4, 0xb009, 0x4fe2, { \ + 0xaf, 0x18, 0x7d, 0xc8, 0xdf, 0x74, 0x96, 0xdf \ + } \ + } + +class nsPIDOMWindowInner : public mozIDOMWindow { + protected: + using Document = mozilla::dom::Document; + friend nsGlobalWindowInner; + friend nsGlobalWindowOuter; + + nsPIDOMWindowInner(nsPIDOMWindowOuter* aOuterWindow, + mozilla::dom::WindowGlobalChild* aActor); + + ~nsPIDOMWindowInner(); + + public: + NS_DECLARE_STATIC_IID_ACCESSOR(NS_PIDOMWINDOWINNER_IID) + + nsIGlobalObject* AsGlobal(); + const nsIGlobalObject* AsGlobal() const; + + nsPIDOMWindowOuter* GetOuterWindow() const { return mOuterWindow; } + + static nsPIDOMWindowInner* From(mozIDOMWindow* aFrom) { + return static_cast<nsPIDOMWindowInner*>(aFrom); + } + + NS_IMPL_FROMEVENTTARGET_HELPER_WITH_GETTER(nsPIDOMWindowInner, + GetAsInnerWindow()) + + // Returns true if this object is the currently-active inner window for its + // BrowsingContext. + bool IsCurrentInnerWindow() const; + + // Returns true if the document of this window is the active document. This + // is identical to IsCurrentInnerWindow() now that document.open() no longer + // creates new inner windows for the document it is called on. + inline bool HasActiveDocument() const; + + // Return true if this object is the currently-active inner window for its + // BrowsingContext and any container document is also fully active. + // For https://html.spec.whatwg.org/multipage/browsers.html#fully-active + bool IsFullyActive() const; + + // Returns true if this window is the same as mTopInnerWindow + inline bool IsTopInnerWindow() const; + + // Returns true if this was the current window for its BrowsingContext when it + // was discarded. + virtual bool WasCurrentInnerWindow() const = 0; + + // Check whether a document is currently loading (really checks if the + // load event has completed). May not be reset to false on errors. + inline bool IsLoading() const; + inline bool IsHandlingResizeEvent() const; + + // Note: not related to IsLoading. Set to false if there's an error, etc. + virtual void SetActiveLoadingState(bool aIsActiveLoading) = 0; + + bool AddAudioContext(mozilla::dom::AudioContext* aAudioContext); + void RemoveAudioContext(mozilla::dom::AudioContext* aAudioContext); + void MuteAudioContexts(); + void UnmuteAudioContexts(); + + void SetAudioCapture(bool aCapture); + + /** + * Associate this inner window with a MediaKeys instance. + */ + void AddMediaKeysInstance(mozilla::dom::MediaKeys* aMediaKeysInstance); + + /** + * Remove an association between this inner window and a MediaKeys instance. + */ + void RemoveMediaKeysInstance(mozilla::dom::MediaKeys* aMediaKeysInstance); + + /** + * Return if any MediaKeys instances are associated with this window. + */ + bool HasActiveMediaKeysInstance(); + + mozilla::dom::Performance* GetPerformance(); + + void QueuePerformanceNavigationTiming(); + + bool HasMutationListeners(uint32_t aMutationEventType) const { + if (!mOuterWindow) { + NS_ERROR("HasMutationListeners() called on orphan inner window!"); + + return false; + } + + return (mMutationBits & aMutationEventType) != 0; + } + + void SetMutationListeners(uint32_t aType) { + if (!mOuterWindow) { + NS_ERROR("HasMutationListeners() called on orphan inner window!"); + + return; + } + + mMutationBits |= aType; + } + + /** + * Call this to check whether some node (this window, its document, + * or content in that document) has a mouseenter/leave event listener. + */ + bool HasMouseEnterLeaveEventListeners() const { + return mMayHaveMouseEnterLeaveEventListener; + } + + /** + * Call this to indicate that some node (this window, its document, + * or content in that document) has a mouseenter/leave event listener. + */ + void SetHasMouseEnterLeaveEventListeners() { + mMayHaveMouseEnterLeaveEventListener = true; + } + + /** + * Call this to check whether some node (this window, its document, + * or content in that document) has a Pointerenter/leave event listener. + */ + bool HasPointerEnterLeaveEventListeners() const { + return mMayHavePointerEnterLeaveEventListener; + } + + /** + * Call this to indicate that some node (this window, its document, + * or content in that document) has a Pointerenter/leave event listener. + */ + void SetHasPointerEnterLeaveEventListeners() { + mMayHavePointerEnterLeaveEventListener = true; + } + + /** + * Call this to check whether some node (this window, its document, + * or content in that document) has a transition* event listeners. + */ + bool HasTransitionEventListeners() { return mMayHaveTransitionEventListener; } + + /** + * Call this to indicate that some node (this window, its document, + * or content in that document) has a transition* event listener. + */ + void SetHasTransitionEventListeners() { + mMayHaveTransitionEventListener = true; + } + + /** + * Call this to check whether some node (this window, its document, + * or content in that document) has a beforeinput event listener. + * Returing false may be wrong if some nodes have come from another document + * with `Document.adoptNode`. + */ + bool HasBeforeInputEventListenersForTelemetry() const { + return mMayHaveBeforeInputEventListenerForTelemetry; + } + + /** + * Call this to indicate that some node (this window, its document, + * or content in that document) has a beforeinput event listener. + */ + void SetHasBeforeInputEventListenersForTelemetry() { + mMayHaveBeforeInputEventListenerForTelemetry = true; + } + + /** + * Call this to check whether some node (The document, or content in the + * document) has been observed by web apps with a mutation observer. + * (i.e., `MutationObserver.observe()` called by chrome script and addon's + * script does not make this returns true). + * Returing false may be wrong if some nodes have come from another document + * with `Document.adoptNode`. + */ + bool MutationObserverHasObservedNodeForTelemetry() const { + return mMutationObserverHasObservedNodeForTelemetry; + } + + /** + * Call this to indicate that some node (The document, or content in the + * document) is observed by web apps with a mutation observer. + */ + void SetMutationObserverHasObservedNodeForTelemetry() { + mMutationObserverHasObservedNodeForTelemetry = true; + } + + // Sets the event for window.event. Does NOT take ownership, so + // the caller is responsible for clearing the event before the + // event gets deallocated. Pass nullptr to set window.event to + // undefined. Returns the previous value. + mozilla::dom::Event* SetEvent(mozilla::dom::Event* aEvent) { + mozilla::dom::Event* old = mEvent; + mEvent = aEvent; + return old; + } + + /** + * Check whether this window is a secure context. + */ + bool IsSecureContext() const; + bool IsSecureContextIfOpenerIgnored() const; + + // Calling suspend should prevent any asynchronous tasks from + // executing javascript for this window. This means setTimeout, + // requestAnimationFrame, and events should not be fired. Suspending + // a window maybe also suspends its children. Workers may + // continue to perform computations in the background. A window + // can have Suspend() called multiple times and will only resume after + // a matching number of Resume() calls. + void Suspend(bool aIncludeSubWindows = true); + void Resume(bool aIncludeSubWindows = true); + + // Whether or not this window was suspended by the BrowserContextGroup + bool GetWasSuspendedByGroup() const { return mWasSuspendedByGroup; } + void SetWasSuspendedByGroup(bool aSuspended) { + mWasSuspendedByGroup = aSuspended; + } + + // Apply the parent window's suspend, freeze, and modal state to the current + // window. + void SyncStateFromParentWindow(); + + /** + * Increment active peer connection count. + */ + void AddPeerConnection(); + + /** + * Decrement active peer connection count. + */ + void RemovePeerConnection(); + + /** + * Check whether the active peer connection count is non-zero. + */ + bool HasActivePeerConnections(); + + bool IsPlayingAudio(); + + bool IsDocumentLoaded() const; + + mozilla::dom::TimeoutManager& TimeoutManager(); + + bool IsRunningTimeout(); + + // To cache top inner-window if available after constructed for tab-wised + // indexedDB counters. + void TryToCacheTopInnerWindow(); + + // Increase/Decrease the number of active IndexedDB databases for the + // decision making of timeout-throttling. + void UpdateActiveIndexedDBDatabaseCount(int32_t aDelta); + + // Return true if there is any active IndexedDB databases which could block + // timeout-throttling. + bool HasActiveIndexedDBDatabases(); + + // Increase/Decrease the number of open WebSockets. + void UpdateWebSocketCount(int32_t aDelta); + + // Return true if there are any open WebSockets that could block + // timeout-throttling. + bool HasOpenWebSockets() const; + + mozilla::Maybe<mozilla::dom::ClientInfo> GetClientInfo() const; + mozilla::Maybe<mozilla::dom::ClientState> GetClientState() const; + mozilla::Maybe<mozilla::dom::ServiceWorkerDescriptor> GetController() const; + + void SetCsp(nsIContentSecurityPolicy* aCsp); + void SetPreloadCsp(nsIContentSecurityPolicy* aPreloadCsp); + nsIContentSecurityPolicy* GetCsp(); + + void NoteCalledRegisterForServiceWorkerScope(const nsACString& aScope); + + void NoteDOMContentLoaded(); + + virtual mozilla::dom::CustomElementRegistry* CustomElements() = 0; + + // XXX: This is called on inner windows + virtual nsPIDOMWindowOuter* GetInProcessScriptableTop() = 0; + virtual nsPIDOMWindowOuter* GetInProcessScriptableParent() = 0; + virtual already_AddRefed<nsPIWindowRoot> GetTopWindowRoot() = 0; + + mozilla::dom::EventTarget* GetChromeEventHandler() const { + return mChromeEventHandler; + } + + mozilla::dom::EventTarget* GetParentTarget() { + if (!mParentTarget) { + UpdateParentTarget(); + } + return mParentTarget; + } + + virtual void MaybeUpdateTouchState() {} + + Document* GetExtantDoc() const { return mDoc; } + nsIURI* GetDocumentURI() const; + nsIURI* GetDocBaseURI() const; + + Document* GetDoc() { + if (!mDoc) { + MaybeCreateDoc(); + } + return mDoc; + } + + mozilla::dom::WindowContext* GetWindowContext() const; + mozilla::dom::WindowGlobalChild* GetWindowGlobalChild() const { + return mWindowGlobalChild; + } + + // Removes this inner window from the BFCache, if it is cached, and returns + // true if it was. + bool RemoveFromBFCacheSync(); + + // Determine if the window is suspended or frozen. Outer windows + // will forward this call to the inner window for convenience. If + // there is no inner window then the outer window is considered + // suspended and frozen by default. + virtual bool IsSuspended() const = 0; + virtual bool IsFrozen() const = 0; + + // Fire any DOM notification events related to things that happened while + // the window was frozen. + virtual nsresult FireDelayedDOMEvents(bool aIncludeSubWindows) = 0; + + /** + * Get the docshell in this window. + */ + inline nsIDocShell* GetDocShell() const; + + /** + * Get the browsing context in this window. + */ + inline mozilla::dom::BrowsingContext* GetBrowsingContext() const; + + /** + * Get the browsing context group this window belongs to. + */ + mozilla::dom::BrowsingContextGroup* GetBrowsingContextGroup() const; + + /** + * Call this to indicate that some node (this window, its document, + * or content in that document) has a DOMActivate event listener. + */ + void SetHasDOMActivateEventListeners() { + mMayHaveDOMActivateEventListeners = true; + } + + /** + * Call this to check whether some node (this window, its document, + * or content in that document) has a DOMActivate event listener. + */ + bool HasDOMActivateEventListeners() const { + return mMayHaveDOMActivateEventListeners; + } + + /** + * Call this to indicate that some node (this window, its document, + * or content in that document) has a paint event listener. + */ + void SetHasPaintEventListeners() { mMayHavePaintEventListener = true; } + + /** + * Call this to check whether some node (this window, its document, + * or content in that document) has a paint event listener. + */ + bool HasPaintEventListeners() { return mMayHavePaintEventListener; } + + /** + * Call this to indicate that some node (this window, its document, + * or content in that document) has a touch event listener. + */ + void SetHasTouchEventListeners() { + if (!mMayHaveTouchEventListener) { + mMayHaveTouchEventListener = true; + MaybeUpdateTouchState(); + } + } + + /** + * Call this to indicate that some node (this window, its document, + * or content in that document) has a selectionchange event listener. + */ + void SetHasSelectionChangeEventListeners() { + mMayHaveSelectionChangeEventListener = true; + } + + /** + * Call this to check whether some node (this window, its document, + * or content in that document) has a selectionchange event listener. + */ + bool HasSelectionChangeEventListeners() const { + return mMayHaveSelectionChangeEventListener; + } + + /** + * Call this to indicate that some node (this window, its document, + * or content in that document) has a select event listener of form controls. + */ + void SetHasFormSelectEventListeners() { + mMayHaveFormSelectEventListener = true; + } + + /** + * Call this to check whether some node (this window, its document, + * or content in that document) has a select event listener of form controls. + */ + bool HasFormSelectEventListeners() const { + return mMayHaveFormSelectEventListener; + } + + /* + * Get and set the currently focused element within the document. If + * aNeedsFocus is true, then set mNeedsFocus to true to indicate that a + * document focus event is needed. + * + * DO NOT CALL EITHER OF THESE METHODS DIRECTLY. USE THE FOCUS MANAGER + * INSTEAD. + */ + mozilla::dom::Element* GetFocusedElement() const { + return mFocusedElement.get(); + } + + virtual void SetFocusedElement(mozilla::dom::Element* aElement, + uint32_t aFocusMethod = 0, + bool aNeedsFocus = false) = 0; + + bool UnknownFocusMethodShouldShowOutline() const { + return mUnknownFocusMethodShouldShowOutline; + } + + /** + * Retrieves the method that was used to focus the current node. + */ + virtual uint32_t GetFocusMethod() = 0; + + /* + * Tells the window that it now has focus or has lost focus, based on the + * state of aFocus. If this method returns true, then the document loaded + * in the window has never received a focus event and expects to receive + * one. If false is returned, the document has received a focus event before + * and should only receive one if the window is being focused. + * + * aFocusMethod may be set to one of the focus method constants in + * nsIFocusManager to indicate how focus was set. + */ + virtual bool TakeFocus(bool aFocus, uint32_t aFocusMethod) = 0; + + /** + * Indicates that the window may now accept a document focus event. This + * should be called once a document has been loaded into the window. + */ + virtual void SetReadyForFocus() = 0; + + /** + * Whether the focused content within the window should show a focus ring. + */ + virtual bool ShouldShowFocusRing() = 0; + + /** + * Indicates that the page in the window has been hidden. This is used to + * reset the focus state. + */ + virtual void PageHidden() = 0; + + /** + * Instructs this window to asynchronously dispatch a hashchange event. This + * method must be called on an inner window. + */ + virtual nsresult DispatchAsyncHashchange(nsIURI* aOldURI, + nsIURI* aNewURI) = 0; + + /** + * Instructs this window to synchronously dispatch a popState event. + */ + virtual nsresult DispatchSyncPopState() = 0; + + /** + * Tell this window that it should listen for sensor changes of the given + * type. + */ + virtual void EnableDeviceSensor(uint32_t aType) = 0; + + /** + * Tell this window that it should remove itself from sensor change + * notifications. + */ + virtual void DisableDeviceSensor(uint32_t aType) = 0; + +#if defined(MOZ_WIDGET_ANDROID) + virtual void EnableOrientationChangeListener() = 0; + virtual void DisableOrientationChangeListener() = 0; +#endif + + /** + * Tell this window that there is an observer for gamepad input + * + * Inner windows only. + */ + virtual void SetHasGamepadEventListener(bool aHasGamepad = true) = 0; + + /** + * Return the window id of this window + */ + uint64_t WindowID() const { return mWindowID; } + + // WebIDL-ish APIs + void MarkUncollectableForCCGeneration(uint32_t aGeneration) { + mMarkedCCGeneration = aGeneration; + } + + uint32_t GetMarkedCCGeneration() { return mMarkedCCGeneration; } + + mozilla::dom::Navigator* Navigator(); + mozilla::dom::MediaDevices* GetExtantMediaDevices() const; + virtual mozilla::dom::Location* Location() = 0; + + virtual nsresult GetControllers(nsIControllers** aControllers) = 0; + + virtual nsresult GetInnerWidth(double* aWidth) = 0; + virtual nsresult GetInnerHeight(double* aHeight) = 0; + + virtual already_AddRefed<nsICSSDeclaration> GetComputedStyle( + mozilla::dom::Element& aElt, const nsAString& aPseudoElt, + mozilla::ErrorResult& aError) = 0; + + virtual bool GetFullScreen() = 0; + + virtual nsresult Focus(mozilla::dom::CallerType aCallerType) = 0; + virtual nsresult Close() = 0; + + mozilla::dom::DocGroup* GetDocGroup() const; + + RefPtr<mozilla::GenericPromise> SaveStorageAccessPermissionGranted(); + RefPtr<mozilla::GenericPromise> SaveStorageAccessPermissionRevoked(); + + bool UsingStorageAccess(); + + uint32_t UpdateLockCount(bool aIncrement) { + MOZ_ASSERT_IF(!aIncrement, mLockCount > 0); + mLockCount += aIncrement ? 1 : -1; + return mLockCount; + }; + bool HasActiveLocks() { return mLockCount > 0; } + + uint32_t UpdateWebTransportCount(bool aIncrement) { + MOZ_ASSERT_IF(!aIncrement, mWebTransportCount > 0); + mWebTransportCount += aIncrement ? 1 : -1; + return mWebTransportCount; + }; + bool HasActiveWebTransports() { return mWebTransportCount > 0; } + + protected: + void CreatePerformanceObjectIfNeeded(); + + // Lazily instantiate an about:blank document if necessary, and if + // we have what it takes to do so. + void MaybeCreateDoc(); + + void SetChromeEventHandlerInternal( + mozilla::dom::EventTarget* aChromeEventHandler) { + mChromeEventHandler = aChromeEventHandler; + // mParentTarget will be set when the next event is dispatched. + mParentTarget = nullptr; + } + + virtual void UpdateParentTarget() = 0; + + // These two variables are special in that they're set to the same + // value on both the outer window and the current inner window. Make + // sure you keep them in sync! + nsCOMPtr<mozilla::dom::EventTarget> mChromeEventHandler; // strong + RefPtr<Document> mDoc; + // Cache the URI when mDoc is cleared. + nsCOMPtr<nsIURI> mDocumentURI; // strong + nsCOMPtr<nsIURI> mDocBaseURI; // strong + + nsCOMPtr<mozilla::dom::EventTarget> mParentTarget; // strong + + RefPtr<mozilla::dom::Performance> mPerformance; + mozilla::UniquePtr<mozilla::dom::TimeoutManager> mTimeoutManager; + + RefPtr<mozilla::dom::Navigator> mNavigator; + + // These variables are only used on inner windows. + uint32_t mMutationBits; + + uint32_t mActivePeerConnections = 0; + + bool mIsDocumentLoaded; + bool mIsHandlingResizeEvent; + bool mMayHaveDOMActivateEventListeners; + bool mMayHavePaintEventListener; + bool mMayHaveTouchEventListener; + bool mMayHaveSelectionChangeEventListener; + bool mMayHaveFormSelectEventListener; + bool mMayHaveMouseEnterLeaveEventListener; + bool mMayHavePointerEnterLeaveEventListener; + bool mMayHaveTransitionEventListener; + // Only used for telemetry probes. This may be wrong if some nodes have + // come from another document with `Document.adoptNode`. + bool mMayHaveBeforeInputEventListenerForTelemetry; + bool mMutationObserverHasObservedNodeForTelemetry; + + // Our inner window's outer window. + nsCOMPtr<nsPIDOMWindowOuter> mOuterWindow; + + // The element within the document that is currently focused when this + // window is active. + RefPtr<mozilla::dom::Element> mFocusedElement; + + // The AudioContexts created for the current document, if any. + nsTArray<mozilla::dom::AudioContext*> mAudioContexts; // Weak + + // Instances of MediaKeys created in this inner window. Storing these allows + // us to shutdown MediaKeys when an inner windows is destroyed. We can also + // use the presence of MediaKeys to assess if a window has EME activity. + nsTArray<mozilla::dom::MediaKeys*> mMediaKeysInstances; // Weak + + RefPtr<mozilla::dom::BrowsingContext> mBrowsingContext; + + // A unique (as long as our 64-bit counter doesn't roll over) id for + // this window. + uint64_t mWindowID; + + // Set to true once we've sent the (chrome|content)-document-global-created + // notification. + bool mHasNotifiedGlobalCreated; + + // Whether when focused via an "unknown" focus method, we should show outlines + // by default or not. The initial value of this is true (so as to show + // outlines for stuff like html autofocus, or initial programmatic focus + // without any other user interaction). + bool mUnknownFocusMethodShouldShowOutline = true; + + uint32_t mMarkedCCGeneration; + + // mTopInnerWindow is used for tab-wise check by timeout throttling. It could + // be null. + nsCOMPtr<nsPIDOMWindowInner> mTopInnerWindow; + + // The evidence that we have tried to cache mTopInnerWindow only once from + // SetNewDocument(). Note: We need this extra flag because mTopInnerWindow + // could be null and we don't want it to be set multiple times. + bool mHasTriedToCacheTopInnerWindow; + + // The number of active IndexedDB databases. + uint32_t mNumOfIndexedDBDatabases; + + // The number of open WebSockets. + uint32_t mNumOfOpenWebSockets; + + // The event dispatch code sets and unsets this while keeping + // the event object alive. + mozilla::dom::Event* mEvent; + + // The WindowGlobalChild actor for this window. + // + // This will be non-null during the full lifetime of the window, initialized + // during SetNewDocument, and cleared during FreeInnerObjects. + RefPtr<mozilla::dom::WindowGlobalChild> mWindowGlobalChild; + + bool mWasSuspendedByGroup; + + /** + * Count of the number of active LockRequest objects, including ones from + * workers. + */ + uint32_t mLockCount = 0; + /** + * Count of the number of active WebTransport objects, including ones from + * workers. + */ + uint32_t mWebTransportCount = 0; +}; + +NS_DEFINE_STATIC_IID_ACCESSOR(nsPIDOMWindowInner, NS_PIDOMWINDOWINNER_IID) + +class nsPIDOMWindowOuter : public mozIDOMWindowProxy { + protected: + using Document = mozilla::dom::Document; + + explicit nsPIDOMWindowOuter(uint64_t aWindowID); + + ~nsPIDOMWindowOuter(); + + void NotifyResumingDelayedMedia(); + + public: + NS_DECLARE_STATIC_IID_ACCESSOR(NS_PIDOMWINDOWOUTER_IID) + + NS_IMPL_FROMEVENTTARGET_HELPER_WITH_GETTER(nsPIDOMWindowOuter, + GetAsOuterWindow()) + + static nsPIDOMWindowOuter* From(mozIDOMWindowProxy* aFrom) { + return static_cast<nsPIDOMWindowOuter*>(aFrom); + } + + // Given an inner window, return its outer if the inner is the current inner. + // Otherwise (argument null or not an inner or not current) return null. + static nsPIDOMWindowOuter* GetFromCurrentInner(nsPIDOMWindowInner* aInner); + + // Check whether a document is currently loading + inline bool IsLoading() const; + inline bool IsHandlingResizeEvent() const; + + nsPIDOMWindowInner* GetCurrentInnerWindow() const { return mInnerWindow; } + + nsPIDOMWindowInner* EnsureInnerWindow() { + // GetDoc forces inner window creation if there isn't one already + GetDoc(); + return GetCurrentInnerWindow(); + } + + bool IsRootOuterWindow() { return mIsRootOuterWindow; } + + // Internal getter/setter for the frame element, this version of the + // getter crosses chrome boundaries whereas the public scriptable + // one doesn't for security reasons. + mozilla::dom::Element* GetFrameElementInternal() const; + void SetFrameElementInternal(mozilla::dom::Element* aFrameElement); + + bool IsBackground() { return mIsBackground; } + + // Audio API + bool GetAudioMuted() const; + + // No longer to delay media from starting for this window. + void ActivateMediaComponents(); + bool ShouldDelayMediaFromStart() const; + + void RefreshMediaElementsVolume(); + + virtual nsPIDOMWindowOuter* GetPrivateRoot() = 0; + + /** + * |top| gets the root of the window hierarchy. + * + * This function does not cross chrome-content boundaries, so if this + * window's parent is of a different type, |top| will return this window. + * + * When script reads the top property, we run GetInProcessScriptableTop, + * which will not cross an <iframe mozbrowser> boundary. + * + * In contrast, C++ calls to GetTop are forwarded to GetRealTop, which + * ignores <iframe mozbrowser> boundaries. + */ + + virtual already_AddRefed<nsPIDOMWindowOuter> + GetInProcessTop() = 0; // Outer only + virtual already_AddRefed<nsPIDOMWindowOuter> GetInProcessParent() = 0; + virtual nsPIDOMWindowOuter* GetInProcessScriptableTop() = 0; + virtual nsPIDOMWindowOuter* GetInProcessScriptableParent() = 0; + virtual already_AddRefed<nsPIWindowRoot> GetTopWindowRoot() = 0; + + /** + * Behaves identically to GetInProcessScriptableParent except that it + * returns null if GetInProcessScriptableParent would return this window. + */ + virtual nsPIDOMWindowOuter* GetInProcessScriptableParentOrNull() = 0; + + virtual void SetIsBackground(bool aIsBackground) = 0; + + mozilla::dom::EventTarget* GetChromeEventHandler() const { + return mChromeEventHandler; + } + + virtual void SetChromeEventHandler( + mozilla::dom::EventTarget* aChromeEventHandler) = 0; + + mozilla::dom::EventTarget* GetParentTarget() { + if (!mParentTarget) { + UpdateParentTarget(); + } + return mParentTarget; + } + + mozilla::dom::ContentFrameMessageManager* GetMessageManager() { + // We maintain our mMessageManager state alongside mParentTarget. + if (!mParentTarget) { + UpdateParentTarget(); + } + return mMessageManager; + } + + Document* GetExtantDoc() const { return mDoc; } + nsIURI* GetDocumentURI() const; + + Document* GetDoc() { + if (!mDoc) { + MaybeCreateDoc(); + } + return mDoc; + } + + // Set the window up with an about:blank document with the given principal and + // potentially a CSP and a COEP. + virtual void SetInitialPrincipal( + nsIPrincipal* aNewWindowPrincipal, nsIContentSecurityPolicy* aCSP, + const mozilla::Maybe<nsILoadInfo::CrossOriginEmbedderPolicy>& aCoep) = 0; + + // Returns an object containing the window's state. This also suspends + // all running timeouts in the window. + virtual already_AddRefed<nsISupports> SaveWindowState() = 0; + + // Restore the window state from aState. + virtual nsresult RestoreWindowState(nsISupports* aState) = 0; + + // Determine if the window is suspended or frozen. Outer windows + // will forward this call to the inner window for convenience. If + // there is no inner window then the outer window is considered + // suspended and frozen by default. + virtual bool IsSuspended() const = 0; + virtual bool IsFrozen() const = 0; + + // Fire any DOM notification events related to things that happened while + // the window was frozen. + virtual nsresult FireDelayedDOMEvents(bool aIncludeSubWindows) = 0; + + /** + * Get the docshell in this window. + */ + inline nsIDocShell* GetDocShell() const; + + /** + * Get the browsing context in this window. + */ + inline mozilla::dom::BrowsingContext* GetBrowsingContext() const; + + /** + * Get the browsing context group this window belongs to. + */ + mozilla::dom::BrowsingContextGroup* GetBrowsingContextGroup() const; + + /** + * Set a new document in the window. Calling this method will in most cases + * create a new inner window. This may be called with a pointer to the current + * document, in that case the document remains unchanged, but a new inner + * window will be created. + * + * aDocument must not be null. + */ + virtual nsresult SetNewDocument( + Document* aDocument, nsISupports* aState, bool aForceReuseInnerWindow, + mozilla::dom::WindowGlobalChild* aActor = nullptr) = 0; + + /** + * Ensure the size and position of this window are up-to-date by doing + * a layout flush in the parent (which will in turn, do a layout flush + * in its parent, etc.). + */ + virtual void EnsureSizeAndPositionUpToDate() = 0; + + /** + * Suppresses/unsuppresses user initiated event handling in window's document + * and all in-process descendant documents. + */ + virtual void SuppressEventHandling() = 0; + virtual void UnsuppressEventHandling() = 0; + + /** + * Callback for notifying a window about a modal dialog being + * opened/closed with the window as a parent. + * + * If any script can run between the enter and leave modal states, and the + * window isn't top, the LeaveModalState() should be called on the window + * returned by EnterModalState(). + */ + virtual nsPIDOMWindowOuter* EnterModalState() = 0; + virtual void LeaveModalState() = 0; + + virtual bool CanClose() = 0; + virtual void ForceClose() = 0; + + /** + * Moves the top-level window into fullscreen mode if aIsFullScreen is true, + * otherwise exits fullscreen. + */ + virtual nsresult SetFullscreenInternal(FullscreenReason aReason, + bool aIsFullscreen) = 0; + virtual void FullscreenWillChange(bool aIsFullscreen) = 0; + /** + * This function should be called when the fullscreen state is flipped. + * If no widget is involved the fullscreen change, this method is called + * by SetFullscreenInternal, otherwise, it is called when the widget + * finishes its change to or from fullscreen. + * + * @param aIsFullscreen indicates whether the widget is in fullscreen. + */ + virtual void FinishFullscreenChange(bool aIsFullscreen) = 0; + + virtual void ForceFullScreenInWidget() = 0; + + virtual void MacFullscreenMenubarOverlapChanged( + mozilla::DesktopCoord aOverlapAmount) = 0; + + // XXX: These focus methods all forward to the inner, could we change + // consumers to call these on the inner directly? + + /* + * Get and set the currently focused element within the document. If + * aNeedsFocus is true, then set mNeedsFocus to true to indicate that a + * document focus event is needed. + * + * DO NOT CALL EITHER OF THESE METHODS DIRECTLY. USE THE FOCUS MANAGER + * INSTEAD. + */ + inline mozilla::dom::Element* GetFocusedElement() const; + + virtual void SetFocusedElement(mozilla::dom::Element* aElement, + uint32_t aFocusMethod = 0, + bool aNeedsFocus = false) = 0; + /** + * Get whether a focused element focused by unknown reasons (like script + * focus) should match the :focus-visible pseudo-class. + */ + bool UnknownFocusMethodShouldShowOutline() const; + + /** + * Retrieves the method that was used to focus the current node. + */ + virtual uint32_t GetFocusMethod() = 0; + + /* + * Tells the window that it now has focus or has lost focus, based on the + * state of aFocus. If this method returns true, then the document loaded + * in the window has never received a focus event and expects to receive + * one. If false is returned, the document has received a focus event before + * and should only receive one if the window is being focused. + * + * aFocusMethod may be set to one of the focus method constants in + * nsIFocusManager to indicate how focus was set. + */ + virtual bool TakeFocus(bool aFocus, uint32_t aFocusMethod) = 0; + + /** + * Indicates that the window may now accept a document focus event. This + * should be called once a document has been loaded into the window. + */ + virtual void SetReadyForFocus() = 0; + + /** + * Whether the focused content within the window should show a focus ring. + */ + virtual bool ShouldShowFocusRing() = 0; + + /** + * Indicates that the page in the window has been hidden. This is used to + * reset the focus state. + */ + virtual void PageHidden() = 0; + + /** + * Return the window id of this window + */ + uint64_t WindowID() const { return mWindowID; } + + /** + * Dispatch a custom event with name aEventName targeted at this window. + * Returns whether the default action should be performed. + * + * Outer windows only. + */ + virtual bool DispatchCustomEvent( + const nsAString& aEventName, + mozilla::ChromeOnlyDispatch aChromeOnlyDispatch = + mozilla::ChromeOnlyDispatch::eNo) = 0; + + /** + * Like nsIDOMWindow::Open, except that we don't navigate to the given URL. + * + * Outer windows only. + */ + virtual nsresult OpenNoNavigate(const nsAString& aUrl, const nsAString& aName, + const nsAString& aOptions, + mozilla::dom::BrowsingContext** _retval) = 0; + + /** + * Fire a popup blocked event on the document. + */ + virtual void FirePopupBlockedEvent(Document* aDoc, nsIURI* aPopupURI, + const nsAString& aPopupWindowName, + const nsAString& aPopupWindowFeatures) = 0; + + // WebIDL-ish APIs + void MarkUncollectableForCCGeneration(uint32_t aGeneration) { + mMarkedCCGeneration = aGeneration; + } + + uint32_t GetMarkedCCGeneration() { return mMarkedCCGeneration; } + + // XXX(nika): These feel like they should be inner window only, but they're + // called on the outer window. + virtual mozilla::dom::Navigator* GetNavigator() = 0; + virtual mozilla::dom::Location* GetLocation() = 0; + + virtual nsresult GetPrompter(nsIPrompt** aPrompt) = 0; + virtual nsresult GetControllers(nsIControllers** aControllers) = 0; + virtual already_AddRefed<mozilla::dom::Selection> GetSelection() = 0; + virtual mozilla::dom::Nullable<mozilla::dom::WindowProxyHolder> + GetOpener() = 0; + + // aLoadState will be passed on through to the windowwatcher. + // aForceNoOpener will act just like a "noopener" feature in aOptions except + // will not affect any other window features. + virtual nsresult Open(const nsAString& aUrl, const nsAString& aName, + const nsAString& aOptions, + nsDocShellLoadState* aLoadState, bool aForceNoOpener, + mozilla::dom::BrowsingContext** _retval) = 0; + virtual nsresult OpenDialog(const nsAString& aUrl, const nsAString& aName, + const nsAString& aOptions, + nsISupports* aExtraArgument, + mozilla::dom::BrowsingContext** _retval) = 0; + + virtual nsresult GetInnerWidth(double* aWidth) = 0; + virtual nsresult GetInnerHeight(double* aHeight) = 0; + + virtual mozilla::dom::Element* GetFrameElement() = 0; + + virtual bool Closed() = 0; + virtual bool GetFullScreen() = 0; + virtual nsresult SetFullScreen(bool aFullscreen) = 0; + + virtual nsresult Focus(mozilla::dom::CallerType aCallerType) = 0; + virtual nsresult Close() = 0; + + virtual nsresult MoveBy(int32_t aXDif, int32_t aYDif) = 0; + + virtual void UpdateCommands(const nsAString& anAction) = 0; + + mozilla::dom::DocGroup* GetDocGroup() const; + + already_AddRefed<nsIDocShellTreeOwner> GetTreeOwner(); + already_AddRefed<nsIBaseWindow> GetTreeOwnerWindow(); + already_AddRefed<nsIWebBrowserChrome> GetWebBrowserChrome(); + + protected: + // Lazily instantiate an about:blank document if necessary, and if + // we have what it takes to do so. + void MaybeCreateDoc(); + + void SetChromeEventHandlerInternal( + mozilla::dom::EventTarget* aChromeEventHandler); + + virtual void UpdateParentTarget() = 0; + + // These two variables are special in that they're set to the same + // value on both the outer window and the current inner window. Make + // sure you keep them in sync! + nsCOMPtr<mozilla::dom::EventTarget> mChromeEventHandler; // strong + RefPtr<Document> mDoc; + // Cache the URI when mDoc is cleared. + nsCOMPtr<nsIURI> mDocumentURI; // strong + + nsCOMPtr<mozilla::dom::EventTarget> mParentTarget; // strong + RefPtr<mozilla::dom::ContentFrameMessageManager> mMessageManager; // strong + + nsCOMPtr<mozilla::dom::Element> mFrameElement; + + // These references are used by nsGlobalWindow. + nsCOMPtr<nsIDocShell> mDocShell; + RefPtr<mozilla::dom::BrowsingContext> mBrowsingContext; + + uint32_t mModalStateDepth; + + uint32_t mSuppressEventHandlingDepth; + + // Tracks whether our docshell is active. If it is, mIsBackground + // is false. Too bad we have so many different concepts of + // "active". + bool mIsBackground; + + bool mIsRootOuterWindow; + + // And these are the references between inner and outer windows. + nsPIDOMWindowInner* MOZ_NON_OWNING_REF mInnerWindow; + + // A unique (as long as our 64-bit counter doesn't roll over) id for + // this window. + uint64_t mWindowID; + + uint32_t mMarkedCCGeneration; +}; + +NS_DEFINE_STATIC_IID_ACCESSOR(nsPIDOMWindowOuter, NS_PIDOMWINDOWOUTER_IID) + +#include "nsPIDOMWindowInlines.h" + +#endif // nsPIDOMWindow_h__ |