使用Selenium Python API进行元素交互-优快云博客

本文链接：https://blog.youkuaiyun.com/csdn_te_blog_002/article/details/148290446

使用Selenium Python API进行元素交互

1. 引言

在现代Web应用程序中，自动化测试变得越来越重要。Selenium WebDriver作为一个强大的工具，可以帮助我们自动化与Web页面元素的交互。本篇文章将详细介绍如何使用Selenium WebDriver客户端库在Python中与不同类型的元素、JavaScript警报、框架和窗口进行交互。通过具体的实例和代码示例，帮助读者掌握这些技能。

2. HTML表单元素

HTML表单是Web应用程序中最常见的交互方式之一。表单通常包含文本框、复选框、单选按钮、提交按钮等输入元素。此外，表单还可以包含选择列表、文本区域、字段集、图例和标签元素。HTML表单被包含在<form>标签中，该标签指定了提交数据的方法（GET或POST）以及提交数据的目标地址。

2.1 表单元素的自动化

为了与HTML表单元素进行交互，Selenium WebDriver提供了多种方法。下面列出了一些常用的方法：

clear()：清除文本框或文本区域的内容。
click()：点击元素。
get_attribute(name)：获取元素的属性值。
send_keys(keys_to_send)：向文本框或文本区域发送文本。
submit()：提交表单。
value_of_css_property(property_name)：获取CSS属性的值。

示例代码

from selenium import webdriver
from selenium.webdriver.common.keys import Keys

# 创建一个新的Firefox会话
driver = webdriver.Firefox()
driver.implicitly_wait(30)
driver.maximize_window()

# 导航到应用程序主页
driver.get("http://demo.magentocommerce.com/")

# 获取搜索文本框
search_field = driver.find_element_by_name("q")
search_field.clear()

# 输入搜索关键词并提交
search_field.send_keys("phones")
search_field.submit()

# 获取所有显示在结果页面上的产品链接
products = driver.find_elements_by_xpath("//h2[@class='product-name']/a")

# 输出找到的产品数量
print(f"Found {len(products)} products:")

# 遍历每个产品链接并打印产品名称
for product in products:
    print(product.text)

# 关闭浏览器窗口
driver.quit()

3. WebDriver和WebElement类

3.1 WebDriver类

WebDriver类提供了多种属性和方法，用于与浏览器窗口、警告框、框架和弹出窗口进行交互。它还支持浏览器导航、访问Cookies、捕获屏幕截图等功能。以下是一些常用的属性和方法：

属性/方法	描述
`switch_to.window(window_name)`	切换到指定的窗口。
`implicitly_wait(time_to_wait)`	设置隐式等待时间。
`set_page_load_timeout(time_to_wait)`	设置页面加载超时时间。
`set_script_timeout(time_to_wait)`	设置异步脚本执行超时时间。

3.2 WebElement类

WebElement类提供了多种属性和方法，用于与网页上的元素进行交互。以下是一些常用的属性和方法：

属性/方法	描述
`size`	获取元素的大小。
`tag_name`	获取元素的HTML标签名。
`text`	获取元素的文本内容。
`clear()`	清除文本框或文本区域的内容。
`click()`	点击元素。
`get_attribute(name)`	获取元素的属性值。
`send_keys(keys_to_send)`	向文本框或文本区域发送文本。
`submit()`	提交表单。
`value_of_css_property(property_name)`	获取CSS属性的值。

示例代码

from selenium import webdriver

# 创建一个新的Firefox会话
driver = webdriver.Firefox()
driver.implicitly_wait(30)
driver.maximize_window()

# 导航到应用程序主页
driver.get("http://demo.magentocommerce.com/")

# 获取搜索文本框
search_field = driver.find_element_by_name("q")

# 输入搜索关键词并提交
search_field.send_keys("selenium webdriver")
search_field.submit()

# 获取搜索结果页面上的链接
se_wd_link = driver.find_element_by_link_text("Selenium WebDriver")
se_wd_link.click()

# 验证页面标题
self.assertEqual("Selenium WebDriver", driver.title)

# 浏览器导航
driver.back()
self.assertTrue(WebDriverWait(driver, 10).until(expected_conditions.title_is("selenium webdriver - Google Search")))
driver.forward()
self.assertTrue(WebDriverWait(driver, 10).until(expected_conditions.title_is("Selenium WebDriver")))
driver.refresh()
self.assertTrue(WebDriverWait(driver, 10).until(expected_conditions.title_is("Selenium WebDriver")))

# 关闭浏览器窗口
driver.quit()

4. 处理表单、文本框、复选框和单选按钮

