dom / latest / formdata / get.html /

FormData.get()

The get() method of the FormData interface returns the first value associated with a given key from within a FormData object. If you expect multiple values and want all of them, use the getAll() method instead.

Note: This method is available in Web Workers.

Syntax

get(name)

Parameters

name

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

Return value

A FormDataEntryValue containing the value. If the key doesn't exist, the method returns null.

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 get() function will only return the first username value appended:

formData.get('username'); // Returns "Chris"

Specifications

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
get
50
18
39
No
37
11.1
50
50
39
37
11.3
5.0

See also

© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/FormData/get