Methods

Table of Contents

focusable

Focuses element matched by selector.

Parameters

  • selector string CSS selector of the element which will be focused
  • userOptions (optional, default {})
  • options Object Additional options
    • options.scope string Nests provided scope within parent’s scope
    • options.at number Reduce the set of matched elements to the one at the specified index
    • options.resetScope boolean Ignore parent scope
    • options.testContainer string Context where to search elements in the DOM

Examples

// <input class="name">
// <input class="email">

const page = PageObject.create({
  focus: focusable('.name')
});

// focuses on element with selector '.name'
page.focus();
// <div class="scope">
//   <input class="name">
// </div>
// <input class="email">

const page = PageObject.create({
  focus: focusable('.name', { scope: '.scope' })
});

// focuses on element with selector '.scope .name'
page.focus();
// <div class="scope">
//   <input class="name">
// </div>
// <input class="email">

const page = PageObject.create({
  scope: '.scope',
  focus: focusable('.name')
});

// focuses on element with selector '.scope .name'
page.focus();

Returns Descriptor