Track the original opener of a webcontents so we can rely on it for popups

content/public/browser/web_contents.h

 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef CONTENT_PUBLIC_BROWSER_WEB_CONTENTS_H_
 #define CONTENT_PUBLIC_BROWSER_WEB_CONTENTS_H_
 
 #include <stdint.h>
 
 #include <memory>
@@ skipping 614 matching lines @@
   virtual void DidChooseColorInColorChooser(SkColor color) = 0;
 
   // Called when the color chooser has ended.
   virtual void DidEndColorChooser() = 0;
 
   // Returns true if the location bar should be focused by default rather than
   // the page contents. The view calls this function when the tab is focused
   // to see what it should do.
   virtual bool FocusLocationBarByDefault() = 0;
 
   // Does this have an opener associated with it?

[Avi (use Gerrit), 2017/02/03 19:26:33]

You might want to note that this is the "opener" in the JavaScript sense.

   virtual bool HasOpener() const = 0;
 
   // Returns the opener if HasOpener() is true, or nullptr otherwise.
   virtual WebContents* GetOpener() const = 0;
 
+  // Returns true if this WebContents was opened by another WebContents, even
+  // if the opener was suppressed.

[Avi (use Gerrit), 2017/02/03 19:26:33]

... even if the JavaScript opener was suppressed...?

If we can make it clear that "opener" is the JavaScript one, but "original
opener" actually means "the WC that opened this one".

+  virtual bool HasOriginalOpener() const = 0;
+
+  // Returns the original opener if HasOriginalOpener() is true, or nullptr
+  // otherwise.
+  virtual WebContents* GetOriginalOpener() const = 0;
+
   typedef base::Callback<void(
       int, /* id */
       int, /* HTTP status code */
       const GURL&, /* image_url */
       const std::vector<SkBitmap>&, /* bitmaps */
       /* The sizes in pixel of the bitmaps before they were resized due to the
          max bitmap size passed to DownloadImage(). Each entry in the bitmaps
          vector corresponds to an entry in the sizes vector. If a bitmap was
          resized, there should be a single returned bitmap. */
       const std::vector<gfx::Size>&)>
@@ skipping 120 matching lines @@
 
  private:
   // This interface should only be implemented inside content.
   friend class WebContentsImpl;
   WebContents() {}
 };
 
 }  // namespace content
 
 #endif  // CONTENT_PUBLIC_BROWSER_WEB_CONTENTS_H_