涉及到的库
类名 | 导入 | 说明 |
---|---|---|
WebDriverWait | from selenium.webdriver.support.ui import WebDriverWait | 显式等待 |
expected_conditions | from selenium.webdriver.support import expected_conditions | 与显示等待连用 |
Options | from selenium.webdriver.chrome.options import Options | 浏览器设置 |
Keys | from selenium.webdriver.common.keys import Keys | 按键库 |
By | from selenium.webdriver.common.by import By | 元素零件库 |
浏览器操作
浏览器属性
调用说明 | 属性说明 |
---|---|
driver.current_url | 用于获得当前页面的URL |
driver.title | 用于获取当前页面的标题 |
driver.page_source | 用于获取页面html源代码 |
driver.current_window_handle | 用于获取当前窗口句柄 |
driver.window_handles | 用于获取所有窗口句柄 |
浏览器函数
调用说明 | 描述 |
---|---|
driver.get | 访问网页 |
driver.forward | 在存在历史记录下,向前拜访网页 |
driver.back | 在存在历史记录下,向后拜访网页 |
driver.refresh | 浏览器刷新 |
driver.close | 关闭当前窗口 |
driver.quit | 关闭所有窗口并安全关闭session |
driver.maximize_window | 窗口最大化 |
driver.set_window_size | 设置窗口大小 |
driver.get_window_size | 获取当前窗口大小 |
dirver.get_window_position | 获取当前窗口的坐标 |
driver.get_sreenshot_as_file | 截图当前窗口 |
driver.execute_script | 运行js |
driver.get_cookies | 获取当前会话所有cookie信息 |
driver.get_cookie | 获取会话的cookie信息 |
driver.add_cookie | 添加cookie |
driver.delete_cookie | 删除cookie |
driver.delete_all_cookies | 删除所有cookie |
driver.switch_to | 切换窗口window、框架frame,最外层default_content,警告框处理alert,跳出当前一级表单parent_content |
等待操作
分为三种方式:
强制(time.sleep):不管操没操作完都停指定的事件才继续
隐式(browser.implicitly_wait(time_to_wait)):一旦设置,存在与整个实例周期中,只要定位元素,都进行一次。在指定时间内按特定频率寻找元素,找到了则结束继续下一语句,没找到则时间结束后返回NoSuchElementException异常
显式等待(WebDriverWait(driver,timeout,poll_frequency=0.5,ignored_exceptions=None)):按指定的方式执行until/until_not内的method
driver:浏览器驱动
timeout:最大超时时间
poll_frequency:询问的间隔步长,默认0.5s
ignored_exceptions:超时后的抛出异常信息,默认抛出NoSuchElementException异常
与until和until_not连用,如:mothed可以是lambda函数或expected_conditions下的函数
WebDriverWait(driver,10).until(method,message="")
调用method提供的驱动程序作为参数,message传入method的参数,直到返回值为True
WebDriverWait(driver,10).until_not(method,message="")
调用method提供的驱动程序作为参数,message传入method的参数,直到返回值为False
WebDriverWait–显式等待
相关库
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
from selenium.webdriver.support import By
示例
waite=webDriverWait(driver,10,0.5)
element=waite.until(EC.presence_of_element_located(By.ID,"kw"))
#判断id=kw的元素是否在dom树里
expected_conditions方法 | 说明 |
---|---|
title_is | 判断当前页面的title是否完全等于预期字符串,返回bool |
title_contains | 判断当前页面的title是否包含预期字符串,返回bool |
presence_of_element_located | 判断某个元素是否被加到dom树里,并不代表该元素一定可见 |
presence_all_element_located | 判断是否至少有一个元素存在于dom树里,举例:如果页面上有n个元素的class都是‘wp’,那么只要有一个元素存在,这个方法就返回True |
visibility_of_element_located | 判断元素是否可见(可见代表元素非隐藏,并且元素宽和高都不等于0) |
visibility_of | 同上,只是参数由locator变为定位后的元素 |
text_to_be_present_in_element | 判断某个元素的text是否包含预期的字符串 |
text_to_be_present_in_element_value | 判断某个元素中的value属性是否包含预期的字符串 |
frame_to_be_available_and_switch_to_it | 判断frame是否可以switch进去,如果可以的话,返回True并且switch进去,否则返回False |
invisibility_of_element_located | 判断某个元素是否不存在于dom树或不可见 |
element_to_be_clickable | 判断某个元素是否可见并且可点击 |
element_to_be_selected | 判断某个元素是否被选中,一般用在下拉列表 |
element_selection_state_to_be | 判断某个元素的选中状态是否符合预期,这个方法传入element |
element_located_selection_state_to_be | 同上,这个方法传入locator |
staleness_of | 等某个元素从dom树中移除,返回bool值 |
alert_is_present | 判断页面上是否存在alert |
也可使用lambda 自编辑函数,如
waite=webDriverWait(driver,10,0.5)
element=waite.until(lambda the:the.find_element_by_id('kw').is_displayed())#=visibility_of_element_located(By.ID,'kw')
By方法 | 说明 |
---|---|
By.ID | id属性定位 |
By.NAME | name属性定位 |
By.CLASS_NAME | classname属性定位 |
By.LINK_TEXT | a标签文本属性定位 |
By.PARTIAL_LINK_TEXT | a标签部分文本属性定位 |
By.TAG_NAME | 标签名定位 |
By.XPATH | xpath路径定位 |
By.CSS_SELECTOR | css选择器定位 |