一、概述：

1.1 Selenium是什么

Selenium 是一个基于浏览器的自动化工具，可以跨平台、跨浏览器使用。

Selenium 主要包括三部分：

1、Selenium IDE： Firefox 浏览器的一个插件（扩展），它可以进行录制回放，并且可以把录制的操作以多 种语言（如 JAVA、Python、C#等）的形式导出成测试用例。

2、Selenium WebDriver： 提供 Web 自动化所需的 API，主要用作浏览器控制、页面元素选择和调试。不同 的浏览器需要不同的 WebDriver。

3、Selenium Grid： 提供了在不同机器的不同浏览器上运行 selenium 测试的能力。

1.2 Selenium 自动化工作原理

Selenium的工作原理涉及几个关键组件：WebDriver、浏览器驱动(Browser Driver)、以及Selenium Server或Remote Server:

1、WebDriver: 是一个API接口，用于操作浏览器。

2、浏览器驱动: 是一个与浏览器相对应的程序，它可以接收来自WebDriver的指令，并执行这些指令。

3、Selenium Server/Remote Server: 

 - Selenium Server是一个可以运行于浏览器的服务器，可以接收从WebDriver发出的命令。

 - Remote Server是一个独立的服务器，可以运行在不同的机器上，用于接收和处理WebDriver发出的命令。

1.3 Python+selenium 自动化测试环境搭建

参考博客：Selenium环境搭建（浏览器驱动下载）-CSDN博客

二、基础启动参数

# 创建驱动对象

driver = webdriver.Chrome()--------------------启动浏览器

#通过驱动发送请求，打开测试页面

driver.get("https://www.baidu.com/")

浏览器设置

driver.maximize_window()---------------------最大化浏览器driver.back()-----------------------后退driver.forward()-------------------前进driver.quit()------------------------关闭浏览器driver.close()---------------------关闭浏览器drvier.refresh()-------------------刷新浏览器

2.1、浏览器初始化配置

from selenium import webdriverfrom selenium.webdriver.edge.options import Options# 实例化Optionsoption = Options()# 不自动关闭浏览器的配置option.add_experimental_option("detach", True)# 在打开浏览器之前，去掉自动化标识option.add_experimental_option('excludeSwitches', ['enable-automation'])option.add_argument('--disable-blink-features=AutomationControlled')# 关掉密码弹窗prefs = {}prefs['credentials_enable_service'] = Falseprefs['profile.password_manager_enabled'] = Falseoption.add_experimental_option('prefs', prefs)# 实例化driver对象，将option传入driver = webdriver.Edge(options=option)

三、页面元素定位方式

id -----------------------------> find_element(By.ID,'xxx')

class ------------------------> find_element(By.CLASS_NAME,'xxx')

name ------------------------> find_element(By.NAME,'xxx')

link_text --------------------> find_element(By.LINK_TEXT,'xxx')

partial_link_text ----------> find_element(By. PARTIAL_LINK_TEXT,'xxx')

tag_name------------------> find_element(By.TAG_NAME,'xxx')

xpath -----------------------> find_element(By.XPATH,'xxx')

css --------------------------> find_element(By.CSS_SELECTOR,'xxx')

# 通过ID定位driver.find_element(By.ID, 'kw').send_keys("奥运会")通过NAME定位driver.find_element(By.NAME, 'wd').clear()# 通过CLASS_NAME定位driver.find_element(By.CLASS_NAME, 'bg s_btn').click()# 文本属性精准定位driver.find_element(By.LINK_TEXT, '新闻').click()# 文本属性的模糊定位（包含即可）driver.find_element(By.PARTIAL_LINK_TEXT, '新').click()

3.1 Xpath -->定位

xpath可以通过"id、name、……"等标签，定位

# 通过id属性

//标签[@id="xxx"]

xpath原理：

绝对xpath：它其实是标签的层级路径

/html/body/div[3]/div/div[2]/div[1]/div/ul[4]/li[2]/a

很不稳定，只要元素前面多出元素就有可能影响xpath的准确性

相对xpath：它其实是通过属性定位元素

