fix: detect stale elements in BiDi mode for getCSSProperty (#14885)

[mccmrunal]

Added isConnected checks in browser.execute callbacks to throw stale element errors when elements are detached. This triggers proper element refetch via existing middleware, fixing infinite loops in waitForDisplayed when using BiDi protocol.

Fixes #14885

Proposed changes

n v9.20.1, getCSSProperty was updated to always use browser.execute with window.getComputedStyle. Under the BiDi protocol, this causes isDisplayed to make two script.callFunction calls on the same sharedId element.
When the DOM re-renders or the element is not yet attached, that sharedId becomes stale. However, BiDi does not throw a stale-element error. Instead, it returns harmless values like false or an empty string.
Because no stale-element error is raised, WebdriverIO never triggers refetchElement. As a result, waitForDisplayed keeps polling the stale reference until timeout, even if a fresh, visible element matching the selector appears.
In v9.20.0, the older getElementCSSValue implementation did throw stale-element errors. That allowed elements to be refetched properly and prevented this regression.

Add isconnected to check if element is stale
//: # (Describe the big picture of your changes here to communicate to the maintainers why we should accept this pull request. If it fixes a bug or resolves a feature request, be sure to link to that issue.)

Types of changes

• Polish (an improvement for an existing feature)
• Bugfix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• Documentation update (improvements to the project's docs)
• Specification changes (updates to WebDriver command specifications)
• Internal updates (everything related to internal scripts, governance documentation and CI files)

Checklist

• I have read the CONTRIBUTING doc
• I have added tests that prove my fix is effective or that my feature works
• I have added the necessary documentation (if appropriate)
• I have added proper type definitions for new commands (if appropriate)

Backport Request

//: # (The current main branch is the development branch for WebdriverIO v9. If your change should be released to the current major version of WebdriverIO (v8), please raise another PR with the same changes against the v8 branch.)

• This change is solely for v9 and doesn't need to be back-ported
• Back-ported PR at #XXXXX

Further comments

Reviewers: @webdriverio/project-committers

[mccmrunal]

@christian-bromann please review

[pkg-pr-new]

Open in StackBlitz

create-wdio

npm i https://pkg.pr.new/webdriverio/webdriverio/create-wdio@14886

eslint-plugin-wdio

npm i https://pkg.pr.new/webdriverio/webdriverio/eslint-plugin-wdio@14886

@wdio/allure-reporter

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/allure-reporter@14886

@wdio/appium-service

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/appium-service@14886

@wdio/browser-runner

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/browser-runner@14886

@wdio/browserstack-service

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/browserstack-service@14886

@wdio/cli

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/cli@14886

@wdio/concise-reporter

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/concise-reporter@14886

@wdio/config

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/config@14886

@wdio/cucumber-framework

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/cucumber-framework@14886

@wdio/dot-reporter

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/dot-reporter@14886

@wdio/firefox-profile-service

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/firefox-profile-service@14886

@wdio/globals

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/globals@14886

@wdio/jasmine-framework

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/jasmine-framework@14886

@wdio/json-reporter

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/json-reporter@14886

@wdio/junit-reporter

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/junit-reporter@14886

@wdio/lighthouse-service

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/lighthouse-service@14886

@wdio/local-runner

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/local-runner@14886

@wdio/logger

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/logger@14886

@wdio/mocha-framework

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/mocha-framework@14886

@wdio/protocols

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/protocols@14886

@wdio/repl

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/repl@14886

@wdio/reporter

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/reporter@14886

@wdio/runner

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/runner@14886

@wdio/sauce-service

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/sauce-service@14886

@wdio/shared-store-service

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/shared-store-service@14886

@wdio/smoke-test-cjs-service

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/smoke-test-cjs-service@14886

@wdio/smoke-test-reporter

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/smoke-test-reporter@14886

@wdio/smoke-test-service

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/smoke-test-service@14886

@wdio/spec-reporter

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/spec-reporter@14886

@wdio/static-server-service

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/static-server-service@14886

@wdio/sumologic-reporter

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/sumologic-reporter@14886

@wdio/testingbot-service

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/testingbot-service@14886

@wdio/types

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/types@14886

@wdio/utils

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/utils@14886

@wdio/webdriver-mock-service

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/webdriver-mock-service@14886

@wdio/xvfb

npm i https://pkg.pr.new/webdriverio/webdriverio/@wdio/xvfb@14886

webdriver

npm i https://pkg.pr.new/webdriverio/webdriverio/webdriver@14886

webdriverio

npm i https://pkg.pr.new/webdriverio/webdriverio@14886

commit: 76461bf

[christian-bromann]

Awesome , LGTM 👍

[wdio-bot]

Hey mccmrunal 👋

Thank you for your contribution to WebdriverIO! Your pull request has been marked as an "Expensable" contribution.

We've sent you an email with further instructions on how to claim your expenses from our development fund.
Please make sure to check your spam folder as well. If you have any questions, feel free to reach out to us at expense@webdriver.io or in the contributing channel on Discord.

We are looking forward to more contributions from you in the future 🙌

Have a nice day,
The WebdriverIO Team 🤖