Helpers
Methods
buildSelector
test-support/page-object/helpers.js:118-120
Builds a CSS selector from a target selector and a PageObject or a node in a PageObject, along with optional parameters.
Parameters
node
Ceibo Node of the treetargetSelector
string CSS selectoroptions
Object Additional optionsoptions.resetScope
boolean Do not use inherited scopeoptions.contains
string Filter by using :contains(‘foo’) pseudo-classoptions.at
number Filter by index using :eq(x) pseudo-classoptions.last
boolean Filter by using :last pseudo-class
Examples
const component = PageObject.create({ scope: '.component'});
buildSelector(component, '.my-element');
// returns '.component .my-element'
const page = PageObject.create({});
buildSelector(page, '.my-element', { at: 0 });
// returns '.my-element:eq(0)'
const page = PageObject.create({});
buildSelector(page, '.my-element', { contains: "Example" });
// returns ".my-element :contains('Example')"
const page = PageObject.create({});
buildSelector(page, '.my-element', { last: true });
// returns '.my-element:last'
Returns string Fully qualified selector
findElement
test-support/page-object/helpers.js:166-173
Returns a jQuery element (can be an empty jQuery result)
Parameters
node
Ceibo Node of the treetargetSelector
string Specific CSS selectoroptions
Object Additional optionsoptions.resetScope
boolean Do not use inherited scopeoptions.contains
string Filter by using :contains(‘foo’) pseudo-classoptions.at
number Filter by index using :eq(x) pseudo-classoptions.last
boolean Filter by using :last pseudo-classoptions.multiple
boolean Specify if built selector can match multiple elements.
Returns Object jQuery object
findElementWithAssert
test-support/page-object/helpers.js:140-147
Returns a jQuery element matched by a selector built from parameters
Parameters
node
Ceibo Node of the treetargetSelector
string Specific CSS selectoroptions
Object Additional optionsoptions.resetScope
boolean Do not use inherited scopeoptions.contains
string Filter by using :contains(‘foo’) pseudo-classoptions.at
number Filter by index using :eq(x) pseudo-classoptions.last
boolean Filter by using :last pseudo-classoptions.multiple
boolean Specify if built selector can match multiple elements.
Returns Object jQuery object
normalizeText
test-support/page-object/helpers.js:183-185
Trim whitespaces at both ends and normalize whitespaces inside text
Due to variations in the HTML parsers in different browsers, the text
returned may vary in newlines and other white space.
Parameters
text