FormData.append()

O método append()  da Interface FormData  adiciona novo valor dentro de um chave existente dentro  da FormData object, ou  adiciona a  chave caso ainda não exista.

A diferença entre  FormData.set e append() é que se um especifico chave ja exista, FormData.set ira apagar o valor existente com um novo valor, onde há append() irá adicionar um novo valor no fim dos conjuntos de valores.

Sintaxe

Existe duas versoes deste metodo: um de dois e um outro de tres:

formData.append(name, value);
formData.append(name, value, filename);

Parametros

name

O nome do campo cujos dados estão contidas em value.

value

O valor deste campo . Nas duas versões este é a USVString, ou  caso não seja , este é convertido em string. Na versão de tres parametros este pode ser Blob, File, ou  USVString, de novo, caso nenhum deses forem especificados  este valor é convertido em uma string.

filename Optional

O filename reporta para o servidor (a USVString), quando a Blob ou File é passado como o segundo parametro. O default filename para  Blob o objecto é "blob".

Retorna

Void.

Exemplo

As seguintes linhas criam um Objecto FormData vazio:

var formData = new FormData(); // Corrente vazio

Podes adicionar chaves/valores pares para usar (domxref("FormData.append")}}:

formData.append('username', 'Chris');
formData.append('userpic', myFileInput.files[0], 'chris.jpg');

Specificasões

Compatibilidade do Browser

Notas Gecko

Antis do Gecko 7.0 (Firefox 7.0 / Thunderbird 7.0 / SeaMonkey 2.4), se especificares Blob como a conteudo a ser  adicionado ao objecto, o filename reportado no "Content-Disposition" HTTP header era um string vazio; este resulta em  erros sendo reportados por alguns servidores. Começando com Gecko 7.0, o filename "blob" é enviado.

Veja Tambem

• XMLHTTPRequest
• Usando XMLHttpRequest
• UsandoFormData objects
• <form>