使用WebElement类可以自动化各种HTML控件的交互，例如在文本框中输入文本、点击按钮、在复选框或单选按钮中选择选项、获取元素的文本和属性值等。

4.1 创建用户账户的测试

以下是一个示例，展示如何使用WebElement类及其属性和方法来自动化示例应用程序的创建账户功能。我们将创建一个测试，以验证在示例应用程序中创建一个新用户账户。

测试代码

from selenium import webdriver
import unittest

class RegisterNewUser(unittest.TestCase):
    def setUp(self):
        # 创建一个新的Firefox会话
        self.driver = webdriver.Firefox()
        self.driver.implicitly_wait(30)
        self.driver.maximize_window()

        # 导航到应用程序主页
        self.driver.get("http://demo.magentocommerce.com/")

    def test_register_new_user(self):
        driver = self.driver

        # 点击登录链接以打开登录页面
        driver.find_element_by_link_text("Log In").click()

        # 检查创建账户按钮是否可见且启用
        create_account_button = driver.find_element_by_xpath("//button[@title='Create an Account']")
        self.assertTrue(create_account_button.is_displayed())
        self.assertTrue(create_account_button.is_enabled())

        # 点击创建账户按钮
        create_account_button.click()

        # 填写表单
        first_name = driver.find_element_by_name("firstname")
        last_name = driver.find_element_by_name("lastname")
        email = driver.find_element_by_name("email")
        password = driver.find_element_by_name("password")
        confirm_password = driver.find_element_by_name("confirmation")
        newsletter_checkbox = driver.find_element_by_name("is_subscribed")

        first_name.send_keys("John")
        last_name.send_keys("Doe")
        email.send_keys("johndoe@example.com")
        password.send_keys("password123")
        confirm_password.send_keys("password123")
        newsletter_checkbox.click()

        # 提交表单
        register_button = driver.find_element_by_xpath("//button[@title='Register']")
        register_button.click()

    def tearDown(self):
        # 关闭浏览器窗口
        self.driver.quit()

if __name__ == '__main__':
    unittest.main()

5. 处理下拉菜单和列表

Select类用于自动化下拉菜单和列表的选择操作。它提供了多种方法来选择选项，例如通过索引、可见文本或值。

5.1 使用Select类

以下是一个示例，展示如何使用Select类来选择下拉菜单中的选项。

示例代码

from selenium import webdriver
from selenium.webdriver.support.ui import Select

# 创建一个新的Firefox会话
driver = webdriver.Firefox()
driver.implicitly_wait(30)
driver.maximize_window()

# 导航到应用程序主页
driver.get("http://demo.magentocommerce.com/")

# 获取语言选择下拉菜单
select_language = Select(driver.find_element_by_id("select-language"))

# 检查默认选中的选项是否为英文
self.assertEqual("ENGLISH", select_language.first_selected_option.text)

# 选择法语选项
select_language.select_by_visible_text("French")

# 验证选择的选项是否为法语
store_cookie = driver.get_cookie("store")['value']
self.assertEqual("french", store_cookie)

# 关闭浏览器窗口
driver.quit()

6. 处理JavaScript警报和弹出窗口

Selenium WebDriver提供了Alert类来处理JavaScript警报和弹出窗口。Alert类提供了多种方法来处理警报，例如接受、取消和发送文本。

6.1 使用Alert类

以下是一个示例，展示如何使用Alert类来处理JavaScript警报。

示例代码

from selenium import webdriver

# 创建一个新的Firefox会话
driver = webdriver.Firefox()
driver.implicitly_wait(30)
driver.maximize_window()

# 导航到应用程序主页
driver.get("http://demo.magentocommerce.com/")

# 触发JavaScript警报
driver.execute_script("alert('This is a JavaScript alert');")

# 切换到警报并处理
alert = driver.switch_to.alert
self.assertEqual("This is a JavaScript alert", alert.text)
alert.accept()

# 关闭浏览器窗口
driver.quit()

以上内容介绍了如何使用Selenium WebDriver客户端库在Python中与不同类型的元素、JavaScript警报、框架和窗口进行交互。通过详细的解释和实例，帮助读者掌握这些技能。接下来的部分将继续探讨更多高级功能，如自动化浏览器导航和处理复杂的用户交互。

7. 自动化浏览器导航

浏览器导航是指在Web应用程序中前进、后退、刷新页面等操作。Selenium WebDriver提供了多种方法来实现这些操作。以下是常用的浏览器导航方法：

back()：返回到上一个页面。
forward()：前进到下一个页面。
refresh()：刷新当前页面。

7.1 示例代码

