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.

Nota: 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
# dom-formdata-append

Compatibilidade com navegadores

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
append
filename parameter

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
See implementation notes.

Veja Tambem