dart-add-unit-test

Import package:test/test.dart, define a main() function, group related cases with group(), and write individual cases with test(). Validate results using expect() with matchers like equals(), isTrue, or throwsA().

Annotate your test with @GenerateNiceMocks, run dart run build_runner build to generate mock classes, then configure stubs with when() and verify calls with verify(). Inject the mock into the class under test via its constructor.

Use dart test for pure Dart packages and flutter test for Flutter projects, which imports package:flutter_test instead. Both runners ignore the integration_test directory by default, so specify its path explicitly.

Place test files in the test/ directory at the package root, mirroring the lib/ structure, and append _test.dart to each filename. Integration tests belong in a separate integration_test/ directory at the root.

The default test runners ignore the integration_test directory. Explicitly pass the path, for example dart test integration_test or flutter test integration_test, to execute those suites.