FormData

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 forma opcional)

Parámetros

forma
 Optional Elemento Forma en HTML <form> para enviar pares llaves/valores. También codificará el contenido del archivo de entrada.

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 archivot que será reportado al servidor en el encabezado "Content-Disposition" usualmente variará de un navegador a otro.

Compatibilidad con Navegadores

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: AngelFQC, wilo, marco_mucino
 Última actualización por: AngelFQC,