FormData: keys() 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.keys() method returns an iterator which iterates through all keys contained in the FormData. The keys are strings.

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

Syntax

js
keys()

Parameters

None.

Return value

An iterator of FormData's keys.

Examples

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

// Display the keys
for (const key of formData.keys()) {
  console.log(key);
}

The result is:

key1
key2

Specifications

Specification
XMLHttpRequest
# interface-formdata

Browser compatibility

See also