MDN wants to learn about developers like you: https://qsurvey.mozilla.com/s3/MDN-dev-survey

Esta tradução está incompleta. Por favor, ajude a traduzir este artigo.

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 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".

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

Especificação Status Comentário
XMLHttpRequest
The definition of 'set()' in that specification.
Living Standard  

Compatibilidade de navegador

Característica Chrome Firefox (Gecko) Internet Explorer Opera Safari
Suporte básico 50.0 39.0 (39.0) Não suportado Não suportado Não suportado
DIsponível para web workers 50.0 39.0 (39.0) Não suportado Não suportado Não suportado
Característica Android Android Webview Firefox Mobile (Gecko) Firefox OS (Gecko) IE Mobile Opera Mobile Safari Mobile Chrome for Android
Suporte básico Não suportado 50.0 (Yes) (Yes) Não suportado

Não suportado

Não suportado 50.0
DIsponível para web workers Não suportado 50.0 (Yes) (Yes) Não suportado Não suportado Não suportado 50.0

Ver também

Etiquetas do documento e colaboradores

 Colaboradores desta página: welingtonms
 Última atualização por: welingtonms,