自学Python第十八天-自动化测试框架(二):DrissionPage、appium

自学Python第十八天-自动化测试框架(二):DrissionPage、appium

  • DrissionPage
    • 环境和安装配置
    • 准备工作
    • 简单的使用示例
      • 控制浏览器
      • 收发数据包
      • 模式切换
    • 浏览器模式
      • 创建浏览器对象
      • 访问页面
        • 加载模式
          • none 模式技巧
      • 获取页面信息
      • 页面交互
      • 查找元素
        • `ele()` 和 `eles()`
        • `parent()` 、`child()` 和 `children()`
        • `next()`、`nexts()` 和 `prev()`、`prevs()`
        • `after()`、`afters()` 和 `before()`、`befores()`
        • 匹配模式
        • 查找语法
        • 处理 frame
        • 简化写法
      • 获取元素信息
      • 元素交互
  • appium

DrissionPage

由于 selenium 的缺点过多,pyppeteer 使用较为复杂,也可以使用 DrissionPage 库来进行自动化测试。

DrissionPage 官方文档

DrissionPage 的优点有:

  • 极简的语法规则,定位元素更加容易
  • 无处不在的等待和自动重试功能,使得容错能力大大增加
  • 允许反复使用已经打开的浏览器,方便调试
  • 把 iframe 看作普通元素,无需切入切出,可以直接查找内容
  • 良好的异步支持

环境和安装配置

DrissionPage需要的环境为:

  • 操作系统:Windows、Linux 或 Mac。
  • python 版本:3.6 及以上
  • 支持浏览器:Chromium 内核(如 Chrome 和 Edge)

使用 pip 安装 DrissionPage:
pip install DrissionPage

DrissionPage 包含三种主要页面类。根据需要在其中选择使用。

  • 如果只要控制浏览器,导入ChromiumPagefrom DrissionPage import ChromiumPage
  • 如果只要收发数据包,导入SessionPagefrom DrissionPage import SessionPage
  • WebPage是功能最全面的页面类,既可控制浏览器,也可收发数据包。from DrissionPage import WebPage

另外 DrissionPage 还有一些配置工具类

类名描述引入方式
ChromiumOptions用于设置浏览器启动参数。这些参数只有在启动浏览器时有用,接管已存在的浏览器时是不生效的。from DrissionPage import ChromiumOptions
SessionOptions用于配置SessionPage或WebPages 模式的连接参数。from DrissionPage import SessionOptions
Settings用于设置全局运行配置,如找不到元素时是否抛出异常等。from DrissionPage.common import Settings
Keys键盘按键类,用于键入 ctrl、alt 等按键。from DrissionPage.common import Keys
Actions动作链,用于执行一系列动作。在浏览器页面对象中已有内置,无如特殊需要无需主动导入。from DrissionPage.common import Actions
By与 selenium 一致的By类,便于项目迁移。from DrissionPage.common import By
wait_until可等待传入的方法结果为真from DrissionPage.common import wait_until
make_session_ele从 html 文本生成ChromiumElement对象from DrissionPage.common import make_session_ele
configs_to_here把配置文件复制到当前路径from DrissionPage.common import configs_to_here
get_blob获取指定的 blob 资源from DrissionPage.common import get_blob
ElementNotFoundError异常类,全部在路径DrissionPage.errorsfrom DrissionPage.errors import ElementNotFoundError

另外 DrissionPage 还有一些衍生对象,例如 TabElement 等对象是由 Page 对象生成的,开发过程中需要类型判断时需要导入这些类型。

from DrissionPage.items import SessionElement
from DrissionPage.items import ChromiumElement
from DrissionPage.items import ShadowRoot
from DrissionPage.items import NoneElement
from DrissionPage.items import ChromiumTab
from DrissionPage.items import WebPageTab
from DrissionPage.items import ChromiumFrame

准备工作

如果只使用收发数据包功能,无需任何准备工作。

如果要控制浏览器,需设置浏览器路径。程序默认设置控制 Chrome,所以下面用 Chrome 演示。如果要使用 Edge 或其它 Chromium 内核浏览器,设置方法是一样的。

  1. 尝试启动浏览器
    默认状态下,程序会自动在系统内查找 Chrome 路径。执行以下代码,浏览器启动并且访问了项目文档,说明可直接使用,跳过后面的步骤即可。
from DrissionPage import ChromiumPagepage = ChromiumPage()
page.get('http://g1879.gitee.io/DrissionPageDocs')
  1. 设置路径
    如果上面的步骤提示出错,说明程序没在系统里找到 Chrome 浏览器。可用以下其中一种方法设置,设置会持久化记录到默认配置文件,之后程序会使用该设置启动。
    查找浏览器路径
    设置方法有2种:

