Pick frame to navigate in the browser process.

content/browser/frame_host/frame_tree.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_H_
 #define CONTENT_BROWSER_FRAME_HOST_FRAME_TREE_H_
 
 #include <string>
 
 #include "base/callback.h"
@@ skipping 41 matching lines @@
 
   FrameTreeNode* root() const { return root_.get(); }
 
   // Returns the FrameTreeNode with the given |frame_tree_node_id| if it is part
   // of this FrameTree.
   FrameTreeNode* FindByID(int64 frame_tree_node_id);
 
   // Returns the FrameTreeNode with the given renderer-specific |routing_id|.
   FrameTreeNode* FindByRoutingID(int process_id, int routing_id);
 
+  // Returns the first frame in this tree with the given |name|, or the main
+  // frame if |name| is empty.
+  // Note that this does NOT support pseudo-names like _self, _top, and _blank,
+  // nor searching other FrameTrees (unlike blink::WebView::findFrameByName).
+  FrameTreeNode* FindByName(const std::string& name);
+
   // Executes |on_node| on each node in the frame tree.  If |on_node| returns
   // false, terminates the iteration immediately. Returning false is useful
   // if |on_node| is just doing a search over the tree.  The iteration proceeds
   // top-down and visits a node before adding its children to the queue, making
   // it safe to remove children during the callback.
   void ForEach(const base::Callback<bool(FrameTreeNode*)>& on_node) const;
 
   // Frame tree manipulation routines.
   // |process_id| is required to disambiguate |new_routing_id|, and it must
   // match the process of the |parent| node.  Otherwise this method returns
@@ skipping 111 matching lines @@
 
   // Overall load progress.
   double load_progress_;
 
   DISALLOW_COPY_AND_ASSIGN(FrameTree);
 };
 
 }  // namespace content
 
 #endif  // CONTENT_BROWSER_FRAME_HOST_FRAME_TREE_H_