在页面上搜索符合提供的 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.findByRole(role, [options])
                

示例

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

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

参数

名称 类型 描述
角色 字符串
选项
可选
[object Object]

返回值

类型 描述
ScopedWebElement