Implementing switchToParentFrame support in atoms

Author: jimevans

javascript/atoms/frame.js

@@ -42,6 +42,19 @@ bot.frame.activeElement = function() {
 };
 
 
+/**
+ * Gets the parent frame of the specified frame.
+ *
+ * @param {!Window=} opt_root The window get the parent of.
+ *     Defaults to {@code bot.getWindow()}.
+ * @return {Window} The frame if found, null otherwise.
+ */
+bot.frame.parentFrame = function(opt_root) {
+  var domWindow = opt_root || bot.getWindow();
+  return domWindow.parent;
+};
+
+
 /**
  * Returns a reference to the window object corresponding to the given element.
  * Note that the element must be a frame or an iframe.

javascript/atoms/test/frame_test.html

@@ -160,6 +160,16 @@
           var index = bot.frame.getFrameIndex(el, frameWin);
           assertEquals(1, index);
         }
+
+        function testFindParentFrame() {
+          var frameWin = bot.frame.parentFrame(window.frames[1]);
+          assertEquals(frameWin, window);
+        }
+
+        function testParentFrameOnTopLevelIsNoOp() {
+          var frameWin = bot.frame.parentFrame(window);
+          assertEquals(frameWin, window);
+        }
     </script>
 </head>
 <frameset rows="*,*,*" >

javascript/webdriver/atoms/fragments/inject/build.desc

@@ -83,6 +83,11 @@ js_fragment(name = "default_content",
   function = "webdriver.atoms.inject.frame.defaultContent",
   deps = ["//javascript/webdriver/atoms/inject:deps"])
 
+js_fragment(name = "get_parent_frame",
+  module = "webdriver.atoms.inject.frame",
+  function = "webdriver.atoms.inject.frame.parentFrame",
+  deps = ["//javascript/webdriver/atoms/inject:deps"])
+
 js_fragment(name = "get_frame_window",
   module = "webdriver.atoms.inject.frame",
   function = "webdriver.atoms.inject.frame.getFrameWindow",

javascript/webdriver/atoms/inject/frame.js

@@ -48,6 +48,20 @@ webdriver.atoms.inject.frame.activeElement = function() {
 };
 
 
+/**
+ * Finds the parent frame of the specified frame.
+ *
+ * @param {!Window=} opt_root The window to perform the search under.
+ * If not specified window is used as the default.
+ * @return {string} A frame element wrapped in a JSON string as defined by
+ *     the wire protocol.
+ */
+webdriver.atoms.inject.frame.parentFrame = function (opt_root) {
+  return webdriver.atoms.inject.executeScript(bot.frame.parentFrame,
+      [opt_root]);
+};
+
+
 /**
  * Finds a frame by index.
  *