FormData

Baseline Widely available *

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

* Some parts of this feature may have varying levels of support.

Nota: Esta característica está disponible en Web Workers.

La interfaz FormData proporciona una manera sencilla de construir un conjunto de parejas clave/valor que representan los campos de un formulario y sus valores, que pueden ser enviados fácilmente con el método XMLHttpRequest.send(). Utiliza el mismo formato que usaría un formulario si el tipo de codificación fuera "multipart/form-data".

También puede pasarse directamente al constructor de URLSearchParams si se quieren generar parámetros de consulta de la misma forma en que lo haría un <form> si usara un envío GET simple.

Un objeto que implementa FormData puede usarse directamente en una estructura for...of, en lugar de entries(): for (var p of myFormData) es equivalente a for (var p of myFormData.entries()).

Nota: Esta característica está disponible en Web Workers.

Constructor

FormData()

Crea un nuevo objeto FormData.

Métodos

FormData.append()

Agrega un nuevo valor a una clave existente dentro de un objeto FormData, o añade la clave si aún no existe.

FormData.delete()

Elimina una pareja clave/valor de un objeto FormData.

FormData.entries()

Devuelve un iterator que permite recorrer todas las parejas clave/valor contenidas en este objeto.

FormData.get()

Devuelve el primer valor asociado con una clave dada en un objeto FormData.

FormData.getAll()

Devuelve un array con todos los valores asociados con una clave dada en un objeto FormData.

FormData.has()

Devuelve un booleano que indica si un objeto FormData contiene una clave determinada.

FormData.keys()

Devuelve un iterator que permite recorrer todas las claves de las parejas clave/valor contenidas en este objeto.

FormData.set()

Establece un nuevo valor para una clave existente dentro de un objeto FormData, o agrega la clave/valor si aún no existe.

FormData.values()

Devuelve un iterator que permite recorrer todos los valores contenidos en este objeto.

Especificaciones

Specification
XMLHttpRequest
# interface-formdata

Compatibilidad con navegadores

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
FormData
[Symbol.iterator]
FormData() constructor
submitter parameter
append
filename parameter
delete
entries
forEach
get
getAll
has
keys
set
values
Available in workers

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
See implementation notes.

Ver también