Skip to main content

avoid-positional-record-field-access

v1.5.0
warning
effort: 2m
dart 3.0+
teams+

Warns when a record positional field is accessed via $.

Accessing record positional fields via $1, $2, etc. might look like a great shortcut to write less code, but it also brings readability issues for others who read the code.

Instead, consider destructuring (final (x, y) = ...) the record or converting its fields to named fields.

Example​

❌ Bad:

void function() {
  final record = (
    'hello',
    'world',
  );

  // LINT: Avoid accessing record fields via $.
  //  Try using an intermediate variable or converting record fields to named fields.
  final first = record.$1;

  // LINT: Avoid accessing record fields via $.
  //  Try using an intermediate variable or converting record fields to named fields.
  final second = record.$2;
}

✅ Good:

void function() {
  final record = (
    first: 'hello',
    second: 'world',
  );

  final first = record.first; // Correct, named field
  final second = record.second;

  final another = (
    'hello',
    'world',
  );

  final (first, second) = another;
}
Last updated on