39. 自动化异步测试开发之编写异步业务函数、测试函数和测试类（函数写法）

39. 自动化异步测试开发之编写异步业务函数、测试函数和测试类（函数写法）

一、异步业务函数解析

1.1 页面导航函数

async def get(async_driver, url: str = 'http://secure.smartbearsoftware.com/samples/testcomplete12/WebOrders/Login.aspx'):
    await async_driver.get(url)

• 功能：导航到指定URL
• 默认URL：Web Orders登录页面
• 执行效果：浏览器打开指定页面

1.2 登录功能函数

async def login(async_driver, username: str = 'Tester', password: str = 'test'):
    await async_driver.send_keys('id', 'ctl00_MainContent_username', text=username)
    await async_driver.send_keys('id', 'ctl00_MainContent_password', text=password)
    await async_driver.click('name', 'ctl00$MainContent$login_button')

• 操作步骤：
  1. 在用户名输入框输入用户名
  2. 在密码输入框输入密码
  3. 点击登录按钮
• 默认凭证：用户名’Tester’，密码’test’
• 元素定位：使用ID定位输入框，Name定位按钮

1.3 搜索功能函数

async def search(async_driver):
    await async_driver.click('xpath', '//*[@id="ctl00_menu"]/li[3]/a')  # 点击搜索菜单
    await async_driver.send_keys('id', 'ctl00_MainContent_fmwOrder_txtName')  # 输入搜索内容
    await async_driver.click('id', 'ctl00_MainContent_fmwOrder_InsertButton')  # 点击搜索按钮

• 操作流程：
  1. 点击菜单中的搜索选项
  2. 在搜索框输入内容
  3. 点击搜索按钮

1.4 登出功能函数

async def logout(async_driver):
    await async_driver.click('xpath', '//*[@id="ctl00_logout"]')  # 点击登出链接

• 功能：退出当前登录状态
• 定位方式：使用XPath定位登出链接

二、异步测试函数实现

2.1 登录功能测试

async def test_login(async_driver):
    await get(async_driver)  # 打开登录页面
    await login(async_driver)  # 执行登录操作
    
    # 验证登录成功
    title_text = await async_driver.text('xpath', '//*[@id="aspnetForm"]//td[1]/h1')
    assert title_text == 'Web Orders'
    
    await logout(async_driver)  # 退出登录

• 测试流程：
  1. 打开登录页
  2. 输入凭证登录
  3. 验证页面标题
  4. 登出系统
• 断言验证：检查登录后页面标题是否为’Web Orders’

2.2 搜索功能测试

async def test_search(async_driver):
    await get(async_driver)  # 打开登录页
    await login(async_driver)  # 登录系统
    await search(async_driver)  # 执行搜索操作
    
    # 验证错误提示
    error_msg = await async_driver.text('id', "ctl00_MainContent_fmwOrder_RequiredFieldValidator3")
    assert error_msg == "Field 'Street' cannot be empty."
    
    await logout(async_driver)  # 退出登录

• 测试流程：
  1. 登录系统
  2. 执行空搜索
  3. 验证错误提示
• 断言验证：检查是否显示’Street不能为空’的错误提示

三、完整测试执行流程

3.1 测试运行器实现

import asyncio
from chap9.async_browser import AsyncBrowser
from aiohttp import ClientSession

async def run_tests():
    async with ClientSession() as session:
        # 启动浏览器
        async with AsyncBrowser.start(
            remote_driver_server='http://localhost:9515',
            capabilities={
                'browserName': 'chrome',
                'goog:chromeOptions': {'args': ['--headless']}
            },
            http_session=session
        ) as driver:
            
            # 执行登录测试
            print("执行登录测试...")
            await test_login(driver)
            print("登录测试通过 ✓")
            
            # 执行搜索测试
            print("执行搜索测试...")
            await test_search(driver)
            print("搜索测试通过 ✓")

if __name__ == "__main__":
    asyncio.run(run_tests())

3.2 预期执行结果

执行登录测试...
登录测试通过 ✓
执行搜索测试...
搜索测试通过 ✓

3.3 实际页面操作流程

1. 打开登录页：http://secure.smartbearsoftware.com/...
2. 输入用户名：Tester
3. 输入密码：test
4. 点击登录按钮
5. 验证页面标题：Web Orders
6. 点击登出链接
7. 重新登录
8. 点击搜索菜单
9. 点击搜索按钮（不输入内容）
10. 验证错误提示：Field 'Street' cannot be empty.
11. 点击登出链接

四、设计优势分析

4.1 业务与测试分离

• 业务函数：封装页面操作逻辑（如login, search）
• 测试函数：组合业务函数并添加断言
• 分离好处：业务变更只需修改一处

4.2 异步执行优势

4.3 可重用性设计

# 在不同测试中重用业务函数
async def test_order(async_driver):
    await get(async_driver)
    await login(async_driver)
    # 添加订单测试代码
    await logout(async_driver)

五、最佳实践建议

1. 参数化默认值：

   async def login(async_driver, username: str = DEFAULT_USER, password: str = DEFAULT_PASS):
   

2. 元素定位器集中管理：

   USERNAME_FIELD = ('id', 'ctl00_MainContent_username')
   await async_driver.send_keys(*USERNAME_FIELD, text=username)
   

3. 添加操作等待：

   from selenium.webdriver.support.ui import WebDriverWait
   await WebDriverWait(async_driver, 10).until(element_visible(USERNAME_FIELD))
   

4. 错误处理增强：

   async def safe_login(async_driver):
       try:
           await login(async_driver)
       except LoginException:
           await handle_login_failure()
   

这种异步测试开发模式通过将业务操作、测试验证和测试执行分层设计，显著提高了测试代码的可维护性和执行效率。

六、完整代码

"""
Python :3.13.3
Selenium: 4.31.0

async_test_func.py
"""


async def get(async_driver,
              url: str = 'http://secure.smartbearsoftware.com/samples/testcomplete12/WebOrders/Login.aspx'):
    await async_driver.get(url)


async def login(async_driver, username: str = 'Tester', password: str = 'test'):
    await async_driver.send_keys('id', 'ctl00_MainContent_username', text=username)
    await async_driver.send_keys('id', 'ctl00_MainContent_password', text=password)
    await async_driver.click('name', 'ctl00$MainContent$login_button')


async def search(async_driver):
    await async_driver.click('xpath', '//*[@id="ctl00_menu"]/li[3]/a')
    await async_driver.send_keys('id', 'ctl00_MainContent_fmwOrder_txtName')
    await async_driver.click('id', 'ctl00_MainContent_fmwOrder_InsertButton')


async def logout(async_driver):
    await async_driver.click('xpath', '//*[@id="ctl00_logout"]')


async def test_login(async_driver):
    await get(async_driver)
    await login(async_driver)
    assert await async_driver.text('xpath', '//*[@id="aspnetForm"]//td[1]/h1') == 'Web Orders'
    await logout(async_driver)


async def test_search(async_driver):
    await get(async_driver)
    await login(async_driver)
    await search(async_driver)
    assert await async_driver.text('id',
                                   "ctl00_MainContent_fmwOrder_RequiredFieldValidator3") == "Field 'Street' cannot be empty."
    await logout(async_driver)

「小贴士」：点击头像→【关注】按钮，获取更多软件测试的晋升认知不迷路！ 🚀