.findAllByRole() Suggest edits
Since: 3.0.0Search for elements on the page that meet the provided ARIA role.
Elements can be searched by using another element as the starting point.
You can pass some options to narrow the search:
selected
- picks elements that has thearea-selected
attribute withtrue
orfalse
value.checked
- picks elements that has thearea-checked
attribute withtrue
orfalse
value.pressed
- picks elements that has thearea-pressed
attribute withtrue
orfalse
value.current
- picks elements that has thearea-current
attribute withtrue
orfalse
value.level
- picks elements that has thearea-level
attribute withtrue
orfalse
value. This option is suitable only for theheading
role.expanded
- picks elements that has thearea-expanded
attribute withtrue
orfalse
value.
Usage
browser.element.findAllByRole(role, [options])
Example
export default {
demoTest(browser: NightwatchAPI): void {
const comboboxes = browser.element.findAllByRole('combobox');
const headings = browser.element.findAllByRole(
'heading',
{ level: 2 }
);
}
}
Parameters
Name | Type | description |
---|---|---|
role |
string | |
options Optional |
[object Object] |
Returns
Type | description |
---|---|
Array.<ScopeWebElement> |