知行迭代
导航
首页
最近更改
随机页面
常用
分类目录
Linux命令
Mediawiki常用
电脑技巧
工具
链入页面
相关更改
特殊页面
页面信息
登录
查看“Selenium (软件)”的源代码
←
Selenium (软件)
页面
讨论
阅读
查看源代码
查看历史
因为以下原因,您没有权限编辑本页:
您请求的操作仅限属于该用户组的用户执行:[
[1]
]
您可以查看和复制此页面的源代码。
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 {{了解更多|[https://www.selenium.dev/documentation/zh-cn/selenium_installation/installing_selenium_libraries/ Selenium 文档:安装 Selenium 库]}} ===安装浏览器和浏览器驱动=== {| class="wikitable" |- ! 浏览器 ! 支持的操作系统 ! 维护者 ! 驱动 ! 驱动下载 |- | [[Chromium]]/[[Google Chrome|Chrome]] | Windows/macOS/Linux | 谷歌 | [[ChromeDriver]] | [https://chromedriver.storage.googleapis.com/index.html 下载] |- | 火狐 | Windows/macOS/Linux | Mozilla | geckodriver | [https://github.com/mozilla/geckodriver/releases 下载] |- | Edge | Windows 10 | 微软 | msedgedriver | [https://developer.microsoft.com/en-us/microsoft-edge/tools/webdriver/ 下载] |- | Internet Explorer | Windows | Selenium 项目组 | | 下载 |- | Safari | macOS El Capitan 及更高版本 | 苹果 | | 内置 |- | Opera | Windows/macOS/Linux | Opera | | 下载 |} 以[[Debian]]/[[Ubuntu]]下安装[[Google Chrome|Chrome]]浏览器和[[ChromeDriver]]驱动为例: <syntaxhighlight lang="bash"> #安装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 </syntaxhighlight> 在命令行输入驱动名,验证是否添加成功。 <syntaxhighlight lang="bash" > chromedriver # chrome geckodriver # firefox </syntaxhighlight> ===检测安装成功=== 以Python语言示例: <syntaxhighlight lang="python" > from selenium import webdriver driver = webdriver.Firefox() driver.get('https://www.baidu.com') </syntaxhighlight> 如果不将驱动加入环境变量,需要在每次使用时,指定驱动路径。以Python使用为例: <syntaxhighlight lang="python" > # executable_path 在selenium 4 已弃用 from selenium import webdriver from selenium.webdriver.firefox.service import Service s = Service(r'D:\geckodriver-v0.31.0-win6\geckodriver.exe') driver = webdriver.Firefox(service=s) driver.get('https://www.baidu.com') </syntaxhighlight> 常见错误: 加入环境变量后,在代码中还是显示找不到 重启编辑器即可。 {{了解更多|[https://www.selenium.dev/documentation/zh-cn/webdriver/driver_requirements/ Selenium 文档:WebDriver > 驱动要求]}} ==快速入门== ===浏览器=== {| class="wikitable" ! 名称 ! 描述 ! 示例 |- |Chrome | | <syntaxhighlight lang="python" > from selenium import webdriver driver = webdriver.Chrome() </syntaxhighlight> |- | firefox | | <syntaxhighlight lang="python" > from selenium import webdriver driver = webdriver.Firefox() </syntaxhighlight> |- | | | |} ===无头浏览器=== 以[[Python]]语言chrome示例: <syntaxhighlight lang="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) driver.quit() </syntaxhighlight> firefox示例: <syntaxhighlight lang="python" > from selenium import webdriver from selenium.webdriver.firefox.options import Options op = Options() op.headless = True driver = webdriver.Firefox(options=op) driver.get(url) print(driver.title) driver.close() </syntaxhighlight> ===下载文件=== firefox示例: <syntaxhighlight lang="python" > from selenium import webdriver from selenium.webdriver.firefox.options import Options op = Options() op.set_preference("browser.download.folderList",2) op.set_preference("browser.download.manager.showWhenStarting", False) op.set_preference("browser.download.dir",save_path) # 设置下载位置 op.set_preference("browser.helperApps.neverAsk.saveToDisk", "binary/octet-stream") op.headless = True # 设置无头模式 driver = webdriver.Firefox(options=op) driver.get(r'https://test.com/test.jpg') driver.close() </syntaxhighlight> ==浏览器设置== ===浏览器参数=== {{了解更多 |[https://www.selenium.dev/zh-cn/documentation/webdriver/browsers/chrome/ selenium 文档:browsers/chrome] |[https://peter.sh/experiments/chromium-command-line-switches/ Peter Beverloo:List of Chromium Command Line Switches] }} ==浏览器操作== 以下[[Python]]编程语言示例: <syntaxhighlight lang="python"> from selenium import webdriver driver = webdriver.Chrome() </syntaxhighlight> ===浏览器导航=== {| class="wikitable" style="width: 100%; ! 操作 ! 描述 ! Python示例 |- | 打开网站 | 浏览器输入地址,打开网站 | driver.get("https://www.baidu.com") |- | 获取当前 URL | 从浏览器的地址栏读取当前的 URL | driver.current_url |- | 后退 | 按下浏览器的后退按钮 | driver.back() |- | 前进 | 按下浏览器的前进键 | driver.back() |- | 刷新 | 刷新当前页面 | driver.refresh() |- | 获取标题 | 从浏览器中读取当前页面的标题 | driver.title |- |} ===窗口和标签页=== WebDriver 没有区分窗口和标签页。如果你的站点打开了一个新标签页或窗口,Selenium 将允许您使用窗口句柄来处理它。 每个窗口都有一个唯一的标识符,该标识符在单个会话中保持持久性。 {| class="wikitable" style="width: 100%; ! 操作 ! 描述 ! Python示例 |- | 窗口句柄 | 获得当前窗口的窗口句柄 | driver.current_window_handle |- | 切换窗口或标签页 | | |- | 创建新窗口或新标签页,并且切换 | 创建一个新窗口或标签页,屏幕焦点将聚焦在新窗口或标签在上。注意:该特性适用于Selenium 4 + | |- | 关闭窗口或标签页 | 当你完成了一个窗口或标签页的工作时,_并且_它不是浏览器中最后一个打开的窗口或标签页时,你应该关闭它并切换回你之前使用的窗口。 | driver.close() |- | 退出浏览器 | 调用quit退出浏览器。退出将会关闭所有与 WebDriver 会话相关的窗口和选项卡,结束浏览器进程,结束后台驱动进程,通知 Selenium Grid 浏览器不再使用,以便可以由另一个会话使用 | driver.quit() |- |} {{了解更多|[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选择器, 链接文本等)。以下使用查找单个元素Find Element示例,查找多个元素Find Elements同样适用。 Python版本的<code>find_element_by_* </code>系列的方法,在新版本中以弃用 {| class="wikitable" style="width: 100%; ! 操作 ! 描述 ! Python 示例 |- | By ID | 通过ID查找元素。适用元素如:<code><nowiki><div id="q">...</div></nowiki></code> | driver.find_element(By.ID, "q") |- | By Name | 通过Name查找元素。适用元素如:<code><nowiki><input name="btnK">...</input></nowiki></code> | driver.find_element(By.NAME, 'btnK') |- | By Class Name | 通过Class Name查找元素。适用元素如:<code><nowiki><p class="rk">...</p></nowiki></code> | driver.find_element(By.CLASS_NAME, 'rk') |- |By Tag Name |通过标签名查找元素 | driver.find_element(By.TAG_NAME, "div") |- |By Link Text |通过链接文本查找元素 |driver.find_element(By.LINK_TEXT, "更多信息...") |- |By Partial Link Text |通过部分链接文本查找元素 |driver.find_element(By.PARTIAL_LINK_TEXT, "更多信") |- |By CSS |通过[[CSS]]选择器查找元素 |driver.find_element(By.CSS_SELECTOR, "h1") |- |By XPath | 通过[[XPath]]查找元素。 |driver.find_element(By.XPATH, "//form[1]") |- |} ===元素属性和方法=== {| 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() |- |元素标签名 |tag_name |获取元素的TagName(标签名)。 |driver.find_element(By.CSS_SELECTOR, "h1").tag_name |- |元素的尺寸和坐标 |rect |用于获取参考元素的尺寸和坐标,提取的数据主体包含以下详细信息:1.元素左上角的X轴位置,2.元素左上角的y轴位置,3.元素的高度,4.元素宽度 |driver.find_element(By.CSS_SELECTOR, "h1").rect |- |元素CSS值 |value_of_css_property() |获取当前浏览上下文中元素的特定计算样式属性的值。 |ddriver.findElement(By.LINK_TEXT, "More information...").value_of_css_property('color') |- |获取元素文本 |text |获取特定元素渲染后的文本 |driver.find_element(By.CSS_SELECTOR, "h1").text |- |获取元素属性的值 |get_attribute() | |<code>element.get_attribute('href')</code>获取元素的href值 <br /><code>element.get_attribute('innerHTML')</code>获取元素的内部HTML代码 <br /> <code>ele.get_atrribute("outerHTML")</code>获取元素的HTML代码 |- |获取元素属性的值 |get_property() | |<code>element.get_property('href')</code> |} {{了解更多 |[https://www.selenium.dev/documentation/zh-cn/webdriver/web_element/ Selenium 文档:WebDriver - 网络元素] |[https://selenium-python.readthedocs.io/locating-elements.html baijum/selenium python文档:Locating Elements]}} ===选择列表元素=== 选择列表元素相比普通元素,提供了一系列方法,方便与<select> 元素进行交互。该类仅适用于用于 HTML 元素 select 和 option。 Python为例,点击某个选择列表的所有选项: <syntaxhighlight lang="python" > from selenium import webdriver from selenium.webdriver.common.by import By from selenium.webdriver.support.ui import Select driver = webdriver.Firefox() driver.get('https://example.com') select_element = driver.find_element(By.TAG_NAME, 'select') select = Select(select_element) for option in select.options: print(option.text) # 打印选项文本 option.click() # 点击选项 </syntaxhighlight> 以下是select元素类提供的特别方法,其他属性方法见同普通元素的属性方法如元素可见文本<code>elem.text</code>,点击元素<code>elem.click()</code>。 {| class="wikitable" ! 名称 ! 描述 ! 示例 |- | 构建类 | 生成选择列表元素对象。定位 <select> 元素,然后使用Select()初始化一个Select 对象。Selenium 4.5 开始, 您无法针对禁用的 <select> 元素构建 Select 对象. | <syntaxhighlight lang="python" > select_element = driver.find_element(By.NAME, 'selectomatic') select = Select(select_element) </syntaxhighlight> |- | 全部选项 | 获取 <select> 元素中所有选项列表 | <code>select.options</code> |- | 所选中的选项列表 | 获取 <select> 元素中所选中的选项列表。对于单选列表,返回只包含一个元素的列表,对于复选列表则表示包含的零个或多个元素。 | <code>select.all_selected_options</code> |- | 通过文本选择选项 | 根据其可见文本选择选项 | <code> select.select_by_visible_text('2021年')</code> |- | 通过value值选择选项 | 根据其值属性选择选项 | <code>select.select_by_value('2021')</code> |- | 通过序号值选择选项 | 根据其在列表中的位置选择选项 | <code> select.select_by_index(3)</code> |- | 通过value值的disabled选择选项 | 具有 disabled 属性的选项可能无法被选择。Selenium v4.5 + 支持 | <syntaxhighlight lang="python" > with pytest.raises(NotImplementedError): select.select_by_value('disabled') </syntaxhighlight> |- | 取消选择选项 | 只有复选类型的选择列表才能取消选择选项. 您可以对要选择的每个元素重复使用这些方法. | <code>select.deselect_by_value('eggs')</code> |} {{了解更多 |[https://www.selenium.dev/zh-cn/documentation/webdriver/support_features/select_lists/ Selenium 文档: 使用选择列表元素] }} ==操作== ===键盘操作=== 键盘操作通过使用底层接口允许我们向web浏览器提供虚拟设备输入。以下示例为Python版,打开百度网页,在输入框输入”webdriver“并按回车键: <syntaxhighlight lang="python"> 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 </syntaxhighlight> {| class="wikitable" ! 名称 ! 描述 ! 示例 |- | 键盘输入 <br />sendKeys | 用于模拟键盘输入。 | |- | 按下按键 <br />keyDown | 用于模拟按下辅助按键(CONTROL, SHIFT, ALT)的动作。 | |- | 按键弹起 <br />keyUp | 用于模拟辅助按键(CONTROL, SHIFT, ALT)弹起或释放的操作。 | |- | 清除<br />clear | 用于清除可编辑元素的内容。 | |} {{了解更多|[https://www.selenium.dev/documentation/zh-cn/webdriver/keyboard/ Selenium 文档:WebDriver - Keyboard]}} ===鼠标操作=== {{了解更多 |[https://www.selenium.dev/zh-cn/documentation/webdriver/actions_api/mouse/ Selenium 文档:Mouse actions] }} ===笔操作=== ===滚轮操作=== ==等待== 网页加载有大量异步内容,某些元素可能在程序运行后才出现,导致查找时出现找不到。 {| class="wikitable" ! 名称 ! 描述 ! 示例 |- | 显式等待 | 条件为假时一直尝试,条件真时继续执行。 | <syntaxhighlight lang="python" > from selenium.webdriver.support.wait import WebDriverWait WebDriverWait(driver, timeout=10).until(lambda d: d.find_element(By.TAG_NAME,"p")) </syntaxhighlight> |- | 隐式等待 | WebDriver在查找元素时先等待设置的时间,默认时间为0,表示禁用。不要混合使用隐式和显式等待,这样做会导致不可预测的等待时间。 |<syntaxhighlight lang="python" > from selenium import webdriver driver = Firefox() driver.implicitly_wait(10) </syntaxhighlight> |- | 流畅等待 | 流畅等待实例定义了等待条件的最大时间量,以及检查条件的频率。用户可以配置等待来忽略等待时出现的特定类型的异常,例如在页面上搜索元素时出现的NoSuchElementException。 |<syntaxhighlight lang="python" > from selenium import webdriver from selenium.webdriver.common.by import By from selenium.webdriver.support.ui import WebDriverWait import selenium.webdriver.support.expected_conditions as EC driver = Firefox() driver.get("http://www.baidu.com") wait = WebDriverWait(driver, timeout=10, poll_frequency=1, ignored_exceptions=[ElementNotVisibleException, ElementNotSelectableException]) element = wait.until(EC.element_to_be_clickable((By.XPATH, "//div"))) </syntaxhighlight> |} {{了解更多 |[https://www.selenium.dev/zh-cn/documentation/webdriver/waits/ selenium 文档:等待 ] }} ===显式等待=== <syntaxhighlight lang="python" > from selenium.webdriver.support.wait import WebDriverWait WebDriverWait(driver, timeout=10).until(lambda d: d.find_element(By.TAG_NAME,"p")) </syntaxhighlight> 每个语言的selenium都附带了一些常用的预期的条件,方便使用: * Python:https://www.selenium.dev/selenium/docs/api/py/webdriver_support/selenium.webdriver.support.expected_conditions.html {| class="wikitable" ! 名称 ! 描述 |- | invisibility_of_element_located() | 检查元素是否可见 |- | presence_of_element_located() | 检查元素是否存在 |- | | |- | | |} 示例: <syntaxhighlight lang="python" > from selenium import webdriver from selenium.webdriver.common.by import By from selenium.webdriver.common.keys import Keys from selenium.webdriver.support.ui import WebDriverWait import selenium.webdriver.support.expected_conditions as EC # Selenium WebDriver 3.13+ with webdriver.Firefox() as driver: wait = WebDriverWait(driver, 10) driver.get("https://www.baidu.com") driver.find_element(By.NAME, "wd").send_keys("hello world" + Keys.RETURN) first_result = wait.until(EC.presence_of_element_located((By.ID, "1"))) print(first_result.text) </syntaxhighlight> {{了解更多 |[https://www.selenium.dev/zh-cn/documentation/webdriver/waits/ selenium 文档:等待 ] |[https://www.selenium.dev/selenium/docs/api/py/webdriver_support/selenium.webdriver.support.expected_conditions.html selenium Python API:selenium.webdriver.support.expected_conditions] }} ==Selenium检测== ==扩展== {| class="wikitable" ! 名称 ! 描述 ! 网站 |- | Selenium Wire | 支持Python,可以访问或修改浏览器发出的底层请求。 <br />安装<code>pip install selenium-wire</code> | https://github.com/wkeeling/selenium-wire |- | | | |- | | | |} ==资源== ===官网=== *官网:https://www.selenium.dev *中文文档:https://www.selenium.dev/documentation/zh-cn/ *Github:https://github.com/SeleniumHQ/selenium *PyPI:https://pypi.python.org/pypi/selenium ===相关网站=== *[https://en.wikipedia.org/wiki/Selenium_(software) 维基百科:Selenium (software)] *[https://developer.mozilla.org/zh-CN/docs/Web/WebDriver MDN:WebDriver] *baijum/selenium python文档:https://selenium-python.readthedocs.io/index.html
本页使用的模板:
模板:了解更多
(
查看源代码
)
返回至“
Selenium (软件)
”。