@testx/objects-standard

TestX Standard objects

This package contains standard objects for testx. These object locators come from Protractor.

Installation

Install the package with:

npm install @testx/objects-standard --save

Usage

In your object files

const { xpath, css } = require('@testx/objects-standard');

module.exports = {
  "MyObject": xpath("//input"),
  "MyOtherObject": css(".cool-class")
}

And then in your testx script:

- go to:
    url: /
- set:
    MyObject: some stuff
    MyOtherObject: other things

Directly in your testx scripts

Add to your tests like any other testx node module. In your config file, as part of the onPrepare function:

testx.objects.add(require('@testx/objects-standard'))

Then use these as any other (functional) object reference:

- go to:
    url: /
- set:
    linkText('Login'):
    name('username'): testuser
    name('password'): verysecret
    buttonText('Login'):

NOTE: Avoid using it this way too often or you may end up with fragile set of tests.

Available objects

This package exposes almost all non-angular protractor (web driver++) element locators. It also adds some custom ones.

Object reference	Description
css	Locates elements using a CSS selector.
xpath	Locates elements matching a XPath selector.
id	Locates an element by its ID.
name	Locates elements whose name attribute has the given value.
linkText	Locates link elements whose visible text matches the given string.
partialLinkText	Locates link elements whose visible text contains the given substring.
className	Locates elements that have a specific class name.
tagName	Locates elements with a given tag name.
buttonText	Find a button by text.
partialButtonText	Find a button by partial text.
cssContainingText	Find elements by CSS which contain a certain string.
deepCss	Find an element by css selector within the Shadow DOM.