方法一:新建一个临时 py 文件,并输入以下代码,填入您电脑里的 Chrome 浏览器可执行文件路径,然后运行。

from DrissionPage import ChromiumOptionspath = r'D:\Chrome\Chrome.exe'  # 请改为你电脑内Chrome可执行文件路径
ChromiumOptions().set_browser_path(path).save()

这段代码会把浏览器路径记录到配置文件,今后启动浏览器皆以新路径为准。另外,如果是想临时切换浏览器路径以尝试运行和操作是否正常,可以去掉 .save(),以如下方式结合第1️⃣步的代码。

from DrissionPage import ChromiumPage, ChromiumOptionspath = r'D:\Chrome\Chrome.exe'  # 请改为你电脑内Chrome可执行文件路径
co = ChromiumOptions().set_browser_path(path)
page = ChromiumPage(co)
page.get('http://g1879.gitee.io/DrissionPageDocs')

方法二:在命令行输入以下命令(路径改成自己电脑里的):
dp -p D:\Chrome\chrome.exe 注意要先使用 cd 命令定位到项目路径

简单的使用示例

DrissionPage 的三个主要的类 ChromiumPageSessionPageWebPage 分别用于主要的三种模式:浏览器模式、数据包模式、混合模式。

控制浏览器

DrissionPage 可以类似于 selenium 一样直接控制浏览器。

from DrissionPage import ChromiumPage# 创建页面对象,并启动或接管浏览器
page = ChromiumPage()
# 跳转到登录页面
page.get('https://gitee.com/login')
# 定位到账号文本框,获取文本框元素
ele = page.ele('#user_login')
# 输入对文本框输入账号
ele.input('您的账号')
# 定位到密码文本框并输入密码
page.ele('#user_password').input('您的密码')
# 点击登录按钮
page.ele('@value=登 录').click()

收发数据包

DrissionPage 可以类似于 requests 一样直接收发数据包获取页面代码,并使用特定的解析语法解析文本获取数据。

from DrissionPage import SessionPage# 创建页面对象
page = SessionPage()# 爬取3页
for i in range(1, 4):# 访问某一页的网页page.get(f'https://gitee.com/explore/all?page={i}')# 获取所有开源库<a>元素列表links = page.eles('.title project-namespace-path')# 遍历所有<a>元素for link in links:# 打印链接信息print(link.text, link.link)

模式切换

DrissionPage 还能在两种模式间切换执行。切换模式是用来应付登录检查很严格的网站,可以用浏览器处理登录,再转换模式用收发数据包的形式来采集数据。

from DrissionPage import WebPage# 创建页面对象
page = WebPage()
# 访问网址
page.get('https://gitee.com/explore')
# 查找文本框元素并输入关键词
page('#q').input('DrissionPage')
# 点击搜索按钮
page('t:button@tx():搜索').click()
# 等待页面加载
page.wait.load_start()
# 切换到收发数据包模式
page.change_mode()
# 获取所有行元素
items = page('#hits-list').eles('.item')
# 遍历获取到的元素
for item in items:# 打印元素文本print(item('.title').text)print(item('.desc').text)print()

浏览器模式

ChromiumPage()创建页面对象。根据不同的配置,可以接管已打开的浏览器,也可以启动新的浏览器。程序结束时,被打开的浏览器不会主动关闭,以便下次运行程序时使用(由VSCode启动的会被关闭)。新手在使用无头模式时需注意,程序关闭后其实浏览器进程还在,只是看不见。

ChromiumPageWebPage对象为单例,每个浏览器只能有一个该对象。对同一个浏览器重复使用ChromiumPage获取的都是同一个对象。

创建浏览器对象

from DrissionPage import ChromiumPagepage = ChromiumPage()

创建ChromiumPage对象时会在指定端口启动浏览器,或接管该端口已有浏览器。默认情况下,程序使用 9222 端口,浏览器可执行文件路径为’chrome’。如路径中没找到浏览器可执行文件,Windows 系统下程序会在注册表中查找路径。
ChromiumPage创建时可接收三个参数:

初始化参数类型默认值说明
addr_or_optsstr int ChromiumOptionsNone浏览器启动配置或接管信息。传入 ‘ip: port’ 字符串、端口数字或ChromiumOptions对象时按配置启动或接管浏览器;为None时使用配置文件配置启动浏览器
tab_idstrNone要控制的标签页 id,为None则控制激活的标签页
timeoutfloatNone整体超时时间,为None则从配置文件中读取,默认10

如果需要已指定方式启动浏览器,可使用ChromiumOptions。它是专门用于设置浏览器初始状态的类,内置了常用的配置。

