avoid_returning_this

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

此规则从 Dart 2.0 开始可用。

来自 Effective Dart

避免为了启用流畅的接口而从方法返回 `this`。

从方法返回 `this` 是多余的；Dart 有一个级联运算符，它允许普遍的方法链式调用。

以下情况允许返回 `this`：

• 运算符
• 返回类型与当前类不同的方法
• 在父类/混入或接口中定义的方法
• 在扩展中定义的方法

错误示例

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

正确示例

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

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

linter:
  rules:
    - avoid_returning_this

除非另有说明，否则本网站上的文档反映的是 Dart 3.6.0。页面最后更新于 2024-07-03。 查看源代码 或 报告问题。