Dart Test Fundamentals

What it does

This skill assists AI agents in understanding and implementing Dart testing fundamentals. It covers core concepts like test structure (tests and groups), lifecycle methods (setUp, tearDown, setUpAll, tearDownAll), configuration via dart_test.yaml, and file naming conventions. The skill is intended to help with writing new test files and structuring existing test suites within a Dart project.

When to use it

• Writing new Dart test files.
• Structuring tests into logical groups using the group construct.
• Configuring test execution options, such as platforms and timeouts, in dart_test.yaml.
• Understanding how lifecycle methods like setUp and tearDown affect test isolation.

Key capabilities

• Test Structure: Defining tests and organizing them into nested groups.
• Lifecycle Methods: Utilizing setUp, tearDown, setUpAll, and tearDownAll for managing test state.
• Configuration: Configuring the Dart test runner through the dart_test.yaml file, including platforms, tags, and timeouts.
• File Naming: Understanding the required naming convention (*_test.dart) for test files.

Example prompts

• "Show me how to create a group of tests in Dart."
• "Explain how to configure timeout settings using dart_test.yaml."
• "What is the purpose of the setUp method in a Dart test?"

Tips & gotchas

• Test files must end with _test.dart and reside within the test/ directory to be recognized by the test runner.
• Avoid wrapping all tests in a single group at the file level.
• Named parameters for tests (e.g., testOn, timeout) should be placed immediately after the description string for improved readability.