Release notes

What's Changed

Enhancements

• Add option not to load Nightwatch APIs while launching browser. by @garg3133 in https://github.com/nightwatchjs/nightwatch/pull/4358
• Pass local context to browser.debug() command. by @garg3133 in https://github.com/nightwatchjs/nightwatch/pull/4299

Full Changelog: https://github.com/nightwatchjs/nightwatch/compare/v3.10.2...v3.11.0

What's Changed

• Increase default timeout for browserstack env. by @Rohannagariya1 in https://github.com/nightwatchjs/nightwatch/pull/4349

Full Changelog: https://github.com/nightwatchjs/nightwatch/compare/v3.10.1...v3.10.2

What's Changed

• Fix .perform() command node promise getting resolved early. by @garg3133 in https://github.com/nightwatchjs/nightwatch/pull/4348
• Fix API calls and improve integration with Turboscale. by @Rohannagariya1 in https://github.com/nightwatchjs/nightwatch/pull/4347

New Contributors

• @Rohannagariya1 made their first contribution in https://github.com/nightwatchjs/nightwatch/pull/4347

Full Changelog: https://github.com/nightwatchjs/nightwatch/compare/v3.10.0...v3.10.1

NOTE: This release contains a few important fixes in the core of Nightwatch. So, if you encounter any unexpected behaviour after upgrading to this release that is not reproducible in the previous release, please open a new issue and tag @garg3133.

What's Changed

Fixes

• Throw error and disable suite for duplicate test cases in describe instance. by @badra022 in https://github.com/nightwatchjs/nightwatch/pull/4302
• Fix asynctree from getting cleared in between test case. by @garg3133 in https://github.com/nightwatchjs/nightwatch/pull/4325
• Reject custom commands node promise on abortOnFailure. by @garg3133 in https://github.com/nightwatchjs/nightwatch/pull/4314
• Fix unhandledRejection on error inside function-based custom commands. by @garg3133 in https://github.com/nightwatchjs/nightwatch/pull/4309
• Restrict suppressNotFoundErrors to NoSuchElementError in new Elem API. by @Vaibhavsahu2810 in https://github.com/nightwatchjs/nightwatch/pull/4294
• Fix TypeError while using assert.present() in new Elem API. by @garg3133 in https://github.com/nightwatchjs/nightwatch/pull/4303
• Fix types for dragAndDrop command in new Elem API. by @ShreySinha02 in https://github.com/nightwatchjs/nightwatch/pull/4329

Enhancements and other changes

• Add CustomCommandInstance interface for this in custom commands. by @garg3133 in https://github.com/nightwatchjs/nightwatch/pull/4310
• Bump selenium-webdriver from 4.26.0 to 4.27.0 by @dikwickley in https://github.com/nightwatchjs/nightwatch/pull/4334

New Contributors

• @Vaibhavsahu2810 made their first contribution in https://github.com/nightwatchjs/nightwatch/pull/4294
• @badra022 made their first contribution in https://github.com/nightwatchjs/nightwatch/pull/4302
• @ShreySinha02 made their first contribution in https://github.com/nightwatchjs/nightwatch/pull/4329

Full Changelog: https://github.com/nightwatchjs/nightwatch/compare/v3.9.0...v3.10.0

What's Changed

• Bump selenium-webdriver to 4.26.0 by @garg3133 in https://github.com/nightwatchjs/nightwatch/pull/4293
• Add isActive() command to new Element API by @dikwickley in https://github.com/nightwatchjs/nightwatch/pull/4261
• Add getComputedLabel() and getComputedRole() alias commands. by @garg3133 in https://github.com/nightwatchjs/nightwatch/pull/4296
• Improve TSDoc for page object's url property. by @garg3133 in https://github.com/nightwatchjs/nightwatch/pull/4297
• Add types for custom commands on page object sections. by @garg3133 in https://github.com/nightwatchjs/nightwatch/pull/4298

Full Changelog: https://github.com/nightwatchjs/nightwatch/compare/v3.8.1...v3.9.0

Issue in v3.8.0

• Fix moveToElement command causing issues in v3.8.0 by @garg3133 in https://github.com/nightwatchjs/nightwatch/pull/4283

Fixes and other updates

