Метод add
Добавляет значение заголовка.
Заголовку с именем name будет назначено строковое значение, полученное из value, добавленное в его список значений.
Некоторые заголовки имеют единственное значение, и добавление значения заменит предыдущее значение. Если значение value является объектом DateTime, будет применён формат даты HTTP. Если значение является объектом Iterable, каждый элемент будет добавлен отдельно. Для всех других типов будет использоваться метод Object.toString по умолчанию.
Имена заголовков преобразуются в нижний регистр, если preserveHeaderCase не установлено в значение true. Если два имени заголовков совпадают после преобразования в нижний регистр, они считаются одним и тем же заголовком с одним набором значений.
Текущий регистр имени заголовка — это регистр имени, используемый в последнем вызове метода set или add для этого заголовка.
Реализация
void add(String name, Object value,
{@Since("2.8") bool preserveHeaderCase = false});
© 2012 the Dart project authors
Licensed under the BSD 3-Clause "New" or "Revised" License.
https://api.dart.dev/stable/2.18.5/dart-io/HttpHeaders/add.html