# 导入 ChromiumOptions
from DrissionPage import ChromiumPage, ChromiumOptions# 创建浏览器配置对象,指定浏览器路径
co = ChromiumOptions().set_browser_path(r'D:\chrome.exe')
# 设置不加载图片、静音、禁用js
co.no_imgs(True).mute(True)no_js(True)
co.incognito()  # 匿名模式(无痕模式)
co.headless()  # 无头模式
# 另外也支持 Chromium 内核浏览器的一系列启动配置参数
co.set_argument('--no-sandbox')  # 无沙盒模式
co.set_argument('--window-size', '800,600')		# 设置初始窗口大小
co.set_argument('--start-maximized')	# 设置启动时最大化
co.set_argument('--guest')	# 使用来宾模式打开浏览器
# 已经配置的参数也可以删除
co.remove_argument('--start-maximized')
co.remove_argument('--window-size')
# 用该配置创建页面对象
page = ChromiumPage(addr_or_opts=co)

访问页面

get() 方法用于跳转到一个网址,

from DrissionPage import ChromiumPagepage = ChromiumPage()
page.get('https://www.baidu.com')

该方法可以接收5个参数,并返回一个 bool 值,表示是否连接成功

参数名称类型默认值说明
urlstr必填目标 url,可指向本地文件路径
show_errmsgboolFalse连接出错时是否显示和抛出异常
retryintNone重试次数,为None时使用页面参数,默认 3
intervalfloatNone重试间隔(秒),为None时使用页面参数,默认 2
timeoutfloatNone加载超时时间(秒)
加载模式

加载模式是指程序在页面加载阶段的行为模式,有以下三种:

  • normal():常规模式,会等待页面加载完毕,超时自动重试或停止,默认使用此模式
  • eager():加载完 DOM 或超时即停止加载,不加载页面资源
  • none():超时也不会自动停止,除非加载完成

前两种模式下,页面加载过程会阻塞程序,直到加载完毕才执行后面的操作。none()模式下,只在连接阶段阻塞程序,加载阶段可自行根据情况执行stop_loading()停止加载。这样提供给用户非常大的自由度,可等到关键数据包或元素出现就主动停止页面加载,大幅提升执行效率。

可以在配置对象中进行设置:

from DrissionPage import ChromiumOptions, ChromiumPageco = ChromiumOptions().set_load_mode('none')
page = ChromiumPage(co)

也可以在运行中设置

from DrissionPage import ChromiumPagepage = ChromiumPage()
page.set.load_mode.eager()
page.get('https://g1879.gitee.io/drissionpagedocs')
none 模式技巧
  • 跟监听器配合,可在获取到需要的数据包时,主动停止加载。
from DrissionPage import ChromiumPagepage = ChromiumPage()
page.set.load_mode.none()  # 设置加载模式为nonepage.listen.start('api/getkeydata')  # 指定监听目标并启动监听
page.get('http://www.hao123.com/')  # 访问网站
packet = page.listen.wait()  # 等待数据包
page.stop_loading()  # 主动停止加载
print(packet.response.body)  # 打印数据包正文
  • 跟元素查找配合,可在获取到某个指定元素时,主动停止加载。
from DrissionPage import ChromiumPagepage = ChromiumPage()
page.set.load_mode.none()  # 设置加载模式为nonepage.get('http://www.hao123.com/')  # 访问网站
ele = page.ele('中国日报')  # 查找text包含“中国日报”的元素
page.stop_loading()  # 主动停止加载
print(ele.text)  # 打印元素text
  • 可等待到页面到达某种状态时,主动停止加载。比如多级跳转的登录,可等待 title 变化到最终目标网址时停止。
from DrissionPage import ChromiumPagepage = ChromiumPage()
page.set.load_mode.none()  # 设置加载模式为nonepage.get('http://www.hao123.com/')  # 访问网站
page.wait.title_change('hao123')  # 等待title变化出现目标文本
page.stop_loading()  # 主动停止加载

获取页面信息

