dom/base/DocGroup.h

   1 /* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
   2 /* vim: set ts=8 sts=2 et sw=2 tw=80: */
   3 /* This Source Code Form is subject to the terms of the Mozilla Public
   4  * License, v. 2.0. If a copy of the MPL was not distributed with this file,
   5  * You can obtain one at http://mozilla.org/MPL/2.0/. */
   6
   7 #ifndef DocGroup_h
   8 #define DocGroup_h
   9
  10 #include "nsISupportsImpl.h"
  11 #include "nsIPrincipal.h"
  12 #include "nsThreadUtils.h"
  13 #include "nsTHashSet.h"
  14 #include "nsString.h"
  15 #include "mozilla/RefPtr.h"
  16 #include "mozilla/dom/BrowsingContextGroup.h"
  17 #include "mozilla/dom/HTMLSlotElement.h"
  18
  19 namespace mozilla {
  20 class AbstractThread;
  21 namespace dom {
  22
  23 class CustomElementReactionsStack;
  24 class JSExecutionManager;
  25
  26 // Two browsing contexts are considered "related" if they are reachable from one
  27 // another through window.opener, window.parent, or window.frames. This is the
  28 // spec concept of a browsing context group.
  29 //
  30 // Two browsing contexts are considered "similar-origin" if they can be made to
  31 // have the same origin by setting document.domain. This is the spec concept of
  32 // a "unit of similar-origin related browsing contexts"
  33 //
  34 // A BrowsingContextGroup is a set of browsing contexts which are all
  35 // "related".  Within a BrowsingContextGroup, browsing contexts are
  36 // broken into "similar-origin" DocGroups.  A DocGroup is a member
  37 // of exactly one BrowsingContextGroup.
  38 class DocGroup final {
  39  public:
  40   typedef nsTArray<Document*>::iterator Iterator;
  41
  42   NS_INLINE_DECL_CYCLE_COLLECTING_NATIVE_REFCOUNTING(DocGroup)
  43   NS_DECL_CYCLE_COLLECTION_NATIVE_CLASS(DocGroup)
  44
  45   static already_AddRefed<DocGroup> Create(
  46       BrowsingContextGroup* aBrowsingContextGroup, const nsACString& aKey);
  47
  48   // Returns NS_ERROR_FAILURE and sets |aString| to an empty string if the TLD
  49   // service isn't available. Returns NS_OK on success, but may still set
  50   // |aString| may still be set to an empty string.
  51   [[nodiscard]] static nsresult GetKey(nsIPrincipal* aPrincipal,
  52                                        bool aCrossOriginIsolated,
  53                                        nsACString& aKey);
  54
  55   bool MatchesKey(const nsACString& aKey) { return aKey == mKey; }
  56
  57   const nsACString& GetKey() const { return mKey; }
  58
  59   JSExecutionManager* GetExecutionManager() const { return mExecutionManager; }
  60   void SetExecutionManager(JSExecutionManager*);
  61
  62   BrowsingContextGroup* GetBrowsingContextGroup() const {
  63     return mBrowsingContextGroup;
  64   }
  65
  66   mozilla::dom::DOMArena* ArenaAllocator() { return mArena; }
  67
  68   mozilla::dom::CustomElementReactionsStack* CustomElementReactionsStack();
  69
  70   // Adding documents to a DocGroup should be done through
  71   // BrowsingContextGroup::AddDocument (which in turn calls
  72   // DocGroup::AddDocument).
  73   void AddDocument(Document* aDocument);
  74
  75   // Removing documents from a DocGroup should be done through
  76   // BrowsingContextGroup::RemoveDocument(which in turn calls
  77   // DocGroup::RemoveDocument).
  78   void RemoveDocument(Document* aDocument);
  79
  80   // Iterators for iterating over every document within the DocGroup
  81   Iterator begin() {
  82     MOZ_ASSERT(NS_IsMainThread());
  83     return mDocuments.begin();
  84   }
  85   Iterator end() {
  86     MOZ_ASSERT(NS_IsMainThread());
  87     return mDocuments.end();
  88   }
  89
  90   // Return a pointer that can be continually checked to see if access to this
  91   // DocGroup is valid. This pointer should live at least as long as the
  92   // DocGroup.
  93   bool* GetValidAccessPtr();
  94
  95   // Append aSlot to the list of signal slot list, and queue a mutation observer
  96   // microtask.
  97   void SignalSlotChange(HTMLSlotElement& aSlot);
  98
  99   nsTArray<RefPtr<HTMLSlotElement>> MoveSignalSlotList();
 100
 101   // List of DocGroups that has non-empty signal slot list.
 102   static AutoTArray<RefPtr<DocGroup>, 2>* sPendingDocGroups;
 103
 104   // Returns true if any of its documents are active but not in the bfcache.
 105   bool IsActive() const;
 106
 107   nsresult QueueIframePostMessages(already_AddRefed<nsIRunnable>&& aRunnable,
 108                                    uint64_t aWindowId);
 109
 110   void TryFlushIframePostMessages(uint64_t aWindowId);
 111
 112   static bool TryToLoadIframesInBackground();
 113
 114   const nsID& AgentClusterId() const { return mAgentClusterId; }
 115
 116   bool IsEmpty() const { return mDocuments.IsEmpty(); }
 117
 118  private:
 119   DocGroup(BrowsingContextGroup* aBrowsingContextGroup, const nsACString& aKey);
 120
 121   ~DocGroup();
 122
 123   void FlushIframePostMessageQueue();
 124   nsCString mKey;
 125   nsTArray<Document*> mDocuments;
 126   RefPtr<mozilla::dom::CustomElementReactionsStack> mReactionsStack;
 127   nsTArray<RefPtr<HTMLSlotElement>> mSignalSlotList;
 128   RefPtr<BrowsingContextGroup> mBrowsingContextGroup;
 129   RefPtr<mozilla::ThrottledEventQueue> mIframePostMessageQueue;
 130   nsTHashSet<uint64_t> mIframesUsedPostMessageQueue;
 131
 132   // non-null if the JS execution for this docgroup is regulated with regards
 133   // to worker threads. This should only be used when we are forcing serialized
 134   // SAB access.
 135   RefPtr<JSExecutionManager> mExecutionManager;
 136
 137   // Each DocGroup has a persisted agent cluster ID.
 138   const nsID mAgentClusterId;
 139
 140   RefPtr<mozilla::dom::DOMArena> mArena;
 141 };
 142
 143 }  // namespace dom
 144 }  // namespace mozilla
 145
 146 #endif  // defined(DocGroup_h)