Skip to main content

isExisting

Overview​

Use the isExisting command to determine whether a given DOM element exists.

The command returns true if the selected element exists, otherwise it returns false.

warning

Unlike other element commands, Testplane will not wait for the element to exist before executing this command.

Usage​

await browser.$(selector).isExisting();

Usage Examples​

index.html

<div id="notDisplayed" style="display: none"></div>
<div id="notVisible" style="visibility: hidden"></div>
<div id="notInViewport" style="position:absolute; left: 9999999"></div>
<div id="zeroOpacity" style="opacity: 0"></div>

isExisting.js

it("should detect if elements are existing", async ({ browser }) => {
    let elem = await browser.$("#someRandomNonExistingElement");
    let isExisting = await elem.isExisting();
    console.log(isExisting); // outputs: false

    elem = await browser.$("#notDisplayed");
    isExisting = await elem.isExisting();
    console.log(isExisting); // outputs: true

    elem = await browser.$("#notVisible");
    isExisting = await elem.isExisting();
    console.log(isExisting); // outputs: true

    elem = await browser.$("#notInViewport");
    isExisting = await elem.isExisting();
    console.log(isExisting); // outputs: true

    elem = await browser.$("#zeroOpacity");
    isExisting = await elem.isExisting();
    console.log(isExisting); // outputs: true
});

References​

We'd like to give credit to the original WebdriverIO docs article, from which we drew some information while writing our version.