Skip to content

Commit

Permalink
python is getting a point release: 2.38.2
Browse files Browse the repository at this point in the history
  • Loading branch information
@lukeis
lukeis committed Dec 9, 2013
1 parent fac5e0b commit b9d005d
Show file tree
Hide file tree
Showing 18 changed files with 719 additions and 96 deletions.
39 changes: 38 additions & 1 deletion docs/api/py/_modules/selenium/common/exceptions.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -112,18 +112,34 @@ <h1>Source code for selenium.common.exceptions</h1><div class="highlight"><pre>
<div class="viewcode-block" id="NoSuchWindowException"><a class="viewcode-back" href="../../../common/selenium.common.exceptions.html#selenium.common.exceptions.NoSuchWindowException">[docs]</a><span class="k">class</span> <span class="nc">NoSuchWindowException</span><span class="p">(</span><span class="n">InvalidSwitchToTargetException</span><span class="p">):</span>
<span class="sd">&quot;&quot;&quot;</span>
<span class="sd"> Thrown when window target to be switched doesn&#39;t exist.</span>

<span class="sd"> To find the current set of active window handles, you can get a list </span>
<span class="sd"> of the active window handles in the following way::</span>

<span class="sd"> print driver.window_handles</span>

<span class="sd"> &quot;&quot;&quot;</span>
<span class="k">pass</span>
</div>
<div class="viewcode-block" id="NoSuchElementException"><a class="viewcode-back" href="../../../common/selenium.common.exceptions.html#selenium.common.exceptions.NoSuchElementException">[docs]</a><span class="k">class</span> <span class="nc">NoSuchElementException</span><span class="p">(</span><span class="n">WebDriverException</span><span class="p">):</span>
<span class="sd">&quot;&quot;&quot;</span>
<span class="sd"> Thrown when element could not be found.</span>

<span class="sd"> If you encounter this exception, you may want to check the following:</span>
<span class="sd"> * Check your selector used in your find_by...</span>
<span class="sd"> * Element may not yet be on the screen at the time of the find operation,</span>
<span class="sd"> (webpage is still loading) see selenium.webdriver.support.wait.WebDriverWait() </span>
<span class="sd"> for how to write a wait wrapper to wait for an element to appear.</span>
<span class="sd"> &quot;&quot;&quot;</span>
<span class="k">pass</span>
</div>
<div class="viewcode-block" id="NoSuchAttributeException"><a class="viewcode-back" href="../../../common/selenium.common.exceptions.html#selenium.common.exceptions.NoSuchAttributeException">[docs]</a><span class="k">class</span> <span class="nc">NoSuchAttributeException</span><span class="p">(</span><span class="n">WebDriverException</span><span class="p">):</span>
<span class="sd">&quot;&quot;&quot;</span>
<span class="sd"> Thrown when the attribute of element could not be found.</span>