//*[@id="q"]

推荐使用相对xpath，或者手写这样的相对xpath

Xpath使用场景：

场景1：一个xpath可能对应多个元素

当有多个元素时，得到是一个列表，可以通过索引取值

# 方式1：eles = driver.find_elements(By.XPATH,'//a[text()="个人信息"]')eles[1].click()# 方式2：通过xpath直接获取第几个（这里下标从1开始）driver.find_element(By.XPATH,'(//a[text()="个人信息"])[2]').click()

场景2：关联型xpath

使用场景：

当新建的信息需要删除，就可以这种方式找到创建信息，对应的删除按钮，进行删除

使用轴定位编写xpath

$x('//span[text()="老Will"]/../../li//a[text()="删除"]')# 祖先元素//span[text()="老Will"]/ancestor::div[1] 最近一个//span[text()="老Will"]/ancestor::div最古老一个$x('//span[text()="老will"]/ancestor::ul//a[text()="删除"]')# 兄弟元素$x('//a[text()="地址管理"]/../preceding-sibling::li[3]')$x('//a[text()="地址管理"]/../following-sibling::li[1]')

3.2 通过text()属性 -->定位

使用text()属性定位，也属于xpath的一种，但是次方法很方便

//标签[text()="xxx"]

3.3 CSS定位

四、操作方法

4.1 浏览器的操作

driver.maximize_window()--------最大化浏览器

drvier.refresh()----------------刷新浏览器

driver.back()-------------------后退

driver.forward()----------------前进

driver.close()------------------关闭浏览器当前页面

driver.quit()-------------------关闭浏览器

# 以x,y坐标点，设置浏览器的位置，以左上角为启点driver.set_window_position(100, 600) # 设置浏览器的分辨率宽高driver.set_window_size(宽, 高)# 获取当前页title名称tile_name = driver.title #百度一下，你就知道# 获取当前页面urlurl_name = driver.current_url #https://www.baidu.com/

4.2 元素的操作

用法：

xxx

常见的操作方法：

click()--------------------->点击（左击）

send_keys(‘xxx’)------->在输入框内输入 xxx

clear()--------------------->清空目标对象上的内容

submit()------------------->提交---强调对表单内容的提交

text------------------------->获取元素的文本内容

get_attribute('class')---------->获取页面元素的某个属性

size-------------------------------->获取元素的大小(宽高) 字典格式{'height': 55, 'width': 350}

查看元素是否可见：is_display() 返回值是布尔值

查看元素是否可用：is_enable() 返回值是布尔值

4.3 键盘和鼠标操作 ActionChains

1、鼠标的操作方法

selenium是支持模拟鼠标操作，是通过一系列的事件链来完成鼠标需要进行的动作，然后提交。

使用步骤:

首先必选创建一个事件链对象（ActionChains）

使用事件链对象来调用方法进行鼠标操作

右击：context_click()

双击：double_click()

拖拽：drag_and_drop(元素1， 元素2)    或 move_by_offset(x, y)

悬停：move_to_element()

其他...

最后鼠标事件链方法调用完之后一定要进行事务的提交

perform()

注意：如果鼠标事件不进行提交，那么所有的方法都无法生效

1) 点击操作

# 创建事件链对象chains = ActionChains(driver)# 右击：context_click()el1 = driver.find_element(By.XPATH,'//*[@id="passwordA"]')chains.context_click(el1)# 提交事件chains.perform()# 双击：double_click()chains.double_click(el1)chains.perform()

2）悬停：move_to_element()

步骤：

导入 from selenium.webdriver import ActionChains实例化 action = ActionChains(driver)action.move_to_element(ele).perform()  # .perform()：提交

# - 悬停：move_to_element()from selenium.webdriver import ActionChains# 元素定位ele = driver.find_element(By.XPATH, "//span[text()='账户设置'] ")# 悬停操作ActionChains()是一个鼠标操作的类action = ActionChains(driver)# .perform()：提交action.move_to_element(ele).perform()

3）拖拽方式1：drag_and_drop()

从元素1位置 拖拽到 元素2位置

