Library of useful expected conditions Service

wdio-wait-for is a 3rd party package, for more information please see GitHub | npm

wdio-wait-for is a Node.js library for WebdriverIO that supplies a set of common conditions that provides functionalities to wait for certain conditions till a defined task is complete.

Installation

To use wdio-wait-for in your project, run:

npm i -D wdio-wait-for

Note: if you use the WDIO Testrunner this package will be already included.

API

• alertIsPresent
• numberOfWindowsToBe​
• titleContains
• titleIs
• urlContains
• urlIs
• elementToBeClickable
• elementToBeEnabled
• elementToBeSelected
• invisibilityOf
• numberOfElementsToBe
• numberOfElementsToBeLessThan
• numberOfElementsToBeMoreThan​
• presenceOf
• sizeOfElementToBe
• stalenessOf
• textToBePresentInElement
• textToBePresentInElementValue
• visibilityOf
• and
• not
• or

Examples

Import

JavaScript

// import all methods
const EC = require('wdio-wait-for');

browser.waitUntil(EC.alertIsPresent(), { timeout: 5000, timeoutMsg: 'Failed, after waiting for the alert to be present' })

// import specific method
const { alertIsPresent } = require('wdio-wait-for');

browser.waitUntil(alertIsPresent(), { timeout: 5000, timeoutMsg: 'Failed, after waiting for the alert to be present' })

TypeScript

// import all methods
import * as EC from 'wdio-wait-for';

browser.waitUntil(EC.elementToBeEnabled('input'), { timeout: 5000, timeoutMsg: 'Failed, after waiting for the element to be enabled' })

// import specific method
import { elementToBeEnabled } from 'wdio-wait-for';

browser.waitUntil(elementToBeEnabled('input'), { timeout: 5000, timeoutMsg: 'Failed, after waiting for the element to be enabled' })

Wait for alert

This code code snippet shows how to use conditions

browser.waitUntil(alertIsPresent(), { timeout: 5000, timeoutMsg: 'Failed, after waiting for the alert to be present' })

Wait for number of elements to be

This code code snippet shows how to use conditions

browser.waitUntil(numberOfElementsToBe('.links', 2), { timeout: 5000, timeoutMsg: 'Failed, after waiting for the 2 elements' })

License

wdio-wait-for is MIT licensed.

Author

Yevhen Laichenkov elaichenkov@gmail.com