<span class="sd"> You may want to check if the attribute exists in the particular browser you are </span>
<span class="sd"> testing against. Some browsers may have different property names for the same </span>
<span class="sd"> property. (IE8&#39;s .innerText vs. Firefox .textContent)</span>
<span class="sd"> &quot;&quot;&quot;</span>
<span class="k">pass</span>
</div>
Expand All @@ -132,6 +148,16 @@ <h1>Source code for selenium.common.exceptions</h1><div class="highlight"><pre>
<span class="sd"> Thrown when a reference to an element is now &quot;stale&quot;.</span>

<span class="sd"> Stale means the element no longer appears on the DOM of the page.</span>


<span class="sd"> Possible causes of StaleElementReferenceException include, but not limited to:</span>
<span class="sd"> * You are no longer on the same page, or the page may have refreshed since the element </span>
<span class="sd"> was located.</span>
<span class="sd"> * The element may have been removed and re-added to the screen, since it was located.</span>
<span class="sd"> Such as an element being relocated. </span>
<span class="sd"> This can happen typically with a javascript framework when values are updated and the </span>
<span class="sd"> node is rebuilt.</span>
<span class="sd"> * Element may have been inside an iframe or another context which was refreshed.</span>
<span class="sd"> &quot;&quot;&quot;</span>
<span class="k">pass</span>
</div>
Expand All @@ -143,25 +169,36 @@ <h1>Source code for selenium.common.exceptions</h1><div class="highlight"><pre>
<div class="viewcode-block" id="UnexpectedAlertPresentException"><a class="viewcode-back" href="../../../common/selenium.common.exceptions.html#selenium.common.exceptions.UnexpectedAlertPresentException">[docs]</a><span class="k">class</span> <span class="nc">UnexpectedAlertPresentException</span><span class="p">(</span><span class="n">WebDriverException</span><span class="p">):</span>
<span class="sd">&quot;&quot;&quot;</span>
<span class="sd"> Thrown when an unexpected alert is appeared.</span>
<span class="sd"> </span>
<span class="sd"> Usually raised when when an expected modal is blocking webdriver form executing any </span>
<span class="sd"> more commands.</span>
<span class="sd"> &quot;&quot;&quot;</span>
<span class="k">pass</span>
</div>
<div class="viewcode-block" id="NoAlertPresentException"><a class="viewcode-back" href="../../../common/selenium.common.exceptions.html#selenium.common.exceptions.NoAlertPresentException">[docs]</a><span class="k">class</span> <span class="nc">NoAlertPresentException</span><span class="p">(</span><span class="n">WebDriverException</span><span class="p">):</span>
<span class="sd">&quot;&quot;&quot;</span>
<span class="sd"> Thrown when switching to no presented alert.</span>

<span class="sd"> This can be caused by calling an operation on the Alert() class when an alert is </span>
<span class="sd"> not yet on the screen.</span>
<span class="sd"> &quot;&quot;&quot;</span>
<span class="k">pass</span>
</div>
<div class="viewcode-block" id="ElementNotVisibleException"><a class="viewcode-back" href="../../../common/selenium.common.exceptions.html#selenium.common.exceptions.ElementNotVisibleException">[docs]</a><span class="k">class</span> <span class="nc">ElementNotVisibleException</span><span class="p">(</span><span class="n">InvalidElementStateException</span><span class="p">):</span>
<span class="sd">&quot;&quot;&quot;</span>
<span class="sd"> Thrown when although an element is present on the DOM, </span>
<span class="sd"> Thrown when an element is present on the DOM, but </span>
<span class="sd"> it is not visible, and so is not able to be interacted with.</span>

<span class="sd"> Most commonly encountered when trying to click or read text </span>
<span class="sd"> of an element that is hidden from view.</span>
<span class="sd"> &quot;&quot;&quot;</span>
<span class="k">pass</span>
</div>
<div class="viewcode-block" id="ElementNotSelectableException"><a class="viewcode-back" href="../../../common/selenium.common.exceptions.html#selenium.common.exceptions.ElementNotSelectableException">[docs]</a><span class="k">class</span> <span class="nc">ElementNotSelectableException</span><span class="p">(</span><span class="n">InvalidElementStateException</span><span class="p">):</span>
<span class="sd">&quot;&quot;&quot;</span>
<span class="sd"> Thrown when trying to select an unselectable element.</span>
<span class="sd"> </span>
<span class="sd"> For example, selecting a &#39;script&#39; element.</span>
<span class="sd"> &quot;&quot;&quot;</span>
<span class="k">pass</span>
</div>
Expand Down
63 changes: 54 additions & 9 deletions docs/api/py/_modules/selenium/webdriver/common/action_chains.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -70,9 +70,35 @@ <h1>Source code for selenium.webdriver.common.action_chains</h1><div class="high

<div class="viewcode-block" id="ActionChains"><a class="viewcode-back" href="../../../../webdriver/selenium.webdriver.common.action_chains.html#selenium.webdriver.common.action_chains.ActionChains">[docs]</a><span class="k">class</span> <span class="nc">ActionChains</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
<span class="sd">&quot;&quot;&quot;</span>
<span class="sd"> ActionChains are a way to automate low level interactions such as </span>
<span class="sd"> mouse movements, mouse button actions, key press, and context menu interactions.</span>
<span class="sd"> This is useful for doing more complex actions like hover over and drag and drop. </span>

<span class="sd"> Generate user actions.</span>
<span class="sd"> All actions are stored in the ActionChains object. </span>
<span class="sd"> Call perform() to fire stored actions.</span>
<span class="sd"> When you call methods for actions on the ActionChains object, </span>
<span class="sd"> the actions are stored in a queue in the ActionChains object. </span>
<span class="sd"> When you call perform(), the events are fired in the order they </span>
<span class="sd"> are queued up.</span>

<span class="sd"> ActionChains can be used in a chain pattern::</span>

<span class="sd"> menu = driver.find_element_by_css_selector(&quot;.nav&quot;)</span>
<span class="sd"> hidden_submenu = driver.find_element_by_css_selector(&quot;.nav #submenu1&quot;)</span>

<span class="sd"> ActionChains(driver).move_to_element(menu).click(hidden_submenu).perform()</span>

<span class="sd"> Or actions can be queued up one by one, then performed.::</span>

<span class="sd"> menu = driver.find_element_by_css_selector(&quot;.nav&quot;)</span>
<span class="sd"> hidden_submenu = driver.find_element_by_css_selector(&quot;.nav #submenu1&quot;)</span>

<span class="sd"> actions = ActionChains(driver)</span>
<span class="sd"> actions.move_to_element(menu)</span>
<span class="sd"> actions.click(hidden_submenu)</span>
<span class="sd"> actions.perform()</span>

<span class="sd"> Either way, the actions are performed in the order they are called, one after </span>
<span class="sd"> another.</span>
<span class="sd"> &quot;&quot;&quot;</span>

<span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">driver</span><span class="p">):</span>
Expand Down Expand Up @@ -181,6 +207,11 @@ <h1>Source code for selenium.webdriver.common.action_chains</h1><div class="high
<span class="sd"> - value: The modifier key to send. Values are defined in `Keys` class.</span>
<span class="sd"> - element: The element to send keys.</span>
<span class="sd"> If None, sends a key to current focused element.</span>
<span class="sd"> </span>
<span class="sd"> Example, pressing ctrl+c::</span>

<span class="sd"> ActionsChains(driver).key_down(Keys.CONTROL).send_keys(&#39;c&#39;).key_up(Keys.CONTROL).perform()</span>

<span class="sd"> &quot;&quot;&quot;</span>
<span class="k">if</span> <span class="n">element</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">click</span><span class="p">(</span><span class="n">element</span><span class="p">)</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_actions</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="k">lambda</span><span class="p">:</span>
Expand All @@ -196,6 +227,11 @@ <h1>Source code for selenium.webdriver.common.action_chains</h1><div class="high
<span class="sd"> - value: The modifier key to send. Values are defined in Keys class.</span>
<span class="sd"> - element: The element to send keys.</span>
<span class="sd"> If None, sends a key to current focused element.</span>

<span class="sd"> Example, pressing ctrl+c::</span>

<span class="sd"> ActionsChains(driver).key_down(Keys.CONTROL).send_keys(&#39;c&#39;).key_up(Keys.CONTROL).perform()</span>

<span class="sd"> &quot;&quot;&quot;</span>
<span class="k">if</span> <span class="n">element</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">click</span><span class="p">(</span><span class="n">element</span><span class="p">)</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_actions</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="k">lambda</span><span class="p">:</span>
Expand All @@ -208,8 +244,8 @@ <h1>Source code for selenium.webdriver.common.action_chains</h1><div class="high
<span class="sd"> Moving the mouse to an offset from current mouse position.</span>

<span class="sd"> :Args:</span>
<span class="sd"> - xoffset: X offset to move to.</span>
<span class="sd"> - yoffset: Y offset to move to.</span>
<span class="sd"> - xoffset: X offset to move to, as a positive or negative integer.</span>
<span class="sd"> - yoffset: Y offset to move to, as a positive or negative integer.</span>
<span class="sd"> &quot;&quot;&quot;</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_actions</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="k">lambda</span><span class="p">:</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_driver</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">Command</span><span class="o">.</span><span class="n">MOVE_TO</span><span class="p">,</span> <span class="p">{</span>
Expand All @@ -222,7 +258,7 @@ <h1>Source code for selenium.webdriver.common.action_chains</h1><div class="high
<span class="sd"> Moving the mouse to the middle of an element.</span>

<span class="sd"> :Args:</span>
<span class="sd"> - to_element: The element to move to.</span>
<span class="sd"> - to_element: The WebElement to move to.</span>
<span class="sd"> &quot;&quot;&quot;</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_actions</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="k">lambda</span><span class="p">:</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_driver</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">Command</span><span class="o">.</span><span class="n">MOVE_TO</span><span class="p">,</span> <span class="p">{</span><span class="s">&#39;element&#39;</span><span class="p">:</span> <span class="n">to_element</span><span class="o">.</span><span class="n">id</span><span class="p">}))</span>
Expand All @@ -234,7 +270,7 @@ <h1>Source code for selenium.webdriver.common.action_chains</h1><div class="high
<span class="sd"> Offsets are relative to the top-left corner of the element.</span>

<span class="sd"> :Args:</span>
<span class="sd"> - to_element: The element to move to.</span>
<span class="sd"> - to_element: The WebElement to move to.</span>
<span class="sd"> - xoffset: X offset to move to.</span>
<span class="sd"> - yoffset: Y offset to move to.</span>
<span class="sd"> &quot;&quot;&quot;</span>
Expand Down Expand Up @@ -263,7 +299,8 @@ <h1>Source code for selenium.webdriver.common.action_chains</h1><div class="high
<span class="sd"> Sends keys to current focused element.</span>

<span class="sd"> :Args:</span>
<span class="sd"> - keys_to_send: The keys to send.</span>
<span class="sd"> - keys_to_send: The keys to send. Modifier keys constants can be found in the </span>
<span class="sd"> &#39;Keys&#39; class.</span>
<span class="sd"> &quot;&quot;&quot;</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_actions</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="k">lambda</span><span class="p">:</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_driver</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">Command</span><span class="o">.</span><span class="n">SEND_KEYS_TO_ACTIVE_ELEMENT</span><span class="p">,</span>
Expand All @@ -276,7 +313,8 @@ <h1>Source code for selenium.webdriver.common.action_chains</h1><div class="high

<span class="sd"> :Args:</span>
<span class="sd"> - element: The element to send keys.</span>
<span class="sd"> - keys_to_send: The keys to send.</span>
<span class="sd"> - keys_to_send: The keys to send. Modifier keys constants can be found in the </span>
<span class="sd"> &#39;Keys&#39; class.</span>
<span class="sd"> &quot;&quot;&quot;</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_actions</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="k">lambda</span><span class="p">:</span>
<span class="n">element</span><span class="o">.</span><span class="n">send_keys</span><span class="p">(</span><span class="o">*</span><span class="n">keys_to_send</span><span class="p">))</span>
Expand All @@ -295,7 +333,14 @@ <h1>Source code for selenium.webdriver.common.action_chains</h1><div class="high
<span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="nb">len</span><span class="p">(</span><span class="n">val</span><span class="p">)):</span>
<span class="n">typing</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">val</span><span class="p">[</span><span class="n">i</span><span class="p">])</span>
<span class="k">return</span> <span class="n">typing</span>
</pre></div></div>

<span class="c"># Context manager so ActionChains can be used in a &#39;with .. as&#39; statements.</span>
<span class="k">def</span> <span class="nf">__enter__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
<span class="k">return</span> <span class="bp">self</span> <span class="c"># Return created instance of self.</span>

<span class="k">def</span> <span class="nf">__exit__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">_type</span><span class="p">,</span> <span class="n">_value</span><span class="p">,</span> <span class="n">_traceback</span><span class="p">):</span>
<span class="k">pass</span> <span class="c"># Do nothing, does not require additional cleanup.</span></div>
</pre></div>

</div>
</div>
Expand Down
Loading

0 comments on commit b9d005d

Please sign in to comment.