• Suppress errors for subsequently chained .find() commands by @dikwickley in https://github.com/nightwatchjs/nightwatch/pull/4119
• Add new examples for element v3 API. by @dikwickley in https://github.com/nightwatchjs/nightwatch/pull/4274
• fix: frame command overlapping with subsequent NW commands. by @garg3133 in https://github.com/nightwatchjs/nightwatch/pull/4276
• fix: assertion failure in new Elem API leads to unhandledRejection. by @garg3133 in https://github.com/nightwatchjs/nightwatch/pull/4277
• Add null check before rejecting BaseLoader.lastDeferred. by @garg3133 in https://github.com/nightwatchjs/nightwatch/pull/4278
• type: Add driver property to NightwatchAPI. by @garg3133 in https://github.com/nightwatchjs/nightwatch/pull/4279
• Enforce BrowserStack build requests to use port 443. by @garg3133 in https://github.com/nightwatchjs/nightwatch/pull/4282
• fix: HTTP request agent does not change on protocol change. by @garg3133 in https://github.com/nightwatchjs/nightwatch/pull/4286

Full Changelog: https://github.com/nightwatchjs/nightwatch/compare/v3.8.0...v3.8.1

What's Changed

Enhancements

• Add isPresent command to new Element API. by @dikwickley in https://github.com/nightwatchjs/nightwatch/pull/4216
• Display describe name in HTML report. by @garg3133 in https://github.com/nightwatchjs/nightwatch/pull/4245
• Expose HttpRequest and cdp modules as utils. by @garg3133 in https://github.com/nightwatchjs/nightwatch/pull/4238

Fixes and other updates

• Add types for Appium-specific locate strategies. by @garg3133 in https://github.com/nightwatchjs/nightwatch/pull/4240
• Save command result values in Json Report. by @garg3133 in https://github.com/nightwatchjs/nightwatch/pull/4258
• Add selector and error line for "staleElementReferenceError" by @pujagani in https://github.com/nightwatchjs/nightwatch/pull/4214
• Update selenium to 4.24.1 by @AutomatedTester in https://github.com/nightwatchjs/nightwatch/pull/4266

New Contributors

• @pujagani made their first contribution in https://github.com/nightwatchjs/nightwatch/pull/4214

Full Changelog: https://github.com/nightwatchjs/nightwatch/compare/v3.7.0...v3.8.0

What's Changed

• Fix selectElement example test. by @garg3133 in https://github.com/nightwatchjs/nightwatch/pull/4233
• Update ws dependency by @AutomatedTester in https://github.com/nightwatchjs/nightwatch/pull/4235
• Add .check and .uncheck commands for immutable checkbox operations by @reallymello in https://github.com/nightwatchjs/nightwatch/pull/4232

Full Changelog: https://github.com/nightwatchjs/nightwatch/compare/v3.6.4...v3.7.0

What's Changed

• Fix error in Cucumber when session is closed in a test case itself. by @garg3133 in https://github.com/nightwatchjs/nightwatch/pull/4209
• Fix page object demo examples in API docs. by @garg3133 in https://github.com/nightwatchjs/nightwatch/pull/4210
• Fixed W3C WebDriver Spec links in API docs. by @Halim-Shams in https://github.com/nightwatchjs/nightwatch/pull/4166
• Small modifications in API docs for updating value. by @garg3133 in https://github.com/nightwatchjs/nightwatch/pull/4213
• Fix API doc for setPassword command. by @garg3133 in https://github.com/nightwatchjs/nightwatch/pull/4225
• Fix selector object doc links in API docs. by @garg3133 in https://github.com/nightwatchjs/nightwatch/pull/4226
• Allow to enter the DEBUG mode from the pause command. by @garg3133 in https://github.com/nightwatchjs/nightwatch/pull/4224

New Contributors

• @Halim-Shams made their first contribution in https://github.com/nightwatchjs/nightwatch/pull/4166

Full Changelog: https://github.com/nightwatchjs/nightwatch/compare/v3.6.3...v3.6.4

What's Changed

• Bump selenium-webdriver to 4.21.0 by @garg3133 in https://github.com/nightwatchjs/nightwatch/pull/4207

Full Changelog: https://github.com/nightwatchjs/nightwatch/compare/v3.6.2...v3.6.3

What's Changed

Fixes

