FormData.set()
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 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.
Nota: Esse método está disponível em Web Workers.
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 umUSVString. Se nenhum desses valores forem especificados, o valor será convertido para string. filenameOptional-
O nome do arquivo a ser enviado (um
USVString), quando umBlobou umFileé passdo como o segundo parâmetro. O nome de arquivo padrão para objetos do tipoBlobé "blob".
Nota:
Se você especificar um Blob como o dado a ser acrescentado ao objeto FormData, o nome do arquivo que será enviado para o servidor, enviado no atributo "Content-Disposition" no cabeçalho varia de navegador para navegador.
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
| Specification |
|---|
| XMLHttpRequest Standard # dom-formdata-set |
Compatibilidade com navegadores
BCD tables only load in the browser