# - 拖拽：drag_and_drop()el2 = driver.find_element(By.XPATH, '//*[@id="div1"]')el3 = driver.find_element(By.XPATH, '//*[@id="div2"]')chains.drag_and_drop(el2, el3)chains.perform()

3）拖拽方式2：move_by_offset(x, y)

按像素拖动，可横向拖动(x=n, y=0)，可纵向拖动(x=0, y=n)

block = driver.find_element(By.XPATH,'//*[@id="nc_1_n1z"]')action = ActionChains(driver)# 按住滑块action.click_and_hold(block)# 移动到最右边action.move_by_offset(400,0)# 松开鼠标action.release().perform()

2、键盘的操作方法

 Selenium之常见键盘的操作：

https://mp.csdn.net/mp_blog/creation/editor/138118005

4.4 Select下拉框处理

特殊标签：select选择框元素

需要对选择框进行定位操作必须创建一个选择框对象进行使用

使用步骤：

首先需要通过Select类创建select对象

通过select对象去选中下拉框元素的具体内容

通过索引（下标）选择，下标从0开始

通过文本内容选择

通过value属性选择

select = Select(driver.find_element(By.XPATH, '//*[@id="selectA"]'))time.sleep(2)# - 通过索引（下标）选择select.select_by_index(1)# - 通过文本内容选择time.sleep(2)select.select_by_visible_text("A重庆")# - 通过value属性选择time.sleep(2)select.select_by_value('gz')

4.5 页面滚动

selenium当中默认没有提供具体方法进行页面滚动操作

可以通过JavaScript脚本去执行滚动操作

使用步骤：

首先定义一个滚动的js脚本然后执行脚本

# 滚动# - 首先定义一个滚动的js脚本# "window.scrollTo(x,y)"time.sleep(2)js_str = "window.scrollTo(0,100000)"# - 然后调用js执行脚本方法：execute_script()driver.execute_script(js_str)

4.6 截图

selenium提供了截图的方法，但是目前只支持png格式

screenshot()方法

# 截图 png格式图片ele = driver.find_element('xpath', '//*[@id="verify_code_img"]')ele.screenshot('./verify.png')

get_screenshot_as_file() -------获取当前浏览器的页面截屏，保存 file 文件

get_screenshot_as_png() -------获取当前浏览器的页面截屏，保存 png 文件

更多截图：https://mp.csdn.net/mp_blog/creation/editor/138125293

4.7 警告框

警告框出现的机制属于JavaScript脚本执行的结果

一般警告框的类型分为：

inputalertconfirmprompt

不管是那种类型的警告框，都会对页面的继续操作进行阻碍

解决警告框的方法：

获取警告框（悬浮页面只上所以需要进行切换到警告框）

关闭警告

       - 确认关闭

       - 取消关闭

获取警告框的提示信息

针对一些警告框可以输入内容的可以进行输入（send_keys（"密码"））

# 警告框driver.find_element(By.XPATH, '//*[@id="alerta"]').click()# 切换到警告框里面alert1 = driver.switch_to.alert# 获取警告框的提示信息print(alert1.text)time.sleep(1)# # - 确认关闭# alert1.dismiss()# # - 取消关闭alert1.accept()# 针对一些警告框可以输入内容的可以进行输入（send_keys（"密码"））# alert1.send_keys("123456")

4.8 页面切换

一个浏览器可以开启多个页面，每个页面都有不同的标识（句柄）

操作步骤：

1.获取窗口句柄2.进入指定窗口

 1.获取窗口句柄（所有句柄、单个）

# 获取所有的窗口句柄hand_list = driver.window_handlesprint(hand_list) # ['008F7760981BF', '008F7760379BF']# 获取所有的窗口句柄hand_now = driver.current_window_handleprint(hand_now) # 008F7760379BF

2.窗口切换 switch_to.window

# 切换窗口 switch_to.window(句柄id)driver.switch_to.window(driver.window_handles[1])

代码示例：

