nightwatch

• Added .within(<selector>) command which adds support for querying within elements

• Fixed #3478 click fix for iOS native app (#3481)
• Fixed #3387 Remove event listeners on command completion (#3416)

New features

The v2.5.2 release adds API Testing capabilities to Nightwatch with the official plugin @nightwatch/apitesting which enables:

• Perform API request testing
• Setup a mock server which enables:
  • Assert on incoming requests
  • Assert on request headers
  • Assert on post data

Other Improvements

• Added new properties to results object #3494

• Fixed #3475: an issue with propagating the exit code properly when using the programmatic api
• Other – upgrade Selenium to 4.6.1

New features

• Run tests on Mobile web

  • end to end setup required to run tests on Mobile web using the @nightwatch/mobile-helper
  • test your website/web app on Android (Chrome & Firefox) & iOS (Safari)

• Nx monorepo integration with the Nx plugin @nightwatch/nx

Improvements

• Added support for writing globals, page objects, and commands in ESM format c40f86

Fixes

• Fixed #3440 – socket hang up error when report_network_errors is enabled
• Fixed #3465 – an issue with using testSuite retries with enable_fail_fast enabled
• Fixed #3470 – issue with Actions API when passing async callback to browser.perform()

Other

• Upgraded selenium-webdriver to 4.5.0

Release Walkthrough Video

Mobile Helper, Nx support (monorepos), API Testing and more: Nightwatch Release Walkthrough v2.5.0

• Added an improvement for error messages shown when running React component tests
• Fixed --open cli argument wasn't working properly #3459
• Added support for launching the local web server for component testing from the android emulator #3460
• Fixed an issue with displaying the http output in the HTML reporter when running tests in parallel 3462

• Fixed an issue resulting from await-ing test hooks properly in some cases 4f6c31

New features

The v2.4.0 release brings improved support for Component Testing, which includes:

• @nightwatch/storybook
  • new official plugin which integrates Nightwatch with Storybook
  • adds ability to run component stories directly from Nightwatch, including:
    • interaction tests using the play() function
    • run test hooks in the Nightwatch context
    • run test() function in the Nightwatch context
    • run configured accessibility rules automatically using the axe-core suite of commands
• vite-plugin-nightwatch
  • upgraded plugin to use Vite 3
• @nightwatch/vue
  • new dedicated Vue.js component testing plugin which includes Vite 3 and manages its own Vite dev server
• @nightwatch/react
  • added support for writing component tests using the Component Story Format which supports JSX directly

New CLI flags

• --serial to run tests in serial mode (disable parallelism)
• --workers to specify the number of test workers to be used when running tests in parallel
• --reuse-browser to reuse the browser session if running in serial mode

component testing related

• --debug – automatically pause the test execution after mounting the component and open the Nightwatch debug REPL interface.
• --story - allows to specify which story to run from the current file (when using Storybook or JSX written in component story format)
• --preview - used to preview a component story/test; automatically pause the test execution after mounting the component.

Other Improvements

• Added support to use --devtools CLI flag in Edge and Safari to open the Dev Tools automatically
• Added support to enable running tests in parallel by default if not set PR #3364
• Added support for using nightwatch.conf.ts as config file and a few other improvements for running typescript tests PR #3316

Fixes

• Fixed #3404 an issue with the moveTo command
• Fixed #3256 .verify assertions do not resolve when called from within the .perform() command

Minor update for the axe-nightwatch-verbose dependency.

• Fixed #3396 showing version using the --version cli flag
• Fixed #3336 an issue with using browser.resizeWindow()

Fixed #3355 – updating the build name using client.updateCapabilities did not work

• Added nightwatch-axe-verbose as a bundled dependency to enable accessibility testing out of the box #3389

