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 127 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 embedder document is

[nasko, 2017/03/01 20:08:04]

nit: s/embedder/parent/, it is a bit more web platform friendly name and
"embedder" is very overloaded term.

[engedy, 2017/04/10 14:36:41]

Done.

+  // collapsed, that is, removed from the layout as if it did not exist, as per
+  // request by the client.

[nasko, 2017/03/01 20:08:04]

What is "client" in this case? The content/ interface to chrome/? Or something
else?

[engedy, 2017/04/10 14:36:41]

Tried to clarify.

+  bool is_collapsed_by_client() const { return is_collapsed_by_client_; }
+
+  // Sets whether to collapse the frame's owner element in the embedder
+  // document, that is, to remove it from the layout as if it did not exist, as
+  // per request by the client. Cannot be called for main frames. Only has an
+  // effect for <iframe> owner elements.

[nasko, 2017/03/01 20:08:04]

Are there owner elements for things other than <iframe>? Maybe worthwhile adding
an example.

[engedy, 2017/04/10 14:36:41]

Done.

+  void SetCollapsedByClient(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 198 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 embedder document is collapsed,
+  // that is, removed from the layout as if it did not exist, as per request
+  // from the client. Always `false` for main frames. Only works for <iframe>
+  // owner elements.

[nasko, 2017/03/01 20:08:04]

nit: This comment is almost identical to the other two. Maybe keep the full
comment here and simplify the other two?

[engedy, 2017/04/10 14:36:41]

Actually, I made this one shorter.

+  bool is_collapsed_by_client_;
+
   // 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 23 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_