FormData.getAll()

The getAll() method of the FormData interface returns all the values associated with a given key from within a FormData object.

Note: This method is available in Web Workers.

Syntax

getAll(name)

Parameters

name

A string representing the name of the key you want to retrieve.

Return value

An array of FormDataEntryValues whose key matches the value passed in the name parameter. If the key doesn't exist, the method returns an empty list.

Examples

The following line creates an empty FormData object:

var formData = new FormData();

If we add two username values using FormData.append:

formData.append('username', 'Chris');
formData.append('username', 'Bob');

The following getAll() function will return both username values in an array:

formData.getAll('username'); // Returns ["Chris", "Bob"]

Specifications

Specification
XMLHttpRequest Standard
# dom-formdata-getall

Browser compatibility

BCD tables only load in the browser

See also