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:182-198
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-163
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
getContext
test-support/page-object/helpers.js:252-261
Return a test context if one was provided during create()
Parameters
node
Ceibo Node of the tree
Returns ** The test’s this
context, or null
getRoot
test-support/page-object/helpers.js:234-244
Return the root of a node’s tree
Parameters
node
Ceibo Node of the tree
Returns Ceibo node - Root node of the tree
normalizeText
test-support/page-object/helpers.js:208-210
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