avoid_returning_this

Avoid returning this from methods just to enable a fluent interface.

From Effective Dart:

AVOID returning this from methods just to enable a fluent interface.

Returning this from a method is redundant; Dart has a cascade operator which allows method chaining universally.

Returning this is allowed for:

• operators
• methods with a return type different of the current class
• methods defined in parent classes / mixins or interfaces
• methods defined in extensions

BAD:

var buffer = StringBuffer()
  .write('one')
  .write('two')
  .write('three');

GOOD:

var buffer = StringBuffer()
  ..write('one')
  ..write('two')
  ..write('three');

To enable the avoid_returning_this rule, add avoid_returning_this under linter > rules in your analysis_options.yaml file:

linter:
  rules:
    - avoid_returning_this

If you're instead using the YAML map syntax to configure linter rules, add avoid_returning_this: true under linter > rules:

linter:
  rules:
    avoid_returning_this: true