Skip to content
This repository has been archived by the owner on May 22, 2024. It is now read-only.

Commit

Permalink
Add node about node fibers.
Browse files Browse the repository at this point in the history
  • Loading branch information
kenk2 committed Feb 12, 2024
1 parent 97d732f commit 7e9b860
Show file tree
Hide file tree
Showing 2 changed files with 6 additions and 2 deletions.
2 changes: 1 addition & 1 deletion packages/terra-functional-testing/CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
## Unreleased

* Breaking changes
* Removed `@wdio/sync` to prepare for Node LTS upgrades. Tests will no longer run in sync mode and will require all tests to run asynchonous functions with `async-await` in test suites. See upgrade guide for how to transition.
* Removed `@wdio/sync` as it is now deprecated. Tests will no longer run in sync mode and will require all tests to run asynchonous functions with `async-await` in test suites. See upgrade guide for how to transition.
* Support for testing `<iframe>` components is dropped.

## 4.6.0 - (February 5, 2024)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,10 +4,14 @@ The upgrade from v4 to v5 removes `@wdio/async`

## Breaking Changes

In order to prepare for upgrading the Terra ecosystem to be compatible with Node +18, `@wdio/sync` is being removed as a dependency from `@cerner/terra-functional-testing`. As `fibers` and `@wdio/sync` are being deprecated from Node +16, this move is necessary to bring the Terra ecosystem with the latest Node version. Due to `@wdio/sync` being removed, all tests are now run asynchronously and tests will need to be re-written in order to ensure they run asynchronously. A short introduction to changing your tests to run asynchronously can be seen here: [From Sync to Async](https://webdriver.io/docs/async-migration/)
The synchronous WebdriverIO API (`@wdio/sync`) has been [deprecated](https://webdriver.io/blog/2021/07/28/sync-api-deprecation/) and is no longer supported. Therefore, terra-functional-testing is switching over to use the asynchronous webdriver API. This will also allow for Terra to utilize future versions of Webdriver and Node which do not support `@wdio/sync`.

Support for testing `<iframe>` components via `terra-functional-testing` is now dropped. We are now utilizing WDIO's official axe-core drivers which drops support for testing iframes. All consumers of `terra-embedded-content-consumer` are encouraged to adopt custom testing strategies for the component.

## Node Fibers

If you are Node 14 and under, you will need to install `fibers` as a dependency in the root of your project if you run your application with `webpack-config-terra`. After Node 16, `fibers` will no longer be required in your project.

## Terra-specific API Changes

`@cerner/terra-functional-testing` provides wrapper functions for accessibility testing. Previously these functions were run synchronously but now need to be executed asynchronously. The following wrapper functions now need to be specified with `await` before execution:
Expand Down

0 comments on commit 7e9b860

Please sign in to comment.