v3.1.0

We’re super excited to announce the release of Nightwatch v3. It that has been built around these three pillars:

• Developer Experience: The entire experience from getting started, to writing and debugging tests, has been redesigned for speed, stability, and consistent non-flaky results.

• Mobile first: Test your web or native, iOS and Android, mobile applications on simulators, real mobile devices or a cloud grid like BrowserStack.

• One test automation framework: Run all types of tests from unit, component, and E2E to API, visual, and accessibility with a single framework.

What's Changed

New Features

• Add support for namespaced aliases. by @garg3133 in #3794
• Move execute and executeAsync to document ns. by @garg3133 in #3807
• Move network-related commands to .network namespace. by @yashPratp983 in #3797

Fixes

TypeScript Fixes

• Fix types for namespaces on page-objects. by @garg3133 in #3778
• Add types for Firefox namespace commands by @Priyanka0613 in #3780
• Add types support in Nightwatch examples, test, and types/tests directories. by @yashPratp983 in #3803
• Build Nightwatch using TypeScript. by @garg3133 in #3774

Dependency Updates

• update dependency nightwatch-axe-verbose to ^2.2.2 by @justafish in #3793
• Update jsdom to v21.1.2 and npm audit fix. by @itsspriyansh in #3811
• Uninstall Coveralls by @itsspriyansh in #3816
• updated semver to v7.5.2 by @itsspriyansh in #3829

Cucumber

