MDN wants to learn about developers like you: https://qsurvey.mozilla.com/s3/MDN-dev-survey

Esta tradução está incompleta. Por favor, ajude a traduzir este artigo.

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.

Nota: Este  metodo esta desponivel no Web Workers.

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".

Nota: Se espisificares  Blob como a data append  para o objecto FormData , o filename a ser reportado para o servidor  no "Content-Disposition" header usado para mudar de browser em browser.

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

Especificações Estato Comentario
XMLHttpRequest
The definition of 'append()' in that specification.
Living Standard  

Compatibilidade do Browser

Caracteristicas Chrome Firefox (Gecko) Internet Explorer Opera Safari
Suporte Basico 7+ 4.0 (2.0) 10+ 12+ 5+
append com filename (Yes) 22.0 (22.0) ? ? ?
Disponivel para Desenvolvedores Web (Yes) 39.0 (39.0) ? ? ?
Caracteristicas Android Chrome para Android Firefox Mobile (Gecko) Firefox OS (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support 3.0 ? 4.0 (2.0) 1.0.1 ?

12+

?
append com filename ? ? 22.0 (22.0) 1.2 ? ? ?
Disponivel para Desenvolvedores Web ? ? 39.0 (39.0) ? ? ? ?

Nota: XHR em  Android 4.0 envia conteudo vazio  para FormData com blob.

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

Etiquetas do documento e colaboradores

 Colaboradores desta página: rogerioac, DouglasValdo
 Última atualização por: rogerioac,