FormData: getAll() method

{{APIRef("XMLHttpRequest API")}} {{AvailableInWorkers}}

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

Syntax

getAll(name)

Parameters

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

Return value

An array of values whose key matches the specified name. Otherwise, an empty list.

Examples

If we add two username values to a {{domxref("FormData")}} using {{domxref("FormData.append", "append()")}}:

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

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

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

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

• Using FormData objects
• {{HTMLElement("Form")}}