FormData: values() method

Baseline
Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since October 2018.

Note: This feature is available in Web Workers.

The FormData.values() method returns an iterator which iterates through all values contained in the FormData. The values are strings or Blob objects.

Note: FormData keys are not necessarily unique. A form can contain multiple elements with the same name, so values sharing one key each appear while iterating. To retrieve all values associated with a single key, use the getAll() method (or get() for only the first value).

Syntax

js
values()

Parameters

None.

Return value

An iterator of FormData's values.

Examples

js
const formData = new FormData();
formData.append("key1", "value1");
formData.append("key2", "value2");

// Display the values
for (const value of formData.values()) {
  console.log(value);
}

The result is:

value1
value2

Specifications

Specification
XMLHttpRequest
# interface-formdata

Browser compatibility

See also