# - 获取浏览器中所有的页面句柄:window_handlesprint(driver.window_handles) # 返回值是一个列表# - 获取单个页面的句柄:current_window_handleprint(driver.current_window_handle)# 点击页面的超链接获取多个页面driver.find_element(By.XPATH, '//*[@id="navitems-group1"]/li[4]/a').click()print(driver.window_handles)# 页面没有进行切换，那么无法对其他页面进行操作# 需要通过获取所有页面句柄的列表下标切换页面driver.switch_to.window(driver.window_handles[1])driver.find_element(By.XPATH, '//*[@id="extra-zhenpin"]/a').click()print(driver.window_handles)# 页面切换driver.switch_to.window(driver.window_handles[2])driver.find_element(By.XPATH, '//*[@id="nav-duobaodao"]/a').click()print(driver.window_handles)time.sleep(2)# - 支持自由切换不同页面句柄driver.switch_to.window(driver.window_handles[0])driver.find_element(By.XPATH, '//*[@id="key"]').send_keys("电脑")print(driver.current_window_handle)# - 创建新的页面句柄driver.switch_to.new_window()print(driver.current_window_handle)

总结：

如果需要操作具体某个页面的元素，必须先切换到页面句柄中，才能执行操作

4.9 frame框架子页面切换

定位frame框架内的元素需要进行跳入跳出

跳入框架：driver.switch_to.frame(ele1)   # ele1='frame框架元素'

跳出框架：driver.switch_to.default_content()

注意：跳出框架会直接跳出到初始框架中，当存在多个frame框架时，需要注意

# 1.定位frame框架frame = driver.find_element(By.XPATH,'/html/frameset/frame[1]')# 跳入frame框架driver.switch_to.frame(frame)# 操作frame内的元素driver.find_element(By.XPATH,'//*[@id="navs"]/ul/li[2]/a').click()# 退出frame框架driver.switch_to.default_content()# 2.点击全部贷款frame = driver.find_element(By.XPATH,'//*[@id="menu-frame"]')# 切换driver.switch_to.frame(frame)driver.find_element(By.XPATH,'/html/body/dl[1]/dd[1]/a').click()# 退出子页面(默认回到主页面)driver.switch_to.default_content()

4.10 页面文本框输入

一般需要进行iframe框架的跳入操作，等同于frame框架

如图：

xxx

4.11 文件/图片上传

检查上传按钮，在按钮附近找到一个<input type="file"这样的标签

<input type="file" 可以直接使用send_keys('文件的绝对路径')

# 元素标签

<input type="file" class="ke-upload-file" name="imgFile" tabindex="-1">

代码示例：

# 定位元素后，使用send_keys输入文件路径driver.find_element(By.XPATH, '//input[@type="file"]').send_keys(r"D:\verify.png")# 单文件上传driver.find_element(By.XPATH, '//*[@id="filePicker"]/div[2]/input').send_keys(r'C:\Users\Amy\Desktop\will.png')# 多文件上传driver.find_element(By.XPATH, '//*[@id="filePicker"]/div[2]/input').send_keys('\n'.join([r'C:\Users\Amy\Desktop\will.png',r'C:\Users\Amy\Desktop\will.png']))

4.12 JS处理页面元素

js详细语法参考博客：

https://www.cnblogs.com/PengHwei/p/18138390

1）日历时间框处理

# 开始时间:# 强制输入：通过JavaScript脚本进行参数接受el5 = driver.find_element(By.XPATH, '//*[@id="start_time"]')# 执行JS脚本需要调用execute_script()driver.execute_script("arguments[0].value='2023-07-15 21:10:10'", el5)

在执行前需要再浏览器控制台执行js函数

function add_time(params) {console.log(arguments[0])}

五、时间等待

提高代码的稳定性，保证页面元素因其它情况的影响下，没有被加载出来，导致程序报错情况的出现

最常见的有三种等待方式：隐式等待、显式等待、强制等待

强制等待

强制等待又称固定等待，就是无论元素是否被加载出来，都会等待设定时间

需要现导入Python内置的time模块 import time

调用sleep()方法，指定等待2s后继续 time.sleep(2)

详见时间等待专项博文：

re>

re>

