搜索页面上符合提供 ARIA 角色的元素。
可以使用另一个元素作为起点来搜索元素。

您可以传递一些选项来缩小搜索范围

  • selected - 选择具有 area-selected 属性且值为 truefalse 的元素。
  • checked - 选择具有 area-checked 属性且值为 truefalse 的元素。
  • pressed - 选择具有 area-pressed 属性且值为 truefalse 的元素。
  • current - 选择具有 area-current 属性且值为 truefalse 的元素。
  • level - 选择具有 area-level 属性且值为 truefalse 的元素。此选项仅适用于 heading 角色。
  • expanded - 选择具有 area-expanded 属性且值为 truefalse 的元素。

用法

                    browser.element.findAllByRole(role, [options])
                

示例

export default {
  demoTest(browser: NightwatchAPI): void {
    const comboboxes = browser.element.findAllByRole('combobox');

    const headings = browser.element.findAllByRole(
      'heading',
      { level: 2 }
    );
  }
}

参数

名称 类型 描述
role string
options
可选
[object Object]

返回值

类型 描述
Array.<ScopeWebElement>