【Python+Appium】开展自动化测试（六）元素等待方法与重新封装元素定位方法

水深无声 2023-10-07 21:34 44阅读 0赞

**目录**

前言

一，元素等待方法

1，强制等待

2，隐式等待

3，显式等待

二，重新封装元素定位方法

结语

--------------------

### 前言 ###

在appium自动化测试脚本运行的过程中，因为网络不稳定、测试机或模拟器卡顿等原因，有时候会出现页面元素加载超时元素定位失败的情况，但实际这又不是bug，只是元素加载较慢，这个时候我们就会使用元素等待的方法来避免这种情况，增加代码的健壮性。

![06543958debd4039b518f3bbb08ad7d0.jpeg][]

### 一，元素等待方法 ###

#### 1，强制等待 ####

import time
    
    # 强制等待5s
    time.sleep(5)

#### 2，隐式等待 ####

implicitly\_wait()是由webdriver提供的隐式等待方法，它不是针对某一个元素，而是针对当前session（即当前driver对象的生命周期）的全部元素，所以只需要在构造driver对象时设置一次即可。隐式等待在定位元素时，需等待该页面全部元素加载完成，才会执行下一步操作（即下一条语句），如果超过设定时间未加载完成则抛出异常。

from appium import webdriver
    
    def android_driver():
        desired_caps = {
            "platformName": "Android",
            "platformVersion": "10",
            "deviceName": "PCT_AL10",
            "appPackage": "com.ss.android.article.news",
            "appActivity": ".activity.MainActivity",
            "automationName": "uiautomator2",
            "unicodeKeyboard": True,
            "resetKeyboard": True,
        }
        # 启动app
        driver = webdriver.Remote('http://127.0.0.1:4723/wd/hub', desired_caps)
        # 隐式等待8s
        driver.implicitly_wait(8)
        return driver

#### 3，显式等待 ####

3.1，webDriverWait()是由webdriver提供的显示等待方法。与隐式等待不一样的是，显示等待是针对单个元素定位进行等待，每隔一段时间检查需要定位的元素是否加载完成，超过参数规定的时间仍未定位到该元素，则定位该元素失败，抛出异常。

from selenium.webdriver.support.ui import WebDriverWait
    
    WebDriverWait(driver,timeout,poll_frequency=0.5,ignored_exceptions=None)
    # 参数说明：
    # driver，上面代码返回的driver对象
    # timeout，最长等待时间，使用时要考虑隐式等待的时间（假如有设置隐式等待的话）
    # poll_frequency，检查元素的时间间隔，默认是0.5s即每隔0.5秒查找一次
    # ignored_exceptions，超时后抛出的异常信息，默认NoSuchElementExeception

3.2，WedDriverWait()需要与unit()或until\_not()方法结合使用。

until(method, message='')
    # 源码说明：Calls the method provided with the driver as an argument until the return value is not False.
    # 调用driver提供的方法作为参数，直到返回值不是False。
    
    until_not(method, message='')
    # 源码说明：Calls the method provided with the driver as an argument until the return value is False.
    # 调用driver提供的方法作为参数，直到返回值为False

自定义等待时间，使用find\_element\_by\_\*()方法定位元素，如下：

# 设置等待，最长等待时间为5s，每0.5秒检查一次
    wait = WebDriverWait(driver, 5, 0.5)
    # 使用匿名函数定位元素
    wait.until(lambda diver:driver.find_element_by_id("android:id/button1"))

3.3，WebDriverWait()与expected\_conditions结合使用。

expected\_conditions是webdriver.support提供的一个类，这个类里面提供了比较多的预期条件判断的方法，但在我们定位元素过程中常用以下三种方法

<table> 
 <thead> 
  <tr> 
   <th>presence_of_element_located</th> 
   <th>判断某个元素是否被加载到 dom 树里，但该元素不一定可见</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>visibility_of_element_located</td> 
   <td>判断元素是否可见（可见代表元素非隐藏，并且元素宽和高都不等于 0）</td> 
  </tr> 
  <tr> 
   <td>element_to_be_clickable</td> 
   <td>判断某个元素中是否可见并且可点击</td> 
  </tr> 
 </tbody> 
</table>

from selenium.webdriver.support import expected_conditions as EC
    from selenium.webdriver.common.by import By
    
    wait = WebDriverWait(driver, 5, 0.5)
    element = waite.until(EC.presence_of_element_located((By.ID, "android:id/button1"), message="")
    # message=""可以省略，注意此时By.ID有两层（）
    # element = waite.until(EC.presence_of_element_located((By.ID, "android:id/button1"))

### 二，重新封装元素定位方法 ###

在脚本编写的过程中，为了增加脚本的健壮性，排除非bug因素导致的脚本运行失败，我们可以在定位元素时加入显示等待，封装成新的元素定位方法。

# /basePage.py
    
    from selenium.webdriver.support import expected_conditions as ec
    from selenium.webdriver.support.ui import WebDriverWait
    from appium.webdriver.common.mobileby import MobileBy as By
    
    class BasePage:
        def __init__(self, driver):
            self.driver = driver
    
        def get_visible_element(self, locator, timeout=20):
            '''
            获取可视元素
            param loctor: By方法定位元素，如(By.XPATH, "//*[@text='照片']")
            return：返回可见元素
            '''
            try:
                return WebDriverWait(self.driver, timeout).until(
                    ec.visibility_of_element_located(locator)
                )
            except Exception as e:
                # 截图、日志
                Screenshots(self.driver, "获取可视元素失败").screen_shot()
                log.error("获取可视元素失败：{}".format(e))
    
        def get_presence_element(self, locator, timeout=20):
            '''获取存在元素'''
            try:
                return WebDriverWait(self.driver, timeout).until(
                    ec.presence_of_element_located(locator)
                )
            except Exception as e:
                Screenshots(self.driver, "获取存在元素失败").screen_shot()
                log.error("获取存在元素失败：{}".format(e))
    
        def get_clickable_element(self, locator, timeout=20):
            '''获取可点击元素'''
            try:
                return WebDriverWait(self.driver, timeout).until(
                    ec.element_to_be_clickable(locator)
                )
            except Exception as e:
                Screenshots(self.driver, "获取可点击元素失败").screen_shot()
                log.error("可点击元素获取失败：{}".format(e))

这样就可以调用新的方法来进行元素定位

# /homePage.py
    
    from basePage import BasePage
    
    class HomePage(BasePage):
        i_know_btn = (By.ID, 'com.ss.android.article.news:id/ciy')
        jurisdiction_btn = (By.ID, 'android:id/button1')
        no_login_btn = (By.XPATH, '//android.widget.TabWidget/android.widget.RelativeLayout[@index=3]')
    
        def enter_to_login_page(self):
            '''首页进入未登录页面'''
            get_visible_element(self.i_know_btn).click()
            get_presence_element(self.jurisdiction_btn).click()
            get_clickable_element(self.no_login_btn).click()

### 结语 ###

这篇贴子到这里就结束了，最后，希望看这篇帖子的朋友能够有所收获。

**有什么不懂或是不理解的地方欢迎在评论区和我互动交流，也可以私❤我【appium】咨询**

如果你觉得文章还不错，请大家 **点赞、分享、留言** 下，因为这将是我持续输出更多优质文章的最强动力！

[06543958debd4039b518f3bbb08ad7d0.jpeg]: https://img-blog.csdnimg.cn/06543958debd4039b518f3bbb08ad7d0.jpeg