Что такое `cascade operator (..)` в Dart и как он работает?

Question

Accepted Answer

Что такое cascade operator

Cascade operator (..) — синтаксический сахар в Dart, позволяющий выполнять цепочку операций над одним объектом без повторного указания его имени. Результатом всего выражения остаётся исходный объект, а не результат последнего вызова метода.

Оператор .. передаёт левый операнд через каждый шаг цепочки и в конце возвращает его же. Это особенно удобно при конфигурировании объектов, построении билдеров и настройке виджетов Flutter.

Синтаксис и семантика

Без cascade:

final paint = Paint();
paint.color = Colors.blue;
paint.strokeWidth = 2.0;
paint.style = PaintingStyle.stroke;

С cascade:

final paint = Paint()
  ..color = Colors.blue
  ..strokeWidth = 2.0
  ..style = PaintingStyle.stroke;

Оба фрагмента эквивалентны, но второй лаконичнее. Dart-компилятор сворачивает cascade в те же операции присваивания — никакого дополнительного overhead нет.

Runnable пример

import 'dart:io';

class HttpRequestBuilder {
  String method = 'GET';
  String url = '';
  final Map headers = {};
  String? body;

  void send() {
    stdout.writeln('$method $url');
    headers.forEach((k, v) => stdout.writeln('  $k: $v'));
    if (body != null) stdout.writeln('  body: $body');
  }
}

void main() {
  HttpRequestBuilder()
    ..method = 'POST'
    ..url = 'https://api.example.com/jobs'
    ..headers['Content-Type'] = 'application/json'
    ..headers['Authorization'] = 'Bearer token123'
    ..body = '{"title": "Flutter Developer"}'
    ..send();
}

Здесь send() вызывается как последний шаг цепочки, но переменная всё равно хранит ссылку на HttpRequestBuilder, а не на void.

Null-aware cascade (.?..)

Dart 2.12 добавил null-aware вариант ?... Если объект равен null, вся цепочка пропускается:

List? maybeList;
maybeList
  ?..add(1)
  ..add(2);  // не выполнится, если maybeList == null

Cascade с коллекциями

final buffer = StringBuffer()
  ..write('Hello')
  ..write(', ')
  ..write('World')
  ..writeln('!');
print(buffer.toString()); // Hello, World!

final list = []
  ..add('dart')
  ..addAll(['flutter', 'firebase'])
  ..sort();
print(list); // [dart, firebase, flutter]

Отличие от method chaining

Method chaining (Builder pattern) требует, чтобы каждый метод возвращал this или новый объект. Cascade работает с любым объектом — даже если методы возвращают void или другой тип. Это делает его совместимым с существующими API без изменения их сигнатуры.

Подводные камни

Возвращаемое значение теряется. Если метод возвращает важный результат (например, индекс вставки или Future), он молча игнорируется в цепочке. Используйте cascade только с void-методами или сеттерами.
Смешивание cascade и присваивания. Выражение a = b..c() присваивает a объект b после вызова c(), а не результат c(). Приоритет операторов здесь неочевиден.
Cascade на temporary object без сохранения. Foo()..doSomething() создаёт объект, вызывает метод и сразу выбрасывает объект в GC — типичная ошибка, когда забывают присвоить результат переменной.
Глубокое вложение снижает читаемость. Несколько уровней вложенных cascade-выражений трудно читать и отлаживать; лучше разбить на именованные переменные.
Null-aware cascade и non-null ветки. После ?.. все следующие шаги тоже должны использовать .., а не ?.. — компилятор это не принудит, но поведение будет неожиданным, если объект оказался null на середине цепочки.
Проблемы с hot reload в Flutter. Cascade, использующийся для конфигурирования глобальных синглтонов или сервис-локаторов (например, GetIt), может приводить к повторной регистрации при hot reload — это выбрасывает исключение.
Отладка пошаговая затруднена. Отладчик в VS Code и IntelliJ не всегда позволяет поставить breakpoint на конкретный шаг cascade; часто приходится разворачивать цепочку в отдельные операторы для диагностики.
Несовместимость с const. Cascade нельзя применять к const-объектам, так как предполагает мутацию. Попытка использовать .. с const-значением приведёт к ошибке компиляции.

Что такое `cascade operator (..)` в Dart и как он работает?