FED-3659 Add Dart bindings for React act

[sydneyjodon-wk]

Motivation

We should expose the act API from React (https://react.dev/reference/react/act)

act is a test helper to apply pending React updates before making assertions.

While most cases are handled by RTL, whose APIs such as UserEvent and fireEvent are wrapped in act:

You might find using act() directly a bit too verbose. To avoid some of the boilerplate, you could use a library like React Testing Library, whose helpers are wrapped with act().

...there are some cases, like testing component imperative API calls, or dispatching actions directly, in which act may be a good fit.

Changes

• Expose act in dart
• add tests

Release Notes

Review

See CONTRIBUTING.md for more details on review types (+1 / QA +1 / +10) and code review process.

QA Checklist

• Tests were updated and provide good coverage of the changeset and other affected code
• Manual testing was performed if needed
  • Steps from PR author:
    • verify test coverage
    • CI passes
  • Anything falling under manual testing criteria outlined in CONTRIBUTING.md

Merge Checklist

While we perform many automated checks before auto-merging, some manual checks are needed:

• A Frontend Frameworks Design member has reviewed these changes
• There are no unaddressed comments - this check can be automated if reviewers use the "Request Changes" feature
• For release PRs - Version metadata in Rosie comment is correct

[greglittlefield-wf]

Just a couple additional test cases I thought would be good to add, otherwise this looks great!

[greglittlefield-wf]

Could we also add some tests that verify that any errors in the callback successfully propagate, both for sync and async callbacks?

That way
a) we'll verify that the errors aren't swallowed and
b) we'll know whether anything weird happens to Dart exceptions in the JS interop that might require throwErrorFromJS or something).

Could do something like this (I stumbled across that when looking through code trying to remember the name of throwErrorFromJS):

react_testing_library/test/unit/dom/wait_for_test.dart

Lines 122 to 123 in 8288d6f

	expect(() => rtl.waitFor(() => throw ExceptionForTesting(), container: view.container),
	throwsA(isA<ExceptionForTesting>()));

[greglittlefield-wf]

Code LGTM, but I just remembered 🤦, this repo is set up to auto-release/publish now on merge.

Would you mind updating the changelog for 3.1.0 with this addition? And if you wouldn't mind, filling in 3.0.3/3.0.4 too while you're in there? 😅

[greglittlefield-wf]

Thanks for updating the changelog!

+10

@Workiva/release-management-p

[rmconsole-wf]

+1 from RM