[chromedriver] Implement commands: findChildElement, findChildElements.

chrome/test/chromedriver/chromedriver.py

 # 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.
 
 import ctypes
 import json
 
+from webelement import WebElement
+
 class ChromeDriverException(Exception):
   pass
 class NoSuchElement(ChromeDriverException):
   pass
 class UnknownCommand(ChromeDriverException):
   pass
+class StaleElementReference(ChromeDriverException):
+  pass
 class UnknownError(ChromeDriverException):
   pass
 class XPathLookupError(ChromeDriverException):
   pass
 class InvalidSelector(ChromeDriverException):
   pass
 class SessionNotCreatedException(ChromeDriverException):
   pass
 class NoSuchSession(ChromeDriverException):
   pass
 
 def _ExceptionForResponse(response):
   exception_class_map = {
     7: NoSuchElement,
     9: UnknownCommand,
+    10: StaleElementReference,
     13: UnknownError,
     19: XPathLookupError,
     32: InvalidSelector,
     33: SessionNotCreatedException,
     100: NoSuchSession
   }
   status = response['status']
   msg = response['value']['message']
   return exception_class_map.get(status, ChromeDriverException)(msg)
 
 class ChromeDriver(object):
   """Starts and controls a single Chrome instance on this machine."""
 
   def __init__(self, lib_path, chrome_binary=None):
     self._lib = ctypes.CDLL(lib_path)
     if chrome_binary is None:
       params = {}
     else:
       params = {
         'desiredCapabilities': {
           'chromeOptions': {
             'binary': chrome_binary
           }
         }
       }
     self._session_id = self._ExecuteCommand('newSession', params)['sessionId']
 
+  def _WrapValue(self, value):
+    """Wrap value from client side for chromedriver side."""
+    if isinstance(value, dict):
+      converted = {}
+      for key, val in value.items():
+        converted[key] = self._WrapValue(val)
+      return converted
+    elif isinstance(value, WebElement):
+      return {'ELEMENT': value._id}
+    elif isinstance(value, list):
+      return list(self._WrapValue(item) for item in value)
+    else:
+      return value
+
+  def _UnwrapValue(self, value):
+    """Unwrap value from chromedriver side for client side."""
+    if isinstance(value, dict):
+      if (len(value) == 1 and 'ELEMENT' in value
+          and isinstance(value['ELEMENT'], basestring)):
+        return WebElement(self, value['ELEMENT'])
+      else:
+        unwraped = {}
+        for key, val in value.items():
+          unwraped[key] = self._UnwrapValue(val)
+        return unwraped
+    elif isinstance(value, list):
+      return list(self._UnwrapValue(item) for item in value)
+    else:
+      return value
+
   def _ExecuteCommand(self, name, params={}, session_id=''):
     cmd = {
       'name': name,
       'parameters': params,
       'sessionId': session_id
     }
     cmd_json = json.dumps(cmd)
     response_data = ctypes.c_char_p()
     response_size = ctypes.c_uint()
     self._lib.ExecuteCommand(
         ctypes.c_char_p(cmd_json),
         ctypes.c_uint(len(cmd_json)),
         ctypes.byref(response_data),
         ctypes.byref(response_size))
     response_json = ctypes.string_at(response_data, response_size.value)
     self._lib.Free(response_data)
     response = json.loads(response_json)
     if response['status'] != 0:
       raise _ExceptionForResponse(response)
     return response
 
-  def _ExecuteSessionCommand(self, name, params={}):
-    return self._ExecuteCommand(name, params, self._session_id)['value']
+  def ExecuteSessionCommand(self, name, params={}):
+    params = self._WrapValue(params)
+    return self._UnwrapValue(
+        self._ExecuteCommand(name, params, self._session_id)['value'])
 
   def Load(self, url):
-    self._ExecuteSessionCommand('get', {'url': url})
+    self.ExecuteSessionCommand('get', {'url': url})
 
   def ExecuteScript(self, script, *args):
-    return self._ExecuteSessionCommand(
-         'executeScript', {'script': script, 'args': args})
+    converted_args = list(args)
+    return self.ExecuteSessionCommand(
+        'executeScript', {'script': script, 'args': converted_args})
 
   def SwitchToFrame(self, id_or_name):
-    self._ExecuteSessionCommand('switchToFrame', {'id': id_or_name})
+    self.ExecuteSessionCommand('switchToFrame', {'id': id_or_name})
 
   def SwitchToFrameByIndex(self, index):
     self.SwitchToFrame(index)
 
   def SwitchToMainFrame(self):
     self.SwitchToFrame(None)
 
   def GetTitle(self):
-    return self._ExecuteSessionCommand('getTitle')
+    return self.ExecuteSessionCommand('getTitle')
 
   def FindElement(self, strategy, target):
-    return self._ExecuteSessionCommand(
-         'findElement', {'using': strategy, 'value': target})
+    return self.ExecuteSessionCommand(
+        'findElement', {'using': strategy, 'value': target})
 
   def FindElements(self, strategy, target):
-    return self._ExecuteSessionCommand(
-         'findElements', {'using': strategy, 'value': target})
+    return self.ExecuteSessionCommand(
+        'findElements', {'using': strategy, 'value': target})
 
   def SetTimeout(self, type, timeout):
-    return self._ExecuteSessionCommand(
-         'setTimeout', {'type' : type, 'ms': timeout})
+    return self.ExecuteSessionCommand(
+        'setTimeout', {'type' : type, 'ms': timeout})
 
   def GetCurrentUrl(self):
-    return self._ExecuteSessionCommand('getCurrentUrl')
+    return self.ExecuteSessionCommand('getCurrentUrl')
 
   def GoBack(self):
-    return self._ExecuteSessionCommand('goBack')
+    return self.ExecuteSessionCommand('goBack')
 
   def GoForward(self):
-    return self._ExecuteSessionCommand('goForward')
+    return self.ExecuteSessionCommand('goForward')
 
   def Refresh(self):
-    return self._ExecuteSessionCommand('refresh')
+    return self.ExecuteSessionCommand('refresh')
 
   def Quit(self):
     """Quits the browser and ends the session."""
-    self._ExecuteSessionCommand('quit')
+    self.ExecuteSessionCommand('quit')