.findByRole() 編集を提案
Since: 3.0.0指定された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 |