Selenium (软件):修订间差异
无编辑摘要 |
无编辑摘要 |
||
第175行: | 第175行: | ||
{{了解更多|[https://www.selenium.dev/documentation/zh-cn/webdriver/browser_manipulation/ Selenium | {{了解更多|[https://www.selenium.dev/documentation/zh-cn/webdriver/browser_manipulation/ Selenium 文档:WebDriver - 操控浏览器]}} | ||
==网络元素== | ==网络元素== | ||
WebElement表示DOM元素。 | |||
===查找元素=== | |||
可以通过使用WebDriver实例从文档根节点进行搜索,或者在另一个WebElement下进行搜索来找到WebElement。 | |||
{| class="wikitable" style="width: 100%; | |||
! 操作 | |||
! 方法 | |||
! 描述 | |||
! Python示例 | |||
|- | |||
| 查找单个元素 | |||
| Find Element | |||
| 此方法用于查找元素并返回第一个匹配的单个WebElement引用。 | |||
| driver.find_element(By.NAME, "q") | |||
|- | |||
| 查找多个元素 | |||
| Find Elements | |||
| 与"Find Element"相似, 但返回的是匹配WebElement列表。要使用列表中的特定WebElement,您需要遍历元素列表以对选定元素执行操作。 | |||
| driver.find_elements(By.TAG_NAME, 'p') | |||
|- | |||
| 查找当前页面上下文中具有焦点的元素 | |||
| Active Element | |||
| 此方法用于追溯或查找当前页面上下文中具有焦点的DOM元素 | |||
| driver.switch_to.active_element | |||
|- | |||
|} | |||
WebDriver API提供了内置方法来查找基于不同属性的WebElement (例如ID, Name, Class, XPath, CSS选择器, 链接文本等)。 | |||
===元素属性和方法=== | |||
{| class="wikitable" style="width: 100%; | |||
! 操作 | |||
! 方法或属性 | |||
! 描述 | |||
! Python示例 | |||
|- | |||
|元素是否被启用或禁用 | |||
|Is Enabled | |||
|此方法用于检查网页上连接的元素是否被启用或禁用. 返回一个布尔值, 如果在当前浏览上下文中启用了连接的元素, 则返回True; 否则返回false 。 | |||
|driver.find_element(By.NAME, 'btnK').is_enabled() | |||
|- | |||
|元素是否被选中 | |||
|Is Selected | |||
|此方法确定是否 已选择 引用的元素. 此方法广泛用于复选框, 单选按钮, 输入元素和选项元素.返回一个布尔值, 如果在当前浏览上下文中 已选择 引用的元素, 则返回 True, 否则返回 False。 | |||
|driver.find_element(By.CSS_SELECTOR, "input[type='checkbox']:first-of-type").is_selected() | |||
|- | |||
|元素标签名 | |||
|Get TagName | |||
|获取元素的TagName(标签名)。 | |||
|driver.find_element(By.CSS_SELECTOR, "h1").tag_name | |||
|- | |||
|元素的尺寸和坐标 | |||
|Get Rect | |||
|用于获取参考元素的尺寸和坐标,提取的数据主体包含以下详细信息:1.元素左上角的X轴位置,2.元素左上角的y轴位置,3.元素的高度,4.元素宽度 | |||
|driver.find_element(By.CSS_SELECTOR, "h1").rect | |||
|- | |||
|元素CSS值 | |||
|Get CSS Value | |||
|获取当前浏览上下文中元素的特定计算样式属性的值。 | |||
|ddriver.findElement(By.LINK_TEXT, "More information...").value_of_css_property('color') | |||
|- | |||
|获取元素文本 | |||
|Get Text | |||
|获取特定元素渲染后的文本 | |||
|driver.find_element(By.CSS_SELECTOR, "h1").text | |||
|- | |||
|} | |||
{{了解更多|[https://www.selenium.dev/documentation/zh-cn/webdriver/web_element/ Selenium 文档:WebDriver - 网络元素]}} | |||
==键盘操作== | ==键盘操作== | ||
第209行: | 第278行: | ||
clear用于清除可编辑元素的内容。 | clear用于清除可编辑元素的内容。 | ||
{{了解更多|[https://www.selenium.dev/documentation/zh-cn/webdriver/keyboard/ Selenium | {{了解更多|[https://www.selenium.dev/documentation/zh-cn/webdriver/keyboard/ Selenium 文档:WebDriver - Keyboard]}} | ||
2020年12月27日 (日) 07:16的版本
Selenium 是一个Web应用测试的开源框架,提供一系列Web浏览器自动化工具,可以模拟用户与浏览器的交互。Selenium IDE是一个Firefox插件,使用图形界面录制和测试。也可以通过Selenium WebDriver,使用多种语言来编写测试,包括:Java、Python、C#、Ruby、JavaScript 和 Kotlin 。
简介
主要工具
以下为Selenium提供的主要工具:
Selenium WebDriver:
Selenium IDE:
Grid:
安装
安装 Selenium
使用不同的语言,安装Selenium方式不同。
Python中可以使用 pip 安装Selenium:
pip install selenium
也可以下载源代码安装。
JavaScript中可以使用 npm 安装 :
npm install selenium-webdriver
了解更多 >> Selenium 文档:安装 Selenium 库
安装浏览器和浏览器驱动
浏览器 | 支持的操作系统 | 维护者 | 驱动 | 驱动下载 |
---|---|---|---|---|
Chromium/Chrome | Windows/macOS/Linux | 谷歌 | ChromeDriver | 下载 |
火狐 | Windows/macOS/Linux | Mozilla | 下载 | |
Edge | Windows 10 | 微软 | 下载 | |
Internet Explorer | Windows | Selenium 项目组 | 下载 | |
Safari | macOS El Capitan 及更高版本 | 苹果 | 内置 | |
Opera | Windows/macOS/Linux | Opera | 下载 |
以Debian/Ubuntu下安装Chrome浏览器和ChromeDriver驱动为例:
#安装Chrome浏览器
#官网下载Chrome稳定版的deb包
wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
#安装Chrome
sudo apt install ./google-chrome-stable_current_amd64.deb
#验证成功,查看chrome版本,结果如:Google Chrome 87.0.4280.88
google-chrome --version
#chromedriver驱动官网:https://chromedriver.storage.googleapis.com/index.html
#在官网查找下载chrome版本对应的chromedriver驱动。如Google Chrome 87.0.4280.88
wget https://chromedriver.storage.googleapis.com/87.0.4280.88/chromedriver_linux64.zip
#解压缩
unzip chromedriver_linux64.zip
#可以将chromedriver文件放置在环境变量路径(通过echo $PATH查看)上。
mv chromedriver /usr/bin
验证是否成功,以Python语言示例:
from selenium import webdriver
chrome_options = webdriver.ChromeOptions()
chrome_options.add_argument('--headless')
chrome_options.add_argument('--no-sandbox') #
chrome_options.add_argument('--disable-dev-shm-usage')
driver = webdriver.Chrome(chrome_options=chrome_options) #如果chromedriver没有添加到环境变量中,就需要添加参数指明路径executable_path='/path/to/chromedriver'
driver.get("https://www.baidu.com")
print(driver.page_source)
client.quit()
了解更多 >> Selenium 文档:WebDriver > 驱动要求
操控浏览器
以下Python编程语言示例:
from selenium import webdriver
driver = webdriver.Chrome()
浏览器导航
操作 | 描述 | Python示例 |
---|---|---|
打开网站 | 浏览器输入地址,打开网站 | driver.get("https://www.baidu.com") |
获取当前 URL | 从浏览器的地址栏读取当前的 URL | driver.current_url |
后退 | 按下浏览器的后退按钮 | driver.back() |
前进 | 按下浏览器的前进键 | driver.back() |
刷新 | 刷新当前页面 | driver.refresh() |
获取标题 | 从浏览器中读取当前页面的标题 | driver.title |
窗口和标签页
WebDriver 没有区分窗口和标签页。如果你的站点打开了一个新标签页或窗口,Selenium 将允许您使用窗口句柄来处理它。 每个窗口都有一个唯一的标识符,该标识符在单个会话中保持持久性。
操作 | 描述 | Python示例 |
---|---|---|
窗口句柄 | 获得当前窗口的窗口句柄 | driver.current_window_handle |
切换窗口或标签页 | ||
创建新窗口或新标签页,并且切换 | 创建一个新窗口或标签页,屏幕焦点将聚焦在新窗口或标签在上。注意:该特性适用于Selenium 4 + | |
关闭窗口或标签页 | 当你完成了一个窗口或标签页的工作时,_并且_它不是浏览器中最后一个打开的窗口或标签页时,你应该关闭它并切换回你之前使用的窗口。 | driver.close() |
退出浏览器 | 调用quit退出浏览器。退出将会关闭所有与 WebDriver 会话相关的窗口和选项卡,结束浏览器进程,结束后台驱动进程,通知 Selenium Grid 浏览器不再使用,以便可以由另一个会话使用 | driver.quit() |
了解更多 >> Selenium 文档:WebDriver - 操控浏览器
网络元素
WebElement表示DOM元素。
查找元素
可以通过使用WebDriver实例从文档根节点进行搜索,或者在另一个WebElement下进行搜索来找到WebElement。
操作 | 方法 | 描述 | Python示例 |
---|---|---|---|
查找单个元素 | Find Element | 此方法用于查找元素并返回第一个匹配的单个WebElement引用。 | driver.find_element(By.NAME, "q") |
查找多个元素 | Find Elements | 与"Find Element"相似, 但返回的是匹配WebElement列表。要使用列表中的特定WebElement,您需要遍历元素列表以对选定元素执行操作。 | driver.find_elements(By.TAG_NAME, 'p') |
查找当前页面上下文中具有焦点的元素 | Active Element | 此方法用于追溯或查找当前页面上下文中具有焦点的DOM元素 | driver.switch_to.active_element |
WebDriver API提供了内置方法来查找基于不同属性的WebElement (例如ID, Name, Class, XPath, CSS选择器, 链接文本等)。
元素属性和方法
操作 | 方法或属性 | 描述 | Python示例 |
---|---|---|---|
元素是否被启用或禁用 | Is Enabled | 此方法用于检查网页上连接的元素是否被启用或禁用. 返回一个布尔值, 如果在当前浏览上下文中启用了连接的元素, 则返回True; 否则返回false 。 | driver.find_element(By.NAME, 'btnK').is_enabled() |
元素是否被选中 | Is Selected | 此方法确定是否 已选择 引用的元素. 此方法广泛用于复选框, 单选按钮, 输入元素和选项元素.返回一个布尔值, 如果在当前浏览上下文中 已选择 引用的元素, 则返回 True, 否则返回 False。 | driver.find_element(By.CSS_SELECTOR, "input[type='checkbox']:first-of-type").is_selected() |
元素标签名 | Get TagName | 获取元素的TagName(标签名)。 | driver.find_element(By.CSS_SELECTOR, "h1").tag_name |
元素的尺寸和坐标 | Get Rect | 用于获取参考元素的尺寸和坐标,提取的数据主体包含以下详细信息:1.元素左上角的X轴位置,2.元素左上角的y轴位置,3.元素的高度,4.元素宽度 | driver.find_element(By.CSS_SELECTOR, "h1").rect |
元素CSS值 | Get CSS Value | 获取当前浏览上下文中元素的特定计算样式属性的值。 | ddriver.findElement(By.LINK_TEXT, "More information...").value_of_css_property('color') |
获取元素文本 | Get Text | 获取特定元素渲染后的文本 | driver.find_element(By.CSS_SELECTOR, "h1").text |
了解更多 >> Selenium 文档:WebDriver - 网络元素
键盘操作
键盘操作通过使用底层接口允许我们向web浏览器提供虚拟设备输入。
键盘输入
sendKeys用于模拟键盘输入。不同语言版本中函数名有一些差别,如Java中使用sendKeys()函数,Python中使用send_keys()函数。以下示例为Python版,打开百度网页,在输入框输入”webdriver“并按回车键:
from selenium import webdriver
from selenium.webdriver.common.by import By
from selenium.webdriver.common.keys import Keys
driver = webdriver.Chrome()
# 打开百度页面
driver.get("http://www.baidu.com")
# 输入"webdriver"文本和输入"ENTER"按键
driver.find_element(By.ID, "kw").send_keys("webdriver" + Keys.ENTER)
# 查看页面代码
driver.page_source
按下按键
keyDown用于模拟按下辅助按键(CONTROL, SHIFT, ALT)的动作。
按键弹起
keyUp用于模拟辅助按键(CONTROL, SHIFT, ALT)弹起或释放的操作。
清除
clear用于清除可编辑元素的内容。
了解更多 >> Selenium 文档:WebDriver - Keyboard
资源
官网
- 官网:https://www.selenium.dev
- 中文文档:https://www.selenium.dev/documentation/zh-cn/
- Github:https://github.com/SeleniumHQ/selenium
- PyPI:https://pypi.python.org/pypi/selenium