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.
io error: No such file or directory (os error 2) (/home/runner/work/yari/yari/mdn/translated-content/files/pt-br/web/api/xmlhttprequest_api/index.md)
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:
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 serBlob,File, ouUSVString, de novo, caso nenhum deses forem especificados este valor é convertido em uma string. filenameOptional-
O filename reporta para o servidor (a
USVString), quando aBlobouFileé passado como o segundo parametro. O default filename paraBlobo 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
| Specification |
|---|
| XMLHttpRequest Standard # dom-formdata-append |
Compatibilidade com navegadores
BCD tables only load in the browser