FormData.append()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Note: This feature is available in Web Workers.

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.

Nota: Este metodo esta desponivel no Web Workers.

Sintaxe

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

js
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:

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

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

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

Especificações

Specification
XMLHttpRequest Standard
# dom-formdata-append

Compatibilidade com navegadores

BCD tables only load in the browser

Veja Tambem