FormData

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

Especificación Estado Comentario
XMLHttpRequest
La definición de 'FormData' en esta especificación.
Living Standard FormData definido en XHR spec

Compatibilidad con navegadores

BCD tables only load in the browser

Ver también