有一些常用的属性和方法能够获取页面的信息

  • html
    此属性返回当前页面 html 文本。返回类型:str
  • json
    此属性把请求内容解析成 json,并把这些数据转换为dict格式。需注意如果是API返回的json字符串,请使用 SessionPage 对象而不是 ChromiumPage
  • title
    此属性返回当前页面title文本。返回类型:str
  • user_agent
    此属性返回当前页面 user agent 信息。返回类型:str
  • save(path:Union[str,Path]=None, name:str=None, as_pdf:bool=False,**kwargs)->Union[str, bytes]
    当前页面保存为文件,同时返回保存的内容。接收 pathnameas_pdf 三个参数。如果pathname参数都为None,只返回内容,不保存文件。path为None保存到当前路径,name为None则使用 title 的值。as_pdfTrue保存为pdf文件,默认False保存为 mhtml。另外如果 as_pdfTrue返回值为文件字节数据。
  • url
    此属性返回当前访问的 url。返回类型:str
  • tab_id
    此属性返回当前标签页的 id。返回类型:str
  • states.is_loading
    此属性返回页面是否正在加载状态。返回类型:bool
  • states.is_alive
    此属性返回页面是否仍然可用,标签页已关闭则返回False
  • states.ready_state
    此属性返回页面当前加载状态,有 4 种:'connecting': 网页连接中,'loading':表示文档还在加载中,'interactive':DOM 已加载,但资源未加载完成,'complete':所有内容已完成加载。
  • states.has_alert
    此属性以布尔值返回页面是否存在弹出框。
  • cookies(as_dict:bool=False, all_domains:bool=False, all_info:bool=False)->Union[dict, list]
    此方法返回 cookies 信息。接收3个参数,默认均为Falseas_dictTrue时返回字典类型,为False返回 cookie 组成的列表;all_domains是否返回所有 cookies,为False只返回当前 url 的;all_info返回的 cookies 是否包含所有信息,False时只包含namevaluedomain信息
  • session_storage(item:str=None)->Union[dict, str]
    此方法用于获取 sessionStorage 信息,可获取全部或单个项。该方法接收一个默认为 None 的 str 型参数,是要获取的项目名称,为None则返回全部项目组成的字典。
  • local_storage(item:str=None)->Union[dict, str]
    此方法用于获取 localStorage 信息,可获取全部或单个项。参数和使用同 session_storage()

页面交互

一个 Tab 对象(ChromiumTabWebPageTab)控制一个浏览器的标签页,是页面控制的主要单位。ChromiumPageWebPage也控制一个标签页,只是它们增加了一些浏览器总体控制功能。

  • get(url:str, show_errmsg:bool=False, retry:int=None, interval:float=None, timeout:float=None)->bool
    该方法用于跳转到一个网址。当连接失败时,程序会进行重试。
  • back(steps:int=1)
    此方法用于在浏览历史中后退若干步。可以接收1个类型为 int 的参数,默认值为1,为后退步数。
  • forward(steps:int=1)
    此方法用于在浏览历史中前进若干步。参数和用法同 back()
  • refresh()
    此方法用于刷新当前页面,可以接收一个默认值为 False 的 bool 参数,刷新时是否忽略缓存。
  • stop_loading()
    此方法用于强制停止当前页面加载。
  • set.blocked_urls(urls:Union[str, list, tuple, None])
    此方法用于设置忽略的连接,接收一个必填的参数,类型可以为 str、list、tuple、None,需要忽略的 url,可以使用通配符'*',传入 None 时清空已设置项。例如不加载css文件:page.set.blocked_urls('*.css*')
  • run_js(script, *args, as_expr:bool=False, timetout:float=None)->Any
    此方法用于执行 js 脚本。参数script是js脚本文本或脚本路径;*args为传入js的参数,按顺序对应为arguments[0]arguments[1]…;as_expr是否作为表达式运行,为Trueargs参数无效;timetout是脚本超时时间,为None则使用页面timeouts.script设置。返回值为脚本执行结果。
  • run_js_loaded(script, *args, as_expr:bool=False, timetout:float=None)->Any
    此方法用于运行 js 脚本,执行前等待页面加载完毕。参数和使用同 run_js()
  • set.cookies(cookies:Union[RequestsCookieJar, list, tuple, str, dict])
    此方法用于设置 cookie。可以接收CookieJarlisttuplestrdict格式的cookies
  • set.cookies.clear()
    清除所有 cookie。
  • set.cookies.remove(name:str, url:str=None, domain:str=None, path:str=None)
    删除一个 cookie。参数分别是cookie的相应字段
  • set.session_storage(item:str, value:Union[str, False])
    设置或删除某项 sessionStorage 信息。item是要设置的项,valuestr时是设置的值,为False时表示删除该项。
  • set.local_storage(item:str, value:Union[str, False])
    设置或删除某项 localStorage 信息。参数和使用同 set.session_storage()
  • scroll.to_top()
    用于滚动页面到顶部,水平位置不变。
  • scroll.to_bottom()
    用于滚动页面到底部,水平位置不变。
  • scroll.to_see(loc_or_ele:Union[str, tuple, ChromiumElement], center:Union[bool, None]=None)
    滚动页面直到元素可见。参数loc_or_ele是元素的定位信息,可以是元素、定位符;参数center是否尽量滚动到页面正中,为None时如果被遮挡,则滚动到页面正中。
  • set.scroll.wait_complete(on_off:bool=True)
    设置滚动后是否等待滚动结束。因为滚动时间不确定,容易导致程序不稳定。此项可以等待滚动结束再继续执行。
  • handle_alert(accept:Union[bool, None]=True, send:str=None, timeout:float=None, next_one:bool=False)->Union[str, False]
    处理提示框。能够设置等待时间,等待提示框出现才进行处理,若超时没等到提示框,返回False。也可只获取提示框文本而不处理提示框。 还可以处理下一个出现的提示框。参数accept为提示框的处理方式,True表示确认,False表示取消,None不会按按钮但依然返回文本值;send处理 prompt 提示框时输入文本;timeout等待提示框出现的超时时间,为None时使用页面整体超时时间;next_one是否处理下一个出现的弹窗,为Truetimeout参数无效。返回值为提示框内容文本或False未等到提示框。
  • set.auto_handle_alert(on_off:bool=True, accept:bool=True)
    设置自动处理提示框,使提示框不会弹窗而直接被处理掉。参数on_off表示开关设置,accept表示处理使用确定还是取消。
  • quit(timeout:float=5, force:bool=True)
    关闭浏览器,只能使用于Page对象而不能用于Tag对象。参数timeout为等待浏览器关闭超时时间(秒);force为关闭超时是否强制终止进程。

