Test constructor

Test({ required int id, required String name, required int suiteID, required List<int> groupIDs, int? line, int? column, String? url, @JsonKey(name: 'root_line') int? rootLine, @JsonKey(name: 'root_column') int? rootColumn, @JsonKey(name: 'root_url') String? rootUrl, required Metadata metadata, })

A single test case. The test's ID is unique in the context of this test run. It's used elsewhere in the protocol to refer to this test without including its full representation.

Most tests will have at least one group ID, representing the implicit root group. However, some may not; these should be treated as having no group metadata.

The line, column, and url fields indicate the location the test() function was called to create this test. They're treated as a unit: they'll either all be null or they'll all be non-null. The URL is always absolute, and may be a package: URL.

Implementation

factory Test({
  /// An opaque ID for the test.
  required int id,

  /// The name of the test, including prefixes from any containing groups.
  required String name,

  /// The ID of the suite containing this test.
  required int suiteID,

  /// The IDs of groups containing this test, in order from outermost to
  /// innermost.
  required List<int> groupIDs,

  /// The (1-based) line on which the test was defined, or `null`.
  int? line,

  /// The (1-based) column on which the test was defined, or `null`.
  int? column,

  /// The URL for the file in which the test was defined, or `null`.
  String? url,

  /// The (1-based) line in the original test suite from which the test
  /// originated.
  ///
  /// Will only be present if `root_url` is different from `url`.
  @JsonKey(name: 'root_line') int? rootLine,

  /// The (1-based) line on in the original test suite from which the test
  /// originated.
  ///
  /// Will only be present if `root_url` is different from `url`.
  @JsonKey(name: 'root_column') int? rootColumn,

  /// The URL for the original test suite in which the test was defined.
  ///
  /// Will only be present if different from `url`.
  @JsonKey(name: 'root_url') String? rootUrl,

  /// Metadatas about a test
  required Metadata metadata,
}) = _Test;