内容

avoid_returning_this

避免从方法中返回 this 仅仅是为了启用流畅的接口。

此规则从 Dart 2.0 开始可用。

详情

#

来自 有效 Dart

**避免**从方法中返回 this 仅仅是为了启用流畅的接口。

从方法中返回 `this` 是多余的;Dart 有一个级联运算符,它允许通用方法链。

允许返回 `this` 的情况包括:

  • 运算符
  • 返回类型不同于当前类的函数
  • 在父类/mixin 或接口中定义的方法
  • 在扩展中定义的方法

错误

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

正确

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

用法

#

要启用 `avoid_returning_this` 规则,请在您的 `analysis_options.yaml` 文件中将 `avoid_returning_this` 添加到 **linter > rules** 下

analysis_options.yaml
yaml
linter:
  rules:
    - avoid_returning_this