查找元素

DrissionPage使用了一套简洁的语法用于查找元素,支持内置等待、链式查找,同时也支持 css selector、xpath、selenium 原生的 loc 元组。

ele()eles()

ele() 方法和 eles() 方法类似,区别在于后者返回多个元素列表,前者可以接收一个默认值为 1 的index参数,表示返回获取的第几个匹配元素(可以为负值表示倒数)。

parent()child()children()

这三种方法为查找元素的父子元素,参数中可以接收查询语法。parent() 查询中可以接收数字,表示第几级父元素。child() 接收参数 index,表示返回第几个匹配到的元素。

next()nexts()prev()prevs()

这四种方法用于查找当前元素的前 / 后的同级节点。可以使用查询语法,单个查询也支持查找第几个同级节点。

after()afters()before()befores()

这四种方法用于查找当前元素之前之后的节点,范围不止同级节点,而是整个 DOM 文档。

匹配模式

匹配模式指某个查询中匹配条件的方式,有精确匹配、模糊匹配、匹配开头、匹配结尾四种。大部分查找语法默认使用精确匹配。

  • 精确匹配 =
    表示精确匹配,匹配完全符合的文本或属性。例如获取name属性为’row1’的元素:ele = page.ele('@name=row1')
  • 模糊匹配 :
    表示模糊匹配,匹配含有指定字符串的文本或属性。例如获取name属性包含’row1’的元素:ele = page.ele('@name:row1')
  • 匹配开头 ^
    表示匹配开头,匹配开头为指定字符串的文本或属性。例如获取name属性以’row1’开头的元素:ele = page.ele('@name^ro')
  • 匹配结尾 $
    表示匹配结尾,匹配结尾为指定字符串的文本或属性。例如获取name属性以’w1’结尾的元素:ele = page.ele('@name$w1')
查找语法

