跳到主要内容

🔦 简化写法


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

✅️ 定位符语法简化​

  • 定位语法都有其简化形式
  • 页面和元素对象都实现了__call__()方法，所以page.ele('****')可简化为page('****')
  • 查找方法都支持链式操作

示例：

# 查找tag为div的元素
ele = tab.ele('tag:div')  # 原写法
ele = tab('t:div')  # 简化写法

# 用xpath查找元素
ele = tab.ele('xpath://****')  # 原写法
ele = tab('x://****')  # 简化写法

# 查找text为'something'的元素
ele = tab.ele('text=something')  # 原写法
ele = tab('tx=something')  # 简化写法

简化写法对应列表

原写法简化写法说明
@id#表示 id 属性，简化写法只在语句最前面且单独使用时生效
@class.表示 class 属性，简化写法只在语句最前面且单独使用时生效
texttx按文本匹配
@text()@tx()按文本查找，与 @ 或 @@ 配合使用时
tagt按标签类型匹配
@tag()@t()按元素名查找，与 @ 或 @@ 配合使用时
xpathx用 xpath 方式查找元素
cssc用 css selector 方式查找元素

✅️ shadow root 简化​

一般获取元素的 shadow root 元素，用ele.shadow_root属性。

由于此属性经常用于大量链式操作，名字太长影响可读性，因此可简化为ele.sr

示例：

txt = ele.sr('t:div').text

✅️ 相对定位参数简化​

相对定位时，有时需要获取当前元素后某个元素，而不关心该元素是什么类型，一般是这样写：ele.next(index=2)。

但有一种简化的写法，可以直接写作ele.next(2)。

当第一个参数filter_loc接收数字时，会自动将其视作序号，替代index参数。因此书写可以稍微精简一些。

示例：

ele2 = ele1.parent(2)
ele2 = ele1.next(2)('tx=****')
ele2 = ele1.before(2)
# 如此类推