FormData.append()

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

A diferença entre FormData.set e append() é que se uma chave específica já exista, FormData.set irá substituir o valor existente com um novo valor, já o append() irá adicionar um novo valor no fim do conjunto 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 String, ou caso não seja , este é convertido em string. Na versão de tres parametros este pode ser Blob, File, ou String, de novo, caso nenhum deses forem especificados este valor é convertido em uma string.

filename Optional

O filename reporta para o servidor (a String), 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");

Especificações

Compatibilidade com navegadores

Veja Tambem

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