隐式等待

特点

作用域是整个webdriver对象

如果需元素在第一次定位的时候就已经出现，则不会触发隐式等待

元素没有定位到会报错（NoSuchElementException）

弊端：

它将会在寻找每个element的时候都进行等待，这样会增加整个测试执行的时间

语法

driver.implicitly_wait(10)

from selenium import webdriverdriver = webdriver.Chrome()driver.maximize_window()driver.get('https://www.baidu.com/')# 设置全局等待10sdriver.implicitly_wait(10) # 查找baidu首页中的kw元素，查找到了则继续下一步driver.find_element(By.ID,'kw')

六、处理cookie信息

浏览器查看cookies

路径：Application(应用程序)-->Storage(存储)-->Cookies

添加cookies

通过百度cookie信息设置保持登录状态

# # 给页面添加cookie信息driver.add_cookie({"name": "BAIDUID", "value": "DDC8E5F343BF028B014:FG=1"})driver.add_cookie({"name": "BDUSS","value":"VmRERYbWM5bkN5Umd4MzkdhcU1AAAAAAAAHaKnWR2ip1kem"})# 设置完cookie信息之后，需要进行清楚缓存才能保持登录time.sleep(2)driver.refresh()

获取登录后所有cookies，并进行制定提取

一般需要获取name和value

# 获取所有cookies信息，返回列表[{},{},……]cookies_list = driver.get_cookies()# print(cookies_list)# 遍历所有cookiesfor cookie in cookies_list: # print(cookie) # 提取特定cookie; 例如提取name为'BAIDUID', 以及对应的value值 if cookie["name"] == 'BAIDUID': print(cookie["name"], cookie["value"])

登录处理

cookie信息的管理机制

cookie信息是保存在客户端的浏览器上面的

服务器管理，当前用户id是处于登录还是未登录的状态

通过浏览器的application里面查看不用页面的cookie信息

如何退出登录

关闭整个浏览器（服务器会识别已退出）

手动删除页面的cookie识别登录id

修改也可以实现退出登录状态

如何保持自动登录

从已经登录之后的状态的cookie信息中提取id进行使用

在未登录的页面中使用cookie信息

# 获取页面中的cookie信息

cookies1 = driver.get_cookies() # 返回值是列表中嵌套字典，字典的所有键值对指定的就是页面的cookie信息

print(cookies1)

# 使用cookie信息

for cookie in cookies1:

    print(cookie)

    driver.add_cookie(cookie)

else:

    driver.refresh()

封装函数获取和使用cookies

def save_cookies(driver): # 将页面中的cookies信息保存在本地文件中 cookies1 = driver.get_cookies() with open("cookies.json", "w") as f: f.write(json.dumps(cookies1)) def load_cookies(driver): driver.get("http://47.107.116.139/fangwei/m.php?m=Public&a=login&") try: with open("cookies.json") as f: cookies = json.loads(f.read()) # 使用cookies for cookie in cookies: # print(cookie) driver.add_cookie(cookie) else: driver.refresh() except: print("目前没有cookie信息，不能进行绕过登录")

判断登录状态

为了提高代码容错率，判断是否是登录的状态，防止元素定位出现问题

def is_login(driver): # 通过登录状态判断是否已登录 if "管理员登录" in driver.title: print("需要正常登录") return False else: print("已登录") return True

如何使用

思想：先去使用cookies，如果没有直接进行正常登录

# 创建一个驱动对象driver = webdriver.Edge()# 准备一个被测试的页面url地址url = "http://47.107.116.139/fangwei/m.php?m=Public&a=login&"# 通过驱动发送请求driver.get(url)# 页面最大化driver.maximize_window()# 在页面正常登录之前使用cookiesload_cookies(driver)# 判断是否已登录if not is_login(driver): # 没有登录 # 截图验证码图片 driver.find_element(By.XPATH, '//*[@id="verify"]').screenshot("verify.jpg") # 调用第三方接口通过函数识别: code = get_verify_code("verify.jpg", 'xap001', '123456@xzp', "1902", "959380") # 账号 driver.find_element(By.XPATH, '//input[@name="adm_name"]').send_keys('admin') # 密码 driver.find_element(By.XPATH, '//input[@name="adm_password"]').send_keys("msjy123") # 验证码 driver.find_element(By.XPATH, '//input[@name="adm_verify"]').send_keys(code) # 登录按钮 driver.find_element(By.XPATH, '//*[@id="login_btn"]').click() # 提取登录cookies，保存到json文件中 save_cookies(driver) time.sleep(1) # 关闭驱动 # driver.quit()

 七、处理验证码：

