mirror of
https://github.com/roytam1/palemoon27.git
synced 2026-06-03 07:28:36 +00:00
Moonchild
88 lines
3.5 KiB
Python
88 lines
3.5 KiB
Python
# Copyright 2011 Software Freedom Conservancy.
|
|
#
|
|
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
# you may not use this file except in compliance with the License.
|
|
# You may obtain a copy of the License at
|
|
#
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
|
#
|
|
# Unless required by applicable law or agreed to in writing, software
|
|
# distributed under the License is distributed on an "AS IS" BASIS,
|
|
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
# See the License for the specific language governing permissions and
|
|
# limitations under the License.
|
|
|
|
"""Waiting functionality."""
|
|
|
|
import time
|
|
from exceptions import NoSuchElementException
|
|
from exceptions import TimeoutException
|
|
|
|
POLL_FREQUENCY = 0.5 # How long to sleep inbetween calls to the method
|
|
IGNORED_EXCEPTIONS = [NoSuchElementException] # list of exceptions ignored during calls to the method
|
|
|
|
class WebDriverWait(object):
|
|
|
|
def __init__(self, driver, timeout, poll_frequency=POLL_FREQUENCY, ignored_exceptions=None):
|
|
"""Constructor, takes a WebDriver instance and timeout in seconds.
|
|
|
|
:Args:
|
|
- driver - Instance of WebDriver (Ie, Firefox, Chrome or Remote)
|
|
- timeout - Number of seconds before timing out
|
|
- poll_frequency - sleep interval between calls
|
|
By default, it is 0.5 second.
|
|
- ignored_exceptions - iterable structure of exception classes ignored during calls.
|
|
By default, it contains NoSuchElementException only.
|
|
|
|
Example:
|
|
from selenium.webdriver.support.ui import WebDriverWait \n
|
|
element = WebDriverWait(driver, 10).until(lambda x: x.find_element_by_id("someId")) \n
|
|
is_disappeared = WebDriverWait(driver, 30, 1, (ElementNotVisibleException)).\ \n
|
|
until_not(lambda x: x.find_element_by_id("someId").is_displayed())
|
|
"""
|
|
self._driver = driver
|
|
self._timeout = timeout
|
|
self._poll = poll_frequency
|
|
# avoid the divide by zero
|
|
if self._poll == 0:
|
|
self._poll = POLL_FREQUENCY
|
|
exceptions = IGNORED_EXCEPTIONS
|
|
if ignored_exceptions is not None:
|
|
try:
|
|
exceptions.extend(iter(ignored_exceptions))
|
|
except TypeError: # ignored_exceptions is not iterable
|
|
exceptions.append(ignored_exceptions)
|
|
self._ignored_exceptions = tuple(exceptions)
|
|
|
|
def until(self, method, message=''):
|
|
"""Calls the method provided with the driver as an argument until the \
|
|
return value is not False."""
|
|
end_time = time.time() + self._timeout
|
|
while(True):
|
|
try:
|
|
value = method(self._driver)
|
|
if value:
|
|
return value
|
|
except self._ignored_exceptions:
|
|
pass
|
|
time.sleep(self._poll)
|
|
if(time.time() > end_time):
|
|
break
|
|
raise TimeoutException(message)
|
|
|
|
def until_not(self, method, message=''):
|
|
"""Calls the method provided with the driver as an argument until the \
|
|
return value is False."""
|
|
end_time = time.time() + self._timeout
|
|
while(True):
|
|
try:
|
|
value = method(self._driver)
|
|
if not value:
|
|
return value
|
|
except self._ignored_exceptions:
|
|
return True
|
|
time.sleep(self._poll)
|
|
if(time.time() > end_time):
|
|
break
|
|
raise TimeoutException(message)
|