selenium4框架学习
https://blog.csdn.net/qq_45158700/article/details/135363339
Selenium with Python中文翻译文档：https://selenium-python-zh.readthedocs.io/en/latest/
下面链接中为103.0.5060.53版本的浏览器和对应的chromedriver
链接：https://pan.baidu.com/s/1rMniL41_L05ucgwGPzhn2A
提取码：6byo
谷歌浏览器和驱动历史版本下载网址_关闭浏览器更新功能：https://www.bilibili.com/read/cv22587648/
安装旧版本chrome 浏览器方法_chrome旧版本-CSDN博客
#切换到iframe
iframe = driver.find_element('//*[@id="mplay]')
driver.switch_to.frame(iframe) #切换到iframe里面
# 跳出iframe
driver.switch_to.parent_frame()
1.selenium编写第一个脚本
#需求：访问bibi网址，输入selenium框架学习点击搜索
from selenium import webdriver
import time
from selenium.webdriver.common.by import By
#定义一个browser的变量，用来接收实例化后的浏览器
browser = webdriver.Chrome()
#使用get方法，访问网址
browser.get("https://www.bilibili.com")
# 1.找到输入框的位置，输入selenium框架学习
browser.find_element(By.CLASS_NAME,'nav-search-input').send_keys("selenium框架学习")
# 2. 找到搜索框的位置，点击搜索
browser.find_element(By.CLASS_NAME,'nav-search-btn').click()
time.sleep(5)
browser.close()
# browser.get("https://im.qq.com/index/")
# browser.find_element_by_id("loginInfo")
从0-1搭建Python+Selenium4自动化测试框架 (yuque.com)
其工作基本流程为：
Webdriver接收到代码后，经过处理来发送给浏览器，浏览器根据处理后的代码执行对应的操作，浏览器执行后完把执行结果返回给Webdriver，Webdriver将执行结果处理并返回给代码展示出来。
2.元素定位
设置好窗口后，想要执行自动化操作，需要定位页面源码中显示的所有HTML所包含的元素内容。
我们有八种元素定位的方法：id、name、class、tag_name、xpath、css_selector、link_text、partial_link_text。
selenium4新版本使用指南：https://zhuanlan.zhihu.com/p/648948497
selenium4自动化测试八大定位高级用法：https://www.bilibili.com/read/cv23264252/
Selenium4Web自动化2-页面元素定位：https://www.cnblogs.com/cekailsf/p/16800385.html
Selenium4自动化框架（超级详细）：https://zhuanlan.zhihu.com/p/632399597
2.1 id、name、class定位
在一般情况下，页面源码中的id都是唯一的，所以只要知道页面元素中的id，就可以定位到该元素，但name、class值可以有重复，所以要注意页面元素中的name、class值有没有重复，假如有的话，selenium默认会返回第一个name或class的元素，假设有如下页面元素标签：
<input type="text" class="s_ipt" name="wd" id="kw" maxlength="100" autocomplete="off">
我们只需要使用find_element()方法来定位该元素，该方法语法格式如下：
from selenium.webdriver.common.by import By
driver.find_element(By.ID,'元素id')
driver.find_element(By.name,'元素name')
driver.find_element(By.class,'元素class')
示例代码如下：
from selenium.webdriver.common.by import By
driver.find_element(By.ID,'kw')
driver.find_element(By.name,'wd')
driver.find_element(By.class,'s_ipt')
2.2 tag_name定位
tag_name定位是通过标签名来定位，例如div、a、input标签等等，当页面中存在多个相同的标签时，默认返回第一个标签元素，其语法格式如下：
from selenium.webdriver.common.by import By
driver.find_element(By.TAG_NAME,"标签名")
示例代码如下：
driver.find_element(By.TAG_NAME,"input") #这样就可以定位到input标签了
2.3 link_text、partial_link_text定位
link_text、partial_link_text都是用来定位标签内的文本，其中link_text必须指明标签内的全部文本，而partial_link_text只需要指定标签内部分文本即可定位，其语法格式如下：
假设有如下标签：
<div class="myclass">自动化测试工具selenium</div>
from selenium.webdriver.common.by import By
driver.find_element(By.LINK_TEXT,'标签内全部文本')
driver.find_element(By.PARTIAL_LINK_TEXT,'标签内部分文本')
示例代码如下：
from selenium.webdriver.common.by import By
driver.find_element(By.LINK_TEXT,'自动化测试工具selenium')
driver.find_element(By.PARTIAL_LINK_TEXT,'自动化')
2.4 xpath定位
xpath是XML路径语言，是XML文档中定位元素的语言，常用的规则如下表所示：
| 表达式 | 描述 |
|---|---|
| nodename | 获取该节点的所有子节点 |
| / | 从当前节点获取直接子节点 |
| // | 从当前节点获取子孙节点 |
| * | 获取当前节点 |
| ** | 获取当前节点的父节点 |
| @ | 选取属性 |
| [] | 添加筛选条件 |
在Selenium自动化测试中，使用xpath定位元素语法格式如下：
例如：
from selenium.webdriver.common.by import By
driver.find_element(By.XPATH,"xpath规则")
示例代码如下：
from selenium.webdriver.common.by import By
driver.find_element(By.XPATH,'//input[@id="kw"]') #定位百度的输入框
//title[@lang='eng'] #其表示选择所有名称为title，同时属性lang的值为eng的节点。
使用xpath定位时，还可以使用运算符来增加定位的准确性，运算符如下表所示：
| 运算符 | 描述 |
|---|---|
| or | 或运算 |
| and | 与运算 |
| mod | 计算除法的余数 |
| | | 计算两个节点集 |
| +、-、*、div | 加法、减法、乘法、除法 |
| =、!=、<、<=、>、>= | 等于、不等于、小于、小于等于、大于、大于等于 |
示例代码如下：
from selenium.webdriver.common.by import By
driver.find_element(By.XPATH,'//input[@id="kw" and @name="wd"]') #这样就可以定位到百度输入框的元素了。
2.5 css选择器定位
css选择器是用于查找HTML元素，定位速度比xpath快，css选择器常用语法表达式如下表：
| 表达式 | 例子 | 描述 |
|---|---|---|
| # | #myid | 选择id为myid的元素 |
| . | .myclass | 选择class为myclass的元素 |
| * | * | 选择所有元素 |
| element | div | 选择div标签元素 |
| > | div>li | 选择div的所有li元素 |
| + | div+li | 选择同一级中在div之后的所有li元素 |
| [=] | type='mytest' | 选择type值为mytest的元素 |
在Selenium自动化定位中，使用css选择器语法格式如下：
from selenium.webdriver.common.by import By
driver.find_element(By.CSS_SELECTOR,"css选择")
示例代码如下：
driver.find_element(By.CSS_SELECTOR,"#kw")
3. 浏览器操作
浏览器操作常用的操作有：
- 获取浏览器信息，导航；
- 处理警告框；
- 添加、获取、删除Cookies；
- 大小、切换窗口。
3.1 获取信息
获取浏览器信息主要有获取标签、当前URL，其方法分别如下所示：
driver.title # 获取浏览器当前页面的标签
driver.current_url # 获取浏览器当前地址栏的URL
driver.page_source # 获取当前html源码
driver.name # 获取浏览器名称(chrome)
driver.get_window_rect() # 获取浏览器尺寸，位置
driver.get_window_position() # 获取浏览器位置(左上角)
3.2 导航
导航最常用的操作是打开、前进、后退和刷新页面，其实现方法分别为：
driver.get(url) # 打开网页
driver.back() # 返回上一个页面（回退操作）
driver.forward() # 回到下一个页面（前进操作）
driver.refresh() # 刷新本页面
3.3 警告框
有三种警告框：Alerts警告框、Confirm确认框、Prompt 提示框。
Alerts警告框：其显示一条自定义消息及关闭该警告框的按钮，如下图所示：
Confirm确认框：其显示一条自定义消息及确认和取消该警告框的按钮，如下图所示：
Prompt 提示框：其显示一条自定义消息、输入文本框及确认和取消该警告框的按钮，如下图所示：
处理这些警示框，首先使用switch_to.alert自动定位当前警示框，再使用text、accpet、dismiss、send_keys等方法进行操作操作，其中：
- text：获取警示框内的文字；
- accpet：接受（确认）弹窗内容；
- dismiss：解除（取消）弹窗；
- send_keys： 发送文本至警告框。
# Alerts警示框、Confirm确认框、Prompt提示框示例代码如下：
from time import sleep
from selenium import webdriver
driver = webdriver.Chrome()
driver.get("https://www.selenium.dev/zh-cn/documentation/webdriver/interactions/alerts/")
driver.find_element('link text','查看样例警告框').click()
sleep(5)
alert = driver.switch_to.alert
alert.accept()
sleep(5)
driver.find_element('link text','查看样例警告框').click()
#例代码如下：
Confirm=driver.switch_to.alert
Confirm.dismiss()
3.4 添加、获取、删除Cookies
Cookies主要用于识别用户并加载存储的信息，有些情况，我们需要携带Cookies才可以继续访问浏览器或者浏览网页的更多信息，在Selenium自动化测试中，我们通过使用如下方法来添加、获取、删除Cookies，
from selenium import webdriver
driver = webdriver.Chrome()
driver.add_cookie(Cookies值) # 添加Cookies
driver.get_cookie(Cookies名称) # 获取单个Cookies
driver.get_cookies() # 获取全部Cookies
driver.delete_cookie(Cookies名称) # 删除单个Cookies
driver.delete_all_cookies() # 删除全部Cookies
#注意：添加Cookie仅接受一组已定义的可序列化JSON对象。
#示例代码 实现了添加、获取、删除Cookies值了。
from time import sleep
from selenium import webdriver
driver = webdriver.Chrome()
driver.get("https://www.baidu.com")
sleep(1)
driver.add_cookie({'name':'mycookies','value':'123456'}) # 添加名为mycookies的cookies，其值为123456
print(driver.get_cookie('mycookies')) # 获取名为mycookies的cookies信息
print(driver.get_cookies()) # 获取全部cookies的信息
driver.delete_cookie('mycookies') # 删除名为mycookies的信息
print(driver.get_cookies()) # 获取全部cookies的信息
driver.delete_all_cookies() # 删除全部cookies的信息
print(driver.get_cookies()) # 获取全部cookies的信息
3.5 浏览器窗口大小
webdriver提供了set_window_size(宽, 高)来修改自动化测试时浏览器启动的窗口大小，示例代码如下：
from selenium import webdriver #导入模块
driver = webdriver.Chrome() #启动浏览器驱动
driver.get('https://www.baidu.com')
driver.set_window_size(1500, 800) #调整浏览器高为800，宽为1500
也可以使用maximize_window()方法使窗体最大化，示例代码如下：
from selenium import webdriver #导入模块
driver = webdriver.Chrome() #启动浏览器驱动
driver.get('https://www.baidu.com')
driver.maximize_window() #最大化窗口
3.6 浏览器窗口切换
在进行浏览器操作时，打开了一个新的标签页后，代码监控的浏览器标签页并不是最新打开的标签页，示例代码如下：
在进行浏览器操作时，打开了一个新的标签页后，代码监控的浏览器标签页并不是最新打开的标签页，示例代码如下：
from selenium import webdriver
from time import sleep
from selenium.webdriver.common.by import By
driver=webdriver.Chrome()
driver.get('https://blog.csdn.net/')
el=driver.find_element(By.ID,'toolbar-search-input')
el.send_keys('Selenium')
bt=driver.find_element(By.ID,'toolbar-search-button').click()
sleep(2)
print(driver.title) # 输出标签页标题
driver.quit()
#运行上面的代码，终端输出的内容是：
CSDN博客-专业IT技术发表平台
但最新的标签页标题为：Selenium- CSDN搜索。
这时我们需要获取打开的窗口句柄，并切换到最新的窗口，示例代码如下：
from selenium import webdriver
from time import sleep
from selenium.webdriver.common.by import By
driver=webdriver.Chrome()
driver.get('https://blog.csdn.net/')
el=driver.find_element(By.ID,'toolbar-search-input')
el.send_keys('Selenium')
bt=driver.find_element(By.ID,'toolbar-search-button').click()
windows = driver.window_handles # 获取浏览器打开的窗口句柄
driver.switch_to.window(windows[-1]) # 切换到最新的窗口
sleep(2)
print(driver.title) # 输出标签页标题
driver.quit()
#运行结果:
Selenium- CSDN搜索。
注意： 获取窗口句柄的返回值类型为数组，而且最新的窗口句柄放在数组最后面，所以通过-1下标来获取最新的句柄。
3.7 浏览器窗口新建
当我们需要新建一个页面方法其他URL链接时，可以使用new_window()方法，示例代码如下：
from selenium import webdriver
from time import sleep
driver=webdriver.Chrome()
driver.get('https://cn.bing.com/')
driver.switch_to.new_window() # 新建标签页
driver.get('https://www.baidu.com/')
sleep(5) # 休眠5秒
driver.quit() # 关闭浏览器并释放进程资源
3.8 浏览器窗口截图
我们可以通过get_screenshot_as_file()方法对打开的标签页进行截图保存，示例代码如下：
from selenium import webdriver
driver = webdriver.Chrome()
driver.get("https://www.baidu.com/")
driver.get_screenshot_as_file('screenshot.png')
driver.quit()
或者
driver.get_screenshot_as_png('...')
driver.get_screenshot_as_base64('...')
3.9 关闭浏览器释放资源
在完成自动化操作后，需要关闭浏览器并释放资源，示例代码如下：
driver.quit() # 关闭所有标签页
driver.close() # 关闭当前标签页
关闭当前标签页时，要注意切换到你想要关闭的标签页。
4. 鼠标操作
常用的鼠标操作方法如下：
| 方法 | 描述 |
|---|---|
| click() | 单击左键 |
| context_click() | 单击右键 |
| double_click() | 双击 |
| drag_and_drop() | 拖动 |
| move_to_element() | 鼠标悬停 |
| perform() | 执行所有ActionChains中存储的动作 |
除了单击左键，上面的方法需要用到ActionChains方法，而且需要使用perform方法执行ActionChains的动作。
4.1 单击左键
单击左键使用click()方法即可，示例代码如下：
bt=driver.find_element(By.ID,'su').click() # 单击左键
4.2 单击右键
单击右键使用context_click()方法即可，示例代码如下：
from selenium.webdriver import ActionChains
bt=driver.find_element(By.ID,'su') # 定位元素
ActionChains(driver).context_click(bt).perform() # 使用ActionChains方法调用context_click方法实现单击右键
4.3 双击左键
双击左键使用double_click()方法即可，示例代码如下：
# 定位搜索按钮
button = driver.find_element('选择器','元素位置')
# 执行双击动作
ActionChains(driver).double_click(button).perform()
4.4 拖动操作
拖动鼠标使用drag_and_drop()方法，该方法需要传递两个参数：
- source：拖动的元素；
- target：拖到目标位置；
示例代码如下：
# 定位要拖动的元素
source = driver.find_element('选择器','xxx')
# 定位目标元素
target = driver.find_element('选择器','')
# 执行拖动动作
ActionChains(driver).drag_and_drop(source, target).perform()
4.5 悬停操作
鼠标悬停使用move_to_element()方法来实现，示例代码如下：
from selenium.webdriver import ActionChains
bt=driver.find_element(By.XPATH,'//*[@id="s-top-left"]/div/a') # 定位元素
ActionChains(driver).move_to_element(bt).perform() # 使用ActionChains方法调用move_to_element实现悬停操作
4.6 滑动操作
滑动操作需要使用execute_script方法来实现，其传入的参数为JavaScript代码，示例代码如下：
from time import sleep
from selenium import webdriver
driver = webdriver.Chrome()
driver.get("https://www.runoob.com/")
js='window.scrollTo(0, 500);'
# 使用execute_script方法执行JavaScript代码来实现鼠标滚动
driver.execute_script(js) # 向下滚动 500 像素
sleep(5)
driver.quit()
除了自定滑动的距离，我们还可以指定滑动到的页面元素，示例代码如下：
from time import sleep
from selenium import webdriver
from selenium.webdriver.common.by import By
driver = webdriver.Chrome()
driver.set_window_size(500, 500)
driver.get("https://www.baidu.com/")
sleep(2)
target = driver.find_element(By.ID,'su') # 定位元素
driver.execute_script("arguments[0].scrollIntoView();", target) # 滑动到定位元素
sleep(2)
driver.quit()
5. 键盘操作
在webdriver中的keys类中，提供了很多按键方法，常用的按键操作有：
| 操作 | 描述 |
|---|---|
| Keys.ENTER | 回车键 |
| Keys.BACK_SPACE | 删除键 |
| Keys.CONTROL | Ctrl键 |
| Keys.F1 | F1键 |
| Keys.SPACE | 空格 |
| Keys.TAB | Tab键 |
| Keys.ESCAPE | ESC键 |
| Keys.ALT | Alt键 |
| Keys.SHIFT | Shift键 |
| Keys.ARROW_DOWN | 向下箭头 |
| Keys.ARROW_LEFT | 向左箭头 |
| Keys.ARROW_RIGHT | 向右箭头 |
| Keys.ARROW_UP | 向上箭头 |
接下来我们以回车键来演示，示例代码如下：
from selenium import webdriver
from time import sleep
from selenium.webdriver import Keys
from selenium.webdriver.common.by import By
driver=webdriver.Chrome()
driver.get('https://www.baidu.com/')
el=driver.find_element(By.ID,'kw') # 定位元素
el.send_keys('NBA头条',Keys.ENTER) # 输出内容后按回车键
sleep(2) # 休眠2秒
driver.quit() # 关闭浏览器并释放进程资源
6. 等待操作
由于页面元素不会一下子就全部渲染出来，当定位还没渲染出来的元素时，就会报错，那么我们需要设置一下等待，等待可以分为：显式等待、隐式等待和强制等待。
6.1 显式等待
显式等待主要是使用WebDriverWait来实现，其语法格式如下：
WebDriverWait(driver,timeout,poll_frequency=0.5,ignored_exceptions=None)
其中：
- driver：浏览器驱动；
- timeout：最长超时时间，默认以秒为单位；
- poll_frequency：检测的间隔步长，默认为0.5s；
- ignored_exceptions：超时后的抛出的异常信息，默认抛出NoSuchElementExeception异常。
在使用WebDriverWait时，需要搭配until或until_not方法来使用，其语法格式如下：
until(method,message='')
until_not(method,message='')
其中：
- method：指定预期条件的判断方法；
- message：超时后抛出的提示；
常用的method方法有：
| 方法 | 描述 |
|---|---|
| title_is('') | 判断当前页面的 title 是否等于预期 |
| title_contains('') | 判断当前页面的 title 是否包含预期字符串 |
| presence_of_element_located(locator) | 判断元素是否被加到了 dom 树里，并不代表该元素一定可见 |
| visibility_of_element_located(locator) | 判断元素是否可见，可见代表元素非隐藏，并且元素的宽和高都不等于0 |
| visibility_of(element) | 跟上一个方法作用相同，但传入参数为 element |
| text_to_be_present_in_element(locator ,'') | 判断元素中的 text 是否包含了预期的字符串 |
| text_to_be_present_in_element_value(locator ,‘’) | 判断元素中的 value 属性是否包含了预期的字符串 |
| frame_to_be_available_and_switch_to_it(locator) | 判断该 frame 是否可以 switch 进去，True 则 switch 进去，反之 False |
| invisibility_of_element_located(locator) | 判断元素中是否不存在于 dom 树或不可见 |
| element_to_be_clickable(locator) | 判断元素中是否可见并且是可点击的 |
| staleness_of(element) | 等待元素从 dom 树中移除 |
| element_to_be_selected(element) | 判断元素是否被选中,一般用在下拉列表 |
| element_selection_state_to_be(element,True) | 判断元素的选中状态是否符合预期，参数 element，第二个参数为 True/False |
| element_located_selection_state_to_be(locator,True) | 跟上一个方法作用相同，但传入参数为 locator |
| alert_is_present() | 判断页面上是否存在 alert |
示例代码如下：
from time import sleep
from selenium import webdriver
from selenium.webdriver import Keys
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
from selenium.webdriver.common.by import By
driver = webdriver.Chrome()
driver.get('https://www.baidu.com/')
element = WebDriverWait(driver, 2, 0.5,ignored_exceptions=None).until(EC.presence_of_element_located((By.ID, 'toolbar-search-input')),message='超时!') # 定位不存在的标签
element.send_keys('NBA',Keys.ENTER)
sleep(5) # 休眠5秒
driver.quit() # 关闭浏览器并释放进程资源
运行结果为：message：超时！
6.2 隐式等待
Webdriver提供了三种隐式等待方法：
- implicitly_wait：识别对象时的超时时间；
- set_script_timeout：异步脚本的超时时间；
- set_page_load_timeout：页面加载时的超时时间。
这三种方法的语法格式如下：
implicitly_wait('时间')
set_script_timeout('时间')
set_page_load_timeout('时间')
大家可以根据需求来选择隐式等待的方法，这里演示implicitly_wait方法，示例代码如下：
from selenium import webdriver
from time import sleep
from selenium.webdriver.common.by import By
driver=webdriver.Chrome()
driver.get('https://www.baidu.com/')
driver.implicitly_wait(5) # 隐式等待5秒
el=driver.find_element(By.ID,'kw1') # 获取id为kw1的元素
el.send_keys('NBA头条')
bt=driver.find_element(By.ID,'su').click() # 单击左键
sleep(3) # 休眠5秒
driver.quit() # 关闭浏览器并释放进程资源
id为kw1的元素不存在，所以5秒后就会报错。
6.3 强制等待
强制等待通过休眠sleep方法来实现，不管元素是否存在、是否已加载出来，都会等到休眠时间结束才会继续下一步操作，示例代码如下：
from selenium import webdriver
from time import sleep
from selenium.webdriver.common.by import By
driver=webdriver.Chrome()
driver.get('https://www.baidu.com/')
sleep(5)
el=driver.find_element(By.ID,'kw')
el.send_keys('NBA头条')
bt=driver.find_element(By.ID,'su').click() # 单击左键
sleep(3) # 休眠5秒
driver.quit() # 关闭浏览器并释放进程资源