详见验证码问题博文：

https://mp.csdn.net/mp_blog/creation/editor/138138791

八、UI自动化设计模式

一般web自动化的设计模式有两种类型

1-POM设计模式

P：page代表页面

O：object代表对象

M：module代表模型

以页面对象为模型进行封装和使用

核心思想：对页面元素进行封装成类的属性（类属性），用例执行流程设计成页面类的方法（实例方法）

作用：可以减少代码的冗余，而且方便后期维护，若页面元素发生变化，只需要调整页面封装的属性即可，从而提高用例脚本的可维护性以及可读性

流程：

页面需要被操作的元素定义成类的类属性

页面需要执行的用例脚本定义成类的实例方法

用例执行通过页面类创建一个页面对象，进行调用实例方法完成用例执行

pom模式封装页面：类属性和实例方法

class BackLogin: def __init__(self, driver): self.driver = driver # 封装页面属性 #账号 username = (By.XPATH, '//input[@name="adm_name"]') #密码 password = (By.XPATH, '//input[@name="adm_password"]') #验证码- code = (By.XPATH, '//input[@name="adm_verify"]') #登录按钮 btn_ok = (By.XPATH, '//*[@id="login_btn"]') # 获取实际结果 res_txt = (By.XPATH, '//*[@id="login_msg"]')# 登录功能 def login(self, username, password, code=None): self.find_element(*self.username, self.driver).send_keys(username) self.find_element(*self.password, self.driver).send_keys(password) self.find_element(*self.code, self.driver).send_keys(code) self.find_element(*self.btn_ok, self.driver).click() # 获取实际文本属性 -->这里采用自定义显示等待方法定位 msg = self.find_element(*self.res_txt, self.driver, need_wait=True).text return msg

在case脚本文件调用

back_login = BackLogin(driver)msg = back_login.login("admin", "123456", "")print(msg)assert msg == "验证码不能为空"

2-KDT设计模式

K：key代表关键字

D：driver代表驱动

T：test代表用例

核心思想：关键字驱动测试，可以实现极限封装0代码模式条件下，结合Excel表格数据进行去读，构造每个用例的步骤，完成用例的执行，得到最终的结果。

可以实现自动化框架搭建以及功能测试人员的分工

自动化测试框架搭建者负责关键字驱动测试的用例脚本设计

功能测试负责编写Excel规范的用例步骤

3、BasePage元类封装-思想

BasePage一般在pom设计模式中当做所有页面的父类（页面元类）

BasePage属于抽象类的范畴

不建议把BasePage类去实例化对象

不能代表任何的实例对象

把子类页面需要共同使用的资源（属性及方法）统一封装到BasePage元类中

简单理解：子类中使用率非常高的属性和方法统一抽取封装到BasePage元类中

定义一个BasePage类

class BasePage: def __init__(self, driver): self.driver = driver def wait(self, func): return WebDriverWait(self.driver, 5).until(func) def find_element(self, by, value, need_wait=False): def f(driver): # 判断当前元素是否有文本属性 if driver.find_element(by, value).text: msg = driver.find_element(by, value).text if need_wait: # 是否触发隐式等待,返回实际提示信息结果 return msg else: return True else: return True self.wait(f) return self.driver.find_element(by, value)

其它页面类继承BasePage

class DealPage(BasePage):pass

九、动态元素定位专题

动态元素定位：

动态元素定位-CSDN博客

十、UI常见问题

1、正向和反向用例，元素可能不一致，不能将元素定位写死，考虑模糊定位

消失型元素怎么办？