Merge pull request #473 from rtomac/get-webelement

Added keyword 'Get WebElement'

Author: emanlove

CHANGES.rst

@@ -1,6 +1,10 @@
 Release Notes
 =============
 
+1.7.3 (unreleased)
+-------------------
+- Added 'Get WebElement' [zephraph][emanlove]
+
 1.7.2
 ----------------
 - Added an argument called screenshot_root_directory that can be passed into S2L's

src/Selenium2Library/keywords/_element.py

@@ -21,6 +21,13 @@ def __init__(self):
 
     # Public, get element(s)
 
+    def get_webelement(self, locator):
+        """Returns the first WebElement matching the given locator.
+
+        See `introduction` for details about locating elements.
+        """
+        return self._element_find(locator, True, True)
+
     def get_webelements(self, locator):
         """Returns list of WebElement objects matching locator.
 

test/acceptance/keywords/elements.robot

@@ -7,6 +7,13 @@ Get Elements
     @{links}=  Get WebElements  //div[@id="div_id"]/a
     Length Should Be  ${links}  11
 
+Get Web Element
+    @{links}=  Get WebElements  //div[@id="div_id"]/a
+    ${link}=  Get WebElement  //div[@id="div_id"]/a
+    Should Be Equal  @{links}[0]  ${link}
+    Run Keyword and Expect Error  ValueError: Element locator 'id=non_existing_elem' did not match any elements.
+    ...  Get WebElement  id=non_existing_elem
+
 More Get Elements
     [Setup]  Go To Page "forms/prefilled_email_form.html"
     @{checkboxes}=  Get WebElements  //input[@type="checkbox"]
@@ -51,4 +58,3 @@ Get Vertical Position
     ${pos}=  Get Vertical Position  link=Link
     Should Be True  ${pos} > ${0}
     Run Keyword And Expect Error  Could not determine position for 'non-existent'  Get Horizontal Position  non-existent
-