fields property

@override Map<String, dynamic> fields

Gets this request's body as a Map where each key-value pair is a form field's name and value.

By default, the body of this FormRequest is an empty Map.

The returned Map is modifiable, allowing incremental field assignment like so:

FormRequest request = new FormRequest()
  ..fields['foo'] = 'bar'
  ..fields['bar'] = 'baz';

To set multiple values for a single key, use a Iterable<String>:

FormRequest request = new FormRequest()
  ..fields['names'] = ['foo', 'bar'];

Prior to sending, this request body will be translated to the equivalent query string. Depending on the platform, this may then be encoded to bytes. Be sure to set encoding if this request body should be encoded with something other than the default utf-8.

Implementation

@override
Map<String, dynamic> get fields =>
    isSent ? Map<String, dynamic>.unmodifiable(_fields) : _fields;

@override void fields=(Map<String, dynamic>? fields)

Sets this request's form fields. The given Map should represent the form fields where each key-value pair is a field's name and value.

Prior to sending, this request body will be translated to the equivalent query string. Depending on the platform, this may then be encoded to bytes. Be sure to set encoding if this request body should be encoded with something other than the default utf-8.

Implementation

@override
set fields(Map<String, dynamic>? fields) {
  verifyUnsent();
  _fields = fields ?? {};
}