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.
Padrão em tempo real  

Compatibilidade do Browser

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

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,