Implement NavigationThrottle::BLOCK_REQUEST_AND_COLLAPSE.

content/browser/frame_host/frame_tree_node.h

 // Copyright 2013 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_BROWSER_FRAME_HOST_FRAME_TREE_NODE_H_
 #define CONTENT_BROWSER_FRAME_HOST_FRAME_TREE_NODE_H_
 
 #include <stddef.h>
 
 #include <memory>
@@ skipping 129 matching lines @@
 
   // Sets the last committed URL for this frame and updates
   // has_committed_real_load accordingly.
   void SetCurrentURL(const GURL& url);
 
   // Returns true iff SetCurrentURL has been called with a non-blank URL.
   bool has_committed_real_load() const {
     return has_committed_real_load_;
   }
 
+  // Returns whether the frame's owner element in the parent document is
+  // collapsed, that is, removed from the layout as if it did not exist, as per
+  // request by the embedder (of the content/ layer).
+  bool is_collapsed() const { return is_collapsed_; }
+
+  // Sets whether to collapse the frame's owner element in the parent document,
+  // that is, to remove it from the layout as if it did not exist, as per
+  // request by the embedder (of the content/ layer). Cannot be called for main
+  // frames.
+  //
+  // This only has an effect for <iframe> owner elements, and is a no-op when
+  // called on sub-frames hosted in <frame>, <object>, and <embed> elements.

[dcheng, 2017/05/10 06:59:46]

Out of curiosity, why limited only to iframe?

[engedy, 2017/05/15 13:35:51]

For historical reasons, we ignore `display: none` for <frame> elements (starting
with the initial revision [1] until today [2]), so I wanted to be consistent
with that and implement collapsing for <iframe> elements only.

Not sure what the original rationale was, but this makes some sense considering
that a <frameset> represents a complete partitioning of a page, so collapsing
one <frame> would affect all others in ill-defined ways.
 
[1]:
https://chromium.googlesource.com/chromium/src/+blame/d869b93fe74f4d6cb2dd6f6...
[2]:
https://cs.chromium.org/chromium/src/third_party/WebKit/Source/core/html/HTML...

[dcheng, 2017/05/18 09:35:55]

Probably makes sense to do this for <object> and <embed> though doesn't it?
Otherwise, switching to either one of those would trivially circumvent this. I'm
OK with poking at this in a followup, but it seems inconsistent to only do it
for one type of embeddable frame.

[engedy, 2017/05/18 09:40:06]

That's a good point and I agree. Let me address that in a follow-up.

+  void SetCollapsed(bool collapsed);
+
   // Returns the origin of the last committed page in this frame.
   // WARNING: To get the last committed origin for a particular
   // RenderFrameHost, use RenderFrameHost::GetLastCommittedOrigin() instead,
   // which will behave correctly even when the RenderFrameHost is not the
   // current one for this frame (such as when it's pending deletion).
   const url::Origin& current_origin() const {
     return replication_state_.origin;
   }
 
   // Set the current origin and notify proxies about the update.
@@ skipping 231 matching lines @@
   // destroyed.
   std::unique_ptr<OpenerDestroyedObserver> original_opener_observer_;
 
   // The immediate children of this specific frame.
   std::vector<std::unique_ptr<FrameTreeNode>> children_;
 
   // Whether this frame has committed any real load, replacing its initial
   // about:blank page.
   bool has_committed_real_load_;
 
+  // Whether the frame's owner element in the parent document is collapsed.
+  bool is_collapsed_;
+
   // Track information that needs to be replicated to processes that have
   // proxies for this frame.
   FrameReplicationState replication_state_;
 
   // Track the pending sandbox flags for this frame.  When a parent frame
   // dynamically updates sandbox flags in the <iframe> element for a child
   // frame, these updated flags are stored here and are transferred into
   // replication_state_.sandbox_flags when they take effect on the next frame
   // navigation.
   blink::WebSandboxFlags pending_sandbox_flags_;
@@ skipping 29 matching lines @@
   // browser process activities to this node (when possible).  It is unrelated
   // to the core logic of FrameTreeNode.
   FrameTreeNodeBlameContext blame_context_;
 
   DISALLOW_COPY_AND_ASSIGN(FrameTreeNode);
 };
 
 }  // namespace content
 
 #endif  // CONTENT_BROWSER_FRAME_HOST_FRAME_TREE_NODE_H_