微软出品自动化神器【Playwright+Java】系列(七) 之 元素的可操作性验证

时间:2022-12-18 10:54:30

前言

昨天在某平台发表了一篇这系列的文章,结果不但提示说有违禁词(java也算?),然后文章审核通过后,文章还找不到,不到去哪了,表示很郁闷,去反应未果,确实有点尴尬了。

元素的可操作性验证

关于API的命名,仅出自于我个人理解,旨在看的同学理解会用,感觉名字不好可以重写哈!

1、何为元素的可操作性验证?

在采取行动之前对元素执行一系列可操作性检查,以确保这些行动按预期进行。它会自动等待所有相关检查通过,然后才执行请求的操作。如果所需的检查未在给定范围内通过timeout,则操作失败并显示TimeoutError

举个栗子:

如元素点击操作,在操作元素之前需要预判:

  • 元素是否附加到DOM
  • 元素是否可见
  • 元素是否加载完成,因为没有为加载完元素不可操作
  • 元素是否接收事件,因为没有被其他元素遮挡不可操作
  • 元素是否可用

以下是针对每个操作执行的可操作性检查的完整列表:

Action Attached Visible Stable Receives Events Enabled Editable
check Yes Yes Yes Yes Yes -
click Yes Yes Yes Yes Yes -
dblclick Yes Yes Yes Yes Yes -
setChecked Yes Yes Yes Yes Yes -
tap Yes Yes Yes Yes Yes -
uncheck Yes Yes Yes Yes Yes -
hover Yes Yes Yes Yes - -
scrollIntoViewIfNeeded Yes - Yes - - -
screenshot Yes Yes Yes - - -
fill Yes Yes - - Yes Yes
selectText Yes Yes - - - -
dispatchEvent Yes - - - - -
focus Yes - - - - -
getAttribute Yes - - - - -
innerText Yes - - - - -
innerHTML Yes - - - - -
press Yes - - - - -
setInputFiles Yes - - - - -
selectOption Yes Yes - - Yes -
textContent Yes - - - - -
type Yes - - - - -

2、常见检查元素的可操作性方法

注意:

  • 当元素连接到DocumentShadowRoot 时,元素被视为已附加。
  • 当元素具有非空边界框且没有visibility:hidden计 算样式时,元素被认为是可见的。请注意,零大小或带有的元素display:none不被视为可见。
  • 当元素在至少两个连续的动画帧中保持相同的边界框时,它被认为是稳定的。
  • 元素被视为已启用,除非它是<button>、或具有属性。<select><input><textarea>disabled
  • 元素在启用且未设置属性时被视为可编辑readonly

3、举个栗子

判断按钮是否可用,如下图:

微软出品自动化神器【Playwright+Java】系列(七) 之 元素的可操作性验证

示例代码如下:

@Test
public void testCheck(){
    System.out.println("按钮状态是否可用:"+page.locator("[value='Submit']").isEnabled());
    System.out.println("按钮状态是否可用:"+page.locator("[value='Submit']").isDisabled());

}

最后

关于其他API部分,请自行去尝试,说句实话,真的硬磕官方文档确实有点累,果然塑料英语是真的不行,希望不要误人子弟就好,建议英文好的同学,还是去看官方文档吧。