DrissionPage 支持css selector、xpath、selenium 原生的 loc 元组,这里只列举单独使用的查找语法。

  • id 匹配符 #
    表示id属性,只在语句最前面且单独使用时生效,可配合匹配模式使用。例如:在页面中查找id属性为one的元素:ele1 = page.ele('#one'),在ele1元素内查找id属性包含ne文本的元素:ele2 = ele1.ele('#:ne')
  • class 匹配符 .
    表示class属性,只在语句最前面且单独使用时生效,可配合匹配模式使用。因为默认精确匹配,所以如果某元素有多个类名,必须写 class 属性的完整值(类名的顺序也不能变);如果需要只匹配多个类名中的一个,可以使用模糊匹配符 .:。例如:查找class属性为p_cls的元素:ele2 = ele1.ele('.p_cls');精确查找class属性为p_cls1 p_cls2 的元素:ele2 = ele1.ele('.p_cls1 p_cls2 ');模糊查找class属性含有类名 ‘p_cls2’ 的元素:ele2 = ele1.ele('.:p_cls2')
  • 单属性匹配符 @
    表示匹配某个属性。例如:查找name属性为row1的元素ele2 = ele1.ele('@name=row1');查找有name属性的元素ele2 = ele1.ele('@name');查找没有任何属性的元素ele2 = ele1.ele('@');查找email属性为abc@def.com的元素,有多个@也不会重复处理ele2 = ele1.ele('@email=abc@def.com');属性中有特殊字符的情形,匹配abc@def属性等于v的元素ele2 = ele1.ele('css:div[abc\@def="v"]')
  • 多属性与匹配符 @@
    匹配同时符合多个条件的元素时使用,每个条件前面添加@@作为开头。例如:查找name属性为row1且class属性包含cls文本的元素ele2 = ele1.ele('@@name=row1@@class:cls')
  • 多属性或匹配符@|
    匹配符合多个条件中任一项的元素时使用,每个条件前面添加@|作为开头。用法与@@一致,需注意不能同 @@ 同时出现在语句中。
  • 属性否定匹配符@!
    用于否定某个条件,可与@@@|混用,也可单独使用。
  • 文本匹配符 text
    要匹配的文本,查询字符串如开头没有任何关键字,也表示根据传入的文本作模糊查找。如果元素内有多个直接的文本节点,精确查找时可匹配所有文本节点拼成的字符串,模糊查找时可匹配每个文本节点。例如:查找文本为“第二行”的元素ele2 = ele1.ele('text=第二行');查找文本包含“第二”的元素ele2 = ele1.ele('text:第二')
  • 文本匹配符 text()
    作为查找属性时使用的文本关键字,必须与@@@配合使用。
  • 类型匹配符 tag
    表示元素的标签,只在语句最前面且单独使用时生效,可与@@@@|配合使用。tag:tag=效果一致,没有tag^tag$语法。
  • css selector 匹配符 css
    表示用 css selector 方式查找元素。css:css=效果一致,没有css^css$语法。
  • xpath 匹配符 xpath
    表示用 xpath 方式查找元素。xpath:xpath=效果一致,没有xpath^xpath$语法。另外,元素对象的ele()支持完整的 xpath 语法,如能使用 xpath 直接获取元素属性(字符串类型)。
  • selenium 的 loc 元组
    查找方法能直接接收 selenium 原生定位元组进行查找,便于项目迁移。例如:page.ele((By.XPATH, '//p[@class="p_cls"]'))
处理 frame

虽然 frame 也能够使用 ele() 方法查找到,并且可以穿透 iframe 标签进行操作(页面对象支持跨级查找,元素对象并不支持),但是不建议这样使用。建议使用 Page 对象的 get_frame() 方法来获取和操作 frame元素。

例如:

  • 获取页面中第一个iframe元素: iframe = page.get_frame(1)
  • 获取页面id为theFrame的iframe元素对象: iframe = page.get_frame('#theFrame')

对于 frame 元素,可以看为一个特殊的元素对象,或页面对象来对待。可以同时操作多个 frame,无需切换。

简化写法

为进一步精简代码,定位语法都可以用简化形式来表示,使语句更短,链式操作时更清晰。

