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

Ver también