指定されたARIAロールを満たす要素をページ上で検索します。
別の要素を開始点として使用して要素を検索できます。

検索を絞り込むためにいくつかのオプションを渡すことができます

  • selected - area-selected属性がtrueまたはfalseの値を持つ要素を選択します。
  • checked - area-checked属性がtrueまたはfalseの値を持つ要素を選択します。
  • pressed - area-pressed属性がtrueまたはfalseの値を持つ要素を選択します。
  • current - area-current属性がtrueまたはfalseの値を持つ要素を選択します。
  • level - area-level属性がtrueまたはfalseの値を持つ要素を選択します。このオプションは、headingロールにのみ適しています。
  • expanded - area-expanded属性がtrueまたはfalseの値を持つ要素を選択します。

使い方

                    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 });
  }
}

パラメータ

名前 説明
role string
options
任意
[object Object]

戻り値

説明
ScopedWebElement