Selenium（3 + 4 超级详细笔记）
文章目录
- selenium（web自动化测试）
-
- 1. selenium初始化（2种）
- 2. chrome 启动参数（3种）
- 3. 八大定位方式
-
- 3.1 css 定位
- 3.2 xpath 定位
- 3.3 link_text 定位
- 3.4 partial_link_text 定位
- 3.5 relative 相对定位
- 4. 添加等待时间
-
- 4.1 休眠等待：time（调式）
- 4.2 显式等待：Explicit Waits（常用）
- 4.3 隐式等待：Implicit Waits
- 5. 浏览器操作（WebDriver方法）
-
- 5.1 获取信息
- 5.2 导航
- 5.3 切换框架（iframe）
- 5.4 切换窗口（window）
- 5.5 屏幕截图
- 6. 元素操作（WebElement方法）
-
- 6.1 鼠标操作（click）
- 6.2 键盘操作（send_keys）
- 6.3 其它操作（4种）
- 7. 下拉框操作（Select）
- 8. 提示框操作（Prompt box）
- 9. 执行 JS 脚本
- 10. PO(page object) 框架
selenium（web自动化测试）
1. selenium初始化（2种）
- 方式一：
# 导入包 （selenium 4版本）
import pytest, os
from selenium import webdriver
from selenium.webdriver.chrome.service import Service
# 用 os 处理路径
chrome_driver_path = os.path.abspath(os.path.join(os.path.dirname(os.path.dirname(__file__)), 'drivers/chromedriver.exe'))
edge_driver_path = os.path.abspath(os.path.join(os.path.dirname(os.path.dirname(__file__)), 'drivers/msedgedriver.exe'))
# 处理测试初始化
@pytest.fixture(scope='session')
def open_close_browser():
print("Open browser!")
# 调起 chrome 浏览器
driver = webdriver.Chrome(service=Service(chrome_driver_path))
# 调起 edge 浏览器
# driver = webdriver.Edge(service=Service(edge_driver_path))
yield driver
print("Close browser!")
driver.close()
print("Test over!")
- 方式二：（推荐）
# 导入包 （selenium 4版本）
import pytest, os
from selenium import webdriver
from selenium.webdriver.chrome.service import Service
from webdriver_manager.chrome import ChromeDriverManager
from webdriver_manager.microsoft import EdgeChromiumDriverManager
from webdriver_manager.microsoft import IEDriverManager
from webdriver_manager.firefox import GeckoDriverManager
# 处理测试初始化
print("Open browser!")
# 调起 chrome 浏览器
# 设置 option 参数（选择）
service = Service(executable_path=ChromeDriverManager().install())
driver = webdriver.Chrome(service=service)
# 调起 edge 浏览器
# service = Service(executable_path=EdgeChromiumDriverManager().install())
# driver = webdriver.Edge(service=service)
# 调起 ie 浏览器
# service = Service(executable_path=IEDriverManager().install())
# driver = webdriver.Ie(service=service)
# 调起 firefox 浏览器
# service = Service(executable_path=GeckoDriverManager().install())
# driver = webdriver.Firefox(service=service)
yield driver
print("Close browser!")
driver.close()
print("Test over!")
# 自动下载的 driver（驱动）在C盘的用户夹下的.wdn文件中。
2. chrome 启动参数（3种）
- –headless: 无界面运行（示例）
# 选择参数
option = webdriver.ChromeOptions()
# 添加属性值
option.add_argument('--headless')
# 创建浏览器驱动对象
driver = webdriver.Chrome(options=option, service=Service(chrome_driver_path))
- –start-maximized: 窗口最大化运行
option.add_argument('--start-maximized')
- –incognito: 隐身模式运行
option.add_argument('--incognito')
- 不展示“浏览器正在被自动化程序控制”提示
option.add_experimental_option('excludeSwitches', ['enable-automation'])
3. 八大定位方式
| 定位方式 | 代码 |
|---|---|
| id 定位 | driver.find_element(By.ID, ‘kw’) |
| name 定位 | driver.find_element(By.NAME, ‘wd’) |
| classname 定位 | driver.find_element(By.CLASS_NAME, ‘s_ipt’) |
| tar_name 定位 | driver.find_element(By.TAG_NAME, ‘input’) |
| css 定位 | 1. driver.find_element(By.CSS_SELECTOR, ‘#kw’) # CSS选择器 2. driver.find_element(By.CSS_SELECTOR, ‘input.s_plt’) # CSS选择器 |
| xpath 定位 | driver.find_element(By.XPATH, ‘//*[@id=“kw”]’) |
| link_text 定位 | driver.find_element(By.LINK_TEXT, ‘新闻’) |
| partial_link_text 定位 | driver.find_element(By.PARTIAL_LINK_TEXT, ‘新’) |
3.1 css 定位
工具获取
- 通过chrome开发者工具复制可得， 百度首页为例,css定位搜索输入框
driver.find_element(By.CSS_SELECTOR, '#kw').send_keys('selenium')
手工编写获取
-
标签和属性组合： 标签名[属性名=属性值]
-
有多个标签时，标签之前空格相隔
-
属性可以是任意属性
-
class/id除了可以采用以上写法外，还可以采用专用写法, 以百度搜索输入框为例：
-
- 通过class编写： 标签名.class属性值
input.s_ipt # input标签中class属性值为s_ipt- 通过id编写： 标签名#id属性值
input#kw # input标签中id属性值为kw- class 和 id 组合
input#kw.s_ipt # input标签中id值为kw,class值为s_ipt
3.2 xpath 定位
| 表达式 | 描述 |
|---|---|
| // | 从当前节点获取子孙节点 |
| / | 从当前节点获取直接子节点 |
| @ | 选取属性 |
| [ ] | 添加筛选条件 |
| * | 获取当前节点 |
| ** | 获取当前节点的父节点 |
| nodename | 获取该节点的所有子节点 |
-
XPath：即为XML路径语言（XML Path Language），它是一种用来确定XML文档中某部分位置的语言。它被开发者采用来当作小型查询语言.
-
获取xpath路径有两种方式：
- 通过开发者工具复制 xpath 路径：
driver.find_element(By.XPATH, '//*[@id="kw"]')- 手工编写 xpath 路径：
1.纯标签路径：
纯标签路径分两种：一种是绝对路径，另一种是相对路径， 以百度首页输入框为例：
1. 绝对路径：
/html/body/div/div/div[5]/div/div/form/span[1]/input- 相对路径：
//form/span[1]/input2.标签和属性相结合：
语法：//标签名[@属性名=属性值]
//input[@id='kw'] # 查找input标签中属性id值为kw的页面元素 //*[@id='kw'] # 查找属性为id=‘kw'的页面元素 //span/input[@id='kw'] # 标签也可以有多个 //span[@class='bg s_ipt_wr quickdelete-wrap']/input # 还可以使用上层标签的属性帮助定位3. xpath 模糊匹配：
- starts-with: 以什么开头
//input[starts-with(@type, "sub")] # 查找input标签中type属性,其值以sub开头的页面元素- ends-with: 以什么结尾（注：chrome使用的是xpath1.0版本，不支持此项模糊查询)
//input[ends-with(@type,"mit")] # 查找input标签中type属性,其属性值以mit结尾的页面元素- contains: 包含
//input[contains(@class, 's_btn')] # 查找input标签中class属性中含有“s_btn”字符串的页面元素- contains: 包含text
//div[contains(text(), "热榜")] # 查找div标签中文本中含有“热榜”的页面元素
3.3 link_text 定位
- link_text定位文字链接：
driver.find_element(By.LINK_TEXT, '新闻').click()
3.4 partial_link_text 定位
- partial_link_text通过部分文字定位文字链接：
driver.find_element(By.PARTIAL_LINK_TEXT, '新').click()
3.5 relative 相对定位
- to_left_of：定位位于指定元素左侧的元素。
- to_right_of：定位位于指定元素右侧的元素。
- above：定位位于指定元素上方的元素。
- below：定位位于指定元素下方的元素。
from selenium.webdriver.support.relative_locator import locate_with
# 获取相对元素
text_locator = locate_with(By.ID,'kw').to_left_of({By.ID: "kw"})
# 注意：
# 目前不知道这个元素能干什么，后续补充！
4. 添加等待时间
4.1 休眠等待：time（调式）
- 有时候为了保证脚本运行的稳定性，需要脚本中添加等待时间, 添加休眠：
import time # 先导入模块文件
sleep(3) # 休眠3秒
4.2 显式等待：Explicit Waits（常用）
- 显式等待主要是使用WebDriverWait来实现，其语法格式如下：
from selenium.webdriver.support.wait import 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：超时后抛出的提示；
- 示例：
from selenium.webdriver.support.wait import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
# 创建 Wait 对象
wait = WebDriverWait(driver,2,0.3)
wait.until(EC.title_is('标题'))
# 后续操作
| 方法 | 描述 | 类型 |
|---|---|---|
| title_is(‘’) | 判断当前页面的 title 是否等于预期 | 布尔 |
| title_contains(‘’) | 判断当前页面的 title 是否包含预期字符串 | 布尔 |
| presence_of_element_located(locator) | 判断元素是否被加到了 dom 树里，并不代表该元素一定可见 | WebElement |
| visibility_of_element_located(locator) | 判断元素是否可见，可见代表元素非隐藏，并且元素的宽和高都不等于0 | WebElement |
| visibility_of(element) | 跟上一个方法作用相同，但传入参数为 element | WebElement |
| 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 | 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() # 关闭浏览器并释放进程资源
4.3 隐式等待：Implicit Waits
- 适用场景：一般在 Browser 初始化阶段（conftest文件中）使用。
driver.implicitly_wait(30)
# 隐式地等待一个元素被发现或一个命令完成，这个方法每次会话只需要调用一次。
5. 浏览器操作（WebDriver方法）
5.1 获取信息
- 获取浏览器信息，其方法分别如下所示：
driver = webdriver.Chrome()
driver.title # 获取浏览器当前页面的标签
driver.current_url # 获取浏览器当前地址栏的URL
driver.page_source # 获取当前html源码
driver.name # 获取浏览器名称(chrome)
driver.current_window_handle # 窗口句柄
driver.window_handles # 当前窗口的所有句柄
driver.get_window_rect() # 获取浏览器尺寸，位置
driver.get_window_position() # 获取浏览器位置(左上角)
# 运行结果：
{'width': 1552, 'height': 840}
{'x': -8, 'y': -8}
5.2 导航
- 浏览器导航，其实现方法分别为：
driver.forward() # 浏览器前进
driver.back() # 浏览器后退
driver.refresh() # 刷新必应网页
5.3 切换框架（iframe）
- 使用 WebElement：
# 存储网页元素
iframe = driver.find_element(By.CSS_SELECTOR, "#modal > iframe")
# 切换到选择的 iframe
driver.switch_to.frame(iframe)
# 单击按钮
driver.find_element(By.TAG_NAME, 'button').click()
- 使用 name 或 id：
# 通过 id 切换框架
driver.switch_to.frame('buttonframe')
# 单击按钮
driver.find_element(By.TAG_NAME, 'button').click()
- 使用索引：
# 基于索引切换到第 2 个 iframe
iframe = driver.find_elements(By.TAG_NAME,'iframe')[1]
# 切换到选择的 iframe
driver.switch_to.frame(iframe)
- 离开框架：
# 切回到默认内容
driver.switch_to.default_content()
5.4 切换窗口（window）
# 打开新闻 Tab 标签
driver.find_element(By.LINK_TEXT,'新闻').click()
# 休眠 1 秒
sleep(1)
# 切换到第一个 Tab 标签
driver.switch_to.window(driver.window_handles[0])
5.5 屏幕截图
- 常用的截图方法如下：
| 方法 | 描述 |
|---|---|
| driver.save_screenshot(filename) | 获取当前屏幕截图保存为指定文件，filename指定为完整保存路径或文件名 |
| driver.get_screenshot_as_base64() | 获取当前的屏幕截图 base64 编码字符串 |
| driver.get_screenshot_as_file(filename) | 获取当前的屏幕截图，使用完整的路径 |
| driver.get_screenshot_as_png() | 获取当前屏幕截图的二进制文件数据 |
- 获取当前屏幕截图的案例：
from time import sleep, strftime, localtime, time
# 文件路径名
filename = os.path.abspath(os.path.dirname(__file__)) + '/screenshot.png'
filename = 'screenshot.com'
# 图片的时间信息
st = strftime("%Y-%m-%d-%H-%M-%S", localtime(time()))
filename = st + '.png'
# 获取屏幕截图
driver.save_screenshot(filename)
- 获取截屏保存到文件夹中：
import os
from time import sleep, strftime, localtime, time
# 图片的时间信息
st = strftime("%Y-%m-%d-%H-%M-%S", localtime(time()))
file_name = st + '.png'
# 路径
path = os.path.abspath('screenshot')
file_path = path + '/' + file_name
# 获取屏幕截图
driver.save_screenshot_as_file(file_path)
6. 元素操作（WebElement方法）
- 常用的元素操作方法如下：
| 方法 | 描述 |
|---|---|
| text | 获取元素文本内容 |
| rect | 获取元素位置信息 |
| click() | 单击左键 |
| send_keys() | 输入内容 |
| clear() | 清除内容 |
| submit() | 提交表单 |
| get_attribute(“属性”) | 获取属性值 |
| is_selected() | 是否被选中 |
| is_enabled() | 是否可用 |
| is_displayed() | 是否显示 |
| value_of_css_property() | css 属性值 |
6.1 鼠标操作（click）
- 常用的鼠标操作方法如下：
| 方法 | 描述 |
|---|---|
| click() | 单击左键 |
| context_click() | 单击右键 |
| double_click() | 双击左键 |
| drag_and_drop() | 鼠标拖动 |
| move_to_element() | 鼠标悬停 |
| execute_script() | 界面滑动 |
| perform() | 执行所有ActionChains中存储的动作 |
- 单击左键
from selenium.webdriver.common.by import By
element = driver.find_element(By.ID, 'su') #定位元素
element.click() # 给元素 单击左键
-
单击右键
-
依赖：pyautogui第三方支持右键菜单元素操作
import pyautogui
from selenium.webdriver.common.by import By
from selenium.webdriver import ActionChains
#定位元素
element = driver.find_element(By.ID, 'su')
# 给元素 单击右键
ActionChains(driver).context_click(element).perform()
# 等待2s
sleep(2)
#
pyautogui.typewrite(['down', 'down', 'return'])
- 双击左键
from selenium.webdriver.common.by import By
from selenium.webdriver import ActionChains
# 定位元素
element = driver.find_element(By.ID, 'su')
# 给元素 双击左键
ActionChains(driver).double_click(element).perform()
- 鼠标拖动
from selenium.webdriver.common.by import By
from selenium.webdriver import ActionChains
# 定位要拖动的元素
source = driver.find_element('选择器','xxx')
# 定位目标元素
target = driver.find_element('选择器','xx')
# 执行拖动动作
ActionChains(driver).drag_and_drop(source, target).perform()
- 鼠标悬停
from selenium.webdriver.common.by import By
from selenium.webdriver import ActionChains
#定位元素
element = driver.find_element(By.XPATH, '"//div/a[@class='s-bri c-font-normal c-color-t']"')
# 给元素 鼠标悬停
ActionChains(driver).move_to_element(element).perform()
6.2 键盘操作（send_keys）
-
作用：模拟键盘输入内容。
-
在webdriver中的keys类中，提供了很多按键方法，常用的按键操作有：
| 操作 | 描述 |
|---|---|
| Keys.ENTER | 回车键 |
| Keys.BACK_SPACE | 删除键 |
| Keys.F1 | F1键 |
| Keys.SPACE | 空格 |
| Keys.CONTROL | Ctrl键 |
| Keys.TAB | Tab键 |
| Keys.ESCAPE | ESC键 |
| Keys.ALT | Alt键 |
| Keys.SHIFT | Shift键 |
| Keys.ARROW_UP | 向上箭头 |
| Keys.ARROW_RIGHT | 向右箭头 |
| Keys.ARROW_DOWN | 向下箭头 |
| Keys.ARROW_LEFT | 向左箭头 |
- 回车键操作案例：
from selenium.webdriver.common.by import By
from selenium.webdriver import Keys
# 定位元素
element = driver.find_element(By.ID, 'kw')
# 给元素 双击左键
element.send_keys('selenium', Keys.ENTER)
- 复制，粘贴操作案例：
from selenium.webdriver.common.by import By
from selenium.webdriver import Keys
# 定位元素
element = driver.find_element(By.ID, 'kw')
# 全选文本
element.send_keys(Keys.CONTROL, 'a')
element.send_keys(Keys.CONTROL, 'c')
element.send_keys(Keys.CONTROL, 'v')
6.3 其它操作（4种）
- 清除输入框的内容：clear()
from selenium.webdriver.common.by import By
# 定位搜索输入框，向搜索输入框中输入文本“selenium"
element = driver.find_element(By.ID, 'kw').send_keys('selenium')
# 等待2s
sleep(2)
# 清除搜索输入框中的文本
element.clear()
- 提交表单：submit()
from selenium.webdriver.common.by import By
# 定位搜索输入框，向搜索输入框中输入文本“selenium"
driver.find_element(By.ID, 'kw').send_keys('selenium')
#定位搜索按钮，并提交表单
driver.find_element(By.ID, 'su').submit()
- 获取元素文本内容：text
from selenium.webdriver.common.by import By
# 定位文本框
element = driver.find_element(By.CSS_SELECTOR, '#bottom_layer > div > p:nth-child(3) > a')
# 等待2s
sleep(1)
# 打印出元素文本内容
print('get text:', element.text)
- 获取页面元素属性：get_attribute(“属性”)
from selenium.webdriver.common.by import By
# 定位文本输入框
element = driver.find_element(By.ID, 'kw')
# 打印文本输入框的 name 属性
print(f'the attribute value of element is: {element.get_attribute("name")}')
7. 下拉框操作（Select）
- 常用的下拉框操作方法如下：
| 方法/属性 | 方法/属性描述 |
|---|---|
| select_by_value() | 根据值选择 |
| select_by_index() | 根据索引选择 |
| select_by_visible_text() | 根据文本选择 |
| deselect_by_value() | 根据值反选 |
| deselect_by_index() | 根据索引反选 |
| deselect_by_visible_text() | 根据文本反选 |
| deselect_all() | 反选所有 |
| options | 所有选项 |
| all_selected_options | 所有选中选项 |
| first_selected_option | 第一个选中选项 |
- 根据值选择案例：
from selenium.webdriver.support.select import Select
# 定位下拉框
element = driver..find_element_by_name('selects')
# 选择选项
Select(element).select_by_visible_text('北京')
8. 提示框操作（Prompt box）
- alert 框： 只有一个确定按钮。
# 定位 alert 框
driver.find_element(By.ID, 'alert').click()
# 切换到 alert 框
alert = driver.switch_to.alert
# 点击确认
alert.accept()
- confirm 框 ：两个按钮，一个“确定”按钮，另一个是“取消”按钮。
# 定位 confirm 框
driver.find_element(By.ID, 'confirm').click()
# 切换到 confirm 框
confirm = driver.switch_to.alert
# 点击确认
confirm.accept()
# 点击取消
confirm.dismiss()
- prompt 框： 一个文本输入框，一个”确定“按钮和一个”取消“按钮。
# 定位 prompt 框
driver.find_element(By.ID, 'prompt').click()
# 切换到 prompt 框
prompt = driver.switch_to.alert
# 向 prompt 框发送消息
prompt.send_keys('lisainfsad')
# 点击确认
prompt.accept()
# 点击取消
prompt.dismiss()
9. 执行 JS 脚本
- 界面滑动案例：
# 使用execute_script方法执行JavaScript代码来实现鼠标滚动
js='window.scrollTo(0, 500);'
# 向下滚动 500 像素
driver.execute_script(js)
10. PO(page object) 框架