from selenium import webdriver

# 创建一个新的Firefox会话
driver = webdriver.Firefox()
driver.implicitly_wait(30)
driver.maximize_window()

# 导航到应用程序主页
driver.get("http://demo.magentocommerce.com/")

# 触发搜索操作
search_field = driver.find_element_by_name("q")
search_field.send_keys("selenium webdriver")
search_field.submit()

# 浏览器导航
driver.back()
self.assertTrue(WebDriverWait(driver, 10).until(expected_conditions.title_is("selenium webdriver - Google Search")))
driver.forward()
self.assertTrue(WebDriverWait(driver, 10).until(expected_conditions.title_is("Selenium WebDriver")))
driver.refresh()
self.assertTrue(WebDriverWait(driver, 10).until(expected_conditions.title_is("Selenium WebDriver")))

# 关闭浏览器窗口
driver.quit()

8. 处理复杂的用户交互

在实际的Web应用程序中，用户交互可能涉及多个步骤和复杂的操作。为了模拟这些交互，Selenium WebDriver提供了多种方法来处理复杂的用户操作，例如拖放、双击、右键点击等。

8.1 使用ActionChains类

ActionChains类用于模拟复杂的用户交互。它提供了多种方法来执行链式操作，例如点击、双击、拖放等。

示例代码

from selenium import webdriver
from selenium.webdriver.common.action_chains import ActionChains

# 创建一个新的Firefox会话
driver = webdriver.Firefox()
driver.implicitly_wait(30)
driver.maximize_window()

# 导航到应用程序主页
driver.get("http://demo.magentocommerce.com/")

# 获取可拖动元素和目标位置
source_element = driver.find_element_by_id("draggable")
target_element = driver.find_element_by_id("droppable")

# 创建ActionChains对象并执行拖放操作
actions = ActionChains(driver)
actions.drag_and_drop(source_element, target_element).perform()

# 关闭浏览器窗口
driver.quit()

通过上述内容，我们已经掌握了如何使用Selenium WebDriver客户端库在Python中与不同类型的元素、JavaScript警报、框架和窗口进行交互。接下来的部分将继续探讨更多高级功能，如自动化浏览器导航和处理复杂的用户交互。

9. mermaid格式流程图

以上内容详细介绍了如何使用Selenium WebDriver客户端库在Python中与不同类型的元素、JavaScript警报、框架和窗口进行交互。通过具体的实例和代码示例，帮助读者掌握这些技能。接下来的部分将继续探讨更多高级功能，如自动化浏览器导航和处理复杂的用户交互。

10. 处理框架和窗口

在Web应用程序中，框架（iframe）和多个窗口的处理是常见的需求。Selenium WebDriver提供了简单的方法来切换到不同的框架和窗口，确保测试可以覆盖所有场景。

10.1 切换框架

框架通常用于在同一个页面中嵌入多个HTML文档。为了与框架内的元素交互，必须先切换到该框架。

示例代码

from selenium import webdriver

# 创建一个新的Firefox会话
driver = webdriver.Firefox()
driver.implicitly_wait(30)
driver.maximize_window()

# 导航到包含框架的页面
driver.get("http://example.com/page-with-iframes.html")

# 切换到框架
driver.switch_to.frame("frame-name-or-id")

# 在框架内查找元素并进行交互
element_in_frame = driver.find_element_by_id("element-inside-frame")
element_in_frame.click()

# 返回主文档
driver.switch_to.default_content()

# 关闭浏览器窗口
driver.quit()

10.2 切换窗口

在某些情况下，Web应用程序可能会打开新的浏览器窗口。为了与新窗口中的元素交互，必须先切换到该窗口。

示例代码

from selenium import webdriver

# 创建一个新的Firefox会话
driver = webdriver.Firefox()
driver.implicitly_wait(30)
driver.maximize_window()

# 导航到主页
driver.get("http://example.com")

# 获取当前窗口句柄
original_window_handle = driver.current_window_handle

# 打开新窗口
driver.find_element_by_link_text("Open New Window").click()

# 获取所有窗口句柄
all_window_handles = driver.window_handles

# 切换到新窗口
for handle in all_window_handles:
    if handle != original_window_handle:
        driver.switch_to.window(handle)
        break

# 在新窗口中进行交互
new_window_element = driver.find_element_by_id("element-in-new-window")
new_window_element.click()

# 切换回原始窗口
driver.switch_to.window(original_window_handle)

# 关闭浏览器窗口
driver.quit()

11. 检查元素状态

在自动化测试中，检查元素的状态是非常重要的。Selenium WebDriver提供了多种方法来检查元素是否可见、启用、选中等。

