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() (en-US). 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() (en-US): 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() (en-US)

Crea un nuevo objeto FormData.

Métodos

FormData.append() (en-US)

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() (en-US)

Elimina una pareja clave/valor de un objeto FormData.

FormData.entries() (en-US)

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

FormData.get() (en-US)

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

FormData.getAll() (en-US)

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

FormData.has() (en-US)

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

FormData.keys() (en-US)

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

FormData.set() (en-US)

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() (en-US)

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

Ver también