• Added new CLI flag ``--report-filename` to specify the report file name for the JSON reporter d73a6f
• Fixed #3361 -- expect.cookie always returning undefined value
• Fixed an issue where the error thrown for using incorrect arguments for element commands was not reported if using async/await testcase e9e38c
• Fixed #3372 -- chaining custom commands from page objects when imported through plugins interface
• Added analytics feature to collect anonymous user metrics (opt in only) PR #3141

• Fixed #3284 – beforeEach hook was executed even it() / test() is marked as skipped
• Fixed #3352 – a TypeError was thrown if a custom command is throwing an error

Improvements

• Added support for using native mobile drivers (#3335)
• Added new cli flag --list-files (#3246)
• Added support to retain the html report between test runs (#3309)

Fixes

• Fixed #3304 - added buildname to settings when running on Browserstack
• Fixed #3301 - awaited asserts used inside custom commands were hanging the test run
• Fixed #3257 - expect.elements(..).count should be 0 if element not found

New feature

• Added pause and debug capabilities - https://github.com/nightwatchjs/nightwatch/issues/3243

  Pause mode

  Add a pause() command to pause your tests indefinitely. In pause mode, you can check the state of your browser or use DevTools to debug. You can also see step-by-step execution from the paused state where the test automatically pauses at the next step.

  Note: The current pause command usage stays as is. You can pass the duration of the pause and the test will pause only for that duration on the mentioned devices.

  Debug mode

  Add a debug() command to pause your test at that step. The debug mode also allows you to check the state of the browser and use DevTools. Furthermore, it offers you an interface to try out nightwatch commands and assertions while your test is paused.

Improvements & Fixes

• Added actionable error messages - #3233
  Redesigned error messages for improved context, relevant documentation and mitigation steps to fix the error.
• Fixed #3177 – additional options in config does not getting passed to cucumber runner
• Added support for waitUntil to use a custom message for timeout errors (https://github.com/nightwatchjs/nightwatch/commit/4b79d79fb01017b2ddc807a6e9cd74fb59cb6e71)

Release Walkthrough

Nightwatch release walkthough

• Fixed #3183 – setting chromeOptions in older format didn't work
• Fixed #3130 – an issue with setting the driver service port number in case of parallel runs with test workers
• Fixed #3096 – an issue with session request redirection when using SauceLabs
• Fixed #3264 – HTML reporter raw http logs were failing to escape html
• Added support for .mockNetworkResponse() to accept relative urls (to launch_url setting)
• Other – Upgraded selenium-webdriver version to 4.3.1 (#3278)

Important fixes

• Fixed #2975 – expect.element().to.not.be.present throws error when the element is not present
• Fixed – an issue with persisting http data for the HTML reporter

New features

The new Nightwatch init CLI tool is now available to use in order to kick-start a new Nightwatch test project in under 60 seconds.

Simply run:

npm init nightwatch

Release notes for create-nightwatch:
https://github.com/nightwatchjs/create-nightwatch/releases/tag/v1.0.0

Other

• Downgraded selenium to 4.1.1 to mitigate a chromedriver startup issue

The latest release introduces a new built-in HTML reporter and several new API commands based on the Chrome Devtools Protocol for mocking network responses, capturing logs, and more.

Improvements

• Added new integrated HTML reporter with test status, assertion logs & raw HTTP logs - #3223; Read more

• Added built-in API commands for working with the Chrome Devtools Protocol - #3208:

  • setGeolocation
  • captureNetworkRequests
  • mockNetworkResponse
  • setDeviceDimensions
  • getPerformanceMetrics
  • enablePerformanceMetrics
  • takeHeapSnapshot
  • captureBrowserConsoleLogs
  • captureBrowserExceptions

• Added --mocha cli flag to quickly switch the test runner to use Mocha

• Added --open cli flag to open the generated HTML report automatically

• Added new integrated JSON reporter

• Added support for using multiple reporters - #3003; to specify more reporters just add several --reporter arguments, e.g.: nightwatch --reporter html --reporter junit --reporter custom-reporter

Other

• Added support to find frame when passing argument as id or name - #3205
• Upgraded selenium-webdriver to v4.2.0 - #3215

• Added - platform methods in case of Appium client (#3166)
• Fixed - an issue with generating XML output for when running tests in parallel (#3163)