Add examples to Wait For Condition.

pekkaklarck · pekkaklarck · commit 1f4baf4124f7 · 2017-11-09T10:47:16.000+02:00
See #925 about doc enhancements in general and #188 about exactly this enhancement.
diff --git a/src/SeleniumLibrary/keywords/waiting.py b/src/SeleniumLibrary/keywords/waiting.py
@@ -36,6 +36,11 @@ def wait_for_condition(self, condition, timeout=None, error=None):
         and their default value.
 
         ``error`` can be used to override the default error message.
+
+        Examples:
+        | `Wait For Condition` | return document.title == "New Title" |
+        | `Wait For Condition` | return jQuery.active == 0            |
+        | `Wait For Condition` | style = document.querySelector('h1').style; return style.background == "red" && style.color == "white" |
         """
         if 'return' not in condition:
             raise ValueError("Condition '%s' did not have mandatory 'return'."
diff --git a/test/acceptance/keywords/waiting.robot b/test/acceptance/keywords/waiting.robot
@@ -7,6 +7,7 @@ Force Tags        Known Issue Internet Explorer
 Wait For Condition
     Title Should Be    Original
     Wait For Condition    return window.document.title == "Changed"
+    Wait For Condition    style = document.querySelector('#content').style; return style.background == "red" && style.color == "white"
     Run Keyword And Expect Error
     ...    Condition 'return window.document.title == "Invalid"' did not become true in 100 milliseconds.
     ...    Wait For Condition    return window.document.title == "Invalid"    ${0.1}
diff --git a/test/resources/html/javascript/delayed_events.html b/test/resources/html/javascript/delayed_events.html
@@ -47,7 +47,7 @@
     </head>
     
     <body onload="modifyAfterDelay()">
-    <div id="content">This is content</div>
+    <div id="content" style="color: white; background: red">This is content</div>
     <div id="container"></div>
     <div id="not_present">Element that should disappear</div>
     <div id="hidden" style="display:none;">Initially hidden content</div>