• Fix command args showing as '[object Object]' in reporter. by @garg3133 in https://github.com/nightwatchjs/nightwatch/pull/4195
• Fix test not aborting when waitFor commands used with async/await. by @garg3133 in https://github.com/nightwatchjs/nightwatch/pull/4196

Dependency updates

• Bump ejs to 3.1.10 by @garg3133 in https://github.com/nightwatchjs/nightwatch/pull/4204
• chore: updating mocha from 10.2.0 -> 10.3.0 to remove CVE-2022-3517 by @athammer in https://github.com/nightwatchjs/nightwatch/pull/4199
• Bump selenium-webdriver to 4.20.0 by @garg3133 in https://github.com/nightwatchjs/nightwatch/pull/4206

New Contributors

• @athammer made their first contribution in https://github.com/nightwatchjs/nightwatch/pull/4199

Full Changelog: https://github.com/nightwatchjs/nightwatch/compare/v3.6.1...v3.6.2

What's Changed

Enhancements

• Add fallback for clear command. by @FireNdIce3 in https://github.com/nightwatchjs/nightwatch/pull/4035 (This also impacts the setValue and updateValue commands which clears the field before sending new values.)
• Use NoSuchElementError when element not found in new Element API. by @garg3133 in https://github.com/nightwatchjs/nightwatch/pull/4193

Fixes

• Fix debug() allowing only one command run in async/await mode. by @chikara1608 in https://github.com/nightwatchjs/nightwatch/pull/4139
• Fix help messages for iOS errors. by @garg3133 in https://github.com/nightwatchjs/nightwatch/pull/4189
• Keep error's original messages for NoSuchElementError. by @garg3133 in https://github.com/nightwatchjs/nightwatch/pull/4191
• Update Page Object tests to make sure invalid Page Objects elements are handled by @AutomatedTester in https://github.com/nightwatchjs/nightwatch/pull/4187

New aliases in new Element API (for backwards compatibility)

• .ariaRole() as alias for .getAriaRole() by @Sajantoor in https://github.com/nightwatchjs/nightwatch/pull/4159
• .text() as alias for .getText() by @Ayush-Vish in https://github.com/nightwatchjs/nightwatch/pull/4180
• .prop() as alias for .getProperty() by @Ayush-Vish in https://github.com/nightwatchjs/nightwatch/pull/4174
• .accessibleName() as alias for .getAccessibleName() by @Ayush-Vish in https://github.com/nightwatchjs/nightwatch/pull/4178
• .tagname() as alias for .getTagName() by @Ayush-Vish in https://github.com/nightwatchjs/nightwatch/pull/4176
• .css() and .getCssValue() as aliases for .getCssProperty() by @Ayush-Vish in https://github.com/nightwatchjs/nightwatch/pull/4168
• .attr() and .attribute() as alias for .getAttribute() by @Ayush-Vish in https://github.com/nightwatchjs/nightwatch/pull/4172
• Added aliases for .find() and .findAll() commands in new Element API by @AritraLeo in https://github.com/nightwatchjs/nightwatch/pull/4130

New Contributors

• @Sajantoor made their first contribution in https://github.com/nightwatchjs/nightwatch/pull/4159
• @Ayush-Vish made their first contribution in https://github.com/nightwatchjs/nightwatch/pull/4180
• @AritraLeo made their first contribution in https://github.com/nightwatchjs/nightwatch/pull/4130
• @FireNdIce3 made their first contribution in https://github.com/nightwatchjs/nightwatch/pull/4035

Full Changelog: https://github.com/nightwatchjs/nightwatch/compare/v3.6.0...v3.6.1

What's Changed

• Add rect() as alias for getRect() command. by @dikwickley in https://github.com/nightwatchjs/nightwatch/pull/4128
• Fix waitUntil not working with async/await. by @chikara1608 in https://github.com/nightwatchjs/nightwatch/pull/4123
• Fix bug that aborts test when waitUntil throws error. #4157 by @chikara1608 in https://github.com/nightwatchjs/nightwatch/pull/4161

New Contributors

• @chikara1608 made their first contribution in https://github.com/nightwatchjs/nightwatch/pull/4123

Full Changelog: https://github.com/nightwatchjs/nightwatch/compare/v3.5.0...v3.6.0

What's Changed

