El Nivel 2 de XMLHttpRequest añade soporte para la nueva interfaz  FormData. Los objetos FormData proporcionan una forma para construir fácilmente un conjunto de pares llave/valor que representan campos de forma y sus valores, los cuales pueden enviarse fácilmente utilizando el método send() del Objeto XMLHttpRequest.

Utiliza el mismo formato que una forma debería utilizar si el tipo de codificación fuera establecido a "multipart/form-data".

Para detalles en cómo utilizar el objeto FormData, vea Usando objetos FormData.

Constructor

new FormData ([HTMLFormElement formulario])

Parámetros

formulario
 Optional Elemento <form> del formulario HTML para enviar pares claves/valores. También codificará el contenido de los campos <input> de tipo archivo.

Métodos

append()

Añade una pareja llave/valor al objeto FormData.

void append(DOMString nombre, Blob valor, opcional DOMString nombre_archivo);
void append(DOMString nombree, DOMString valor);
Parámetros
nombre
El nombre del campo cuya información está contendia en valor.
valor
El valor del campo. Puede ser un Blob, File, o una cadena, si no es ninguno, el valor se convierte a cadena.
nombre_archivo
Optional El nombre del archivo reportado al servidor, cuando un Blob o File es pasado como segundo parámetro. El nombre del archivo por defecto para objetos Blob es "blob".

Nota: Si especifica un Blob como los datos para añadir al objeto FormData, el nombre del archivo que será reportado al servidor en el encabezado "Content-Disposition" usualmente variará de un navegador a otro.

Compatibilidad con Navegadores

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

Característica Chrome Firefox (Gecko) Internet Explorer Opera Safari
Soporte Básico 7+ 4.0 (2.0) 10+ 12+ 5+
Añadir con nombre de archivo (Yes) 22.0 (22.0) ? ? ?
Feature Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Soporte Básico 3.0 ? 4.0 (2.0) ?

12+

?
Añadir con nombre de archivo ? ? 22.0 (22.0) ? ? ?

Notas para Gecko

En versiones anteriores a Gecko 7.0 (Firefox 7.0 / Thunderbird 7.0 / SeaMonkey 2.4), si especifica un Blob como los datos a agregar al objeto, el nombre del archivo reportado en el encabezado HTTP "Content-Disposition" era una cadena vacía; esto resultó en errores reportados por algunos servidores. A partir de Gecko 7.0, se envía "blob" como nombre del archivo.

Especificación

Vea también

Etiquetas y colaboradores del documento

Colaboradores en esta página: alvaromorenomorales, ojgarciab, Sheppy, AngelFQC, wilo, marco_mucino
Última actualización por: alvaromorenomorales,