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
BloboFilees pasado como segundo parámetro. El nombre del archivo por defecto para objetosBlobes "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.