• Add actionable error message for TimeoutError in hooks. by @dikwickley in https://github.com/nightwatchjs/nightwatch/pull/4053
• Add missing isSelected command to new Element API. by @dikwickley in https://github.com/nightwatchjs/nightwatch/pull/4038
• Added missing isEnabled command in new Element API by @subhajit20 in https://github.com/nightwatchjs/nightwatch/pull/4041
• Refactor commands in README. by @konavivekramakrishna in https://github.com/nightwatchjs/nightwatch/pull/4076
• Hide password values from raw HTTP logs. by @dikwickley in https://github.com/nightwatchjs/nightwatch/pull/4066
• Fix JSDoc example for getText command. by @garg3133 in https://github.com/nightwatchjs/nightwatch/pull/4043
• Added missing isVisible command in new Element API by @subhajit20 in https://github.com/nightwatchjs/nightwatch/pull/4039
• Added isDisplayed() as alias to isVisible() by @uditrajput03 in https://github.com/nightwatchjs/nightwatch/pull/4107
• fixed takeScreenshot example by @dikwickley in https://github.com/nightwatchjs/nightwatch/pull/4121
• allow parallel envs with cucumber by @AutomatedTester in https://github.com/nightwatchjs/nightwatch/pull/4095

New Contributors

• @dikwickley made their first contribution in https://github.com/nightwatchjs/nightwatch/pull/4053
• @subhajit20 made their first contribution in https://github.com/nightwatchjs/nightwatch/pull/4041
• @konavivekramakrishna made their first contribution in https://github.com/nightwatchjs/nightwatch/pull/4076
• @uditrajput03 made their first contribution in https://github.com/nightwatchjs/nightwatch/pull/4107

Full Changelog: https://github.com/nightwatchjs/nightwatch/compare/v3.4.1...v3.5.0

What's Changed

• Warn about two describe()s in a single testsuite. by @garg3133 in #4011
• Fix error while exiting Nightwatch using Ctrl+C. by @garg3133 in #4013
• deps: Update piscina dependency to v4.3.1. by @garg3133 in #4020
• Send POST_SESSION_EVENT with capabilities on session creation. by @garg3133 in #4024
• Add appium reset command by @AutomatedTester in #4019
• Disable HTML reporter in Cucumber. by @garg3133 in #4025

Full Changelog: https://github.com/nightwatchjs/nightwatch/compare/v3.4.0...v3.4.1

What's Changed

Fixed and improvements:

• Fixed #3998 – cannot set custom session status for retried test when using Browserstack, by Priyansh Garg in #3999
• Fixed #3990 – CDP connection not getting reset across sessions when using Selenium, by Priyansh Garg in #3994
• Fixed #3989 – Unable to fetch elements with reference to a ShadowRoot, by Priyansh Garg in #3992
• Fixed #4003 – Replace per-method packages with the main lodash package, by Priyansh Garg in #4005
• Fixed #4007 – add parallel_process_delay in worker threads by @gravityvi in #4007
• Fixed test hooks giving TypeScript error with NightwatchBrowser, by Priyansh Garg in #4004
• Added extended types for waitFor commands, by Priyansh Garg in #3986

Dependency updates:

• Upgraded Selenium to 4.16 by David Burns in #4008. This upgrade brings improved stability, new features, and bug fixes, enhancing the overall testing capabilities with Nightwatch.
• Updated nightwatch-axe-verbose dependency to enhance accessibility testing features, including improved axe-core integration and support for advanced configurations. by Priyansh Garg in #3993

Full Changelog

View Complete History

What's Changed

• Fix types for Nightwatch settings/config file. by @garg3133 in https://github.com/nightwatchjs/nightwatch/pull/3876
• Update dependencies. by @garg3133 in https://github.com/nightwatchjs/nightwatch/pull/3985

Full Changelog: https://github.com/nightwatchjs/nightwatch/compare/v3.3.7...v3.3.8

• Added – support for defining a custom return function for custom command fe9a01

What's Changed

• Fixed process stalling for 4 mins after test run in Node v20+. by @garg3133 in #3976
• Fixed #3639 waitFor commands not retrying for stale elements. by @garg3133 in #3978

Full Changelog: https://github.com/nightwatchjs/nightwatch/compare/v3.3.4...v3.3.5

What's Changed

• Fixed #3966 – shadow root not working on Firefox. by @garg3133
• Fixed #3959 – TS tests not working in ESM project. by @garg3133