selenium4框架学习

https://blog.csdn.net/qq_45158700/article/details/135363339

浏览器驱动&selenium文档下载

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文档中定位元素的语言，常用的规则如下表所示：

在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定位时，还可以使用运算符来增加定位的准确性，运算符如下表所示：

示例代码如下：

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选择器常用语法表达式如下表：

在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. 鼠标操作

常用的鼠标操作方法如下：

除了单击左键，上面的方法需要用到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类中，提供了很多按键方法，常用的按键操作有：

接下来我们以回车键来演示，示例代码如下：

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方法有：

示例代码如下：

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()     # 关闭浏览器并释放进程资源