waitForEnabled

Wait for an element (selected by css selector) for the provided amount of milliseconds to be (dis/en)abled. If multiple elements get queried by given selector, it returns true if at least one element is (dis/en)abled.

info

As opposed to other element commands WebdriverIO will not wait for the element to exist to execute this command.

Usage

$(selector).waitForEnabled({ timeout, reverse, timeoutMsg, interval })

Parameters

Name	Type	Details
options optional	WaitForOptions	waitForEnabled options (optional)
options.timeout optional	Number	time in ms (default: 500)
options.reverse optional	Boolean	if true it waits for the opposite (default: false)
options.timeoutMsg optional	String	if exists it overrides the default error message
options.interval optional	Number	interval between checks (default: waitforInterval)

Examples

index.html

<input type="text" id="username" value="foobar" disabled="disabled"></input>
<script type="text/javascript">
    setTimeout(() => {
        document.getElementById('username').disabled = false
    }, 2000);
</script>

waitForEnabledExample.js

it('should detect when element is enabled', async () => {
    await $('#username').waitForEnabled({ timeout: 3000 });
});

it('should detect when element is disabled', async () => {
    elem = await $('#username');
    await elem.waitForEnabled({ reverse: true })
});