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.
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 Standard # interface-formdata |
Compatibilidad con navegadores
BCD tables only load in the browser