11.1 检查元素是否可见

使用is_displayed()方法可以检查元素是否在屏幕上可见。

示例代码

from selenium import webdriver

# 创建一个新的Firefox会话
driver = webdriver.Firefox()
driver.implicitly_wait(30)
driver.maximize_window()

# 导航到主页
driver.get("http://example.com")

# 检查元素是否可见
element = driver.find_element_by_id("element-id")
is_visible = element.is_displayed()
print(f"Element visibility: {is_visible}")

# 关闭浏览器窗口
driver.quit()

11.2 检查元素是否启用

使用is_enabled()方法可以检查元素是否启用，即用户是否可以与其交互。

示例代码

from selenium import webdriver

# 创建一个新的Firefox会话
driver = webdriver.Firefox()
driver.implicitly_wait(30)
driver.maximize_window()

# 导航到主页
driver.get("http://example.com")

# 检查元素是否启用
element = driver.find_element_by_id("element-id")
is_enabled = element.is_enabled()
print(f"Element enabled: {is_enabled}")

# 关闭浏览器窗口
driver.quit()

11.3 检查复选框或单选按钮是否选中

使用is_selected()方法可以检查复选框或单选按钮是否被选中。

示例代码

from selenium import webdriver

# 创建一个新的Firefox会话
driver = webdriver.Firefox()
driver.implicitly_wait(30)
driver.maximize_window()

# 导航到主页
driver.get("http://example.com")

# 检查复选框是否选中
checkbox = driver.find_element_by_id("checkbox-id")
is_selected = checkbox.is_selected()
print(f"Checkbox selected: {is_selected}")

# 关闭浏览器窗口
driver.quit()

12. mermaid格式流程图

13. 获取元素属性和文本

在自动化测试中，获取元素的属性和文本内容是非常常见的需求。Selenium WebDriver提供了多种方法来获取这些信息。

13.1 获取元素属性

使用get_attribute()方法可以获取元素的特定属性值。

示例代码

from selenium import webdriver

# 创建一个新的Firefox会话
driver = webdriver.Firefox()
driver.implicitly_wait(30)
driver.maximize_window()

# 导航到主页
driver.get("http://example.com")

# 获取元素属性
element = driver.find_element_by_id("element-id")
attribute_value = element.get_attribute("attribute-name")
print(f"Attribute value: {attribute_value}")

# 关闭浏览器窗口
driver.quit()

13.2 获取元素文本

使用text属性可以获取元素的文本内容。

示例代码

from selenium import webdriver

# 创建一个新的Firefox会话
driver = webdriver.Firefox()
driver.implicitly_wait(30)
driver.maximize_window()

# 导航到主页
driver.get("http://example.com")

# 获取元素文本
element = driver.find_element_by_id("element-id")
element_text = element.text
print(f"Element text: {element_text}")

# 关闭浏览器窗口
driver.quit()

14. 获取CSS属性

有时需要获取元素的CSS属性值，例如颜色、字体大小等。Selenium WebDriver提供了value_of_css_property()方法来实现这一点。

14.1 获取CSS属性

示例代码

from selenium import webdriver

# 创建一个新的Firefox会话
driver = webdriver.Firefox()
driver.implicitly_wait(30)
driver.maximize_window()

# 导航到主页
driver.get("http://example.com")

# 获取CSS属性
element = driver.find_element_by_id("element-id")
css_property_value = element.value_of_css_property("css-property-name")
print(f"CSS property value: {css_property_value}")

# 关闭浏览器窗口
driver.quit()

15. 小结

通过上述内容，我们已经详细介绍了如何使用Selenium WebDriver客户端库在Python中与不同类型的元素、JavaScript警报、框架和窗口进行交互。我们学习了如何执行向元素发送值、执行点击和从下拉列表中选择选项等操作，如何处理框架、不同类型JavaScript警报以及在子浏览器窗口之间切换，如何检查元素是否显示及启用状态，获取元素属性值，使用is_selected()方法，以及使用clear()和send_keys()方法。此外，我们还探讨了如何工作于下拉菜单和列表，理解Select类及其属性和方法，处理警告和弹出窗口，理解Alert类及其属性和方法，自动化浏览器导航，处理复杂的用户交互，检查元素状态，获取元素属性和文本，以及获取CSS属性。

希望这些内容能够帮助读者更好地理解和掌握Selenium WebDriver在Python中的应用，从而实现Web页面的自动化测试。通过不断的实践和探索，读者可以进一步提升自己的自动化测试技能，为Web应用程序的开发和测试带来更高的效率和可靠性。