FormData.set()

O método set() da interface FormData adiciona o novo valor para um chave existente em um objeto FormData, ou adicionar a combinação chave/valor caso ela não exista.

A diferença entre  set() e FormData.append é que, se a chave especificada já existir, set() irá sobrescrever todos os valores existentes pelo novo valor, enquanto o FormData.append apenas acrescenta o novo valor ao conjunto de valores existentes.

Sintaxe

Existem duas versões desse método: uma com dois e outra com três parâmetros:

formData.set(name, value);
formData.set(name, value, filename);

Parâmetros

name

O nome do campo cujo dado está em value.

value

O valor do campo. Na versão de dois parâmetros, esse é um USVString, e caso não seja, ele é convertido para uma string. Na versão de três parâmetros ele pode ser um {domxref("Blob")}}, File, ou um USVString. Se nenhum desses valores forem especificados, o valor será convertido para string.

filename Optional

O nome do arquivo a ser enviado (um USVString), quando um Blob ou um File é passdo como o segundo parâmetro. O nome de arquivo padrão para objetos do tipo Blob é "blob".

Exemplo

A linha a seguir cria um objeto FormData vazio:

var formData = new FormData(); // Currently empty

Você pode adicionar os pares chave/valor usando (domxref("FormData.set")}}:

formData.set('username', 'Chris');
formData.set('userpic', myFileInput.files[0], 'chris.jpg');

Especificações

Compatibilidade de navegador

Ver também

• XMLHTTPRequest
• Usando XMLHttpRequest
• Usando objetos FormData
• <form>