From 5f8de423f190bbb79a62f804151bc24824fa32d8 Mon Sep 17 00:00:00 2001 From: "Matt A. Tobin" Date: Fri, 2 Feb 2018 04:16:08 -0500 Subject: Add m-esr52 at 52.6.0 --- dom/base/DocGroup.h | 79 +++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 79 insertions(+) create mode 100644 dom/base/DocGroup.h (limited to 'dom/base/DocGroup.h') diff --git a/dom/base/DocGroup.h b/dom/base/DocGroup.h new file mode 100644 index 000000000..f4f7ac8ad --- /dev/null +++ b/dom/base/DocGroup.h @@ -0,0 +1,79 @@ +/* -*- 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 DocGroup_h +#define DocGroup_h + +#include "nsISupports.h" +#include "nsISupportsImpl.h" +#include "nsIPrincipal.h" +#include "nsTHashtable.h" +#include "nsString.h" + +#include "mozilla/RefPtr.h" + +namespace mozilla { +namespace dom { + +// Two browsing contexts are considered "related" if they are reachable from one +// another through window.opener, window.parent, or window.frames. This is the +// spec concept of a "unit of related browsing contexts" +// +// Two browsing contexts are considered "similar-origin" if they can be made to +// have the same origin by setting document.domain. This is the spec concept of +// a "unit of similar-origin related browsing contexts" +// +// A TabGroup is a set of browsing contexts which are all "related". Within a +// TabGroup, browsing contexts are broken into "similar-origin" DocGroups. In +// more detail, a DocGroup is actually a collection of documents, and a +// TabGroup is a collection of DocGroups. A TabGroup typically will contain +// (through its DocGroups) the documents from one or more tabs related by +// window.opener. A DocGroup is a member of exactly one TabGroup. + +class TabGroup; + +class DocGroup final : public nsISupports +{ +public: + typedef nsTArray::iterator Iterator; + friend class TabGroup; + + NS_DECL_THREADSAFE_ISUPPORTS + + static void GetKey(nsIPrincipal* aPrincipal, nsACString& aString); + bool MatchesKey(const nsACString& aKey) + { + return aKey == mKey; + } + TabGroup* GetTabGroup() + { + return mTabGroup; + } + void RemoveDocument(nsIDocument* aWindow); + + // Iterators for iterating over every document within the DocGroup + Iterator begin() + { + return mDocuments.begin(); + } + Iterator end() + { + return mDocuments.end(); + } + +private: + DocGroup(TabGroup* aTabGroup, const nsACString& aKey); + ~DocGroup(); + + nsCString mKey; + RefPtr mTabGroup; + nsTArray mDocuments; +}; + +} // namespace dom +} // namespace mozilla + +#endif // defined(DocGroup_h) -- cgit v1.2.3