• Fixes/3781 fix cucumber step definition config by @gravityvi in #3782
• allow esm imports (#3805) by @thermsdorff in #3806

General

• Fix takeScreenshot command not returning anything. by @garg3133 in #3769
• Feature/disable process listener for programattic api by @swrdfish in #3800
• Add missing documentation by @swrdfish in #3826
• Updated Error Message for Browser Compatibility Information. by @yashPratp983 in #3809
• programatic-api: add methods to call global hooks, add a cleanup method by @swrdfish in #3822
• add error handling for worker threads by @gravityvi in #3828
• Page-object commands should return the same page-object. by @garg3133 in #3779
• Fix elements and commands property issue with POM. by @garg3133 in #3788
• Fix sync tests getting skipped in parallel mode. by @garg3133 in #3791
• Fixed the issue regarding error if a folder defined in src_folders is empty when using tags by @itsspriyansh in #3824
• Fix #3625 - Changed to recursive merge on caps by @vinodreddy-bs in #3831

New Contributors

• @yashPratp983 made their first contribution in #3803
• @justafish made their first contribution in #3793
• @itsspriyansh made their first contribution in #3811
• @thermsdorff made their first contribution in #3806
• @vinodreddy-bs made their first contribution in #3831

Full Changelog: v3.0.1...v3.1.0

Nightly 3.1.0-nightly-26072023

nightly-3.1.0-nightly-26072023

handle error for src folders while using tags (#3824)

Nightly 3.1.0-nightly-18072023

nightly-3.1.0-nightly-18072023

Fix sync tests getting skipped in parallel mode. (#3791)

V3.0.1

We’re super excited to announce the release of Nightwatch v3. It that has been built around these three pillars:

• Developer Experience: The entire experience from getting started, to writing and debugging tests, has been redesigned for speed, stability, and consistent non-flaky results.

• Mobile first: Test your web or native, iOS and Android, mobile applications on simulators, real mobile devices or a cloud grid like BrowserStack.

• One test automation framework: Run all types of tests from unit, component, and E2E to API, visual, and accessibility with a single framework.

New features

New element APIs

With Nightwatch v3, we have revamped the element API to make test authoring simpler and more concise. Learn more
More rich & powerful selectors

New selectors are introduced as part of this latest versions

.findByText()

.findByPlaceholderText()

.findByAltText()

.findByRole()

You can also chain selectors to find elements that are more complex to find

For E.g.

browser.element.find('CSS Selector').findByText('text').click();

Guide

Performance improvements

Nightwatch v3 has implemented worker threads for parallel runs and we have observed improvements of up to 25% between Nightwatch v2 & v3. Try it now

Nightwatch inspector

Nightwatch v3 introduces a point and click tool that can help you easily find selectors. It will improve your productivity of authoring tests & help you find durable selectors for lower long term maintenance. Learn more

Angular component testing

With Nightwatch v3 you can test Angular components in isolation by mounting them in the browser. Try it now

Test doubles

The unit testing with Nightwatch got an upgrade as v3 introduced test doubles. You can use mocks, stubs & spies in your Nightwatch tests.

Fixes

• Fix: incorrect build duration in HTML Report by @vaibhavsingh97 in #3658

• Fix timeout issue on windows builds. by @garg3133 in #3660

• Fix #3484 Added elementId only param in moveTo command by @harshit-bs in #3517

• Fix element api support in POM. by @garg3133 in #3689

• Fix xPath selectors to locate within elements. by @garg3133 in #3672

Other Improvements

• Upgrade selenium to 4.10.0 by @AutomatedTester in #3705

• Types migration from definitely typed to Nightwatch project by @beatfactor in #3714

• Remove dependency on driver binaries, fallback to selenium-manager by @swrdfish in #3717

• Add the ability to rerun failed tests by @prudhvi22 in #3703

Breaking changes

We have tried to ensure that there are no breaking changes while upgrading to v3. However, in case you need migration assistance please reach out to us on our new Nightwatch v3 channel on Discord

v3.0.0 - Beta 1

What's Changed

Features

• add support for a dynamic filename for HTML Report by @vaibhavsingh97 in #3667
• Make new element API commands available on page objects. by @garg3133 in #3698
• Migrate namespaces to client-commands and get them working on page-objects. by @garg3133 in #3684
• Added retry test data to a global reporter by @harshit-bs in #3712
• Make new element API available as named export. by @garg3133 in #3671
• Skipped tests have been categorized as either user-marked or runtime-failed by @harshit-bs in #3711
• Remove dependency on driver binaries, fallback to selenium-manager by @swrdfish in #3717
• Types migration by @beatfactor in #3714
• Add the ability to rerun failed tests by @prudhvi22 in #3703

Fixes

• move screenshot aboslute path to relative path in HTML Report by @vaibhavsingh97 in #3661
• resolve overlapping testnames issue by @AlaaSayed794 in #3539
• remove mkpath as a dependency by @gravityvi in #3679
• Fix xpath selectors to locate within elements. by @garg3133 in #3672
• fixed issues with findByLabelText by @beatfactor in #3681
• fix build duration for HTML Reporter by @vaibhavsingh97 in #3683
• Fix element api support in POM. by @garg3133 in #3689
• feat: add bstack demo example by @vaibhavsingh97 in #3405
• fix: env is not passed to worker threads by @vaibhavsingh97 in #3691
• Added default value fix for retryInterval in waitUntil with message param by @harshit-bs in #3669
• Added a fix for assert.hasAttribute by @harshit-bs in #3651
• Fix nesting strategies in findByLabelText. by @garg3133 in #3710
• Fix sendKeys to allow multiple value arguments; add setValue. by @garg3133 in #3709
• Always throw uncaught exceptions by @swrdfish in #3708
• example tests fix for mobile by @harshit-bs in #3487
• fix #3554 : Added fix for mobile-web error classes by @harshit-bs in #3572
• Test fix for waitForElementNotPresent by @harshit-bs in #3599
• Nightwatch Inspector - Blocking parallelism for default case for chrome in debug mode by @harshit-bs in #3692
• fix #3513 Dont skip tests if verify fails by @prudhvi22 in #3533
• added waitUntil module to element apis by @gravityvi in #3715
• Upgrade selenium to 4.9.0 by @AutomatedTester in #3705
• Added describe name, hook timestamps to reporter by @prudhvi22 in #3680
• Nightwatch session is not getting closed in serial mode by @harshit-bs in #3694
• return correct status code for waitForElementNotPresent by @swrdfish in #3678

New Contributors

• @AlaaSayed794 made their first contribution in #3539

Full Changelog: v3.0.0-alpha.3...v3.0.0-beta.1

v2.6.21

What's Changed

• Return correct status code for waitForElementNotPresent (#3678)
• skipped tests have categorized as either user-marked or runtime-failed (#3711)
• REPL interface exits on error or failed expect assertion.
• Added rerun functionality for failed test (#3703)
• Added describe name, hook timestamps to reporter (#3680)
• feat/retry-data: Added retry test data to global reporter (#3712)
• Always throw uncaught exceptions (#3708)
• Added a fix for assert.hasAttribute (#3651)

Full Changelog: v2.6.20...v2.6.21

v2.6.20

• feat: add support for dynamic filename for HTML Report (#3667) b82b75f
• chore: fix build duration for HTML Reporter (#3683) 4173ac0
• remove mkpath as a dependency (#3679) 48f488f
• resolve overlapping testnames issue (#3539) a647ee7
• fix: incorrect build duration in HTML Report (#3658) 5557e5a
• update baseHook to handle hook done function inside command callback (#3636) 98226b8

v2.6.19...v2.6.20

v3.0.0-alpha.3

What's Changed

• Fix #3484 Added elementId only param in moveTo command by @harshit-bs in #3517
• avoid pushing autoInvoked command nodes to command queue by @gravityvi in #3653
• fix #3469 REPL interface exits on error by @prudhvi22 in #3489
• Fix #3591 - stringify the object in console output by @harshit-bs in #3650
• update baseHook to handle hook done function inside command callback by @gravityvi in #3636
• fix: incorrect build duration in HTML Report by @vaibhavsingh97 in #3658
• Fix timeout issue on windows builds. by @garg3133 in #3660
• Added brand new element() api which includes an improved chainable locator syntax with several new commands and assertions by @beatfactor, @garg3133 in #3666

Full Changelog: v3.0.0-alpha.2...v3.0.0-alpha.3

v2.6.19

• Fixed #3484 – Added elementId only param in moveTo command
• Fixed #3652 – Command queue nodes with autoInvoke mode were executed twice
• Fixed #3469 REPL interface exits on error
• Fixed #3591 - added support to stringify objects in console output

v3.0.0 - Alpha 2

What's Changed

• Fixes/3612 add session name to browserstack transport by @gravityvi in #3632
• Allow to use any browser with BrowserStack and Appium. by @garg3133 in #3634
• Selector Playground / Nightwatch Inspector Extension by @harshit-bs in #3609
• Features/use worker threads by @gravityvi in #3592
• Bump Selenium Version to 4.8.0 by @AutomatedTester in #3586

Full Changelog: v2.6.16...v3.0.0-alpha.2