原操作简化后说明
page.ele()page()页面对象定位精简
page.ele(@id=xxx)page(#xxx)id查找精简
page.ele(@class=xxx)page(.xxx)class查找精简
page.ele(text=xxx)page(tx=xxx)text查找精简
page.ele(@text()=xxx)page(@tx()=xxx)text()查找精简
page.ele(tag:img)page(t:img)tag 查找精简
page.ele(xpath://xxxx)page(x://xxxx)xpath查找精简
page.ele(css:xxx)page(c:xxxx)css 查找精简

获取元素信息

一些常用的属性和方法能够获取常用的元素数据信息:

  • tag
    此属性返回元素的标签名
  • text
    此属性返回元素内所有文本组合成的字符串
  • attrs
    此属性以字典形式返回元素所有属性及值
  • attre()
    此方法返回元素某个 attribute 属性值
  • link
    此方法返回元素的 href 属性或 src 属性
  • page
    此属性返回元素所在的页面对象
  • style()
    该方法返回元素 css 样式属性值,可获取伪元素的属性。
  • states.is_checked
    此属性以布尔值返回表单单选或多选元素是否选中。
  • states.is_selected
    此属性以布尔值返回<select>元素中的项是否选中。
  • states.is_enabled
    此属性以布尔值返回元素是否可用。
  • states.is_displayed
    此属性以布尔值返回元素是否可见。
  • src()
    此方法用于返回元素src属性所使用的资源。base64 的可转为bytes返回,其它的以str返回。无资源的返回None

元素交互

  • click()
    用于左键点击元素。
  • click.right()
    此方法实现右键单击元素。
  • click.at()
    此方法用于带偏移量点击元素,偏移量相对于元素左上角坐标。不传入offset_x和offset_y时点击元素中间点。
  • click.to_upload()
    此方法用于点击元素,触发文件选择框并把指定的文件路径添加到网页。参数为文件上传路径
  • click.to_download()
    此方法用于点击元素触发下载,并返回下载任务对象。参数为文件保存路径
  • clear()
    清空元素文本
  • input()
    向元素输入文本或组合键,也可用于输入文件路径到上传控件。可选择输入前是否清空元素。组合键需要导入类 from DrissionPage.common import Keys,例如:ele.input((Keys.CTRL, 'a', Keys.DEL))
  • drag()
    拖拽元素到相对于当前的一个新位置
  • drag_to()
    拖拽元素到另一个元素上或一个坐标上
  • hover()
    模拟鼠标悬停在元素上,可接受偏移量,偏移量相对于元素左上角坐标
  • run_js()
    用于对元素执行 js 代码,代码中用this表示元素自己。类似于页面中的 run_js()

appium

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.rhkb.cn/news/262620.html

如若内容造成侵权/违法违规/事实不符,请联系长河编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

knife4j springboot3使用

简介 在日常开发中&#xff0c;写接口文档是我们必不可少的&#xff0c;而Knife4j就是一个接口文档工具&#xff0c;可以看作是Swagger的升级版&#xff0c;但是界面比Swagger更好看&#xff0c;功能更丰富 使用 我使用的是springboot3.2.3 knife4j 4.3.0,knife4j 4.4版本有…

HarmonyOS学习--三方库

文章目录 一、三方库获取二、常用的三方库1. UI库&#xff1a;2. 网络库&#xff1a;3. 动画库&#xff1a; 三、使用开源三方库1. 安装与卸载2. 使用 四、问题解决1. zsh: command not found: ohpm 一、三方库获取 在Gitee网站中获取 搜索OpenHarmony-TPC仓库&#xff0c;在t…

算法沉淀——穷举、暴搜、深搜、回溯、剪枝综合练习四(leetcode真题剖析)

算法沉淀——穷举、暴搜、深搜、回溯、剪枝综合练习四 01.解数独02.单词搜索03.黄金矿工04.不同路径 III 01.解数独 题目链接&#xff1a;https://leetcode.cn/problems/sudoku-solver/ 编写一个程序&#xff0c;通过填充空格来解决数独问题。 数独的解法需 遵循如下规则&am…

个人博客系统测试

文章目录 一、项目介绍二、测试1. 功能测试2. 自动化测试&#xff08;1&#xff09;添加相关依赖&#xff08;2&#xff09;新建包并在报下创建测试类&#xff08;3&#xff09;亮点及难点 一、项目介绍 个人博客系统采用前后端分离的方法来实现&#xff0c;同时使用了数据库来…

Stable Diffusion 3的到来巩固了 AI 图像对抗 Sora 和 Gemini 的早期领先优势

Stability AI 将其更改为 Stable Diffusion 3。VentureBeat 报道称&#xff0c;Stability AI 的下一代旗舰 AI 图像生成模型将使用类似于 OpenAI 的 Sora 的扩散变压器框架。其当前模型仅依赖于扩散架构。虽然尚未发布&#xff0c;但您可以在等候名单中注册。 官方网址链接&am…

<Linux> 可重入函数 volatile关键字 以及SICHLD信号

目录 一、可重入函数 &#xff08;一&#xff09;引入 &#xff08;二&#xff09;可重入函数的判断 二、volatile关键字 &#xff08;一&#xff09;概念 &#xff08;二&#xff09;关于编译器的优化的简单讨论 三、SIGCHLD信号 一、可重入函数 &#xff08;一&#…

CSS 面试题汇总

CSS 面试题汇总 1. 介绍下 BFC 及其应 参考答案&#xff1a; 参考答案&#xff1a; 所谓 BFC&#xff0c;指的是一个独立的布局环境&#xff0c;BFC 内部的元素布局与外部互不影响。 触发 BFC 的方式有很多&#xff0c;常见的有&#xff1a; 设置浮动overflow 设置为 auto、scr…

3DIoUMatch: Leveraging IoU Prediction for Semi-Supervised 3D Object Detection

3DIoUMatch: Leveraging IoU Prediction for Semi-Supervised 3D Object Detection 论文链接&#xff1a;https://arxiv.org/pdf/2012.04355.pdf 代码链接&#xff1a;https://github.com/yezhen17/3DIoUMatch 作者单位&#xff1a;Stanford University等 发表平台&#xff1a;…

镜像的使用条件

Q&#xff1a;老师&#xff0c;我怎么才能把做了一半的脸直接复制呢&#xff1f; A&#xff1a;镜像&#xff0c;但是镜像是有条件的 Q&#xff1a;镜像的使用条件有哪些呢&#xff1f; A&#xff1a; 1.对称面不能存在&#xff0c;必须是镂空的&#xff08;以哪个面做对称…

【坑】Spring Boot整合MyBatis,一级缓存失效

一、Spring Boot整合MyBatis&#xff0c;一级缓存失效 1.1、概述 MyBatis一级缓存的作用域是同一个SqlSession&#xff0c;在同一个SqlSession中执行两次相同的查询&#xff0c;第一次执行完毕后&#xff0c;Mybatis会将查询到的数据缓存起来&#xff08;缓存到内存中&#xf…

Error: A JNI error has occurred, please check your installation and try again

天行健&#xff0c;君子以自强不息&#xff1b;地势坤&#xff0c;君子以厚德载物。 每个人都有惰性&#xff0c;但不断学习是好好生活的根本&#xff0c;共勉&#xff01; 文章均为学习整理笔记&#xff0c;分享记录为主&#xff0c;如有错误请指正&#xff0c;共同学习进步。…

node.js使用multer在vue中实现图片上传

效果演示 点击上传选择要上传的图片。 上传成功会加载图片的缩略图。 此时&#xff0c;图片以保存在后端的静态目录中。 设计思路 vue中使用input标签上传图片&#xff0c;绑定change事件&#xff0c;事件负责把图片发送给后端&#xff0c;后端通过multer模块处理前端传来的…

分散的产品开发团队

分散的产品开发团队指的是各个团队或成员在地理位置上分布在不同地方&#xff0c;通过互联网和现代通讯技术进行协作和沟通&#xff0c;以共同完成产品开发任务的团队模式。 这种团队模式的优势在于可以充分利用各地的人才资源&#xff0c;降低团队的管理和协作成本&#xff0…

云图极速版限时免费活动

产品介绍 云图极速版是针对拥有攻击面管理需求的用户打造的 SaaS 应用&#xff0c;致力于协助用户发现并管理互联网资产攻击面。 实战数据 (2023.11.6 - 2024.2.23) 云图极速版上线 3 个月以来&#xff0c;接入用户 3,563 家&#xff0c;扫描主体 19,961 个&#xff0c;累计发…

【开源】SpringBoot框架开发婚恋交友网站

目录 一、摘要1.1 项目介绍1.2 项目录屏 二、功能模块2.1 数据中心模块2.2 会员管理模块2.3 新闻管理模块2.4 相亲大会管理模块2.5 留言管理模块 三、系统设计3.1 用例设计3.2 数据库设计3.2.1 会员信息表3.2.2 新闻表3.2.3 相亲大会表3.2.4 留言表 四、系统展示五、核心代码5.…

Java 学习和实践笔记(19):this的使用方法

this用来指向当前对象的地址。 this的用法&#xff1a; 1&#xff09;在普通方法中&#xff0c;this总是指向调用该方法的对象。在普通方法中&#xff0c;它是作为一种隐式参数一直就存在着&#xff08;这句话的意思&#xff0c;就是其实在普通方法中&#xff0c;编译器一直就…

计算机网络面经-TCP三次握手一文说清

目录 说一下TCP的三次握手&#xff1f; 为什么要三次握手&#xff1f;两次行不行&#xff1f;四次呢&#xff1f; 为什么建立连接是三次握手&#xff0c;关闭连接确是四次挥手呢&#xff1f; TCP四次挥手的过程&#xff1f; 如果已经建立了连接&#xff0c;但是客户端突然出…

JavaWeb——004Maven SpringBootWeb入门

一、Maven 1、什么是maven&#xff1f; 2、Maven的作用是什么&#xff1f;&#xff08;3种&#xff09; 1.1、方便的依赖管理 依赖管理&#xff1a;有了Maven&#xff0c;我们就不用再手动导入Jar包了&#xff0c;我们只需要在配置文件当中&#xff0c;简单描述一下项目所需要…

前端基础面试题

摘要&#xff1a;最近&#xff0c;看了下慕课2周刷完n道面试题&#xff0c;记录下... 1.请说明Ajax、Fetch、Axios三者的区别 三者都用于网络请求&#xff0c;但维度不同&#xff1a; Ajax&#xff08;Asynchronous Javascript ang XML&#xff09;&#xff0c;是一种在不重新…

深入探索Linux:ACL权限、特殊位与隐藏属性的奥秘

前言&#xff1a; 在Linux系统中&#xff0c;文件和目录的权限管理是一项至关重要的任务。它决定了哪些用户或用户组可以对文件或目录执行读、写或执行等操作。传统的Linux权限模型基于用户、组和其他的概念&#xff0c;但随着时间的推移&#xff0c;这种模型在某些情况下显得…