Tags:
- 💥 [Breaking Change]
- 👓 [Spec Compliancy]
- 🚀 [New Feature]
- 🐛 [Bug Fix]
- 📝 [Documentation]
- 🏠 [Internal]
- 💅 [Polish]
Note: Gaps between patch versions are faulty, broken or test releases.
See CHANGELOG - v4.
See CHANGELOG - v5.
See CHANGELOG - v6
wdio-cli
,wdio-config
,wdio-runner
,wdio-types
- #6475 Fix auto compile mechanism (@christian-bromann)
devtools
,wdio-types
- #6473 better type and document
wdio:devtoolsOptions
(@christian-bromann)
- #6473 better type and document
wdio-cli
,wdio-config
,wdio-jasmine-framework
,wdio-junit-reporter
- #6472 Rename
jasmineNodeOpts
intojasmineOpts
(@christian-bromann)
- #6472 Rename
wdio-types
- #6474 Improve type definition for Sauce Labs capabilities (@christian-bromann)
- Other
- Christian Bromann (@christian-bromann)
- Eric Saari (@esaari)
- Piotr Mikosz (@MikoSh95)
wdio-cucumber-framework
- #6453 Fix/add cucumber keyword (@wswebcreation)
- Piotr Mikosz (@MikoSh95)
- Wim Selles (@wswebcreation)
wdio-sauce-service
- #6454 Fix/sauce service cucumber (@wswebcreation)
- #6446 chore: fix link to contributor guide in README (@web-padawan)
devtools
,wdio-devtools-service
,webdriverio
- #6447 chore: remove obsolete puppeteer types (@web-padawan)
- Serhii Kulykov (@web-padawan)
- Wim Selles (@wswebcreation)
wdio-cucumber-framework
- #6441 Ensure that 'title' property is passed down by cucumber framework to reporters (@rickschubert)
wdio-cli
,wdio-local-runner
,wdio-types
- #6373 @wdio/cli: Ensure watch mode re-runs all specs when the --spec command line option is set and a filesToWatch file is added or changed (@kohlmannj)
wdio-junit-reporter
- #6439 Removed _ from suite/test name in junit reporter (@AutomationReddy)
devtools
,wdio-allure-reporter
- Other
- #6444 fixed typo in the wdio exec command (@AutomationReddy)
wdio-runner
,webdriverio
- #6429 Improve typings for instance base (@christian-bromann)
wdio-cli
,wdio-cucumber-framework
,webdriverio
- #6431 fix docs for cucumber hooks (@christian-bromann)
wdio-junit-reporter
- #6430 bump junit reporter builder (@christian-bromann)
- Christian Bromann (@christian-bromann)
- Joseph Kohlmann (he/him/his) (@kohlmannj)
- Raju (@spnraju)
- Rick Schubert (@rickschubert)
- Vinod Reddy (@AutomationReddy)
- @dependabot-preview[bot]
wdio-types
,webdriver
,webdriverio
- #6416 Move user/key options back to
webdriver
package (@christian-bromann)
- #6416 Move user/key options back to
webdriverio
- #6415 Allow
ScrollIntoViewOptions
inscrollIntoView
(@christian-bromann)
- #6415 Allow
- Christian Bromann (@christian-bromann)
wdio-config
,wdio-runner
,wdio-sync
,wdio-types
,webdriver
,webdriverio
- #6408 Refactor
detectBackend
and move it to thewebdriverio
package (@christian-bromann)
- #6408 Refactor
- Christian Bromann (@christian-bromann)
wdio-allure-reporter
,wdio-appium-service
,wdio-applitools-service
,wdio-browserstack-service
,wdio-concise-reporter
,wdio-crossbrowsertesting-service
,wdio-cucumber-framework
,wdio-devtools-service
,wdio-dot-reporter
,wdio-firefox-profile-service
,wdio-jasmine-framework
,wdio-junit-reporter
,wdio-local-runner
,wdio-sauce-service
,wdio-selenium-standalone-service
,wdio-spec-reporter
,wdio-sumologic-reporter
,wdio-testingbot-service
- #6402 Update peer dependencies (@christian-bromann)
- Christian Bromann (@christian-bromann)
- Kanitkorn Sujautra (@lukyth)
- #6302 TypeScript Rewrite
-
As we have moved the complete code base to TypeScript we have rewritten the way how WebdriverIO provides type definitions to you. This has been more or less and internal change that should only affect users using TypeScript and having custom command definitions. In order to have proper type support now you need to add
webdriverio/sync
to your list of types, e.g.:// tsconfig.json "types": [ "node", "webdriverio/sync", "@wdio/mocha-framework" ],
Custom commands can now be added like this:
declare global { namespace WebdriverIO { interface Browser { browserCustomCommand: (arg: number) => void } } } browser.browserCustomCommand(42)
We do not recommend to specify
webdriverio
or@wdio/sync
in there anymore. For more information visit our updated docs on TypeScript Integration. -
If you use WebdriverIO in multiremote mode to get proper typing you should use the
multiremote
global variable -
Alongside with this change we also equipped the testrunner to auto-compile your configuration if TypeScript is detected, this allows to leverage type safety in your WDIO configuration without any additional setup (big thanks for this contribution goes to @r4j4h)
-
It is required to have TypeScript v4 or higher
-
- #6309 Cucumber Framework update to v7
- We have updated our Cucumber integration to use Cucumber v7
- To provide proper type safety we updated the Cucumber hooks to match original Cucumber types
- #6276 Google Lighthouse Updates
-
We have updated Google Lighthouse to support the latest performance metrics introduced by Google Lighthouse v7
-
There are no default environment changes when running performance tests anymore. If you want to emulate a mobile user (which is a recommended practice) you have to pass these information when running
enablePerformanceAudits
, e.g.:browser.emulateDevice('iPhone X') browser.enablePerformanceAudits({ networkThrottling: 'Regular 3G', cpuThrottling: 4, cacheEnabled: false, formFactor: 'mobile' })
-
We added
formFactor
to theEnablePerformanceAuditsOptions
as it has been added to Lighthouse v7 as well, it tweaks the performance results based on which environment you run your tests in to give certain performance factors more weight -
We added a new command test PWA apps based on Google Lighthouse audits, e.g.:
const result = browser.checkPWA() expect(result.passed).toBe(true)
Checks the following PWA criterias:
- Installable
- PWA optimized (without checking for HTTPS redirect)
We have purposely not added the complete set of audits as they require data that can only be captured through additional automation commands. These could interfer with further test processes and skew results and create flakiness which would make integrating these commands difficult.
-
- #3407 Automatically run worker with Babel if setup
- In order to improve the onboarding experience we will now automatically compile the configuration and your test files using Babel or TypeScript
- This will allow you to have
import
statements in your config file without any additional setup
- #6054 Validate W3C Capabilities
- With the WebDriver protocol being a recommended standard since 2018 we want to move away from usage of outdated capability sets that might confuse WebDriver endpoints
- This breaking change will throw an error if we detect invalid capabilities when user use a mixture of clear W3C capabilities and outdated JSONWireProtocol capabilities, e.g.:
will fail this check because vendor capabilities have been used which were introduced by WebDriver while at the same time a JSONWireProtocol capability (
capabilities: { browserName: 'Chrome', platform: 'Windows 10', // invalid JSONWire Protocol capability 'goog:chromeOptions': { ... } }
platform
) has been used too
- #6236 Update fibers to v5 and drop Node.js support for v10
- We recommend to continue to use Node.js v12 and higher)
- #6311 Get Test Coverage Report
- The
@wdio/devtools-service
now offers to capture the code coverage of your JavaScript application files. This can help you to identify whether you should write more e2e tests or not. To enable the feature you have to enable it by setting thecoverageReporter
option for the service:// wdio.conf.js services: [ ['devtools' { coverageReporter: { enable: true, type: 'html', logDir: __dirname + '/coverage' } }] ]
- You can also assert the code coverage within your tests using the new
getCoverageReport
command, e.g.:const coverage = browser.getCoverageReport() expect(coverage.lines.total).toBeAbove(0.9) expect(coverage.statements.total).toBeAbove(0.9) expect(coverage.functions.total).toBeAbove(0.9) expect(coverage.branches.total).toBeAbove(0.9)
- The
- We have renamed our main development branch from
master
tomain
- As the WebdriverIO community is committed to be an inclusive community we join the global effort to remove all unnecessary references to slavery and other non-inclusive terms.
- #6392 Add Sauce Labs sharable report links in
@wdio/spec-reporter
- New Website Design and Documentation Overhaul
- The project maintainers are constantly striving to provide better documentation and clear descriptions on commands and WebdriverIO functionality. We the v7 release we now also publish an overhauled website design and re-organisation of our docs.
- You will continue to find the old docs in their respective places:
- v6 docs - v6.webdriver.io
- v5 docs - v5.webdriver.io
- v4 docs - v4.webdriver.io