搜尋頁面上符合所提供 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 字串
options
選用
[物件 物件]

傳回

類型 描述
陣列.<ScopeWebElement>